GitHub links are not unfurling in Jira
Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.
Problem
With the GitHub for Jira app, Jira administrators can integrate Jira with GitHub organisations. Once the app is installed and configured, GitHub links posted on Jira issues (Description, comments) are expected to 'unfurl' to show the content of the GitHub link.
However, in some cases, the GitHub links added to Jira issues don't 'unfurl' but instead show as 'RESTRICTED CONTENT'.
Cause
There are multiple possible reasons a Github link shows as 'Restricted':
- The user viewing the link does not have the necessary permissions to view the link content under GitHub – This can include not being part of the necessary GitHub organisation with the appropriate access level or not having read permissions to the linked GitHub repository.
- There is an IP address allowlist (GitHub: Managing allowed IP addresses for your organization) configured under your GitHub organisation, and Atlassian IP ranges are not added to the allowlist.
Solution
Make sure the users encountering the problem have the necessary permission to view the content of the link under GitHub
- Ensure that the user encountering the restricted content issue has the necessary permissions to view the content in GitHub. This includes being part of the necessary GitHub organisation with the appropriate access level and having permission to access the repository in GitHub.
Make sure to add all Atlassian IP ranges in the GitHub IP allowlist (including Forge IP addresses)
- If there is an IP address allowlist configured under your team's GitHub organisation, please make sure to add all the Atlassian IP ranges documented under IP addresses and domains for Atlassian cloud products: Outgoing Connections and also all the IP address ranges for outgoing connections for Forge apps documented on Updated IP address ranges for outgoing connections for Forge apps
Due to a limitation on Github's end, these IP ranges will have to be added to the Github IP allowlist one by one. There is currently no functionality to add IP addresses to Github’s allowlist in bulk.