Creating and authorizing a Box developer App

You need to create a Box developer App before you can crawl Box files and folders.

Before you begin

You must create a Box account at Box. Enable 2-step verification in Box Security.

Procedure

Create an RSA keypair

  1. Run the following shell commands.
    openssl genrsa 2048 > private-box.pem
    openssl rsa -in private-box.pem -pubout -out public-box.pem

    Make a copy of public-box.pem.

    If you create a RSA key-pair with a passphrase, you must install unlimited strength JCE Policy files (local_policy.jar and US_export_policy.jar). For more information, see Installing JCE Unlimited Strength Files.

Create an App on the Box developer site

  1. Log in to Box Developers and create a new Enterprise Integration App.
  2. Select OAuth 2.0 with JWT (Server Authentication) and create the App.
  3. View the App and select Configuration.
  4. Copy the Client ID and Client Secret. You will use these items when configuring the crawler.
  5. Select Enterprise as Application Access.
  6. Enable all options of Application Scopes.
  7. Enable Perform Actions as Users and Generate User Access Tokens options in Advanced Features.
  8. Click Save Changes.
  9. Click Add a Public Key and enter the content of public-box.pem.
  10. Copy Public Key 1 ID. You will use this item when configuring the crawler.

Authorize the App

  1. Go to Admin Console.
  2. Select any department, check that you are managing a team, and thern click Get Started.
  3. On the Admin Console click Business Settings.
  4. On the Account info tab, copy the Enterprise ID. You will use this item when configuring the crawler.
  5. On the Apps tab click Authorize New App.
  6. Enter the Client ID as API Key, and then click Authorize.

    If you modify the App, you will have to authorize it again.