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/v1/certificates/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

Status HTTP	Mensagem de erro
400 Bad Request	Parâmetros inválidos fornecidos (campos obrigatórios ausentes ou formato inválido).
401 Unauthorized	Credenciais de autenticação inválidas. Por exemplo: Token expirado.
404 Not Found	Certificado com o ID especificado não foi encontrado.
500 Internal Server Error	Erro do lado do servidor ocorreu durante o processamento do certificado. Por exemplo: certificado já existente, certificado inválido ou vazio, chave privada inválida ou vazia.