Jira Data Center configuration

Private preview: Creating and using a data store using 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 or the sales team.

Public preview: The federated search is in public preview. This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

To successfully connect Gemini Enterprise to your Jira Data Center instance, complete the following configuration steps.

Create a user and grant administrator access

To create a new user and add the user to the administrator group, do the following:

1. Sign in to your Jira Data Center instance at the base URL with administrator credentials. The base URL is typically in the format https://jira.yourcompany.com.
2. To create a new user, follow these steps:
   1. Click the settings icon settings and select User management from the list.
   2. Enter the administrator credentials, if prompted.
   3. In the Administration page, click Create user.
   4. Enter the email address, full name, username, and password.
   5. Click Create user.
3. To add the newly created user to the administrators group, follow these steps:
   1. Click Groups from the navigation menu.
   2. Search for the jira-administrators group and open it.
   3. Click Add/Remove Users and add the newly created user to this group.

Set up OAuth 2.0 authentication and add permissions

To set up an incoming external application link using OAuth 2.0 in Jira Data Center and obtain the client ID and client secret, complete the following steps. You must have administrator privilege or the help of a Jira Data Center administrator to complete this step.

1. Sign in to your Jira Data Center instance at the base URL with administrator credentials. The base URL is typically in the format https://jira.yourcompany.com.
2. Click the settings icon and select Jira Administration from Applications.
3. In the navigation menu, click Application links from Integrations.
4. On the Application links page, click Create link.
5. In the Create link modal, configure the following:
   • Application type: Select External application.
   • Direction: Select Incoming.
   • Click Continue.

6. Configure the OAuth 2.0 details:

   • Name: Enter a descriptive name for the application link.

   • Redirect URL: Enter the following redirect URI:

     • https://vertexaisearch.cloud.google.com/oauth-redirect

   • Application permissions: Select Read or Write based on your specific connection mode:

     Connection mode	Permissions	Purpose
     Data ingestion	Read	Required to ingest Jira Data Center projects, comments, issues, attachments, and worklogs.
     Federated search	Read	Required to search Jira Data Center projects, comments, issues, attachments, and worklogs.

7. Click Continue. The client ID and client secret are automatically generated and displayed.

   • Client ID (Consumer Key): Copy the unique ID provided.
   • Client Secret (Shared Secret): Copy the client secret and store it securely, for example, in a password manager. The secret is displayed only once. If lost, you must create a new application link to generate new credentials.

8. Click Save. The newly created application link will appear in the list on the Application links page.