AWS organizations: Clarify OrganizationAccountAccessRole creation and custom naming
Summary
Expands the description of the automatically created cross-account IAM role: it is now created via console, CLI, or CreateAccount API, its name is customizable, and it is not auto-created in invited or project accounts.
Security assessment
The change documents an IAM role that carries full administrative permissions in member accounts and is assumable by all principals in the management account. It clarifies creation paths and naming but does not fix a vulnerability or introduce new security guidance, so it is security-adjacent IAM documentation only.
Evidence
+When you create a member account by using the AWS Organizations console, the AWS CLI, or the `CreateAccount` API operation, AWS Organizations _automatically_ creates an IAM role in the account. By default, this role is named `OrganizationAccountAccessRole`. You can specify a different name when you create the account. This role has full administrative permissions in the member account. The scope of access for this role includes all principals in the management account, such that the role is configured to grant that access to the organization's management account.
Diff
diff --git a/organizations/latest/userguide/orgs_manage_accounts_access-cross-account-role.md b/organizations/latest/userguide/orgs_manage_accounts_access-cross-account-role.md index db3a630..5b27538 100644 --- a//organizations/latest/userguide/orgs_manage_accounts_access-cross-account-role.md +++ b//organizations/latest/userguide/orgs_manage_accounts_access-cross-account-role.md @@ -9 +9 @@ -When you create a member account using the AWS Organizations console, AWS Organizations _automatically_ creates an IAM role named `OrganizationAccountAccessRole` in the account. This role has full administrative permissions in the member account. The scope of access for this role includes all principals in the management account, such that the role is configured to grant that access to the organization's management account. +When you create a member account by using the AWS Organizations console, the AWS CLI, or the `CreateAccount` API operation, AWS Organizations _automatically_ creates an IAM role in the account. By default, this role is named `OrganizationAccountAccessRole`. You can specify a different name when you create the account. This role has full administrative permissions in the member account. The scope of access for this role includes all principals in the management account, such that the role is configured to grant that access to the organization's management account. @@ -11 +11 @@ When you create a member account using the AWS Organizations console, AWS Organi -You can create an identical role for an invited member account by following the steps in [Creating OrganizationAccountAccessRole for an invited account with AWS Organizations](./orgs_manage_accounts_create-cross-account-role.html). +AWS Organizations doesn't automatically create this role in invited member accounts or in project accounts, which you created as projects in AWS Settings. You can create an identical role in these accounts by following the steps in [Creating OrganizationAccountAccessRole for an invited account with AWS Organizations](./orgs_manage_accounts_create-cross-account-role.html).