Zum Inhalt springen
Zuletzt geändert von MACH formsolutions am 08.07.2026
Zeige letzte Bearbeiter
1 (% class="box warningmessage" %)
2 (((
3 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**.
4
5 Nutzen Sie vorrangig den vom ITZBund bereitgestellten **Anbindungsleitfaden Zentrales Bürgerpostfach**, den Sie im BundID SSP herunterladen können (unter "Hilfe-Center" > "Downloads").
6
7 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.
8 Supportanfragen zum Self Service Portal werden von MACH nicht entgegengenommen. Das Portal unterliegt nicht der Verantwortung der MACH.
9 )))
10
11 {{toc/}}
12
13 == Voraussetzungen, Kenntnisse, Werkzeuge ==
14
15 (% class="wikigeneratedid" id="HDieBundID-Postfach-ZertifikatewerdenvomITZBunderstellt.FFCrdieseErstellungistesnotwendig2CdassderanzubindendeMandanteinprivatesZertifikaterstelltundeinensogenanntenCertificate-Signing-Request28CSR29erzeugt.DerCSRwirdimBundIDSSPandasITZBundFCbermittelt.AnschlieDFendwirdIhnendasBundID-Postfach-ZertifikatimBundIDSSPzumDownloadzurVerfFCgunggestellt." %)
16 Die BundID-Postfach-Zertifikate werden vom ITZBund erstellt.
17 Dafür ist es notwendig, dass der anzubindende Mandant ein privates Zertifikat erstellt und einen sogenannten Certificate-Signing-Request (CSR) erzeugt.
18 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.
19
20 **Wichtig:**
21 Für **Testumgebung (INT)** und **Produktivumgebung (PROD)** werden **separate Zertifikate** benötigt.
22
23 **Werkzeuge/Kenntnisse:**
24
25 * Zugang zum **BundID Self-Service-Portal (BundID SSP)**
26 * Grundverständnis von **Zertifikaten**
27 * **Nutzung der Befehlszeile** (z B. Windows-Eingabeaufforderung) und Zertifikatserstellung, z. B. mit **OpenSSL** (kostenloses Programm zur Zertifikatserstellung)
28 * Hilfsmittel: **Anbindungsleitfaden** des ITZBund
29 Download im BundID SSP unter "Hilfe-Center" > "Downloads"
30
31 Falls Sie unsicher sind, wenden Sie sich an Ihre IT-Abteilung um die Schlüsseldatei und den CSR erstellen zu lassen.
32
33 == Privaten Schlüssel und Certificate-Signing-Request (CSR) erstellen ==
34
35 (% class="box infomessage" %)
36 (((
37 Die detaillierte Anleitung und die benötigten Befehle finden Sie im Anbindungsleitfaden des ITZBund.
38 )))
39
40 **Schritte:**
41
42 1. **Private Schlüsseldatei generieren:** Datei priv.key
43 1. **Private Schlüsseldatei konvertieren** ins Dateiformat pkcs#1
44 1. **Konfigurationsdatei erstellen:** Datei csrconfig.txt
45 1. **CSR erstellen:** Datei test_cert_csr.pem
46
47 Falls Sie unsicher sind, wenden Sie sich an Ihre IT-Abteilung.
48
49 == Erhalt des BundID-Postfach-Zertifikats durch das Self Service Portal BundID ==
50
51 Durch den Upload des Certificate-Signing-Requests (CSR) im SSP BundID erhalten Sie das benötigte BundID-Postfach-Zertifikat.
52
53 **Schritte:**
54
55 1. Melden Sie sich im **BundID SSP** an.
56 1. Laden Sie die **CSR-Datei** (z. B. **test_cert_csr.pem**) hoch, unter unter „Leistungen“ > „BundID-Postfach-Zertifikat beantragen“(((
57 Das **ITZBund** erstellt daraufhin das Zertifikat und stellt es im .cer-Format bereit.
58 )))
59 1. Laden Sie das Zertifikat (BundID_Postfach_Zertifikat.cer) aus dem BundID SSP herunter.
60
61 == Zertifikat in MACH formsolutions einbinden ==
62
63 In der Modulkonfiguration des Mandanten konfigurieren Sie die Anbindung.
64
65 Die Konfiguration finden sie im Abschnitt **Login-Anbieter **>** Bürgerportal-Konfiguration **>** BundID **>** Zentrales Bürgerpostfach.**
66 Laden Sie das Zertifikat und den privaten Schlüssel hoch, wie im [[Artikel Zentrales Bürgerpostfach>>doc:Main.09_Schnittstellen.02_Konten.BundID.ZentralesBuergerpostfach.WebHome]] beschrieben.