Box
Quick Start

Setup Box App

In order to be able to access the Box Content API, the connector must use OAuth 2.0 for authentication. For that reason, the connector must first be registered in your Box Enterprise. To do so, go to the following address and login with an admin account:

https://app.box.com/developers/console/newapp

  1. Create a "Custom App" by clicking on it.

    box 1 create custom app

  2. Determine a fitting App Name, the entries for Purpose are not of technical relevance. Then click "Next"

    box 2 select name

  3. Choose "Server Authentication (with JWT)" as the authentication method. Then click "Create App"

    box 3 authentication method

  4. Switch the App Access Level to "App + Enterprise Access"

    box 4 access level

  5. The Connector needs the "Write all files and folder stored in Box" privilege to index file content (This is selected by default).

  6. Further down, enable the Advanced Features "Make API calls using the as-user header" and "Generate user access token". Also provide or generate a pair of public/private keys. This requires the user to have 2FA enabled (See Box support).

    box 5 advanced features

  7. Clicking on "Generate a Public/Private Keypair" will trigger a file download with the JWT. This file can not be recovered, but you can generate a new one.

    box 7 auto download jwt

  8. You will need this JSON file and the eMail address of the admin account to configure the Raytion Box Connector.

  9. Click on "Save Changes"

  10. Navigate to "Authorization"

    box 9 authorization

  11. Click on "Review and Submit"

  12. Fill the "App Description" field and click "Submit"

    box 10 review submission

  13. Your review is now pending approval from a tenant administrator.

  14. As the admin account, navigate to the Box Admin UI https://app.box.com/master

  15. On the left, click on "Apps"

    box 11 admin left

  16. Click on the "Custom Apps Manager" tab

    box 12 custom apps

  17. You should see your approval request as "Pending Authorization"

    box 13 waiting approval

  18. On the right end of the row, click on the ellipsis and then on "Authorize App"

    box 14 authorize

  19. Click on "Authorize"

    box 15 authorize dialog

  20. Your app has now been approved.

    box 16 authorize admin success

  21. This status is also visible from the app overview

    box 17 authorize app success

Box is now prepared to be indexed by the Raytion Enterprise Search Connector.