Connect Confluence Cloud

This page describes how to connect Confluence Cloud to Agentspace Enterprise.

After you set up your data source and import data the first time, the data store syncs data from that source at a frequency that you select during setup.

Before you begin

Before setting up your connection:

  1. Verify that you have administrator access to the Confluence instance and project.

  2. Set up access control for your data source. For information about setting up access control, see Use data source access control.

Set up authentication and permissions in Confluence

Make sure that you have the necessary authentication details and administrator access to your Confluence instance. Use the following instructions to create a client ID and client secret through the Atlassian Developer Console, configure the required OAuth 2.0 scopes, set up permissions for users, retrieve your instance URL and ID, configure roles, and authenticate to sync data between Confluence Cloud and Agentspace Enterprise . To enable OAuth 2.0 and obtain the client ID and secret, see OAuth 2.0 (3LO) apps in the Atlassian Developer documentation.

  1. Create an OAuth 2.0 integration in the Atlassian Developer Console:

    1. Sign in to Atlassian Developer Console.

    2. Click the profile icon and select Developer console.

      select
      Select Developer console

    3. Click Create and select OAuth 2.0 Integration.

      select-integration
      Select OAuth 2.0 Integration

    4. Enter a name for the app and do the following:

      1. Check the terms and conditions checkbox.

      2. Click Create.

        click-create
        Create a new OAuth 2.0 Integration

      3. Click Authorization.

      4. In the Authorization type table, select Add for OAuth 2.0 (3LO).

        select-add
        Add authorization type

    5. In the Callback URL field, enter https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html.

    6. Click Save changes.

      click-save-changes
      Save changes

    If you see the warning: Your app doesn't have any APIs. Add APIs to your app, proceed to step 2 under the next section and complete all the remaining steps. Otherwise, skip ahead to step 4 in that same section.

To configure OAuth 2.0 and retrieve the required credentials for your Confluence connector setup, do the following:

  1. Enable OAuth 2.0:

    1. Click Permissions.

      select-permissions
      Select permissions

    2. Go to Confluence API.

    3. Click Add.

    4. Click Configure.

    5. Go to the Granular scopes tab and click Edit scopes.

      confluence-select-granular-permissions-edit-scopes
      Edit scopes

    6. Select the following scopes.

    7. Confirm that seven scopes are selected and save your changes.

  2. Obtain the client ID and client secret:

    1. Click Distribution.

    2. Select Edit.

      select-distribution-edit
      Edit distribution

    3. Select Sharing to enable editing other fields.

    4. Fill out the remaining fields. Make sure to set Vendor to Google and Privacy policy to policies.google.com.

    5. Select Yes when you see `Does your app store personal data?.

    6. Select Settings to copy your Client ID and Client secret.

      select-settings-copy-auth
      Copy your client ID and client secret

  3. Obtain the instance URL:

    1. Go to atlassian.net and sign in with your administrator account.
    2. Select the app you want to sync. For example, sync the first app.
    3. Find the instance URL. It appears as the subdomain in the address bar.

  4. Obtain the instance ID:

    1. Open a new tab, copy the instance URL, and append /_edge/tenant_info to the instance URL. For example, https://<var>YOUR-INSTANCE</var>.atlassian.net/_edge/tenant_info.

    2. Navigate to the link to find the cloudId value. The cloudId is your instance ID.

      instance-identifier
      Obtain instance ID

Set up permissions and roles

To set the user visibility, do the following:

  1. Click the user profile icon and go to Manage account.

    manage-account
    Manage account

  2. Navigate to the Profile and visibility.

    profile-and-visibility
    Profile and visibility

  3. Go to Contact and set the Who can see this as Anyone.

    contact
    Contact

To grant Confluence administrator with Discovery Engine Editor role in the Google Cloud console, do the following:

  1. In the Google Cloud console, go to the Agentspace page.
  2. Navigate to IAM.
  3. Locate the Confluence administrator account.
  4. Grant the Discovery Engine Editor role to the administrator.

To grant a user with an administrator role in Atlassian, do the following:

  1. Sign in to Atlassian using an administrator account.

  2. Click the menu icon and select your organization. Alternatively, you can go to admin.atlassian.com.

  3. On the Admin page, click the product and select the Manage users button.

    manage-users
    Manage users

  4. Click Groups under User management.

  5. On the Groups page:

    1. Click Create group.
    2. Enter a name for the group.

    create-group
    Create group

This group receives permissions required by the connector. Users added to this group inherit these permissions.The connector uses this group to authenticate and fetch documents.

  1. On the group page, click Add product.

    1. Select User access admin as the product role.

    2. Click Add.

      confluence-user-access-admin
      Confluence user access administrator

  2. Click Add group members to add the user account or group members that the connector uses to authenticate.

    add-group-members
    Add group members

Create a Confluence Cloud connector

Console

To use the Google Cloud console to sync data from Confluence Cloud to Agentspace Enterprise , follow these steps:

  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 to connect your third-party source.

  5. Enter your authentication information and click Authenticate.

  6. A new window appears. Enter the instance username and password. Check that the authentication succeeded before returning to the Specify the Confluence source for your data store page.

    auth-details
    Enter the authentication details

  7. Select which entities to sync and click Continue.

    entities-to-sync
    Select entities to sync

  8. Select a region for your data connector.

  9. Enter a name for your data connector.

  10. Select a synchronization frequency.

  11. Click Create. Agentspace Enterprise creates your data store and displays your data stores on the Data Stores page.

  12. To check the status of your ingestion, go to the Data stores page and click your data store name to see details about it on its Data page. The Connector state changes from Creating to Running when it starts synchronizing data. When ingestion is complete, the state changes to Active to indicate that the connection to your data source is set up and awaiting the next scheduled synchronization.

    Depending on the size of your data, ingestion can take minutes or hours.

Next steps