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]
}