🆕Knowledge Base: Confluence (OAuth 2.0 Authentication)

Overview

This guide will help you connect your Confluence content to MangoApps AI assistants using OAuth 2.0 authentication. Once set up, your assistants can draw answers directly from Confluence pages, blogs, and other structured knowledge in real time.

What You Will Need

Before starting the setup process, ensure you have the necessary credentials and access to both MangoApps and Atlassian systems:

• Access to your Atlassian Developer Console

• OAuth 2.0 client credentials, including:

  • Client ID

  • Client Secret

Setup in MangoApps

Step 1: Start the Knowledge Base Setup in MangoApps

To begin the integration, you will create a new knowledge base entry inside MangoApps AI Studio.

1. Navigate to Admin Portal > Modules > AI Studio > External KBs > Create a Knowledge Base.

2. Select Confluence as the data source type.

3. Add a name, description, and enter the URL of the Confluence page or space you want to connect.

1. Under Authentication Method, select OAuth 2.0 Authentication.

2. Copy the Callback URL provided—this is needed when registering your OAuth app in Atlassian.

Setup in Atlassion

Step 2: Create an OAuth 2.0 App in Atlassian

Next, you’ll set up an OAuth 2.0 application in the Atlassian Developer Console to authorize secure access between Confluence and MangoApps.

1. Go to the Atlassian Developer Console – My Apps. You can click this link to login directly to that page.

2. Click Create > OAuth 2.0 integration.

1. Name your app, agree to the terms, and click Create.

1. You will be redirected to the App Overview page. From here, click on the Authorization tab and click Add in the row named OAuth 2.0 (3LO).

1. When asked for a Callback URL, paste the one you copied from MangoApps.

2. Click Save changes to continue.

Step 3: Set Required Permissions in Atlassian

To allow MangoApps to access and read your Confluence content, you need to assign the appropriate scopes and permissions to the OAuth app.

1. Go to the Permissions tab in your Atlassian app settings.

2. Under User identity API, click Add to allow basic user profile access.

3. Under Confluence API, click Add, then click Configure.

1. On the next page, click Edit Scopes. Select the row “Write Confluence content”, then click Save.

1. Certain read permissions must be granted for your OAuth 2.0 app to connect to Confluence. Following the same instructions above, enable the permissions for the required scopes listed below.

Required Scopes:

• offline_access

• read:content:confluence

• read:content-details:confluence

• read:space-details:confluence

• read:audit-log:confluence

• read:page:confluence

• read:attachment:confluence

• read:blogpost:confluence

• read:custom-content:confluence

• read:comment:confluence

• read:template:confluence

• read:label:confluence

• read:watcher:confluence

• read:relation:confluence

• read:user:confluence

• read:configuration:confluence

• read:space:confluence

• read:space.property:confluence

• read:user.property:confluence

• read:space.setting:confluence

• read:analytics.content:confluence

• read:content.property:confluence

• read:content.metadata:confluence

• read:inlinetask:confluence

• read:task:confluence

• read:whiteboard:confluence

• read:app-data:confluence

• read:folder:confluence

• read:embed:confluence

1. Click Save once you have selected all required scopes.

Step 4: Retrieve Client ID and Secret

With the app and permissions in place, you'll now collect your credentials to link MangoApps with Atlassian.

1. Go to the Settings tab in the Atlassian app.

2. Scroll down to the Authentication details section.

3. Copy your Client ID and Client Secret for use in MangoApps.

Finalize Setup in MangoApps

Step 5: Return to MangoApps to complete the integration

Input the credentials and authorizing access.

1. In the knowledge base setup screen, enter the Client ID under Confluence App Key.

2. Enter the Client Secret under Confluence App Secret.

3. Click Give Access Consent.

4. A pop-up will appear. In the Use app on field, choose your Atlassian site.

5. Click Accept to authorize the connection.

Step 6. (Optional) Configure Regex Filters

If you want to control which content is included or excluded during crawling, you can define regex-based filters.

• Use exclusion patterns to skip files like those containing "private": Example: .*private.*\.pdf

• Use inclusion patterns to restrict crawling to specific types of content.

You can apply filters to:

• Space (space key)

• Page (title)

• Blog (title)

• Comment (by parent content)

• Attachment (filename)

Step 7. (Optional) Schedule Syncs

You can choose to keep your knowledge base up-to-date automatically by enabling scheduled syncing.

If disabled, the sync will run only once upon saving.

Step 8: Save and Connect

To finalize everything, save your setup so MangoApps can begin syncing with your Confluence site.

Click Save. MangoApps will now begin indexing content from the connected Confluence site and make it available to AI assistants.