POST | Criar ou editar um perfil de publicação Apache

Prev Next

Cria ou edita um perfil de publicação para um plugin Apache.

  • Endpoint: /api/certificate/profile/apache
  • Método: POST
  • Requisição: POST /api/certificate/profile/apache

Parâmetros da requisição

Parâmetro Tipo Obrigatório Descrição
code_profile int Não Código de perfil existente. Um novo perfil será criado caso não exista um.
name_profile string Sim Nome do perfil.
site string Não Site onde o certificado deve ser instalado. Se não for informado, o certificado será instalado no site padrão do Apache.
config_path string Não Caminho do arquivo de configuração. Padrão: /etc/apache2/sites-available/default.com.conf.
port int Não Porta. Padrão: 443.
code_credential int Condicional Código da credencial a ser usado na publicação. Obrigatório se o username não for fornecido.
username string Condicional Nome de usuário utilizado para localizar credenciais para publicação. Obrigatório se o code_credential não for fornecido.
devices array Sim Array com códigos de dispositivos onde o certificado deve ser publicado.

Exemplo utilizando cURL

curl -X POST https://[segura_vault_url]/api/certificate/profile/apache \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name_profile": "Web Servers - Production",
    "site": "api.example.com",
    "config_path": "/etc/apache2/sites-available/api.example.com.conf",
    "port": 443,
    "username": "admin",
    "devices": [101, 102, 103]
  }'

Resposta

{
  "status": 200,
  "message": "Profile created successfully",
  "error": false,
  "code_profile": 22,
  "name_profile": "Web Servers - Production",
  "site": "api.example.com",
  "config_path": "/etc/apache2/sites-available/api.example.com.conf",
  "port": 443,
  "username": "admin",
  "devices": [101, 102, 103]
}

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.