AWS Service Management Connector for Jira Service Management

To help customers provision and manage secure, compliant AWS resources into their Jira Service Management portal, AWS created the AWS Service Management Connector for Jira Service Management (formerly the AWS Service Catalog Connector).

The AWS Service Management Connector for Jira Service Management allows Jira Service Management end-users to provision, manage and operate AWS resources natively through Atlassian's Jira Service Management. Jira Service Management administrators can provide pre-approved, secured and governed AWS resources to end-users through AWS Service Catalog, create and manage operational items through AWS Systems Manager OpsCenter, execute automation playbooks through AWS Systems Manager Automation and track resources in a configuration item view powered by AWS Config seamlessly on the Jira Service Management with the AWS Service Management Connector.

This simplifies AWS product request actions for Jira Service Management users and provides Jira Service Management governance and oversight over AWS products.

The AWS-supplied connector is available at no charge in the Atlassian Marketplace. This new feature is generally available in all AWS Regions where AWS Service Catalog, AWS Config and AWS Systems Manager services are available.

Topics

• Background
• Jira Service Management Supported Versions and Releases
• Getting Started
• Release Notes
• Baseline Permissions
• Configuring AWS Service Catalog
• Configuring Jira Service Management
• IT Lifecycle Management Setup and Use Case
• Validating Configurations
• Jira Additional Administrator Features

Background

AWS Service Catalog allows you to centrally manage commonly deployed AWS services and provisioned software products. It helps your organization meet consistent governance and compliance requirements, while enabling users to quickly deploy only the approved AWS services they need.

AWS Config enables you to assess, audit, and evaluate the configurations of your AWS resources. AWS Config continuously monitors and records your AWS resource configurations and allows you to automate the evaluation of recorded configurations against desired configurations.

AWS Systems Manager gives you visibility and control of your infrastructure on AWS. Systems Manager provides a unified user interface so you can view operational data from multiple AWS services, investigate and resolve operational issues through OpsCenter, and allows you to automate operational tasks across your AWS resources.

Atlassian Jira Service Management is service desk software for modern IT teams. Jira Service Management request types enable self-service for developers and end users to order IT services based on request fulfillment approvals and workflows.

Jira Service Management Supported Versions and Releases

The AWS Service Management Connector for Jira Service Management supports Jira Service Management Server and Data Center versions. Jira software (Jira Service Management) releases are supported for the current and one previous version in each of the major, minor, and point release streams:

• Jira Server 7.13.17 to 8.15.0

• Jira Data Center 7.13.17 to 8.15.0

A Jira Service Management Cloud Connector is also available in the Atlassian Marketplace. For more information, see AWS Service Catalog for Jira Service Management Cloud.

Getting Started

Before installing the AWS Service Management Connector for Jira Service Management , you need an AWS account and an Atlassian instance with Jira Service Management pre-installed. Verify that you have the necessary permissions in your AWS account and Jira Service Management software.

For a zip file containing Connector add-on code as well as AWS Configuration files, download and extract the AWS Service Management Connector for JSM-Configuration Files.

Note

The Jira Products on AWS Reference Deployment Quick Start is available to use AWS resources for infrastructure required to install Jira Service Management data center version.

AWS prerequisites

To get started:

• To use AWS Service Catalog with the Connector, you need an AWS account to configure your AWS portfolios and products. For details, see Setting Up AWS Service Catalog.

• To see AWS Config details, the service settings need to be configured to record data for the resource types of interest. It is recommended to include provisioned products and AWS CloudFormation stacks in addition to the major resource types used by your team. For details,see Setting Up AWS Config with the Console.

• To use AWS Systems Manager Automation with the Connector, no AWS-side setup is required. A number of automation documents are provided by AWS as standard. If you have additional automation documents you wish to use, they will be available in the Connector. For details, see Working with Automation Documents (Playbooks).

• To use AWS Systems Manager OpsCenter with the Connector, enable OpsCenter in the AWS Systems Manager console. For details see, Getting Started with OpsCenter. The Connector also enables viewing resources and automation documents (runbooks) associated to OpsItem. For details to associate resources to OpsItems in AWS OpsCenter, see Working with Related Resources . For details to associate automation documents to OpsItems in AWS OpsCenter, see Remediating OpsItem issues using Systems Manager automation.

For each AWS account, the Connector for Jira Service Management also requires API access with Baseline permissions as described below.

Jira Service Management prerequisites

In addition to your AWS account, you need the Jira Service Management software installed on your Atlassian instance before you can install the AWS Service Management Connector add-on. The Jira Service Management administrator needs the admin role to install the AWS Service Management Connector add-on.

Before configuring your AWS connector, ensure that you follow Atlassian recommendations for securing your Jira Service Management instances. For more information, see Preventing Security Attacks.

The Connector for Jira Service Management add-on is available to download in the Atlassian Marketplace.

Release Notes

Version 1.7.1 of the AWS Service management Connector for Jira Service Management (formerly the AWS Service Catalog Connector) is a patch release that fixes a bug in the workflow for end users. Version 1.7.1 also includes recently launched Version 1.7.0 features:

AWS Service Catalog integration features

• The ability for Jira Service Management administrators to assign the default Jira user used by the Jira workflow engine.

• Enable Jira Service Management administrators to configure AWS product request form components available for end users to view.

• Enable Jira Service Management administrators to create AWS Tags across provisioned products.

• The ability for end users to view AWS specific parameters on EC2 resources such as Availability Zones, Image ID, Instance Id, KeyPair, Security Group and VPC.

AWS Systems Manager OpsCenter integration features

• Create and update a Jira Issue when an operational item (OpsItem) is created or updated in AWS Systems Manager OpsCenter.

• Ability to update OpsItems in AWS Systems Manager OpsCenter when the Jira issue is updated in Jira Service Management.

• Ability to view and execute automation runbooks to resolve OpsItems and view execution results from the Jira Issue.

  This version also includes prior AWS Service Management Connector for Jira Service Management features such as:

AWS Service Catalog

• Rendering AWS Service Catalog portfolios and products in the Jira Service Management Customer Portal and Jira Agent views.

• The ability for Jira Service Management administrators to associate Jira Service Management approval groups to AWS Service Catalog portfolios to require approvals for Jira Service Management user product requests.

• The ability for Jira Service Management users to request AWS Service Catalog products through Jira Service Management.

• The ability for administrators to view portfolio and product budgets and actual costs. (Requires budgets to be associated within AWS Service Catalog.)

• Support for AWS Service Catalog self-service actions for Jira Service Management users to update and terminate products.

• Support for AWS CloudFormation StackSets, enabling launch of AWS Service Catalog products across multiple regions and accounts.

• Support for AWS CloudFormation Change Sets, enabling a preview of resource changes prior to a launch or update.

AWS Config

• Rendering of AWS Config configuration item details on provisioned AWS products through Jira Service Management request.

• The ability to view the configuration item relationships in a tree structure.

• The ability to associate AWS Config items details to Jira issues.

AWS Systems Manager Automation

• Rendering of AWS Systems Manager automation documents in the Jira Service Management Customer Portal and Jira Agent views.

• The ability for Jira Service Management administrators to associate AWS Systems Manager automation to Jira projects.

• The ability for Jira Service Management users to request and execute AWS Systems Manager automation documents through Jira Service Management.

• The ability to create Jira issues (incidents) that provide actionable remediation suggestions through a Connector specific AWS Systems Manager automation document.

• Support for multiple AWS accounts.

• Support for FIPS endpoints and usage in the AWS GovCloud East and GovCloud West regions.

• Support for the latest releases of Jira Service Management Server and Data Center versions.