Rotar certificado ICP-Brasil
Prerrequisito: este es el primer paso de la cadena de onboarding (certificado → disponibilidad → prueba-de-conectividad → envío); rota el certificado antes de activarlo (ver activateCertificate), verificar la disponibilidad (ver getReadiness) o enviar cualquier operación. Realiza una recarga en caliente, con emisión de evidencia, del par de certificados ICP-Brasil/RSFN. El nuevo certificado ya debe existir en disco bajo la ruta base configurada; este endpoint solo intercambia el puntero en memoria y emite un registro de auditoría. Idempotente: reenviar la misma clave X-Idempotency con el mismo cuerpo devuelve la respuesta en caché. La respuesta NUNCA incluye la ruta de la clave privada ni el material de claves.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Idempotency key (primary).
Idempotency key (legacy alias for X-Idempotency).
Idempotency key TTL in seconds (overrides the configured default).
Cuerpo
Operator-supplied reference to the new certificate material (filesystem path or secrets-manager URI), validated against the configured cert directory before any read.
1 - 2048"/etc/lerian/certs/2026-q2/icp-brasil.crt"
Operator-supplied reference to the new private-key material (filesystem path or secrets-manager URI), validated against the configured cert directory before any read.
1 - 2048"/etc/lerian/certs/2026-q2/icp-brasil.key"
Optional operator rationale recorded in the audit evidence (max 512 chars).
512"Quarterly rotation per ICP-Brasil policy"
Respuesta
OK
UUID of the audit record written for this rotation.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
State of the certificate after the rotation hot-reload.
Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.
"req-7a3f9c2e"
Optional post-rotation readiness summary; omitted when readiness lookup is unavailable.

