Info |
---|
Jira integration allows users to add a Jira account to Cloudaware to set up auto-discovery of Jira issues in the CMDB and/or create issues in Jira based on specific criteria met in Cloudaware. |
To see how Cloudaware seamlessly integrates with Jira in action, request a demo.
Table of Contents |
---|
Introduction
Cloudaware offers several key capabilities of integrating with Atlassian Jira:
Auto-discovery of issues related to CMDB objects and importing them from JIRA Jira to Cloudaware
Creating a Jira issue whenever any specific criteria is met in Cloudaware (e.g. new incident, policy violation, vulnerability scan, etc.) and posting a comment to the existing Jira issue (e.g. new vulnerability has been detected as fixed, etc.)
...
Configuring Auto-discovery and Import of Jira Issues to CMDB
...
4. The green light in 'Status' means your Jira account has been successfully added. If there is a red light, please contact support@cloudaware.com
...
Adding Custom Fields to Jira
...
Manage Permissions and Create Fields in Jira
1. Grant Cloudaware with user/project: ADD_COMMENTS permission (see Jira documentation).
2. Log in to Cloudaware account → Setup → Objects.
3. Select an object you want Jira issues to be created for (in this example, CloudAware Vulnerability Scan).
4. Review the section 'Custom Fields & Relationships' to define fields that should be displayed in an issue's description. In our use case we are using the following fields: Priority, Risk, Severity, CVSS Number, Host, Port, Protocol, Description, Disappearance Time.
Note |
---|
Use Cloudaware Field Label names when creating fields in your Jira as fields names MUST match. |
Setting Up Jira Actions in Cloudaware
Anchor | ||||
---|---|---|---|---|
|
...
Field List - determine the fields you'd like to be displayed in a Jira issue and Cloudaware comment.
Note |
---|
Use API names for fields. The integration must include all the fields you plan to use in notifications. The order you choose for the fields will be reflected in a Jira issue. |
...
5. Click Save.
6. Copy and save the URL as it is required for further configuration in Cloudaware.
...
Configuring Cloudaware Workflows to Create Issues and Post Comments in Jira
Anchor | ||||
---|---|---|---|---|
|
Once you have configured Jira Action, set up two different workflow rules - for creating a Jira issue (1) and adding a comment (2).
1. Workflow Rule for Jira issue creation:
...
Click Save&Next.
Add Workflow Action → New Outbound Message:
Object: CloudAware Vulnerability Scan
Name: Jira Notification: New Vulnerability Detected
Endpoint URL: paste the URL copied from the integration's details
Select the fields to be displayed as set up in the Integration details:
...
Note that Name is a mandatory field.
Click Done. Click Activate to activate your workflow.
2. Workflow Rule for posting a comment in Jira issue:
...
Click Save&Next.
Add Workflow Action → New Outbound Message:
Object: CloudAware Vulnerability Scan
Name: Jira Notification: Vulnerability Fixed
Endpoint URL: paste the URL copied from the integration's details
Select the fields to be displayed as set up in the Integration details:
...
Click Done. Click Activate to activate your workflow.
Jira issue sample | Cloudaware comment sample |
---|---|
...
Bulk Closing Issues with Cloudaware Comments in Jira
Based on our use case, we can consider all issues with a comment as not requiring further actions since a vulnerability the Jira issue informs of has been fixed.
Follow these steps to configure automatic change of issue status to 'Resolved':
In your Service Desk project select Project settings → Automation.
Select Add rule.
Select Custom rule from the list, then select Next.
Give your custom rule a name and a description.
Configure your rule by defining the WHEN, IF, and THEN fields:
5.1. When comment added
5.2. If comment contains This vulnerability is fixed and deleted on
5.3. Then transition issue to status "Resolved"
...
Populating Custom Fields in Jira*
Anchor | ||||
---|---|---|---|---|
|
...