Trifaco API
Certificados

deactivation de certificado

POST/v1/certificates/{id}/deactivation

Estado: parcial. Ambientes: simulation, qualification. Permisos: certificates:write.

Alcance: Requiere If-Match; impide nuevas firmas y bloquea trabajos pendientes sin firmar. Conserva los documentos ya firmados.

Activar requiere autorización verificada y certificado apto. Retirar material privado no elimina la evidencia histórica; una revisión ya enviada sigue conciliándose.

Authorization

ClientApiKey
X-API-Key<token>

Secreto ligado a empresa, actor, permisos y ambiente. No admite cambiar empresa por body/header.

In: header

Path Parameters

id*string

Identificador opaco. No autoriza acceso por sí mismo.

Formatuuid
Length1 <= length <= 36

Header Parameters

Idempotency-Key*string

Obligatoria en mutaciones. Alcance: empresa/ambiente/operación/recurso destino. Retención mínima 90 días y mientras haya trabajo pendiente. Mismo contenido recupera resultado; contenido diferente produce 409.

Match^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
Length1 <= length <= 128
If-Match*string

ETag de versión vigente. Replay idempotente se resuelve ANTES de revalidar If-Match; un comando nuevo con versión antigua produce 409 VERSION_CONFLICT.

Match^"[1-9][0-9]*"$
Length1 <= length <= 30

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/certificates/497f6eca-6276-4993-bfeb-53cbbbba6f08/deactivation" \  -H "Idempotency-Key: string" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{    "reason": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "label": "string",  "status": "checking",  "authorization_id": "be63c26c-03c0-4635-ae2b-58f14bd033f9",  "fingerprint_sha256": "string",  "subject": "string",  "issuer": "string",  "valid_from": "2019-08-24T14:15:22Z",  "valid_until": "2019-08-24T14:15:22Z",  "verification": {    "status": "passed",    "checked_at": "2019-08-24T14:15:22Z",    "policy_version": "local-pfx-rsa-crl-v1",    "reason_codes": [      "string"    ],    "checks": {      "pfx": "passed",      "key_pair": "passed",      "validity": "passed",      "key_usage": "passed",      "chain": "passed",      "revocation": "passed"    },    "recheck_at": "2019-08-24T14:15:22Z",    "trust_sha256": "string",    "crl_sha256": "string"  },  "version": 1,  "created_at": "2019-08-24T14:15:22Z"}

activation de certificado POST

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `certificates:write`. **Alcance:** Requiere If-Match, verificación técnica vigente y autorización de firma vigente con revisión independiente aprobada. Activar requiere autorización verificada y certificado apto. Retirar material privado no elimina la evidencia histórica; una revisión ya enviada sigue conciliándose.

private-material-destruction de certificado POST

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `certificates:write`. **Alcance:** Requiere If-Match. Elimina el material privado cifrado activo de forma irreversible para ese registro y conserva sus metadatos. Activar requiere autorización verificada y certificado apto. Retirar material privado no elimina la evidencia histórica; una revisión ya enviada sigue conciliándose.