Skip to main content

Dropbox

Dropbox is a file hosting service operated by the American company Dropbox, Inc., headquartered in San Francisco, California, that offers cloud storage, file synchronization, personal cloud, and client software.

With Dropbox bring Your Files & Cloud Content With the Tools Your Team Wants To Use. Easily Access Your Teams Work From Your Computer, Mobile Device, or Any Web Browser. Password-Protected Links. Extended File Recovery.

There are 3 ways to connect to Dropbox:

Regular Dropbox OAuth: This allows us to connect to the Dropbox API. This authenticates with only one user, and any content must be able to be accessed by that user.

Dropbox for Business OAuth: This allows us to connect to the Dropbox For Business API. This will require an Admin to login for a Dropbox for Business

Developer Token: These last about 1 hour and are good for testing or providing temporary access.


Application Setup

First, you'll need dropbox account.

Then go to: Dropbox Developer Apps.

  • Click the Create app button
  • Create your app under My Apps
  • Select the Scoped access permission model
  • Select Full Dropbox for the access type
  • Name your app
  • Check the I agree box
  • Click the Create app button

Now, you should be able to go to your app control panel. You have two options Add the following to the redirect uri:

https://{simflofy instance}/simflofy-admin/authconn/oauthcb

Use the Access Code

Hit "Generate Access Token" and copy the code. That's it!

Back in Simflofy, create or edit your authentication connection and enter the auth code in Client Auth

Key and Secret

Now, grab your App key and secret. Make sure, if you copy them, you didn't grab any extra spaces.

Back in Simflofy, create or edit your authentication connection and enter your app key and secret and hit "Authenticate". If this is a business application, check the "Use Business API" checkbox first.

You will be asked to log into your dropbox account and give your app access permission. You will then be returned to Simflofy and you can save your access tokens.

For a business connection, you will have a dropdown for team members in the connection upon editing the connection again. Any action taken with this auth connection will be performed as that member.


Authentication Connection

Requirements

Simflofy must be running with SSL (https://). See Tomcat SSL

  • Name: Unique name for this auth connector.
  • Dropbox App Key: Client ID Dropbox will give you once you've set up the Application in Dropbox.
  • Dropbox Secret Key: Secret Key Dropbox will generate for you as part of the Application Setup in Dropbox.
  • Dropbox Client Auth Code: Optional Developer Token to be used instead of requiring users to login.
  • Business API: Optional Flag for whether to use the Dropbox For Business API (Checked)or the regular Dropbox API (Unchecked).

Discovery Connector

Dropbox only has two core types, Files and Folders. Custom metadata takes the form of templates. These templates have names and field groups. These templates will appear as a type in the discovery report. More info

Discovery Instance Fields

  • Name: Unique Name for the Discovery Connection to identify it in the UI.
  • Authentication Connection: The Authentication connection that you want to use.
  • Ignore Types: Comma delimited list of types to ignore. Note that you can have regex as well. So to ignore all types with "workflow" in the name, you would enter(.)workflow(.) into the ignore types textbox.
  • Folder Path: The directory location where your files are stored.

Integration Connector

The Dropbox Integration Connection is designed to write content, and it's associated metadata into a specified Dropbox location.It is also for retrieving content, and it's associated metadata from Dropbox. Utilizing the Dropbox Java SDK and Dropbox APIs, the Dropbox Integration Connection allows the user to obtain content and metadata from their specified Dropbox Location. More info

  • Connection Name: This is a unique name given to the connector instance upon creation.
  • Description: A description of the connector to help identify it better.
  • Authentication Connector: Your FileNet Auth Connector

Job Configuration

  • Repository Folders: Comma delimited list of folder paths to crawl
  • Get Folders: Process Folders

Content Service Connector

Content Service Connector

This section covers the Dropbox specific configuration of the Content Service Connector. For a description of how to set up a content services connector generically see Content Service Connectors.

Basic Configuration Fields

  • Connector ID: Give your connector a unique name
  • Description: Provide a description for this connection
  • Type: Select your DocuWare connector
  • Keep Connection Alive: Keep this connection active
  • Keep alive in Milliseconds (300000 is 5 minutes): How long until connection expires if unused
  • Connection URL: The web address for your connection
  • Security mode: Select your preferred type of security credential access(Service Provided, User Pass through or Authentication Connector)
  • Mapping Type: Choose a single map or group mapping

Connection Configuration

  • Extra parameters can be passed to the content service connection and vary by connection.

Supported Method

  • Create File
  • Create Folder
  • Delete Folder
  • Delete Object By Id
  • Get File Content
  • Get Object Id By Path
  • Get Object Properties
  • Get Types
  • List Folder Items
  • List Versions
  • Update File

Need help integrating DropBox? Learn more here.