Zum Inhalt springen

Änderungen von Dokument BundID

Zuletzt geändert von MACH ProForms GmbH am 03.03.2025
Von Version 24.7
bearbeitet von MACH ProForms GmbH
am 03.03.2025
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 10.1
bearbeitet von MACH ProForms GmbH
am 21.11.2023
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,16 +1,10 @@
1 1  Die BundID-Funktionalitäten stehen ab dem Release 4.92 zur Verfügung.
2 2  
3 -== Architektur-Varianten ==
3 +In der Praxis können mehrere Architektur-Varianten für die Anbindung an des Formularservers an die BundID vorkommen.
4 4  
5 -Es sind drei Architektur-Varianten der Anbindung von MACH formsolutions an die BundID möglich.
6 6  
7 -Für die Variante 1 und 3 sind Einstellungen in der Modulkonfiguration des Mandanten zu treffen.
6 +**Variante 1** - Anbindung an BundID direkt über den Formularservice
8 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 -
12 -**Variante 1** - Anbindung an BundID direkt über die Software
13 -
14 14  [[image:Schaubild1.png||alt="Schaubild1" height="167" width="726"]]
15 15  
16 16  
... ... @@ -19,17 +19,24 @@
19 19  [[image:Schaubild2.png||alt="Schaubild2" height="192" width="733"]]
20 20  
21 21  
22 -**Variante 3** - Anbindung an BundID direkt über die Software ohne Einstiegsseite
16 +**Variante 3** - Anbindung an BundID direkt über den Formularserver ohne Einstiegsseite
23 23  
24 24  [[image:Schaubild3 (3).png||alt="Schaubild3" height="239" width="735"]]
25 25  
26 26  
21 +Für die Variante 1 und 3 sind einige Einstellungen in der Modulkonfiguration des Mandanten zu treffen.
27 27  
28 -=== Anbindung des Mandanten ===
23 +Im Falle der Variante 2 können die Daten über die SecurePostData Schnittstelle
29 29  
30 -Die Konfiguration für die Varianten 1 und 3 ist in der Anwenderdokumentation
25 +([[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/]])
31 31  
27 +direkt in den Assistenten übergeben werden.
32 32  
29 +
30 +== Einstellungen in der Modulkonfiguration ==
31 +
32 +Die folgenden Einstellungen gelten nur für die Variante 1 oder 3.
33 +
33 33  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.
34 34  
35 35  === Keystore generieren ===
... ... @@ -48,84 +48,62 @@
48 48  Re-enter new password:
49 49  
50 50  What is your first and last name?
51 -Unknown:
52 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
52 52  What is the name of your organizational unit?
53 -Unknown:
54 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
54 54  What is the name of your organization?
55 -Unknown:
56 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
56 56  What is the name of your City or Locality?
57 -Unknown:
58 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
58 58  What is the name of your State or Province?
59 -Unknown:
60 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
60 60  What is the two-letter country code for this unit?
61 -Unknown:
62 +[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
62 62  Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct?
63 -no: yes
64 +[[no>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=no&linkCreation=true&fromPageId=127858922]]: yes
64 64  
65 65  Enter key password for <alias>
66 66  (RETURN if same as keystore password):
67 67  
68 68  
69 -Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das Mandantenrecht eID.
70 +Für die folgenden Schritte benötigt der Mandant, für den die Einstellungen zu treffen sind, das eID Mandantenrecht.
70 70  
71 71  Einstellungen für das Bürgerportal:
72 72  
73 -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.
74 +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.
74 74  
75 -[[image:1736859216979-481.png]]
76 +[[image:Bürgerportal Schaubild.png||alt="Schaubild Buergerportal" height="494" width="720"]]
76 76  
77 77  
78 -[[image:1736859277992-433.png]]
79 -
80 -
81 81  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.
82 82  
83 -Beim EntityID-Format "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" muss auf "Ja" stehen.
81 +Beim EntityID-Format bitte "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" soll auf "Ja" stehen.
84 84  
85 -(% class="box warningmessage" %)
86 -(((
87 -**Der Keystoredateiupload und die Auswahl der EntityID "URL" müssen explizit durch Speichern an den Server übertragen werden.**
88 -)))
89 89  
90 -Es erscheint der grüne Balken mit dem Hinweis "Es wurde bereits eine Keystore-Datei hinterlegt."
91 -Anschließend können Sie die "Service-Provider-Metadaten für BundID" herunterladen:
84 +[[image:Portale.png||alt="Schaubild Portale" height="409" width="712"]]
92 92  
93 93  
94 -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.
87 +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 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 sich die BundID-Systeme mit dem Formularserver "verstehen".
95 95  
96 96  
97 -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.
90 +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.
98 98  
99 -Identity Provider XML-Datei für Testumgebung: [[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]]
92 +Bemerkung: damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden.
100 100  
101 -Identity Provider XML-Datei für die Produktivumgebung: [[idp_prod.xml>>https://cloud.machproforms.de/index.php/s/P5tNDtQkyDc4QGY]]
102 102  
103 -(% class="box warningmessage" %)
104 -(((
105 -Damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden.
106 -)))
95 +Identity Provider XML-Datei für Testumgebung:
107 107  
97 +[[idp.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp.xml?version=1&modificationDate=1700496069973&api=v2]]
108 108  
109 -=== Überprüfung der Metadaten für die BundID ===
99 +Identity Provider XML-Datei für die Produktivumgebung:
110 110  
111 -==== EntityID Prüfung ====
101 +[[idp_prod.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp_prod.xml?version=1&modificationDate=1700553044769&api=v2]]
112 112  
113 -Kontrollieren Sie mit einem Texteditor, dass in der XML-Datei der Service-Provider-Metadaten die EntityID im Format ##"https:~/~/(Formularserveradresse)" angegeben ist.##
114 114  
115 -Beispiel:
104 +=== Tool zur Validierung der Metadaten für die BundID ===
116 116  
117 -{{code language="xml"}}
118 -<md:EntityDescriptor entityID="https://pdf.form-solutions.net/00000000-0000/sso" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata">
119 -{{/code}}
106 +Sollten Sie sich unsicher seien, ob die generierten Metadaten passend sind, dann können Sie dies mit Hilfe dieses Tools testen:
120 120  
121 -(% class="wikigeneratedid" %)
122 -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.
123 -
124 -
125 -==== Validierungstool ====
126 -
127 -Die Metadaten können Sie mit Hilfe dieses Tools validieren:
128 -
129 129  [[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]]
130 130  
131 131  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