Client-Referenz (Advanced Options)¶
Beim Bearbeiten eines Clients sind dessen Eigenschaften in Menüpunkte gegliedert. Diese Seite ist eine Referenz für die drei „erweiterten“ Bereiche — Advanced Options, Advanced Collections und Advanced Properties. Die meisten Werte sind bereits durch das Client-Template vorkonfiguriert und müssen selten geändert werden.
Die übrigen Menüpunkte (Name, Client Secrets, Allowed Grants, Allowed Scopes) werden
in Web Anwendung, API Client und Grant Types und Flows behandelt.
Advanced Options¶
Dies sind An/Aus-Schalter. Jede Beschreibung entspricht dem im Admin-UI angezeigten Text.
Authentifizierung & Sicherheit
Option |
Beschreibung |
|---|---|
|
Erfordert ein Client Secret für Anfragen an den Token-Endpoint. |
|
Erzwingt Proof Key for Code Exchange (PKCE) für Authorization-Code-Flows. |
|
Erlaubt die weniger sichere Klartext-Code-Challenge-Methode für PKCE. |
|
Erfordert, dass Authorization Requests Pushed Authorization Requests (PAR) verwenden. |
|
Erlaubt die Rückgabe von Access Tokens in Browser-URL-Fragmenten (Implicit Flow). |
|
Erlaubt Benutzern die Anmeldung mit lokalem Benutzernamen und Passwort. |
|
Aktiviert oder deaktiviert diesen Client vollständig. |
Consent
Option |
Beschreibung |
|---|---|
|
Zeigt Benutzern vor der Autorisierung des Clients den Consent-Screen an. |
|
Lässt Benutzer ihre Consent-Entscheidung speichern, um den Consent-Screen künftig zu überspringen. |
Tokens & Claims
Option |
Beschreibung |
|---|---|
|
Erlaubt Clients, Refresh Tokens für Offline-Zugriff anzufordern. |
|
Stellt beim Verwenden eines Refresh Tokens aktualisierte Access-Token-Claims neu aus. |
|
Fügt jedem JWT Access Token einen eindeutigen jti-Claim zur Nachverfolgung hinzu. |
|
Nimmt Client-Claims immer in den Token auf, auch ohne Benutzerinteraktion. |
|
Nimmt alle angeforderten Benutzer-Claims direkt in den Identity Token auf. |
Logout
Option |
Beschreibung |
|---|---|
|
Nimmt die Session-ID in Front-Channel-Logout-iframe-Requests auf. |
|
Sendet die Session-ID in Back-Channel-Logout-Benachrichtigungen. |
Advanced Collections¶
Listenbasierte Werte — ein Eintrag pro Zeile. Kommt später ein Request mit einem Wert, der nicht in der jeweiligen Liste steht, weist IdentityServerNET ihn ab.
Collection |
Zweck |
|---|---|
|
Erlaubte URIs, zu denen nach erfolgreicher Anmeldung weitergeleitet wird (Authorization Code / Implicit). Für interaktive Clients erforderlich. |
|
Erlaubte URIs, zu denen nach dem Logout weitergeleitet wird. |
|
Browser-Origins, die IdentityServerNET-Endpoints per CORS aufrufen dürfen. Relevant für SPA-/JavaScript-Clients. |
|
Schränkt ein, welche externen Identity Provider dieser Client verwenden darf. Leer bedeutet: alle konfigurierten Provider sind erlaubt. |
|
Nur für Realm-gebundene Clients. Zusätzliche, über den eigenen Realm des Clients hinausgehende
E-Mail-Domains, die sich anmelden dürfen; |
Bemerkung
Die einzelnen Logout-URIs FrontChannelLogoutUri und BackChannelLogoutUri werden zusammen
mit den Collections bearbeitet. Sie verweisen auf den Client-Endpoint, den IdentityServerNET
aufruft, um ein Logout zu propagieren.
Advanced Properties¶
Numerische Lebensdauern und Token-Verhalten. Die Defaults sind in Sekunden angegeben und müssen in der Regel nicht geändert werden.
Property |
Default |
Bedeutung |
|---|---|---|
|
300 |
Lebensdauer des Identity Tokens (5 Minuten). |
|
3600 |
Lebensdauer des Access Tokens (1 Stunde). |
|
300 |
Lebensdauer des Authorization Codes (5 Minuten). |
|
2592000 |
Maximale Lebensdauer eines Refresh Tokens (30 Tage). |
|
1296000 |
Gleitendes Fenster, um das ein Refresh Token bei Verwendung verlängert wird (15 Tage). |
|
null |
Lebensdauer des gespeicherten Consents. |
|
300 |
Lebensdauer eines Device Codes im Device Flow (5 Minuten). |
|
null |
Maximales Alter der Single-Sign-On-Session eines Benutzers für diesen Client. |
Token-Verhalten (Enumerationen):
Property |
Werte |
|---|---|
|
|
|
|
|
|
Weitere Properties:
ClientClaimsPrefix— Präfix für Client-Claims im Token (Standardclient_).PairWiseSubjectSalt— Salt zur Erzeugung paarweiser (pairwise) Subject-Identifier.UserCodeType— das User-Code-Format für den Device Flow.