• 13 Mar 2023
  • 1 Minute to read
  • Dark
  • PDF


  • Dark
  • PDF

Article Summary

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:

Screen Shot 2022-11-27 at 13.10.59.png

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

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.