Passer au contenu principal
POST
Remplacer l'attestation
Crée une nouvelle attestation qui remplace une attestation existante. L’attestation originale est marquée comme SUPERSEDED avec une référence à la nouvelle version. La nouvelle attestation est signée avec la clé spécifiée, enregistrée dans le journal de transparence et renvoyée avec l’originale mise à jour. Les deux attestations restent vérifiables, créant une chaîne auditable de versions d’informations d’identification. Seules les attestations VALID peuvent être remplacées — les attestations REVOKED ou déjà SUPERSEDED renvoient une 409 Conflict.

Comment ça marche

1

Appeler la substitution avec l'ID d'attestation original

Fournissez l’UUID de l’attestation à remplacer en tant que paramètre de chemin, ainsi que la nouvelle charge utile et la clé de signature.
2

Attestation originale marquée REMPLACÉE

Le statut de l’attestation originale passe à SUPERSEDED avec un horodatage et une référence au nouvel ID d’attestation.
3

Nouvelle attestation créée avec le statut VALIDE

Une nouvelle attestation est frappée avec la charge utile mise à jour, signée avec la clé spécifiée et enregistrée dans le journal de transparence.
4

Les deux sont retournés en réponse

La réponse inclut les objets d’attestation anciens (remplacés) et nouveaux (valides) sous les clés old et new.

Cas d’utilisation courants

Réponses

Les opérations de remplacement sont idempotentes lors de l’utilisation du même Idempotency-Key. Réessayer une requête échouée avec la même clé est sûr et ne créera pas d’attestations en double.
L’attestation originale reste dans le journal de transparence et peut toujours être vérifiée. Son statut passe à SUPERSEDED mais la preuve cryptographique est préservée. Les vérificateurs peuvent tracer la chaîne de supersession complète en suivant le champ superseded_by_attestation_id.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

En-têtes

Idempotency-Key
string
requis

Paramètres de chemin

id
string<uuid>
requis

Corps

application/json
alg
string
requis
kid
string
requis
payload_b64url
string
requis

Réponse

201 - application/json

Nouvelle attestation créée

id
string<uuid>
issuer_id
string<uuid>
kid
string
status
enum<string>
Options disponibles:
VALID,
REVOKED,
SUPERSEDED
payload
object
signature
string
log_index
integer
created_at
string<date-time>