Configure the Node.js agent for Pivotal Cloud Foundry (now VMware Tanzu)

Deploy the service broker application:

cf push contrast-security-service-broker

You should now see the service broker now appears in PCF. The service broker doesn't offer any plans by default. Configure plans with CONTRAST_SERVICE_PLANS environment variable. You can also use the Pivotal Ops Manager to set the environment variables. If you are using IBM Cloud, you can select the application, select Runtimeand then Environment Variables to set the value.

This example shows how to set the value in the command line:

cf set-env contrast-security-service-broker CONTRAST_SERVICE_PLANS
    " {
            "ServicePlan1": {
                 "name":"ServicePlan1",
                 "teamserver_url":"https://yourteamserverurl.com",
                 "username":"your_username",
                 "org_uuid":"00000000-1111-2222-3333-000000000000",
                 "api_key":"your_api_key",
                 "service_key":"your_service_key"
             },
             "AnotherServicePlan":{
                 "name":"AnotherServicePlan",
                 "teamserver_url":"https://yourteamserverurl.com",
                 "username":"your_username",
                 "org_uuid":"00000000-1111-2222-3333-000000000001",
                 "api_key":"your_api_key",
                 "service_key":"some_other_service_key"
                 }
             } "

    cf set-env contrast-security-service-broker CONTRAST_SERVICE_PLANS
    " {
            'ServicePlan1': {
                 'name':'ServicePlan1',
                 'teamserver_url':'https://yourteamserverurl.com',
                 'username':'your_username',
                 'org_uuid':'00000000-1111-2222-3333-000000000000',
                 'api_key':'your_api_key',
                 'service_key':'your_service_key'
             },
             'AnotherServicePlan':{
                 'name':'AnotherServicePlan',
                 'teamserver_url':'https://yourteamserverurl.com',
                 'username':'your_username',
                 'org_uuid':'00000000-1111-2222-3333-000000000000',
                 'api_key':'your_api_key',
                 'service_key':'some_other_service_key'
                 }
             } "

After you modify the environment variable, restage your application:

cf restage contrast-security-service-broker

The application also requires an environment variable for a username and a password:

cf set-env contrast-security-service-broker SECURITY_USER_NAME aSecureUsername
cf set-env contrast-security-service-broker SECURITY_USER_PASSWORD aSecurePassword

Create a service broker instance. Define at least one service plan for this. You must use the same username and password as above.

cf create-service-broker contrast-security-service-broker USER_NAME PASSWORD
<URL of your application>

cf create-service-broker contrast-security-service-broker USER_NAME PASSWORD
<URL of your application> --space-scoped

All service brokers start as private. Make it public with:

cf enable-service-access contrast-security-service-broker

Now that the service broker is working, create a service instance and bind it to the application. To create a service instance, run the following command:

cf create-service contrast-security-service-broker ServicePlan1 <name_of_service>

To bind it to your application, run the following command:

cf bind-service <app_name> <name_of_service>

You should see the agent start up with your application. You will also see your application in Contrast.

Download the Contrast service broker tile from the VMware Tanzu Network.

Select Import a Product then select the contrast-security-service-broker-#.#.#.pivotal tile that you downloaded.

The tile requires some configuration before you can deploy it. The service broker does not include service plans by default. You must add at least one before you can deploy the Contrast service broker tile. To add a service plan, select Service Plansin the Contrast service broker tile and select Add.

Complete these configuration parameters in the service plan:

After you define the service plan, select Save. If you want some applications to belong to different organizations, define the other plans you will need.

Select the Apply Changes in the dashboard. This may take some time to finish.

After you successfully deploy the service broker, you can bind the credentials to an application. Go to the Marketplace to find the Contrast service broker option.

Select the Contrast service broker option to see the available plans that you created in the Pivotal Ops Manager.

Use Select this Plan to choose the plan you want to bind to an application.

Specify an instance name for the plan. This doesn't affect the service broker. You can name the instance what you want.

In the Bind to App drop-down menu, select the application to bind to this service. Then restage the application. This will retrieve the latest agent from Contrast to instrument your application.

If you want to override agent properties, such as the application name, you can set environment variables in PCF. Here is a command line example:

cf set-env APP-NAME JAVA_OPTS " -Dcontrast.app.name.override=PivotalSpringApp
-Dcontrast.server=PivotalServerName "