Document toolboxDocument toolbox

Box

Owned by Jonas Gonzalez
Last updated: Nov 29, 2024
2 min read
[ 1 Connecting with Box with Devo SOAR ] [ 2 Actions for Box ] [ 2.1 Get Enterprise Events ] [ 2.1.1 Input Field ] [ 2.1.2 Output ] [ 3 Release Notes ]

Box is a platform for Secure Content Management, Workflow, and Collaboration. That focuses on cloud content management and file sharing service for businesses.

Connecting with Box with Devo SOAR

  1. Navigate to Automations > Integrations.

  2. Search for Box.

  3. Click Details, then the + icon. Enter the required information in the following fields.

  4. Label: Enter a connection name.

  5. Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.

  6. Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).

  7. Remote Agent: Run this integration using the Devo SOAR Remote Agent.

  8. Credentials Config File: JSON file containing the application's private key and other details.

  9. After you've entered all the details, click Connect.

Actions for Box

Get Enterprise Events

Get enterprise events objects with an optional filter.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

Start Time

Enter the value for start time (Default is Batch start time). Example: 2020-09-01T22:02:24-07:00.

Optional

End Time

Enter the value for end time (Default is Batch end time). Example: 2020-10-01T22:02:24-07:00.

Optional

Event Type

Jinja-templated event type containing comma separated string of events to filter by. Example: {{event_type_column1}}, {{event_type_column2}}.

Optional

Maximum Results

The maximum number of results to return per call (Default is 10000).

Optional

Output

A JSON object containing multiple rows of result:

  • has_error: True/False

  • error: message/null

  • result: List of events

{json}{ "action_by": null, "additional_details": null, "created_at": "2020-09-29T05:09:33-07:00", "created_by": { "id": "13711115568", "login": "aaaa@aaa.com", "name": "aaa bbb ", "type": "user" }, "error": null, "event_id": "5f08d89c-33c8-476775-bce1-dc691ioaae5d96", "event_type": "LOGIN", "has_error": false, "ip_address": "122.88.88.88", "session_id": null, "source": { "id": "13711115568", "login": "aaa@aaa.com", "name": "aaa bbb ", "type": "user" }, "type": "event" }

Release Notes

  • v3.0.0 - Updated architecture to support IO via filesystem