AWS Security ChangesHomeSearch

AWS wellarchitected: AWS WA Agent auto-creates roles for current-account monitoring

Service: wellarchitected · 2026-10-23 · Documentation medium

File: wellarchitected/latest/userguide/agent-concepts.md · Type: iam

Summary

Adds a sentence in two places (profile setup and role-naming sections) stating that when you choose to monitor only the current account during profile creation, AWS WA Agent automatically creates both the execution role and the access role, so no manual role creation is needed.

Security assessment

The added text clarifies IAM role provisioning behavior: for current-account-only monitoring the service auto-creates the execution role and the access role that otherwise would be created and linked manually via trust policies. This changes the identity/permission footprint an operator must reason about (fewer manually managed roles and trust policies), which is security-relevant configuration guidance, but it neither fixes a vulnerability nor references any incident/CVE.

Evidence

When you create a profile, you can create an execution role during the setup process or select an existing one. You create access roles in your workload accounts before or after profile creation, then link them by updating the access role trust policies. If you choose to monitor only the current account during profile creation, AWS WA Agent creates both the execution role and the access role automatically, so you don't need to create any roles manually.

Diff

diff --git a/wellarchitected/latest/userguide/agent-concepts.md b/wellarchitected/latest/userguide/agent-concepts.md
index 8d99ea1..3ccf9f9 100644
--- a//wellarchitected/latest/userguide/agent-concepts.md
+++ b//wellarchitected/latest/userguide/agent-concepts.md
@@ -23 +23 @@ AWS Well-Architected Tool also has a feature named profiles. AWS WA Tool profile
-When you create a profile, you can create an execution role during the setup process or select an existing one. You create access roles in your workload accounts before or after profile creation, then link them by updating the access role trust policies.
+When you create a profile, you can create an execution role during the setup process or select an existing one. You create access roles in your workload accounts before or after profile creation, then link them by updating the access role trust policies. If you choose to monitor only the current account during profile creation, AWS WA Agent creates both the execution role and the access role automatically, so you don't need to create any roles manually.
@@ -51 +51 @@ Neither role grants AWS WA Agent permission to modify your resources. The execut
-You can use the same role name across all workload accounts (common name pattern) or use different names per account (per-account ARN). During profile creation, you specify which approach you are using.
+You can use the same role name across all workload accounts (common name pattern) or use different names per account (per-account ARN). During profile creation, you specify which approach you are using. If you choose to monitor only the current account, AWS WA Agent creates both the execution role and the access role automatically, so you don't need to create any roles manually.