Wiki-Quellcode von ServiceProviderMetadaten.xml
Zuletzt geändert von MACH formsolutions am 24.03.2025
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | Die Datei ServiceProviderMetadaten.xml enthält Daten, die für die Anbindung von z.B. BundID und "Mein Unternehmenskonto" benötigt werden. | ||
| 2 | |||
| 3 | Sie erhalten diese Datei aus der erweiterten Modulkonfiguration Ihres Mandanten, oder von Ihrem MACH formsolutions Betreiber. | ||
| 4 | |||
| 5 | == Dateiinhalte == | ||
| 6 | |||
| 7 | [[image:ServiceProviderMetadaten-xml.png]] | ||
| 8 | |||
| 9 | |**1**|**entityID**|Format: | ||
| 10 | https:~/~/formularserveradresse.de/12345678-0000/sso | ||
| 11 | |**2**|**Zertifikat (encryption)**|(% colspan="1" rowspan="2" %)((( | ||
| 12 | Die Zertifikate bestehen aus dem Text zwischen den spitzen Klammern. | ||
| 13 | |||
| 14 | |||
| 15 | Für das Self Service Portal MUK müssen diese umformatiert werden. | ||
| 16 | Verwenden Sie dafür ein Werkzeug wie beispielsweise [[https:~~/~~/www.samltool.com/format_x509cert.php>>https://www.samltool.com/format_x509cert.php]]. | ||
| 17 | Das Zielformat ist: "X.509 cert with header". | ||
| 18 | Entfernen Sie nach dem Umformatieren die Zeilen "~-~-~-~--BEGIN CERTIFICATE~-~-~-~--" und "~-~-~-~--END CERTIFICATE~-~-~-~--". | ||
| 19 | ))) | ||
| 20 | |((( | ||
| 21 | **3** | ||
| 22 | )))|**Zertifikat (signing)** | ||
| 23 | |**4**|((( | ||
| 24 | **Single Logout Service URL** | ||
| 25 | )))|Format: | ||
| 26 | https:~/~/formularserveradresse.de/login-saml/Form-Solutions/singleLogout/12345678-0000/redirect | ||
| 27 | |**5**|**Assertion Consumer Service URL**|((( | ||
| 28 | Format: | ||
| 29 | https:~/~/formularserveradresse.de/login-saml/Form-Solutions/assertionConsumer/12345678-0000/post | ||
| 30 | ))) | ||
| 31 | |||
| 32 | == Mandantenspezifische Domains == | ||
| 33 | |||
| 34 | Verfügt der Mandant über eine mandantenspezifische Domain (Internetadresse), beispielsweise ##https:~/~/formulare.musterhausen.de,## muss die "Service-Provider-Metadaten" Datei für diese Domäne erstellt werden. | ||
| 35 | Für jede Domain, unter der Veröffentlichungen mit Servicekontoanbindung geplant sind, ist eine eigene Anbindung beim Anbieter anzulegen. Dafür benötigen Sie jeweils eine ServiceProviderMetadaten.xml-Datei, in der die entsprechende Domain korrekt eingetragen ist. | ||
| 36 | |||
| 37 | Rufen Sie die Anmeldemaske des Formularservers über Ihre mandantenspezifische Adresse auf und loggen Sie sich ein. Erstellen Sie die Datei, wie in der Dokumentation der entsprechenden Anbindung beschrieben. | ||
| 38 | |||
| 39 | Kontrollieren Sie, dass in der resultierenden XML-Datei jedes Vorkommen der Adresse des Formularservers die Kundendomain enthält. Die zu prüfenden Stellen sind 1, 4 und 5 im obigen Schaubild. | ||
| 40 | Gegebenenfalls ersetzen Sie manuell die Adressen, z.B. ##https:~/~/pdf.form-solutions.de## durch ##https:~/~/formulare.musterstadt.de##. |