Box - Create/Update User

Box - Create/Update User creates or updates Box Platform users for assets returned by the selected query or assets selected on the relevant asset page.

Required Fields

These fields must be configured to run the Enforcement Set.

• Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Working with Axonius Compute Nodes.

  
  

Additional Fields

These fields are optional.

• Box Platform private key configuration file - The private key configuration file that provides the Required Permissions to fetch assets.
• Action - Select the action to perform.
• Use Adapter connection - Enter the ID of the adapter connection this action should use.
• Initial Request Body - Enter the initial request body in JSON format.

• Map Axonius fields to vendor fields - Use the Field Mapping Wizard to map Axonius fields to fields in external systems. In this way, you can transfer data found in Axonius into the external system as part of the configuration of relevant enforcement actions. The wizard shows you which fields exist on the Axonius system, allowing you to map them easily.

  📘

  Note:

  For details, see Axonius to External Field Mapping.

• Gateway Name - Select the Gateway through which to connect to perform the action.

  
  

APIs

Axonius uses the following BOX APIs:

• Create user - API Reference - Box Developer Documentation
• Update user - API Reference - Box Developer Documentation
• Upload file - for file size up to 20MB.
• Create upload session - for file size over 20MB.

Required Permissions

The value supplied in Box Platform private key configuration file refers to the generated 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.

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. Application Scopes - The configured app must have the following application scopes:

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