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 토큰을 사용하여 사이트 추가

다음은 API 토큰과 함께 SafeLine Open 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와 안전하게 상호 작용할 수 있으므로 웹 보안 설정을 쉽게 자동화하고 관리할 수 있습니다.