Skip to main content

Jira Accounts

Integrate Atlassian Jira with Cloudaware to discover issues, link them to CMDB configuration items, and support issue creation or updates from Cloudaware workflows.

info
  • Audience: Cloudaware administrators, PMO/DevOps
  • Outcome: The Jira account is connected and Jira issues are available in the CMDB for work tracking, operational context, and asset correlation

Capabilities​

The integration supports:

  • Discovery of Jira issues in the CMDB
  • Relationships between Jira accounts, issue, and related assets
  • Jira issue creation or updates from Cloudaware workflows, where configured

Prerequisites​

Before you begin, make sure you have:

  • Access to a Cloudaware account.
  • A user with access to the Admin Console and permissions to manage cloud accounts, organizations, and integrations (Cloudaware Administrator).
  • Jira Cloud or Jira Server URL.
  • Jira API token or service credentials with read access.
note

If you use API tokens with scopes in Jira, ensure that the following Jira OAuth scopes are granted to Cloudaware:

  • read:jql:jira
  • read:jira-work
  • read:issue:jira
  • read:issue-meta:jira
  • read:project:jira
  • read:servicedesk-request
  • read:request.feedback:jira-service-management
  • read:user:jira
  • write:jira-work
  • write:request.feedback:jira-service-management
  • write:servicedesk-request

Add a Jira Account to Cloudaware​

To connect your Jira account to Cloudaware:

  1. In Cloudaware, go to Admin.
  2. Find Jira Accounts & Actions, then click + ADD.
  3. Enter the following values:
    • Name: A display name for this connection.
    • URL: The Jira Cloud or Jira Server URL, e.g., https://jira.companyname.com.
    • Login: The Jira username.
    • Password: The Jira password (for cloud Jira, use API token).
    • Retrieve issues for the last: Select the desired time range from the drop-down list.
    • Trust Certificate: Enable if Jira is in a private network and TunHub has been set up by Cloudaware (in this case, the Jira URL has the format https://gw.tunhub.cloudaware.com:12345).
  4. Click SAVE.
  5. Confirm that the integration status indicator is green.

View Jira Data in CMDB​

To browse discovered Jira resources:

  1. In Cloudaware, open CMDB Navigator.
  2. In the left pane, select JIRA.
  3. Open an object list, e.g., Jira Issues, to view records.

Supported Objects​

Cloudaware ingests the following Jira objects:

Jira ObjectCMDB Object API Name
Jira AccountCA10__CaJiraAccount__c
Jira IssueCA10__CaJiraIssue__c

Troubleshooting​

note

Initial data collection may take time to complete.

Authentication Fails or Integration Shows Red Status​

  • Verify the Jira URL and API token or service credentials.
  • Confirm that the Jira account has read access to the projects and issues Cloudaware must discover.
  • Re-enter the credentials by editing the integration in Cloudaware.

Issues Are Missing​

  • Confirm that the Jira account can access the missing projects or issues in Jira.
  • Review project permissions and issue security settings.
  • In CMDB Navigator, verify that you are viewing the JIRA section and related resources.

Jira Workflow Actions Do Not Create or Update Issues​

  • Confirm that Jira actions are configured in Cloudaware.
  • Verify that the Jira account has the required issue create or update permissions for the target project.
  • Review the workflow criteria that trigger Jira actions.

Still stuck? Contact Cloudaware Support at support@cloudaware.com with the integration name and a brief description of the issue.

Reconfigure or Remove the Integration​

warning

To rotate credentials, edit the existing integration instead of deleting and re-creating it.

Update the Integration Details​

  1. Go to Admin.
  2. Select Jira Accounts & Actions.
  3. Under the Jira Accounts tab, select the specific integration.
  4. Open the three-dot menu (⋮), then click Edit.
  5. Update the required fields.
  6. Click Save.

Remove the Integration from Cloudaware​

  1. Go to Admin.
  2. Select Jira Accounts & Actions.
  3. Under the Jira Accounts tab, select the specific integration.
  4. Open the three-dot menu (⋮), then click Delete.
  5. Confirm the deletion if prompted.

Jira Actions​

Jira actions use the connected Jira account to create or update Jira issues from Cloudaware workflows. Use them when CMDB records, policy findings, incidents, or other Cloudaware events need to open work items in Jira and keep those issues aligned with Cloudaware context.

Security Notes​

  • Use a dedicated Jira service account or API token for Cloudaware discovery and workflow actions.
  • Grant only the minimum project and issue permissions required for the Jira data and actions Cloudaware must use.
  • Avoid using a personal administrator account for long-running integrations.
  • Rotate tokens or service credentials according to your organization's credential-rotation policy.
  • Update the Cloudaware Jira integration immediately if credentials are revoked, regenerated, or reset in Jira.