POST | Criar ou editar perfil de publicação IIS

Prev Next

Cria ou edita um perfil de publicação IIS.

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

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 IIS.
cert_store string Não Repositório de gerenciamento de certificados do IIS. Padrão: MY.
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/iis \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name_profile": "Windows Servers",
    "site": "intranet.example.com",
    "cert_store": "MY",
    "port": 443,
    "code_credential": 15,
    "devices": [201, 202]
  }'

Resposta

{
  "status": 200,
  "message": "Profile created successfully",
  "error": false,
  "code_profile": 35,
  "name_profile": "Windows Servers",
  "site": "intranet.example.com",
  "cert_store": "MY",
  "port": 443,
  "code_credential": 15,
  "devices": [201, 202]
}

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.