[ 1 Connect Dropbox with Devo SOAR ] [ 2 Actions for Dropbox ] [ 2.1 Retrieve Team Events ] [ 2.1.1 Input Field ] [ 2.1.2 Output ] [ 3 Release Notes ]

Dropbox is a file hosting service, that offers cloud storage, file synchronization, personal cloud, and client software.

Connect Dropbox with Devo SOAR

Navigate to Automations > Integrations.
Search for Dropbox.
Click Details, then the + icon. Enter the required information in the following fields.
Label: Enter a connection name.
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.
Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).
Remote Agent: Run this integration using the Devo SOAR Remote Agent.
Access Token: The Access Token to connect to Dropbox.
Permissions: "team_data.member" and "team_data.team_space" permissions are required to execute the action.

We have tested this action with the "Scoped access app", which can be created by clicking here. To create an app, see Getting started with the Dropbox API.

Actions for Dropbox

Retrieve Team Events

Retrieves team events.

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 expressed in UTC, with a special UTC designator Z (Default is Batch start time). Example: 2020-08-25T21:49:46Z.	Optional
End Time	Enter the value for end-time expressed in UTC, with a special UTC designator Z (Default is Batch end time). Example: 2020-08-26T21:49:46Z.	Optional
Maximum Results	The maximum number of results to return per call (Default is 1000). Must be between 1 through 1000 (inclusive).	Optional

Output

A JSON object containing multiple rows of result:

has_error: True/False
error: message/null
result: List of events.

Retrieve Team Events

{
  "actor": {
    ".tag": "admin",
    "admin": {
      ".tag": "team_member",
      "account_id": "dbid:AAD34674eHcfL57467467467fpunam26jqipaUw7fj2NT5jLc",
      "display_name": "aaa aaa",
      "email": "aaa@aaa.com",
      "team_member_id": "dbmid:AADGTxFevbsRW0467467qq4pk0EIzEBTSW3nggK5k"
    }
  },
  "assets": [],
  "context": {
    ".tag": "team_member",
    "account_id": "dbid:AAD74673eHcfL5fpu74674nam26jqipaUw7fj2NT5jLc",
    "display_name": "aaa aaa",
    "email": "aaa@aaa.com",
    "team_member_id": "dbmid:AADGT746747xFevfgfdsfgbsR7467W0qq4pk0EIzEBTSW3nggK5k"
  },
  "details": {
    ".tag": "login_success_details",
    "is_emm_managed": false,
    "login_method": {
      ".tag": "password"
    }
  },
  "error": null,
  "event_category": {
    ".tag": "logins"
  },
  "event_type": {
    ".tag": "login_success",
    "description": "Signed in"
  },
  "has_error": false,
  "involve_non_team_member": false,
  "origin": {
    "access_method": {
      ".tag": "end_user",
      "end_user": {
        ".tag": "web",
        "session_id": "dbwsid:23736610789476749895657467474567281269158215712678"
      }
    },
    "geo_location": {
      "city": "Noida",
      "country": "IN",
      "ip_address": "10.10.10.10",
      "region": "Uttar Pradesh"
    }
  },
  "participants": [],
  "timestamp": "2020-09-20T10:46:54Z"
}

Release Notes

v3.0.0 - Updated architecture to support IO via filesystem