सेफलाइन ओपन एपीआई गाइड: एपीआई टोकन प्रमाणीकरण

सेफलाइन (v6.6.0 और ऊपर) के नवीनतम संस्करण में, ओपन एपीआई अब एपीआई टोकन-आधारित प्रमाणीकरण का समर्थन करता है। हालाँकि आधिकारिक एपीआई दस्तावेज़ वर्तमान में उपलब्ध नहीं है, यदि आवश्यक हो तो आप इसे स्वयं स्क्रैप कर सकते हैं।

आवश्यकताएं:

• इस सुविधा तक पहुंचने के लिए आपको डिफ़ॉल्ट व्यवस्थापक खाते का उपयोग करके लॉग इन करना होगा।
• सेफलाइन संस्करण कम से कम 6.6.0 होना चाहिए।

GitHub:https://github.com/chaitin/SafeLine
डेमो:https://demo.waf.chaitin.com:9443/डैशबोर्ड

ओपन एपीआई का उपयोग कैसे करें

चरण 1: एक एपीआई टोकन बनाएं

सबसे पहले, सेफलाइन में सिस्टम मैनेजमेंट पर जाएं और एक एपीआई टोकन जेनरेट करें।

चरण 2: अपने अनुरोधों में एपीआई टोकन शामिल करें

एपीआई कॉल करते समय, आपको अनुरोध हेडर में टोकन को इस तरह शामिल करना होगा:

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

उदाहरण: साइट जोड़ने के लिए पायथन में एपीआई टोकन का उपयोग करना

पायथन में एक नई साइट जोड़ने के लिए एपीआई टोकन के साथ सेफलाइन ओपन एपीआई का उपयोग कैसे करें इसका एक उदाहरण नीचे दिया गया है।

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())

स्पष्टीकरण:

• हेडर में प्रमाणीकरण के लिए आवश्यक एपीआई टोकन शामिल है।
• URL एक साइट (/api/open/site) जोड़ने का अंतिम बिंदु है।
• पेलोड साइट के बारे में विवरण जैसे पोर्ट, सर्वर नाम, अपस्ट्रीम और लोड-बैलेंसिंग कॉन्फ़िगरेशन निर्दिष्ट करता है।

इन चरणों का पालन करके, आप टोकन-आधारित प्रमाणीकरण का उपयोग करके सेफलाइन के ओपन एपीआई के साथ सुरक्षित रूप से इंटरैक्ट कर सकते हैं, जिससे आप आसानी से अपने वेब सुरक्षा सेटअप को स्वचालित और प्रबंधित कर सकते हैं।