Connect your Cloud Foundry foundations to DESK
To connect your Cloud Foundry foundations to DESK, follow the steps below.
Set up Cloud Foundry integration
1. Install an ActiveGate
To connect your Cloud Foundry foundations to DESK and use the Cloud Foundry overview page as well as the automatic detection of your Cloud Foundry organizations in addition to other Cloud Foundry process properties like space
, space ID
, application
, application ID
, and instance index
you need to install an ActiveGate.
Note: The Cloud Foundry overview page requires an ActiveGate (version 1.155+) in combination with DESK OneAgent version 1.155+ and DESK Server version 1.156+. You can leverage the automatic detection of your Cloud Foundry organizations with ActiveGate version 1.151+ in combination with DESK OneAgent 1.151+ and DESK Server version 1.152+.
2. Connect your Cloud Foundry foundations through the product settings
We recommend that you use a Cloud Foundry admin read-only account for connecting your Cloud Foundry foundation to DESK. Such an admin read-only account can view almost all Cloud Controller API resources but it's not permitted to modify them. To create such an account, run the following commands:
uaac user add ReadOnlyUser -p SecretPassword --emails something@example.com
uaac member add cloud_controller.admin_read_only ReadOnlyUser
uaac member add scim.read ReadOnlyUser
DESK queries the following endpoints to detect organizations, spaces, and applications associated with your connected Cloud Foundry foundation:
v2/organizations
v2/organizations/spaces
v2/spaces/apps
DESK will query the following Cloud Foundry API endpoints to detect the organization property and attach it to related process groups:
v2/organizations
v2/organizations/<orgid>/spaces
v2/spaces/<spaceid>/apps
To connect your Cloud Foundry foundation
- Go to Settings > Cloud and virtualization > Cloud Foundry.
- Click Connect new foundation.
- Type in your Cloud Foundry API target URL, your Authentication endpoint, your Cloud Foundry Username, and Password.
Configure ActiveGate
For environments with proxies or self-signed certificates as well as for ActiveGate versions 1.151 or 1.153, you need to adapt the configuration of your ActiveGate. You'll find details for environments with proxies or self-signed certificates on the ActiveGate configuration page. Following configuration, don't forget to restart the ActiveGate service.
Configuration for ActiveGate versions 1.151 or 1.153
To enable the detection of the Cloud Foundry organization
property within a version 1.151 or version 1.153 ActiveGate configuration, you need to adapt your custom.properties
file by adding the following set of parameters:
[cloudfoundry_monitoring]
cloudfoundry_monitoring_enabled = true
cloudfoundry_oauth_client_id = cf
cloudfoundry_oauth_client_user = cf
cloudfoundry_oauth_client_password =
Note: DESK supports querying of up to 100 organizations per Cloud Foundry foundation with ActiveGate versions 1.151 and 1.153.