Connect Confluence Data Center

This page describes how to create a Confluence Data Center data store and search app in Agentspace.

After you set up your data source and import data the first time, you can choose how often the data store syncs with that source.

Before you begin

Before setting up your connection, do the following:

  1. Verify that you have the Confluence Administrator permission to fetch the Access Control List (ACL) information.

  2. Install the Permission Accessor for Confluence Data Center plugin. This plugin provides REST endpoints to Google Agentspace. These endpoints enable Google Agentspace to retrieve space permission details, content restrictions, and email addresses of licensed users. This information is then used to ensure that the correct permissions are applied within the Google Agentspace search experience.

  3. Publish a Private Service Connect producer service for your Confluence Data Center instance. For more information about using Private Service Connect to connect Agentspace to self-hosted data sources, see Introduction to self-hosted data sources.

Create a Confluence Data Center user and set up permissions

To enable Agentspace to obtain data from Confluence, you need to create a new user and assign administrator permission to the user. This is because only Confluence administrators can view and manage permissions across all spaces.

  1. Sign in as an administrator:

    1. Go to your Atlassian domain site and open the Confluence Data Center instance.
    2. Enter the administrator username and password.
    3. Click Log In.

  2. Create a new user:

    When creating a data store, you must create a user to obtain data from the third-party instance.

    1. Click the settings icon.
    2. Select User management.
    3. Enter the administrator credentials, if prompted.
    4. In the Administration page, click Create user.
    5. Enter the email address, full name, username, and password.
    6. Click Create user.

  3. Configure user permissions:

    1. In the Confluence administration page, navigate to the Users and security tab and click Groups.
    2. Search for the confluence-administrators group and add the newly created user to this group.

Create a Confluence Data Center data store

Console

  1. In the Google Cloud console, go to the Agentspace page.

    Agentspace

  2. In the navigation menu, click Data Stores.

  3. Click Create Data Store.

  4. On the Select a data source page, scroll or search for Confluence data center to connect your third-party source.

  5. Enter your authentication information and click Continue.

  6. From the Destination type drop-down list, select Public or Private.

    1. If you selected the Public destination type, for Domain URL, enter your public URL.

    2. If you selected the Private destination type, enter the following information:

      1. If the region of your Private Service Connect service attachment is different from the region of your data store, select Enable PSC Global Access.

      2. For an instance with Domain URL:

        • Service attachment: Enter your Private Service Connectservice attachment.
        • Optional: Base domain name: Enter your base domain.
        • Domain URL: Enter your domain URL.
        • Optional: Destination port: Enter your destination port.

      3. For an instance without Domain URL:

        • Service attachment: Enter your Private Service Connect service attachment.
        • Optional: Destination port: Enter your destination port.

  7. Click Continue.

  8. Optional: Advanced options: Select and enable Proxy settings and SSL settings, if required.

  9. Under the Entities to sync, select all the required entities to sync and click Continue.

  10. Select the Sync frequency for Full sync and the Incremental sync frequency for Incremental data sync. For more information, see Sync schedules.

    If you want to schedule separate full syncs of entity and identity data, expand the menu under Full sync and then select Custom options.

    Custom options for full data sync.
    Setting separate schedules for full entity sync and full identity sync.

  11. Select a region for your data store and enter a name for your data store.

  12. Click Create.

  13. If you selected the Private destination type and configured your Private Service Connect producer service to Accept connections for selected projects (explicit approval), do the following:

    1. In the Google Cloud console, go to Network Services > Private Service Connect.

    2. Click the Published services tab.

    3. Click the name of the Private Service Connect service corresponding to your Confluence Data Center data store.

    4. In the Connected projects section, select the checkbox next to the Agentspace tenant project for the data store, and then click Accept project. The Agentspace tenant project ID ends in -tp.

    The data store status remains as Creating until you accept the connection request in the Private Service Connect settings. After you accept the connection request, the data store status changes to Active during the next sync run.

To verify the state of the data store and the ingestion activity, do the following:

  1. Navigate to the connector in the data store list and monitor its state until it changes to Active.

  2. After the connector state changes to Active, click the required entity and confirm that all selected entities are ingested. The data store state transitions from Creating to Running when synchronization begins and changes to Active once ingestion completes, indicating that the data store is set up. Depending on the size of your data, ingestion can take several hours.

Next steps