Zum Inhalt springen

Änderungen von Dokument BundID

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

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,14 +1,8 @@
1 1  Die BundID-Funktionalitäten stehen ab dem Release 4.92 zur Verfügung.
2 2  
3 -== Architektur-Varianten ==
3 +In der Praxis können mehrere Architektur-Varianten für die Anbindung der MACH formsolutions an die BundID vorkommen.
4 4  
5 -Es sind drei Architektur-Varianten der Anbindung von MACH formsolutions an die BundID möglich.
6 6  
7 -Für die Variante 1 und 3 sind Einstellungen in der Modulkonfiguration des Mandanten zu treffen.
8 -
9 -Bei 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.
10 -
11 -
12 12  **Variante 1** - Anbindung an BundID direkt über die Software
13 13  
14 14  [[image:Schaubild1.png||alt="Schaubild1" height="167" width="726"]]
... ... @@ -24,17 +24,78 @@
24 24  [[image:Schaubild3 (3).png||alt="Schaubild3" height="239" width="735"]]
25 25  
26 26  
21 +Für die Variante 1 und 3 sind einige Einstellungen in der Modulkonfiguration des Mandanten zu treffen.
27 27  
28 -=== Anbindung des Mandanten ===
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.
29 29  
30 -Die Konfiguration für die Varianten 1 und 3 ist in der [[Anwenderdokumentation BundID>>https://wiki.machproforms.de/wiki/docwiki/view/Main/09_Schnittstellen/02_Konten/BundID/]] beschrieben.
31 31  
26 +=== Einstellungen in der Modulkonfiguration ===
32 32  
33 -
28 +Die folgenden Einstellungen gelten nur für die Variante 1 oder 3.
34 34  
35 - Nur auf Basis der Kenntnis der Inhalte dieser XML-Datei ist es möglich, dass die BundID-Systeme mit der MACH formsolutions Plattform kommunizieren können.
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.
36 36  
32 +=== Keystore generieren ===
37 37  
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 Anbindung 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 "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" muss auf "Ja" stehen.
78 +
79 +(% class="box warningmessage" %)
80 +(((
81 +**Der Keystoredateiupload und die Auswahl der EntityID "URL" müssen explizit durch Speichern an den Server übertragen werden.**
82 +)))
83 +
84 +Es erscheint der grüne Balken mit dem Hinweis "Es wurde bereits eine Keystore-Datei hinterlegt."
85 +Anschließend können Sie die "Service-Provider-Metadaten für BundID" herunterladen:
86 +
87 +[[image:Portale.png||alt="Schaubild Portale" height="409" width="712"]]
88 +
89 +
90 +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 Innern. Nur auf Basis der Kenntnis der Inhalte dieser XML-Datei ist es möglich, dass die BundID-Systeme mit der MACH formsolutions Plattform kommunizieren können.
91 +
92 +
38 38  Beim "SAML-Identity-Provider" laden Sie die 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.
39 39  
40 40  Identity Provider XML-Datei für Testumgebung: [[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]]
... ... @@ -65,7 +65,7 @@
65 65  
66 66  ==== Validierungstool ====
67 67  
68 -Die Metadaten können Sie mit Hilfe dieses Tools validieren:
123 +Die Metadaten können Sie dies mit Hilfe dieses Tools validieren:
69 69  
70 70  [[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]]
71 71  
1736859216979-481.png
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,1 +1,0 @@
1 -50.0 KB
Inhalt
1736859277992-433.png
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,1 +1,0 @@
1 -65.6 KB
Inhalt