Adding Box and Dropbox Repositories

Owned by Cooper Labenske
Last updated: Apr 05, 2022
3 min read

HQ can index the contents of both Box and Dropbox, but it cannot access files directly and must use a specific authentication scheme to do so. While the details of connecting to Box or Dropbox repositories are different, they share some higher-level similarities: 

  • They both require a custom App that manages API access to data in a specific account

  • They both require generating a unique access token (Dropbox) or configuration file (Box) that HQ then uses to connect to the repository

The main differences between the two platforms lie in the processes for generating the Apps and access tokens/configuration files.  This article will cover the basic implementation of indexing Box and Dropbox sets, but it is by no means exhaustive and users should always refer to each site's documentation and tutorials. 

Creating a Dropbox Repository

IMPORTANT NOTE: You should always refer to the Dropbox documentation for the latest information on working with the Dropbox API.

Before you can create a Dropbox repository, you will need:

  • A Dropbox Developer account (create one if you do not have one yet)

  • Data to index

  • The path to the data, relative to the root of your Dropbox

  • An App, which manages access and security for your Dropbox files (see Build Your App on the DBX Platform for detailed information)

  • An Access Token (this token can be used to access your Dropbox account - be very careful with whom you share it)

To create a Dropbox Repository in HQ:

  • Go to HQ > Indexing > Repositories and click Add New

  • Select File for the Repository type and click Next

  • Select Dropbox from the drop-down menu

 

In the Add Repository window, enter:

 

 

 

  • A unique Name for the Repository

  • The Access Token generated by your Dropbox App

  • The Dropbox Path, which is the path from the root of your Dropbox account to the data you are indexing (if you don't enter a path, Voyager will index all contents of your Dropbox account, starting at the root)

  • When you are done, click Next and continue with the remaining steps to create a new Repository

  • At the final step, click Index to begin indexing the new Repository

  • Open Navigo in Voyager Server to view the indexed data

Resources For Dropbox

Creating a Box Repository

IMPORTANT NOTE:  You should always refer to the Box documentation for the latest information on working with the Box API.

Before you can create a Box repository, you will need:

  • A Box Developer account (create one if you do not have one yet)

  • Data to index

  • The path to the data, relative to the root of your Box account

  • An App, which manages access and security for your Box files (see Installing and Using Apps in Box for detailed information)

  • A JSON file that includes the clientID (download this from your Box App)

To create a Box Repository in HQ:

  • Go to HQ > Indexing > Repositories and click Add New

  • Select File for the Repository type and click Next

  • Select Box Cloud Storage from the drop-down menu

In the Add Repository window, enter:

  • unique Name for the Repository

  • Connection Config (this is the value of clientID in the JSON file you downloaded from Box)

  • The Box Path, which is the path from the root of your Box account to the data you are indexing (if you don't enter a path, Voyager will index all contents of your Box account, starting at the root)

  • When you are done, click Next and continue with the remaining steps to create a new Repository

  • At the final step, click Index to begin indexing the new Repository

  • Open Navigo in Voyager Server to view the indexed data

Resources For Box