1. MSB Integration Guide

2. Service Registration/Discovery/Routing with MSB
OOM register/update service endpoint to MSB service discovery
External API Gateway handle the service request form external systems(Browser, OSS, BSS, etc.)
Centralized Auth is enforced at the entry point(External API Gateway), user don’t have to login to individual services for multiple times
Internal API Gateway handle the service routing/LB between ONAP microservices
No invasion to individual Microservice. ONAP projects don’t have to modify their codes to leverage the Registration/Discovery/Routing capabilities provided by MSB
A client SDK will be provided at the next release to facilitate direct communication between ONAP microservices.
ONAP Microservices
MSB
Service Discovery
Internal API Gateway
(Router)
external service request
External service
Internal service
OOM
Register service
AAF
Authentication
Authorization
Desktop
External Systems
Mobile
External API Gateway
Service A
A&AI
VF-C …
LCM(deploy/ start/ stop/ scale, etc.)
Internal service request( REST)
DMaaP
Async Messages
Routing and Load Balancing

3. ONAP RESTful API Definition Specification
URI Construction
name}]/v{version number}/{resource}
Versioning
Semantic Versioning 
Other

4. Service Registration – Service Endpoint Info
Attribute
Description
serviceName
Service Name
version
Service Version
url
the actual URL of the service to be registered
protocol
supported protocols: 'REST', 'UI', 'HTTP','TCP'
visualRange
Visibility of the service.  External(can be accessed by external systems):0  Internal(can only be accessed by ONAP microservices):1
path
The customized publish path of this service.
If path parameter is specified when registering the service, the service will be published to api gateway under this path. Otherwise, the service will be published to api gateway using a fixed format: api/{serviceName} /{version}.
The customized publish path should only be used for back-compatible.
nodes
ip: the ip of theservice instance node port: the port of the service instance node ttl: time to live, this parameter is reserved for later use

5. A&AI MSB Integration
Provide A&AI service endpoints definition for consumption
Define the service according to ONAP RESTful API definition Specification
Keep the old RESTful URL for back-compatible
Service
serviceName
version
url
protocol
visualRange
path
Cloud Infrastructure
AAI-CloudInfrastructure v1
/cloud-infrastructure
REST 1
AAI-CloudInfrastructure-deprecated
Service Design And Creation
AAI-service-design-and-creation
/service-design-and-creation
AAI-service-design-and-creation-deprecated
/ervice-design-and-creation
/api/AAI-CloudInfrastructure/v1
/cloud-infrastructure/
A&AI don’t have to modify its code to provide the new API definition, MSB can translate the request to the new API to the current A&AI API. It is expected that A&AI should deprecate the old API and move to the new one in compliance with ONAP ESTful API definition specification in the later release like Beijing.

6. A&AI MSB Integration
Use the MSB internal API gateway to access other microservices
Using a configuration file, we might have problems on scaling, failover and update
MSB as the single entry point
Before:
After:
“internalapigateway": " ……
How to call service:
API gateway routes the request to:
POST
Note: If there are multiple service provider instances, MSB will choose one to send the request according to LB method
POST