How to set up the Dropbox Dash connector for GitHub

You can connect your GitHub account to Dropbox Dash so you can access and search your GitHub content directly within Dash. This requires requires OAuth authentication to ensure Dash only retrieves information relevant to your data, giving you full control over what Dash can access. Dash strictly follows the OAuth model, meaning it only accesses the data you specifically permit.

Integration features

For GitHub, Dash captures the following details:

• Repositories: Repositories are the most basic element of GitHub. It's 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 help you 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: Pull requests are requests 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 requests the following authorizations:

• 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.

How content syncing works

• Content sync begins immediately after establishing a connection, to ensure you can start searching right away, prioritizing the most relevant data.
• Activity feed refers to content 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.

How to connect GitHub to Dropbox Dash

1. Open Dropbox Dash.
2. Click Apps near the bottom of the left sidebar.
3. Locate GitHub in the apps list.
4. Click “+” (plus) on the right to connect the app.
5. You’ll be prompted to log in to GitHub, and click Sign in.
6. Click Authorize Dropbox Dash.
7. If the connection is successful, you’ll see a confirmation message at the bottom of the page.

How to check your connected apps

1. To check your connected apps, open Dropbox Dash.
2. Click Apps near the bottom of the left sidebar. GitHub should display in the Added section.