Box Platform

Box Platform provides data security, file sharing, collaborating, and content management tools. Box Platform provides access to Box APIs.

Types of Assets Fetched

This adapter fetches the following types of assets:

• Users
  
  

Parameters

1. Box Platform enterprise ID (required) - Specify your Box enterprise account ID.
   The Box Platform enterprise ID is located in the Enterprise settings view. Click the Admin Console link from the top of your Box account. Then choose the Gear icon / Enterprise settings. Your Enterprise ID may also be located in the Account and Billing tab of the Admin Console.
2. Client ID and Box Platform private key configuration file (required) - The Client ID and private key configuration file that provides the Required Permissions to fetch assets.
3. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in Box Platform enterprise ID.
   • If supplied, Axonius will utilize the proxy when connecting to the value supplied in Box Platform enterprise ID.
   • If not supplied, Axonius will connect directly to the value supplied in Box Platform enterprise ID.
4. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

APIs

Axonius uses the Box REST API - List enterprise users.

Required Permissions

The values supplied in Client ID and Box Platform private key configuration file refer to the generated Client ID and private key configuration file for your Custom App using JWT authentication:

1. Set up a Custom App - Set up a Custom App using JWT authentication. For details, see Box Guides - Setup with JWT. The following App Scopes are required:
   • Read and write all files and folders stored in Box
   • Manage groups
   • Manage enterprise properties
   • Manage users
   • Manage app users
2. Create Box Platform private key configuration file - After a Custom App has been created to use JWT authentication, there is an option available in the Developer Console to have Box create a configuration file. This file will include the keypair as well as a number of other application details that are used during authentication.
   1. Click on the "Configuration" option from the left sidebar in your application and scroll down to the "Add and Manage Public Keys" section.
      
   2. Click the "Generate a Public/Private Keypair" button to have Box generate a keypair. This will trigger the download of a JSON configuration file that you can move to your application code.
   3. Upload this file as the Box Platform private key configuration file.
3. Get Client ID - The Client ID of the application that is requesting to authenticate the user. To get the Client ID for your application:
   1. log in to your Box developer console and click the Edit Application link for the application you're working with.
   2. In the OAuth 2.0 Parameters section of the configuration page, find the item labelled client_id. The text of that item is your application's Client ID.