Guia SafeLine Open API: Autenticação de token de API

Na versão mais recente do SafeLine (v6.6.0 e superior), a Open API agora oferece suporte à autenticação baseada em token de API. Embora a documentação oficial da API não esteja disponível no momento, você mesmo pode obtê-la, se necessário.

Requisitos:

• Você deve estar conectado usando a conta de administrador padrão para acessar este recurso.
• A versão do SafeLine deve ser pelo menos 6.6.0.

GitHub:https://github.com/chaitin/SafeLine
Demonstração:https://demo.waf.chaitin.com:9443/dashboard

Como usar a API aberta

Etapa 1: crie um token de API

Primeiro, navegue até Gerenciamento do sistema no SafeLine e gere um token de API.

Etapa 2: inclua o token da API em suas solicitações

Ao fazer chamadas de API, você precisa incluir o token nos cabeçalhos da solicitação como este:

"X-SLCE-API-TOKEN": "Your API Token from SafeLine"

Exemplo: usando token de API em Python para adicionar um site

Abaixo está um exemplo de como usar a API SafeLine Open com um token de API para adicionar um novo site em Python.

import requests
import json

# Define the header with your API token
header = {
    "X-SLCE-API-TOKEN": "Your API Token from SafeLine"
}

# API endpoint to add a site
url = 'https://:9443/api/open/site'

# Payload containing site details
payload = {
    "ports": ["80"],
    "server_names": ["*"],
    "upstreams": ["http://127.0.0.1:9443"],
    "comment": "",
    "load_balance": {
        "balance_type": 1
    }
}

# Convert payload to JSON
payload = json.dumps(payload)

# Send the POST request
response = requests.post(url=url, headers=header, data=payload, verify=False)

# Check the response
print(response.status_code)
print(response.json())

Explicação:

• O cabeçalho contém o token de API necessário para autenticação.
• O URL é o ponto final para adicionar um site (/api/open/site).
• A payload especifica detalhes sobre o site, como portas, nomes de servidores, upstreams e configuração de balanceamento de carga.

Seguindo essas etapas, você pode interagir com segurança com a API aberta do SafeLine usando autenticação baseada em token, permitindo automatizar e gerenciar sua configuração de segurança da web com facilidade.