How to set up GitHub App integration?
GitHub App Setup
Permissions
The GitHub App requires the following permissions prior to integration:
Repository permissions:
Administration:
Access: Read and writeContents:
Access: Read and writeMetadata:
Access: Read-onlyProjects:
Access: Read-onlyPull requests:
Access: Read and write
To update your GitHub Apps permissions, go to the app in your GitHub account located here, click the button next to your app, select
from the menu to the left, then change the approrpiate Repository Permissions, then click the Save changes button at the bottom.
Private Key
From the section of your GitHub, scroll down to the Private Keys section and click to generate a private key as shown below:
![image-20240530-161409.png](../__attachments/2474213378/image-20240530-161409.png?inst-v=8ed9d612-469d-42f2-91de-89125d175e22)
Once the private key has downloaded, open the file with a text editor, as the contents will need to be pasted during the integration setup.
Jigit GitHub App Integration
Navigate to the Jigit Plugin Config located under the Managed apps section of Jira. Under the Configurations Tab, select
Select GitHub App and specify which of the apps features are required.
Enter the specified details and paste the Private Key from your GitHub App and the App Id, found in the General section of your GitHub App.
Select which branches to be indexed
From the Advances settings, you can change the indexing parameters:
Provide a name for the Integration
Pressing the will check the integration is complete, and provide an error for any issues that need to be address. Once you have a green bar with
, press Save and the integration is complete.