Overview & Objectives

Purpose:

This document describes how to onboard an AWS Organization (i.e. the master account plus member accounts) into ARMO Platform. The goal is to enable unified visibility, governance, and security controls across all AWS accounts under that Organization.

Prerequisites

High-Level Onboarding Flow

Here’s the sequence of steps at a high level:

1. In ARMO Platform: initiate the connect Amazon Web Services Organization flow.
2. In the AWS management (root / payer) account: create an IAM role (the “ARMO Organization Role”) with a trust policy and attach the required permissions.
3. Configure that role as the organization-level connection in ARMO.
4. ARMO will detect all member accounts and propagate read only roles into them.
5. ARMO can access all accounts and resources for scanning purpose
6. The data is being ingested correctly and present in the ARMO platform.

Detailed Step-by-Step Onboarding

Step 1: Start in ARMO

1. Log in to the ARMO Platform and navigate to Settings → Accounts → AWS
2. Click the Amazon Web Services card select Entire Organization as the type of cloud account to onboard.
3. Choose the Security features (Compliance, Vulnerabilities ) and click next
4. Choose an AWS Region to launch your stack, and click Launch Stack
5. The AWS console will present you with a CloudFormation template, IAM trust policy, and instructions to deploy in AWS

Step 2: Create IAM Role in AWS Management Account

In the AWS management account:

1. Provide a stack name, e.g. armo-org-discovery-stack
2. Scroll to the bottom and Mark the «I acknowledge that AWS CloudFormation might create IAM resources with custom names»
3. Click “Create stack”
4. Navigate to the Outputs tabs (The RoleARN may take up to a minute to appear)
5. Copy the RoleARN value

Step 3: Configure the Role in ARMO Platform

1. Back in ARMO, paste the Role ARN of the role you just created (e.g. arn:aws:iam::<management_account_id>:role/armo-org-discovery-role).
2. Click Next
3. ARMO will attempt to assume that role in the management account and list all AWS accounts in the Organization.

Step 4: Onboard Member Accounts

ARMO uses AWS CloudFormation StackSets to connect to your AWS Organization by deploying a read-only IAM role across all accounts in one operation

1. Click on ״Launch StackSet״ to continue and follow the steps on the ARMO connection wizard
   1. The AWS console will present you with a Create StackSet wizard
   2. For each member account, deploy a delegated IAM role (e.g. ArmoSecurityCloudMemberRole) with the required read only permissions
2. Back in ARMO, Click Next
3. Enter a Display name for the organization
4. (Optional) enter account ids you would like to exclude
5. Click Connect organization

Step 5: Confirm Data Ingestion & Monitoring

• In ARMO, verify that all accounts under the AWS Organization appear in the Settings / Accounts / AWS table.
• Check that ARMO is showing the scanning results on the Compliance or Host pages (depending to the feature selection)
• Validate data freshness (e.g. that ARMO is syncing on its schedule).

---

Troubleshooting