Änderungen von Dokument BundID
Zuletzt geändert von MACH ProForms GmbH am 03.03.2025
Von Version 21.1
bearbeitet von MACH ProForms GmbH
am 20.08.2024
am 20.08.2024
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Auf Version 24.11
bearbeitet von MACH ProForms GmbH
am 03.03.2025
am 03.03.2025
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Zusammenfassung
-
Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
-
Anhänge (0 geändert, 2 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- Inhalt
-
... ... @@ -1,8 +1,14 @@ 1 1 Die BundID-Funktionalitäten stehen ab dem Release 4.92 zur Verfügung. 2 2 3 - Inder Praxis können mehrereArchitektur-Variantenfür die Anbindung der MACH formsolutions an die BundID vorkommen.3 +== Architektur-Varianten == 4 4 5 +Es sind drei Architektur-Varianten der Anbindung von MACH formsolutions an die BundID möglich. 5 5 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 + 6 6 **Variante 1** - Anbindung an BundID direkt über die Software 7 7 8 8 [[image:Schaubild1.png||alt="Schaubild1" height="167" width="726"]] ... ... @@ -18,78 +18,17 @@ 18 18 [[image:Schaubild3 (3).png||alt="Schaubild3" height="239" width="735"]] 19 19 20 20 21 -Für die Variante 1 und 3 sind einige Einstellungen in der Modulkonfiguration des Mandanten zu treffen. 22 22 23 - ImFalle der Variante 2 könnendie Datenüberdie[[SecurePostDataSchnittstelle>>doc:Main.03_Steuerungsprozess.02_Vorbefüllung.02_SecurePostdata.WebHome]] direkt inden Assistentenübergeben werden.28 +=== Anbindung des Mandanten === 24 24 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. 25 25 26 -=== Einstellungen in der Modulkonfiguration === 27 27 28 - Diefolgenden Einstellungen gelten nur für die Variante 1 oder 3.33 + 29 29 30 - Wirempfehlen dieNutzungdesBrowser **ChromeoderEdge**bei derEinstellungder Modulkonfiguration.Firefoxstelltauf Grundeinessehralten Bugs dieXMLDateiteilsfalschdar.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. 31 31 32 -=== Keystore generieren === 33 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 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 - 93 93 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. 94 94 95 95 Identity Provider XML-Datei für Testumgebung: [[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]]
- 1736859216979-481.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.Dokumentation - Größe
-
... ... @@ -1,0 +1,1 @@ 1 +50.0 KB - Inhalt
- 1736859277992-433.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.Dokumentation - Größe
-
... ... @@ -1,0 +1,1 @@ 1 +65.6 KB - Inhalt