859_Dokumentation_FAQs_uebernehmen(planning#859)

docs/details/jwk-creation.md

@@ -13,6 +13,9 @@ Die Ausführung des Skriptes setzt eine installierte Version von [Python](https:
 
 ### Windows
 Eine Anleitung zur Installation und Einrichtung unter Windows finden Sie unter [Installationsanleitung Python Windows](https://docs.microsoft.com/de-de/windows/python/beginners).
+:::note Hinweis
+Python sollte nicht über den Windows-Store installiert werden, da hier Probleme mit dem Installationspfad auftreten können. Außerdem sollte nach der Installation überprüft werden, ob Python auch wirklich der Systemvariablen PATH hinzugefügt wurde. Hierfür muss im Installationsprozess ein Häkchen gesetzt werden.
+:::
 
 ### Linux
 Der Ablauf und die Befehle zur Installation und Einrichtung von Python unter Linux unterscheiden sich je nach verwendeter Distribution.
@@ -46,8 +49,28 @@ Navigieren Sie anschließend zum Verzeichnis in dem Sie die Tools entpackt haben
 ### 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 jedoch sehr einfach mithilfe von **pip** und **poetry** nachinstallieren. Dazu kann unter Windows die **PowerShell** sowie **Terminal** unter Linux verwendet werden.
 
+:::note Hinweis
+Im Folgenden können sich je nach Installation die Kommandos ein wenig unterscheiden. <br />
+Pip: pip3, pip<br />
+Python: python3, python, py<br />
+:::
+
+Hier bietet es sich an, zunächst zu testen, ob Python korrekt installiert ist. Dazu dient der folgende Befehl:
+```console
+$ python -V
+```
+
+Eine korrekte Ausgabe sieht etwa so aus:
+```console
+Python 3.11.0
+```
+Sollte hier ein Fehler ausgegeben werden, dann muss statt 'python' zum Beispiel 'python3' oder 'py' verwendet werden, im Befehl zur Erstellung der JSON Web Keys (siehe unten "Ausführung des Skripts"). Sollte nach wie vor ein Fehler ausgegeben werden, dann muss die Installation überprüft werden.
+
+Nun können die zusätzlich benötigten Pakete wie folgt installiert werden.<br />
+
+
 ```console
-$ pip3 install poetry
+$ pip install poetry
 $ poetry install
 ```
 
@@ -55,7 +78,7 @@ $ poetry install
 Mit dem folgenden Befehl kann das Python-Skript zur Erstellung der JSON Web Keys ausgeführt werden.
 
 ```console
-$ poetry run python3 createSelfSignedJwks.py
+$ poetry run python createSelfSignedJwks.py
 ```
 
 In der Konsole wird dann im Erfolgsfall der Speicherort der Schlüssel ausgegeben: