CloudConsole

Configurar CloudConsole para tu equipo

Para administradores: crea un enlace o código QR de configuración con las cuentas y roles de tu equipo, usa un rol de solo lectura en el día a día y otro distinto para los cambios.

Si varias personas de tu equipo usan CloudConsole, dales un enlace o código QR de configuración en lugar de una lista de URL de inicio, ID de cuentas y nombres de roles. Cada persona lo escanea o lo abre, aprueba el inicio de sesión una vez por portal de acceso y obtiene las mismas cuentas, roles y regiones. El enlace no contiene secretos, así que puede estar en tu wiki.

Lo que ve una persona del equipo después de escanear el QR de configuración
Lo que ve tu equipo

1. Crea el enlace a partir de ~/.aws/config

Si tu configuración de la AWS CLI ya tiene los perfiles que usa tu equipo, pégala en la herramienta gratuita AWS config to QR. Funciona en tu navegador, conserva los perfiles de IAM Identity Center (tanto sso-session como el formato antiguo) y los perfiles de rol (role_arn + source_profile, con external_id y cadenas), y descarta las claves que encuentre. Desmarca lo que el equipo no necesite y copia el enlace o guarda el código QR.

2. O créalo a mano

Un enlace de configuración es https://cloudconsole.dev/connect#v1. seguido de una lista JSON, comprimida con raw deflate y escrita en base64url sin relleno. Cada entrada de la lista es una cuenta de SSO o un rol, por ejemplo:

[{"t":"sso","k":"prod","u":"https://acme.awsapps.com/start","sr":"eu-west-2",
  "a":"111122223333","n":"acme-prod","ro":"CloudConsoleReadOnly","r":"eu-west-2"},
 {"t":"role","k":"prod-operator","arn":"arn:aws:iam::111122223333:role/Operator",
  "src":"prod","x":"acme-oncall","r":"eu-west-2"}]
  • sso: u (URL de inicio) y sr (región de Identity Center) son obligatorios. a (ID de cuenta) y ro (nombre del rol) van juntos; omite los dos para que cada persona elija después de iniciar sesión. n es el nombre de la cuenta que muestra la app, r la región en la que se abre y k el nombre del perfil.
  • role: arn y src son obligatorios. src es el k de otra entrada, o el nombre de una cuenta que la persona ya tiene en la app. x es un ID externo.

Para convertir en enlace un archivo team.json con esa lista:

python3 -c 'import json,sys,zlib,base64
d=json.dumps(json.load(open(sys.argv[1])),separators=(",",":")).encode()
c=zlib.compressobj(9,zlib.DEFLATED,-15); z=c.compress(d)+c.flush()
print("https://cloudconsole.dev/connect#v1."+base64.urlsafe_b64encode(z).decode().rstrip("="))' team.json

Abre el enlace en un navegador para comprobarlo: la página /connect (EN) muestra lo que añade o qué falla. Los valores de los campos no pueden parecer claves ni secretos; si alguno lo parece, se rechaza el enlace entero.

3. Un rol de solo lectura y otro distinto para los cambios

Da a todo el mundo un rol de solo lectura para las comprobaciones diarias y otro distinto para los cambios que quieras permitir desde el móvil:

  • Solo lectura: un conjunto de permisos de IAM Identity Center con la política administrada por AWS ReadOnlyAccess o con la política de CloudConsole, más restrictiva, de Permisos recomendados.
  • Cambios: un segundo conjunto de permisos (o un rol asumido desde el primero) con solo las acciones de Permisos para hacer cambios que tu equipo deba usar de guardia. Restringe los recursos y añade condiciones de etiquetas donde puedas.

Pon los dos en el enlace, por ejemplo prod con el rol de solo lectura y prod-operator con el rol de cambios. Pide a cada persona que ponga la protección de la cuenta de cambios en Typed + Face ID en la app (Protecciones); un enlace no puede configurar protecciones ni solo lectura por ellos.

4. Compártelo

Pon el enlace y el código QR en tu wiki o en tu runbook, junto a cómo instalar la app. En un ordenador, cada persona escanea el QR de la pantalla con Scan setup QR; en el móvil, toca el enlace. Un código QR admite unos 2300 caracteres, así que con muchos perfiles comparte el enlace o crea dos códigos.

Hacer cambios desde la app requiere CloudConsole Pro para cada persona que los haga; leer es gratis para una cuenta. Consulta Gratis y Pro.

Preguntas frecuentes

¿Puede el enlace incluir claves de acceso de un usuario de IAM compartido?

No. Los enlaces nunca llevan credenciales, y la app rechaza cualquier enlace que contenga algo parecido a una clave o un secreto. Usa IAM Identity Center o deja que cada persona añada sus propias claves.

¿Qué pasa si cambiamos el enlace?

En los móviles que ya usaron el anterior no cambia nada. Cada persona abre el enlace nuevo y desmarca lo que ya tiene; las entradas con la misma cuenta y el mismo rol se sustituyen en lugar de duplicarse.

¿Puedo fijar protecciones o solo lectura en el enlace?

No. Se configuran por cuenta en cada móvil, en Account → Accounts → el icono de ajustes.

¿Sigues atascado?

Escribe a [email protected] contando qué has probado y qué mensaje mostró la app. No envíes claves de acceso ni secretos. Respondemos en dos días laborables.