View the full list of steps

How to Setup the Dropbox Dash Connector for Github

Overview

Users can connect their GitHub account to Dropbox Dash, allowing them to access and search all of their GitHub content directly within Dash. This integration requires OAuth authentication to ensure that Dash only retrieves information relevant to the user’s data, giving them full control over what Dash can access. Dash strictly adheres to the OAuth model, meaning it only accesses the data users specifically permit.

Users can only connect to Dash if the integration has been approved and enabled by their Dash admin.

Team members must authorize access for Dash to connect.

Integration features

For GitHub, Dash will capture the following details:

Items
How Dash uses the items
Repositories
A repository is the most basic element of GitHub. It's a place where you store your code, your files, and each file's revision history. Dash gathers information such as the title, content and timestamp, so it can search through these items.
Issues
Issues are items you can create in a repository to plan, discuss and track work. Dash gathers information such as issue title, state, and timestamp so it can search through these items.
Labels
Labels can be used to manage your work on GitHub to categorize issues, pull requests, and discussions. Dash gathers the label name to enhance search capabilities.
Members
Members are the users of an organization. Dash gathers the name of the members to enhance search capabilities with people data.
Pages
Pages are static websites that users can host on GitHub. Dash gathers the title and content, so it can search through these items and enhance search capabilities.
Pull Requests
A pull request is a proposal to merge a set of changes from one branch into another. Dash gathers information such as title, content, and timestamp, so it can search through these items.
Releases
Releases are deployable software iterations you can package and make available for a wider audience to download and use. Dash gather the release name and contents, so it can search through these items.
Tags
Repository tags mark a specific commit at a point in your repository history. Dash gathers the tag name to enhance search capabilities.

API usage

When connecting GitHub to Dropbox Dash, Dash will request the following authorizations:

Authorization request
Purpose of the request
Verify your GitHub identity
Allows Dash to access your public GitHub profile. This is required by GitHub to be able to integrate with Dash.
Know which resources you can access
Allows Dash to determine which resources you can access that the app can also access. This allows Dash to make sure you can access the appropriate content on GitHub. This is required by GitHub to be able to integrate with Dash.
Act on your behalf
Required by GitHub to be able to integrate with Dash.

Learn more about authorizing GitHub apps.

Crawling strategy and performance

  • Content sync begins immediately after establishing a connection, to ensure you can start searching right away, prioritizing the most relevant data.
    • “Recent/latest items" refer to content that a user has interacted with through actions such as preview, upload, create, comment, open, modify/update, share, and shared-with-me.
  • Incremental sync occurs every 15 minutes.

User requirements

The user must have a GitHub account to connect to.

How to connect GitHub to Dropbox Dash

  1. Open Dropbox Dash.
  2. Click Apps near the bottom of the left sidebar.
  1. Scroll down to the section All and find the GitHub app.
  2. Click the “+” (plus symbol) on the right to connect the app.
  1. You’ll be prompted to sign in to GitHub. Enter your login credentials and click Sign in.
  1. You’ll be presented with a list of permissions required by Dash. Click Allow to continue.
  1. If the connection’s successful, you’ll see a message at the bottom of the page, confirming that GitHub was connected.

Connected apps

  1. To check your connected apps, open Dropbox Dash.
  2. Click Apps near the bottom of the left sidebar. You should now see GitHub under the Added section.
Made by Dropbox — trusted by over 700 million registered users

Supercharge your team with AI-powered universal search