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.

Step1: 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're 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 Manage groups and Manage enterprise properties.

      You should now have 3 Application Scopes checked—Read all files and folders stored in Box, Read and write all files and folders stored in Box (required to download files from Box and is not used to write data to your Box account), and Manage users.

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

      A JSON configuration file with your app settings, including the only copy of your private key, is automatically downloaded to your machine. Store this file securely as you need it 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 your Box documentation.

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

Step 2: 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.

Step 3: Add a source connection for Box

  1. In the G Suite Migrate platform, click New ""and thenConnection.
  2. Under Name, 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.

      Doing so allows G Suite Migrate to access the Box APIs using the App configured above.

  5. Click Create.

Edit a connection (Optional)

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

Next step

Create a sharding users list (Optional)

Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.