Rotacionar certificado ICP-Brasil
Pré-requisito: esta é a primeira etapa da cadeia de onboarding (certificado → prontidão → teste-de-conectividade → envio); rotacione o certificado antes de ativá-lo (ver activateCertificate), verificar a prontidão (ver getReadiness) ou enviar qualquer operação. Realiza uma recarga a quente, com emissão de evidência, do par de certificados ICP-Brasil/RSFN. O novo certificado já deve existir em disco sob o caminho base configurado; este endpoint apenas troca o ponteiro em memória e emite um registro de auditoria. Idempotente: reenviar a mesma chave X-Idempotency com o mesmo corpo retorna a resposta em cache. A resposta NUNCA inclui o caminho da chave privada nem o material de chaves.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Idempotency key (primary).
Idempotency key (legacy alias for X-Idempotency).
Idempotency key TTL in seconds (overrides the configured default).
Corpo
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"
Resposta
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.

