POST | Publicar certificado

Prev Next

Publica o certificado em um ou mais dispositivos.

  • Endpoint: /api/certificate/publish
  • Método: POST
  • Requisição: POST /api/certificate/publish
Parâmetro Tipo Obrigatório Descrição
certificate_code int Sim ID do certificado a ser publicado.
code_profile_publication int Sim Código do perfil de publicação. Um perfil de publicação já cadastrado na Segura® será utilizado.
justification string Não Justificativa da solicitação (máx. 1024 caracteres).
reason int Sim Código de motivo para assinatura. Deve haver um código de motivo válido na Segura®.
itsm_code string Condicional Código ITSM. Obrigatório se o campo Código de governança obrigatório ao justificar estiver habilitado no grupo de acesso do certificado.
devices array Sim Array com códigos de dispositivos onde o certificado deve ser publicado.

Exemplo utilizando cURL

curl -X POST https://[segura_vault_url]/api/certificate/publish/{{id_certificado}} \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "code_profile_publication": 22,
    "justification": "Certificate renewal for production servers",
    "reason": 3,
    "itsm_code": "CHG0012345",
    "devices": [101, 102, 103]
  }'

Resposta

{
  "status": 200,
  "message": "Publication scheduled successfully",
  "error": false,
  "code_publishing": 567,
  "reason": "3 - Scheduled Renewal",
  "itsm_code": "CHG0012345",
  "devices": [101, 102, 103]
}

Respostas de erro

Código de status HTTP Descrição
400 Bad Request Parâmetros inválidos fornecidos (campos obrigatórios ausentes ou formato inválido).
401 Unauthorized Acesso não autorizado.
403 Forbidden Permissão negada.
404 Not Found Recurso não encontrado.
500 Internal Server Error Erro interno do servidor.