Erstellen, Bearbeiten oder Löschen von Claim Definitionen¶
Claim Definitionen werden dazu verwendet, Claims zu definieren. In einer ClaimDefinition kann beispielsweise der Typ (String, Int, Boolean, ...) eines Claims definiert werden.
Claims zuweisen
Um einem Benutzer einen Claim zuweisen zu können, muss erst eine Claim Definition erstellt werden. Die Erstellung von ClaimDefinitions ist der Rolle RootAdministrator vorbehalten.
Claim Definition erstellen¶
Admin > Claim Definitionen > Claim Definition erstellen
Die bearbeitbaren Punkte sind unter Claim Definition bearbeiten erläutert.
Claim Definition bearbeiten¶
Admin > Claim Definitionen > zu bearbeitende Claim Definition wählen
Bearbeitbar von Rolle¶
Mittels "bearbeitbar von Rolle" kann gesteuert werden, wer anschliessend den Claim bearbeiten kann.
| Bearbeitbar von Rolle | Beschreibung | Beispiel |
|---|---|---|
| User | Kann durch jeden Benutzer bearbeitet werden | Profilbild |
| Tenant Administrator | Kann nur durch TenantAdministratoren, Administratoren oder Root Administratoren bearbeitet werden | Benutzerrolle (user.role, siehe Beispiel) |
| Administrator | Kann nur durch Administratoren oder Root Administratoren bearbeitet werden. | Lizenzen |
Scope¶
Mittels Claim Scope wird geregelt, auf welcher Stufe die Claims gültig sind.
Scope ändern
Scope Änderungen von "Externer Provider" zu "User", "Tenant" oder "Global" und umgekehrt sind nicht möglich. Die Claim Definition muss erst gelöscht und danach erneut erstellt werden. So wird sichergestellt, dass alle bestehenden Claims gelöscht sind.
| Claim Scope | Beschreibung | Beispiel |
|---|---|---|
| User | Unterschiedlich von Benutzer zu Benutzer | Profilbild, Name, Rolle, ... |
| Tenant | Unterschiedlich von Organisation zu Organisation | Eine von der Organisation erworbene Lizenz |
| Global | für alle gleich | Umgebungstyp (Produktion, QS, ...) |
| Externer Provider | von OIDC Provider gemanagt | Rolle des Benutzers |
Claim Definition Scope Externer Provider
Claim Definitionen mit Scope "Externer Provider" haben als Hoheit den OIDC Provider und können im User Management nicht editiert werden. Beim Login gilt der vom OIDC Provider übermittelte Wert. So wird sichergestellt, dass vom OIDC Provider übermittelte Werte nicht übersteuert werden können.
Nach der Erstellung wird man zur ClaimDefinition, wo weitere Einstellungen möglich sind. Da wir bereits wissen, dass es die Rollen "Superuser", "Sachbearbeiter" und "Basic" geben wird, können diese Werte unter "Wählbare Werte" ergänzt werden. Anschliessend kann unter "Standardwert" definiert werden, dass ein Benutzer per Default den Wert "Basic" zugewiesen bekommt. Mit "Pflichtfeld" wird bestimmt, dass der Claim "user.role" für jeden Benutzer ergänzt werden muss.
Pflichtfeld¶
Mit dem Pflichtfeld kann definiert werden, ob es verpflichtend ist, den Claim zu ergänzen. Wenn die Anwendung ohne den Claim nicht funktioniert, sollte dieser als Pflichtfeld definiert werden.
Wofür werden Pflichtfelder verwendet
Ein beispiel für einen verpflichtenden Claim ist die Benutzerrolle "user.role". Wenn sich ein Benutzer bei elego einloggt und keine Rolle zugewiesen bekommt, wird er keine Aktionen ausführen können.
Minimaler Wert / Länge¶
Mit dem minimalen Wert kann je nach Art bestimmt werden:
- Wie Lange ein String mindestens sein muss
- Wie klein eine Zahl mindestens sein muss
- Welches datum mindestens gewählt werden muss
Maximaler Wert / Länge¶
Mit dem maximalen Wert kann je nach Art bestimmt werden:
- Wie Lange ein String maximal sein kann
- Wie gross eine Zahl mindestens sein kann
- Welches datum maximal gewählt werden kann
Regex (Regular Expression)¶
Mit Regex können für Strings Regeln implementiert werden, welche befolgt werden müssen.
Regex ausdrücke testen
Auf Regex101 können Reguläre Ausdrücke getestet werden.
| Regex Beispiel | Mögliche Werte |
|---|---|
| go*gle | ggle, gogle, google, gooogle, goooogle, ... |
| z{3,6} | zzz, zzzz, zzzzz, zzzzzz |
| \d{5}(-\d{4})? | Der Wert muss einer Amerikanischen Postleitzahl entsprechen |
| ^dog | Das Wort muss mit dog beginnen |
Wählbare Werte¶
Wenn für einen Claim nur vordefinierte Werte wählbar sind, können diese unter Wählbare Werte ergänzt werden. Nach der Eingabe wird ein Wert mit Enter gespeichert.
Claim Definition löschen¶
Wenn eine Claim Definition nicht mehr benötigt wird, kann diese gelöscht werden.
Claim Definition löschen
Die Löschung einer Claim Definition hat zur Folge, dass alle damit zusammenhängenden Claims ebenfalls gelöscht werden.
