Supporting Multiple PAS Instances

Overview
Routing and Authentication
X-Api-Info-Location Header

Page last updated:

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.

Create a pull request or raise an issue on the source for this page in GitHub