AWS

Add AWS Account Integration

This integration uses AWS CloudFormation to automatically set up the necessary IAM roles and permissions.

Integration Steps

Follow these steps to securely connect your AWS account. This process involves your application and the AWS Console.

1. Give Account a Name

   • In the Add AWS Account form, enter a Display Name *. This is a friendly, custom name for your reference (e.g., aws-production or aws-dev).

2. Connect to AWS Console

   • Click the Connect Via AWS Console button.
   • You will be redirected to the AWS CloudFormation console in a new browser tab. The required template will be pre-loaded.

3. Create the CloudFormation Stack

   • In the AWS CloudFormation tab, all values will be pre-filled.
   • Important: As the instructions state, DO NOT change any values in the fields.
   • Scroll to the bottom of the page, acknowledge that AWS CloudFormation might create IAM resources, and click Create stack.

4. Wait for Stack Completion

   • Remain on the AWS CloudFormation page and wait for the stack's status to change from CREATE_IN_PROGRESS to CREATE_COMPLETE. This may take a minute or two.

5. Copy the Output Role ARN

   • Once the stack is complete, click on the stack's name.
   • Navigate to the Outputs tab.
   • You will see a value listed (often named RoleArn or similar). Copy this full ARN value (it will look like arn:aws:iam::123456789012:role/YourNewRole).

6. Complete the Integration

   • Return to your application's Add AWS Account modal.
   • Paste the copied ARN into the Role Name * field.
   • Click the Save button (do not click "Connect Via AWS Console" again).

Configuration Fields

• Display Name * (Required)

  • A friendly name you provide to identify this account connection.

• Role Name * (Required)

  • The Amazon Resource Name (ARN) of the IAM role that allows access. This value is generated by the CloudFormation stack and must be copied from the stack's Outputs tab in the AWS Console.