AWS cli documentation change
Summary
Added examples section with two usage examples for the 'aws login' command and updated CLI version reference
Security assessment
The change adds practical examples for using the 'aws login' command, which is an authentication feature. While this documents security-related functionality (authentication), there is no evidence it addresses a specific security issue. The examples show both local and remote authentication scenarios.
Diff
diff --git a/cli/latest/reference/login/index.md b/cli/latest/reference/login/index.md index 94dc85b3a..fe40a7109 100644 --- a//cli/latest/reference/login/index.md +++ b//cli/latest/reference/login/index.md @@ -15 +15 @@ - * [AWS CLI 2.34.16 Command Reference](../../index.html) » + * [AWS CLI 2.34.19 Command Reference](../../index.html) » @@ -34,0 +35 @@ + * Examples @@ -197,0 +199,46 @@ The formatting style for error output. By default, errors are displayed in enhan +## Examples¶ + +**Example 1: To login with default parameters** + +The following `login` example authenticates the CLI using your AWS Console session. A browser window opens automatically to complete the sign-in. + + + aws login + + +Output: + + + Attempting to open your default browser. + If the browser does not open, open the following URL: + + https://signin.aws.amazon.com/... + + Updated profile default to use arn:aws:sts::123456789012:assumed-role/my-role/my-session-name credentials. + + +For more information, see [Login for AWS local development using console credentials](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sign-in.html) in the _AWS CLI User Guide_. + +**Example 2: To login from a remote host** + +The following `login` example uses the `--remote` option to authenticate from a host where a browser is not available, such as over SSH. You visit the provided URL on another device and paste the authorization code back into the CLI. + + + aws login --remote + + +Output: + + + Browser will not be automatically opened. + Please visit the following URL: + + https://signin.aws.amazon.com/... + + Enter the authorization code displayed in your browser: XXXX + + Updated profile default to use arn:aws:sts::123456789012:assumed-role/my-role/my-session-name credentials. + + +For more information, see [Login for AWS local development using console credentials](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sign-in.html) in the _AWS CLI User Guide_. + @@ -208 +255 @@ The formatting style for error output. By default, errors are displayed in enhan - * [AWS CLI 2.34.16 Command Reference](../../index.html) » + * [AWS CLI 2.34.19 Command Reference](../../index.html) »