Cert

Verwaltung der Zertifikate: Zertifikate abrufen, neue Zertifikate per Queue-Prozess anfordern, vorhandene Zertifikate hinterlegen, die automatische Synchronisation steuern und Zertifikate löschen.

Alle Zertifikate abrufen

POST KUNDEN-HMAC /cert/getall

Liefert alle hinterlegten Zertifikate des eigenen Unternehmens.

Response

Array der Zertifikatsdatensätze (Felder wie bei cert/get):

json

[
  {
    "cert_ID": "a0b05178-e0bb-4b78-b6e6-3eda8b2a0eac",
    "cert_owner": "Copper & Grey Solutions GmbH",
    "cert_create_timestamp": "2026-08-11 18:26:45",
    "cert_create_userID": "2359d87a-ad3e-4802-bfb6-8622f564311c",
    "cert_validate_timestamp": "2033-05-26 19:11:09",
    "cert_validate_active": "1",
    "cert_safe_ID": "DE.Justiz.004804f3-edc6-4ee8-9398-47d861417aae.8e3a",
    "cert_sync": "0"
  }
]

Mögliche Fehler

Code	Meldung	Bedingung
`404`	`cert could not be found`	Keine Zertifikate hinterlegt
`403`	`access denied`	HMAC-Signatur ungültig oder abgelaufen, `hmac_unique` wiederverwendet oder Origin nicht freigegeben
`500`	–	Interner Fehler – generische Meldung
`503`	–	Rate-Limit überschritten (250 Requests/s pro IP)

Zertifikat abrufen

POST KUNDEN-HMAC /cert/get/{cert_ID}

Liefert den Datensatz eines hinterlegten Zertifikats.

Pfad-Parameter

Parameter	Beispiel	Beschreibung
`cert_ID`	`7726e6c8-b1d9-4f63-8f38-d567d6aaa50a`	UUID v4 des Zertifikats

Response

Der Zertifikatsdatensatz:

json

{
  "cert_ID": "a0b05178-e0bb-4b78-b6e6-3eda8b2a0eac",
  "cert_owner": "Copper & Grey Solutions GmbH",
  "cert_create_timestamp": "2026-08-11 18:26:45",
  "cert_create_userID": "2359d87a-ad3e-4802-bfb6-8622f564311c",
  "cert_validate_timestamp": "2033-05-26 19:11:09",
  "cert_validate_active": "1",
  "cert_safe_ID": "DE.Justiz.004804f3-edc6-4ee8-9398-47d861417aae.8e3a",
  "cert_sync": "0"
}

Feld	Typ	Beschreibung
`cert_ID`	string	UUID des Zertifikats
`cert_owner`	string	Inhaber/Organisation des Zertifikats
`cert_create_timestamp`	string	Zeitpunkt der Hinterlegung (`YYYY-MM-DD HH:MM:SS`)
`cert_create_userID`	string	Benutzer:in, die das Zertifikat hinterlegt hat
`cert_validate_timestamp`	string	Gültigkeitsende des Zertifikats
`cert_validate_active`	string	`1` = Zertifikat zeitlich gültig (Gültigkeitsende noch nicht überschritten), `0` = abgelaufen
`cert_safe_ID`	string	Safe-ID des Zertifikats (z. B. `DE.Justiz.…`)
`cert_sync`	string	Auto-Sync aktiv: `0` oder `1`

Mögliche Fehler

Code	Meldung	Bedingung
`404`	`cert could not be found`	Zertifikat existiert nicht
`406`	`validationinvalid`	`cert_ID` fehlt oder ist keine UUID v4
`403`	`access denied`	HMAC-Signatur ungültig oder abgelaufen, `hmac_unique` wiederverwendet oder Origin nicht freigegeben
`500`	–	Interner Fehler – generische Meldung
`503`	–	Rate-Limit überschritten (250 Requests/s pro IP)

Auto-Sync des Zertifikats schalten

POST KUNDEN-HMAC /cert/updatesync/{cert_ID}

Aktiviert oder deaktiviert die automatische Synchronisation des Zertifikats.

Pfad-Parameter

Parameter	Beispiel	Beschreibung
`cert_ID`	`1b727638-6f4e-4427-a7bf-11195bc6d9ff`	UUID v4 des Zertifikats

Request-Body (form-data)

Feld	Beschreibung	Beispiel
`cert_sync`	`0` = aus, `1` = an (Pflicht)	`0`

Response

Der Response-Body enthält bei Erfolg [true] (auch wenn der Wert unverändert war).

Mögliche Fehler

Code	Meldung	Bedingung
`404`	`cert could not be found`	Zertifikat existiert nicht
`406`	`validationinvalid`	`cert_sync` fehlt oder ist nicht `0`/`1`
`403`	`access denied`	HMAC-Signatur ungültig oder abgelaufen, `hmac_unique` wiederverwendet oder Origin nicht freigegeben
`500`	–	Interner Fehler – generische Meldung
`503`	–	Rate-Limit überschritten (250 Requests/s pro IP)

Zertifikats-Sync manuell starten

POST KUNDEN-HMAC /cert/startsync/{cert_ID}

Stößt einen manuellen Sync-Lauf für ein Zertifikat an. Nur möglich, wenn Auto-Sync deaktiviert ist (cert_sync = 0).

Pfad-Parameter

Parameter	Beispiel	Beschreibung
`cert_ID`	`1b727638-6f4e-4427-a7bf-11195bc6d9ff`	UUID v4 des Zertifikats

Response

Der Response-Body enthält [true] – der Sync läuft asynchron im Hintergrund.

Mögliche Fehler

Code	Meldung	Bedingung
`404`	`cert could not be found`	Zertifikat existiert nicht
`409`	`certificate auto sync enabled`	Auto-Sync ist bereits aktiv
`403`	`access denied`	HMAC-Signatur ungültig oder abgelaufen, `hmac_unique` wiederverwendet oder Origin nicht freigegeben
`500`	–	Interner Fehler – generische Meldung
`503`	–	Rate-Limit überschritten (250 Requests/s pro IP)

Zertifikat löschen

POST KUNDEN-HMAC /cert/delete/{cert_ID}

Löscht ein Zertifikat inklusive aller Nutzer-Zuordnungen und des sicher abgelegten Zertifikatsmaterials.

Pfad-Parameter

Parameter	Beispiel	Beschreibung
`cert_ID`	`a2151c78-7ed0-4253-b92d-5438bda3a731`	UUID v4 des Zertifikats

Response

Der Response-Body enthält bei Erfolg [true].

Mögliche Fehler

Code	Meldung	Bedingung
`404`	`cert could not be found`	Zertifikat existiert nicht
`500`	`cert could not be deleted`	Löschung im Speicher oder der Datenbank fehlgeschlagen
`403`	`access denied`	HMAC-Signatur ungültig oder abgelaufen, `hmac_unique` wiederverwendet oder Origin nicht freigegeben
`500`	–	Interner Fehler – generische Meldung
`503`	–	Rate-Limit überschritten (250 Requests/s pro IP)

Vorhandenes Zertifikat hinterlegen

POST KUNDEN-HMAC /cert/setexist

Hinterlegt ein vorhandenes PKCS#12-Zertifikat (Base64-kodiert) inklusive Passwort. Das Zertifikat wird serverseitig geprüft (Lesbarkeit, Gültigkeitszeitraum, Safe-ID im UID-Feld, Duplikat) und sicher abgelegt. Offene Zertifikats-Anforderungen zur selben Safe-ID werden bereinigt.

Request-Body (form-data)

Feld	Beschreibung	Beispiel
`cert_cert`	PKCS#12-Zertifikat, Base64-kodiert (Pflicht)	`<geheim>`
`cert_password`	Passwort des Zertifikats (Pflicht, 1–80 Zeichen)	`<geheim>`
`cert_sync`	Auto-Sync aktiv: `0` oder `1` (Pflicht)	`1`

Response

Die cert_ID (UUID) des hinterlegten Zertifikats als JSON-String:

json

"<cert_ID>"

Mögliche Fehler

Code	Meldung	Bedingung
`409`	`certificate limit reached`	Maximale Anzahl Zertifikate laut Tarif erreicht
`406`	`certificate could not be read or is invalid or password is wrong`	P12 nicht lesbar oder falsches Passwort
`406`	`certificate could not be parsed`	X.509-Daten nicht parsbar
`406`	`certificate has expired`	Gültigkeitsende überschritten
`406`	`certificate is not yet valid`	Gültigkeitsbeginn liegt in der Zukunft
`406`	`certificate does not contain a safe-ID`	Kein UID-Eintrag im Zertifikats-Subject
`406`	`certificate already exists`	Zertifikat (Hash) bereits hinterlegt
`500`	`certificate could not be set`	Speicherung fehlgeschlagen
`403`	`access denied`	HMAC-Signatur ungültig oder abgelaufen, `hmac_unique` wiederverwendet oder Origin nicht freigegeben
`500`	–	Interner Fehler – generische Meldung
`503`	–	Rate-Limit überschritten (250 Requests/s pro IP)

Neues Zertifikat anfordern (asynchron)

POST KUNDEN-HMAC /cert/setrequest

Startet die Ausstellung eines neuen Zertifikats über einen Queue-Prozess. Ergebnis und Zertifikatsdaten werden in einen Datahandler-Eintrag geschrieben und über datahandler/get/{datahandler_ID} abgerufen.

Response

Beide IDs – das Ergebnis wird über datahandler/get/{datahandler_ID} abgerufen:

json

{
  "datahandler_ID": "<uuid>",
  "cert_request_ID": "<id>"
}

Mögliche Fehler

Code	Meldung	Bedingung
`409`	`certificate limit reached`	Maximale Anzahl Zertifikate laut Tarif erreicht
`500`	`cert_request could not be created`	Interne Anforderung fehlgeschlagen
`500`	`request could not be created`	Datahandler-Eintrag konnte nicht erstellt werden
`403`	`access denied`	HMAC-Signatur ungültig oder abgelaufen, `hmac_unique` wiederverwendet oder Origin nicht freigegeben
`500`	–	Interner Fehler – generische Meldung
`503`	–	Rate-Limit überschritten (250 Requests/s pro IP)

Cert ​

Alle Zertifikate abrufen ​

Response ​

Mögliche Fehler ​

Zertifikat abrufen ​

Pfad-Parameter ​

Response ​

Mögliche Fehler ​

Auto-Sync des Zertifikats schalten ​

Pfad-Parameter ​

Request-Body (form-data) ​

Response ​

Mögliche Fehler ​

Zertifikats-Sync manuell starten ​

Pfad-Parameter ​

Response ​

Mögliche Fehler ​

Zertifikat löschen ​

Pfad-Parameter ​

Response ​

Mögliche Fehler ​

Vorhandenes Zertifikat hinterlegen ​

Request-Body (form-data) ​

Response ​

Mögliche Fehler ​

Neues Zertifikat anfordern (asynchron) ​

Response ​

Mögliche Fehler ​

Cert

Alle Zertifikate abrufen

Response

Mögliche Fehler

Zertifikat abrufen

Pfad-Parameter

Response

Mögliche Fehler

Auto-Sync des Zertifikats schalten

Pfad-Parameter

Request-Body (form-data)

Response

Mögliche Fehler

Zertifikats-Sync manuell starten

Pfad-Parameter

Response

Mögliche Fehler

Zertifikat löschen

Pfad-Parameter

Response

Mögliche Fehler

Vorhandenes Zertifikat hinterlegen

Request-Body (form-data)

Response

Mögliche Fehler

Neues Zertifikat anfordern (asynchron)

Response

Mögliche Fehler