Créer votre instance Keycloak

Ce guide vous accompagne dans la création et la configuration de votre instance Keycloak sur Skycloak. Avant de commencer, définissons ce qu’est un cluster Keycloak.

Qu’est-ce qu’un cluster Keycloak ?

Au sens courant, un cluster (grappe) désigne un ensemble d’éléments semblables regroupés ou survenant à proximité les uns des autres.

En informatique distribuée, un cluster est un ensemble d’ordinateurs connectés (les nœuds) qui fonctionnent comme un seul système pour assurer la haute disponibilité, la répartition de charge et la tolérance aux pannes. Des services web très fréquentés comme Netflix ou Amazon s’appuient ainsi sur des grappes de serveurs pour absorber des millions de requêtes sans interruption.

Un cluster Keycloak suit le même principe : c’est un groupe de serveurs Keycloak qui travaillent ensemble pour fournir des services d’authentification et d’autorisation sans interruption. Nous employons le terme « cluster » parce que la haute disponibilité est au cœur de notre système.

Cluster Keycloak

Tailles de cluster et composants

Nous proposons plusieurs configurations pour répondre à des besoins différents :

Cluster Small

Une seule instance Keycloak
Techniquement pas un cluster, mais extensible grâce à notre option de clustering
Convient aux environnements de développement et de test

Cluster Medium

2 instances Keycloak
Réparties sur 2 centres de données
Latence inférieure à 10 ms entre les instances
Idéal pour la production avec un trafic modéré

Cluster Large

Au minimum 3 instances Keycloak
Réparties sur 3 centres de données ou plus
Tolérance aux pannes renforcée
Recommandé pour la production à fort trafic

Cluster Custom

Clusters Infinispan dédiés pour les besoins particuliers
Adapté aux cas suivants :
- Exigences extrêmes de haute disponibilité
- Volumes d’utilisateurs très importants
- Configurations de déploiement sur mesure
À noter : la plupart des besoins sont parfaitement couverts par les clusters Small, Medium ou Large avec Infinispan embarqué

Prérequis

Un compte Skycloak vérifié
Un abonnement actif ou un essai gratuit

Créer le cluster

Ouvrez la page des clusters depuis la barre latérale ou ici
Cliquez sur le bouton « Create Cluster » (créer un cluster)
Choisissez votre configuration :
- Cluster name (nom du cluster) : un nom explicite
- Size (taille) : Small, Medium ou Large selon vos besoins
- Region (région) : la plus proche de vos utilisateurs
- Keycloak Version (version de Keycloak) : la dernière version stable est recommandée
- Admin Console SSO : activé par défaut (accédez à la console d’administration avec votre compte Skycloak, sans mot de passe distinct)
Cliquez sur le bouton « Create » (créer)

Les clusters sont toujours entièrement managés : il n’y a aucun identifiant administrateur Keycloak à créer ni à stocker, vous vous connectez à la console d’administration via votre compte Skycloak.

Page des clusters

Une fois la demande envoyée, le provisionnement démarre. Votre tableau de bord affiche le cluster à l’état « Creating » (création en cours) jusqu’à ce qu’il soit disponible. L’opération prend généralement 2 à 4 minutes, et vous recevez un e-mail lorsque tout est prêt.

Accéder à votre cluster

Une fois le cluster créé, vous y accédez directement depuis votre tableau de bord. Cliquez sur la carte du cluster pour afficher son détail. La barre latérale bascule dans le contexte du cluster, puis dans le contexte du realm lorsque vous ouvrez un realm (voir S’orienter dans le tableau de bord).

Page de détail d’un cluster

Depuis cette page, vous pouvez :

Go to Console (ouvrir la console) : accéder à la console d’administration de Keycloak
Consulter l’état du cluster : surveiller la santé et la disponibilité
Gérer les paramètres : ajuster la configuration si nécessaire

Identifiant du cluster

Chaque cluster reçoit un identifiant unique qui détermine son URL publique. Votre cluster est accessible à l’adresse :

https://<identifiant-unique-du-cluster>.app.skycloak.io

Gardez cette URL en sécurité : elle donne accès à votre infrastructure d’authentification. Bien qu’elle soit publique par conception, traitez-la comme une information sensible et ne la partagez qu’avec les membres d’équipe de confiance et les applications qui doivent s’intégrer à Keycloak.

Sécurité de la console d’administration

⚠️ Avertissement de sécurité : par défaut, la console d’administration est accessible publiquement à l’URL de votre cluster. Toute personne connaissant l’URL peut donc tenter d’y accéder.

Pour renforcer la sécurité, vous pouvez :

Utiliser Admin Console SSO (activé par défaut) : accédez à la console d’administration avec votre compte Skycloak plutôt qu’avec des identifiants partagés. Aucun mot de passe à gérer ni à exposer par inadvertance.
Choisir la formule Enterprise, qui inclut des règles de pare-feu et des options de connectivité VPN
Ajouter l’option Security Firewall (disponible à partir de la formule Launch) pour restreindre l’accès administrateur

Pour d’autres options de sécurité, consultez notre page sur les options.

Étapes suivantes

Ces pages sont disponibles en anglais :