Add or edit a Box connection

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

Step 1: Create your Box application

Google Workspace Migrate uses a JSON Web Token (JWT) 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 Custom App.
3. Click Server Authentication (with JWT) and in for App Name, enter a name.
4. 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. For App Access Level, select App + Enterprise Access.
   2. For Application Scopes, uncheck Manage groups and Manage enterprise properties.

      You should have 3 application scopes checked—Read all files and folders stored in Box, Write all files and folders stored in Box, and Manage users.

   3. For Advanced Features, check Make API calls using the as-user header.
   4. For 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 Google Workspace Migrate.

      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. For 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. Click Custom Apps ManagerAdd App.
3. For Client ID, 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.
6. Your new app appears under Custom Applications.

Step 3: Add a source connection for Box

1. In the Google Workspace Migrate platform, click New Connection.
2. For Name, enter a connection name.
3. For Type, select Box.
4. For 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 Google Workspace Migrate to access the Box APIs using the App configured above.

5. Click Create.

Next step

Create a sharding users list (Optional)