Connect AptEdge to Confluence Cloud

This guide explains how to create a Confluence OAuth integration and connect it to your AptEdge instance.

Prerequisites:

1. We recommend creating an integration user in Atlassian for this connection (It can be the same account used for Jira)

2. Ensure the user has access to all Confluence spaces that should be indexed in AptEdge.

3. The account only requires read permissions.

The following steps should be performed with the integration user.

Step 1: Create a Confluence OAuth Integration

1. Navigate to the Atlassian Developer Console:

   https://developer.atlassian.com/console/myapps

2. Click Create.

3. From the dropdown menu, select OAuth 2.0 Integration.

4. Enter a name for the integration, for example:

   AptEdge Confluence Integration

5. Click Create.

Step 2: Configure Confluence Permissions

1. In the left-hand navigation menu, select Permissions.

2. Click Add next to Confluence API.

3. Select Configure.

4. Under Classic Scopes, click Edit Scopes.

5. Enable the following permissions:

• Read Confluence space summary (read:confluence-space.summary)
• Read Confluence content properties (read:confluence-props)
• Read Confluence content summary (read:confluence-content.summary)
• Read Confluence detailed content (read:confluence-content.all)
• Search Confluence content and space summaries (search:confluence)
• Read content permission in Confluence (read:confluence-content.permission)
• Read user (read:confluence-user)
• Read user groups (read:confluence-groups)
• Download content attachments (readonly:content.attachment:confluence)

6. Click Save.

Step 3: Configure OAuth Authorization

1. In the left-hand navigation menu, select Authorization.

2. Click Add under OAuth 2.0.

3. Enter the callback URL for your AptEdge instance:

   1. For example, if your aptedge instance is https://acme.aptedge.io, enter

   2. https://acme.aptedge.io/confluence/callback

4. Click Save changes.

Step 4: Retrieve the OAuth Credentials

1. Open the Settings page of your OAuth integration.

2. Copy the following values:

• Client ID

• Client Secret

You will need these values to connect Jira to AptEdge.

Step 5: Connect Confluence to AptEdge

1. Log in to your AptEdge instance as an administrator.

2. Click the gear icon in the top navigation.

3. Select:

Admin Settings → Integrations

4. Find Confluence Cloud.

5. Click Connect.

6. Enter the following information:

   OAuth Client ID
   (from Step 4)

   OAuth Client Secret
   (from Step 4)
    

7. Click Authorize.