Dynamische Client-Registrierung
Client-Anwendungen registrieren sich selbst über OAuth 2.0 Dynamic Client Registration, autorisiert durch Initial Access Tokens.
Hinweis: Verfügbar mit den Abonnements Advanced und Pro. Die offene Registrierung für KI-Agenten erfordert Pro.
Mit der dynamischen Client-Registrierung registriert sich eine Client-Anwendung selbst, statt in der Admin Console manuell angelegt zu werden. Sie sendet ihre Metadaten (Name, Redirect-URIs, Client-Authentifizierung) an den Registrierungs-Endpunkt und erhält im Gegenzug eine Client-ID und, bei vertraulichen Clients, ein Client Secret. Die Plattform implementiert OAuth 2.0 Dynamic Client Registration (RFC 7591) und das Verwaltungsprotokoll, mit dem der Client seine eigene Registrierung später lesen, ändern und löschen kann (RFC 7592).
Standardmäßig erfordert jede Registrierung ein Initial Access Token, das Sie ausstellen. So entscheiden Sie, wer Clients registrieren darf und wie oft. Für KI-Agenten und andere Public Clients können Sie zusätzlich die offene Registrierung erlauben.
Sie verwalten Initial Access Tokens in der Admin Console unter Integrationen → Applikationen → Dynamische Registrierungen.
Funktionsweise
- Sie stellen ein Initial Access Token aus und übergeben es an die Stelle, die den Client registriert, zum Beispiel einen Partner oder eine Deployment-Pipeline.
- Der Client sendet eine Registrierungsanfrage an den Registrierungs-Endpunkt, mit dem Initial Access Token als Bearer-Token.
- Die Plattform prüft die Metadaten anhand der unten beschriebenen Regeln, legt die Anwendung an und antwortet mit den Client-Zugangsdaten, einem Registration Access Token und der eigenen Verwaltungs-URL des Clients.
- Mit dem Registration Access Token kann der Client seine Registrierung lesen, ändern oder löschen. Jede Änderung stellt ein neues Registration Access Token aus und macht das vorherige ungültig.
Der registrierte Client wird auf der Registerkarte Dynamische Registrierungen unter Registrierte Anwendungen aufgeführt, zusammen mit der Art der Registrierung und der letzten Nutzung. Seine Detailseite ist dieselbe wie bei jeder anderen Anwendung, gekennzeichnet als Dynamisch registriert. Anmelden kann sich daran noch niemand: Wie bei jeder neuen Anwendung muss der Zugriff zuerst zugewiesen werden.
Ein Initial Access Token ausstellen
- Öffnen Sie Integrationen → Applikationen und dort die Registerkarte Dynamische Registrierungen.
- Wählen Sie Token ausstellen.
- Geben Sie einen Name ein, zum Beispiel den Partner oder das System, für das das Token bestimmt ist. Er erscheint in der Liste und im Audit-Log.
- Legen Sie die Gültigkeit in Tagen fest (1 bis 365). Das Token läuft nach diesem Zeitraum ab.
- Lassen Sie Einmalig ausgewählt, wenn das Token genau eine Registrierung erlauben soll. Ohne diese Option ist es bis zum Ablauf beliebig oft verwendbar.
- Wählen Sie Token ausstellen und kopieren Sie das Token. Es wird nur einmal angezeigt und kann später nicht erneut abgerufen werden.
Die Seite zeigt außerdem den Registrierungs-Endpunkt, den Sie zusammen mit dem Token weitergeben. Er wird auch als registration_endpoint im OpenID-Connect-Discovery-Dokument veröffentlicht.
Die Liste zeigt für jedes Token die Verwendungsart, die Anzahl der damit vorgenommenen Registrierungen, das Ablaufdatum und wer es ausgestellt hat. Entziehen sperrt ein Token für neue Registrierungen. Bereits damit registrierte Anwendungen bleiben unberührt. Abgelaufene Tokens werden automatisch entfernt.
Offene Registrierung für KI-Agenten
Hinweis: Verfügbar mit dem Pro-Abonnement.
KI-Agenten, zum Beispiel Clients des Model Context Protocol (MCP), und Kommandozeilen-Tools registrieren sich selbst, sobald ein Benutzer sie verbindet, ohne dass jemand ein Token übergibt. Jede Installation registriert dabei meist einen eigenen Client. Die offene Registrierung erlaubt genau das für Public Clients, die kein Client Secret haben und Benutzer über den Authorization Code Flow mit PKCE anmelden.
- Öffnen Sie Einstellungen → Erweitert.
- Schalten Sie in der Karte Offene Registrierung die Option Offene Registrierung für Public Clients ein.
- Wählen Sie unter Benutzer mit Anmeldeberechtigung die Verzeichnisse, deren Benutzer solche Clients verwenden dürfen.
- Wählen Sie Änderungen speichern.
Für offen registrierte Clients gilt:
- Nur Public Clients werden akzeptiert. Eine Registrierung ohne Initial Access Token muss
"token_endpoint_auth_method": "none"senden, und der Client bleibt öffentlich: Eine spätere Änderung kann kein Client Secret hinzufügen. Vertrauliche Clients benötigen weiterhin ein Initial Access Token. - Der Zugriff ergibt sich aus den Verzeichnissen. Benutzer der ausgewählten Verzeichnisse können sich nach ihrer Zustimmung anmelden, ohne Zuweisung pro Anwendung. Die Auswahl gilt für neue Registrierungen; bereits registrierte Anwendungen behalten die Verzeichnisse, mit denen sie registriert wurden.
- Registrierungen sind ratenbegrenzt auf 10 pro Stunde je Client-IP-Adresse und 200 pro Stunde insgesamt (20 während des Testzeitraums).
- Ungenutzte Registrierungen werden entfernt. Ein Client, an dem sich niemand angemeldet hat, wird nach 24 Stunden gelöscht, ein Client ohne Anmeldungen oder Token-Anfragen seit 90 Tagen ebenfalls. Jede Entfernung wird im Audit-Log erfasst.
- Es gibt keinen Owner. Offen registrierte Anwendungen sind keinem Administrator zugeordnet.
Der Registrierungs-Endpunkt wird im Discovery-Dokument angekündigt, das unter /.well-known/openid-configuration und, für OAuth-Clients, die dort suchen, unter /.well-known/oauth-authorization-server bereitsteht. Fordert ein Agent ein Access Token für eine bestimmte Ressource an, etwa einen MCP-Server, legen Sie diese Ressource als API an.
Das Ausschalten der offenen Registrierung stoppt neue anonyme Registrierungen. Bereits registrierte Clients funktionieren weiter und können ihre Registrierung weiterhin verwalten. Ohne Pro-Abonnement erhalten Benutzer der Verzeichnisse keinen automatischen Zugriff mehr auf offen registrierte Clients: Weisen Sie sie explizit zu, andernfalls werden die ungenutzten Clients nach 90 Tagen entfernt.
Einen Client registrieren
Der Client sendet seine Metadaten als JSON-POST-Anfrage:
curl -X POST https://id.example.com/oidc/register \
-H "Authorization: Bearer <initial access token>" \
-H "Content-Type: application/json" \
-d '{
"client_name": "Partner Portal",
"redirect_uris": ["https://portal.partner.example/callback"],
"post_logout_redirect_uris": ["https://portal.partner.example/"],
"grant_types": ["authorization_code", "refresh_token"],
"token_endpoint_auth_method": "client_secret_basic"
}'Eine erfolgreiche Registrierung antwortet mit 201 Created:
{
"client_id": "V1StGXR8_Z5jdHi6B-myT",
"client_secret": "...",
"client_name": "Partner Portal",
"redirect_uris": ["https://portal.partner.example/callback"],
"grant_types": ["authorization_code", "refresh_token"],
"response_types": ["code"],
"token_endpoint_auth_method": "client_secret_basic",
"registration_client_uri": "https://id.example.com/oidc/register/V1StGXR8_Z5jdHi6B-myT",
"registration_access_token": "..."
}Der Client speichert client_secret und registration_access_token sicher. Beide lassen sich nicht erneut abrufen.
Die Registrierung verwalten
Der Client verwaltet seine Registrierung unter registration_client_uri, authentifiziert mit seinem aktuellen Registration Access Token:
| Anfrage | Wirkung |
|---|---|
GET | Liefert die aktuelle Registrierung. |
PUT | Ersetzt die Registrierung durch die gesendeten Metadaten. Der Body muss client_id enthalten; ein weggelassenes Feld wird entfernt. Die Antwort enthält ein neues Registration Access Token. |
DELETE | Löscht die Anwendung. Ihre Benutzer können sich danach nicht mehr daran anmelden. |
Eine dynamisch registrierte Anwendung lässt sich in der Admin Console wie jede andere bearbeiten oder löschen. Beachten Sie, dass das nächste PUT des Clients die Felder überschreibt, die ihm gehören (Name, Redirect-URIs, Grant Types, Client-Authentifizierung, Client-URI und Client-Schlüssel). Zuweisungen, Richtlinien, Owner und die Einwilligungseinstellung bleiben so, wie ein Administrator sie gesetzt hat.
Was ein registrierter Client sein kann
| Metadaten | Regel |
|---|---|
token_endpoint_auth_method | client_secret_basic (Standard), client_secret_post, private_key_jwt oder none. |
| Anwendungstyp | Ergibt sich aus der Client-Authentifizierung: none legt eine Single-Page-Anwendung an, oder eine native Anwendung, wenn "application_type": "native" gesendet wird oder jede Redirect-URI eine Loopback-Adresse (http://127.0.0.1, http://[::1], http://localhost) oder ein App-eigenes Schema ist. Ein nativer Loopback-Redirect passt auf jeden Port. Jede andere Methode legt eine Webanwendung an. Ein nativer Client muss none verwenden. |
grant_types | Muss authorization_code enthalten, refresh_token ist zusätzlich möglich. Implicit, Client Credentials, Device und Token Exchange werden abgelehnt. |
response_types | Nur code. |
redirect_uris, post_logout_redirect_uris | Keine Wildcards, keine URIs auf der eigenen Domain des Identity Providers. |
client_uri | Muss https verwenden. |
jwks | Nur öffentliche Schlüssel, RSA mit mindestens 2048 Bit oder EC auf der Kurve P-256. Erforderlich für private_key_jwt. |
jwks_uri, sector_identifier_uri, backchannel_logout_uri, request_uris | Abgelehnt, weil die Plattform diese URLs selbst aufrufen müsste. Ein Administrator kann die entsprechenden Optionen anschließend an der Anwendung setzen. |
client_name | Optional. Ohne Namen heißt die Anwendung "Dynamic client", gefolgt von ihrer Client-ID. An einen bereits vergebenen Namen wird ein Teil der Client-ID angehängt. |
default_max_age | Wird übernommen. |
Alle anderen Metadaten werden ignoriert und sind nicht Teil der Antwort.
Einige Einstellungen legt immer die Plattform fest, unabhängig vom Inhalt der Anfrage:
- Nutzereinwilligung erforderlich ist eingeschaltet. Benutzer bestätigen den angefragten Zugriff bei der ersten Anmeldung, und Refresh Tokens werden nur ausgestellt, wenn der Client den Scope
offline_accessanfragt. - Es wird kein Sicherheitsprofil angewendet. Ein Administrator kann anschließend eines setzen, siehe Financial-grade API security.
- Die Anwendung wird im Anwendungsportal der Benutzer nicht aufgeführt.
- Der Administrator, der das Initial Access Token ausgestellt hat, wird Owner der Anwendung. Offen registrierte Anwendungen haben keinen Owner.
Registrierungen zählen zum Anwendungslimit Ihres Abonnements.
Audit-Log
| Ereignis | Protokolliert, wenn |
|---|---|
INITIAL_ACCESS_TOKEN_CREATED | Ein Administrator ein Initial Access Token ausstellt. |
INITIAL_ACCESS_TOKEN_REVOKED | Ein Administrator ein Initial Access Token widerruft. |
CONFIGURATION_UPDATED | Ein Administrator die offene Registrierung ein- oder ausschaltet oder ihre Verzeichnisse ändert. |
APPLICATION_REGISTERED | Sich ein Client registriert. Der registrierende Client wird als Akteur erfasst. |
APPLICATION_UPDATED | Ein Client seine Registrierung ändert. |
APPLICATION_DEREGISTERED | Ein Client seine Registrierung löscht, ein Administrator die Anwendung löscht oder eine ungenutzte offene Registrierung entfernt wird. |
Die vollständige Liste finden Sie unter Audit-Ereignistypen.
Fehlerbehebung
invalid_tokenbei der Registrierung: Das Initial Access Token ist unbekannt, abgelaufen, widerrufen, oder ein einmaliges Token wurde bereits verwendet. Stellen Sie ein neues aus. Ohne Token ist die offene Registrierung ausgeschaltet.429bei einer anonymen Registrierung: Die Ratenbegrenzung der offenen Registrierung ist erreicht. Versuchen Sie es später erneut.invalid_tokenbeim Lesen, Ändern oder Löschen: Das Registration Access Token wurde bei der letzten Änderung durch ein neueres ersetzt, oder die Anwendung wurde gelöscht.invalid_client_metadatamit "dynamic client registration is not available": Das Abonnement enthält die Funktion nicht. Registrierungen und Änderungen werden abgelehnt; Lesen und Löschen einer bestehenden Registrierung funktionieren weiterhin.invalid_client_metadata: Die Metadaten verletzen eine der oben beschriebenen Regeln. Dieerror_descriptionnennt das Feld. Eine abgelehnte Anfrage verbraucht kein einmaliges Token.- Benutzer können sich nach der Registrierung nicht anmelden: Die Anwendung hat noch keine Zuweisungen. Weisen Sie auf der Registerkarte Zuweisungen der Anwendung Benutzer, Gruppen oder Verzeichnisse zu. Prüfen Sie bei einem offen registrierten Client, ob der Benutzer zu einem seiner Verzeichnisse gehört.