Spring Cloud Services v1.3

Spring Cloud® Connectors

Page last updated:

To connect client applications to the Config Server, Spring Cloud Services uses Spring Cloud Connectors, including the Spring Cloud Cloud Foundry Connector, which discovers services bound to applications running in Cloud Foundry.

Service Detection

The connector inspects Cloud Foundry’s VCAP_SERVICES environment variable, which stores connection and identification information for service instances that are bound to Cloud Foundry applications, to detect available services. Below is an example of a VCAP_SERVICES entry for the Spring Cloud Services Config Server.

  "p-config-server": [
    "credentials": {
     "access_token_uri": "",
     "client_id": "p-config-server-c4a56a3d-9507-4c2f-9cd1-f858dbf9e11c",
     "client_secret": "9aGx9K5Vx0cM",
     "uri": ""
    "label": "p-config-server",
    "name": "config-server",
    "plan": "standard",
    "tags": [

For each service in the VCAP_SERVICES variable, the connector considers the following fields:

  • tags: Attributes or names of backing technologies behind the service.
  • label: The service offering’s name (not to be confused with a service instance’s name).
  • credentials.uri: A URI pertaining to the service instance.
  • credentials.uris: URIs pertaining to the service instance.

Config Server Detection Criteria

To establish availability of the Config Server, the Spring Cloud Cloud Foundry Connector compares VCAP_SERVICES service entries against the following criteria:

  • tags including configuration

Application Configuration

When the connector detects a Config Server service instance which has been bound to the application, it will automatically set the property in the client application’s environment, using the URL provided in the Config Server instance’s credentials object. The connector will also set additional security properties to allow the client application to access the Config Server service instance.

See Also

For more information about Spring Cloud Connectors, see the following:

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