From 37b9052a0c311c4118b18d0e7f5b092c6f4139d7 Mon Sep 17 00:00:00 2001 From: Lilith Wittmann <mail@lilithwittmann.de> Date: Wed, 9 Jun 2021 20:08:46 +0200 Subject: [PATCH] feat(oauth): minor fixes --- docs/Detailinformationen/OAuth.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/Detailinformationen/OAuth.md b/docs/Detailinformationen/OAuth.md index 009dfab4..fb698d71 100644 --- a/docs/Detailinformationen/OAuth.md +++ b/docs/Detailinformationen/OAuth.md @@ -47,13 +47,15 @@ Nachdem der Assistent abgeschlossen wurde, sollte im aktuellen Verzeichnis eine Mithilfe der fitconnect-cli können JWTs zum Abrufen von bzw. Versenden von Anträgen generiert werden. Dabei wird zuerst über das OAuth 2 Client Credentials Verfahren ein JWT abgerufen und dann falls Antreäge versendet werden sollen der sogenannte Online-Service-Token mit eingeschränkten Berechtigungen davon abgeleitet. +### Abrufen von JWTs für antragssendene Systeme (Onlineservices) + Für die Generierung von JWTs zum Versenden von Anträgen muss neben der Konfiguration außerdem über den Parameter *destination* angegeben werden, an welche Destination-IDs Anträge gesendet werden sollen. ```bash fitconnect get_jwt --config=test_sender.json --destination "d771f1d8-6967-4740-9668-82c5a910a29b" ``` -Bei erfolgreicher Generierung erhält man ein JSON-Objekt mit einem Token und einen Online-Service-Token zurück. Diese können dann dazu verwendet werden um mithilfe eines FIT-Connect-API-Client oder CURL einen Antrag versenden. +Bei erfolgreicher Generierung erhält man ein JSON-Objekt mit einem User-Token und einen Online-Service-Token zurück. Diese können dann dazu verwendet werden um mithilfe eines FIT-Connect-API-Client oder CURL einen Antrag versenden. ```json { @@ -105,13 +107,15 @@ Ein CURL-Request um dann mit diesen Tokens auf die API zuzugreifen, könnte z.B. curl -i -H "Accept: application/json" -H "Content-Type: application/json" -H "token: ...token..." -H "online-service-token: ...online-service-token..." https://fit-connect-url.einfügen ``` +### Abrufen von JWTs für antragsempfangende Systeme (Fachverfahren / virtuelle Poststellen + Wenn ein JWT zum Abrufen von Anträgen generiert werden soll, kann auf den Parameter destination verzichtet werden. ```bash fitconnect get_jwt --config=test_receiver.json ``` -Bei erfolgreicher Generierung erhält man einen JWT Token, welchen man zur Authentifizierung gbeim Abrufen von Anträgen verwenden kann +Als Antwort erhält man einen (vom Authentifizierungsserver via OAuth Client Credentials abgerufenen) JWT, welchen man zur Authentifizierung beim Abrufen von Anträgen verwenden kann. ```bash curl -i -H "Accept: application/json" -H "Content-Type: application/json" -H "token: ...token..." https://fit-connect-url.einfügen -- GitLab