Box lets users securely store, access, share, and collaboratively work on files across devices. It is accessible through web and mobile applications and REST APIs. It features functions such as search, metadata, granular permission models, enterprise-grade security, retention policies, and preview capabilities.

Supervisor configuration parameters

To configure the connector, following parameters are required:

• Connector name

• Client Id

• Client Secret

• Public Key

• Private Key
• Pass Phrase
• Enterprise Id

• Instance DateTime Offset (refer Configuring additional datetime offset in connectors for more details)

To get the Box credentials

1. Create an account in Box.

2. Log in to the Box account . The URL will be similar to https://{Business_Name}.app.box.com/folder/0.

3. Navigate to the Developer console.

4. Create a new custom application.

5. Select OAuth 2.0 with JWT (server authentication) as the authentication method.

6. Enter a relevant name for the application that is to be created.

7. Click View App and navigate to the Configuration section.

8. Set the value of Application Access to Enterprise.

9. Enable the advanced features by selecting the following options:

   • Perform action as Users
   • Generate User access token

10. In the Add and manage public keys section, click generate Public/Private Key pair button. A config JSON file gets downloaded and it includes the credentials, that are required to get the access token for authentication.

Supported objects and operations

Users

Table 72: Supported operations for Users

Operation	VERB
Create	POST
Update	PUT
Delete	DELETE
Get user by Id	GET
Get all users	GET
Get all users with pagination	GET

Groups

Table 73: Supported operations for Groups

Operation	VERB
Create	POST
Update	PUT
Delete	DELETE
Get group by Id	GET
Get all groups	GET
Get all groups with pagination	GET

Mandatory fields

Users

• DisplayName
• Email ID

Groups

• DisplayName

The user and group mappings are listed in the tables below.

Table 74: User mapping

SCIM parameter	Box parameter
id	id
login	email[0].value
login	userName
name	name.formatted
name	displayName
status	active
address	address[0].formatted
type	userType
phone	PhoneNumbers[0].Value
status	active
job_title	title
language	preferredLanguage
timezone	timezone
created_at	meta.created
modified_at	meta.lastModified
emailAliases.entries[].id	userExtension.additionalEmails[].id
emailAliases.entries[].email	userExtension.additionalEmails[].value
emailAliases.entries[].is_confirmed	userExtension.additionalEmails[].is_confirmed

 

 

Table 75: Group mapping

SCIM parameter	Box parameter
id	id
displayName	name
created_at	created
modified_at	lastModified
user[].id	members[].value
user[].name	members[].display

Connector limitations

There might be a performance impact when you add or remove multiple email aliases since the cloud application processes them one by one.