Supporting Multiple PAS Instances

Page last updated:

Warning: Pivotal Cloud Foundry (PCF) v2.5 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.

This topic describes registering a service broker with multiple Pivotal Application Service (PAS) instances.

Overview

It may be necessary for the broker to know which PAS instance is making a given request. For example, when using Dashboard Single Sign-On, the broker is expected to interact with the authorization and token endpoints for a given PAS instance.

There are two strategies that can be used to discover which PAS instance is making a given request.

Routing and Authentication

The broker can use unique credentials, a unique URL, or both for each PAS instance. When registering the broker, you can configure different PAS instances to use different base URLs that include a unique ID. For example:

  • On PAS instance 1, the service broker is registered with the URL broker.example.com/123.

  • On PAS instance 2, the service broker is registered with the URL broker.example.com/456.

X-Api-Info-Location Header

All calls to the broker from PAS include an X-Api-Info-Location header containing the /v2/info URL for that instance. The /v2/info endpoint returns further information, including the location of that PAS instance’s UAA.

Support for this header was introduced in cf-release v212.