Zum Inhalt springen

Änderungen von Dokument BundID

Zuletzt geändert von MACH ProForms GmbH am 03.03.2025
Von Version 7.2
bearbeitet von MACH ProForms GmbH
am 21.11.2023
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 9.3
bearbeitet von MACH ProForms GmbH
am 21.11.2023
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -16,3 +16,95 @@
16 16  **Variante 3** - Anbindung an BundID direkt über den Formularserver ohne Einstiegsseite
17 17  
18 18  [[image:Schaubild3 (3).png||alt="Schaubild3" height="239" width="735"]]
19 +
20 +
21 +Für die Variante 1 und 3 sind einige Einstellungen in der Modulkonfiguration des Mandanten zu treffen.
22 +
23 +Im Falle der Variante 2 können die Daten über die SecurePostData Schnittstelle
24 +
25 +([[https:~~/~~/wiki.form-solutions.de/wiki/admindoku/view/Main/03_Steuerungsprozess/02_Vorbef%C3%BCllung/02_SecurePostdata/>>url:https://wiki.form-solutions.de/wiki/admindoku/view/Main/03_Steuerungsprozess/02_Vorbef%C3%BCllung/02_SecurePostdata/]])
26 +
27 +direkt in den Assistenten übergeben werden.
28 +
29 +
30 +== Einstellungen in der Modulkonfiguration ==
31 +
32 +Die folgenden Einstellungen gelten nur für die Variante 1 oder 3.
33 +
34 +Wir empfehlen die Nutzung des Browser **Chrome oder Edge **bei der Einstellung der Modulkonfiguration. Firefox stellt auf Grund eines sehr alten Bugs die XML Datei teils falsch dar.
35 +
36 +=== Keystore generieren ===
37 +
38 +Den Keystore kann man per CLI generieren, wenn ein JDK auf dem Rechner vorhanden ist.
39 +
40 +Folgender Befehl muss in der Konsole/Terminal ausgeführt werden:
41 +
42 +$keytool -genkeypair -alias <ALIAS> -keyalg RSA -storetype jks -keysize 4096 -validity 730 -keystore <PFAD>\<ALIAS>.jks
43 +\\Der Pfad steht für die Location an der der Keystore gespeichert werden soll. Der Alias ist gleichzusetzen mit dem Namen der Kommune, bspw. "NewYorkCity".
44 +In der Konsole werden Sie nach Ihrem Passwort und einigen Details zur Organisation nach folgendem Schemata gefragt. Notieren Sie sich das Passwort,
45 +dass Sie selber aussuchen, separat. Das Passwort wird in den nächsten Schritten benötigt:
46 +
47 +
48 +Enter keystore password:
49 +Re-enter new password:
50 +
51 +What is your first and last name?
52 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
53 +What is the name of your organizational unit?
54 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
55 +What is the name of your organization?
56 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
57 +What is the name of your City or Locality?
58 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
59 +What is the name of your State or Province?
60 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
61 +What is the two-letter country code for this unit?
62 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
63 +Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct?
64 +[[no>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=no&linkCreation=true&fromPageId=127858922]]: yes
65 +
66 +Enter key password for <alias>
67 +(RETURN if same as keystore password):
68 +
69 +
70 +Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das eID Mandantenrecht.
71 +
72 +Einstellungen für das Bürgerportal:
73 +
74 +Unter dem Reiter Login-Anbieter/ Bürgerportal der Modulkonfiguration finden Sie die Seite auf der die Einstellungen für die Anschließung der BundID zu machen sind.
75 +
76 +[[image:Bürgerportal Schaubild.png||alt="Schaubild Buergerportal" height="494" width="720"]]
77 +
78 +
79 +Die vorher generierte Keystore Datei muss für den jeweiligen Mandanten hochgeladen werden. Das Passwort der Keystore Datei sowie der KeyStore Alias müssen angegeben werden.
80 +
81 +Beim EntityID-Format bitte "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" soll auf "Ja" stehen.
82 +
83 +
84 +[[image:Portale.png||alt="Schaubild Portale" height="409" width="712"]]
85 +
86 +
87 +Bei der Auswahl der Portalanbieter stehen Ihnen das AKDB-Bürgerportal, das BundID-Bürgerportal sowie das OSI-Bürgerportal zur Verfügung. Sollten Sie schon ein Portal ausgewählt haben, benötigen jedoch für die Anschließung des neuen Bürgerportals eine andere Service-Provider-Metadaten Datei, können Sie diese durch Anklicken des Links jederzeit generieren. Für die Anbindung an BundID generieren Sie die "**Service-Provider-Metadaten für BundID**". Es öffnet sich eine neue Seite, deren Inhalte in eine XML-Datei gespeichert werden muss. Diese Datei ist notwendig zur Weiterleitung an den Mandanten beziehungsweise das Bundesministerium des Inneren. Nur auf Basis der Kenntnis der Inhalte dieser XML-Datei ist es möglich, dass sich die BundID-Systeme mit dem Formularserver "verstehen".
88 +
89 +
90 +Beim "SAML-Identity-Provider" laden Sie die so genannte Identity Provider XML-Datei hoch. Für jedes Portal ist diese unterschiedlich. Nach erfolgreicher Freigabe durch das BMI und der Einpflege der IDP-XML ist die Anbindung komplett.
91 +
92 +Bemerkung: damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden.
93 +
94 +
95 +Identity Provider XML-Datei für Testumgebung:
96 +
97 +[[idp.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp.xml?version=1&modificationDate=1700496069973&api=v2]]
98 +
99 +Identity Provider XML-Datei für die Produktivumgebung:
100 +
101 +[[idp_prod.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp_prod.xml?version=1&modificationDate=1700553044769&api=v2]]
102 +
103 +
104 +=== Tool zur Validierung der Metadaten für die BundID ===
105 +
106 +Sollten Sie sich unsicher seien, ob die generierten Metadaten passend sind, dann können Sie dies mit Hilfe dieses Tools testen:
107 +
108 +[[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]]
109 +
110 +Wählen Sie dabei XSD (schema file) für Metadata aus und kopieren Sie die Inhalte der XML in das angegebene Feld.
Bürgerportal Schaubild.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,0 +1,1 @@
1 +116.0 KB
Inhalt
Portale.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,0 +1,1 @@
1 +65.7 KB
Inhalt