SafeLine 开放 API 指南：API 令牌身份验证

在最新版本的 SafeLine（v6.6.0 及更高版本）中，Open API 现在支持基于 API 令牌的身份验证。虽然目前还没有官方的API文档，但是如果需要的话可以自己爬一下。

要求：

• 您必须使用默认管理员帐户登录才能访问此功能。
• SafeLine 版本必须至少为 6.6.0。

GitHub：https://github.com/chaitin/SafeLine
演示：https://demo.waf.chaitin.com:9443/dashboard

如何使用开放API

第 1 步：创建 API 令牌

首先，导航到 SafeLine 中的系统管理并生成 API 令牌。

第 2 步：在您的请求中包含 API 令牌

进行 API 调用时，您需要在请求标头中包含令牌，如下所示：

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

示例：在 Python 中使用 API 令牌添加站点

下面是如何使用 SafeLine Open API 和 API 令牌在 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())

解释：

• 标头包含身份验证所需的 API 令牌。
• URL 是添加站点的端点 (/api/open/site)。
• 有效负载指定有关站点的详细信息，例如端口、服务器名称、上游和负载平衡配置。

通过执行这些步骤，您可以使用基于令牌的身份验证与 SafeLine 的开放 API 安全地交互，从而使您能够轻松自动化和管理您的网络安全设置。