Box Streaming Configuration

This guide provides steps on how to enable real-time data streaming for a Box connection and monitor streaming events within the Forcepoint DSPM platform.

Prerequisites

Existing Box app

If you have not created Box credentials yet, follow this guide to Box app scan and ensure the necessary credentials are set up.

Additional scope to Box app

Data streaming needs Manage webhooks scope, as shown below.

Create a New Scan Configuration

  1. From the Data Sources page, select Box from the list of available data sources. In the Scan Configurations list, create a New Configuration.

  2. Make sure the connection has a Name and Credentials set. Then select the Path icon.

Pick a Folder for Real-Time Events

  1. Click on the Folder icon in the Path field to select the folder you want to monitor for real-time events.
    • Magnifying glass icon: Folders with this icon next to them indicate that real- time events can be subscribed to from this directory.

  2. After selecting the folder, click Save & Close to finalize the changes.

  3. Clock icon: When data streaming is being activated, the clock icon will appear, indicating that the subscription is being processed. Once the subscription is activated, this icon will change to a green magnifying glass.
  4. After enabling Data Streaming, the system will automatically handle the subscription to Boxʼs real-time events. There is no need to manually configure Webhooks.

View the created webhook in Box UI

You can view the configured webhook in your Box Dev Console

  1. Login to your Box account and navigate to Dev Console.
  2. Select the Box app configured in previous steps.

  3. Navigate to Webhooks tab, here you can see the list of configured webhooks.

Monitoring Real-Time Events

After the subscription is activated (green magnifying glass icon), real-time events will start flowing into the platform, and you will be able to monitor them from various sections of Forcepoint DSPM.

Viewing Events in the Live Events Section

  1. Navigate to the Live Events section under Administration to view a detailed audit log of all streaming events.

  2. In this section, you can filter and view event details.