Box

Votiro and Box

The diagram below describes the architecture of the Votiro - Box interface;

Configuration of an App in Box to Integrate with Votiro

In the Box menu, select Dev Console (if you can’t find the button go to Dev Console).

On the My Apps page, Click on theCreate New App button:

Select Custom App:

On the Custom App pane:

Select the Authentication Method as Server Authentication (with JWT).

Type in an App Name (for example, Votiro-Box-Integration).

Click on the Create App button:

Select the Configuration tab, then select “App + Enterprise Access”:

Select App + Enterprise Access.

Make sure you check all the checkboxes under Application Scopes and Advanced Features:

Click the Save Changes button:

10.

Scroll down to Add and Manage Public Keys and click on Generate a Public/Private Keypair (this step might require 2FA approval) and save the prompted JSON file to your machine:

Note: If the JSON file is not downloaded, click again on Generate a Public/Private Keypair.

11.

Add the Votiro URL to the Allowed Origins section:

12.

Click the Save Changes button again:

13.

Select the Authorization tab and:

Click on Review and Submit.

Type an App Description

Click on the Submit button:

14.

Your Box admin should receive a confirmation email, similar to the screenshot below.
Click on Review App Details:

15.

You’ll get redirected to Box.com again.

Go to the Custom Apps Manager and select your new app.

Click Authorize and review your app settings.

Click on the Authorize button:

16.

After the Box app is configured, you must configure it in the Votiro Management Dashboard, as described in the following section.

Configuration of the Box App in the Votiro Management Dashboard

To get to the Box page, from the navigation pane on the left, click Cloud Connectors > Box.

The Box page contains the following fields:

Field	Description
Policy Name	Specify a policy for the Box connector to work with. Select the Default Policy if you have not created an alternative policy to use.
Box App Settings	To integrate with the Box account, add the Public/Private Keypair by pasting the content of the JSON file you saved to your machine when creating the Custom App in Box to integrate with Votiro. The keypair is located in the JSON file.
Channel Name	Specify the name of your channel. The channel name appears in the Incidents page as the name of a connector. In the example above, the channel name is "Box Connector".
Monitor All Users	Check this box to enable all users under the Box enterprise account to perform sanitization when uploading files to Box. *
*Monitored Users	* displayed only if Monitor All Users is not checked. The left column will contain all users under the Box enterprise account. To authorize specific users to be able to sanitize files, select the users from the left column and click Add. To deny sanitization authorization to specific users, select the users from the right column and click Remove. To add/remove all/no users, click the All/None buttons in the respective column.
*Monitored Groups	* displayed only if Monitor All Users is not checked. The left column will contain all groups under the Box enterprise account. To authorize specific groups to be able to sanitize files, select the groups from the left column and click Add. To deny sanitization authorization to specific groups, select the groups from the right column and click Remove. If a group is enabled/disabled for sanitization, all the group users are enabled/disabled even if the group users were not enabled/disabled in the Monitored Users field.

* If you uncheck Monitor All Users, the following options are displayed:

Box App Behavior when Uploading Files

Each file that an authorized user uploads to Box will be automatically send to sanitization. When the user uploads a file, Box will display a message:

After the sanitization is successfully completed, the original file will be replaced with the sanitized file, and Box will display a message indicating that a new version of the file was uploaded: