Configure an Ansible Automation Platform integration

Connect the automation orchestrator to an Ansible Automation Platform endpoint so that workflow nodes can run job templates and workflows on your Ansible Automation Platform environment.

Before you begin

You must have an administrator role in the automation orchestrator. For more information about roles, see Role-based access control.
You must have access to an Ansible Automation Platform endpoint, including:
- The endpoint URL
- Authentication credentials (username and password, or OAuth token)
The Ansible Automation Platform endpoint must be accessible from the automation orchestrator network.

About this task

The Configure integration wizard guides you through the integration details and connection credential steps.

Procedure

Complete the integration details.

Log in to the automation orchestrator.
Navigate to Configuration > Integrations.
Click Configure integration.
From the Integration type list, select Ansible Automation Platform.

Enter the integration details.

Field	Description
Server name / ID	A display name for this integration. Use a descriptive name that identifies the environment, such as `Ansible Automation Platform - Production` or `Ansible Automation Platform - Development`.
Description	An optional description of the integration and its purpose.
AAP URL	The URL of the Ansible Automation Platform endpoint (for example, `https://aap.example.com`).
Scope	When Global is enabled, this integration is available to all projects. Disable to scope the integration to specific projects.

Expand the Security section and configure the following optional fields.

Field	Description
Allow HTTP connections	Permits unencrypted HTTP URLs for this integration.
Disable TLS certificate verification	Skips validation of the server's TLS certificate on connections.
CA certificate	PEM-encoded CA certificate to trust for this integration's TLS connections.

Click Next.

Configure the connection credential.
1. Select a Health check credential from the dropdown. This credential is used to verify the connection to the integration and perform periodic health checks.
  
  Note:
  
  This credential is not the credential used by the integration at runtime in a workflow. Workflow credentials are configured separately in the workflow builder.
2. Click Test connection to verify that the endpoint is reachable and authentication is valid.
  - If the test succeeds, a confirmation message is displayed.
  - If the test fails, review the error message and verify your endpoint URL and health check credential. For more information, see Test and monitor integration health.
3. Click Save.

Results

On the Integrations list page, verify that the new integration shows an Available status.

Note:

The Ansible Automation Platform integration is now available for workflow designers to select when configuring job template or workflow nodes. Workflow designers can only select integrations that are globally scoped or project-scoped to their current project.

Tip:

To connect to multiple Ansible Automation Platform environments (for example, development, staging, and production), repeat this procedure for each environment.