Configurer CloudConsole pour votre équipe
Pour les administrateurs : créez un lien ou QR code de configuration avec les comptes et rôles de votre équipe, un rôle en lecture seule au quotidien et un rôle distinct pour les modifications.
Si plusieurs personnes de votre équipe utilisent CloudConsole, donnez-leur un lien ou QR code de configuration plutôt qu’une liste d’URL de démarrage, d’ID de comptes et de noms de rôles. Chacun le scanne ou l’ouvre, approuve la connexion une fois par portail d’accès et obtient les mêmes comptes, rôles et régions. Le lien ne contient aucun secret : il peut figurer sur votre wiki.

1. Créer le lien à partir de ~/.aws/config
Si votre configuration AWS CLI contient déjà les profils de votre équipe, collez-la dans l’outil gratuit AWS config to QR. Il fonctionne dans votre navigateur, conserve les profils IAM Identity Center (sso-session comme l’ancien format) et les profils de rôle (role_arn + source_profile, avec external_id et les chaînes), et écarte toute clé trouvée. Décochez ce dont l’équipe n’a pas besoin, puis copiez le lien ou enregistrez le QR code.
2. Ou le construire à la main
Un lien de configuration est https://cloudconsole.dev/connect#v1. suivi d’une liste JSON, compressée en raw deflate et écrite en base64url sans remplissage. Chaque entrée de la liste est un compte SSO ou un rôle, par exemple :
[{"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 démarrage) etsr(région d’Identity Center) sont obligatoires.a(ID du compte) etro(nom du rôle) vont ensemble ; omettez-les tous deux pour laisser chacun choisir après la connexion.nest le nom du compte affiché dans l’app,rla région dans laquelle il s’ouvre,kle nom du profil. - role :
arnetsrcsont obligatoires.srcest lekd’une autre entrée, ou le nom d’un compte déjà présent dans l’app de la personne.xest un ID externe.
Pour transformer un fichier team.json contenant cette liste en lien :
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
Ouvrez le lien dans un navigateur pour le vérifier : la page /connect (EN) liste ce qu’il ajoute, ou indique ce qui ne va pas. Les valeurs des champs ne peuvent pas ressembler à des clés ou à des secrets ; si l’une d’elles en a l’air, tout le lien est refusé.
3. Un rôle en lecture seule, et un rôle distinct pour les modifications
Donnez à chacun un rôle en lecture seule pour les vérifications quotidiennes, et un rôle distinct pour les modifications que vous voulez autoriser depuis un téléphone :
- Lecture seule : un ensemble d’autorisations IAM Identity Center avec la politique gérée par AWS
ReadOnlyAccess, ou la politique CloudConsole plus restrictive de Autorisations recommandées. - Modifications : un second ensemble d’autorisations (ou un rôle assumé à partir du premier) avec uniquement les actions de Autorisations pour les modifications que votre équipe doit utiliser en astreinte. Restreignez les ressources et ajoutez des conditions sur les tags quand c’est possible.
Mettez les deux dans le lien, par exemple prod avec le rôle en lecture seule et prod-operator avec le rôle de modification. Demandez à chacun de régler le garde-fou du compte de modification sur Typed + Face ID dans l’app (Garde-fous) ; un lien ne peut pas régler les garde-fous ni la lecture seule à leur place.
4. Le partager
Placez le lien et le QR code sur votre wiki ou votre runbook, à côté des instructions d’installation de l’app. Sur un ordinateur, on scanne le QR code à l’écran avec Scan setup QR ; sur un téléphone, on touche le lien. Un QR code contient environ 2 300 caractères : pour de nombreux profils, partagez le lien ou créez deux codes.
Faire des modifications depuis l’app nécessite CloudConsole Pro pour chaque personne qui les fait ; la lecture est gratuite pour un compte. Voir Gratuit et Pro.
Questions fréquentes
Le lien peut-il inclure les clés d’accès d’un utilisateur IAM partagé ?
Non. Les liens ne contiennent jamais d’identifiants, et l’app refuse tout lien qui contient quelque chose ressemblant à une clé ou à un secret. Utilisez IAM Identity Center, ou laissez chacun ajouter ses propres clés.
Que se passe-t-il quand nous modifions le lien ?
Rien ne change sur les téléphones qui ont déjà utilisé l’ancien. Chacun ouvre le nouveau lien et décoche ce qu’il a déjà ; les entrées avec le même compte et le même rôle sont remplacées plutôt que dupliquées.
Puis-je régler les garde-fous ou la lecture seule dans le lien ?
Non. Ces réglages se font par compte sur chaque téléphone, dans Account → Accounts → l’icône de réglages.
Écrivez à [email protected] en indiquant ce que vous avez essayé et le message affiché par l’app. N’envoyez ni clés d’accès ni secrets. Nous répondons sous deux jours ouvrés.