Skip to main content

Connect to Dropbox (Legacy UI)

Nexla's bi-directional connectors can both send data to and receive data from any data system. This means that once a user has created or gained access to a credential for any data system, building any data flow to ingest data from or send data to a location within that data system requires only a few simple steps.

1. Credentials

This section provides information about and step-by-step instructions for creating a new Dropbox credential in Nexla.

1.1 Connect Nexla to the Dropbox Account

  1. After selecting the data source/destination type, in the Authenticate.png screen, click AddANewCredential.png. This will open a pop-up authorization window.

      Authorization2.png

  2. Follow the instructions below to authorize Nexla to connect to the Dropbox account.

    • Drobox Accounts Tied to Another Account Type:

      1. To sign into a Dropbox account associated with another account type, such as a Google or Apple account, click the button corresponding to the account type.

        Here, a Google account is used as an example.

          ContinueAs.png

      2. Sign into Dropbox by selecting the associated account.

          Account.png

      3. Click Allow.png to authorize Nexla to access the files and folders in the Dropbox account.

          Allow2.png

    • Sign into Dropbox with an Email & Password:

      1. Enter the email associated with the Dropbox account in the Email field.

          Email.png

      2. Click Continue.png.

          Continue2.png

      3. Enter the password for the Dropbox account in the Password field.

          Password.png

      4. Click LogIn.png.

          LogIn2.png

      5. Click Allow.png to authorize Nexla to access the files and folders in the Dropbox account.

          Allow2.png

1.2 Configure the Credential

The instructions in this section correspond to the Add New Credential window.

     AddNewCredential.png

  1. In the Add New Credential window, enter a name for the credential in the Credential Name field.

      CredName.png

  2. Enter a description of the credential in the Credential Description field.

      CredDescription.png

    • To configure Nexla to handle file encryption/decryption, continue to Section 1.3.
    • To create the credential without configuring file encryption/decryption, continue to Section 1.4.

1.3 Advanced Settings File Encryption/Decryption

Nexla can be configured to process encrypted files such that a data source connected to this credential will decrypt files before ingestion, and a data destination connected to this credential will encrypt generated files before uploading to the S3 storage location.

  1. Click AdvSettings.png to access additional available settings for the credential.

      AdvSettings2.png

  2. To configure Nexla to encrypt/decrypt files when accessing Dropbox via this credential, check the box next to "Handle File Encryption/Decryption?".

    When this option is selected, for Dropbox data sources/destinations created using this credential, Nexla will decrypt files from the source before ingestion and will encrypt files before uploading them to the destination.

      EncryptionDecryption.png

  3. Select the type of file-encryption protocol that should be used to encrypt/decrypt files from the list of available protocols in the File Encryption Protocol pulldown menu.

      EncryptionProtocol.png

    • PGP Encryption

      1. Enter the ID of the user whose public key will be used for file encryption/decryption in the External User ID field.

          ExtUserID.png

      2. Enter the public key will be used for file encryption/decryption in the External User's Public Key field.

          PublicKey.png

      3. Enter the user ID that was used to generate the PGP private key in the Your User ID for Private Key field.

          UserID.png

      4. Enter the password for the user ID in Step 5 in the Your Password for Private Key field.

          Password.png

      5. Enter the PGP private key that will be used to encrypt/decrypt files in the Your Private Key field.

          PrivateKey.png

1.4 Save and Create the Dropbox Credential

  1. Once all of the relevant steps in the above sections have been completed, click Save.png at the bottom of the Add New Credential screen to save the credential and all entered information.

  2. The newly added credential will now appear in a tile on the Authenticate.png screen and can be selected for use with a new data source or destination.

      CredentialsList.png

2. Add a Dropbox Data Source

  1. Log into Nexla with your provided credentials to view the Nexla Dashboard.

    If you need credentials, contact support@nexla.com.

  2. Select Sources.png from the menu on the left.

  3. Click Create_New_Source.png in the upper right corner to begin adding a new data source.

  4. Select Dropbox.png, and click Next.png in the upper right corner of the screen to begin adding Google Drive data source.

2.1 Configure the Data Source

  1. Find the Dropbox location from which Nexla should read data. Expand files as necessary by clicking the Expand.png icon next to each.

  2. To select a file, hover over it, and click the Select.png button that appears.

    Once a file is selected, the button will display Selected.png, and the path of the selected location will be shown at the top of the list.

    Selected_Location.png

2.2 Schedule Data Source Scanning

  1. In the Advanced Settings menu on the right, use the Scheduling pulldown menu to specify how often Nexla should fetch data from the source.

    The default setting configures Nexla to fetch any new data from the source once every day.

      Scheduling.png

    • For options such as "Every N Hours" and "Every N Days", use the additional pulldown menu that appears when these options are selected to specify N in defining the fetching frequency.

      N_Frequency.png

  2. Optional: To set a specific time at which Nexla should fetch any new data from the source, check the Set_Time.png box, and type or use the pulldown menus to enter the desired time.

      Specify_Time.png

  3. Optional: Use the Advanced Settings menu on the right to access additional settings for the source, including file scan scheduling and options related to text files and delimiter-separated values.

  4. Once all needed files have been selected, click Create.png in the upper right corner.

2.3 Confirmation

  1. The confirmation page indicates that the Google Drive data source has been successfully added.

      Successfully_Created.png

  2. Optional: Edit the name of the data source by clicking on it and entering the desired text.

      Edit_Name.png

  3. Optional: Add a description of the data source by clicking on Description.png below the source name and entering the desired text.

    • To return to My Data Sources, click Done.png in the upper right corner.

    • To view the newly created data source, click View_Source.png.

    • To view Nexsets detected in the newly added source, click View_Detected_Nexsets.png.