3.2.4 Add A Box Storage

In order to integrate Box with MetaDefender for Secure Storage please follow these steps:

Steps 4 and 5 are optional. Perform them in order to set up a specific location for file processing.

  1. From the left side menu, navigate to Storage units and from the Cloud Storage tab, choose Add Box Storage

    images/download/attachments/6224394/add_box_storage.png

  2. Give your storage a name so you can easily find it later

  3. Upload your Credentials file. Scroll down for more details.

  4. Select a specific User or Custom App as the source of files that should be processed by MetaDefender for Secure Storage, by filling in the name. Leaving this field empty will allow MetaDefender for Secure Storage to be able to process files from all users created by the custom application, from the application itself and also from all Enterprise users, depending on the Application Access provided.

  5. Set up a specific location as a source of files that should be processed by MetaDefender for Secure Storage by filling in the full path of the folder. Make sure it’s a valid path corresponding to the User or Custom App name you previously added. Note that it could take up to 10-15 minutes for newly added folders to be discovered.
    images/download/attachments/6224394/image-20210128-080535.png

  6. Select the MetaDefender Core server that you wish to use.

  7. Select Add in order to finish the process.

For most Box applications “All Files” is considered the root of the folder structure. To be able to scan entire structure of folders from a user or custom application, Folder Path field should remain empty.

How can I generate a Public / Private key pair

To generate a file that contains all the necessary information to connect MetaDefender for Secure Storage to your Box storage please follow these steps:

  1. Log in to Box and then go to Dev Console

  2. From the console, choose Create New App
    images/download/attachments/6224394/image-20210114-120045.png

  3. Select Custom App and click Next
    images/download/attachments/6224394/Box-Create-new-app.png

  4. Choose OAuth 2.0 with JWT (Server Authentication) as the authentication method and give your app a name, for example MetaDefender for Secure Storage and then click Create App
    images/download/attachments/6224394/image-20210119-073804.png

  5. You will receive a message saying that your app has been successfully created. Click View Your App.

  6. You will be redirected to the app General Settings page, switch to Configuration.

  7. Scroll down to the Application Access section and choose App Access Only or App Access + Enterprise Access.
    Selecting App Access only will allow MetaDefender for Secure Storage to be able to process files from the users created by the custom application and also from the application itself.
    Selecting App Access + Enterprise Access will allow MetaDefender for Secure Storage to be able to process files from the users created by the custom application, from the application itself and also from the Enterprise users.

    images/download/attachments/6224394/image-20210119-072753.png

  8. Scroll down to the Application Scopes section and make sure that the following permissions are checked:
    images/download/attachments/6224394/image-20210119-072857.png

    1. Read all files and folders stored in Box

    2. Read and write all files and folders stored in Box

    3. Manage users

    4. Manage groups

  9. Next, please scroll down to the Advanced Features section and make sure that both Perform Actions as Users and Generate Users Access Tokens are enabled
    images/download/attachments/6224394/image-20210119-072928.png

  10. Make sure you save your changes.

  11. The next step will be to generate a Public/Private Keypair
    Note: When performing this action you may be required to re-authenticate using a two-factor authentication method. If this happens, after re-authenticating, please go back and click Generate Public/Private Keypair again
    images/download/attachments/6224394/image-20210119-073028.png

  12. A configuration file with all of your app settings will be downloaded. Please store it securely as you will need it a bit later

  13. Click to Authorization menu.
    images/download/attachments/6224394/image-20210119-073135.png

  14. Click Review and Submit. From the popup that will appear, please make a copy of the Client ID
    images/download/attachments/6224394/image-20210119-073314.png

  15. Click Submit

  16. From the left-side menu, please press Back to My Account and switch to Admin Console.

  17. Using the Admin Console left-side menu, navigate to Apps and then Custom Apps
    images/download/attachments/6224394/image-20210114-122052.png

  18. Click “+” and paste the previously copied Client ID and then click Next
    images/download/attachments/6224394/image-20210114-122238.png

    images/download/attachments/6224394/image-20210114-122605.png

  19. Review the application permissions once again and then click Authorize
    images/download/attachments/6224394/image-20210119-073519.png

  20. Almost done! All you need to do is go back to the MetaDefender for Secure Storage web interface and upload the Public/Private Keypair that you generated earlier in the Credentials field.