Connect Jira Data Center On-premises

This page describes how to connect Jira Data Center to Agentspace, syncing on-premises Jira data with 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 Jira System administrators permission to fetch the Access Control List (ACL) information.

  2. If you have set up issue-level security in Jira, install the Permission Accessor for Jira 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 Jira 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 Jira Data Center user and set up permissions

To enable Agentspace to obtain data from Jira, you need to create a new user and assign administrator permission to the user.

  1. Sign in as an administrator:

    1. Go to your Atlassian domain site and open Jira 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 with administrator privileges 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 Jira administration page, navigate to the Users and security tab and click Groups.
    2. Search for the jira-administrators group and add the newly created user to this group.

Create a Jira Data Center on-premises connector

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 Jira 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.

    • 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. 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 instance with the Domain URL: - Service attachment: Enter your Private Service Connect service attachment. - Optional: Base domain name: Enter your base domain. - Domain URL: Enter your domain URL. - Optional: Destination port: Enter your destination port.

      1. For 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 a synchronization frequency.

  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 Jira 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