---
title: "Git Hub_ How to Connect and Collect"
slug: "git-hub-how-to-connect-and-collect"
tags: ["Git Hub", "Collect", "Connect"]
updated: 2024-06-26T18:14:56Z
published: 2024-06-27T17:26:27Z
canonical: "docs.revealdata.com/git-hub-how-to-connect-and-collect"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revealdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Git Hub_ How to Connect and Collect

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-arqf8m2v.png)

#### **In this article**:

- GitHub Overview
- GitHub Requirements
- How to Connect and Collect Using GitHub

## **GitHub Overview**

GitHub is a web-based service that helps developers store and manage their code through repositories, as well as track and control changes to their code with Git version control. Onna connects directly with GitHub's API to collect a user's pull requests and issues.

| **Connector Features** |
| --- |
| **Authorized Connection Required?** No | **Is identity mapping supported?** No |
| **Audit logs available?** Yes | **Admin Access?** No |
| **Supports a full archive?** Yes | **Custodian based collections?** No |
| **Preserve in place with ILH?** No | **Resumable sync supported?** No |
| **Supports Onna preservation?** No | **Syncs future users automatically?** No |
| **Sync modes supported:** - One-time sync - Auto-sync | **Is file versioning supported?** No |
|  |
| **Types of Data Collected** | **Metadata Collected** |
| - All issues - All pull requests | - Path to original file - Repository name - Labels - List of creators - File size - Extension - File last modified |

### **GitHub Considerations**

- If your organization has enabled two factor authentication (2FA), Onna will make 2FA part of the synchronization workflow.
- Onna only collects issues and pull requests. We do not sync the actual files of the repository.

## **GitHub Requirements**

- In order to collect from a user, you will need their individual login credentials.

## **How to Connect and Collect Using GitHub**

To create a new GitHub collection follow the steps below:

### **Step 1**

Click on ‘Workspaces’ in the main menu (a), then click on the workspace where you’d like to add a new sync (b).

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-7lv1y7lx.png)

### **Step 2**

Click on the ‘+’ icon in the upper right corner to add a new source

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-a90f0vp4.png)

### **Step 3**

Select the GitHub connector from your list of available connectors.

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-vgwfy6fv.png)

### **Step 4**

Click the blue ‘Connect’ button.

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-g5ufg854.png)

### **Step 5**

You’ll now be taken to the Oauth flow where you’ll enter your username and password (a), then click the ‘Sign in’ button (b).

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-8qkxfwgt.png)

### **Step 6**

Once logged in, you’ll be taken back to Onna where you’ll configure your sync. To start, enter the sync name in the ‘Name’ field. Then, select your synchronization mode (b), and click the ‘Get repositories’ button (c).

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-t1c3jekp.png)

### **Step 7**

Next, you’ll choose which repositories to sync by putting a check next to the names of those you’d like to collect (a), then click the blue ‘Done’ button (b).

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-5iktjooc.png)

### **Step 8**

You’ll now see your new source appear alphabetically in the list of ‘Connected sources’ in your workspace.

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/git-hub_-how-to-connect-and-collect-image-de820n1a.png)

## Related

- [Getting Started with Sources](/getting-started-with-sources.md)
- [Onna Sync Modes](/onna-sync-modes.md)