Add or edit a Box connection

You add a source connection to allow G Suite Migrate to read, convert, and transfer data from Box® to your G Suite account. Before you add a source connection, you need to authenticate your Box enterprise account.

Create your Box application

G Suite Migrate uses OAuth 2.0 with JSON Web Token (JWT), an open standard for access delegation, to connect to your Box enterprise account.

  1. Go to the Box developer console and click Create New App.

    You might need to sign in to your Box enterprise account first.

  2. Click Enterprise Integration, then click Next.
  3. Click OAuth 2.0 with JWT (Server Authentication), then click Next.
  4. Enter an app name, then click Create App.
  5. After it's created, click View Your App.

    You will be redirected to your app's Configuration page.

  6. On the app Configuration page, make the following changes:
    1. Under Application Access, select Enterprise.
    2. Under Application Scopes, uncheck:
      1. Manage groups
      2. Manage enterprise properties

      You should now only have 3 Application Scopes checked:

      1. Read all files and folders stored in Box
      2. Read and write all files and folders stored in Box
      3. Manage users

      Note: The "Read and write all files and folders stored in Box" Application Scope is required to download files from Box. G Suite Migrate does not write data to your Box account.

    3. Under Advanced Features, select Perform Actions as Users.
    4. Under Add and Manage Public Keys, click Generate a Public/Private Keypair.

      This will automatically download a JSON configuration file with your app settings, including the only copy of your private key, to your machine. Store this file securely as you will use it below to configure the Box connection in G Suite Migrate.

      Note: To download this file, you might need to turn on 2-Step Verification on your Box enterprise account. For more information, see Box documentation to Enable 2-Step Verification.

    5. Under OAuth 2.0 Credentials (near the top of the page), copy the Client ID.
    6. Click Save Changes.

Authorize your Box application

  1. Go to the Apps tab in the Box Admin Console.
  2. Under Custom Applications, click Authorize New App.
  3. Under API Key, enter the Client ID copied from the Configuration page, then click Next.
  4. On the confirmation dialog, under For the following users, make sure it authorizes access for All Users.
  5. Click Authorize.

    Your new app appears under Custom Applications.

Add a source connection for Box

  1. In the G Suite Migrate platform, click New connection or New New and then Connection.
  2. Enter a connection name.
  3. Under Type, select Box.
  4. Under Account, choose an option:
    • Select a Box enterprise admin account.
    • Click Add new account and upload the JSON configuration file previously downloaded from your app's configuration page on Box.
      This allows G Suite Migrate to access the Box APIs using the App configured above.
  5. Click Create.

Edit a connection

  1. In the G Suite Migrate platform, click Connections. You might have to click Menu Menu first.
  2. Point to the connection and click More More and then Edit.
  3. Enter your changes and click Save.

Next step

Create a sharding users list (Optional)