Activity Insights - Dropbox

To display activity data from Dropbox, you can set up a single SaaS connector or configure both a virtual appliance (VA) and Activity Insights - Dropbox connector.

Configuring Activity Insights Using the Dropbox SaaS Connector

If you are using the Dropbox SaaS connector, follow the connector guide to enable Activity Insights.

After a successful test connection, you must correlate accounts and run an aggregation for the Dropbox SaaS source. Your activity data will begin syncing immediately but may take up to 24 hours to display. Data will then update daily.

Note

If you previously configured both the Dropbox identity governance and Activity Insights - Dropbox connectors, you do not have to take additional action to continue receiving your data.

Configuring Activity Insights Using a VA-Based Source

If you are setting up Activity Insights using a VA-based connector, you must first create an OAuth application in Dropbox and generate a refresh token. You'll then configure both the Dropbox identity governance and Activity Insights - Dropbox connectors so that Identity Security Cloud can gather your account information and display activity data.

Creating an OAuth Application in Dropbox

Before Activity Insights can display in Identity Security Cloud, you must create an OAuth app in Dropbox.

Select the Menu icon > App Center.
Select Build an App under Manage in the navigation menu.
Select Create apps.
Select Scoped Access.
Select Full Dropbox.
Enter a name for your application like Activity Insights - Dropbox.
Select the I agree to Dropbox API Terms and Conditions checkbox.
Select Create app.
From the Settings page, copy your app key and secret. Store these values in a safe location as you will need them to connect Dropbox to Identity Security Cloud.
Go to the Permissions tab and select the following scopes:

team_data.member View structure of your team's and members' folders.

events.read View your team's activity log.
Go to the Branding tab and select Save Changes.

Generating a Refresh Token for Dropbox

Construct an authorization URL for the app using the following example:

https://www.dropbox.com/oauth2/authorize?client_id=<APP_KEY>&response_type=code&token_access_type=offline

Where <APP_KEY> is your app key from Dropbox.

Copy and save the Access Code generated by the above URL. It will be used in the next API call.
Use the following token API to get the refresh token:

curl https://api.dropbox.com/oauth2/token \ -d code=<ACCESS_CODE> \ -d grant_type=authorization_code \ -u client_id=<APP_KEY> \ -u client_secret=<APP_SECRET>

Where:

<ACCESS_CODE> - The access code from the previous step.

<APP_KEY> - Your app key from Dropbox.

<APP_SECRET> - Your app secret from Dropbox.

Configuring the Dropbox Identity Governance Source

Follow the directions to configure your Dropbox source in Identity Security Cloud. You can also edit an existing source.

Configuring the Activity Insights - Dropbox Source

To display activity data from Dropbox, you must configure the Activity Insights - Dropbox source in Identity Security Cloud.

Go to Admin > Connections > Sources.
Select Create New to create a new source. 
Search for and select the Activity Insights - Dropbox connector.
Enter a name and description for your source. 
In the Source Owner field, begin typing the name of an owner. Matches appear after you type two letters. 
(Optional) Select a governance group for source management.
Select the checkbox if the source is an authoritative source. 
Select Continue to create the source.
Select Configuration from the left panel.
Enter the following information: 
- App Key - The app key from Dropbox.
- App Secret - The app secret from Dropbox.
- Refresh Token - The refresh token you generated.
Select Save to save these settings. 
Select Review and Test from the left panel. 
Select Test Connection to test the connection between the applications. You must have a successful connection for Identity Security Cloud to gather activity data. If the test is unsuccessful, retry your credentials or contact SailPoint Support.

To gather account data, you must correlate accounts and run an aggregation for the Dropbox identity governance source. Your activity data will begin syncing immediately but may take up to 24 hours to display. Data will then update daily.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.


`team_data.member`	View structure of your team's and members' folders.
`events.read`	View your team's activity log.