# Page de connexion

> Donnez à l'écran de connexion de votre application l'apparence de votre marque, environnement par environnement, avec un thème Keycloak versionné.

L'écran où vos utilisateurs saisissent leur adresse et leur mot de passe est servi par [Keycloak](/v1.0/glossaire#keycloak), pas par votre application. Pour qu'il porte votre marque, vous fournissez un **thème de connexion** : un dossier de gabarits et de feuilles de style au format Keycloak.

Wakastart range chaque version de ce thème dans la bibliothèque d'un environnement de votre application, dev, staging ou prod, puis l'applique dans cet environnement. Chaque environnement a sa propre bibliothèque.

## Comment ça marche

```mermaid
flowchart LR
  R["Dépôt GitHub de l'app<br/>dossier keycloak-theme/"] -- "ajout dans chaque environnement" --> BD
  J["Fichier .jar"] -. "ou envoi" .-> BD
  R --> BS
  R --> BP
  BD["Thèmes de l'app · dev"] -- appliquer --> D["Keycloak dev<br/>tous les realms de l'app"]
  BS["Thèmes de l'app · staging"] -- appliquer --> S["Keycloak staging"]
  BP["Thèmes de l'app · prod"] -- appliquer --> P["Keycloak prod"]
```

1. Vous préparez le thème dans un dossier `keycloak-theme/` de l'un des dépôts GitHub de votre application, ou sous forme de fichier `.jar`.
2. Le thème entre dans la bibliothèque **Thèmes de l'app** d'un environnement, sous un nom de version calculé à partir de son contenu. Rien ne change encore pour vos utilisateurs.
3. La version est appliquée dans cet environnement. Elle remplace la page de connexion et les e-mails Keycloak de **tous les realms** de l'application sur l'instance Keycloak de cet environnement.
4. La console suit la publication jusqu'à l'état **Appliqué**.

La publication d'une version sur un environnement est réalisée par l'équipe Wakastart, à votre demande. Vous préparez le thème, vous suivez son état dans la console et vous validez le résultat.

## Choisissez votre approche

| Source | Quand la choisir |
|---|---|
| **Dépôt GitHub** :badge[Recommandé]{type=new} | Votre thème vit avec le code de l'application. Chaque version garde la trace du dépôt, de la branche et du commit importés. |
| **Fichier `.jar`** | Vous recevez un thème déjà empaqueté, ou votre dépôt n'est pas sur GitHub. |

## Commencer

::::cards{cols=3}
:::card{title="Versions et environnements" href="/v1.0/page-de-connexion/versions-et-environnements" icon="Layers"}
Comprendre la bibliothèque, l'application par environnement et les états.
:::
:::card{title="Préparer un thème" href="/v1.0/page-de-connexion/preparer-un-theme" icon="Paintbrush"}
Structurer le dossier keycloak-theme/ et respecter les contraintes.
:::
:::card{title="Publier un thème" href="/v1.0/page-de-connexion/publier-un-theme" icon="Send"}
Faire appliquer une version, la tester sur dev, puis la reprendre en prod.
:::
::::

## Fonctionnalités

- Une bibliothèque de versions par environnement, sans copie de l'un à l'autre.
- Un nom de version dérivé du contenu : importer deux fois le même thème donne la même version.
- Une application environnement par environnement, sur tous les realms de l'application.
- Un suivi de la publication étape par étape, avec un niveau d'alerte si elle dure.
- Un retour arrière en appliquant une version précédente.

## Produits liés

::::cards{cols=3}
:::card{title="Apparence" href="/v1.0/apparence" icon="Palette"}
Habiller l'interface de votre application elle-même.
:::
:::card{title="E-mails" href="/v1.0/emails" icon="Mail"}
Choisir le serveur qui envoie les e-mails Keycloak.
:::
:::card{title="Authentification" href="/v1.0/authentification" icon="LogIn"}
Connecter vos utilisateurs à Keycloak.
:::
::::

## Ressources

- [Référence du thème de connexion](/v1.0/page-de-connexion/reference)
- [Résoudre les problèmes de page de connexion](/v1.0/page-de-connexion/depannage)
