Chapter 2. Getting started as a platform administrator

Procedure

1. With the login information provided after your installation completed, open a web browser and log in to Red Hat Ansible Automation Platform by navigating to its server URL at: https://<AAP_SERVER_NAME>/

2. Use the credentials specified during the installation process to login:

   • The default username is admin.
   • The password for admin is the value specified during installation.

1. Click the Service Account / Red Hat Satellite tab.
2. Enter the client ID you received when you created your service account in the field labeled Client ID / Satellite username.
3. Enter the client secret you received when you created your service account in the field labeled Client secret / Satellite password. Your subscription appears in the Subscription list. Select your subscription.
4. After you have added your subscription, click Next.
5. Check the box indicating that you agree to the End User License Agreement.
6. Review your information and click Finish.

Procedure

1. From the navigation panel, select Access Management Organizations.
2. Click Create organization.

3. Enter the Name and optionally provide a Description for your organization.

   Note

   If automation controller is enabled on the platform, continue with Step 4. Otherwise, proceed to Step 6.

4. Select the name of the Execution environment or search for one that exists that members of this team can run automation.
5. Enter the name of the Instance Groups on which to run this organization.
6. Optional: Enter the Galaxy credentials or search from a list of existing ones.

7. Select the Max hosts for this organization. The default is 0. When this value is 0, it signifies no limit. If you try to add a host to an organization that has reached or exceeded its cap on hosts, an error message displays:

   You have already reached the maximum number of 1 hosts allowed for your organization. Contact your System Administrator for assistance.

   Copy to Clipboard Toggle word wrap
8. Click Next.

9. If you selected more than 1 instance group, you can manage the order by dragging and dropping the instance group up or down in the list and clicking Confirm.

   Note

   The execution precedence is determined by the order in which the instance groups are listed.

10. Click Next and verify the organization settings.
11. Click Finish.

Procedure

1. From the navigation panel, select Access Management Teams.
2. Click Create team.
3. Enter a Name and optionally give a Description for the team.

4. Select an Organization to be associated with this team.

   Note

   Each team can only be assigned to one organization.

5. Click Create team.

   The Details page opens, where you can review and edit your team information.

Procedure

1. From the navigation panel, select Access Management Users.
2. Click Create user.
3. Enter the details about your new user in the fields on the Create user page. Fields marked with an asterisk (*) are required.

4. Normal users are the default when no User type is specified. To define a user as an administrator or auditor, select a User type checkbox.

   Note

   If you are modifying your own password, log out and log back in again for it to take effect.

5. Select the Organization to be assigned for this user. For information about creating a new organization, refer to Creating an organization.
6. Click Create user.

Procedure

1. From the navigation panel, select Access Management Authentication Methods.
2. Click Create authentication.
3. Select GitHub from the Authentication type list and click Next.
4. Enter a Name for this authentication configuration.

5. When the application is registered, GitHub displays the Client ID and Client Secret:

   1. Copy and paste the GitHub Client ID into the GitHub OAuth2 Key field.
   2. Copy and paste the GitHub Client Secret into the GitHub OAuth2 Secret field.

6. Optional: Enter any Additional Authenticator Fields that this authenticator can take. These fields are not validated and are passed directly back to the authenticator.

   Note

   Values defined in this field override the dedicated fields provided in the UI. Any values not defined here are not provided to the authenticator.

7. To automatically create organizations, users, and teams upon successful login, select Create objects.
8. To enable this authentication method upon creation, select Enabled.
9. To remove a user for any groups they were previously added to when they authenticate from this source, select Remove users.
10. Click Next.