> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ansible Tower

> Follow these steps to connect Ansible Tower via the StackOne Hub successfully.

<Warning>
  Ensure that your Ansible Tower account has Administrator privileges.
</Warning>

If you've been directed to StackOne to integrate with Ansible Tower, the following steps will help you understand the process and any necessary actions to configure a successful integration.

## Log in to Ansible Tower

Log in to your Ansible Tower instance, and note your **Ansible Tower URL** to be used in a later step.

(Example: `https://ansible.myapp-exp.com`)

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Log in" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/ansibletower/image1.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=49b2a7a68c26c7d3ec950439ef080004" width="576" height="376" data-path="images/ansibletower/image1.png" />
</Frame>

## Create a New OAuth Application

This connection will authenticate on behalf of a registered Application in Ansible.

<Steps>
  <Step title="Navigate to Applications">
    Click **Applications** in the left navigation bar.
  </Step>

  <Step title="Create New Application">
    Click the **+** button in the top right to begin creating a new application.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create New Application" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/ansibletower/image2.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=826745703a7149011ca7e4f9dc5e2bcf" width="2494" height="1036" data-path="images/ansibletower/image2.png" />
    </Frame>
  </Step>

  <Step title="Enter Application Details">
    Enter the following details in the *Create New Application* window:

    * Name
    * Description (optional)
    * Organization: select the organization to be associated with this connection
    * Authorization Grant Type: Select *Authorization Code*
    * Redirect URIS: Enter `https://api.stackone.com/connect/oauth2/ansibletower_iam/callback`
    * Client Type: *Confidential* or *Public* can be selected for this connection

    Click the *Save* button to proceed.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Application Details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/ansibletower/image3.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=bff3b0fadad942e0a1987b45c97e412c" width="2360" height="680" data-path="images/ansibletower/image3.png" />
    </Frame>
  </Step>

  <Step title="Copy Application Credentials">
    Your new Application **Client ID** and **Client Secret** will be displayed. Copy these and store them securely to be used in a later step.
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter the credentials from the previous steps:

    * Client ID
    * Client Secret
    * Ansible Tower URL

    Proceed by clicking the Connect button.
  </Step>

  <Step title="Authorize Application Access">
    Depending on your Ansible Tower instance configuration, a window may appear with a prompt to log in to Ansible Tower and authorize this new application.

    Log in again and click the **Authorize** button to proceed.
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/getting-started-with-your-api) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
  <li>Groups</li>
</ul>