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 安全地交互，從而使您能夠輕鬆自動化和管理您的網路安全設定。