Änderungen von Dokument BundID

Zuletzt geändert von MACH ProForms GmbH am 03.03.2025

Von Version 24.3
bearbeitet von MACH ProForms GmbH
am 03.03.2025
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 24.11
bearbeitet von MACH ProForms GmbH
am 03.03.2025
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -25,74 +25,16 @@
25 25  
26 26  
27 27  
28 -=== Einstellungen in der Modulkonfiguration ===
28 +=== Anbindung des Mandanten ===
29 29  
30 -Die folgenden Einstellungen gelten nur für die Variante 1 oder 3.
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  
32 -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.
33 33  
34 -=== Keystore generieren ===
33 +
35 35  
36 -Den Keystore kann man per CLI generieren, wenn ein JDK auf dem Rechner vorhanden ist.
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.
37 37  
38 -Folgender Befehl muss in der Konsole/Terminal ausgeführt werden:
39 39  
40 -$keytool -genkeypair -alias <ALIAS> -keyalg RSA -storetype jks -keysize 4096 -validity 730 -keystore <PFAD>\<ALIAS>.jks
41 -\\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".
42 -In der Konsole werden Sie nach Ihrem Passwort und einigen Details zur Organisation nach folgendem Schemata gefragt. Notieren Sie sich das Passwort,
43 -dass Sie selber aussuchen, separat. Das Passwort wird in den nächsten Schritten benötigt:
44 -
45 -
46 -Enter keystore password:
47 -Re-enter new password:
48 -
49 -What is your first and last name?
50 -Unknown:
51 -What is the name of your organizational unit?
52 -Unknown:
53 -What is the name of your organization?
54 -Unknown:
55 -What is the name of your City or Locality?
56 -Unknown:
57 -What is the name of your State or Province?
58 -Unknown:
59 -What is the two-letter country code for this unit?
60 -Unknown:
61 -Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct?
62 -no: yes
63 -
64 -Enter key password for <alias>
65 -(RETURN if same as keystore password):
66 -
67 -
68 -Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das Mandantenrecht eID.
69 -
70 -Einstellungen für das Bürgerportal:
71 -
72 -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.
73 -
74 -[[image:1736859216979-481.png]]
75 -
76 -
77 -[[image:1736859277992-433.png]]
78 -
79 -
80 -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.
81 -
82 -Beim EntityID-Format "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" muss auf "Ja" stehen.
83 -
84 -(% class="box warningmessage" %)
85 -(((
86 -**Der Keystoredateiupload und die Auswahl der EntityID "URL" müssen explizit durch Speichern an den Server übertragen werden.**
87 -)))
88 -
89 -Es erscheint der grüne Balken mit dem Hinweis "Es wurde bereits eine Keystore-Datei hinterlegt."
90 -Anschließend können Sie die "Service-Provider-Metadaten für BundID" herunterladen:
91 -
92 -
93 -Bei der Auswahl der Portalanbieter stehen Ihnen das AKDB-Bürgerportal, das BundID-Bürgerportal, Mein UnternehmensKonto, 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.
94 -
95 -
96 96  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.
97 97  
98 98  Identity Provider XML-Datei für Testumgebung: [[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]]