# serveur_keycloak

SSO / IAM **Keycloak** (distribution Quarkus) — hub d'authentification centralisée
(OIDC/SAML) pour les services Chezlepro.

## Rôle
- Installe un JRE, télécharge et extrait la distribution Keycloak dans `/opt/keycloak`.
- Configure la **base PostgreSQL via le registre** `docs/bases-donnees.yml` (entrée `keycloak`).
- Publie derrière `serveur_nginx` (TLS à l'edge) : `hostname`, `proxy-headers=xforwarded`, `http-enabled=true`.
- Secrets (mot de passe BD + admin bootstrap) dans `/etc/keycloak/keycloak.env` (`0640`, `no_log`).
- `kc.sh build --db=postgres` (une fois par version) puis service systemd `start --optimized`.

## Premier consommateur du registre de BD
L'entrée `keycloak` de `docs/bases-donnees.yml` fait que :
1. `serveur_postgresql` crée la base `keycloak` + le compte propriétaire `keycloak`.
2. Ce rôle lit **la même entrée** pour bâtir sa connexion (`db-url-database`, `db-username`, mot de passe = `vault_bd_keycloak`).

Mot de passe partagé, source unique. Dépendance `serveur_keycloak requiert serveur_postgresql actif` déjà dans `docs/dependances-groupes.yml`.

## Secrets requis (Vault)
```yaml
serveur_keycloak_admin_password: "{{ vault_keycloak_admin }}"   # admin bootstrap
vault_bd_keycloak: "..."                                          # mot de passe BD (partage avec postgres)
```

## Variables principales
| Variable | Défaut | Rôle |
| --- | --- | --- |
| `serveur_keycloak_version` | `26.0.7` | Version (à vérifier/bumper sur keycloak.org/downloads) |
| `serveur_keycloak_hostname` | `keycloak.chezlepro.internal` | Hostname public (via nginx) |
| `serveur_keycloak_db_host` | `10.1.13.11` | IP de data-01 (serveur_postgresql) |
| `serveur_keycloak_admin_user` | `admin` | Admin bootstrap |

## Notes / limites
- **Version** : à confirmer/bumper ; l'URL suit le motif officiel des releases GitHub.
- L'unité systemd est dérivée des conventions Keycloak (la doc officielle ne fournit pas d'unité) — sandboxing volontairement modéré pour ne pas casser le démarrage.
- Le **site nginx** publiant Keycloak se déclare côté `serveur_nginx` (`serveur_nginx_sites`), pas ici.
- Certificats : TLS terminé à l'edge ; aucun certificat sur Keycloak.

## Prérequis
- Réseau sortant pour télécharger la distribution.
- Base PostgreSQL atteignable (dépendance `serveur_postgresql`).