User Community Service Desk Downloads

Dropbox Connection

This article describes how to connect to Dropbox.

Availability

Data processing & catalog Edge processing Lineage Exceptions

  • Supports CSV, Apache Parquet, Microsoft Excel files.

  • Doesn’t support:

    • Writing data using data transformation steps.

    • Creating SQL catalog items.

Prerequisites

Create Dropbox application

If you already have an application set up, make sure to verify the application permissions.

Follow the Dropbox Getting Started guide to create an application in the Dropbox App Console.

When configuring your application, use the following settings:

  • API: Scoped access

  • Access type: Full Dropbox

  • Permissions (on the Permissions tab):

    • files.content.read (in Files and folders)

    • openid (in OpenID Connect)

After creating the application, note the App key and App secret from the Settings tab. You’ll need these when configuring credentials in ONE.

Add a connection

  1. Go to [your source] > Connections and select Add Connection.

  2. In Connection type, select Dropbox.

  3. Fill in the following:

    • Name: A meaningful name for your connection. Used to indicate the location of catalog items.

    • Description (Optional): A short description of the connection.

Add credentials

Only OAuth 2.0 authentication is supported.

Before continuing, make sure you’re logged in to Dropbox in the same browser you’re using for ONE.

  1. Select Add Credentials.

  2. Fill in the following:

    • Name: Provide a clear name for this set of credentials.

    • Description (Optional): Explain what the credentials are used for or provide other useful information.

  3. Add the ONE redirect URI to your Dropbox app:

    1. Copy the Redirect URL shown in ONE.

    2. In Dropbox, go to your app’s Settings tab.

    3. Paste the URL in Redirect URIs and select Add.

      600
  4. Back in ONE, provide your Dropbox app details (found on your app’s Settings tab in Dropbox):

    • Client ID: The App key.

    • Client secret: The App secret.

  5. In Refresh token, select Generate to create a new token.

    This might open a Dropbox window asking you to allow access. Select Allow to continue.

    Once generated, the token’s expiration date is shown in Refresh token valid till.

  6. To use this set of credentials by default when connecting to the data source, select Set as default.

One set of credentials must be defined as default for each connection. Otherwise, DQ evaluation fails and previewing data in the catalog is not possible.

Add write credentials

If you want to export data to this source, add write credentials. Select Add Credentials and follow the instructions in Add credentials.

Next steps

Test and save your connection to complete setup.

Was this page useful?