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. For detailed information refer to the Box’s official documentation.

Integration Method: API

Tables: Authentication (3002), Detection Finding (2004), File Hosting Activity (6006)

This integration supports the following events.

This integration supports the following versions.

Note:

As of this document preparation, latest release was on Sept 27, 2024.

Prerequisites

• Access to the Box platform to generate API credentials.

• Access to the DataBee console.

Configuration Overview

1. Create an API Client and obtain the required authentication details, including the Client ID and Client Secret.

   1. Create Platform App.

   2. Authorize APP.

2. Create Box Data Feed in the DataBee console with the required API credentials.

   DataBee Parameter	Box Parameter
   Client ID	API Client ID
   Client Secret	API Client Secret

Box Configuration

Create Platform App

1. Before creating the app, make sure that 2FA (two-factor authentication) is enabled.

   1. Go to Box Account Settings.
       

   2. Select type of sign-in method as ‘Authentication App’ and click Next.
       

   3. Configure 2-Step Verification and click submit.
       

2. Login to Box Dev Consol.

3. Click on Create Platform App.
    

4. From Box Developer Console, Select Custom App.
    

   1. Enter an App Name and provide a description. Select Purpose and Categories according to your requirement.
       

   2. Select authorization method “Server Authentication (Client Credentials Grant)”.

   3. Click on Create App button.
      
      

5. Copy the Client ID for later use.
    

6. Click on Fetch Client Secret and complete 2FA.
    

7. Click again on Fetch Client Secret and copy Client Secret.
    

8. Change the app access level to App + Enterprise Access.
    

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

   Note:

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

   Reference: Reference Events.

Authorize APP

1. Login to Admin Console after building the App from Developer Console to authorize that app.

2. From Box Admin Console, Navigate to Integrations.
    

3. Navigate to Platform Apps Manager and click on Add Platform App button.

4. Add Client Id which you have copied from the previous step and click on Next.
    

5. Click on Authorize.
    

6. In the 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 the DataBee integration.
    

DataBee Configuration

1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button
    

2. Search for the Box and click it as shown below.
    

3. Click on the API Ingest option for the collection method.
    

4. Enter feed contact information and click Next.
    

5. In the endpoint configuration page, fill in the following:

   1. Authorization Method: OAuth2

   2. API Base URL: this is the base URL that DataBee will interact with.

   3. Client Key: paste the Client Id.

   4. Client Secret: paste the Client Secret.

   5. Box Subject Id: paste the Enterprise Id.

   6. Token URL: Token URL.

   
   

6. Click Submit.

Troubleshooting Tips

• Ensure the Client ID and Client Secret are entered correctly. Since you cannot view the secret after the first time, store it securely in a text editor to verify there are no spaces or unexpected characters before configuring the DataBee integration.

• Verify that the required Box API scopes/permissions are correctly configured.

• Ensure you are using Box API version 2.0, as this integration has been tested against it.