Zum Inhalt springen

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.

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.

Keycloak-Cluster

Wir bieten mehrere Konfigurationen für unterschiedliche Anforderungen:

  • Eine einzelne Keycloak-Instanz
  • Streng genommen kein Cluster, lässt sich aber mit unserer Clustering-Option erweitern
  • Geeignet für Entwicklungs- und Testumgebungen
  • 2 Keycloak-Instanzen
  • Auf 2 Rechenzentren verteilt
  • Latenz unter 10 ms zwischen den Instanzen
  • Ideal für den Produktivbetrieb mit mittlerem Aufkommen
  • Mindestens 3 Keycloak-Instanzen
  • Auf 3 oder mehr Rechenzentren verteilt
  • Erhöhte Ausfallsicherheit
  • Empfohlen für den Produktivbetrieb mit hohem Aufkommen
  • 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
  • Ein bestätigtes Skycloak-Konto
  • Ein aktives Abonnement oder eine laufende kostenlose Testphase
  1. Öffnen Sie die Cluster-Seite über die Seitenleiste oder hier
  2. Klicken Sie auf die Schaltfläche „Create Cluster“ (Cluster erstellen)
  3. 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)
  4. 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.

Cluster-Seite

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.

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).

Detailseite eines Clusters

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

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.

⚠️ 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.

Diese Seiten liegen auf Englisch vor: