Skip to content

Doku: Zertifikatsumwandlung

Warum?

  • Viele Anbindungsprojekte haben Probleme mit der Zertifikatsumwandlung, daher ist die Überarbeitung der bestehenden Doku wichtig, um den Support-Aufwand zu minimieren
  • Verschiedene Probleme sind aufgetreten, die auf verschiedene Problemursprünge beruhen
  • Anforderung vom Anbindungsprojekt: Es wäre insofern wünschenswert, wenn in Zukunft ein Tool entwickelt und zur Verfügung gestellt wird, welches das Generieren der Webkeys über eine zuverlässige grafische Oberfläche durch einem Verwaltungsmitarbeiter ermöglicht, ohne externe IT-Dienstleister in Anspruch nehmen zu müssen. Hierbei sollte die übliche IT-Sicherheitsarchitektur in Verwaltungen (IT Grundschutz des Bundesamt für Sicherheit in der Informationstechnik) berücksichtigt werden, was derzeit bei der Prozedur zum Erstellen der WebKeys nicht der Fall ist.
  • Lösung ist eine möglichst kleinschrittige Dokumentation, welche die Voraussetzungen (Sicherheits- und Softwaremöglichkeiten) der Kommunen bedenkt

Relevante Links und Bemerkungen

Akzeptanzkriterien

  1. Leicht verständliche Sprache genutzt (auch für nicht It'ler verständlich)
  2. Intuitive Benutzung der Doku ermöglicht
  3. Intuitive Benutzung der Tools ermöglicht
  4. Alle externen Seiten sind verlinkt, sodass eine mögliche Installation von "falscher" oder schadhafter Software minimiert ist
  5. Alle Kommandos sind detailliert beschrieben
  6. am 27 Januar von Andreas angestoßene Diskussion in ein neues Issue überführen - anderes Team (#926 (comment 60466))

Durchführungsplan (von Entwickler:in bei Umsetzungsplanung auszufüllen)

  • Links zu jwk-creation ersetzen durch einen Link zur neuen Seite "jwks-erzeugen.mdx"
  • In der Datei "sidebar.js" LinK zu details/jwk-creation löschen -> Dadurch ist die Seite "Erstellen von JSON Web Keys für Testzwecke" nicht mehr unter dem Menüpunkt "Weiterführende Informationen" aufgeführt.
  • Die neue Seite "Dateien mit JSON Web Keys bereitstellen" (Datei "jwks-erzeugen.mdx") wird unter dem Menüpunkt "Infos für Verantwortliche > Leitfaden zur Anbindung von Fachverfahren" veröffentlicht.
  • Die Seite "Zertifikate" unter dem Menüpunkt "Infos für Entwicker:innen > Abruf von Einreichungen" wird gekürzt und erhält einen Link auf die neue Seite "Dateien mit JSON Web Keys bereitstellen" (Datei "jwks-erzeugen.mdx"),
  • Sammlung von Schwierigkeiten der Umwandlung
  • Voraussetzungen der Kommunen analysieren
  • Bestehende Dokumentation zusammenführen
  • Neugewonnene Erkenntnisse in die Dokumentation aufnehmen
  • In der Doku beschriebene Nachreichungen nachreichen
  • Definition of Done wurde geprüft
Edited by Michael Haidner