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.

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.

In additions the application, should be granted the following scopes:

• members.read - For fetching users.
• sessions.list - For fetching devices.
  
  

APIs

Axonius uses the Dropbox API.

Obtain the App Key and App Secret

1. Follow the Dropbox instructions for creating an application in Dropbox.
2. In Dropbox, navigate to Settings > Apps.
3. Open the settings for your newly created application.
4. On the bottom of the page, copy the App Key and App Secret, and paste them into their corresponding fields in Axonius's Dropbox Adapter connection form.
   You will also need your App Key and App Secret for generating the refresh token.

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 input should appear in the following format:

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.