From 3fa940659699d0b59b2ded1cfda5e3982adc3b43 Mon Sep 17 00:00:00 2001 From: Pascal Osterwinter <pascal.osterwinter@spotgroup.de> Date: Fri, 24 Jun 2022 08:59:28 +0000 Subject: [PATCH] "Title" formatting. --- docs/receiving/certificate.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/receiving/certificate.mdx b/docs/receiving/certificate.mdx index bf02a8f98..0752604fa 100644 --- a/docs/receiving/certificate.mdx +++ b/docs/receiving/certificate.mdx @@ -156,7 +156,7 @@ Sie erhalten nach der Bestätigung eine Meldung, dass Ihr Zertifikat freigeschal <img width="600" alt="Zertifikat als *.der-Datei herunterladen" src={useBaseUrl('/images/certificate_registration/certificate_registration_11_3.png')} /> -### Ableitung eines FIT-Connect-kompatiblen JSON Web Keys aus einem Zertifikat +## Ableitung eines FIT-Connect-kompatiblen JSON Web Keys aus einem Zertifikat JSON Web Keys sind das Austauschformat in dem kryptografische Schlüssel in FIT-Connect zwischen der Destination und dem Onlinedienst ausgetauscht werden. Private Schlüssel sollten nach Möglichkeit dort generiert werden, wo sie am Ende eingesetzt werden. Ein Übertragen von privaten Schlüsseln zwischen Servern/Computern sollte vermieden werden. @@ -169,12 +169,12 @@ Sollte dies doch notwendig sein, so muss die Übermittlung nur verschlüsselt er ### Python Skript Für diesen Prozess wird [hier](https://git.fitko.de/fit-connect/fit-connect-tools) ein tool bereit gestellt um aus einem vorhandenen Zertifikat JWKs für die nutzung in der FIT-Connect API zu generieren. Die Nutzung des tools ist dort auch beschrieben. -## Herunterladen der FIT-Connect Tools +### Herunterladen der FIT-Connect Tools Laden Sie die [FIT-Connect-Tools als Zip-Datei](https://git.fitko.de/fit-connect/fit-connect-tools/-/archive/main/fit-connect-tools-main.zip) herunter und entpacken Sie sie an einem Ort Ihrer Wahl (Alternativ: Klonen Sie [unser Git-Repository](https://git.fitko.de/fit-connect/fit-connect-tools): `git clone https://git.fitko.de/fit-connect/fit-connect-tools.git`). Navigieren Sie anschließend zum Verzeichnis in dem Sie die Tools entpackt haben und öffnen Sie dort unter Windows eine **PowerShell** bzw. unter Linux ein **Terminal**. Alternativ können Sie auch innerhalb der **PowerShell** oder des **Terminals** zum Verzeichnis navigieren. -## Erforderliche Python-Pakete installieren +### Erforderliche Python-Pakete installieren Um das Skript zur Erstellung von JSON Web Keys auszuführen, werden zusätzliche Python Pakete benötigt. Diese lassen sich sehr einfach mithilfe von **pip** und **poetry** nachinstallieren. Dazu kann unter Windows die **PowerShell** sowie das **Terminal** unter Linux verwendet werden. ```console @@ -182,7 +182,7 @@ $ pip3 install poetry $ poetry install ``` -## Ausführung des Skripts +### Ausführung des Skripts Das Skript braucht einige Parameter um zu Funktionieren. - Der Pfad zu einem Zertifikat im PKCS12 Format (`-i`) - Den pfad an den die JWKs gespeichert werden sollen (`-o`) -- GitLab