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.
Navigate to Admin Portal > Modules > AI Studio > External KBs > Create a Knowledge Base.
Select Confluence as the data source type.
Add a name, description, and enter the URL of the Confluence page or space you want to connect.
Under Authentication Method, select OAuth 2.0 Authentication.
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.
Click Create > OAuth 2.0 integration.
Name your app, agree to the terms, and click Create.
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).
When asked for a Callback URL, paste the one you copied from MangoApps.
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.
Go to the Permissions tab in your Atlassian app settings.
Under User identity API, click Add to allow basic user profile access.
Under Confluence API, click Add, then click Configure.
On the next page, click Edit Scopes. Select the row “Write Confluence content”, then click Save.
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_accessread:content:confluenceread:content-details:confluenceread:space-details:confluenceread:audit-log:confluenceread:page:confluenceread:attachment:confluenceread:blogpost:confluenceread:custom-content:confluenceread:comment:confluenceread:template:confluenceread:label:confluenceread:watcher:confluenceread:relation:confluenceread:user:confluenceread:configuration:confluenceread:space:confluenceread:space.property:confluenceread:user.property:confluenceread:space.setting:confluenceread:analytics.content:confluenceread:content.property:confluenceread:content.metadata:confluenceread:inlinetask:confluenceread:task:confluenceread:whiteboard:confluenceread:app-data:confluenceread:folder:confluenceread:embed:confluence
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.
Go to the Settings tab in the Atlassian app.
Scroll down to the Authentication details section.
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.
In the knowledge base setup screen, enter the Client ID under Confluence App Key.
Enter the Client Secret under Confluence App Secret.
Click Give Access Consent.
A pop-up will appear. In the Use app on field, choose your Atlassian site.
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.*\.pdfUse 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)
If both an inclusion and exclusion filter apply, the exclusion takes precedence.
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.
Last updated
