Keycloak-Instanz erstellen
Diese Anleitung führt Sie durch das Erstellen und Konfigurieren Ihrer Keycloak-Instanz bei Skycloak. Zuvor klären wir, was ein Keycloak-Cluster überhaupt ist.
Was ist ein Keycloak-Cluster?
Section titled “Was ist ein Keycloak-Cluster?”Allgemein bezeichnet ein Cluster eine Gruppe ähnlicher Dinge, die nah beieinander liegen oder auftreten.
Im verteilten Rechnen ist ein Cluster eine Menge verbundener Rechner (Knoten), die als ein einziges System zusammenarbeiten und so Hochverfügbarkeit, Lastverteilung und Ausfallsicherheit ermöglichen. Stark frequentierte Webdienste wie Netflix oder Amazon nutzen solche Serververbünde, um Millionen Anfragen unterbrechungsfrei zu bedienen.
Ein Keycloak-Cluster folgt demselben Prinzip: Es ist eine Gruppe von Keycloak-Servern, die gemeinsam Authentifizierung und Autorisierung ohne Unterbrechung bereitstellen. Wir sprechen von einem Cluster, weil Hochverfügbarkeit ein Kernmerkmal unseres Systems ist.

Cluster-Größen und Bestandteile
Section titled “Cluster-Größen und Bestandteile”Wir bieten mehrere Konfigurationen für unterschiedliche Anforderungen:
Cluster Small
Section titled “Cluster Small”- Eine einzelne Keycloak-Instanz
- Streng genommen kein Cluster, lässt sich aber mit unserer Clustering-Option erweitern
- Geeignet für Entwicklungs- und Testumgebungen
Cluster Medium
Section titled “Cluster Medium”- 2 Keycloak-Instanzen
- Auf 2 Rechenzentren verteilt
- Latenz unter 10 ms zwischen den Instanzen
- Ideal für den Produktivbetrieb mit mittlerem Aufkommen
Cluster Large
Section titled “Cluster Large”- Mindestens 3 Keycloak-Instanzen
- Auf 3 oder mehr Rechenzentren verteilt
- Erhöhte Ausfallsicherheit
- Empfohlen für den Produktivbetrieb mit hohem Aufkommen
Cluster Custom
Section titled “Cluster Custom”- Dedizierte Infinispan-Cluster für besondere Anforderungen
- Geeignet für:
- Extreme Anforderungen an Hochverfügbarkeit
- Sehr große Benutzerzahlen
- Maßgeschneiderte Bereitstellungen
- Hinweis: Die meisten Anwendungsfälle sind mit Small, Medium oder Large samt eingebettetem Infinispan bestens bedient
Voraussetzungen
Section titled “Voraussetzungen”- Ein bestätigtes Skycloak-Konto
- Ein aktives Abonnement oder eine laufende kostenlose Testphase
Cluster erstellen
Section titled “Cluster erstellen”- Öffnen Sie die Cluster-Seite über die Seitenleiste oder hier
- Klicken Sie auf die Schaltfläche „Create Cluster“ (Cluster erstellen)
- Wählen Sie Ihre Konfiguration:
- Cluster name (Cluster-Name): ein sprechender Name
- Size (Größe): Small, Medium oder Large, je nach Bedarf
- Region: die Region, die Ihren Benutzern am nächsten liegt
- Keycloak Version: die aktuelle stabile Version wird empfohlen
- Admin Console SSO: standardmäßig aktiv (Zugriff auf die Admin-Konsole mit Ihrem Skycloak-Konto, ohne separates Passwort)
- Klicken Sie auf die Schaltfläche „Create“ (erstellen)
Cluster sind immer vollständig verwaltet: Es gibt keine Keycloak-Administratorzugangsdaten anzulegen oder aufzubewahren, Sie melden sich über Ihr Skycloak-Konto an der Admin-Konsole an.

Nach dem Absenden beginnt die Bereitstellung. Ihr Dashboard zeigt den Cluster im Zustand „Creating“ (wird erstellt), bis er vollständig verfügbar ist. Das dauert in der Regel 2 bis 4 Minuten, und Sie erhalten eine E-Mail, sobald alles bereit ist.
Auf Ihren Cluster zugreifen
Section titled “Auf Ihren Cluster zugreifen”Nach dem Erstellen erreichen Sie den Cluster direkt aus Ihrem Dashboard. Klicken Sie auf die Cluster-Karte, um die Details zu sehen. Die Seitenleiste wechselt in den Cluster-Kontext und, sobald Sie einen Realm öffnen, in den Realm-Kontext (siehe Orientierung im Dashboard).

Auf der Detailseite können Sie:
- Go to Console (Konsole öffnen): die Keycloak-Administrationskonsole aufrufen
- Cluster-Status einsehen: Zustand und Verfügbarkeit beobachten
- Einstellungen verwalten: die Konfiguration bei Bedarf anpassen
Cluster-Kennung
Section titled “Cluster-Kennung”Jeder Cluster erhält eine eindeutige Kennung, die seine öffentliche URL bestimmt. Ihr Cluster ist erreichbar unter:
https://<eindeutige-cluster-kennung>.app.skycloak.io
Bewahren Sie diese URL sorgsam auf, denn sie führt zu Ihrer Authentifizierungsinfrastruktur. Sie ist zwar bewusst öffentlich, sollte aber wie eine vertrauliche Information behandelt und nur mit vertrauenswürdigen Teammitgliedern und den Anwendungen geteilt werden, die Keycloak einbinden müssen.
Sicherheit der Admin-Konsole
Section titled “Sicherheit der Admin-Konsole”⚠️ Sicherheitshinweis: Standardmäßig ist die Administrationskonsole unter der Cluster-URL öffentlich erreichbar. Wer die URL kennt, kann also versuchen, auf die Admin-Konsole zuzugreifen.
Zur Absicherung können Sie:
- Admin Console SSO nutzen (standardmäßig aktiv): Melden Sie sich mit Ihrem Skycloak-Konto statt mit geteilten Zugangsdaten an. So gibt es keine Passwörter zu verwalten oder versehentlich preiszugeben.
- Den Tarif Enterprise wählen, der Firewall-Regeln und VPN-Anbindung enthält
- Die Option Security Firewall ergänzen (ab dem Tarif Launch verfügbar), um den administrativen Zugriff einzuschränken
Weitere Sicherheitsoptionen finden Sie auf unserer Seite zu den Zusatzoptionen.
Nächste Schritte
Section titled “Nächste Schritte”Diese Seiten liegen auf Englisch vor: