Task Roadmap: Setting Platform Services

The following task roadmap shows the basic steps required to get started with Predix platform services.

#TaskDescription
1Set up your trusted issuer.Create an instance of the User Account and Authentication (UAA) service. UAA is the authorization server that each platform service uses for authentication.

For more information, see uaas-get-started.html#task_y1l_vms_2s.

Tip: The maximum number of UAA instances that you can create in your space is 10. As a best practice, use the same UAA instance with each of your services.
2Create an instance of your service.Select the service that you need from the Predix.io catalog and create an instance of your service.

For more information, see t_creating_a_platform_service_instance.html#task_486d337a-4349-a80c-b4447d267f9912345

3Create OAuth2 clients to setup access to your service authenticated using UAA. When you create a UAA instance, an admin client is automatically created for you to access UAA for additional configuration. You can create a new client for your service instance with specific scopes. If an Oauth2 client already exists, you can update the client to add your service instance.

For more information, see uaas-managing-clients.html#task_79a81b74-552e-4f74-abfc-bd37e6adac87.

4Update the Oath2 client to add service specific scopes or authorities. To enable your application to access a platform service, your JSON Web Token (JWT) must contain the scopes required for a platform service.

For more information, see uaas-managing-clients.html#task_k3h_k2c_1x.

5Bind your application to the service instance.To establish communication between your application and the platform service, you must bind the application to the service.

For more information, see t_connecting_your_app_to_a_platform_service_instance.html#task_2e2b8b0f-9a72-41d2-be37-273f01f8e47f.

6Start using your services.Your service instances are listed on the Console page when you sign into Predix.io.

For more information on using a specific service instance, use the See Documentation button on each service information page on Predix.io.