Introduction

Dropbox is a widely-used cloud-based file hosting service that offers a seamless solution for storing, sharing, and collaborating on files across various platforms. Established in 2007, it provides users with the flexibility to upload, organize, and share files and folders, fostering efficient collaboration through shared access to documents. With cross-platform compatibility, users can access their files from web browsers, desktop applications on Windows, macOS, and Linux, as well as dedicated mobile apps for iOS and Android. Dropbox's file synchronization feature ensures that changes made on one device are instantly reflected across all linked devices, maintaining consistency. Additionally, features such as version history and offline access contribute to its popularity by providing users with robust tools for efficient file management and collaboration. A Dropbox connector can be configured in SigningHub Admin by providing two integration keys, i.e.  App key and App secret. 

https://docs.pingidentity.com/bundle/dropboxConn20_sm_quickConnect/page/dropboxConn_t_obtainAppKeySecretFromDropbox.html


How it works?

  1. Create a Dropbox App on the Dropbox Developer Console.
  2. Create a Dropbox connector in SigningHub Admin.
  3. Configure the Dropbox Connector as Default in SigningHub Admin.
  4. Enable your cloud drives in SigningHub Web.


Create a Dropbox App on the Dropbox Developer Console

  1. Browse https://www.dropbox.com/developers to open the Dropbox developer console.
  2. Log into your Dropbox account.



  3. Click the "App Console" option from the left menu, and then click the "Create app" button.



  4. Select the "Dropbox API app" option, then select the "No - My app needs access to files already on Dropbox." option, and then select the "All file types - My app needs access to a user's full Dropbox." option from the respective preferences. Specify your app name, i.e. SigningHub, agree to Dropbox API terms and conditions, and click the "Create app" button.



  5. A new Dropbox API app will be created with the specified name. The App key and App secret of newly created app are shown on the screen. Add these values in your  Dropbox Connector



  6. The "Redirect URIs" field is used to push the documents from your SigningHub site to Dropbox. Specify the callback URL of your SigningHub site and click the "Add" button.


  1. For example if your SigningHub site is "https://web.signinghub.com" then the redirect URL will be "https://web.signinghub.com/OAuth/DropBoxCallBack".
  2. The "Drop-ins domains" field is used to pull the documents from Dropbox. Specify the URL of your SigningHub site e.g. "https://web.signinghub.com" and click the "Add" button.


Create a Dropbox connector

  1. Access the SigningHub Admin portal.
  2. Click the "Configurations"section from the left menu.
  3. Click the "Connectors" tab. The "Connectors" screen will appear.
  4. Click  from the grid header.



  5. A dialog will appear to add the connector details. The connector dialog is comprised of two screens, i.e. Basic Information and Details. Specify the basic information and click the "Next" button to provide the respective connector details. See the below table for fields description.




     
  6. Click the "Finish" button. A new connector will be saved and displayed in the list.


Basic Information

Fields

Description

Name

Specify a unique name for this connector, i.e. My Dropbox. This connector will be used in the configuration of Global Settings.

Provider

Select the provider for this connector, i.e. "Dropbox". 

Purpose

This field will display the purpose of the selected provider above, i.e. the purpose of "Dropbox" is "Cloud Drive".

Active

Tick this check box to make this connector active. Inactive connectors cannot be configured in the Global Settings.


Details

Fields

Description

Logo

Select an appropriate image in the jpeg, jpg, gif or png format for the connector's logo that will be displayed on the login screen.

App Key

  Specify the registered app ID that has been provided by Dropbox to connect to the Dropbox server, e.g. "94zt9tmbyeedsxh". See details as how to get the App Key.

App Secret

  Specify the registered app secret that has been provided by Dropbox to connect to the Dropbox server, e.g. "92yeroxz1kbg3dls".See details as how to get the App Secret.

Allow Multiple Files Selection

Tick this check box to enable the end users to import multiple files from Dropbox.


Configure the Dropbox Connector as Default in the SigningHub Global Settings

  1. Click the "Configurations" option from the left menu.
  2. Click the "Global Settings" option.
  3. Global Settings will appear, select the "Default Connectors" option from the top right drop down. 
  4. Configure these settings as required and click the "Save" button from the screen bottom. 
  5. Select the default Dropbox connector for SigningHub Desktop Web. The selected connector will be used to pull the Dropbox content (documents) directly into SigningHub Desktop Web. The Dropbox connectors are managed through the connectors section, see details.

 


Enable your cloud drives 

  1. Access the SigningHub Web portal.
  2. Click your profile drop down menu (available at the top right corner).
  3. Click the "My Settings" option. 
  4. Click the "Cloud Drives" option from the left menu.
  5. Click the "Enable" option against the Dropbox cloud drive.



  6. A pop-up will appear asking for the authentication of the Dropbox cloud drive. Provide your credentials and click Login.
  7. Upon successful authentication, the cloud drive will be enabled, and will start appearing in the Post Processing screens.
  8. To pull document from Dropbox, go to “Start New Workflow” and click on the Dropbox icon to upload document.
  9. Document will be pushed to the Dropbox account (if post processing was set during workflow) that has been configured, once a workflow will be completed.




See Also