Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- edpweb3:jwt_external [2024/12/19 11:35] – angelegt admin
+++ edpweb3:jwt_external [2024/12/19 17:13] (aktuell) – admin
@@ Zeile 10: / Zeile 10: @@
 In der edpweb.ini muss folgender Block ergänzt werden:
+<code>
 [JWT External]
 Aktiv=1
 ;Angabe des Secrets für das JWT
 Secret=...
-;Bezeichnung des Claims für den Benutzernamen
+</code>
-FieldUsername=sub
-;Bezeichnung des Claims für die Funktion
-FieldFunktion=funktion
-;Bezeichnung des Claims für die Benutzerrolle
-FieldUserlevel=rolle
-;Bezeichnung des Claims für das Ortsfeld (benötigt bei der Benutzerrolle abteilung)
-FieldOrt=ort
+Innerhalb des erzeugten JWTs müssen folgende Claims im Payload enthalten sein:
+  * **sub**: Hier wird der Benutzername angegeben, unter dem der Benutzer in EDP angemeldet wird.
+  * **funktion**: Die Funktion definiert den Funktionsnamen, mit dem der Benutzer in EDP Web angemeldet wird.
+  * **rolle**: Hier muss die jeweilige Benutzerrolle angegeben werden, mit der der Benutzer in EDP Web angemeldet wird. Üblicherweise wären das default, abschnitt oder abteilung.
+  * **ort**:  Wenn der Benutzer mit der Abteilungsrolle angemeldet wird, muss hier zusätzlich noch das Ortsfeld angegeben werden, also die Filterung des Einsatzzugriffs auf einen bestimmten Bereich.
-Innerhalb des erzeugten JWTs müssen folgende Inhalte im Claim enthalten sein.
+Die Gültigkeit des JWTs sollte nur wenige Sekunden betragen, da es nur einmalig für die Anmeldung genutzt wird. Die Konfiguration dazu erfolgt auf Ebene des Drittsystems.
-Benutzername.
+Bitte beachten Sie darauf, dass das Secret eine ausreichende Komplexität besitzt.
-Hier wird der Benutzername angegeben, unter dem der Benutzer in EDP angemeldet wird.
+===== Aufruf des Endpoints =====
-Funktion.
+Wenn der Endpoint in der Konfiguration aktiviert wurde, ist er wie folgt erreichbar:
-Die Funktion definiert den Funktionsnamen, mit dem der Benutzer in EDP Web angemeldet wird.
+====Aufruf per HTTP GET ====
+<code>
+https://ip-adresse:port/jwt_ext?jwt={JWT}
+</code>
-Benutzerrolle.
+An Stelle von {JWT} muss das JWT angegeben sein.
-Hier muss die jeweilige Benutzerrolle angegeben werden, mit der der Benutzer in EDP Web angemeldet wird.
+==== Aufruf per HTTP POST ====
+<code>
+https://ip-adresse:port/jwt_ext
-Üblicherweise wären das Default, Abschnitt oder Abteilung.
+Header:
+...
+Authorization: Bearer {JWT}
+</code>
-Weitere Informationen zu den Benutzerrollen finden Sie hier.
-Ortsfeld.
+===== Anpassung der Zuordnung der Claims =====
-Wenn der Benutzer mit der Abteilungsrolle angemeldet wird, muss hier zusätzlich noch das Ortsfeld angegeben werden.
+Sollte die Bezeichnung der Claims anderslautend als o.g. sein, so kann in der edpweb.ini zudem unter [JWT External] noch folgendes ergänzt werden:
-Sprich die Filterung des Einsatzzugriffs auf einen bestimmten Bereich.
-Weitere Informationen dazu finden Sie hier.
-Die Gültigkeit des JWTs sollte nur wenige Sekunden betragen, da es nur einmalig für die Anmeldung genutzt wird.
-Die Konfiguration dazu erfolgt auf Ebene des Drittsystems.
-Zuordnung der Claims zu den Datenfeldern auf Ebene von EDP.
-Die jeweiligen Felder im GWT können über die Konfiguration zugeordnet werden.
-Wenn die Feldnamen die EDP erwartet, von denen des GWTs abweicht.
-Bitte beachten Sie darauf, dass das Secret eine ausreichende Komplexität besitzt.
-===== Aufruf des Endpoints =====
-Wenn der Endpoint in der Konfiguration aktiviert wurde, ist er wie folgt erreichbar:
 <code>
-https://ip-adresse:port/jwt_ext?jwt=...
+[JWT External]
+Aktiv=1
+;Angabe des Secrets für das JWT
+Secret=...
+;Bezeichnung des Claims für den Benutzernamen
+FieldUsername=sub
+;Bezeichnung des Claims für die Funktion
+FieldFunktion=funktion
+;Bezeichnung des Claims für die Benutzerrolle
+FieldUserlevel=rolle
+;Bezeichnung des Claims für das Ortsfeld (benötigt bei der Benutzerrolle abteilung)
+FieldOrt=ort
 </code>