¿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?
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
- Etiquetas
- AWS Identity and Access Management
- Idioma
- Español

This article was reviewed and updated on 2026-04-01.
Contenido relevante
preguntada hace un año
- Como solucionar el error: Supplied Policy document is breaching Cloudwatch Logs policy length limit.Respuesta aceptada
preguntada hace 2 años
preguntada hace un año
OFICIAL DE AWSActualizada hace 7 meses