Assume Role (STS)
Conéctate con credenciales temporales de un rol de IAM en cualquier cuenta. DynamoOps llama a sts:AssumeRole por ti, muestra una cuenta regresiva de la sesión en vivo y permite renovarla con un clic.
Cuándo usarlo
Usa Assume Role cuando tus credenciales locales pertenecen a una cuenta (o usuario) y las tablas están detrás de un rol de IAM, normalmente en otra cuenta. DynamoOps realiza la misma llamada a STS que harías con aws sts assume-role y luego conecta DynamoDB con las credenciales temporales devueltas. Tus claves de largo plazo solo se usan para llamar a STS.
aws sts assume-role \
--role-arn arn:aws:iam::123456789012:role/DevelopersRole \
--role-session-name dev-session \
--duration-seconds 3600 \
--profile defaultCampos
- Account ID12 dígitosobligatorio
- La cuenta de AWS de destino. Los guiones se eliminan automáticamente.
- Role Nametextobligatorio
- El rol que se asumirá, por ejemplo
DevelopersRole. DynamoOps construye el ARNarn:aws:iam::<account>:role/<name>. - AWS Profiletext
- El perfil local cuyas credenciales llaman a STS.
defaulto vacío usa la cadena predeterminada del SDK. - Regionselectobligatorio
- Se usa como región de STS y también como la región de DynamoDB a la que te conectas.
- Environmenttoggle
- None, Dev, Staging o Prod. Se muestra como una insignia en el encabezado después de conectarte.
- Session Nametext
- Opcional. Aparece en CloudTrail como nombre de la sesión del rol. El valor predeterminado es
dev-session. - Save profilecheckbox
- Guarda esta configuración con un nombre en Saved Profiles.
Conectarse
- Completa la cuenta y el rol
Escribe el Account ID de 12 dígitos y el Role Name, y luego elige la región y el perfil local.
- Haz clic en Assume Role & Connect
DynamoOps solicita credenciales válidas por una hora, las valida con una llamada a
ListTablesy cambia toda la app al rol asumido. - Verifica la insignia
El encabezado muestra 🛡️ <RoleName> (mm:ss) con una cuenta regresiva en vivo, la insignia de proveedor ☁ AWS <region> y tu etiqueta de entorno.
Si faltan tanto la cuenta como el rol, DynamoOps te pide completarlos antes de llamar a AWS. Cualquier error de STS se muestra debajo del formulario, por ejemplo “Assume Role failed: User … is not authorized to perform: sts:AssumeRole on resource …” (el usuario no está autorizado a ejecutar sts:AssumeRole sobre el recurso).
Vencimiento y renovación de la sesión
Las credenciales de STS vencen después de una hora. DynamoOps te mantiene informado y te permite renovarlas sin salir del espacio de trabajo.
| Cuándo | Qué ocurre |
|---|---|
| Durante toda la sesión | La insignia del rol muestra la cuenta regresiva hasta el vencimiento y se actualiza cada segundo. |
| 5 minutos antes del vencimiento | Un diálogo avisa que la sesión está por vencer y ofrece renovarla ahora o ignorar el aviso. |
| Renovar | DynamoOps vuelve a ejecutar AssumeRole con los mismos parámetros. Como cualquier conexión nueva, esto cierra las pestañas abiertas y recarga la lista de tablas. |
| Unos 10 segundos después del vencimiento | Si ignoraste el aviso y el diálogo sigue abierto, se convierte en un aviso bloqueante con una única acción de renovar. Si la renovación falla, vuelves a la pantalla de inicio de sesión. |
| Ignorado por completo | No hay más avisos. Las llamadas a la API empiezan a fallar cuando AWS rechaza las credenciales vencidas; vuelve a conectarte desde la pantalla de inicio de sesión. |
Historial de roles
Debajo del formulario, DynamoOps conserva las últimas diez combinaciones distintas de rol y perfil que asumiste, de la más reciente a la más antigua. Cada entrada muestra el nombre del rol, el ID de la cuenta, el perfil local (cuando no es default) y la etiqueta de entorno, con un color según el entorno. Al hacer clic en una entrada se completa el formulario, así que solo tienes que presionar Assume Role & Connect.
Atajo ante acceso denegado
Si te conectas con credenciales que no tienen dynamodb:ListTables, la barra lateral reemplaza la lista de tablas por un aviso de acceso denegado que indica el principal de IAM y un botón que te lleva directamente a la pestaña Assume Role. Es la forma más rápida de recuperarte cuando un perfil base solo puede asumir roles y no tiene permisos propios de DynamoDB.
- Permiso mínimo en el principal base:
sts:AssumeRolesobre el rol de destino. - Permiso mínimo en el rol de destino:
dynamodb:ListTablesmás lo que requieran las tablas que abras. - Encontrarás todos los detalles sobre dónde se guardan las credenciales en Seguridad y privacidad.