This page describes how to create a data store and connect Confluence Data Center to Gemini Enterprise.

## Before you begin

> [!NOTE]
> **Note:** To enforce data source access control and secure data in Google Gemini Enterprise, ensure that you have [configured your identity provider](https://docs.cloud.google.com/gemini/enterprise/docs/configure-identity-provider.md.txt).

Before you set up your connection, do the following:

1.
   Grant the Discovery Engine Editor role (`roles/discoveryengine.editor`). This role is required for the user to create the data store. To grant this role, do the following:

   1. In the Google Cloud console, go to the **IAM** page.

      [Go to IAM](https://console.cloud.google.com/iam-admin/iam)
   2. Locate the user account and click edit **Edit**.
   3. Grant the `Discovery Engine Editor` role to the user. For more information, see [IAM roles and permissions](https://cloud.google.com/gemini/enterprise/docs/access-control).

   <br />

2. Complete the steps in [Set up authentication and obtain client credentials](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/confluence-dc/confluence-datacenter-configuration.md.txt#create-oauth-app-link) to get the client ID and client secret and [set up OAuth scopes](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/confluence-dc/confluence-datacenter-configuration.md.txt#create-oauth-app-link).

3. If your Confluence Data Center instance uses a private IP, [publish a Private Service Connect producer service](https://cloud.google.com/vpc/docs/configure-private-service-connect-producer). For more information about using
   Private Service Connect to connect Gemini Enterprise to
   self-hosted data sources, see
   [Introduction to self-hosted data sources](https://docs.cloud.google.com/gemini/enterprise/docs/introduction-to-self-hosted).

If you are using the data ingestion connection mode, you must meet these additional requirements:

1. Verify that you have the [Confluence Administrator permission](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/confluence-dc/confluence-datacenter-configuration.md.txt#create-conf-user) to fetch the Access Control List (ACL) information.

2. [Install the Permission Accessor for Confluence Data Center plugin](https://marketplace.atlassian.com/apps/1237929/permission-accessor-for-confluence-data-center?hosting=datacenter&tab=installation).
   This plugin provides REST endpoints to Gemini Enterprise. These endpoints
   enable Gemini Enterprise 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
   Gemini Enterprise search experience.

## Create the Confluence Data Center data store

To create the Confluence Data Center data store, perform the following steps:

1. In the Google Cloud console, go to the Gemini Enterprise page.

   [Gemini Enterprise](https://console.cloud.google.com/gemini-enterprise/)
2. Select or [create](https://cloud.google.com/resource-manager/docs/creating-managing-projects) a Google Cloud project.

3. In the navigation menu, click **Data stores**.

4. Click **Create data store**.

5. In the **Source** section, search for **Confluence Data Center** , and click **Select**.

6. In the **Data** section:

   1. In the **Connector mode** section, select **Data ingestion** or **Federated search**.

      > [!NOTE]
      > **Note:** **Data ingestion** is in Private Preview. You need to be on the allowlist to use the data ingestion data store. To be added to the allowlist, contact your [account team](https://cloud.google.com/tam) or the [sales team](https://cloud.google.com/contact).

   2. Click **Continue**.

   3. In the **Authentication settings** section, configure authentication based on your chosen connection mode.

      1. Provide the authentication details:

         - For **Federated search**, provide the following details:

           - **Instance URI:** The base URL of your Confluence Data Center instance, for example, `https://your-confluence-instance.com`.
           - **Client ID:** The unique identifier for the OAuth application registered with Confluence Data Center.
           - **Client secret:** The Secret Manager secret that contains the client secret for authenticating requests.

           To learn how to obtain these credentials, see [Set up authentication and obtain client credentials](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/confluence-dc/confluence-datacenter-configuration.md.txt#create-oauth-app-link).
         - For **Data ingestion** , choose between **Username** and **Password** credentials, **Personal access token** , or **API token**, and enter the authentication details accordingly.

      2. Click **Continue**.

   4. From the **Destination type** list, select **Public** or **Private**.

      - If you selected the **Public** destination type, for **Domain URL**, enter your public URL.
      - If you selected the **Private** destination type, enter the following information:

        1. **Service attachment** : Enter your Private Service Connect service attachment. To obtain this, you need to [publish a Private Service Connect producer service](https://cloud.google.com/vpc/docs/configure-private-service-connect-producer) for your Confluence Data Center instance.
        2. If the region of your Private Service Connect service attachment is different from the region of your data store, select the **Enable PSC Global Access** checkbox.
        3. For an instance with a Domain URL:
           - Optional: **Base domain name** : Enter your base domain. Specify a unique and granular base domain name (for example, `confluence.example.com`) rather than a shared root domain (for example, `example.com`). If you have multiple data connectors in the same project, such as both Jira Data Center and Confluence Data Center, ensure each uses its own full instance domain as the base domain to avoid network collisions. Two data connectors using Private Connectivity with the same base domain name cannot be created in the same project.
           - **Domain url**: Enter your domain URL. This must match the instance URI.
           - Optional: **Destination port**: Enter your destination port.
        4. For an instance without a Domain URL:
           - **Destination port**: Enter your destination port.

        > [!NOTE]
        > **Note:** Private connectivity is required when connecting to private, on-premises authentication endpoints.

   5. Click **Continue**.

   6. Optional: Click **Advanced options**.

      - If you selected **Federated search**, do the following:

        - If you enable the **SSL settings** checkbox, select a **Trust Model** from **Private** , **Public** , or **Insecure** , and then configure the required fields. For more information on trust models, see [Trust models](https://cloud.google.com/certificate-authority-service/docs/trust-model).

          - **Public**: Use this option if your Confluence Data Center instance uses certificates issued by a publicly trusted CA.
          - **Private**: Use this option if your Confluence Data Center instance uses certificates signed by a private or internal CA.
          - **Insecure**: This option bypasses certificate validation. It is not recommended for production environments as it can expose your connection to security risks.

          The following fields are common to all Trust Models:
          - **Keystore Client Certificate** : The client certificate in PEM format. For example, `---BEGIN CERTIFICATE---\n...\n---END CERTIFICATE---`.
          - **Keystore Client Private Key**: The private key for the client certificate in PEM format.
          - **Keystore Client Private Key Passphrase**: The passphrase for the client private key, if applicable.

          The following additional information is required for the **Private** Trust Model:
          - **Private Certificate**: The public certificate of the private CA in PEM format.
      - If you selected **Data ingestion**, do the following:

        1. Select the **Enable Static IP Addresses** checkbox. After creating the connector, you must allowlist registered static IPs for sync runs to succeed. For more information, see [Configure static IP egress](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/configure-static-ip-egress.md.txt).
        2. In the **Max QPS** field, specify the maximum number of queries sent to the Confluence Data Center data store per second.
        3. Select the **Enable Custom Fields** checkbox. If enabled, the connector fetches custom fields from the Confluence Data Center.
        4. If required, select the **Proxy settings** and **SSL settings** checkboxes to enable them.
   7. Click **Continue**.

   8. In the **Entities to search** (if you selected **Federated search** ) or **Entities to sync** (if you selected **Data ingestion**) section:

      1. Select all the required entities.
      2. If you selected **Federated search**, proceed to the next step.
      3. If you selected **Data ingestion** , continue with the following steps:
         1. **Optional:** To sync specific projects, do the following:
            1. Click **Filter**.
            2. To filter entities out of the index, select the **Exclude from the index** checkbox, or to ensure that they are included in the index, select the **Include in the index** checkbox.
            3. Enter the keys. Press **Enter** after each key.
            4. Click **Save**.
         2. To configure the sync schedule, do the following:
            1. In the **Sync frequency** list, select a sync frequency.
               - To schedule separate full syncs of entity and identity data, expand the menu in the **Full sync** section and then select **Custom options**.
            2. In the **Incremental sync frequency** list, select an incremental sync frequency. For more information, see [Sync schedules](https://cloud.google.com/gemini/enterprise/docs/introduction-to-connectors-and-data-stores#sync-schedules).
7. Click **Continue**.

8. If you selected **Federated search** , in the **Actions** section, for **Select Confluence Data Center actions to enable**, choose the actions from the category to enable for the data store.

   > [!NOTE]
   > **Note:** If you skip adding actions in this step, you can add them later. For more information, see [Add actions](https://docs.cloud.google.com/gemini/enterprise/docs/manage-actions#add-actions).

   To manage the list of actions, see [Manage actions](https://docs.cloud.google.com/gemini/enterprise/docs/manage-actions).
9. Click **Continue**.

10.
    In the **Configuration** section:

    1. From the **Multi-region** list, select the location for your data connector.
    2. In the **Your data connector name** field, enter a name for your connector.
    3. If you selected `us` or `eu` as the location, configure the **Encryption settings** :
       - Optional: If you haven't configured single-region keys, click **Go to settings page** to do so. For more information, see [Register a single-region key for third-party connectors](https://docs.cloud.google.com/gemini/enterprise/docs/cmek.md.txt#third-party-connectors-key-registration).
       - Select **Google-managed encryption key** or **Cloud KMS key**.
       - If you selected **Cloud KMS key** :
         - In the **Key management type** list, select the appropriate type.
         - In the **Cloud KMS key** list, select the key.

       For more information, see [Customer-managed encryption keys](https://docs.cloud.google.com/gemini/enterprise/docs/cmek.md.txt).

    <br />

11. Click **Continue**.

12.
    In the **Billing** section, select **General pricing** or **Configurable pricing** . For more information, see [Verify the billing status of your projects](https://cloud.google.com/billing/docs/how-to/verify-billing-enabled) and [Licenses](https://docs.cloud.google.com/gemini/enterprise/docs/licenses.md.txt).

13. Click **Continue**.

14. Click **Create** . Gemini Enterprise creates your data store and displays your data stores on the **Data stores** page.

15. If you selected the **Private** destination type and [configured your
    Private Service Connect producer service](https://cloud.google.com/vpc/docs/configure-private-service-connect-producer) to
    **Accept connections for selected projects** (explicit approval), do the
    following:

    1. In the Google Cloud console, search for `Private Service Connect` and go to the
       **Private Service Connect** page.

    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
       Gemini Enterprise tenant project for the data store, and then click
       **Accept project**.

    > [!NOTE]
    > **Note:** The Gemini Enterprise tenant project ID ends in `-tp`.

    The data store status remains as **Creating** in the **Data Stores** page until you click **Accept project**
    on the service details page within Private Service Connect. After you click **Accept project** , the data store status changes to **Active**.

To verify the state of the data store, do the following in the **Data stores** page:

1. Navigate to the newly created data store in the data store list and monitor its state until it changes to **Active**.
2. When the data store state changes from **Creating** to **Active**, the Confluence Data Center connector is ready to be used.

After creating the data store:

- [Create an app](https://docs.cloud.google.com/gemini/enterprise/docs/create-app.md.txt).
- [Connect it to the Confluence Data Center data store](https://docs.cloud.google.com/gemini/enterprise/docs/connect-existing-data-store).
- [Authorize](https://docs.cloud.google.com/gemini/enterprise/docs/create-app.md.txt#user-authorization) Gemini Enterprise to Confluence Data Center before executing any queries.

For information on permissions required to perform search, see
[Required scopes](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/confluence-dc.md.txt#set-up-permissions).


## Data handling and query execution

This section describes how Gemini Enterprise manages your query and the privacy implications of using the federated data store.

### Query execution

After you authorize Confluence Data Center and send a search query to Gemini Enterprise:

- Gemini Enterprise sends your search query directly to the Confluence Data Center API.
- Gemini Enterprise blends the results with those from other connected data sources and displays a comprehensive search result.

### Data handling

When using third-party federated search, the following data handling rules apply:

- Your query string is sent to the third-party search backend (Confluence Data Center API).
- These third parties may associate queries with your identity.
- If multiple federated search data sources are enabled, the query might be sent to all of them.
- After the data reaches the third-party system, it is governed by that system's terms of service and privacy policies.

> [!NOTE]
> **Note:** To improve accuracy, an LLM may rewrite your query before it is sent to Confluence Data Center. This rewritten query can incorporate information from your session's query history. As a result, parts of your query history might also be included in the query sent to the Confluence Data Center API.

<br />

## What's next

- To provide a user interface for querying your Confluence Data Center data, [create an app](https://docs.cloud.google.com/gemini/enterprise/docs/create-app.md.txt) and [connect it to the Confluence Data Center data store](https://docs.cloud.google.com/gemini/enterprise/docs/connect-existing-data-store).
- To preview how your search results appear after your app is set up, see [Get search results](https://docs.cloud.google.com/gemini/enterprise/docs/preview-search-results.md.txt).
- To enable alerts for the data store, see [Configure alerts for third-party data stores](https://docs.cloud.google.com/gemini/enterprise/docs/configure-periodic-data-alerts).