Box Connector

Overview

This topic describes how to configure and use the Aisera's Box connector as a data source.

The Box connector uses the File Data data source during setup. This method increases your flexibility by allowing you to Easily ingest data from multiple non-contiguous folders and sub-folders. This configuration supports the following key features.

Multiple Folder Ingestion

In the Data Source configuration, you can enter multiple Box Folder IDs separated by commas in the Folder Id parameter. This allows you to include content from several specific folders within a single data source.

Recursive Folder Crawling

When Enable Recursion is selected, the connector will automatically crawl and ingest supported files from all sub-folders nested within the specified Folder IDs. This eliminates the need to manually add every sub-folder ID individually when you want to include nested content.

Prepare

Authorization

The Aisera Box connector supports OAuth 2.0 for authentication. You will need to create a Custom Application on the Box Platform to authorize the Aisera Platform to ingest data. Go to Setup with OAuth 2.0 for instructions on how to do this.

You will need to set the Redirect URI during the setup of the custom application. The redirect URI is: https://<your_tenant>.login.aisera.<top_level_domain>/?id=aisera.oauth.oauthCommand

You will need to enable the following options in the Application Scopes:

• Write All files and Folders Stored in Box

• Manage Enterprise Properties

For the integration step, take note of the following credentials:

• Access Token URL

• Authorization URL

• Client Id

• Client Secret

Manual Approval

You may need to manually approve the application if the application if the application is inactive by default. Go to Platform App Approval to learn about how to enable an application.

Integration Setup

1. In the Aisera Admin UI navigate to Settings > Integrations

2. Click on + New Integration

3. In the menu, select Box and click Next

   
4. Enter the configuration details, then click Next

   Field

   Description

   Name

   The name used to identify the integration

   Description

   A description of the integration and it's purpose

5. Under the Auth Type dropdown select OAuth

   
6. Enter the collected credentials

7. Click OK

When you click Ok you will be directed to the Box Platform to authorize the Aisera Platform to use OAuth. When authorization is complete the integration will be saved.

Data Source Setup

To set up the File Data data source for the Box connector:

1. In the Aisera Admin UI navigate to Settings > Data Sources

2. Click + New Data Source in the upper right corner

3. Select File Data and click Next

   
4. Select Cloud Files. You can now see the integrations that are available for your tenant

   
5. Choose the Box integration that you created in Step 2

6. After you enter the integration, you will see the updated Folder Id parameter. Enter a comma-separated list of Folder Ids corresponding to the folders you want to ingest data from

7. All remaining options are optional. See the section below for more information. Click Next until the window closes to complete the creation of the Data Source

Optional Configurations

Enable Recursion

When enabled, the Aisera Platform will check for and ingest content from all subfolders contained in the folders listed in the Folder Id field.

Post Setup Actions

Your Aisera team can use test knowledge articles to ingest and then determine the specific fields that are mapped, if your data source administrators want to restrict the access of the Aisera Service User account to only those fields.