Gérer les hôtes IAM
Vérifier que chaque nom d'hôte mène au bon realm Keycloak, resynchroniser les hôtes automatiques et créer des hôtes pour le mobile ou le développement local.
- Required access
- Administrateur réseau, avec le droit « Gérer les URLs/routage » (et « Accès infrastructure en production » en prod)
- Duration
- 5 min
This page has not been translated yet and is shown in French.
Les hôtes IAM relient vos noms d'hôte au realm Keycloak de l'application. La plupart sont créés automatiquement quand vous mettez une route en ligne ; vous intervenez pour les resynchroniser ou pour déclarer un nom que la plateforme ne connaît pas. Le principe est expliqué dans Hôtes IAM.
Avant de commencer
- Vous avez le niveau Administrateur réseau ou supérieur. En dessous, la création et la resynchronisation sont refusées.
- Les routes de l'environnement sont en ligne (voir Mettre une route en ligne).
Consulter les hôtes d'un environnement
- Ouvrez l'environnement, puis l'onglet URLs & IAM.
- Faites défiler jusqu'à la section Hôtes IAM.
Résultat : chaque hôte est listé avec son motif et ses options. Les hôtes qui correspondent à une URL publique apparaissent aussi sous cette URL, dans Instances de routes dans l'environnement.
Pour une vue de tous les environnements, ouvrez la liste Environnements de l'application, onglet Mapping IAM : chaque nom d'hôte y figure avec son instance Keycloak.
Resynchroniser les hôtes automatiques
À faire si un nom d'hôte en ligne n'a pas d'hôte IAM, après un message d'échec de synchronisation, ou après un changement de préfixe.
- Dans la section Hôtes IAM, cliquez sur Resynchroniser IAM.
Résultat : Synchronisation IAM en cours… s'affiche, puis la liste se met à jour. Les hôtes automatiques sont alignés sur les noms d'hôte réels et Keycloak reçoit les adresses de retour correspondantes. Vos hôtes manuels ne sont pas touchés.
Le même bouton existe sur l'onglet Résumé de l'environnement.
Créer un hôte manuel
- Dans la section Hôtes IAM, cliquez sur Nouveau hôte. Le dialogue Nouvel hôte IAM s'ouvre.
- Pour un site web, saisissez dans Pattern d'hôte le nom d'hôte complet, par exemple
app.exemple.fr. Cochez *Wildcard ( . ) pour couvrir tous ses sous-domaines. - Pour une application mobile, cochez App mobile (deep link), puis saisissez le Schéma (par exemple
monapp) et le Chemin callback (par défautcallback). Keycloak recevramonapp://callbackcomme adresse de retour. - En dev uniquement, pour un poste local, saisissez
<identifiant de l'app>.localhost:<port>, par exemplemonapp.localhost:5173. - Laissez cochée la case Actif.
- Laissez Realm dédié, MFA obligatoire, IdPs autorisés et Durée de session (minutes) à leur valeur par défaut.
- Cliquez sur Créer.
Résultat : le message Hôte IAM créé s'affiche et l'hôte rejoint la liste.
Désactiver ou supprimer un hôte
- Pour suspendre un hôte sans le perdre, cliquez sur Désactiver sur sa ligne. Activer le rétablit.
- Pour le supprimer, cliquez sur l'icône Supprimer de sa ligne, puis sur Supprimer dans le dialogue Supprimer l'hôte IAM. Les utilisateurs qui arrivent par ce nom ne peuvent plus se connecter. Un hôte automatique supprimé est recréé à la prochaine resynchronisation tant que la route existe.
Vérifier le résultat
Depuis votre poste, demandez à Discovery l'adresse de connexion pour le nom d'hôte :
curl -s -X POST https://discovery.wakastart.app/discover/start-login \
-H "Content-Type: application/json" \
-d '{
"host": "app.staging.exemple.fr",
"redirectUri": "https://app.staging.exemple.fr/callback",
"state": "etat-exemple",
"codeChallenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM"
}'La réponse contient keycloakUrl, une URL d'autorisation du Keycloak de l'environnement visé (https://auth-staging.wakastart.app/realms/… pour staging). Un nom d'hôte sans hôte IAM est refusé.
Dépannage
- Message URL instanciée, mais la réconciliation IAM a échoué. Relancez via Resynchroniser IAM. : cliquez sur Resynchroniser IAM.
- Le nom d'hôte est déjà utilisé par une autre application : un nom n'appartient qu'à une seule app. Choisissez un autre nom.