Wiki-Quellcode von BundID

Version 24.11 von MACH formsolutions am 03.03.2025

version	line-number	content
5.2	1	Die BundID-Funktionalitäten stehen ab dem Release 4.92 zur Verfügung.
	2
24.2	3	== Architektur-Varianten ==
5.2	4
24.2	5	Es sind drei Architektur-Varianten der Anbindung von MACH formsolutions an die BundID möglich.
5.3	6
24.3	7	Für die Variante 1 und 3 sind Einstellungen in der Modulkonfiguration des Mandanten zu treffen.
24.2	8
24.3	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
16.1	12	Variante 1 - Anbindung an BundID direkt über die Software
5.2	13
6.2	14	[[image:Schaubild1.png\|\|alt="Schaubild1" height="167" width="726"]]
5.2	15
6.2	16
	17	Variante 2 - Anbindung an BundID über die vorgelagerte Einstiegsseite
	18
	19	[[image:Schaubild2.png\|\|alt="Schaubild2" height="192" width="733"]]
	20
	21
16.1	22	Variante 3 - Anbindung an BundID direkt über die Software ohne Einstiegsseite
6.2	23
7.2	24	[[image:Schaubild3 (3).png\|\|alt="Schaubild3" height="239" width="735"]]
9.2	25
	26
	27
24.4	28	=== Anbindung des Mandanten ===
9.3	29
24.10	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.
9.2	31
24.4	32
24.11	33
9.2	34
24.11	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.
9.2	36
	37
19.1	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.
9.2	39
19.1	40	Identity Provider XML-Datei für Testumgebung: [[idp.xml>>https://cloud.machproforms.de/index.php/s/E3aotLNafQPeRmc]]
9.2	41
19.1	42	Identity Provider XML-Datei für die Produktivumgebung: [[idp_prod.xml>>https://cloud.machproforms.de/index.php/s/P5tNDtQkyDc4QGY]]
9.2	43
19.1	44	(% class="box warningmessage" %)
	45	(((
	46	Damit die Einstellungen im Reiter Bürgerportal aktiv werden, müssen Ihre Eingaben explizit gespeichert werden.
	47	)))
9.2	48
	49
19.1	50	=== Überprüfung der Metadaten für die BundID ===
9.2	51
19.1	52	==== EntityID Prüfung ====
9.2	53
19.1	54	Kontrollieren Sie mit einem Texteditor, dass in der XML-Datei der Service-Provider-Metadaten die EntityID im Format ##"https:~/~/(Formularserveradresse)" angegeben ist.##
9.2	55
20.1	56	Beispiel:
9.2	57
19.1	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}}
9.2	61
19.1	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
21.1	68	Die Metadaten können Sie mit Hilfe dieses Tools validieren:
19.1	69
9.2	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.