The Box connector retrieves data from a Box.com cloud-based data repository. To fetch content from multiple Box users, you must create a Box app that uses OAuth 2.0 with JWT server authentication. For limited testing using a single user account, you can create a Box app that uses Standard OAuth 2.0 authentication.
This topic explains how to configure Box.com authorization, access, and refresh tokens.
Fusion supports two methods of authentication with the Box API:
-
JSON Web Token (JWT)
-
OAuth2
Box App Users Using JWT
Box.com has rather recently released a Box Developer Edition. The Box Developer Edition lets a user access an application without having to create their own Box account.
App Auth uses the JSON Web Token (JWT) authentication architecture to establish a trusted connection with Box, allowing an application to provision and manage a Box account while minimizing the number of logins for a user and authentication services to manage.
For this option, Fusion needs the inputs below to crawl your Box data.
Required options are highlighted.
UI Label, API Name |
Description |
---|---|
JWT App User ID |
The Developer Edition API App User ID that you want to crawl as. |
JWT Public Key ID |
The public key prefix registered in Box Auth that you want to use to authenticate with. |
JWT Private Key |
Base64-encoded JWT private key for the app user you want to authenticate as. (Fusion 5.0+ only.) |
JWT Private Key File Path |
Path to the JWT private key file for the app user you want to authenticate as. (Prior to Fusion 5.0 only.) |
JWT Private Key File Password |
The password that secures the public key. |
Tip
|
The biggest advantage to using the JWT App Auth Users approach is that you don’t have to generate new refresh tokens. The public/private key file combination remain valid indefinitely. |
Authentication Using OAuth 2.0
For limited testing using a single user account, you can create a Box app that uses Standard OAuth 2.0 authentication.
-
Log in to your Box developer account as the Admin.
-
Open the Box Developers web portal.
-
In the top right corner, click Log In.
-
-
Open the page for creating a new app and click Create New App.
-
Click Custom App, and then click Next.
-
Click Standard OAuth 2.0 (User Authentication), and then click Next.
-
Name your app, and then click Create App. The name must be globally unique across all apps created by all Box users.
-
Click View Your App.
-
On the Configuration page:
-
Click the Authentication Method Standard OAuth 2.0 (User Authentication).
-
Set the Redirect URI to
http://localhost
orhttp://0.0.0.0
. This address is not used by Fusion, but cannot be left blank. -
Click Save Changes.
-