Ä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 11.1
bearbeitet von MACH ProForms GmbH
am 31.01.2024
am 31.01.2024
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Zusammenfassung
-
Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- Dokument-Autor
-
... ... @@ -1,1 +1,1 @@ 1 -xwiki:XWiki. Dokumentation1 +xwiki:XWiki.fweise - Inhalt
-
... ... @@ -1,9 +1,9 @@ 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 de rMACH formsolutions3 +In der Praxis können mehrere Architektur-Varianten für die Anbindung des Formularservers an die BundID vorkommen. 4 4 5 5 6 -**Variante 1** - Anbindung an BundID direkt über d ieSoftware6 +**Variante 1** - Anbindung an BundID direkt über den Formularserver 7 7 8 8 [[image:Schaubild1.png||alt="Schaubild1" height="167" width="726"]] 9 9 ... ... @@ -13,7 +13,7 @@ 13 13 [[image:Schaubild2.png||alt="Schaubild2" height="192" width="733"]] 14 14 15 15 16 -**Variante 3** - Anbindung an BundID direkt über d ieSoftware ohne Einstiegsseite16 +**Variante 3** - Anbindung an BundID direkt über den Formularserver ohne Einstiegsseite 17 17 18 18 [[image:Schaubild3 (3).png||alt="Schaubild3" height="239" width="735"]] 19 19 ... ... @@ -67,7 +67,7 @@ 67 67 68 68 Einstellungen für das Bürgerportal: 69 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.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 71 72 72 [[image:Bürgerportal Schaubild.png||alt="Schaubild Buergerportal" height="494" width="720"]] 73 73 ... ... @@ -74,54 +74,33 @@ 74 74 75 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 76 77 -Beim EntityID-Format "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" muss auf "Ja" stehen. 77 +Beim EntityID-Format bitte "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" muss auf "Ja" stehen. 78 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 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 87 [[image:Portale.png||alt="Schaubild Portale" height="409" width="712"]] 88 88 89 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 de rMACH formsolutions Plattformkommunizieren können.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. 91 91 92 92 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. 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. 94 94 95 - IdentityProviderXML-Dateifür Testumgebung:[[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]]88 +Bemerkung: damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden. 96 96 97 -Identity Provider XML-Datei für die Produktivumgebung: [[idp_prod.xml>>https://cloud.machproforms.de/index.php/s/P5tNDtQkyDc4QGY]] 98 98 99 -(% class="box warningmessage" %) 100 -((( 101 -Damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden. 102 -))) 91 +Identity Provider XML-Datei für Testumgebung: 103 103 93 +[[idp.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp.xml?version=1&modificationDate=1700496069973&api=v2]] 104 104 105 - === Überprüfungder Metadatenfür dieBundID ===95 +Identity Provider XML-Datei für die Produktivumgebung: 106 106 107 - ==== EntityID Prüfung====97 +[[idp_prod.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp_prod.xml?version=1&modificationDate=1700553044769&api=v2]] 108 108 109 -Kontrollieren Sie mit einem Texteditor, dass in der XML-Datei der Service-Provider-Metadaten die EntityID im Format ##"https:~/~/(Formularserveradresse)" angegeben ist.## 110 110 111 - Beispiel:100 +=== Tool zur Validierung der Metadaten für die BundID === 112 112 113 -{{code language="xml"}} 114 -<md:EntityDescriptor entityID="https://pdf.form-solutions.net/00000000-0000/sso" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"> 115 -{{/code}} 102 +Sollten Sie sich unsicher seien, ob die generierten Metadaten passend sind, dann können Sie dies mit Hilfe dieses Tools testen: 116 116 117 -(% class="wikigeneratedid" %) 118 -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. 119 - 120 - 121 -==== Validierungstool ==== 122 - 123 -Die Metadaten können Sie mit Hilfe dieses Tools validieren: 124 - 125 125 [[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]] 126 126 127 127 Wählen Sie dabei XSD (schema file) für Metadata aus und kopieren Sie die Inhalte der XML in das angegebene Feld.