Using Signal Sciences Service Broker for VMware Tanzu

This topic describes how to use Signal Sciences Service Broker for VMware Tanzu.

Enable the Agent for Your App

To use the Signal Sciences service with your app, you must first enable the Signal Sciences agent that runs within the app.

Overview

The Signal Sciences Agent does the following:

Enable

To enable the Signal Sciences agent with your app, the SIGSCI_ACCESSKEYID and SIGSCI_SECRETACCESSKEY environment variables must be set. All languages and frameworks are supported.

  1. Set the agent keys environment variables of your app using cf set-env:

    • Agent keys, which can be obtained from the Agents page in the Signal Sciences Dashboard
      • cf set-env MyAppName "SIGSCI_ACCESSKEYID" "1234-EXAMPLE"
      • cf set-env MyAppName "SIGSCI_SECRETACCESSKEY" "ABCD-EXAMPLE"
    • Optional Agent Configuration
      • SIGSCI_SERVER_HOSTNAME - Specify a specific hostname for each agent. This is what gets displayed in the Signal Sciences Dashboard UI, and it should be a unique name per instance.
      • SIGSCI_AGENT_VERSION - By default the latest version of the Signal Sciences agent will be installed. To specify a different version set the SIGSCI_AGENT_VERSION environment variable to the desired version number.
      • SIGSCI_REQUIRED - By default, if the Signal Sciences agent fails to start (e.g. invalid agent keys), this will not prevent the app from starting. To ensure your app is not started without Signal Sciences set SIGSCI_REQUIRED environment variable to true.
      • For a complete list of agent configuration options, see the agent configuration documentation, https://dashboard.signalsciences.net/documentation/installation/agent-configuration.
  2. Ensure your app process obtains its listening port from the $PORT environment variable. Typically, this does not require any changes to your app.

  3. When deploying your app, you must include the Signal Sciences buildpack before the final buildpack. For example, if MyAppName is a go app: * cf push MyAppName -b sigsci_cloudfoundry_buildpack -b go_buildpack

Use the Signal Sciences Dashboard

With Signal Sciences enabled, every time your app is deployed and running, you have visibility into common web attacks and anomalies via the Signal Sciences Dashboard.

In the Dashboard, you can enable blocking to protect your app from attacks like SQL Injection, Cross-Site Scripting, Directory Traversal, Command Execution, etc. Also, by leveraging Signal Sciences custom signals you can enable visibility and protection over the business risks associated with your app, e.g. Account Takeover, High Risk Transactions, Vulnerability Discovery, and Policy Validation.