Zum Hauptinhalt springen
POST
Bestätigung ersetzen
Erstellt eine neue Bestätigung, die eine bestehende ersetzt. Die ursprüngliche Bestätigung wird als SUPERSEDED mit einem Verweis auf die neue Version markiert. Die neue Bestätigung wird mit dem angegebenen Schlüssel signiert, im Transparenzprotokoll aufgezeichnet und zusammen mit der aktualisierten Originalbestätigung zurückgegeben. Beide Bestätigungen bleiben verifizierbar und bilden eine überprüfbare Kette von Anmeldeinformationsversionen. Nur VALID Bestätigungen können ersetzt werden – REVOKED oder bereits SUPERSEDED Bestätigungen geben einen 409 Conflict zurück.

Funktionsweise

1

Supersede mit ursprünglicher Bestätigungs-ID aufrufen

Geben Sie die UUID der zu ersetzenden Bestätigung als Pfadparameter an, zusammen mit der neuen Nutzlast und dem Signaturschlüssel.
2

Originalattestierung als ERSETZT markiert

Der Status der ursprünglichen Attestierung ändert sich zu SUPERSEDED mit einem Zeitstempel und einem Verweis auf die neue Attestierungs-ID.
3

Neue Attestierung mit dem Status GÜLTIG erstellt

Eine neue Bestätigung wird mit der aktualisierten Nutzlast geprägt, mit dem angegebenen Schlüssel signiert und im Transparenzlog aufgezeichnet.
4

Beide in der Antwort zurückgegeben

Die Antwort enthält sowohl das alte (ersetzt) als auch das neue (gültige) Attestierungsobjekt unter den Schlüsseln old und new.

Häufige Anwendungsfälle

Antworten

Supersede-Operationen sind idempotent, wenn derselbe Idempotency-Key verwendet wird. Das Wiederholen einer fehlgeschlagenen Anforderung mit demselben Schlüssel ist sicher und führt nicht zu doppelten Bestätigungen.
Die ursprüngliche Bestätigung bleibt im Transparenzprotokoll und kann weiterhin überprüft werden. Ihr Status ändert sich zu SUPERSEDED, aber der kryptografische Beweis bleibt erhalten. Verifizierer können die vollständige Supersession-Kette verfolgen, indem sie dem Feld superseded_by_attestation_id folgen.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Header

Idempotency-Key
string
erforderlich

Pfadparameter

id
string<uuid>
erforderlich

Body

application/json
alg
string
erforderlich
kid
string
erforderlich
payload_b64url
string
erforderlich

Antwort

201 - application/json

Neue Attestierung erstellt

id
string<uuid>
issuer_id
string<uuid>
kid
string
status
enum<string>
Verfügbare Optionen:
VALID,
REVOKED,
SUPERSEDED
payload
object
signature
string
log_index
integer
created_at
string<date-time>