Saltar al contenido

¿Cómo puedo solucionar el error de AWS STS "the security token included in the request is expired" cuando uso AWS CLI para asumir un rol de IAM?

6 minutos de lectura
0

He intentado asumir un rol de AWS Identity and Access Management (IAM) mediante la Interfaz de la línea de comandos de AWS (AWS CLI). Se muestra el error "security token included in the request is expired".

Descripción corta

Solicita credenciales de seguridad temporales para los usuarios de IAM con AWS Security Token Service (AWS STS). Las credenciales temporales que se crean con la acción de la API AssumeRole duran de 1 a 12 horas. La duración de las credenciales temporales depende de la duración de la sesión del rol que configures para el rol de IAM. Una vez vencidas las credenciales temporales, no se pueden volver a utilizar. Para obtener más información, consulta Credenciales de seguridad temporales en IAM.

Resolución

Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulta Solución de errores para la AWS CLI. Además, asegúrate de utilizar la versión más reciente de AWS CLI.

Cómo asegurarse de que las solicitudes de credenciales de seguridad temporales puedan conectarse a los puntos de enlace de AWS

Para establecer las credenciales de un rol, es necesario tener un ID de clave de acceso, una clave de acceso secreta y un token de sesión. Las solicitudes deben llegar al punto de enlace de AWS en un plazo de cinco minutos a partir de la marca temporal de la solicitud o, de lo contrario, se denegará la solicitud. Para obtener más información, consulta Por qué se firman las solicitudes.

Uso de perfiles para asumir un rol de IAM

Un perfil con nombre es un conjunto de configuraciones y credenciales que puedes aplicar a un comando de AWS CLI. Comprueba que se están utilizando las credenciales correctas.

El siguiente comando de AWS CLI usa las credenciales de perfil predeterminadas:

aws s3 ls

Este comando de ejemplo usa las credenciales del perfil project1 configuradas en el archivo .config:

aws s3 ls --profile project1

Ejemplo de salida con credenciales vencidas:

"An error occurred (ExpiredToken) when calling the ListBuckets operation: The provided token has expired."

Estos perfiles se definen en los archivos credentials y config de la carpeta .aws.

El archivo de configuración se encuentra en ~/.aws/config en Linux/macOS y en C:\Users\%USERPROFILE%\.aws\config en Windows. El archivo de credenciales se encuentra en ~/.aws/credentials en Linux/macOS y en C:\Users\%USERPROFILE%\.aws\credentials en Windows.

Para comprobar las credenciales de perfil predeterminadas, ejecuta el siguiente comando:

aws configure list --profile default

Resultado de ejemplo:

Name Value Type Location
---- ----- ---- --------
profile default manual —profile
access_key TGN7 shared-credentials-file
secret_key SbXb shared-credentials-file
region us-east-1 config-file ~/.aws/config

Para confirmar que se utilizan las mismas credenciales para el perfil project1, ejecuta el siguiente comando:

aws configure list --profile project1

Resultado de ejemplo:

Name Value Type Location
---- ----- ---- --------
profile project1 manual —profile
access_key QN2X config-file
secret_key LPYI config-file
region eu-west-1 config-file ~/.aws/config

En el resultado de ejemplo, ten en cuenta que se pueden configurar diferentes credenciales para los perfiles predeterminados y project1.

Puedes crear un perfil en el archivo .aws/config con el siguiente formato:

[profile project1]
region = eu-west-1
aws_access_key_id =
aws_secret_access_key = <secret-access-Key-for-an-IAM-role>
aws_session_token = <session-token>

Puedes crear un perfil en el archivo .aws/credentials con el siguiente formato:

[project1]region = eu-west-1  
aws_access_key_id = <access-Key-for-an-IAM-role>  
aws_secret_access_key = <secret-access-Key-for-an-IAM-role>  
aws_session_token = <session-token>

Estas credenciales se proporcionan cuando ejecutas el comando de AWS STS assume-role similar al siguiente:

aws sts assume-role --role-arn arn:aws:iam::<account-number>:role/Prod-Role --role-session-name environment-prod

Resultado de ejemplo:

{
"AssumedRoleUser": {
"AssumedRoleId": "AROAXXXXXXXXXXXX:environment-prod",
"Arn": "arn:aws:sts::<account-number>:assumed-role/Prod-Role/environment-prod"
},
"Credentials": {
"SecretAccessKey": "<secret-access-Key-for-an-IAM-role>,
"SessionToken": "<session-token>",
"Expiration": "2020-03-31T17:17:53Z",
"AccessKeyId": "<access-Key-for-an-IAM-role>"
}

Nota: Puedes aumentar la duración máxima del vencimiento de la sesión para las credenciales temporales de los roles de IAM con el parámetro DurationSeconds. Sin embargo, si usas una cadena de roles, la duración máxima de la sesión de roles es de 1 hora.

La nueva llamada a la API assume-role recupera un nuevo conjunto de credenciales válidas. Tras la llamada a la API, debes actualizar manualmente el archivo ~/.aws/config con las nuevas credenciales temporales.

Puedes evitar actualizar el archivo de configuración cada vez que venza una sesión. Define un perfil para el rol de IAM junto con el usuario que asuma ese rol en el archivo ~/.aws/config o en ~/.aws/credentials, similar al siguiente:

[profile project1] role_arn = <arn-of-IAM-role>
source_profile = user1
region = <region>

Ten en cuenta que user1 se define en el archivo ~/.aws/credentials de forma similar a la siguiente:

[user1]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Si defines source_profile, no tienes que actualizar las credenciales temporales en el archivo ~/.aws/config o en ~/.aws/credentials.

El siguiente comando de AWS CLI muestra los buckets de Amazon Simple Storage Service (Amazon S3) con credenciales para user1 que se encuentran en el archivo ~/.aws/credentials.

aws s3 ls --profile project1

Si utilizas AWS CLI con un elemento source_profile, la llamada a la API assume-role coloca las credenciales en el archivo .aws/cli/cache. Las credenciales vencidas se actualizan automáticamente en el archivo .aws/cli/cache. Si se muestra un error por las credenciales vencidas, puedes borrar la memoria caché con los siguientes comandos:

Linux/macOS:

rm -r ~/.aws/cli/cache

Windows:

C:\> del /s /q %UserProfile%\.aws\cli\cache

AWS CLI crea nuevas credenciales en la caché.

Cómo crear variables de entorno para asumir el rol de IAM y comprobar el acceso

Puedes usar las credenciales del rol de IAM para crear tres variables de entorno que asuman el rol de IAM de forma similar a la siguiente:

Linux/macOS:

export AWS_ACCESS_KEY_ID=RoleAccessKeyID
export AWS_SECRET_ACCESS_KEY=RoleSecretKey
export AWS_SESSION_TOKEN=RoleSessionToken

Windows:

C:\> setx AWS_ACCESS_KEY_ID RoleAccessKeyID
C:\> setx AWS_SECRET_ACCESS_KEY RoleSecretKey
C:\> setx AWS_SESSION_TOKEN RoleSessionToken

Para comprobar si has asumido el rol de IAM correcto, ejecuta el siguiente comando:

aws sts get-caller-identity

El comando get-caller-identity muestra información sobre la identidad de IAM que se usa para autenticar la solicitud. Para obtener más información, consulta ¿Cómo puedo asumir un rol de IAM mediante la AWS CLI?

Las variables de entorno mantienen las credenciales temporales almacenadas en caché incluso después de que caducan y no se renuevan automáticamente. Utiliza los siguientes comandos para comprobar si las variables de entorno de credenciales están configuradas:

Linux/macOS:

printenv | grep AWS

Windows:

C:\>set AWS

Puedes eliminar las variables de entorno caducadas con los siguientes comandos:

Linux/macOS:

unset AWS_ACCESS_KEY_ID
unset AWS_SECRET_ACCESS_KEY
unset AWS_SESSION_TOKEN

Windows:

C:\>set AWS_ACCESS_KEY_ID=
C:\>set AWS_SECRET_ACCESS_KEY=
C:\>set AWS_SESSION_TOKEN=

Ahora puedes volver a utilizar la llamada a la API assume-role para obtener credenciales nuevas y válidas y volver a configurar las variables de entorno.

Nota: Los archivos .aws/credentials y .aws/config contienen los detalles de las credenciales de las entidades de IAM. Al administrar tus credenciales, asegúrate de seguir las prácticas recomendadas de seguridad de IAM.

Información relacionada

Solicitud de credenciales de seguridad temporales

Actualizar la duración máxima de la sesión para un rol

¿Cómo soluciono el error "The security token included in the request is expired" al usar aplicaciones de Java en Amazon EC2?