Saltar al contenido principal
POST
Sustituir Atestación
Crea una nueva atestación que reemplaza una existente. La atestación original se marca como SUPERSEDED con una referencia a la nueva versión. La nueva atestación se firma con la clave especificada, se registra en el registro de transparencia y se devuelve junto con la original actualizada. Ambas atestaciones siguen siendo verificables, creando una cadena auditable de versiones de credenciales. Solo las atestaciones VALID pueden ser reemplazadas — las atestaciones REVOKED o ya SUPERSEDED devuelven un 409 Conflict.

Cómo funciona

1

Llamar a reemplazar con el ID de atestación original

Proporciona el UUID de la atestación a reemplazar como parámetro de ruta, junto con la nueva carga útil y la clave de firma.
2

Atestación original marcada como SUSTITUIDA

El estado de la atestación original cambia a SUPERSEDED con una marca de tiempo y una referencia al nuevo ID de atestación.
3

Nueva atestación creada con estado VÁLIDO

Se acuña una nueva atestación con la carga útil actualizada, firmada con la clave especificada y registrada en el registro de transparencia.
4

Ambos devueltos en la respuesta

La respuesta incluye tanto el objeto de atestación antiguo (sustituido) como el nuevo (válido) bajo las claves old y new.

Casos de uso comunes

Respuestas

Las operaciones de sustitución son idempotentes cuando se utiliza el mismo Idempotency-Key. Reintentar una solicitud fallida con la misma clave es seguro y no creará atestaciones duplicadas.
La atestación original permanece en el registro de transparencia y aún puede verificarse. Su estado cambia a SUPERSEDED, pero la prueba criptográfica se conserva. Los verificadores pueden rastrear la cadena de supersesión completa siguiendo el campo superseded_by_attestation_id.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Encabezados

Idempotency-Key
string
requerido

Parámetros de ruta

id
string<uuid>
requerido

Cuerpo

application/json
alg
string
requerido
kid
string
requerido
payload_b64url
string
requerido

Respuesta

201 - application/json

Nueva atestación creada

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