Dropbox

How it works#

The Dropbox connector ingests all documents from your Dropbox account into Nexus.

The connector recursively pulls all files from the root directory of your Dropbox account. It is currently not possible to pull files only from specific directories.

The connector will only pull once upon initialization. If you would like to pull more documents, you must generate a new access token (step 6 below), put that token into the connector, and re-initialize the connector.

Setting up#

Authorization#

Create Dropbox app#

Head over to https://www.dropbox.com/developers/apps and click the Create app button on the top right. Select Scoped access and Full Dropbox as the type of access. Give your app a name like 'Nexus Connector' and click Create app.

Open Permissions#

Click on the Permissions tab.

Grant required scopes#

Check the files.content.read and sharing.write permissions so the files can be read and links for the documents can be created. Click Submit to save the changes.

Generate access token#

Navigate to the Settings tab and scroll down to the OAuth 2 section. Click Generate to generate an access token.

You must complete granting permissions before generating an access token. Changing permissions will not affect existing access tokens, and Nexus will be unable to index your Dropbox.

Copy access token#

Copy the access token.

Refresh the page if you need to regenerate your access token

Indexing#

Open Dropbox connector#

In the Nexus UI, navigate to the Admin Panel and select the Dropbox Connector

Enter access token#

Provide the access token from the previous step

Start indexing#

Click Connect to begin indexing your Dropbox files

Before using this source with students#

Start with approved course material. Check which documents the connector can retrieve and how it maps source permissions. Test with a student account and a teacher account before widening access. A successful sync does not prove that the intended class boundary is correct.

Use source troubleshooting when a document is missing or visible to the wrong audience.