Box: Configuring the App Activities Integration

This article explains how to configure the App Activities integration for Box

Overview

App Activities provides you with an API-based solution for out-of-band visibility of all activity made by any user in a connected SaaS application. To provide App Activities with visibility of data within an app, you need to set up an integration with the required application. Once you create the integration, if a field has changed or expired, you can edit it from the Resources >Integrations > Integrated Apps page. For more information, see What is Application Control via API with App Activities.

To configure the App Activities integration, you need to:

Configure the integration within the SaaS application
Create the API connector in the CMA

A CASB license is required for App Activities. This license includes app and data control and App Activities via API. For more about purchasing a CASB license, please contact your Cato representative.

Configuring the Box Integration

To configure the Box integration create a Platform App.

Prerequisites

You must have purchased the Box Enterprise license

Step 1: Configure the Integration in the Box Developer Center

In the Box Developer Center, identify the Enterprise ID and Client ID to enter into the CMA.

To configure the Box integration:

Login to the Box Developer Center (https://<your_tenant>.app.box.com/developers/console)
On the My Platform Apps page, click Create Platform App
Click Custom App.
Add a name for the app
In the Purpose field, select Integration and in the Category field, select Security & Compliance and click Next.
Select Server Authentication (Client Credentials Grant) and click Create App.
On the General Settings page, copy the Enterprise ID so it can be added into the CMA.
On the Configuration page:
- Click Fetch Client Secret. Copy the Client Secret and the Client ID so they can be added into the CMA.
  
  Note: Two Factor Authentication must be enabled for the Client Secret to be displayed.
- Select App + Enterprise Access
On the Authorization page, click Review and Submit.
The Box account admin receives an email from which approval for the integration needs to be approved.

Step 2: Create the API Connector in the CMA

After you have set up an integration with the required application, add the details in the CMA.

To create the API connector in the CMA:

From the navigation menu, click Resources > Integrations.
Click the Integrated Apps tab.
Click New.

The New Integration panel opens.
Select the SaaS Application you want to add.
In the Capability drop down select App Activities.
Add the details created during step one.
Click Save.
The app is visible on the Integrated Apps table with a Connected status.

After connecting your APIs, you can track the App activities in the Cloud Activities dashboard. Data may take a few minutes to appear.

Sources

Login - using the OAuth endpoint
Events - Querying the Events endpoint with the admin_logs stream_type

Known Limitations

All events are currently fetched