Zum Inhalt springen

Änderungen von Dokument BundID

Zuletzt geändert von MACH ProForms GmbH am 03.03.2025
Von Version 13.1
bearbeitet von MACH ProForms GmbH
am 31.01.2024
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 6.1
bearbeitet von MACH ProForms GmbH
am 21.11.2023
Änderungskommentar: Neuen Anhang Schaubild2.png hochladen

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.fweise
1 +xwiki:XWiki.Dokumentation
Inhalt
... ... @@ -1,106 +1,10 @@
1 1  Die BundID-Funktionalitäten stehen ab dem Release 4.92 zur Verfügung.
2 2  
3 -In der Praxis können mehrere Architektur-Varianten für die Anbindung des Formularservers an die BundID vorkommen.
3 +In der Praxis können mehrere Architektur-Varianten für die Anbindung an des Formularservers an die BundID vorkommen.
4 4  
5 5  
6 -**Variante 1** - Anbindung an BundID direkt über den Formularserver
6 +**Variante 1** - Anbindung an BundID direkt über den Formularservice
7 7  
8 -[[image:Schaubild1.png||alt="Schaubild1" height="167" width="726"]]
8 +[[image:Schaubild1.png||alt="Schaubild1"]]
9 9  
10 -
11 -**Variante 2** - Anbindung an BundID über die vorgelagerte Einstiegsseite
12 -
13 -[[image:Schaubild2.png||alt="Schaubild2" height="192" width="733"]]
14 -
15 -
16 -**Variante 3** - Anbindung an BundID direkt über den Formularserver ohne Einstiegsseite
17 -
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>>doc:Main.03_Steuerungsprozess.02_Vorbefüllung.02_SecurePostdata.WebHome]] direkt in den Assistenten übergeben werden.
24 -
25 -
26 -=== Einstellungen in der Modulkonfiguration ===
27 -
28 -Die folgenden Einstellungen gelten nur für die Variante 1 oder 3.
29 -
30 -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.
31 -
32 -=== Keystore generieren ===
33 -
34 -Den Keystore kann man per CLI generieren, wenn ein JDK auf dem Rechner vorhanden ist.
35 -
36 -Folgender Befehl muss in der Konsole/Terminal ausgeführt werden:
37 -
38 -$keytool -genkeypair -alias <ALIAS> -keyalg RSA -storetype jks -keysize 4096 -validity 730 -keystore <PFAD>\<ALIAS>.jks
39 -\\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".
40 -In der Konsole werden Sie nach Ihrem Passwort und einigen Details zur Organisation nach folgendem Schemata gefragt. Notieren Sie sich das Passwort,
41 -dass Sie selber aussuchen, separat. Das Passwort wird in den nächsten Schritten benötigt:
42 -
43 -
44 -Enter keystore password:
45 -Re-enter new password:
46 -
47 -What is your first and last name?
48 -Unknown:
49 -What is the name of your organizational unit?
50 -Unknown:
51 -What is the name of your organization?
52 -Unknown:
53 -What is the name of your City or Locality?
54 -Unknown:
55 -What is the name of your State or Province?
56 -Unknown:
57 -What is the two-letter country code for this unit?
58 -Unknown:
59 -Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct?
60 -no: yes
61 -
62 -Enter key password for <alias>
63 -(RETURN if same as keystore password):
64 -
65 -
66 -Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das Mandantenrecht eID.
67 -
68 -Einstellungen für das Bürgerportal:
69 -
70 -Unter dem Reiter Login-Anbieter/ Bürgerportal der Modulkonfiguration finden Sie die Seite auf der die Einstellungen für die Anschließung der BundID vorzunehmen sind.
71 -
72 -[[image:Bürgerportal Schaubild.png||alt="Schaubild Buergerportal" height="494" width="720"]]
73 -
74 -
75 -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.
76 -
77 -Beim EntityID-Format bitte "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" muss auf "Ja" stehen.
78 -
79 -
80 -[[image:Portale.png||alt="Schaubild Portale" height="409" width="712"]]
81 -
82 -
83 -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 Anbindung 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 die BundID-Systeme mit dem Formularserver kommunizieren können.
84 -
85 -
86 -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.
87 -
88 -Bemerkung: damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden.
89 -
90 -
91 -Identity Provider XML-Datei für Testumgebung:
92 -
93 -[[idp.xml>>https://cloud.form-solutions.de/index.php/s/3pGew8qibdSs8yr]]
94 -
95 -Identity Provider XML-Datei für die Produktivumgebung:
96 -
97 -[[idp_prod.xml>>https://cloud.form-solutions.de/index.php/s/aZRHq2SnAxmownF]]
98 -
99 -
100 -=== Tool zur Validierung der Metadaten für die BundID ===
101 -
102 -Sollten Sie sich unsicher seien, ob die generierten Metadaten passend sind, dann können Sie dies mit Hilfe dieses Tools testen:
103 -
104 -[[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]]
105 -
106 -Wählen Sie dabei XSD (schema file) für Metadata aus und kopieren Sie die Inhalte der XML in das angegebene Feld.
10 +
Bürgerportal Schaubild.png
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,1 +1,0 @@
1 -116.0 KB
Inhalt
Portale.png
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,1 +1,0 @@
1 -65.7 KB
Inhalt
Schaubild3 (3).png
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,1 +1,0 @@
1 -19.9 KB
Inhalt