Wallet Connectors stellt einen EUDI-Wallet-Konnektor für Keycloak vor. Er bindet Identitätsnachweise aus einer Wallet in den Anmeldeablauf von Anwendungen ein, die bereits Keycloak für die Identitäts- und Zugriffsverwaltung nutzen.

Warum eine EUDI Wallet mit Keycloak verbinden?

Öffentliche Einrichtungen, Softwareanbieter, IAM-Teams in Unternehmen und Systemintegratoren können die Wallet-Anmeldung in einer bereits betriebenen Umgebung erproben. Die Integration verbindet die Identitätsprüfung per Wallet mit der bestehenden Zugriffsverwaltung, während die Anwendungen ihre Keycloak-Anbindung behalten.

Web3 Digital Wallet, das Unternehmen hinter Talao, entwickelt Identitätswallets. Mit Wallet Connectors unterstützen wir Anwendungsteams außerdem dabei, die von Nutzern über diese Wallets präsentierten Nachweise zu akzeptieren.

So funktioniert die Wallet-Anmeldung

  1. Der Nutzer beginnt die Anmeldung bei einer mit Keycloak verbundenen Anwendung.
  2. Keycloak bietet den konfigurierten EUDI-Wallet-Identitätsanbieter an.
  3. Der Nutzer präsentiert Identitätsnachweise mit seiner Wallet; Wallet Connectors überprüft die Präsentation.
  4. Keycloak verwaltet die Kontozuordnung und wendet die Rollen und Zugriffsregeln der Anwendung an.

Damit werden die Prüfung der vorgelegten Identitätsinformationen und die Autorisierungsentscheidungen der Anwendung getrennt. Keycloak bleibt für das Konto und die in Ihrem Realm konfigurierten Zugriffsregeln verantwortlich.

Den integrierten OpenID-Connect-Anbieter von Keycloak nutzen

Der Konnektor verwendet das native OIDC Identity Brokering von Keycloak. Sie konfigurieren einen OpenID-Connect-Identitätsanbieter im Realm, anstatt jeder Anwendung wallet-spezifischen Integrationscode hinzuzufügen.

Konfiguration und Videodemonstration finden Sie auf der englischsprachigen Keycloak-Integrationsseite von Wallet Connectors. Keycloak bietet außerdem eine OpenID-Connect-Dokumentation auf Englisch für Teams, die ihre Anwendungsarchitektur prüfen.

Einen praktischen Piloten vorbereiten

In der mit dem Konnektor angekündigten Demonstration gelang eine Wallet-Anmeldung in weniger als fünf Minuten, nachdem die lokale Keycloak-Umgebung vorbereitet war. Diese Beobachtung bezieht sich auf die vorbereitete Demonstration; eine produktive Bereitstellung erfordert zusätzlich Integration und die Prüfung der Regeln.

Die aktuelle Anleitung verlangt eine öffentliche HTTPS-Callback-URL aus Ihrem Realm, Verbindungszugangsdaten und eine Prüfung des Verhaltens bei der ersten Anmeldung. Testen Sie den gesamten Ablauf aus einer an diesen Realm angebundenen Anwendung, bevor Sie den Piloten erweitern.

Kontoverknüpfung und Identitätsattribute

Der dokumentierte Identitätsablauf nutzt openid profile. Er fordert weder eine E-Mail-Adresse noch einen Volljährigkeitsnachweis an. Prüfen Sie vor der Nutzung, ob in Ihrem Realm eine E-Mail-Adresse verpflichtend ist.

Bei einem bestehenden Konto muss vor der Verknüpfung des externen Identitätsanbieters eine Authentifizierung an diesem Konto erfolgen. Namen und E-Mail-Adressen allein reichen nicht für eine automatische Zuordnung. Die Anbieterzuordnung verwendet dessen externe Subjektkennung.

Ihre Keycloak-Integration starten

Entdecken Sie die englischsprachige Keycloak-Anleitung und das Videotutorial oder lesen Sie die Startankündigung von Wallet Connectors. Organisationen mit eigener Wallet können außerdem Talaos White-Label-EUDI-Wallet-Anwendungen und Backend kennenlernen.

Auf Grundlage der Startankündigung von Thierry Thevenet. Die Konfigurationsdetails wurden am 18. November 2026 anhand der verlinkten Integrationsanleitung geprüft.