Zum Inhalt springen

Modulkonfiguration des Mandanten

Zuletzt geändert von MACH ProForms GmbH am 23.06.2025

Konfiguration MACH formsolutions

Die Nutzung der BundID erfordert Konfiguration im MACH formsolutions Mandanten. Es muss eine Keystoredatei hochgeladen und konfiguriert sein, die für alle Bürgerportale gilt. Zusätzlich muss die Konfiguration für BundID erstellt und aktiviert werden.

Voraussetzungen

Wir empfehlen, die Konfiguration mit den Browsern Chrome oder Edge durchzuführen. Bei Firefox kann es zu Problemen mit den XML-Dateien kommen.

Benötigen Sie Unterstützung? Wenden Sie sich bitte an Ihren zuständigen MACH formsolutions Support.

Modulkonfiguration

Rufen Sie den Menüpunkt auf: Einstellungen > Eigene Daten bearbeiten > Module > Erweiterte Modulkonfiguration
In der erweiterten Modulkonfiguration wählen Sie im Untermenü: Login-Anbieter > Bürgerportal-Konfiguration > BundID

  1. Optionsfeld Konfiguration freischalten aktivieren.
    Damit schalten Sie in der Veröffentlichungskonfiguration frei, Login-Anforderung mit BundID auszuwählen.
  2. BMI-Nummer eintragen 1

  3. Auswahl der Optionen

    • URL
    • Authentifizierungs-Anfrage signieren?: Ja
  4. Datei mit Identity-Provider-Metadaten für die BundID hochladen Siehe Voraussetzungen.
  5. Speichern der Konfiguration

Unter dem Link Service-Provider-Metadaten können Sie im Anschluss die benötigten Daten für die weitere Konfiguration im Self Service Portal BundID herunterladen.
Weitere Erläuterungen finden Sie in der Dokumentation zur Datei ServiceProviderMetadaten.xml.

1 Das Feld BMI-Nummer ist zukünftig verpflichtend, wird aktuell aber noch nicht von der Schnittstelle unterstützt.

Text der Weiterleitungsseite

Bearbeiten Sie gegebenenfalls den Textabschnitt für die Weiterleitungsseite. Dieser Text wird unterhalb der Auswahlmöglichkeit "BundID" angezeigt.

Modulkonfiguration BundID

Die Konfiguration des Mandanten ist damit abgeschlossen.

Mandantenspezifische Domains

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.
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.

Rufen Sie die Anmeldemaske des Formularservers über Ihre mandantenspezifische Adresse auf und loggen Sie sich ein. Erstellen Sie die Datei, wie oben beschrieben.

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 Schaubild in der Dokumentation zur Datei ServiceProviderMetadaten.xml.
Gegebenenfalls ersetzen Sie manuell die Adressen, z.B. https://pdf.form-solutions.de durch https://formulare.musterstadt.de.

Nächste Schritte

Im Self Service Portal der BundID laden Sie die Metadaten hoch.
Ist dies abgeschlossen, wählen Sie in der Veröffentlichungskonfiguration Ihrer Assistenten die Login-Anforderung "BundID" aus.