With IAM Role (Recommended)

Use this guide to connect AWS to Cloudaware during trial registration using an IAM role.

Start in Cloudaware

In the Cloudaware Launcher (Control Hub), fill out the form:

1. Enter an AWS account name.

2. Click Generate External ID (crossed-arrows icon).

3. Select the AWS partition^*:

   • aws for public AWS cloud.

   • aws-us-gov for AWS GovCloud.

4. Select one of the CloudFormation launch options:

   • Click this pre-generated template to open a pre-generated CloudFormation template in the AWS Console. For the next steps, see Quick launch below.

   • Click this template to download the CloudFormation template and create the stack manually. For the next steps, see Manual creation below.

5. Continue the setup in the AWS Console based on the selected option.

^*Cloudaware also supports the AWS China partition. Authenticate with Access & Secret Keys.

Set up the IAM Role in AWS

Quick launch

The pre-generated CloudFormation template opens directly in the AWS Console.

In the AWS Console:

1. On the ‘Create stack’ page, review the template details. The Amazon S3 URL is pre-selected as the template source.

2. Click Next to proceed to stack parameters.

3. Specify the stack parameters.

   • Stack name: Enter a descriptive stack name.

   • CloudAware Role ARN: Enter CloudAware.aws.

   • CloudAware Role Name: Enter a descriptive role name, for example, CloudawareRole.

   • External ID: Paste the External ID generated in Cloudaware.

4. Optional: Configure tags, stack failure options, and additional settings,

5. Acknowledge IAM resource creation, then click Next.

6. Review the stack settings, then click Submit to create the stack.

7. After the stack deployment completes, open the Outputs tab.

8. Copy the IAM Role ARN.

Manual creation

Use this option if you downloaded the CloudFormation template to create the stack manually in the AWS Console.

In the AWS Console:

1. Navigate to CloudFormation.

2. Click Create stack → With new resources (standard).

3. Under Specify template, select Upload a template file. Upload CloudFormation template downloaded from Cloudaware.

4. Click Next to proceed to stack parameters.

5. Specify the stack parameters.

   • Stack name: Enter a descriptive stack name.

   • CloudAware Role ARN: Enter CloudAware.aws.

   • CloudAware Role Name: Enter a descriptive role name, for example, CloudawareRole.

   • External ID: Paste the External ID generated in Cloudaware.

6. Optional: Configure tags, stack failure options, and additional settings.

7. Acknowledge IAM resource creation, then click Next.

8. Review the stack settings, then click Submit to create the stack.

9. After the stack deployment completes, open the Outputs tab.

10. Copy the IAM Role ARN.

Complete the setup in Cloudaware

Return to the Cloudaware Launcher (Control Hub):

1. Paste the IAM Role ARN into the form.

2. Click Continue to check the credentials.

3. Click Save.

After Cloudaware validates the AWS account, the trial registration is submitted.

Next steps

Check the inbox for the Registration Complete email.

Registration may take up to 1 hour.