Connecting and disconnecting your Box account¶

This article describes how to connect your Box account for Coro protection.

Prerequisites¶

Before you begin, make sure you have the following prerequisites:

• A minimum subscription of Box "Enterprise"
• Full administrator access for your Box subscription

Connecting to Coro¶

To connect your Box account for Coro protection:

1. Create a new app in Box
2. Connect your Box app to Coro

Creating a new app in Box¶

Use this process to create a new application for Coro in the Box developer console.

Perform the following steps:

1. Sign into your Box developer console:

   https://account.box.com/login?redirect_url=%2Fdevelopers%2Fconsole

2. In My Apps, select Create New App:

   

3. Choose Custom App, then select Next:

   

4. In the Custom App dialog:

   1. For Authentication Method, choose Server Authentication (with JWT).
   2. Specify an App name.
   3. Select Create app.

   

5. In your new application:

   1. Switch to the Configuration tab.
   2. For App Access Level, choose App + Enterprise Access.
   3. For Application Scopes, set the following permissions:
      • In Content Actions, leave all settings as their default values (only Read all files and folders stored in Box is enabled).
      • In Administrative Actions and Developer Actions, enable all settings.
   4. For Advanced Features, enable all settings.

   

6. Select Save changes at the top-right corner of the screen.

   

7. Locate the Add and Manage Public Keys section and select Generate a Public/Private Keypair.

   Info

   You are required to confirm this operation through 2FA (two-factor-authentication).

   

   This generates a configuration file for your app.

   Important

   Save this file to your local workstation. Coro uses it to configure access to Box.

8. Select OK to close the confirmation dialog, then select Save changes at the top-right corner of the screen:

   

9. Switch to the Authorization tab and select Review and Submit:

   

10. In the Review App Authorization Submission dialog, review the presented App Info, then select Submit.

    

11. Select Back to My Account:

    

12. Select Admin Console:

    

13. Select Apps from the side menu, then switch to the Custom Apps Manager tab.

14. Find the record of your newly created Coro app, select the adjacent 3-dots menu, then select Authorize App:

    

15. In the Authorize App dialog, check the information is correct and select Authorize.

    

The process is now complete.

Connecting your Box app to Coro¶

1. Log into the Coro console.

2. Navigate to Control Panel > Cloud applications:

   

3. On the Cloud applications page, select CONNECT adjacent to the Box logo, or use the + CONNECT button at the top:

   

   Note

   If you have no connected apps, Coro shows a banner page instead:

   

   In this scenario, select CONNECT CLOUD APPS or + CONNECT to start the process. Then, select Box from the app selection pop-up that follows.

4. The Connect to Box dialog is displayed:

   

5. Step 1 requires you to create a new Coro app in Box. This process is described in Create a new app in Box.

   If you have already created a Coro app in Box, select CONTINUE.

6. In Step 2, specify the configuration file downloaded as part of the Box app creation process, then select CONFIRM:

   

Box is now connected to Coro and is shown as Connected:

Disconnecting your Box account¶

To disconnect Box from Coro protection:

1. Log into the Coro console and navigate to Control Panel > Cloud applications.

2. Select DISCONNECT adjacent to the Box logo.

3. Select YES, DISCONNECT, once a confirmation dialog is displayed.

Box is now disconnected from Coro protection.