Keycloak
Keycloak est disponible comme service de projet pour ajouter l'authentification unique (SSO), OpenID Connect et SAML à vos applications. SailOps exécute Keycloak 26 avec l'opérateur officiel, le publie sur une URL HTTPS publique et stocke ses données dans un service PostgreSQL du même projet. Les organisations en période d'essai ne peuvent pas le provisionner.
Créer une instance
Ouvrez Services → Créer un service → Keycloak. Le formulaire comporte quatre sections :
-
Configuration de base — nom de l'instance et version de Keycloak. La version est fixée à la création.
-
Base de données — Keycloak conserve toutes ses données (realms, utilisateurs, sessions qui survivent aux redémarrages) dans PostgreSQL :
- Utiliser un service PostgreSQL existant du projet, ou
- Créer un nouveau service PostgreSQL avec les options PostgreSQL habituelles. Il est créé en même temps que Keycloak et apparaît dans votre liste de services comme toute autre base de données.
SailOps crée une base de données et un utilisateur dédiés à Keycloak sur ce service. Ce choix est fixé à la création.
-
Ressources — classe de calcul, flavor (au moins 0,5 vCPU et 1 Gio de mémoire par instance ; le flavor eco à 0,5 vCPU convient au développement et aux petits realms) et nombre d'instances (1 à 3). Plusieurs instances partagent leurs sessions et continuent de servir pendant qu'une redémarre. Le nombre d'instances, le flavor et la classe de calcul peuvent être modifiés ensuite ; les changements redémarrent les instances une par une.
-
Public Access (accès public) — liste facultative d'adresses IP ou de CIDR autorisés à joindre la console d'administration. Voir Restreindre la console d'administration.
Le provisionnement attend que le service PostgreSQL soit prêt, puis démarre Keycloak. Le premier démarrage crée le schéma de la base : environ 2 minutes avec 1 vCPU, environ 6 minutes avec 0,5 vCPU.
Se connecter à la console d'administration
L'onglet Identifiants affiche l'URL de la console d'administration et le nom d'utilisateur de l'administrateur du realm master. Le mot de passe n'est affiché qu'une seule fois ; conservez-le immédiatement. Réinitialiser le mot de passe en définit un nouveau.
Keycloak marque l'administrateur initial comme temporaire et affiche un bandeau dans la console. Créez votre propre administrateur dans le realm master, puis ne gardez le compte initial que comme moyen de récupération.
SailOps crée aussi un client nommé sailops-admin dans le realm master. C'est lui qui permet à l'action Réinitialiser le mot de passe de fonctionner même si vous avez changé le mot de passe de l'administrateur. Ne le supprimez pas et ne le désactivez pas : sans lui, SailOps ne peut plus réinitialiser le mot de passe à votre place.
L'utiliser depuis vos applications
Les realms, clients, utilisateurs et fournisseurs d'identité se gèrent dans la console d'administration de Keycloak. Chaque realm est servi sous l'URL publique affichée dans l'onglet Vue d'ensemble :
https://<URL publique>/realms/<realm>/.well-known/openid-configuration
Les émetteurs (issuers) des jetons utilisent toujours l'URL publique : les jetons obtenus par un navigateur sont donc valides pour vos backends.
Pour donner à un conteneur ou à un job les URL dont il a besoin, créez une connexion vers l'instance Keycloak. Elle injecte :
| Variable | Valeur |
|---|---|
KEYCLOAK_URL | URL publique, pour les navigateurs et la vérification de l'émetteur |
KEYCLOAK_INTERNAL_URL | URL interne au projet, pour les appels back-channel comme l'échange de jetons ou l'API d'administration |
Une connexion Keycloak ne transporte aucun identifiant : créez un client dans votre realm pour chaque application.
Restreindre la console d'administration
La console d'administration, l'API REST d'administration et le realm master peuvent être restreints à une liste d'adresses IP ou de CIDR, dans le formulaire ou plus tard en modifiant l'instance. Les realms de vos applications restent publics, comme doit l'être un fournisseur d'identité. Une liste vide autorise toutes les adresses.
Base de données et sauvegardes
Keycloak ne conserve lui-même aucune donnée : tout est dans sa base PostgreSQL. Sauvegardez-la et restaurez-la depuis le service PostgreSQL, avec ses sauvegardes planifiées et manuelles.
Un service PostgreSQL utilisé par Keycloak ne peut pas être supprimé tant que Keycloak existe ; supprimez d'abord Keycloak. Quand vous supprimez Keycloak, sa base de données dédiée est supprimée. Si le service PostgreSQL a été créé en même temps que Keycloak et que rien d'autre ne l'utilise, la fenêtre de suppression propose de le supprimer aussi. Keycloak, et le service PostgreSQL supprimé avec lui, affichent l'état Deleting jusqu'à leur disparition. Keycloak ne peut plus être modifié dès que sa suppression est acceptée ; le service PostgreSQL n'est supprimé qu'après la disparition de Keycloak, et le tableau de bord désactive ses actions entre-temps.
Facturation
Chaque instance est facturée à l'heure au prix de son flavor. Le service PostgreSQL est facturé séparément, comme toute base de données.
Limitations
- L'import de realms, les thèmes personnalisés et les extensions (providers) personnalisées ne sont pas encore disponibles.
- Les métriques propres à Keycloak (connexions, sessions) ne sont pas affichées ; l'onglet Observabilité montre le CPU, la mémoire et l'état des instances.