POST | Importar um certificado SSL

Importa um certificado SSL no sistema.

Endpoint: /api/v1/certificates/import
Método: POST
Requisição: POST /api/v1/certificates/import

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`certificate`	`string`	Sim	Arquivo de certificado codificado em Base64.
`private_key`	`string`	Não	Arquivo de chave privada codificado em Base64. Se vazio, a chave não estará disponível no sistema, limitando o uso do certificado, publicação e associação de dispositivos. Nota: arquivos `.pfx` já inclui uma chave privada.
`password`	`string`	Não	Senha para recuperar o certificado correspondente.
`revoke_password`	`string`	Não	Senha para revogar o certificado SSL associado.
`extension`	`string`	Sim	Extensão do arquivo do certificado.

Exemplo utilizando cURL

curl -X POST https://[segura_vault_url]/api/certificate/import \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "certificate": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUVCVENDQW...",
    "private_key": "LS0tLS1CRUdJTiBQUklWQVRFIEtFWS0tLS0tCk1JSUV2UUlCQU...",
    "password": "certpass123",
    "revoke_password": "revokepass456",
    "extension": "crt"
  }'

Resposta

{
  "status": 200,
  "message": "Certificate imported successfully",
  "error": false,
  "code_certificate": 789,
  "common_name": "api.example.com",
  "issuer": "GlobalSign",
  "validity_start": "2024-01-15",
  "validity_end": "2025-01-15"
}

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. Por exemplo: certificado inválido ou vazio, chave privada inválida ou vazia.