POST | Assinar requisição

  • 1 minuto(s) lido(s)
Prev Next

Assinar uma requisição de certificado existente.

  • Endpoint: /api/v1/certificates/requests/{request_id}/sign
  • Método: POST
  • Requisição: POST /api/v1/certificates/requests/{request_id}/sign

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. Valores: 1 = true 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 seja falso.
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.

Exemplo utilizando cURL

curl -X POST https://[segura_vault_url]/api/v1/certificates/requests/123/sign \
  -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"
}