Dropbox

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

Types of Assets Fetched

This adapter fetches the following types of assets:

• Devices
• Users

The Dropbox adapter connection requires the following parameters:

1. Account Name - Enter your Dropbox account name.

2. App Key and App Secret (required) - API credentials associated with a user account that has the Required Permissions to fetch assets.
   To obtain the App Key and App Secret, navigate to the Dropbox app > Settings tab. The App Key and App Secret are displayed at the bottom of the page.

3. Refresh Token (required) - An API Refresh Token associated with a user account that has permissions to fetch assets.
   To generate a Refresh Token, see Generate a Refresh Token.

4. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

5. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

6. HTTPS Proxy User Name (optional) - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

7. HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.

8. To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Required Permissions

The value supplied in App Key must be associated with credentials that have the permission session.list enabled.

Generate a Refresh Token

To generate a refresh token

1. Log in to Dropbox.
2. Go to https://www.dropbox.com/oauth2/authorize?client_id=APP_KEY&response_type=code&token_access_type=offline, substituting your APP_KEY in the URL.
3. Confirm connecting your account to the Dropbox app. A single-use code is then displayed.
4. Run the following curl command to obtain the Refresh Token:

curl https://api.dropbox.com/oauth2/token -d code=ACCESS_CODE_GENERATED -d grant_type=authorization_code  -u APP_KEY:APP_SECRET

The output of the command should appear similar to the following:

5. From the output, copy the Refresh Token value and paste it into the Axonius adapter's Refresh Token parameter.