Box.com Connector Configuration
Create a service account with JWT authentication for Box.com file migration.
Overview
The Box.com connector uses JWT (JSON Web Token) authentication for secure server-to-server communication. This guide walks through creating a custom Box app and configuring it for migration.
Administrator Required
You need Box administrator privileges to create custom apps and authorize them for enterprise access.
Prerequisites
- Box administrator account
- 2-Step Verification enabled on your Box account
- Access to Box Developer Console
Step 1: Create Box Application
- 1 Log in to Box
Go to box.com and sign in with your administrator credentials
- 2 Access Developer Console
Navigate to the Box Developer Console
- 3 Create New App
Click "Create New App"
- 4 Select App Type
Choose "Custom App"
- 5 Select Authentication
Choose "Server Authentication (with JWT)"
- 6 Name Your App
Enter a name like "Cloudiway Migration"
Step 2: Configuration Settings
Configure your app for enterprise-wide access:
- 1 Open Configuration Tab
Click on your app to access its settings
- 2 Change App Access Level
Switch from "App Access Only" to "App + Enterprise Access"
- 3 Enable Advanced Features
Under "Advanced Features", enable:
- "Make API calls using the as-user header"
- "Generate user access tokens"
- 4 Save Changes
Click "Save Changes"
Step 3: Generate Authentication Keys
2-Step Verification Required
You must have 2-Step Verification enabled on your Box account before generating a private key. Enable it in your Box Account Settings if not already active.
- 1 Navigate to App Settings
In your app's Configuration page, scroll to "Add and Manage Public Keys"
- 2 Generate Key Pair
Click "Generate a Public/Private KeyPair"
- 3 Verify with 2FA
Complete the 2-Step Verification prompt
- 4 Download JSON File
A JSON file will automatically download. Rename it to "key.json"
Keep key.json Secure
The key.json file contains your private key and credentials. Store it securely and never share it publicly.
Step 5: Cloudiway Connector Setup
- 1 Navigate to Connectors
In Cloudiway portal, go to Configuration → Connectors
- 2 Create Box Connector
Click "New Connector" and select "Box.com"
- 3 Upload key.json
Upload your key.json file to the connector
- 4 Test & Save
Click "Test" to verify the connection, then "Save"
Disable 2FA (Optional)
After generating the key pair, you may disable 2-Step Verification on your Box account if desired. The key.json file contains all necessary authentication credentials.