Skip to end of metadata
Go to start of metadata

Introduction

As the connection will be an application that interfaces with Box, you will need to register at Box as a developer and create and authorize a Box application using the Box website. The application can have any name and settings. This can be done with a free Box Developer Account, available at Box Developers.

Box App Creation and Authorization Steps

At the Box website, create an app using the following steps.

  1. Log in at Box with your Box Developers account. (If you are at the regular Box account, you can reach the developer site by clicking the Dev Console link in the left sidebar.) Click on the Create New App button:

    Box application creation

  2. Select Custom App and then click the Next button:

    Box application creation

  3. Select to use OAuth2.0 with JWT (Server Authentication) and click the Next button:

    Box application creation

  4. Give a name to your app (shown here as #Connector-test) and then click the Create App button:

    Box application creation

  5. Once the app has been created, click the View Your App button:

    Box application creation

  6. Scroll down to the section Application Access and enable the option of Enterprise:

    Box application creation

  7. Scroll down to the section Application Scopes and enable the options of Manage Enterprise properties and Enable integrations:

    Box application creation

  8. Scroll down to the section Advanced Features and enable the options of Perform Action as Users and Generate User Access Tokens:

    Box application creation

    NOTE: On choosing Enterprise in Application Access section, the Advanced Features section will get refreshed and you will need to re-enable Generate User Access Tokens.

  9. Scroll down to the section Add and Manage Public Keys and click on the Generate a Public/Private Keypair button:

    Box application creation

    The JSON file with the generated private key will be downloaded automatically. Retain the file in a safe location, as you will need it when creating a connection in Cloud Studio.

    NOTE: This may require that you configure 2-step verification in your Box account. Follow the instructions provided by Box if required.

  10. From your application's web page, obtain the User ID as shown here:

    Box application creation

    In this example, an app named #Connector-test has been created. The clientID, clientSecret, publicKeyID, privateKey, passphrase, and enterpriseID will be in the downloaded JSON file.

    The JSON file can be downloaded through a button at the end of the application configuration page.

  11. Return to your regular Box account:

    Box application creation

  12. Click on Admin Console in the left side menu list:

    Box application creation

  13. In the Admin Console, click on Enterprise Settings in the left side menu list:

    Box application creation

  14. On the Enterprise Settings webpage, click on Apps, shown outlined in blue:

    Box application creation

  15. Scroll down to the Custom Applications section and click the Authorize New App button:

    Box application creation

  16. Copy the clientID from the downloaded JSON file generated above and paste it in as the API Key and click the Next button:

    Box application creation

  17. Click on the Authorize button:

    Box application creation

  18. Your app has now been authorized and you should see its name under the Custom Applications section:

    Box application creation

    NOTE: In this example, in addition to being the name of the app, #Connector-test will be the root folder on Box where any files you download, upload, or update with the connector will reside.

On This Page

Last updated:  Mar 30, 2019

  • No labels