Guía de API abierta de SafeLine: autenticación de token API

En la última versión de SafeLine (v6.6.0 y superior), Open API ahora admite la autenticación basada en token API. Aunque la documentación oficial de la API no está disponible actualmente, puedes extraerla tú mismo si es necesario.

Requisitos:

• Debes iniciar sesión con la cuenta de administrador predeterminada para acceder a esta función.
• La versión de SafeLine debe ser al menos 6.6.0.

GitHub:https://github.com/chaitin/SafeLine
Demostración:https://demo.waf.chaitin.com:9443/dashboard

Cómo utilizar la API abierta

Paso 1: crear un token API

Primero, navegue hasta Administración del sistema en SafeLine y genere un token API.

Paso 2: incluya el token API en sus solicitudes

Al realizar llamadas a la API, debe incluir el token en los encabezados de solicitud de esta manera:

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

Ejemplo: uso de token API en Python para agregar un sitio

A continuación se muestra un ejemplo de cómo utilizar SafeLine Open API con un token API para agregar un nuevo sitio en 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())

Explicación:

• El encabezado contiene el token API requerido para la autenticación.
• La URL es el punto final para agregar un sitio (/api/open/site).
• La carga útil especifica detalles sobre el sitio, como puertos, nombres de servidores, flujos ascendentes y configuración de equilibrio de carga.

Al seguir estos pasos, puede interactuar de forma segura con la API abierta de SafeLine mediante autenticación basada en token, lo que le permitirá automatizar y administrar su configuración de seguridad web con facilidad.