Use Atlassian Automation with Ansible

Before you begin

To manage project automations, you must have the appropriate project permissions:

• Company-managed projects: You’ll need the Administer projects and Browse projects permissions for your project. Learn more about permissions for company-managed projects

• Team-managed projects: You’ll need Administrator access for your project. Learn more about permissions for team-managed projects

To manage global automations, you’ll need the Administer Jira permission. Learn more about global permissions in Jira Cloud.

In Ansible, make sure you have configured the following settings so your connection works properly:

• Open up the HTTPS port in the Ansible Automation controller. Read more about Ansible network ports and protocols

• Enable X-origin requests for Automation in Ansible. Read how to enable X-original requests in Ansible
  You’ll need to make CORS_ORIGIN_ALLOW_ALL = True and add your Jira site's URL to allowed regexes, like CORS_ALLOWED_ORIGIN_REGEXES = [
  r"<https://<your_jira_site>>.atlassian.net*",
  ]

• If you use a firewall, allow the Atlassian IP address [IP address] to ensure access to Ansible Automation Controller. Read more about Atlassian IP addresses and domains

Integrate your automation rule with Ansible

1. You can use your existing application in Ansible to connect to Atlassian Automation. If you don’t have an application, create a new one. Read how to create an application in Ansible to get started. Use the details below while creating:
   Redirect URIs: https://id.atlassian.com/outboundAuth/finish
   Client Type: Confidential
   Authorisation Grant Type: Authorisation Code

2. In your Jira Service Management, go to Automation and select Create rule.

3. Select the Ansible action for your rule. Launch job template in Ansible is the only available action at the moment.
   
   

4. Select Connect to create a connection with Ansible. Connections allow your automation rules to make changes in other tools and products.

5. In your connection, enter the application information that you wish to connect to Atlassian Automation.

   1. Application name. Provide a unique name to easily identify your Ansible connection. This doesn’t have to be the name of the application, but mentioning the application name with a unique identifier can help. For example, Acme A or Acme B, where Acme is the name of the application and A/B are the unique values.

   2. Client ID. The client ID of the application in Ansible. It’s shown only once after you create an application.

   3. Client secret. The client secret of the application in Ansible. It’s shown only once after you create an application.

   4. Ansible Tower URL. This is usually the URL from the address bar of your browser while you’re in the Ansible Automation Controller.

6. Select Connect to complete creating your connection.