# 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.

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](/v1.0/domaines-et-urls/hotes-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](/v1.0/domaines-et-urls/mettre-une-route-en-ligne)).

## Consulter les hôtes d'un environnement

1. Ouvrez l'environnement, puis l'onglet **URLs & IAM**.
2. 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.

1. 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

1. Dans la section **Hôtes IAM**, cliquez sur **Nouveau hôte**. Le dialogue **Nouvel hôte IAM** s'ouvre.
2. 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.
3. Pour une application mobile, cochez **App mobile (deep link)**, puis saisissez le **Schéma** (par exemple `monapp`) et le **Chemin callback** (par défaut `callback`). Keycloak recevra `monapp://callback` comme adresse de retour.
4. En dev uniquement, pour un poste local, saisissez `<identifiant de l'app>.localhost:<port>`, par exemple `monapp.localhost:5173`.
5. Laissez cochée la case **Actif**.
6. Laissez **Realm dédié**, **MFA obligatoire**, **IdPs autorisés** et **Durée de session (minutes)** à leur valeur par défaut.
7. 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 :

```bash
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.

## Voir aussi

- [Hôtes IAM](/v1.0/domaines-et-urls/hotes-iam)
- [Authentification](/v1.0/authentification)
