Jira Data Center configuration

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 managementfrom the list.
   2. Enter the administrator credentials, if prompted.
   3. In the Administrationpage, 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 Groupsfrom the navigation menu.
   2. Search for the jira-administrators group and open it.
   3. Click Add/Remove Usersand 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 Administrationfrom Applications.
3. In the navigation menu, click Application linksfrom Integrations.
4. On the Application linkspage, click Create link.
5. In the Create linkmodal, 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 the READ or WRITE scope for the OAuth App, based on your connection mode:

   Connection mode	Scope	Purpose
   Data ingestion	Read	Required to ingest Jira Data Center projects, comments, issues, attachments, and worklogs.
   Federated search and actions	Write	Required to perform search and actions like creating issues, updating issues, updating comments, and uploading attachments.

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