POST | Publicar certificado

Prev Next

O usuário solicita a publicação de um certificado para um ou mais dispositivos.

  • Endpoint: /api/v1/certificates/{certificate_id}/publish
  • Método: POST
  • Requisição: POST /api/v1/certificates/{certificate_id}/publish

Parâmetros do caminho

Parâmetro Tipo Obrigatório Descrição
certificate_id Int Sim ID do certificado a ser publicado.

Parâmetros da requisição

Parâmetro Tipo Obrigatório Descrição
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 "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/v1/certificates/456/publish \
  -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]
}