# Connect Confluence

Sign in to Confluence from the Add Knowledge Source wizard, limit the sync to chosen spaces if you want, and start its first sync.

The Confluence connector indexes wiki pages from a Confluence site you sign in to, so agents can answer from them. This page covers what is specific to Confluence; the steps every connector shares are in [Add a knowledge source](/knowledge/knowledge-bases/add-a-knowledge-source).

**Who can use it:** the **Builder** role, or a Member holding the **Knowledge Admin** grant, in a tenant licensed for knowledge. One-click sign-in also needs an administrator to have stored a Confluence OAuth app on the **Credentials** tab of Knowledge Management.

## What it brings in

In the wizard, Confluence sits in the **Recommended** row and under the **Knowledge Base** chip, described as **Wiki pages & spaces**. The Catalog's **Connectors** section lists it with the same description and says how it signs in. The connector can read only what the Confluence account you sign in with can open. Who may use the source inside Katonic is a separate choice, made on the **Schedule & Access** step.

## Prerequisites

- An embedding model configured on the **Settings** tab of Knowledge Management. Until then **Connect Source** is disabled.
- A Confluence account that can open the spaces you want indexed.
- Either a Confluence OAuth app stored by your administrator, which gives one-click sign-in (see [Set up connector credentials](/knowledge/knowledge-bases/credentials)), or your own OAuth app's Client ID and Client Secret.
- Pop-ups allowed for the Katonic site: the sign-in opens in a pop-up window.

## Connect the source

  
**Step 1. Pick Confluence**

In the Control Room, open **Knowledge** and select **Connect Source**. On **Select Source**, choose **Confluence** in the **Recommended** row, or filter by **Knowledge Base** and select its card; the wizard moves to **Configure**. From the Catalog's **Connectors** section, **Connect** on the Confluence card opens **Connect Source** with Confluence already chosen.

  
**Step 2. Name the source and pick its resources**

Enter a **Knowledge Name**. Under **Resources**, keep the preselected option or pick another: each one says what kind of documents it is meant for.

  
**Step 3. Sign in to Confluence**

![Step 2 of the Add Knowledge Source wizard, Configure, for Confluence: the Client ID and Client Secret fields, the Connect to Confluence box inviting you to sign in with Confluence, its Connect with Confluence button and the note that it opens a secure popup, above the Back, Cancel and Next buttons.](https://docs.katonic.ai/img/knowledge/connectors/confluence/connector-confluence-configure.png)
*Configure for Confluence when no OAuth app is stored for the tenant: the step asks for your own Client ID and Client Secret, then Connect with Confluence opens the sign-in pop-up. Space Keys appears once the connection succeeds, and Next stays disabled until then.*
    If your administrator has stored a Confluence OAuth app, the **Connect to Confluence** box reads **Click below to sign in with Confluence - credentials are pre-configured by your admin** and you go straight to the button. Otherwise the step asks for a **Client ID** and a **Client Secret** first, and the box reads **Sign in with Confluence to securely connect your account**. **Connect with Confluence** opens a secure pop-up where you sign in to Atlassian and grant access; the button reads **Connecting…** while the wizard waits. On success the box changes to **Connected to Confluence** with **OAuth authorization successful**, a notice confirms it, and **Disconnect** lets you start again. The sign-in identifies the site: the wizard never asks for a site address, an API token or an email. **Next** stays disabled until the source is named and connected.

  
**Step 4. Limit the sync to chosen spaces**

After the connection, **Space Keys (comma-separated)** appears. Enter the keys of the spaces to index, separated by commas, or leave the field empty to index every space the account can open. A connector may also add settings of its own to this step.

  
**Step 5. Schedule, access and review**

Select **Next**. **Schedule & Access** is the same for every connector: **Sync Schedule**, **Knowledge plane** and **Access**. Confluence has no permission sync; the **Access** choice decides who inside Katonic can open the source and does not change what the connector reads. Select **Review**. The summary lists **Source**, **Name**, **Authentication** as **OAuth (connected)**, **Schedule**, **Graph Extraction**, **Access** and **ACL Sync** as **None (open access)**. Select **Connect Source**: it reads **Creating...** while the source is created, and the first sync starts straight away.

## Verify

The new row appears on the **Sources** tab as **Syncing**, then **Synced** with a document count when the first sync finishes. Open the source: its **Documents** tab lists the indexed pages, and the **Runs** tab shows the first run. Because Confluence permissions are not carried over, check on the **Access** tab that the right people, and only they, can open the source. See [Control who can use a knowledge source](/knowledge/knowledge-bases/access).

## Troubleshooting

- **Client ID and Client Secret are required.** You selected **Connect with Confluence** without filling both fields. Fill them, or ask your administrator to store the app on the **Credentials** tab so the fields disappear.
- **Popup blocked. Please allow popups for this site.** Allow pop-ups for the Katonic site in your browser, then select **Connect with Confluence** again.
- **OAuth didn't complete - the popup may have been closed. Try again.** The wizard waits about two minutes for the sign-in to finish. Keep the pop-up open until it closes by itself, then retry.
- **OAuth connection failed. Please try again.**, or a reason from the provider: the sign-in could not start, or Atlassian rejected it. Check the Client ID and Client Secret, or ask your administrator to run **Test** on the stored credential.
- **Next stays disabled.** The source needs a **Knowledge Name** and a completed connection.
- **Source created, but the first sync couldn't start - open it and click Reindex.** The source exists but nothing is indexed yet. Open it and select **Reindex**.
- **Pages you expected are missing.** The connector reads what the signed-in account can open, within the spaces you listed. Check the space keys, or sign in with an account that has access, then reindex.

## Related

- [Connectors](/knowledge/connectors/overview)
- [Set up connector credentials](/knowledge/knowledge-bases/credentials)
- [Add a knowledge source](/knowledge/knowledge-bases/add-a-knowledge-source)
- [Control who can use a knowledge source](/knowledge/knowledge-bases/access)

Source: https://docs.katonic.ai/knowledge/connectors/confluence
