AWS Security ChangesHomeSearch

AWS cli medium security documentation change

Service: cli · 2025-11-13 · Security-related medium

File: cli/latest/reference/sts/assume-root.md

Summary

Added security requirements for AssumeRoot operation including credential restrictions and security best practices guidance

Security assessment

The change explicitly prohibits using root user credentials for AssumeRoot and adds guidance about least privilege permissions and SCP usage. This addresses potential security risks from credential misuse and overprivileged access.

Diff

diff --git a/cli/latest/reference/sts/assume-root.md b/cli/latest/reference/sts/assume-root.md
index bb3f9a68e..146b46f8c 100644
--- a//cli/latest/reference/sts/assume-root.md
+++ b//cli/latest/reference/sts/assume-root.md
@@ -15 +15 @@
-  * [AWS CLI 2.31.32 Command Reference](../../index.html) »
+  * [AWS CLI 2.31.35 Command Reference](../../index.html) »
@@ -60 +60 @@ First time using the AWS CLI? See the [User Guide](https://docs.aws.amazon.com/c
-Returns a set of short term credentials you can use to perform privileged tasks on a member account in your organization.
+Returns a set of short term credentials you can use to perform privileged tasks on a member account in your organization. You must use credentials from an Organizations management account or a delegated administrator account for IAM to call `AssumeRoot` . You cannot use root user credentials to make this call.
@@ -69,0 +70,2 @@ You can track AssumeRoot in CloudTrail logs to determine what actions were perfo
+When granting access to privileged tasks you should only grant the necessary permissions required to perform that task. For more information, see [Security best practices in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) . In addition, you can use [service control policies](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) (SCPs) to manage and limit permissions in your organization. See [General examples](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps_examples_general.html) in the _Organizations User Guide_ for more information on SCPs.
+
@@ -116 +118 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/sts-20
-> The identity based policy that scopes the session to the privileged tasks that can be performed. You can use one of following Amazon Web Services managed policies to scope root session actions.
+> The identity based policy that scopes the session to the privileged tasks that can be performed. You must use one of following Amazon Web Services managed policies to scope root session actions:
@@ -357 +359 @@ SourceIdentity -> (string)
-  * [AWS CLI 2.31.32 Command Reference](../../index.html) »
+  * [AWS CLI 2.31.35 Command Reference](../../index.html) »