AWS SSO (IAM Identity Center)
Inicia sesión en el navegador a través del portal de acceso de AWS de tu organización, elige una cuenta y un permission set, y deja que DynamoOps renueve las credenciales del rol en segundo plano mientras dure tu sesión.
Cómo funciona
La pestaña AWS SSO implementa el mismo flujo de autorización de dispositivo de OAuth 2.0 que aws sso login. DynamoOps se registra como cliente OIDC en IAM Identity Center, abre la página de verificación de AWS en tu navegador predeterminado y espera a que apruebes la solicitud. Una vez aprobada, lista las cuentas y los permission sets (conjuntos de permisos) a los que tienes acceso, obtiene credenciales de rol de corta duración para el que elijas y se conecta. En ningún momento intervienen claves de acceso.
aws sso login en ~/.aws/sso/cache, DynamoOps lo reutiliza y se salta por completo el paso del navegador. Verás el aviso “Reusing your aws sso login session” (reutilizando tu sesión de aws sso login).Paso 1 — URL de inicio y regiones
- From ~/.aws/configchips
- Un chip por cada perfil con SSO encontrado en tu configuración de AWS (perfiles con
sso_start_urlo unsso_session). Al hacer clic en un chip se completan la URL de inicio y las regiones, y se recuerdan la cuenta y el rol para preseleccionarlos. - SSO start URLurlobligatorio
- Tu portal de acceso, por ejemplo
https://my-org.awsapps.com/start. El esquema se agrega y las barras finales se eliminan automáticamente. - SSO regionselectobligatorio
- La región donde IAM Identity Center está habilitado para tu organización.
- DynamoDB regionselectobligatorio
- La región cuyas tablas quieres abrir después de iniciar sesión.
- Environmenttoggle
- None, Dev, QA, Staging o Prod.
La última URL de inicio, las regiones, la cuenta y el rol que usaste se recuerdan y se completan la próxima vez que abras la pestaña. Presiona 🌐 Sign in with AWS in browser (o Enter en el campo de la URL) para continuar.
[profile prod-admin]
sso_session = my-org
sso_account_id = 123456789012
sso_role_name = AdministratorAccess
region = eu-west-1
[sso-session my-org]
sso_start_url = https://my-org.awsapps.com/start
sso_region = us-east-1Paso 2 — Aprueba en el navegador
- Se abre una pestaña del navegador
Aparece la página de verificación de AWS con el código del dispositivo ya completado. DynamoOps muestra el mismo código de confirmación en pantalla para que puedas compararlos.
- Inicia sesión y aprueba
Autentícate con tu proveedor de identidad si se te solicita y luego aprueba la solicitud de “DynamoOps”.
- Vuelve a la app
DynamoOps consulta a AWS cada pocos segundos y avanza automáticamente. Usa Open the page again si cerraste la pestaña, o Cancel para volver.
La solicitud sigue siendo válida durante unos diez minutos. Si vence, se rechaza o se pierde, vuelves al formulario con un mensaje claro y puedes intentarlo de nuevo.
Paso 3 — Elige una cuenta y un rol
Después de la aprobación, el panel muestra “Signed in to <your portal host>” (sesión iniciada en el host de tu portal) y dos selectores.
- AWS account — todas las cuentas asignadas a tu usuario de SSO, listadas como “Nombre (id)” y ordenadas por nombre.
- Role — los permission sets disponibles en la cuenta seleccionada. Al cambiar la cuenta se recarga la lista.
- Save profile — opcionalmente, guarda esta URL de inicio, la cuenta y el rol con un nombre para reconectarte con un clic.
Haz clic en Connect. DynamoOps obtiene las credenciales del rol, las valida con ListTablesy muestra el aviso “Signed in as <role> @ <account>” (sesión iniciada como rol @ cuenta). El encabezado muestra una insignia 🛡️ <role> sin cuenta regresiva, porque la renovación es automática.
Dos enlaces te ayudan a gestionar la sesión: ← Change start URL vuelve al paso 1 conservando el token en caché, y Forget this SSO session elimina el token que DynamoOps guardó en caché para ese portal, de modo que el siguiente inicio de sesión vuelva a abrir el navegador. La caché propia de AWS CLI nunca se modifica.
Duración de la sesión
| Credencial | Duración | Renovación |
|---|---|---|
| Token de acceso de SSO | La define tu organización, normalmente 8 horas | Se guarda en caché en el disco con permisos de archivo 0600. Vuelve a iniciar sesión cuando venza. |
| Credenciales del rol | Normalmente 1 hora | Se renuevan automáticamente en segundo plano cuando ocurre cualquier solicitud dentro de los 5 minutos previos al vencimiento, siempre que el token de SSO sea válido. |
Cuando vence el propio token de SSO, la renovación se detiene y las siguientes llamadas a AWS fallan. Vuelve a la pantalla de inicio de sesión e inicia sesión de nuevo; tu perfil guardado preseleccionará la cuenta y el rol.
Solución de problemas
| Mensaje | Significado y solución |
|---|---|
| AWS did not recognize this SSO start URL in the selected SSO region | Revisa la URL del portal y asegúrate de que la región de SSO sea aquella donde IAM Identity Center está habilitado, no la región de tus tablas. |
| The cached client registration is no longer valid | DynamoOps descartó el registro obsoleto. Simplemente vuelve a intentarlo; se creará uno nuevo. |
| AWS rejected the sign-in request | Tu usuario no tiene acceso a este portal de acceso. Consulta a tu administrador. |
| AWS is rate-limiting sign-in requests | AWS está limitando la frecuencia de las solicitudes de inicio de sesión. Espera un momento y vuelve a intentarlo. |
| Could not reach AWS | No fue posible comunicarse con AWS. Revisa tu conexión a internet o tu VPN. |
| Your SSO user has no AWS accounts assigned | El inicio de sesión funcionó, pero no tienes ninguna cuenta asignada en IAM Identity Center. |