Documentation forSolarWinds Service Desk

Jira Integration

You can integrate several applications with SWSD to improve efficiency for all processes within your organization. The integration of Jira with SWSD allows you to escalate an incident directly into a Jira project.

SolarWinds recommends setting up service accounts in both Jira and SWSD for smooth integration of the two platforms. If the incident requester doesn’t have a user with the same email in Jira, the Jira issue reporter defaults to the Jira admin.

Setup

  1. In SWSD, navigate to Setup> Integrations > Jira.
  2. Authenticate SWSD and Jira to establish a connection.
    1. You can now escalate any incident to Jira via the Incident details page.
    2. After an issue is closed in Jira, the incident in SWSD will simultaneously update with the details from Jira.
  3. Make sure you have an active Jira account and enter the URL in the space provided. Then click Generate Public.

  1. Log into your Jira account and navigate to Settings.
  2. Click Products and Application Links.
  3. Enter the URL of your SWSD account (for example, https://company.solarwinds.com) into the field at the top of the Configure Applications Links page, and click Create new link.
  4. When presented with the following warning, please disregard and click Continue.

  5. In the Link Applications section, enter the requested information:
    1. Application Name. Type Samanage (uppercase first letter).

    2. Application Type. Select Generic Application.

    3. Service Provider. Type Samanage (uppercase first letter).

    4. Consumer key and Shared secret. Type samanage (note the use of lower case here).

    5. Request Token URL, Access token URL, and Authorize URL. Type the URL of your Samanage account (For example, https://company.samanage.com).

    6. Select the Create incoming link checkbox.

    7. Click Continue.

  6. Create an Application link in Jira.
  7. Enter Consumer Key (samanage) and a Consumer Name (Samanage).

  8. Paste the RSA public key you generated in Samanage into the "Public Key" field, then click Continue.

  9. See the confirmation screen confirming the application link was created successfully.

  10. Return to SWSD and click Active.
  11. When prompted to give SWSD access to read/write in Jira, click Allow.

  12. After you are returned to the activation page, click Next Step (projects and issues) to continue configuration.
  13. Pull projects and issues from your Jira instance into SWSD.

    Select the associated checkbox of each Jira project you would like tied to SWSD. Here you can also select the issue type (task, incident, change, epic, or story) as shown below. After making selections, click Next Step (Select Defaults) to continue configuration.

  14. Select Default Project and Default Issue when incidents are escalated to Jira, then click Next Step (Field mapping).

  15. In the Field Mapping dialog, map the fields for the path between SWSD and Jira.

    This defines relationships and allows data and information to flow to the correct fields within the databases on each side of the integration. After establishing mapping, click Next Step (Tickets and Comments).

  16. Define what to do when an issue is closed in Jira. Options are:
    1. Keep the SWSD ticket open.
    2. Close the SWSD ticket with the details from Jira.
    3. You can also select the name of the user that is associated with private comments from Jira and link back to SWSD. This is used when you want to communicate to the SWSD incident agent privately from Jira to perhaps let the agent know a private status update. You can also select whether you want to be able to send comments from SWSD to Jira via a checkbox.

    When resolution codes are set to Mandatory in SWSD, tickets closed in Jira are automatically labeled "Closed by Jira" and are closed in SWSD as well.

Notifications

To receive notifications upon closure of an associated Jira issue, you will need to enable a webhook. To enable this feature:

  1. Log in to Jira and navigate to System Webhooks (at /plugins/servlet/webhooks as of the writing of this article) and create a new webhook.
  2. Use the following information:
    • Name. SolarWinds
    • URL. Copy and paste from the final step in SWSD.

  3. Under Issue related events, select the Issue checkbox labeled updated.

  4. Click Create.

Active Jira Integration

After you have successfully activated Jira integration, you can:

  • Make configuration changes by selecting Projects and Issues.
  • View your list of projects.
  • Add/edit existing project details.
  • Modify field mappings.