POST | Assinar requisição

Prev Next

Assina uma requisição de certificado existente.

  • Endpoint: /api/certificate/request/sign/{id_requisicao}
  • Método: POST
  • Requisição: POST /api/certificate/request/sign/{id_requisicao}

Parâmetros do caminho

Parâmetro Tipo Obrigatório Descrição
request_id int Sim ID de solicitação do certificado a ser assinado.

Parâmetros da requisição

Parâmetro Tipo Obrigatório Descrição
self_signed int Sim Indica se é auto assinado. As opções são: 1 = true e 0 = false.
ca int Condicional O código da CA responsável por assinar a requisição. O código é necessário caso o parâmetro self-signed esteja definido como false.
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.

Exemplo utilizando cURL

curl -X POST https://[segura_vault_url]/api/certificate/request/sign/123 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "self_signed": 0,
    "ca": 5,
    "justification": "Annual certificate renewal",
    "reason": 3,
    "itsm_code": "CHG0012345"
  }'

Resposta

{
  "status": 200,
  "message": "Request signed successfully",
  "error": false,
  "code_request": 123,
  "self_signed": 0,
  "ca": "5 - GlobalSign",
  "justification": "Annual certificate renewal",
  "reason": "3 - Scheduled Renewal",
  "itsm_code": "CHG0012345"
}

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.