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. |