--- title: "Onboarding AWS Accounts to CloudLabs" slug: "onboarding-aws-accounts-to-cloudlabs" updated: 2025-07-02T12:56:53Z published: 2025-07-02T12:56:53Z canonical: "help.cloudlabs.ai/onboarding-aws-accounts-to-cloudlabs" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.cloudlabs.ai/llms.txt > Use this file to discover all available pages before exploring further. # Onboarding AWS Accounts to CloudLabs ## Overview[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#overview) We will learn how to set up and onboard AWS accounts to CloudLabs AI platform. ## Pre-requisites:[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#pre-requisites) - AWS Root account and login credentials We only need the AWS Root Account to begin the initial setup, and we'll take care of the rest later. ## Please follow the steps given below and get stared with the setup:[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#please-follow-the-steps-given-below-and-get-stared-with-the-setup) 1. Login to [**AWS console**](https://console.aws.amazon.com/) with **Root Account** credentials. 2. Once logged in, select **My Organization** from the drop-down menu next to the organisation name on the right top. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aws1.png) 1. Click on **Add an AWS account** under Organization. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aws2.png) 1. Choose **Create an AWS Account** and fill all the details asked in this form. - AWS account name: Give your AWS account a name, such as **Contoso-Labs-001**. (**Note**: Using a sequential number along with the account name is recommended.) - Email: [**accountName@domain.com**](mailto:accountName@domain.com) - IAM role name: Keep default role i.e. **OrganizationAccountAccessRole** - Finally click the **Create AWS account** button. **If you want to establish more AWS accounts, repeat steps 3–4.** 1. Note down the **Account ID** for future reference once the account has been successfully created. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aws3.png) ## Include the newly created accounts in the root account's access list.[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#include-the-newly-created-accounts-in-the-root-accounts-access-list) For each newly created account, you must now add a group and inline policy. 1. Navigate to **Identity and Access Management (IAM)** and select **User groups** 2. Now, click on **Create Group** button to create a new groups 3. Name the group **MemberAccountAdmins**. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/img5.png) 1. Goto **permissions** and click on **create inline policy** under Add permissions. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/img6(1).png) 1. Choose **JSON** and place the below policy. You should update you **Account ID** in it. ```json "arn:aws:iam::NEW_ACCOUNT_ID:role/OrganizationAccountAccessRole ``` ```json {    "Version": "2012-10-17",    "Statement": [        {            "Sid": "Stmt1508134114000",            "Effect": "Allow",            "Action": [                "sts:AssumeRole"            ],            "Resource": [                "arn:aws:iam:::role/OrganizationAccountAccessRole",                "arn:aws:iam:::role/OrganizationAccountAccessRole",                "arn:aws:iam:::role/OrganizationAccountAccessRole"            ]        }    ] } ``` > [!WARNING] > **Note**: You must add the same number of roles as you have accounts, i.e. one role per account and each role should have account ID in it. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/img7.png) 1. Click on **review** policy and then **create policy** ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/img8.png) **If you plan to create additional AWS accounts after implementing inline policy, make sure to change the policy and add role with new Account ID.** ## Setup Admin Group and add administrator access policy to it.[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#setup-admin-group-and-add-administrator-access-policy-to-it) 1. Go to Identity and Access Management (IAM) and click select **Groups** 2. Click on **Create Group** and enter name for group such as **Admins** 3. Goto Attach permissions policies and search for **AdministratorAccess** and select the same from the list. 4. Click on **Create Group** ## Setup IAM user account and add it to the Admins group you just created.[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#setup-iam-user-account-and-add-it-to-the-admins-group-you-just-created) 1. Click on **users** under Access Management and click on **Add user** to add a new IAM user 2. User name: give IAM user a name such as **admin-user** 3. Select access type: - Enable **Access Key - Programmatic access** & **Password - AWS Management Console access** - Console Password you can choose either autogenerated password or custom Password. - Require password reset: you can disable this check box to avoid the reset password at next login. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aw1.png) 1. Click **Next permissions** ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aw1a.png) 1. Set **admin** permission for this user by selecting **Admins** group and then click on **Next: tags** 2. Tags are optional, you can leave them blank or enter any value here, then click **Review** and **Create User**. > [!WARNING] > **Note: Please make sure to copy the Access Key and Secret Key that has been generated.This would be required later.** > [!WARNING] > **Note: You'll need this user to switch roles on newly generated accounts and get their access key and secret key, which are required to onboard the accounts to CloudLabs Platform.** ## Create a admin user and keys in the new accounts.[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#create-a-admin-user-and-keys-in-the-new-accounts) 1. Login to [**AWS console as an IAM user**](https://console.aws.amazon.com/) with **admin-user** user credentials you just created in the above section. 2. To login, you will need your Root account ID and IAM admin-user credentials. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aws12.png) 1. Now, use the **drop-down** on the IAM user available on the right top to **switch roles** to newly created account OR target account. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aws13.png) 1. Enter the details as below: - Account: Enter your newly created AWS account's **accountID.** - Role: Enter role name as **OrganizationAccountAccessRole** - Leave all other fields empty and click on **swich role** ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aw2.png) > Now that you're inside your newly created account, you'll need to create an admin user with access to the account, as well as secret keys. 1. Go to Identity and Access Management (IAM) and create new user by clicking on **add user**, name it **dev-admin**. 2. Enable **programmatic access** as the access type to create the access key and secret key. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/aw3.png) 1. Click on **Next: Permissions** 2. Add **dev-admin** user to **Admins** group and then click on **Next: tags** ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/img10(2).png) 1. Tags are optional, you can leave them blank or enter any value here, then click **Review** and **Create User**. 2. After confirmation, the newly created Access Key and Secret Key will be available. Save these. The Secret Key will not be available afterwards. > [!TIP] > **Repeat steps 3–10 for each newly created AWS account, being sure to keep the access keys and secret keys noted.** #### Once all AWS accounts are created and assigned with the required permissions, onboard those accounts to CloudLabs AI platform.[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#once-all-aws-accounts-are-created-and-assigned-with-the-required-permissions-onboard-those-accounts-to-cloudlabs-ai-platform) i. Select the Subscriptions tab from the right-hand menu and then click on **+ ADD button** to add subscription group for AWS accounts. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/img8(1).png) ii. Next, create a subscription group by filling in the details like image below: ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/sub1.png) - Cloud Platform: Choose **Amazon Web Services** from the drop-down. - Cloud Provider Billing Type: Choose **Amazon Web Service(AWS)** from the drop-down. - Labs Rate Card: Choose **AWS** from the drop-down. iii. Next, Click on the settings Icon to the right of the Subscription group name you just created. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/sub5.png) iv. Next, Click on **+ ADD ACCOUNT** to add subscription to the subscription group. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/sub2.png) v. Next, we can add the **Account Friendly Name**, **Account Id**, **Access Key**, **Secret Key** and click on **SUBMIT**. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/sub3.png) ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/sub4.png) You can repeat the steps (i) to (v) if you have more subscriptions to onboard. > [!WARNING] > **Note:** If you need to onboard the subscriptions in BULK, you can share these details with us, and we'll be happy to assist you with the backend onboarding. ## Steps to create cost and usage report in AWS[​](https://docs.cloudlabs.ai/LabDeveloper/OnboardingAWSAccountstoCloudLabs#steps-to-create-cost-and-usage-report-in-aws) 1. Now, go back to the AWS Root account & search for Billing in AWS services section. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost1.png) 1. Navigate to **cost and usage reports** on the left tab as mentioned in the image below and open it. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost2.png) 1. Click on **create report**. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost3.png) 1. Give your report a name example Test-Report and leave the rest of the settings as default. Click **Next**. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost4.png) 1. **Configure(1)** a S3 bucket for reports by clicking on **configure** button. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost5.png) 1. Create new **S3 bucket name (2)** or use any previous bucket where you want to make cost and usage reports to be available. In this case we are creating a new bucket and selecting a **Region(3)** as well where our bucket should be created. Click **Next(4)**. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost6.png) 1. After Clicking on Next, we need to click on **Checkbox(5)** to acknowledge the policy and then click on **Save(6)**. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost7.png) 1. (a) For **Report path prefix**, enter the report path prefix that you want prepended to the name of your report. You can put any prefix word like here we have added Test. (b) For **Time Granularity**, we can put on hour basis, monthly basis, or yearly basis, hereby we have added on hourly basis. (c). For **Report versioning**, we can either continue data entry on previous reports or we can create new one, hereby we have chosen the format of new report version. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost8.png) (d) Then choose compression type, hereby we have chosen **ZIP** format. Then click **Next**. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost9.png) 1. You can review the data at last page and make changes if anything is required. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost10.png) 1. Click **Review & Create** if no changes are required. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost11.png) 1. On the Billing Service main screen, you will be able to see your Cost and Usage report, and within the next 24 hrs you will start getting your first report. ![](https://cdn.document360.io/eb22e69b-92a3-4c63-861d-5b53dc9d04c5/Images/Documentation/awcost12.png) 1. Please create an excel file with below details and send it over to CloudLabs so we can start generating reports. **Name:** [a nick name for billing configuration] **OrganizationId:** [root account Id] **AccessKey:** [access key of admin IAM user] **SecretKey:** [secret key of admin IAM user] **BucketName:** [name of the bucket created for cost and usage report] **BucketRegion:** [region of the bucket created for cost and usage report] **ReportName:** [name of the cost and usage report]