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. 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:


  • User Name: It is not a mandatory field.  Provide the administrator email address.


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

Note:  All the below fields are mandatory and you are recommended to provide the values respectively.


  • Box Name: Provide the name of the Box data source.

  • Client ID: Provide the ‘clientID’ value generated in the JSON file.

  • Client Secret: Provide the ‘clientSecret’ value generated in the JSON file.

  • Public Key ID: Provide the ‘publicKeyID’ generated in the JSON file.

  • Private Key: Provide the ‘privateKey’ generated value in the JSON file.

  • Private Key Password: Provide the ‘passphrase’ value generated in the JSON file.


  1. Click ‘Save’.