search mobile facets autocomplete spellcheck crawler rankings weights synonyms analytics engage api customize documentation install setup technology content domains user history info home business cart chart contact email activate analyticsalt analytics autocomplete cart contact content crawling custom documentation domains email engage faceted history info install mobile person querybuilder search setup spellcheck synonyms weights engage_search_term engage_related_content engage_next_results engage_personalized_results engage_recent_results success add arrow-down arrow-left arrow-right arrow-up caret-down caret-left caret-right caret-up check close content conversions-small conversions details edit grid help small-info error live magento minus move photo pin plus preview refresh search settings small-home stat subtract text trash unpin wordpress x alert case_deflection advanced-permissions keyword-detection predictive-ai sso

Dropbox Connector Guide

Ingest all of your Dropbox files into Enterprise Search.

The Dropbox Connector requires that you create an OAuth App within Dropbox.

Configuration

Login to Dropbox's app developer portal: https://www.dropbox.com/developers/apps.

Click the Create app button:

Dropbox - Click Create app.
After logging in, the screen is clean and simple. There is one nice blue botton, which you need to click.

You'll need to define the type of app.

Select the Dropbox API with Full Dropbox access, then provide a name. Elastic Enterprise Search is a good one:

Dropbox - Filling out dropbox app information.
Dropbox sure has these UIs nailed. It's a clean screen, ample white space, and it contains  clear choices.

Now that we've created a new app, there are two important things to understand...

  1. The app can stay in developer mode. You do not need to publish it.
  2. Make sure that you create this app with a trusted and stable Dropbox account!

We recommend creating a team-owned account for only this app. If access is lost, we cannot help.

Back to the fun ~ we're ready to finish up and reveal the secrets.

Enter two callback URLs, clicking Add for each:

  1. http://localhost:3002/ent/org/sources/dropbox/create
  2. http://localhost:3002/ent/sources/dropbox/create

You can also reveal your App key and App secret now.

Keep them secret!

Dropbox - Adding a callback URL and revealing the secrets.
The sleek UI show continues. The app has been created, but it's just a shell of itself. The picture has three menus, and places to enter your text and values.

You can also add a logo to help you identify which app is for Enterprise Search.

Click Branding from the top app menu.

Select Choose from Dropbox.

Here's the Elastic Enterprise Search logo, if you'd like to upload and use it.

Right click and save-as:

It's all colourful, sleek, and sophisticated. A partial, sunlike circle with a convex-like bubble coming out of the right side connects to what looks like a convex green eye. It's pretty radical.

The application is complete. Great!

For the final step, you must return back to Enterprise Search.

Login to Enterprise Search.

Within the administrative dashboard, click Settings within the sidebar.

Navigate to Content Source Connectors:

Dropbox - Click Settings within the sidebar, then Content Source Connectors.
A picture of the sidebar within the administrative dashboard. The item

Click Dropbox and then fill in the App key as the Client ID.

And fill in the App secret as the Client Secret, then click Save Changes:

Dropbox - Add the Dropbox tokens to Enterprise Search.
Two simple text boxes, one green button. It's not our finest view, but it does the job.

Click Settings if you ever need to change tokens or remove the Connector.

Dropbox - A successful configuration.
Content source... added. Nice work.

Now, click Sources within the sidebar.

Dropbox - Click Sources within the sidebar.
A picture of the sidebar within the administrative dashboard. The item

Click Add under the Dropbox source.

First, you'll need to click I understand.

Why the hurdle? We want to make it clear that you're adding a public source.

All of its contents will be accessible by those with the right permissions.

If you're comfortable with that, click the button:

Dropbox - Understanding the nature of public sources.
It's a button that says I understand. Seems annoying, but you'd be amazed at the things that happen.

After that, you'll be asked to connect to Dropbox:

Dropbox - Forward, for OAuth.
Connect the Connector!

You'll then be presented with an OAuth screen from Dropbox.

Once you accept, you have added Dropbox as a content source to your organization.

Congratulations! It's time to search.

You can now make the source available to various groups and scale its relevance priority.


Enjoying the beta? Something broken? Lost? Please send us your feedback or visit the Enterprise Search community.