GitHub is a widely used development platform. The Kualitee-GitHub two-way integration allows you to sync your issues between both tools. Each GitHub project can be linked with a Kualitee project to sync all the reported issues that exist in both projects. Since it’s a two-way integration, all updates that are made on the issue will automatically get synced, including a change in status, additional comments, and associations changed through Kualitee. 

Creating GitHub Integration

To integrate with GitHub, you click on ‘create integration’ in settings and choose GitHub from the product list. Provide your personal access token and domain URL to successfully create a domain-level integration.

After creating the integration, map your GitHub Project to the Kualitee project. To map your project, click on the action > edit, next to the GitHub integration on the listing screen as shown below:

You will be navigated to the mapping screen. Follow the steps below to map your project

1. Click on map project button. 
    
   A popup will open.  
   Select integration type as “Basic” 
   Select the organization 
   Select the repository that you want to sync 
   Select the Label only if you want to sync defects having that particular label. If you want to sync all the defects having different or No Label, then leave it as it is. 
   Select the Kualitee Project that you want to map 
   Click on Save button to save the mapping 
    
   Project will be mapped and will be displayed on mapping screen. 
    
   Click on the view button to view the fields that will be mapped on both tools. The basic mapping is a hard-coded field-to-field mapping between Kualitee and GitHub. Below is a table that shows the mapping for each field.  

GitHub token generation steps:

Navigate to: https://github.com/settings/tokens

Click on generate new token (Classic)

Enter token name or any information in the “note” field

Set the expiry date of token

Select the scope of token as shown in below image, and click on ‘generate token’ button

To integrate on Kualitee:

Go to Kualitee -> Settings -> Integrations

Click on ‘Create Integration’

Select GitHub as tool from the drop down menu

Copy the token in Personal Access token field

Click on the ‘edit’ icon and navigate to the Project Mapping screen

Click on ‘Map Project’ button

Select the integration type as ‘basic’

Select the organization that you want to map (if you want to map repository integrated from organization)

Select GitHub repository

Select labels (If you select the labels only, the labeled defects will be pulled from GitHub)

Select the Kualitee project with which you want to map

Click on the ‘Save’ button to save the integration