Red Hat Ansible Tower - Launch Job Template
Red Hat Ansible Tower - Launch Job Template launches an existing Job Template, Workflow Job Template, or System Job Template in Ansible Tower, for:
- Assets returned by the selected query or assets selected on the relevant asset page.
This enforcement action launches the specified Ansible Tower template and passes per-device Axonius field values as extra_vars in the launch payload, allowing the playbook to access asset-specific data.
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
Note
- Not all asset types are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Aggregated Security Findings.
- See Actions supported for Software.
Required Fields
These fields must be configured to run the Enforcement Action.
- Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
- Configure Dynamic Values (optional) - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
-
Use stored credentials from the Red Hat Ansible Tower adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.
-
When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.
- Note: The Red Hat Ansible Tower adapter must be configured with a successful connection before using this enforcement action.
-
-
Template Type - Select the type of template to launch:
Job Template,Workflow Job Template, orSystem Job Template. This determines which endpoint is used when launching the template. -
Template ID - The numeric ID of the existing template in Ansible Tower. This is the unique identifier for the template you want to launch.
-
Extra Variables Field Mapping (Optional) - Map Axonius device fields to
extra_varskeys. Each mapped field value is included in the launch payload, allowing the playbook to access device-specific information. For example, mapansible_tower_adapter:hostnametotarget_hostto pass the device hostname to the playbook. -
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Working with Axonius Compute Nodes.
Additional Fields
These fields are optional.
- Domain - Ansible Tower domain URL.
- User Name - Ansible Tower username.
- Password - Ansible Tower password.
- API Token - API token for authentication.
Connection Settings
To successfully execute this enforcement action, the following connection parameters are required:
- Host Name or IP Address - The Ansible Tower domain or IP address (e.g.,
https://ansible.example.com). - Authentication credentials - Either username/password combination or API Token.
-
Verify SSL (optional) - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
-
HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.
-
HTTPS Proxy User Name (optional) - The user name to use when connecting to the server using the HTTPS Proxy.
-
HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.
-
Gateway Name - Select the Gateway through which to connect to perform the action.
APIs
Axonius uses the Red Hat Ansible Automation Platform API - POST /api/v2/job_templates/{id}/launch/ or POST /api/controller/v2/job_templates/{id}/launch/
The endpoint varies based on your Ansible Tower version (legacy vs. 2.5+).
Required Ports
Axonius must be able to communicate via the following ports:
- TCP port 80 (HTTP)
- TCP port 443 (HTTPS)
Required Permissions
The stored credentials, or those provided in Connection and Credentials, must have the following permission(s) to perform this Enforcement Action:
- Ansible Tower user must have permission to launch templates.
- Organization access: User must have access to the organization containing the template.
Updated about 6 hours ago
