Connect Confluence Data Center to Rovo

Centralize your team’s knowledge across Data Center and Cloud sites by integrating your Confluence Data Center pages and blog posts into Rovo.

What is indexed?

The Confluence DC connector indexes these objects:

• Pages

• Blog posts

• Comments

• Attachments

• Name

• URL

• Created date

• Last updated date

• Creator

• Contributor

• Document body

• Space

• Labels

• Reactions

• All parent pages

• Number of page views

Before you begin

• Rovo will always respect permissions. Users will only ever see content that they already have access to. More on connectors and permissions

• The Confluence Data Center connector is supported in Confluence 9.4 and above, as well as in 9.2.6 LTS and later.

• If you’ve enabled rate limiting, you may need to adjust your request limits to ensure content is seamlessly indexed in Rovo.

Overview

To connect Confluence Data Center to Rovo, complete the following steps:

1. Create an application tunnel or configure an allowlist - This step only applies to Confluence instances hosted on private networks. If your Confluence instance is available over the public internet, skip this step.

2. Create an incoming application link.

3. Set up the connector in Atlassian Admin.

4. Choose which spaces to include.

Step 1: Set up an application tunnel

If your Confluence Data Center instance is on a private network, you need to set up an application tunnel from your Cloud organization to your Confluence Data Center instance. You can also use an existing tunnel by adjusting its configuration. More on tunnels

Alternatively, if you prefer not to use tunnels, you can allowlist incoming connections or IPs for Atlassian Cloud products and sites in your Data Center instance. More on IP addresses and domains for Atlassian Cloud products

Create a new tunnel

1. Configure the required connections and upstream ports.

2. Go to Atlassian Administration. Select your organization if you have more than one.

3. Select Data management > Data sources > Application tunnels.

4. Select Create tunnel.

5. Go through the wizard to provide the details of your self-managed instance and generate the security key associated with your tunnel.

6. Add the key to your Confluence Data Center instance.

   1. To be redirected to your instance, select Copy and process.

   2. To give the key to the admin of the instance, select Copy, then Close. The key can be added manually in Administration > Application tunnel, by selecting Add security key.

7. Paste your security key and follow the steps in the wizard.

Your tunnel is created. Wait until the status is Connected.

Use an existing tunnel

To use an existing tunnel, modify the HTTP connector:

1. In your installation directory, edit the conf/server.xml file.

2. Update the connector to include the attribute: secure="true".

More on required connections and upstream ports

Step 2: Create an incoming application link

Create an application link in the administration of your Confluence Data Center instance to use in the connection process. About creating application links

1. In Confluence Data Center, go to Administration > Application Links.

2. Select Create link.

3. Choose External application > Incoming.

4. Select Continue.

5. Enter a name for your application link

6. Insert https://id.atlassian.com/outboundAuth/finish as the redirect URL.

7. For application permissions, select Manage Subscriptions.

8. Select Save.

9. In the application links table, under Actions, select More actions (•••) > View credentials.

10. Make note of the Client ID and Client secret - you’ll need them when setting up the connector in Atlassian Admin.

Step 3: Set up the connector in Atlassian Admin

Access the setup screen for the Confluence Data Center connector in Atlassian Admin:

1. Go to admin.atlassian.com. Select your organization if you have more than one.

2. Select Apps > AI settings > Rovo.

3. Under Sites, next to the site you want to connect, select Add connector.

4. Select Confluence Data Center and press Next.

Configure Confluence Data Center:

1. Enter a name for your Confluence Data Center connection.

2. Select your Data Center network type:

   1. Private network if your network is behind a firewall and can’t be accessed over the public internet. Select the application tunnel you previously set up.

   2. Public network if your Confluence Data Center instance can be accessed over the public internet or you’ve allowlisted incoming connections or IPs instead of using tunnels. Insert the server base URL (including context path if applicable) of your Confluence Data Center instance.

3. Enter the OAuth Client ID and Client secret.

4. Review the disclaimer.

5. Select Next.

Step 4: Choose data to include

You can choose which spaces you want to index. All spaces are selected by default. You can also choose whether new spaces created in the future are included or not.

Before you start, it’s important to note:

• The connector will only start indexing the content of included spaces once you’ve saved your selection of data to include. Before then, the connector will only index the list of all spaces including space names, space keys and space icons.

• Blocking individual pages is not supported.

Once you’ve set up your connector, you can manage the indexed content:

1. Go to admin.atlassian.com. Select your organization if you have more than one.

2. Select Settings > Rovo.

3. Under Sites, next to Confluence Data Center, select More actions () and select Manage content.

Next steps

After you’ve finished connecting Confluence Data Center, your team members will see Confluence Data Center show up as a filter option in Search. They will be asked to connect before they can see results. This is required so Rovo can make sure your teammates only see results they have access to.