Anbindung des ZBP - Zertifikate beantragen

Zuletzt geändert von MACH formsolutions am 08.07.2026

Für die Anbindung des Zentralen Bürgerpostfachs an MACH formsolutions benötigen Sie einen privaten Schlüssel, den Sie selbst erzeugen und eine Zertifikatsdatei, die Sie über das Self Service Portal BundID erhalten. Hierfür ist jeder Mandant selbst verantwortlich.

Nutzen Sie vorrangig den vom ITZBund bereitgestellten Anbindungsleitfaden Zentrales Bürgerpostfach, den Sie im BundID SSP herunterladen können (unter "Hilfe-Center" > "Downloads").

Diese Anleitung ist eine zusätzliche Hilfestellung bei von Ihnen auszuführenden Programmen und bei der Bedienung des Self Service Portal BundID, um MACH formsolutions anzubinden.
Supportanfragen zum Self Service Portal werden von MACH nicht entgegengenommen. Das Portal unterliegt nicht der Verantwortung der MACH.

Voraussetzungen, Kenntnisse, Werkzeuge

Die BundID-Postfach-Zertifikate werden vom ITZBund erstellt.
Dafür ist es notwendig, dass der anzubindende Mandant ein privates Zertifikat erstellt und einen sogenannten Certificate-Signing-Request (CSR) erzeugt.
Den CSR übermitteln Sie im BundID Self Service Portal (SSP) an das ITZBund. Anschließend wird Ihnen das BundID-Postfach-Zertifikat im BundID SSP zum Download zur Verfügung gestellt.

Wichtig:
Für Testumgebung (INT) und Produktivumgebung (PROD) werden separate Zertifikate benötigt.

Werkzeuge/Kenntnisse:

Zugang zum BundID Self-Service-Portal (BundID SSP)
Grundverständnis von Zertifikaten
Nutzung der Befehlszeile (z B. Windows-Eingabeaufforderung) und Zertifikatserstellung, z. B. mit OpenSSL (kostenloses Programm zur Zertifikatserstellung)
Hilfsmittel: Anbindungsleitfaden des ITZBund
Download im BundID SSP unter "Hilfe-Center" > "Downloads"

Falls Sie unsicher sind, wenden Sie sich an Ihre IT-Abteilung um die Schlüsseldatei und den CSR erstellen zu lassen.

Privaten Schlüssel und Certificate-Signing-Request (CSR) erstellen

Die detaillierte Anleitung und die benötigten Befehle finden Sie im Anbindungsleitfaden des ITZBund.

Schritte:

Private Schlüsseldatei generieren: Datei priv.key
Private Schlüsseldatei konvertieren ins Dateiformat pkcs#1
Konfigurationsdatei erstellen: Datei csrconfig.txt
CSR erstellen: Datei test_cert_csr.pem

Falls Sie unsicher sind, wenden Sie sich an Ihre IT-Abteilung.

Erhalt des BundID-Postfach-Zertifikats durch das Self Service Portal BundID

Durch den Upload des Certificate-Signing-Requests (CSR) im SSP BundID erhalten Sie das benötigte BundID-Postfach-Zertifikat.

Schritte:

Melden Sie sich im BundID SSP an.
Laden Sie die CSR-Datei (z. B. test_cert_csr.pem) hoch, unter unter „Leistungen“ > „BundID-Postfach-Zertifikat beantragen“
Das ITZBund erstellt daraufhin das Zertifikat und stellt es im .cer-Format bereit.
Laden Sie das Zertifikat (BundID_Postfach_Zertifikat.cer) aus dem BundID SSP herunter.

Zertifikat in MACH formsolutions einbinden

In der Modulkonfiguration des Mandanten konfigurieren Sie die Anbindung.

Die Konfiguration finden sie im Abschnitt Login-Anbieter > Bürgerportal-Konfiguration > BundID > Zentrales Bürgerpostfach.
Laden Sie das Zertifikat und den privaten Schlüssel hoch, wie im Artikel Zentrales Bürgerpostfach beschrieben.