Confluence

You can integrate your TeamRetro team with your Confluence Cloud or Confluence Server Space to publish retrospective and health check summaries. To configure this integration you must be a TeamRetro team administrator.

Supported Confluence editions:

• Confluence (Cloud)
• Confluence (Data Center)
• Confluence (Server)

Supported authentication methods:

• Confluence Cloud - Atlassian Login - connect to your Confluence (Cloud) instance using the Atlassian Cloud Oauth2 provider.
• Confluence Cloud - API Token - connect to your Confluence (Cloud) instance with a secure way of using scripts.
• Confluence Server / Data Center - Personal Access Token - connect to your Confluence (Data Center / Server) using personal access tokens as a safe alternative to authenticating with a username and password.
• Confluence Server / Data Center - Basic Authentication - connect to your Confluence (Data Center / Server) using username / password.

• Confluence Server / Data Center - Application Link - connect to your Confluence (Data Center / Server) using your Confluence instance as an Oauth provider.

  
  

Please note if connecting to Data Center or Server editions, your Confluence instance must be publicly accessible on the internet (so our application can talk to it). For further information on how our Confluence integrations work and the authorization scopes requested, please refer to Confluence Integration Security.

Configure in TeamRetro

1. On the TEAM > SETTINGS > INTEGRATIONS screen

   

2. Click CONNECT next to Confluence.

   

   
   
3. In the configuration dialog, select the AUTHENTICATION METHOD you wish to use.
   1. Confluence Cloud - Atlassian Login
   2. Confluence Cloud - API Token

   3. Confluence Server / Data Center - Personal Access Token

      Confluence Server / Data Center - Basic Authentication

      Confluence Server / Data Center - Application Link

      • 

If you selected Confluence Cloud - Atlassian Login for Confluence (Cloud):

1. Click Sign In To Confluence Cloud.

   

2. You will be redirected to atlassian.com to authorize TeamRetro to post pages to your space.

   For further information how our Confluence integrations work and the authorization scopes requested, please refer to Confluence Integration Security.

   
   

3. Click on Accept to authorize TeamRetro.

   

   
   

4. Select your Atlassian Cloud instance from the dropdown

   

   
   

5. Click NEXT (->)

   
   

If you selected Confluence Cloud - API Token for Confluence (Cloud), you first need to configure the API Token in your Confluence instance.

1. Open your Confluence instance in a new tab and navigate to Your profile and settings > Manage account.
2. You will be directed to your Atlassian Account. Select the Security tab.
3. Click Create and manage API tokens.

4. Click Create API token.

   

   
   
5. In the Create API token dialog:
   1. Enter a Label for your token: TeamRetro (or similar).

   2. Click Create.

      

      
      

   3. On the new API token screen, make note of or copy your API token.

      

6. Return to the TeamRetro tab.
7. Enter your Server URL (note: your Confluence instance must be accessible on the public internet to our IP addresses).
8. Enter your API token (provided by Confluence).
9. Enter your Email Address (provided by Confluence).

10. Click Next (->).

    

    
    

If you selected Confluence Server / Data Center - Personal Access Token for Confluence (Data Center) or Confluence (Server), you first need to configure the Access token in your Confluence instance.

1. Open your Confluence instance in a new tab and navigate to Your profile picture > Setting > Personal Access Token.
   1. Click Create Token.
   2. In the Create a personal access token dialog:
      1. Enter a Name for your token: TeamRetro (or similar).
      2. Select Expiry date (you can select Automatic expiry or Never expiry).

      3. Click Create.

         

   3. On the Credentials screen, make note of or copy your Personal Access Token.

      

   4. Return to the TeamRetro tab.
   5. Enter your Server URL (note: your Confluence instance must be accessible on the public internet to our IP addresses).

   6. Enter your Personal Access Token (provided by Confluence).

      

   7. Click Next (->).

      
      

If you selected Confluence Server / Data Center - Basic Authentication for Confluence (Data Center) or Confluence (Server):

Enter your:

1. Server URL (note: your Confluence instance must be accessible on the public internet to our IP addresses).
2. Confluence Username (we recommend creating a new user with minimal permissions for this).

3. Confluence Password