Getting Started

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. 

Integration Features

The GitHub integration syncs an individual GitHub user's account. 

Files Collected

• All issues 

• All pull requests

Historical information and related metadata, including:

• Path to original file 

• Repository name

• Labels 

• List of creators 

• File size

• Extension 

• File last modified

Onna's sync modes

We currently support two syncing modes - One-Time Sync and Auto-Sync.

• One-time sync: Onna will perform a one-time sync that collects information from the source only once during a specified time range or up until the date the source was added. 

• Auto-sync: Onna will perform a full sync from the data source first. Onna will keep the data source in mirrored sync. Any deletions from the data source will be deleted in Onna, as well.

Data Exports

You can export data and metadata in eDiscovery ready format. Exported files are available in the following formats:

• dat 

• CSV

• Custom text file 

How to start a GitHub collection

For this integration, you'll only be able to collect a single user's issues and pull requests.

From My Sources click on Add new source and select GitHub

Select GitHub from the list of integrations. If you aren't already signed in to the Github account, it will take you to the sign-in screen

Once you add the account details, you may be taken through to the two-factor authentication screen if you have it enabled. 

Once you authenticate the account, you'll be taken back to Onna.

Give your source a name and decide what synchronization mode you like. The next step is to add the repositories associated with the account to sync to Onna. 

You'll have the option to select all repositories or specific ones. This will pull in all issues and pull requests from that repository. Once you've finished the repository selection, click Done. The GitHub source will not appear in your My Sources section and will begin syncing.

GitHub Files in Onna

GitHub issues and pull requests are processed in HTML format. These files will be rendered in Onna as follows:

You will see all labels listed at the top including status, assignees, labels, projects and milestones. There are time and date stamps for all modified sections of the issue. 

Accessing audit logs

On results page, clicking on the information icon on the top right will take you to the source details where you can see how many files the source has and its size. In this same panel, you can scroll down and select the Audits button to see the source's collection audit logs.

Ready to start collecting from GitHub?

GitHub FAQ

How does Onna deal with two-factor authentication (2FA)?
With any of the integrations that we offer, Onna makes 2FA part of the synchronization workflow. 

Does Onna collect the code repository of the user's account?
Onna only collects issues and pull requests. It does not sync the actual files of the repository.