Box Service Accounts
On This Page
Overview
A connection is how you grant DryvIQ access to the content in your Box Service Account. You will provide the connection information required for DryvIQ to connect to the platform/server. This grants DryvIQ access to the account so it can scan and analyze content according to the policies you create.
Creating a Connection
Select Content from the main menu.
Verify you are on the Connections tab.
Select Add connection.
Select Box (Service Accounts) as the platform on the Add connection modal.
Enter the connection information. See Connection Authentication Options below for details about each field.
Test the connection to ensure DryvIQ can connect using the information entered.
Select Done.
Connection Authentication Options
Below is a list of the authentication options available to create the connection. Select the options that work best for your account and the connection you are creating.
Field | Notes | Required |
|---|---|---|
Display as | Enter the display name for the connection. If you will create multiple connections, ensure the name clearly identifies each connection. The name displays in the application, and you can use it to search for the connection and filter lists. | Required |
User Type | Required | |
Connect as a standard user | Select this option to create a standard connection to access a user's files and folders. This is the default selection. | |
Connect as an administrator | Select this option to create an administrator connection. This requires administrator privileges and grants access to all accounts within the organization. | |
|
|
|
Client ID | This value will be provided by your administrator. It can be found in your Box Developers Console or in the boxAppSettings section of {{public key}}_config.json. | Required |
Client Secret | This value will be provided by your administrator. It can be found in your Box Developers Console or in the boxAppSettings section of {{public key}}_config.json. | Required |
Enterprise ID | Enter the Enterprise ID if the connection will list content for all users on your connection root. This field is not required when an Account ID is being used. The Enterprise ID cannot be used with an Account ID; the options are mutually exclusive. | Required if not using an Account ID |
Account ID | Enter the account ID (user ID) if the connection will impersonate a single account. This field is not required when an Enterprise ID is being used. The Account ID cannot be used with an Enterprise ID; the options are mutually exclusive. | Required if not using an Enterprise ID |
Public Key ID | Enter the public key for the account. This value can be obtained from your manually generated keypair or in the boxAppSettings section of {{public key}}_config.json. | Required |
Private Key | Enter the account's private key. This value can be obtained from your manually generated key, which is stored locally. | Required |
Password | Enter the password for the account. This value can be obtained from your manually generated keypair or in the boxAppSettings section of {{public key}}_config.json. The password is generated by Box when you create a keypair via the download keypair option in your Box Developers Console. | Required |
Behavior When Deleting Items | Select the type of delete DryvIQ should perform if a policy requires deleting items: Permanent or Soft. Soft delete is the default delete behavior; however, Permanent is the recommended behavior. A soft delete marks items as deleted and moves them to the platform’s deleted items. You can still access the"”m to restore the items or pe"”rmanently delete the items. A permanent delet the items. This deletion is not reversible. | Optional |