YOUnite Adaptors communicate with the YOUnite API/Router using JMS through a message broker.
The properties covered below can be either specified in the application.properties file for spring boot application or using the environment variables of the same name in docker instance, via the docker command line or the docker-compose.yml file.
To configure the adaptor instance to be able to communicate with the message broker, following needs to be done:
- Message broker URL: Specify the message broker URL using the property
activemq.broker.url.
This URL is used to specify the host and port information for the message broker.
(TODO: move this information to another service that can be used to retrieve such dependencies) - SSL/TLS: YOUnite uses self signed certificates for enabling SSL/TLS between YOUnite API service and YOUnite Adaptors. Since these certificates are being used only for enabling SSL/TLS encryption nothing else needs to be done for enabling SSL/TLS.
- Adapter Uuid: This uniquely identifies an Adaptor in the YOUnite system and is assigned at the time of creating or posting the Adaptor. Specify the adaptor Uuid using the property
younite.adaptor.uuid. - Oauth Server URL: Specify the Oauth server URL using the property
oauth.authorization.server.url. - Oauth Client Id: Specify Oauth client Id (may not be the same as the Adaptor Uuid), using the property
oauth.client.client-id. - Oauth Client secret: Specify Oauth Client secret, using the property
oauth.client.client-secret.
For example:
activemq.broker.url=nio+ssl://docker.local:61617
oauth.authorization.server.url=http://localhost:8080
oauth2.client.client-id=074554bd-2ab7-4249-8267-8747459d82ab
oauth2.client.client-secret=66e2caa4-c656-4b94-9d44-dc0b90320b02
oauth2.client.grant-type=client_credentials
younite.adaptor.uuid=defaultUuid
Running API server in IDE and the rest of the stack using docker-compose
Please see the instructions at this page.