GitHub links for Jira

GitHub links for Jira allow you to bring additional information about GitHub entities, like issues, pull requests, milestones, to Jira’s issue view page.

How does it look?

On the left side of the issue view you will see enriched GitHub links. GitHub links parsed out from description, comments and custom fields.

Configuration

If you want to use this App only with public repositories - you do NOT need any configuration. You only need to follow the next steps if you need to connect to your private organization.

Connect GitHub links for Confluence with your organization

Important: Make sure that when you authorize our GitHub OAuth App to access your data you select the organization you want to use the App with.

Here is short (25 seconds) demo video on where to make sure that GitHub links GitHub App is authorized to access your organization's data.

Please watch the video below and pay attention that the org access is given, not only personal.

Important: if you need to reconnect the GitHub links App with your organization please 1 - disconnect the App in the Confluence (go to the Configuration page) and 2 - delete access for our App on GitHub side (in org settings).

A. Navigate to the Jira Settings → System → Github Links Configuration page

B. Click on the "Connect" button and authenticate yourself and authorize the App to see your private organization.

When you allow GitHub App to access your data, please make sure that you grant permissions to your organization as well, not only your personal repositories.

Use with private repositories

To use the private repositories you need to follow the steps in the Configuration section above.

Use cases

All use cases use public links so that you can reproduce them straight away.

Pull request information

https://github.com/facebook/react/pull/17484

Readme embedding

https://github.com/cjbarber/ToolsOfTheTrade/blob/master/readme.md

You can also keep the file open by checking “Do you want to see extended information about the link“ checkbox.

Issue information

https://github.com/facebook/react/issues/17785

The list of the latest pull requests

https://github.com/microsoft/team-explorer-everywhere/pulls

The list of the latest issues

https://github.com/facebook/react/issues

User and organization information

https://github.com/moveworkforward

https://github.com/facebook

https://github.com/Atlassian

https://github.com/spudbean

The list of labeled issues of a milestone

Set the filters in the dialog of the macro.

The parameters used are listed on GitHub in a table - https://developer.github.com/v3/issues/#list-issues-for-a-repository

Save the macros to see the changes.

Known issues

GitHub Enterprise is not supported at the moment.
Github links for Jira can be used with private and public repositories and organizations.
We cannot get more fine-grained permissions at this stage, due to restrictions from GitHub API.

Security and compliance

We do not store or read any of your code or user data. We only use GitHub APIs to enrich the link you inserted.

Get help

You can create a Jira Service Desk support request with all information you could gather, please include the screenshot of the configuration, links and time stamps.

Updated: 19 Feb 2021