Wiki-Quellcode von BundID
Version 24.11 von MACH ProForms GmbH am 03.03.2025
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | Die BundID-Funktionalitäten stehen ab dem Release 4.92 zur Verfügung. | ||
| 2 | |||
| 3 | == Architektur-Varianten == | ||
| 4 | |||
| 5 | Es sind drei Architektur-Varianten der Anbindung von MACH formsolutions an die BundID möglich. | ||
| 6 | |||
| 7 | Für die Variante 1 und 3 sind Einstellungen in der Modulkonfiguration des Mandanten zu treffen. | ||
| 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 | [[image:Schaubild1.png||alt="Schaubild1" height="167" width="726"]] | ||
| 15 | |||
| 16 | |||
| 17 | **Variante 2** - Anbindung an BundID über die vorgelagerte Einstiegsseite | ||
| 18 | |||
| 19 | [[image:Schaubild2.png||alt="Schaubild2" height="192" width="733"]] | ||
| 20 | |||
| 21 | |||
| 22 | **Variante 3** - Anbindung an BundID direkt über die Software ohne Einstiegsseite | ||
| 23 | |||
| 24 | [[image:Schaubild3 (3).png||alt="Schaubild3" height="239" width="735"]] | ||
| 25 | |||
| 26 | |||
| 27 | |||
| 28 | === Anbindung des Mandanten === | ||
| 29 | |||
| 30 | Die Konfiguration für die Varianten 1 und 3 ist in der [[Anwenderdokumentation BundID>>https://wiki.machproforms.de/wiki/docwiki/view/Main/09_Schnittstellen/02_Konten/BundID/]] beschrieben. | ||
| 31 | |||
| 32 | |||
| 33 | |||
| 34 | |||
| 35 | 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. | ||
| 36 | |||
| 37 | |||
| 38 | 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. | ||
| 39 | |||
| 40 | Identity Provider XML-Datei für Testumgebung: [[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]] | ||
| 41 | |||
| 42 | Identity Provider XML-Datei für die Produktivumgebung: [[idp_prod.xml>>https://cloud.machproforms.de/index.php/s/P5tNDtQkyDc4QGY]] | ||
| 43 | |||
| 44 | (% class="box warningmessage" %) | ||
| 45 | ((( | ||
| 46 | Damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben **explizit **gespeichert werden. | ||
| 47 | ))) | ||
| 48 | |||
| 49 | |||
| 50 | === Überprüfung der Metadaten für die BundID === | ||
| 51 | |||
| 52 | ==== EntityID Prüfung ==== | ||
| 53 | |||
| 54 | Kontrollieren Sie mit einem Texteditor, dass in der XML-Datei der Service-Provider-Metadaten die EntityID im Format ##"https:~/~/(Formularserveradresse)" angegeben ist.## | ||
| 55 | |||
| 56 | Beispiel: | ||
| 57 | |||
| 58 | {{code language="xml"}} | ||
| 59 | <md:EntityDescriptor entityID="https://pdf.form-solutions.net/00000000-0000/sso" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"> | ||
| 60 | {{/code}} | ||
| 61 | |||
| 62 | (% class="wikigeneratedid" %) | ||
| 63 | 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. | ||
| 64 | |||
| 65 | |||
| 66 | ==== Validierungstool ==== | ||
| 67 | |||
| 68 | Die Metadaten können Sie mit Hilfe dieses Tools validieren: | ||
| 69 | |||
| 70 | [[https:~~/~~/www.samltool.com/validate_xml.php>>url:https://www.samltool.com/validate_xml.php]] | ||
| 71 | |||
| 72 | Wählen Sie dabei XSD (schema file) für Metadata aus und kopieren Sie die Inhalte der XML in das angegebene Feld. |