Skip to content
Snippets Groups Projects
Commit 13b25cc5 authored by Marco Holz's avatar Marco Holz
Browse files

Einheitliche Begriffsverwendung + Tabs für Code-Beispiele

parent 7a307c4c
No related branches found
No related tags found
1 merge request!84Informationen zur Konfiguration des Antragsrouting ergänzt
Hide whitespace changes
Inline Side-by-side
docs/getting-started/receiving/routing.mdx
+ 29
− 13
View file @ 13b25cc5
...@@ -4,22 +4,25 @@ sidebar_position: 4 ...@@ -4,22 +4,25 @@ sidebar_position: 4
--- ---
import useBaseUrl from '@docusaurus/useBaseUrl'; import useBaseUrl from '@docusaurus/useBaseUrl';
import Tabs from '@theme/Tabs'
import TabItem from '@theme/TabItem'
Zustellpunkt Address Informationen können über einen Button in der Self-Service Portal Zustellpunkt Übersichts Liste in die Zwischenablage kopiert werden. Von der Zwischenablage kann es dann in das Redaktionssystem kopiert/import werden. Um eine [Auffindbarkeit des Zustellpunktes über die Routing API](../sending/get-destination.mdx) zu ermöglichen, müssen die konfigurierten Zuständigkeitsinformationen zunächst in einem an den Portalverbund angeschlossenen Landes-Redaktionssystem des FIM-Bausteins Leistungen hinterlegt werden.
Die zu einem Zustellpunkt gehörigen Zuständigkeits-/Adressierungsinformationen können im Self-Service-Portal über einen Button in der Zustellpunkt-Übersichtsliste in die Zwischenablage kopiert werden.
Von der Zwischenablage können diese Informationen dann in das zuständige Redaktionssystem kopiert/import werden.
<div class="center"> <div class="center">
<img width="800" alt="Zustellpunkt Address Informationen können über einen Button in der Zustellpunkt Übersichts Liste in die Zwischenablage kopiert werden. Von der Zwischenablage kann es dann in das Redaktionssystem kopiert/import werden." <img width="800" alt="Button in der Zustellpunkt-Übersichtsliste"
src={useBaseUrl('/images/ssp/destination-overview-export-address-information.png')}/> src={useBaseUrl('/images/ssp/destination-overview-export-address-information.png')}/>
</div> </div>
### Inhalt eines Zustellpunkt Address Informations JWK ### Inhalt der Adressierungsinformationen
Der dekodierte Inhalt (Payload) der Adressierungsinformationen sieht beispielhaft wie folgt aus (Leerzeichen und Zeilenumbrüche dienen ausschließlich der besseren Lesbarkeit):
Der Inhalt eines Address Informations JWK sieht beispielhaft und "json prettyfied" wie folgt aus:
```json ```json
{ {
"submissionHost": "zustelldienst.example.com", "submissionHost": "zustelldienst.example.com",
"iss": "https://portal.example.com", "iss": "https://self-service-portal.example.com",
"services": [ "services": [
{ {
"gebietIDs": [ "gebietIDs": [
...@@ -36,13 +39,13 @@ Der Inhalt eines Address Informations JWK sieht beispielhaft und "json prettyfie ...@@ -36,13 +39,13 @@ Der Inhalt eines Address Informations JWK sieht beispielhaft und "json prettyfie
} }
``` ```
### Signaturprüfung des vom Self-Service Portal (SSP) erstellten Zustellpunkt Address Informations JWK ### Signaturprüfung der vom Self-Service Portal (SSP) signierten Adressierungsinformationen
Bei den signierten Adressierungsinformationen handelt es sich um signierte JSON Web Tokens (JWTs).
Um die Signatur eines JWT zu überprüfen, welches vom SSP ausgestellt wurde, ist es notwendig auf die verwendeten Schlüssel zugreifen zu können. Um die Signatur der vom Self-Service-Portal signierten JWTs zu überprüfen, ist es notwendig, auf die verwendeten Schlüssel (im Format JSON Web Key, kurz JWK) zugreifen zu können.
Das SSP stellt ein JSON Web Key Set (JWKS) öffentlich zugänglich über den Endpunkt ``/.well-known/jwks.json` bereit. Für unser Testsystem ist das JWKS z.B. [hier](https://portal.auth-testing.fit-connect.fitko.dev/.well-known/jwks.json) verfügbar. Das Self-Service-Portal stellt ein JSON Web Key Set (JWKS) öffentlich zugänglich über den Endpunkt `/.well-known/jwks.json` bereit.
Für unser Testsystem ist das JWKS z.B. [hier](https://portal.auth-testing.fit-connect.fitko.dev/.well-known/jwks.json) verfügbar.
Ein Beispiel für ein JWKS ist in folgendem Ausschnitt dargestellt: Ein Beispiel für ein JWKS ist in folgendem Ausschnitt dargestellt:
```json ```json
{ {
"keys": [ "keys": [
...@@ -69,9 +72,19 @@ Ein Beispiel für ein JWKS ist in folgendem Ausschnitt dargestellt: ...@@ -69,9 +72,19 @@ Ein Beispiel für ein JWKS ist in folgendem Ausschnitt dargestellt:
] ]
} }
``` ```
Mit diesem JWK Set kann die Signatur eines Zustellpunkt Address Informations JWK überprüft werden.
Hierfür muss der Schlüssel mit der passenden `kid` aus dem Header des Zustellpunkt Address Informations JWK’s im JWK Set gesucht werden. Mit diesem JWKS kann die Signatur der Adressierungsinformationen überprüft werden.
Hierfür muss der Schlüssel mit der passenden Schlüssel-ID (Key-ID) aus dem `kid`-Header der Adressierungsinformationen im JWKS ermittelt werden.
Dann kann man mit diesem und einer entsprechenden Bibliothek eine Signaturprüfung durchführen. Dann kann man mit diesem und einer entsprechenden Bibliothek eine Signaturprüfung durchführen.
<Tabs
defaultValue="java"
values={[
{ label: 'Java (Spring)', value: 'java', },
]
}>
<TabItem value="java">
Im folgenden Beispiel wird die Bibliothek [nimbus-jose-jwt](https://connect2id.com/products/nimbus-jose-jwt) für die Prüfung genutzt. Im folgenden Beispiel wird die Bibliothek [nimbus-jose-jwt](https://connect2id.com/products/nimbus-jose-jwt) für die Prüfung genutzt.
```java ```java
...@@ -89,3 +102,6 @@ boolean verifySSPSignature(SignedJWT securityEventToken, String keyId) { ...@@ -89,3 +102,6 @@ boolean verifySSPSignature(SignedJWT securityEventToken, String keyId) {
return signedJWT.verify(jwsVerifier); return signedJWT.verify(jwsVerifier);
} }
``` ```
</TabItem>
</Tabs>
\ No newline at end of file
versioned_docs/version-FIT-Connect_v1/getting-started/receiving/routing.mdx
+ 29
− 13
View file @ 13b25cc5
...@@ -4,22 +4,25 @@ sidebar_position: 4 ...@@ -4,22 +4,25 @@ sidebar_position: 4
--- ---
import useBaseUrl from '@docusaurus/useBaseUrl'; import useBaseUrl from '@docusaurus/useBaseUrl';
import Tabs from '@theme/Tabs'
import TabItem from '@theme/TabItem'
Zustellpunkt Address Informationen können über einen Button in der Self-Service Portal Zustellpunkt Übersichts Liste in die Zwischenablage kopiert werden. Von der Zwischenablage kann es dann in das Redaktionssystem kopiert/import werden. Um eine [Auffindbarkeit des Zustellpunktes über die Routing API](../sending/get-destination.mdx) zu ermöglichen, müssen die konfigurierten Zuständigkeitsinformationen zunächst in einem an den Portalverbund angeschlossenen Landes-Redaktionssystem des FIM-Bausteins Leistungen hinterlegt werden.
Die zu einem Zustellpunkt gehörigen Zuständigkeits-/Adressierungsinformationen können im Self-Service-Portal über einen Button in der Zustellpunkt-Übersichtsliste in die Zwischenablage kopiert werden.
Von der Zwischenablage können diese Informationen dann in das zuständige Redaktionssystem kopiert/import werden.
<div class="center"> <div class="center">
<img width="800" alt="Zustellpunkt Address Informationen können über einen Button in der Zustellpunkt Übersichts Liste in die Zwischenablage kopiert werden. Von der Zwischenablage kann es dann in das Redaktionssystem kopiert/import werden." <img width="800" alt="Button in der Zustellpunkt-Übersichtsliste"
src={useBaseUrl('/images/ssp/destination-overview-export-address-information.png')}/> src={useBaseUrl('/images/ssp/destination-overview-export-address-information.png')}/>
</div> </div>
### Inhalt eines Zustellpunkt Address Informations JWK ### Inhalt der Adressierungsinformationen
Der dekodierte Inhalt (Payload) der Adressierungsinformationen sieht beispielhaft wie folgt aus (Leerzeichen und Zeilenumbrüche dienen ausschließlich der besseren Lesbarkeit):
Der Inhalt eines Address Informations JWK sieht beispielhaft und "json prettyfied" wie folgt aus:
```json ```json
{ {
"submissionHost": "zustelldienst.example.com", "submissionHost": "zustelldienst.example.com",
"iss": "https://portal.example.com", "iss": "https://self-service-portal.example.com",
"services": [ "services": [
{ {
"gebietIDs": [ "gebietIDs": [
...@@ -36,13 +39,13 @@ Der Inhalt eines Address Informations JWK sieht beispielhaft und "json prettyfie ...@@ -36,13 +39,13 @@ Der Inhalt eines Address Informations JWK sieht beispielhaft und "json prettyfie
} }
``` ```
### Signaturprüfung des vom Self-Service Portal (SSP) erstellten Zustellpunkt Address Informations JWK ### Signaturprüfung der vom Self-Service Portal (SSP) signierten Adressierungsinformationen
Bei den signierten Adressierungsinformationen handelt es sich um signierte JSON Web Tokens (JWTs).
Um die Signatur eines JWT zu überprüfen, welches vom SSP ausgestellt wurde, ist es notwendig auf die verwendeten Schlüssel zugreifen zu können. Um die Signatur der vom Self-Service-Portal signierten JWTs zu überprüfen, ist es notwendig, auf die verwendeten Schlüssel (im Format JSON Web Key, kurz JWK) zugreifen zu können.
Das SSP stellt ein JSON Web Key Set (JWKS) öffentlich zugänglich über den Endpunkt ``/.well-known/jwks.json` bereit. Für unser Testsystem ist das JWKS z.B. [hier](https://portal.auth-testing.fit-connect.fitko.dev/.well-known/jwks.json) verfügbar. Das Self-Service-Portal stellt ein JSON Web Key Set (JWKS) öffentlich zugänglich über den Endpunkt `/.well-known/jwks.json` bereit.
Für unser Testsystem ist das JWKS z.B. [hier](https://portal.auth-testing.fit-connect.fitko.dev/.well-known/jwks.json) verfügbar.
Ein Beispiel für ein JWKS ist in folgendem Ausschnitt dargestellt: Ein Beispiel für ein JWKS ist in folgendem Ausschnitt dargestellt:
```json ```json
{ {
"keys": [ "keys": [
...@@ -69,9 +72,19 @@ Ein Beispiel für ein JWKS ist in folgendem Ausschnitt dargestellt: ...@@ -69,9 +72,19 @@ Ein Beispiel für ein JWKS ist in folgendem Ausschnitt dargestellt:
] ]
} }
``` ```
Mit diesem JWK Set kann die Signatur eines Zustellpunkt Address Informations JWK überprüft werden.
Hierfür muss der Schlüssel mit der passenden `kid` aus dem Header des Zustellpunkt Address Informations JWK’s im JWK Set gesucht werden. Mit diesem JWKS kann die Signatur der Adressierungsinformationen überprüft werden.
Hierfür muss der Schlüssel mit der passenden Schlüssel-ID (Key-ID) aus dem `kid`-Header der Adressierungsinformationen im JWKS ermittelt werden.
Dann kann man mit diesem und einer entsprechenden Bibliothek eine Signaturprüfung durchführen. Dann kann man mit diesem und einer entsprechenden Bibliothek eine Signaturprüfung durchführen.
<Tabs
defaultValue="java"
values={[
{ label: 'Java (Spring)', value: 'java', },
]
}>
<TabItem value="java">
Im folgenden Beispiel wird die Bibliothek [nimbus-jose-jwt](https://connect2id.com/products/nimbus-jose-jwt) für die Prüfung genutzt. Im folgenden Beispiel wird die Bibliothek [nimbus-jose-jwt](https://connect2id.com/products/nimbus-jose-jwt) für die Prüfung genutzt.
```java ```java
...@@ -89,3 +102,6 @@ boolean verifySSPSignature(SignedJWT securityEventToken, String keyId) { ...@@ -89,3 +102,6 @@ boolean verifySSPSignature(SignedJWT securityEventToken, String keyId) {
return signedJWT.verify(jwsVerifier); return signedJWT.verify(jwsVerifier);
} }
``` ```
</TabItem>
</Tabs>
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment