Onboard Jira to DevOps Change Velocity — Service Catalog
- UpdatedJan 30, 2025
- 3 minutes to read
- Yokohama
- DevOps
Create, connect, discover, and configure your Jira Server or Jira Cloud instance using the ServiceNow Service Catalog.
Before you begin
Role required: sn_devops.admin or sn_devops.tool_owner
Procedure
-
Navigate to All > Service Catalog > Catalog Definitions > Maintain Items and search for DevOps.
Note: You can also access the service catalog from the Employee Center or Service portal.
- From the DevOps catalog items, select and activate DevOps App Onboarding and DevOps Tool Onboarding.
- After activating, select DevOps Tool Onboarding and select Try it.
-
In the DevOps Tool Onboarding form, enter the tool details:
Jira Server - In the Tool name field, enter a name for the tool.
- In the Tool integration field, search for and select Jira.
- Enter your Jira server instance URL.
- From the Credential type list, select the authentication type you want to use to connect with your Jira server.
-
Basic Auth
- Enter your Jira server username.Note: The Jira user that you use here must have the Jira Administrators permissions.
- Enter the password or access token to access this instance.
- Enter your Jira server username.
- API Key
Enter the API token to access the instance.
-
- If you want to configure webhooks for all the projects discovered in your Jira instance, then select the option Do you wish to configure webhook for the tool?
- Select Use MidServer for an on-premises tool that is attached to a MID Server. Application is automatically set to DevOps and capability is set to REST.
Jira Cloud - In the Tool name field, enter a name for the tool.
- In the Tool integration field, search for and select Jira Cloud.
- in the Tool URL field, enter your Jira Cloud instance URL.
- In the Credential type field, select Basic Auth or OAuth 2.0.
Basic Auth
- Enter your Jira Cloud username.Note: The Jira user that you use here must have the Jira Administrators permissions.
- Enter the password or access token to access this instance.
OAuth 2.0
Pre-requisites:In the Tool credential field, select an existing OAuth 2.0 tool credential record.Note: Only records that are not in use and configured for Jira Cloud can be selected as an existing credential record. - Enter your Jira Cloud username.
- If you want to configure webhooks for all the projects discovered in your Jira instance, then select the option Do you wish to configure webhook for the tool?Note: If you have connected your Jira tool using OAuth 2.0 based authentication, the webhooks are created for the OAuth 2.0 integration app in Jira when you configure automatically, whereas if you have connected using basic authentication, the webhooks are created for all your projects in Jira.
- Select Use MidServer for an on-premises tool that is attached to a MID Server. Application is automatically set to DevOps and capability is set to REST.
For a list of all the permissions required on the credentials for connecting to Jira, see Jira permissions in Permissions required for DevOps tools.
-
Select Order Now.
A request is created. When the request is approved, the tool is created, connected, configured, and discovered.
- From the DevOps catalog items, select DevOps App Onboarding and select Try it.
-
In the DevOps App Onboarding form, enter the details:
Are you creating a new app or adding to an existing one? Select from the options whether to create a new app or use an existing app. App Enter the name for the app that you're creating or using. Onboarding pipelines Leave empty. Onboarding repositories Leave empty. Onboarding plans Enter the connected Jira tool name. Plans Select the plans for which you want to import historical data. Import from and Import to Select the dates for which you want to import the data. By default, the last 30 days are selected. You can choose to import data for a maximum of 90 days. -
Select Order Now.
A request is created. When the request is approved, the plan objects are associated to the app record, which enables real-time tracking. Historical data is also imported for the selected plans. The Track field is automatically enabled for imported plans.