Configure Jira Service Desk Connection

A Jira Service Desk connection securely stores reusable authentication credential and URL path information for integrations with Jira Service Desk.

Complete the following steps to configure a connection to Jira Service Desk:

1. Identify your Jira Service Desk base URL
2. Create an Atlassian API token
3. Generate an Authorization header
4. Create the Jira Service Desk connection from the Alert Logic console
5. Use the connection

Identify your Jira Service Desk base URL

Identify your Jira Service Desk instance name. In the Base URL field, you must replace "<myinstance>" in the default URL provided in the Alert Logic console with the Jira Service Desk instance you want to target.

In the Jira Service Desk templated connection configuration, the Alert Logic console provides the rest of the default URL path that Jira Service Desk requires for ticket creation. For more information, see Configure Jira Service Desk Templated Connection.

Generate an Authorization header

Jira Service Desk requires an HTTP Authorization request header. You can use the following instructions for your operating system to generate the header.

The command requires a valid Jira Service Desk username and API token, and it encodes the credentials with base64. To construct the header, you enter the word "Basic" (which is the Authorization header type), a space, and then the base64-encoded credentials.

Alert Logic stores your Authorization header securely when you save the connection.

To generate the header on Linux and Mac OS X:

1. In the command line, type the following command, including the single quotation marks:

   echo -n '<username>:<api_token>' | base64

   where you must replace <username> with a valid username for Jira Service Desk and <api_token> with the API token you created earlier.

2. Copy the following string, which you must enter in the Authorization Header field when you create the connection:

   Basic <resulting_base64_encoded_string>

To generate the header in Windows PowerShell:

1. In the command line, type the following commands, including the quotation marks:

   $auth = [System.Text.Encoding]::UTF8.GetBytes("<username>:<api_token>")

   where you must replace <username> with a valid username for Jira Service Desk and <api_token> with the API token you created earlier.

   [System.Convert]::ToBase64String($auth)

2. Copy the following string, which you must enter in the Authorization Header field when you create the connection:

   Basic <resulting_base64_encoded_string>

Create the Jira Service Desk connection from the Alert Logic console

The next step is to create the Jira Service Desk connection in the Alert Logic console.

To create a Jira Service Desk connection:

1. In the Alert Logic console, click the navigation menu icon (), click Configure, and then click Connections.
2. On the Connections page, click the add icon (), and then click Jira Service Desk.
3. On the Create a Jira Service Desk Connection page, type a descriptive name for the connection—for example, "Jira Service Desk Connection".
4. In Base URL, replace <myinstance> with the Jira Service Desk instance name identified earlier.
5. In Authorization Header, paste the authorization header you generated earlier.
6. In Custom Header(s), leave the following default HTTP header that Jira Service Desk requires or customize the headers for advanced integrations.

   Content-Type: application/json
   

   If you add headers, each HTTP header name-value pair must be on a separate line.

7. Click SAVE.

Use the connection

After you save the connection, you can use it in a templated connection. For more information on templated connections, see Templated Connections Configuration Guide.

Manage connections

You can view the list of connections and edit or delete an existing one. For more information, see Manage Connections.