Zum Inhalt springen

Änderungen von Dokument BundID

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

Zusammenfassung

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 des Formularservers an die BundID vorkommen.
3 +In der Praxis können mehrere Architektur-Varianten für die Anbindung der MACH formsolutions an die BundID vorkommen.
4 4  
5 5  
6 -**Variante 1** - Anbindung an BundID direkt über den Formularserver
6 +**Variante 1** - Anbindung an BundID direkt über die Software
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 den Formularserver ohne Einstiegsseite
16 +**Variante 3** - Anbindung an BundID direkt über die Software ohne Einstiegsseite
17 17  
18 18  [[image:Schaubild3 (3).png||alt="Schaubild3" height="239" width="735"]]
19 19  
... ... @@ -45,19 +45,19 @@
45 45  Re-enter new password:
46 46  
47 47  What is your first and last name?
48 -[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
48 +Unknown:
49 49  What is the name of your organizational unit?
50 -[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
50 +Unknown:
51 51  What is the name of your organization?
52 -[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
52 +Unknown:
53 53  What is the name of your City or Locality?
54 -[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
54 +Unknown:
55 55  What is the name of your State or Province?
56 -[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
56 +Unknown:
57 57  What is the two-letter country code for this unit?
58 -[[Unknown>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=Unknown&linkCreation=true&fromPageId=127858922]]:
58 +Unknown:
59 59  Is CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct?
60 -[[no>>url:https://confluence.mach.de/pages/createpage.action?spaceKey=FSONE&title=no&linkCreation=true&fromPageId=127858922]]: yes
60 +no: yes
61 61  
62 62  Enter key password for <alias>
63 63  (RETURN if same as keystore password):
... ... @@ -67,40 +67,62 @@
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 Anschließung der BundID zu machen sind.
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.
71 71  
72 -[[image:Bürgerportal Schaubild.png||alt="Schaubild Buergerportal" height="494" width="720"]]
72 +[[image:1736859216979-481.png]]
73 73  
74 74  
75 +[[image:1736859277992-433.png]]
76 +
77 +
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 bitte "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" soll auf "Ja" stehen.
80 +Beim EntityID-Format "URL" auswählen. Die Option "Authentifizierungs-Anfrage signieren" muss auf "Ja" stehen.
78 78  
82 +(% class="box warningmessage" %)
83 +(((
84 +**Der Keystoredateiupload und die Auswahl der EntityID "URL" müssen explizit durch Speichern an den Server übertragen werden.**
85 +)))
79 79  
80 -[[image:Portale.png||alt="Schaubild Portale" height="409" width="712"]]
87 +Es erscheint der grüne Balken mit dem Hinweis "Es wurde bereits eine Keystore-Datei hinterlegt."
88 +Anschließend können Sie die "Service-Provider-Metadaten für BundID" herunterladen:
81 81  
82 82  
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 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".
91 +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.
84 84  
85 85  
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 +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.
87 87  
88 -Bemerkung: damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden.
96 +Identity Provider XML-Datei für Testumgebung: [[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]]
89 89  
98 +Identity Provider XML-Datei für die Produktivumgebung: [[idp_prod.xml>>https://cloud.machproforms.de/index.php/s/P5tNDtQkyDc4QGY]]
90 90  
91 -Identity Provider XML-Datei für Testumgebung:
100 +(% class="box warningmessage" %)
101 +(((
102 +Damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden.
103 +)))
92 92  
93 -[[idp.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp.xml?version=1&modificationDate=1700496069973&api=v2]]
94 94  
95 -Identity Provider XML-Datei für die Produktivumgebung:
106 +=== Überprüfung der Metadaten für die BundID ===
96 96  
97 -[[idp_prod.xml>>url:https://confluence.mach.de/download/attachments/127858922/idp_prod.xml?version=1&modificationDate=1700553044769&api=v2]]
108 +==== EntityID Prüfung ====
98 98  
110 +Kontrollieren Sie mit einem Texteditor, dass in der XML-Datei der Service-Provider-Metadaten die EntityID im Format ##"https:~/~/(Formularserveradresse)" angegeben ist.##
99 99  
100 -=== Tool zur Validierung der Metadaten für die BundID ===
112 +Beispiel:
101 101  
102 -Sollten Sie sich unsicher seien, ob die generierten Metadaten passend sind, dann können Sie dies mit Hilfe dieses Tools testen:
114 +{{code language="xml"}}
115 +<md:EntityDescriptor entityID="https://pdf.form-solutions.net/00000000-0000/sso" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata">
116 +{{/code}}
103 103  
118 +(% class="wikigeneratedid" %)
119 +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.
120 +
121 +
122 +==== Validierungstool ====
123 +
124 +Die Metadaten können Sie mit Hilfe dieses Tools validieren:
125 +
104 104  [[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]]
105 105  
106 106  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,0 +1,1 @@
1 +xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,0 +1,1 @@
1 +50.0 KB
Inhalt
1736859277992-433.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,0 +1,1 @@
1 +65.6 KB
Inhalt