Jira Plugins

Overview

Runbook Automation integrates with Jira through a variety of plugins listed below.
By integrating Runbook Automation with Jira, users can automate many of their operations around Issues, Projects, IT Service Requests, and much more.
These integrations allow operations teams to provide self-service mechanisms to users throughout the business, as well as setup event-driven automation for workflows that involve Jira Software and Jira Service Management.

Plugin Name	Plugin Type	Description
Search Assigned Issues	Job Step	Search assigned issues by user.
Check Issue Exists	Job Step	Check if the Jira issue exists by key.
Comment on Issue	Job Step	Append comments to a Jira issue.
Create Issue	Job Step	Creates a new Jira issue.
Update Issue	Job Step	Updates an existing Jira issue.
Retrieve Issue	Job Step	View the data of an existing Jira issue.
Comment on Issue	Notification	Append comments to a Jira issue.
Create Issue	Notification	Creates a new Jira issue.

Click to expand to see the full list of Runbook Automation plugins for Jira.

Setup

Authentication for the Jira plugins can be configured for the entire system or for an individual project.

Add Jira Account Password or Auth Token to Key Storage

System Key Storage

Place the Jira credentials into the System Key Storage if all Runbook Automation Projects will share the same Jira credentials.

1. Click on the System Menu (gear icon) in the upper right.
2. Click on Key Storage
3. Click +Add or Upload a Key. Select Password for the Key Type.
4. Paste the Jira password or auth token into the field.
5. Click Save:
   

Project Key Storage

Place the Jira credentials into the Project Key Storage if only a specific project should use these Jira credentials.

1. In the specific project, click on Project Settings in the lower left.
2. Click on Key Storage.
3. Click +Add or Upload a Key. Select Password for the Key Type.
4. Paste the Jira password into the field.
5. Click Save.

Now that the Jira password or auth token has been added to Key Storage, the plugin suite can be configured at a Project or System level:

Project Level Configuration

Use the following steps to configure authentication for the Jira plugins for a specific project:

1. In the specific project, click on Project Settings in the lower left.
2. Click on Edit Configuration then click on Plugins.
   
   
3. Click on +PluginGroup.
4. Select Jira from the list.
5. Add your Jira instance URL to the Server URL field. For example, https://acme-company.atlassian.net
6. Place an active Jira username into the Login field. This user must have sufficient permissions to perform the actions that will be automated by Runbook Automation.
7. Click Select next to the Password field and find the Jira password from the prior section stored in Key Storage.
8. (Optional) If using an Auth Token is preferred over a Password, then click Select next to the Auth Token field and select the Jira auth token from Key Storage.
9. Click Save for the plugin configuration.
10. Click Save for the Project Settings:
    
    

System Level Configuration

Use the following steps to configure authentication for the Jira plugins for the whole Runbook Automation system.

1. Click on the System Menu (gear icon) in the upper right.
2. Click on System Configuration.
3. Navigate to the Jira section and click on the Pencil Icon in the upper right:
   
4. Add your Jira instance URL to the Server URL field. For example, https://acme-company.atlassian.net
5. Place an active Jira username into the Login field. This user must have sufficient permissions to perform the actions that will be automated by Runbook Automation.
6. Click Select next to the Password field and find the Jira password from the prior section stored in Key Storage.
7. (Optional) If using an Auth Token is preferred over a Password, then click Select next to the Auth Token field and select the Jira auth token from Key Storage.
8. Click Save for the plugin configuration.