GitHub links for Confluence
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).
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/repositories.
A. Navigate to the Settings → Github linker 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 and allow our GitHub App to access your private repositories. We do not close or access source code, we use GitHub APIs to get additional information from the links inserted in Confluence.
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
Milestone information
https://github.com/facebook/react/milestone/40
Release information
https://github.com/facebook/react/releases/tag/v16.12.0
The latest release information
https://github.com/facebook/react/releases/latest
The list of the latest releases
https://github.com/facebook/react/releases
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. The reason is that our App gets called when a particular github.com link is inserted on the page, it is not possible to dynamically tell Confluence with URLs should be handled by our App.
Github links for Confluence 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: