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 an application in Box
  2. Connect your Box application to Coro

Creating an application in Box

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

Perform the following steps:

  1. Sign in to your Box developer console:

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

  2. In My Apps , select Create New App :

    Create new Box app

  3. Choose Custom App , then select Next :

    Custom app

  4. In the Custom App dialog:
    1. For Authentication Method , choose Server Authentication (with JWT) .
    2. Specify an App Name .
    3. Select Create App .

    Custom app options

  5. In your new application:
    1. Select the Configuration tab.
    2. For App Access Level , select 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:

    App enterprise scopes

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

    Save changes for Coro

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

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

    Generating keys

    Box generates a configuration file for your application.

    Important

    Save this file to your local device. 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:

    Select OK

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

    Review and submit

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

    Review app submission

  11. Select Back to My Account :

    Back to my account

  12. Select Admin Console :

    All files

  13. Select Apps from the side menu, then switch to the Custom Apps Manager tab.
  14. Find the record of your newly created Coro application, select the adjacent 3-dots menu, then select Authorize App :

    Authorizing app

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

    Authorizing app button

The process is now complete.

Connecting your Box application to Coro

  1. Sign in to the Coro console .
  2. From the sidebar, select Control Panel to access the Control Panel .
  3. Select Cloud Applications :

    box-img14

  4. On the Cloud Applications page, select Box :

    Cloud apps screen

    note

    Alternatively, select + CONNECT and then, select Box from the Connect cloud applications dialog that follows.

    Coro displays Connect to Box dialog:

    Connect to Box dialog step 1

  5. Step 1 requires you to create a new Coro application in Box. For details, see Creating an application in Box .

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

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

    Connect to Box step 2

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

Cloud Applications page

Disconnecting your Box account

To disconnect Box from Coro protection:

  1. Sign in to the Coro console and go to Control Panel > Cloud applications .
  2. From the three-dot menu adjacent to Box , select Disconnect .
  3. When the confirmation dialog appears, select YES, DISCONNECT .

Box is now disconnected from Coro protection.