Connect to GitHub Cloud (github.com)

Public repositories

No configuration needed.

Private repositories

By default no configuration is required. Each user will have to authenticate with OAuth to GitHub to access the content. Therefore, each Confluence user also needs a GitHub account to see the private repositories.

Shared Authentication

Alternatively, shared authentication can be used. All Confluence users will share the same authentication to GitHub and therefore won’t need a GitHub account. Confluence users will see all content the authentication token has access to.

1. On github.com , navigate to

   1. User (top-right) → Settings → Developer settings → Personal access tokens → Fine-grained tokens

2. Generate a new fine-grained token

   1. Select the Resource owner:

      • Choose your personal account or

      • Choose your organization (available if the organization allows fine-grained tokens)

   2. Select the repositories you want to grant access to

   3. Use the following permissions:

      • Contents: Read-only

      • Pull requests: Read-only

      • Issues: Read-only

   4. Set an expiration date

      

      
      

3. On Confluence, navigate to the Settings → Apps → Include from GitHub to Confluence

4. Switch the authentication method and save the token:

Configuration in Isolated Cloud environments

Additional step for Isolated Cloud environments:

Before the app can access content from GitHub.com repositories, a Confluence administrator must approve data sharing with GitHub domains.

If repository content is inaccessible or a domain approval warning is displayed, verify that GitHub domain access has been approved:

1. Go to Confluence Administration → Apps.

2. Select Include from GitHub to Confluence.

3. Check for a warning message prompting you to Allow Access or Update Access to GitHub.com.

You can also review the approved domains:

1. Go to Confluence Administration → Manage apps → Connected apps.

2. Select Include from GitHub to Confluence.

3. Click Data management to view the approved domains and permissions.