Änderungen von Dokument BundID

Zuletzt geändert von MACH ProForms GmbH am 03.03.2025

Von 9.2 nach 9.1 Von 24.4 nach 24.3

Von Version 24.3

bearbeitet von MACH ProForms GmbH
am 03.03.2025

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 9.2

bearbeitet von MACH ProForms GmbH
am 21.11.2023

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
Anhänge (0 geändert, 0 hinzugefügt, 2 gelöscht)
- 1736859216979-481.png
- 1736859277992-433.png

Details

Seiteneigenschaften

Inhalt

@@ -1,16 +1,10 @@
  Die BundID-Funktionalitäten stehen ab dem Release 4.92 zur Verfügung.
--== Architektur-Varianten ==
++In der Praxis können mehrere Architektur-Varianten für die Anbindung an des Formularservers an die BundID vorkommen.
--Es sind drei Architektur-Varianten der Anbindung von MACH formsolutions an die BundID möglich.
--Für die Variante 1 und 3 sind Einstellungen in der Modulkonfiguration des Mandanten zu treffen.
++**Variante 1** - Anbindung an BundID direkt über den Formularservice
--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.
--
--
--**Variante 1** - Anbindung an BundID direkt über die Software
--
  [[image:Schaubild1.png||alt="Schaubild1" height="167" width="726"]]
@@ -19,14 +19,18 @@
  [[image:Schaubild2.png||alt="Schaubild2" height="192" width="733"]]
--**Variante 3** - Anbindung an BundID direkt über die Software ohne Einstiegsseite
++**Variante 3** - Anbindung an BundID direkt über den Formularserver ohne Einstiegsseite
  [[image:Schaubild3 (3).png||alt="Schaubild3" height="239" width="735"]]
++Für die Variante 1 und 3 sind einige Einstellungen in der Modulkonfiguration des Mandanten zu treffen.
--=== Einstellungen in der Modulkonfiguration ===
++Im Falle der Variante 2 können die Daten über die SecurePostData Schnittstelle ([[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/]]) direkt in den Assistenten übergeben werden.
++
++== Einstellungen in der Modulkonfiguration ==
++
  Die folgenden Einstellungen gelten nur für die Variante 1 oder 3.
  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.
@@ -47,84 +47,62 @@
  Re-enter new password:
  What is your first and last name?
--Unknown:
++[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
  What is the name of your organizational unit?
--Unknown:
++[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
  What is the name of your organization?
--Unknown:
++[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
  What is the name of your City or Locality?
--Unknown:
++[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
  What is the name of your State or Province?
--Unknown:
++[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
  What is the two-letter country code for this unit?
--Unknown:
++[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
  Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct?
--no: yes
++[[no>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=no&linkCreation=true&fromPageId=127858922]]: yes
  Enter key password for <alias>
  (RETURN if same as keystore password):
--Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das Mandantenrecht eID.
++Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das eID Mandantenrecht.
  Einstellungen für das Bürgerportal:
--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.
++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.
--[[image:1736859216979-481.png]]
++[[image:Bürgerportal Schaubild.png||alt="Schaubild Buergerportal" height="494" width="720"]]
--[[image:1736859277992-433.png]]
--
--
  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.
--Beim EntityID-Format "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" muss auf "Ja" stehen.
++Beim EntityID-Format bitte "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" soll auf "Ja" stehen.
--(% class="box warningmessage" %)
--(((
--**Der Keystoredateiupload und die Auswahl der EntityID "URL" müssen explizit durch Speichern an den Server übertragen werden.**
--)))
--Es erscheint der grüne Balken mit dem Hinweis "Es wurde bereits eine Keystore-Datei hinterlegt."
--Anschließend können Sie die "Service-Provider-Metadaten für BundID" herunterladen:
++[[image:Portale.png||alt="Schaubild Portale" height="409" width="712"]]
--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.
++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 Anschließung 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".
--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.
++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 steht der Anschluss.
--Identity Provider XML-Datei für Testumgebung: [[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]]
++Bemerkung: damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden.
--Identity Provider XML-Datei für die Produktivumgebung: [[idp_prod.xml>>https://cloud.machproforms.de/index.php/s/P5tNDtQkyDc4QGY]]
--(% class="box warningmessage" %)
--(((
--Damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden.
--)))
++Identity Provider XML-Datei für Testumgebung:
++[[idp.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp.xml?version=1&modificationDate=1700496069973&api=v2]]
--=== Überprüfung der Metadaten für die BundID ===
++Identity Provider XML-Datei für die Produktivumgebung:
--==== EntityID Prüfung ====
++[[idp_prod.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp_prod.xml?version=1&modificationDate=1700553044769&api=v2]]
--Kontrollieren Sie mit einem Texteditor, dass in der XML-Datei der Service-Provider-Metadaten die EntityID im Format ##"https:~/~/(Formularserveradresse)" angegeben ist.##
--Beispiel:
++=== Tool zur Validierung der Metadaten für die BundID ===
--{{code language="xml"}}
--<md:EntityDescriptor entityID="https://pdf.form-solutions.net/00000000-0000/sso" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata">
--{{/code}}
++Sollten Sie sich unsicher seien, ob die generierten Metadaten passend sind, dann können Sie dies mit Hilfe dieses Tools testen:
--(% class="wikigeneratedid" %)
--Sollte hier stattdessen die Adresse im Format "##entityID="urn:pdf.form-solutions.de:00000000-0000:sso"## stehen, generieren Sie die Service-Provider-Metadaten neu. Achten Sie dabei darauf, zwischen dem Konfigurieren und dem Herunterladen der Metadaten zu speichern.
--
--
--==== Validierungstool ====
--
--Die Metadaten können Sie mit Hilfe dieses Tools validieren:
--
  [[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]]
  Wählen Sie dabei XSD (schema file) für Metadata aus und kopieren Sie die Inhalte der XML in das angegebene Feld.

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