Question

How do I configure FTK Central to collect from Box?

 

Prerequisites

Answer

Create a Box Application

  1. Login to Box developer site and navigate to the Console page.


https://account.box.com/developers/services


  1. Click ‘Create New App’ in ‘My apps’ section.



  1. Choose ‘Custom App’ and click ‘Next’.


  1. Choose ‘Server Authentication (with JWT)’ in ‘Authentication Method’ page.


Graphical user interface, text, application, email Description automatically generated


  1. Enter a unique ‘App name’ for reference and save it.


  1. Copy the ‘Client ID’ and ‘Client Secret’ in OAuth 2.0 Credentials section which is to be configured in the Box Data source.


Graphical user interface, text, email Description automatically generated


  1. Under ‘App access level’, choose ‘Enterprise’.


Graphical user interface, text, application Description automatically generated

  1. Under ‘Application Scopes’, choose the below scopes:

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

  • Manage users.

  • Manage groups.

  • Manage enterprise properties.

  • Manage retention policies.


Graphical user interface, text, application, email Description automatically generated


  1. In the ‘Advanced Features’, enable the below features:

  • Make API calls using the as-user header.

  • Generate user access tokens.


Graphical user interface, text, application, email Description automatically generated


  1. Click ‘Save changes’.

  2. Click ‘Generate a Public/Private Keypair’.

  • The MFA screen is displayed. 



  1. Provide the MFA code.

  2. Again, click ‘Generate a Public/Private Keypair’.


C:\Users\ruthanne.roesener\Documents\5.0 User Manuals\Notes symbol.png

Note:  The json file will be downloaded along with the public key ID which is displayed above.


  1. Remove all the escape characters from the downloaded JSON by navigating to https://www.freeformatter.com/json-escape.html, pasting the full contents of the JSON file in the box provided, and clicking "UNESCAPE".

  2. Save the full "Unescaped string" output for future reference.

  3. Back in the Box portal, navigate to the ‘Authorisation’ tab and click on ‘Review and submit’.


Graphical user interface, text, application, email Description automatically generated

  1. Login to the Admin Console.

  2. Navigate to ‘Enterprise settings.

  3. Click ‘Apps’.

  4. Navigate to ‘Custom Apps Manager’.

  5. Under ‘Server Authentication Apps’, click on  across the created app.

  6. Click on ‘Authorize App’.

  7. Check the permissions required and click ‘Authorize’.


Configure FTK Central

  1. Login to FTK Central.

  2. Navigate to ‘Data Sources’.



  1. Select ‘Box’ from the data sources list.


  1. Click ‘Add Box’.



  • The ‘Add Box Details’ pop-up is displayed.

  1. Provide the below Box details:


  • Box Name: Provide a friendly name for the Box data source.
  • Admin User Name: Provide the BOX administrator email address.
  • Client ID: Provide the ‘clientID’ value generated before.
  • Client Secret: Provide the ‘clientSecret’ value generated before.
  • Public Key ID: Provide the ‘publicKeyID’ generated before. 
  • Private Key: Provide the ‘privateKey’ generated before. This should include the "-----BEGIN ENCRYPTED PRIVATE KEY-----" and "-----END ENCRYPTED PRIVATE KEY-----" messages, as shown below.
  • Private Key Password: Provide the ‘passphrase’ value generated before.


  1. Click ‘Save’.