# Knowledge Base: Confluence (Basic Authentication)
### **Overview**
MangoApps AI Studio allows you to connect external knowledge sources to enhance the intelligence and accuracy of your AI assistants. One such integration is with **Confluence**, Atlassian’s popular knowledge management platform. This guide walks you through how to configure Confluence (using Basic Authentication) as an external knowledge base so your AI assistants can access and utilize your organization’s existing documentation.
***
### What You Will Need
Before starting the setup, make sure you have the necessary credentials and tools available. This ensures a smooth configuration without interruptions.
To set up Confluence as a knowledge base, you’ll need the following:
* Your Atlassian login credentials
* A Confluence API token
***
### **Atlassian Setup**
#### **Step 1. Access Your Atlassian Account Settings**
To connect Confluence to MangoApps, you’ll first need to generate an API token from your Atlassian account.
Log in to your Atlassian account and go to **Account Settings > Security**.
Alternatively, go directly to your account security settings using this link: [Atlassian Account Security Settings](https://hub.mangoapps.com/mlink/file/NzY0NjUwMA==)
***
#### **Step 2. Generate a Confluence API Token**
The API token acts as a secure password that MangoApps uses to connect to your Confluence instance. You will need to generate this manually.
To do so, click the **Create Classic API token** button.
In the resulting pop-up menu, enter a name for your token and set an expiration date.
Click **Create** to generate your token.
***
#### **Step 3. Copy and Save Your API Token**
Once generated, the API token will **only be shown once**. You must copy and store it securely, as it will be used to authenticate the knowledge base integration.
Click **Copy** to securely save your new token.
{% hint style="danger" %}
**You will not be able to view the token again later.**
{% endhint %}
***
### **MangoApps Setup**
#### **Step 4. Add a New Knowledge Base in MangoApps**
With your token ready, you will now create a new external knowledge base inside MangoApps AI Studio.
To do this, navigate to **Admin Portal > Modules > AI Studio > External KBs > Create a Knowledge Base**
Select **Confluence** as your data source.
***
#### **Step 5. Enter Knowledge Base Details**
This step involves naming your knowledge base and specifying which part of your Confluence site should be connected. These details help organize and define the knowledge set your AI assistant will use.
Fill out the required fields:
* **Name**: Enter a meaningful name for the knowledge base.
* **Description**: Provide a short description for internal reference.
* **URL**: Enter the URL of the Confluence page or space you want to connect.
***
#### **Step 6. Configure Basic Authentication**
To allow MangoApps to access your Confluence content, you need to authenticate using your email address and the API token created earlier.
Under **Authentication Method**, select **Basic Authentication**, then add two rows for credentials:
| Key | Value |
| -------- | ----------------------------------- |
| username | Your Confluence login email address |
| password | Your API token from Step 3 |
***
#### **Step 7. (Optional) Apply Regex Filters**
If you only want specific types of documents included in the knowledge base, you can apply regular expression (regex) filters to narrow down what is crawled.
**How it Works:**
Regex filters allow inclusion or exclusion of content by matching patterns in document titles, file types, or metadata. If both inclusion and exclusion filters match a document, exclusion takes priority.
**Supported Content Types:**
* **Space**: Unique space key
* **Page**: Main page title
* **Blog**: Blog title
* **Comment**: Text from blog or page comments
* **Attachment**: File name + extension
**Example:**\
To exclude PDFs with "private" in the name: `.*private.*\.pdf`
***
#### **Step 8. (Optional) Set a Sync Schedule**
To keep your knowledge base updated automatically, you can configure a sync schedule.
* You can toggle **sync scheduling** on to keep your Confluence knowledge base updated automatically.
* If disabled, the knowledge base will sync only once at the time of saving.
***
#### **Step 9. Save and Activate**
Now that all settings and credentials are in place, save the configuration to begin the syncing process. This will establish a connection between your MangoApps AI Studio and the specified Confluence space or page.
Click **Save** to finalize the setup.
MangoApps will now begin connecting with your Confluence site and start syncing content based on your filters and authentication.
