Activity Insights - Dropbox

To display activity data from Activity Insights, you must first create an OAuth application in Dropbox and generate a refresh token. You’ll then configure the following required sources so that IdentityNow can gather your account information and display activity data.

Required Connectors

Connectors	Description
Dropbox	The identity governance connector allows you to manage your Dropbox users and accounts in IdentityNow.
Activity Insights - Dropbox	The Activity Insights connector works with your Dropbox identity governance connector to provide activity data for identities.

Creating an OAuth Application in Dropbox

Before Activity Insights can display in IdentityNow, you must create an OAuth app in Dropbox.

1. Select the Menu icon > App Center.

2. Select Build an App under Manage in the navigation menu.

3. Select Create apps.

4. Select Scoped Access.

5. Select Full Dropbox.

6. Enter a name for your application like Activity Insights - Dropbox.

7. Select the I agree to Dropbox API Terms and Conditions checkbox.

8. Select Create app.

9. 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 IdentityNow.

10. 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.

11. Go to the Branding tab and select Save Changes.

Generating a Refresh Token

1. 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.

2. 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.

Connecting Dropbox to IdentityNow for Activity Insights

To connect Dropbox to IdentityNow, you’ll need to configure the Dropbox Identity Governance and Activity Insights - Dropbox sources in IdentityNow. This will allow IdentityNow to gather account information and activity data from Dropbox.

Configuring the Dropbox Identity Governance Source

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

Configuring the Activity Insights - Dropbox Source

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

1. Go to Admin > Connections > Sources. 

2. Select Create New to create a new source. 

3. Search for and select the Activity Insights - Dropbox connector.

4. Enter a name and description for your source. 

5. In the Source Owner field, begin typing the name of an owner. Matches appear after you type two letters. 

6. (Optional) Select a governance group for source management. 

7. Select Continue to create the source.

8. Select Configuration from the left panel.

9. 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.

10. Select Save to save these settings. 

11. Select Review and Test from the left panel. 

12. Select Test Connection to test the connection between the applications. You must have a successful connection for IdentityNow 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.