Box

Box is a cloud content management platform designed to help businesses manage and collaborate on files securely. It provides solutions for file storage, sharing, and collaboration, allowing users to access their content from anywhere while ensuring data security.

Integration Method: API

Tables: Authentication, Detection Finding, File Hosting Activity

This integration has been tested against Box API version 2.0.

Box Configuration

You will need to create the API Client and get the necessary information for API authentication such as Client ID and Client Secret. These values are needed to configure the DataBee integration.

Create API Client

• Before creating the app, make sure that 2FA (two-factor authentication) is enabled
• From Box Developer Console, Navigate to My Apps

• Click on Create New App.

• Select Custom App

• Give App Name to identify App in future, provide a description that describes the purpose for the App, if desired. Select Purpose and Categories according to your requirement.
• Select authorization method “Server Authentication (Client Credentials Grant)”
• Click on create app button
• Copy the Client ID, and Client Secret
• Change the app access level to App + Enterprise Access

• In Application scope, select all Administrative Actions checkbox and then click on Save Changes

Note: You will not be able to view client secret again after you complete this step. Ensure that you copy it before closing it.

Reference: https://developer.box.com/reference/get-events/ 

Authorize APP

• Login to Admin Console after building the App from Developer Console to authorize that app
• From Box Admin Console, Navigate to Apps
• Navigate to “Custom Apps Manager” and Click on “Add App” button
• Add Client Id which you have copied from the previous step and click on Next

• Click on Authorize
• In Admin console navigate to “Account & Billing” and save “Enterprise ID” . This is also known as “Box Subject id” also which will be required while configuring databee UI.

DataBee Configuration

• To configure the Data Source, login into the Databee UI and click on Add New Data Source. Search and click on the Box as mentioned below.

• Click on the API Ingest option for collection method. Give the name of the Data Source and other relevant information as mentioned below.

• In the endpoint configuration page, fill in the following:
  • Authorization Method: OAuth2
  • give the Base URL found in the previous step of the API Client generation.
  • Client Key: Fill in with the Client Id
  • Client Secret: Fill in with the Client Secret
  • Box Subject Id: Fill in with the previously saved Enterprise Id
  • Token URL: https://api.box.com/oauth2/token

• Click Submit