Änderungen von Dokument BundID
Zuletzt geändert von MACH ProForms GmbH am 03.03.2025
Von Version 19.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 9.2
bearbeitet von MACH ProForms GmbH
am 21.11.2023
am 21.11.2023
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Zusammenfassung
-
Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- 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 an 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 Formularservice 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 ... ... @@ -20,10 +20,10 @@ 20 20 21 21 Für die Variante 1 und 3 sind einige Einstellungen in der Modulkonfiguration des Mandanten zu treffen. 22 22 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.23 +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. 24 24 25 25 26 -== =Einstellungen in der Modulkonfiguration ===26 +== Einstellungen in der Modulkonfiguration == 27 27 28 28 Die folgenden Einstellungen gelten nur für die Variante 1 oder 3. 29 29 ... ... @@ -45,29 +45,29 @@ 45 45 Re-enter new password: 46 46 47 47 What is your first and last name? 48 -Unknown: 48 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]: 49 49 What is the name of your organizational unit? 50 -Unknown: 50 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]: 51 51 What is the name of your organization? 52 -Unknown: 52 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]: 53 53 What is the name of your City or Locality? 54 -Unknown: 54 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]: 55 55 What is the name of your State or Province? 56 -Unknown: 56 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]: 57 57 What is the two-letter country code for this unit? 58 -Unknown: 58 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]: 59 59 Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct? 60 -no: yes 60 +[[no>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=no&linkCreation=true&fromPageId=127858922]]: yes 61 61 62 62 Enter key password for <alias> 63 63 (RETURN if same as keystore password): 64 64 65 65 66 -Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das Mandantenrecht eID.66 +Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das eID Mandantenrecht. 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 BundIDvorzunehmen 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 zu machen sind. 71 71 72 72 [[image:Bürgerportal Schaubild.png||alt="Schaubild Buergerportal" height="494" width="720"]] 73 73 ... ... @@ -74,56 +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" mussauf "Ja" stehen.77 +Beim EntityID-Format bitte "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" soll 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 - 88 88 [[image:Portale.png||alt="Schaubild Portale" height="409" width="712"]] 89 89 90 90 91 -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 An bindung 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 derMACH formsolutions Plattform kommunizierenkö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 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". 92 92 93 93 94 -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 steht der Anschluss. 95 95 96 - 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. 97 97 98 -Identity Provider XML-Datei für die Produktivumgebung: [[idp_prod.xml>>https://cloud.machproforms.de/index.php/s/P5tNDtQkyDc4QGY]] 99 99 100 -(% class="box warningmessage" %) 101 -((( 102 -Damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden. 103 -))) 91 +Identity Provider XML-Datei für Testumgebung: 104 104 105 - 93 +[[idp.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp.xml?version=1&modificationDate=1700496069973&api=v2]] 106 106 107 - === Überprüfungder Metadatenfür dieBundID ===95 +Identity Provider XML-Datei für die Produktivumgebung: 108 108 109 - ==== EntityID Prüfung====97 +[[idp_prod.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp_prod.xml?version=1&modificationDate=1700553044769&api=v2]] 110 110 111 -Kontrollieren Sie mit einem Texteditor, dass in der XML-Datei der Service-Provider-Metadaten die EntityID im Format ##"https:~/~/(Formularserveradresse)" angegeben ist.## 112 112 113 - Beispielsweise:100 +=== Tool zur Validierung der Metadaten für die BundID === 114 114 115 -{{code language="xml"}} 116 -<md:EntityDescriptor entityID="https://pdf.form-solutions.net/00000000-0000/sso" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"> 117 -{{/code}} 102 +Sollten Sie sich unsicher seien, ob die generierten Metadaten passend sind, dann können Sie dies mit Hilfe dieses Tools testen: 118 118 119 -(% class="wikigeneratedid" %) 120 -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. 121 - 122 - 123 -==== Validierungstool ==== 124 - 125 -Die Metadaten können Sie dies mit Hilfe dieses Tools validieren: 126 - 127 127 [[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]] 128 128 129 129 Wählen Sie dabei XSD (schema file) für Metadata aus und kopieren Sie die Inhalte der XML in das angegebene Feld.