Integrate your ServiceNow instance with the Jira Server instance to authenticate the requests from ServiceNow.

Before you begin

  • Request an Integration Hub subscription
  • Activate the Jira spoke
  • Role required: admin

About this task

You can set up the Jira spoke for your Jira Server instance using basic authentication. For this basic authentication, you can use either API Key or user name and password, as per your requirement.

Option 1: Using user name and password

Integrate the ServiceNow instance and Jira Server using user name and password to authenticate ServiceNow requests.

Before you begin

Role required: admin

Procedure

  1. Navigate to Process Automation > Flow Designer.
  2. Click the Connections tab.
  3. Locate the Jira connection alias and click View Details.
    • To configure the default connection and credential alias record that is shipped along with the Jira spoke, click View Details.
    • To manage more than one Jira spoke connection records, you should create a new child alias record by clicking Add Connection. For more information about using multiple connections, see Supporting multiple connections.
    If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.
  4. On the Connection form, fill in the fields.

    Configure the connection for Jira Server.

  5. Click Create Connection.

Option 2: Using API Key

Integrate the ServiceNow instance and Jira Server using API Key to authenticate ServiceNow requests.

Before you begin

Role required: admin

Generate a personal access token

Generate a personal access token from the Jira Server instance.

Before you begin

  • Access to Jira Server instance.
  • Role required: admin

Procedure

  1. Log in to the Jira Server instance as an admin.
  2. Click the user profile icon and click Profile.
  3. Under Personal Access Tokens, click Create token.Create a personal access token.
  4. On the Create a personal access token form, fill in the required values.Fill in the values to create a personal access token.
    The value of personal access token is generated and displayed. Copy this value for later use.Copy the value of the generated token.

Create a credential record for the Jira spoke

Create an API key credential record to authenticate the requests from ServiceNow.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > Integration Hub > Connection & Credential Aliases > Credentials.
  2. Click New.
    The system displays the message, What type of Credentials would you like to create?
  3. Select API Key Credentials.
  4. On the form, fill these values.
    Field Description
    Name Name to identify the credential record. For example, Jira Server API Key Cred.
    API Key Enter value in this format: Bearer <Personal Access Token>.

    <Personal Access Token> is the value of personal access token you had created in the Jira system dashboard.

  5. Click Submit.

Create a connection record for the Jira spoke

Create a connection record for the Jira account. The connection and credential alias uses this connection to perform actions in Jira.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > Connections & Credentials > Connection & Credential Aliases.
  2. Open the alias record for Jira that shipped with the spoke.
  3. On the Connections tab, click New.
    The system displays a blank HTTP(s) Connection form.
  4. Enter these values and click Submit.
    Field Value required
    Name Enter any name to uniquely identify the connection record. For example, enter Jira Server API key Connection.
    Credential Select the Credential record created for Jira. For example, select Jira Server API Key Cred.
    Connection URL Enter the URL of your Jira Server instance.
  5. In the Attributes related list, provide these values.
    1. Enter the value 2 for api_version.
    2. Enter the value server for server_type.
    Set the value of server_type to server.
  6. Click Submit.