Skip to main content

Cloud ConnectorsExabeam Cloud Connectors Configuration Guide

Dropbox Business Cloud Connector

Dropbox Business is a file sharing and cloud storage solution that enables employees to store files, and share, sync, and collaborate on files securely. For more information, see the Dropbox documentation.

Prerequisites to Configure the Dropbox Business Cloud Connector

Before you configure the Dropbox Business connector you must complete the following prerequisites:

  • To access the events endpoint, in the Dropbox developer portal, provide the following permissions:

    • account_info.read

    • team_info.read

    • team_data.member

    • members.read

    • groups.read

    • events.read

  • Generate the App key and App Secret.

Generate the App key, App Secret, and Set Permissions

To set permissions and obtain the App Key and App Secret:

  1. Log in to the Dropbox developer portal to create a Dropbox application for your organization. For more information, see https://www.dropbox.com/developers.

  2. On the Dropbox developer portal, click Create app.

  3. In the Choose an API section, click Scoped access.

  4. Select the access type Full Dropbox.

  5. Specify a name for the app based on the Dropbox branding guide, then click Create app.

  6. To set permissions, in the Permission Type section, click Scoped App.

  7. Select the check boxes for the following permissions:

    • account_info.read

    • team_info.read

    • team_data.member

    • members.read

    • groups.read

    • events.read

  8. Click Submit.

  9. Navigate to Settings.

  10. Click the Show link for the App Key and the App Secret fields, then record the App Key and App Secret.

    Note

    While configuring the Dropbox cloud connector, if you select the authentication method OAuth2, enter the App key in the the Client ID field the App Secret in the Client Secret field.

  11. To let Dropbox authenticate Exabeam cloud connector, in the Redirect URIs field for OAuth2, enter the URL https://auth.skyformation.net/v1/oauth.

Configure the Dropbox Business Cloud Connector

Dropbox Business is a file sharing and cloud storage solution that enables employees to store files, and share, sync, and collaborate on files securely. For more information, see the Dropbox documentation.

The following table displays audit source API and security events supported by the connector.

Audit Source: API

Service or Module Covered

Event Types

Event Included

get_events

Any

Access events, administrative events, file/folders events, security settings events and more

All audit events

To configure the Dropbox Business connector to import data into the Exabeam Cloud Connectors platform:

  1. Complete the Prerequisites to Configure the Dropbox Business Cloud Connector.

  2. Log in to the Exabeam Cloud Connectors platform with your registered credentials.

  3. Navigate to Settings > Accounts > Add Account.

  4. Click Select Service to Add, then select Dropbox from the list.

  5. In the Accounts section, enter the required information:

    Note

    Required fields are indicated with red bar.

    1. Tenant – Select a tenant to be attached to the connector, only for multi-tenant edition of Exabeam Cloud Connector. Otherwise, select default.

    2. Account Name – Specify a name for the connector. For example, Dropbox_file_sharing.

    3. (Optional) Description – Describe the Dropbox account.

    4. Authentication Method – Select OAuth 2.

    5. For the authentication method OAuth2, enter the required information for the following fields.

      Dropbox_OAuth2.png

      1. Client ID – Enter the App Key that you obtained while completing prerequisites.

      2. Client Secret – Enter the App Secret that you obtained while completing prerequisites.

      3. External Authentication – Click Open External OAuth Window to authorize the Exabeam Cloud Connector to communicate with Dropbox account. In a window that prompts you to provide access to allow Exabeam Cloud Connector to interact with Dropbox account for retrieving audit events, click Login.

      Note

      Do not use the Event Access Token method that is deprecated.

  6. To confirm that the Exabeam Cloud Connector platform communicates with the service, click Test Connection.

  7. Click Done to save your changes. The cloud connector is now set up on the Exabeam Cloud Connector platform.

  8. To ensure that the connector is ready to send and collect data, Start the connector and check that the status shows OK.