Skip to main content

Box

The Box connector API provides information about various events of the entire enterprise from the given Box account. Box connector uses the box-sdk to pull box enterprise event logs into DNIF.

Pre-requisites​
  • Create a Box application
Steps to create a Box Application​

image 1-Nov-16-2023-09-55-53-6336-AM

  • Select Custom App and then select Server Authentication (with jwt).

  • Enter the App Name and click Create App

  • In the Configuration tab, your Client ID and Client Secret will be displayed.

image 2-Nov-16-2023-09-56-18-8720-AM

  • Change the App access level to App Access + Enterprise Access in the configuration.

image 3-Nov-16-2023-09-56-40-2257-AM

  • Under Application Scopes in the configuration tab, select the following options (preferably all) based on the data you want to pull from your Box account.

    • Read all files and folders stored in the box

    • Write all files and folders stored in the box

    • Manage users

    • Manage groups

    • Manage enterprise properties

  • Under Add and Manage Public Keys in the configuration tab, click Generate public/private key pair after which it will automatically download a json file.

  • Ensure to save this downloaded json file.

  • Save all changes and click on review and submit button in the Authorization tab.

Re-submit the app if any changes are made after submission.

Configurations​

The following configurations should be completed to forward Box Connector logs to DNIF.

image 4-Nov-16-2023-09-57-04-3556-AM

FieldDescription
Connector NameEnter a name for the connector
Connector TypeEnter Box Connector
Config FileCopy and paste the content from xxxx_config.json file, downloaded while creating box connector account.

  • Click Save after entering all the required details and click Test Connection, to test the configuration.

  • A Connection successful message will be displayed on screen along with the time stamp.

  • If the connection is not successful an error message will be displayed. Refer Troubleshooting Connector Validations for more details on the error message.