पाइथन SDK को साथ चेक पोइन्ट API लाई सरल बनाउँदै

एपीआईसँगको अन्तरक्रियाको पूर्ण शक्ति प्रोग्राम कोडसँग सँगै प्रयोग गर्दा, API प्रतिक्रियाहरू विश्लेषण गर्नका लागि गतिशील रूपमा API अनुरोधहरू र उपकरणहरू उत्पन्न गर्न सम्भव हुँदा प्रकट हुन्छ। यद्यपि, यो अझै पनि अप्रत्याशित छ पाइथन सफ्टवेयर विकास किट (यसपछि पाइथन SDK भनिन्छ) को लागि बिन्दु व्यवस्थापन API जाँच गर्नुहोस्, तर व्यर्थमा। यसले विकासकर्ताहरू र स्वचालन उत्साहीहरूको जीवनलाई महत्त्वपूर्ण रूपमा सरल बनाउँछ। पाइथनले भर्खरै धेरै लोकप्रियता प्राप्त गरेको छ र मैले खाली ठाउँ भर्ने र मुख्य सुविधाहरू समीक्षा गर्ने निर्णय गरें। पोइन्ट API पाइथन विकास किट जाँच गर्नुहोस्। यस लेखले Habré मा अर्को लेखमा उत्कृष्ट थपको रूपमा कार्य गर्दछ पोइन्ट R80.10 API जाँच गर्नुहोस्। CLI, स्क्रिप्ट र थप मार्फत व्यवस्थापन। हामी पाइथन SDK प्रयोग गरेर स्क्रिप्टहरू कसरी लेख्ने भनेर हेर्नेछौं र संस्करण 1.6 (R80.40 बाट समर्थित) मा नयाँ व्यवस्थापन API कार्यक्षमतालाई नजिकबाट हेर्नेछौं। लेख बुझ्नको लागि, तपाईंलाई API र पाइथनसँग काम गर्ने आधारभूत ज्ञान चाहिन्छ।

चेक पोइन्ट सक्रिय रूपमा एपीआई विकास गर्दैछ र यस समयमा निम्न जारी गरिएको छ:

• बिन्दु व्यवस्थापन API जाँच गर्नुहोस् (हालको संस्करण 1.6) — API मार्फत नियन्त्रण सर्भरसँग काम गर्नुहोस् (र नियन्त्रण सर्भरद्वारा नियन्त्रित गेटवेहरूमा स्क्रिप्टहरू कार्यान्वयन गर्ने क्षमता)
• चेक पोइन्ट GAIA API (हालको संस्करण १.४) - सुरक्षा गेटवे संग काम
• खतरा रोकथाम API 1.0 — चेक पोइन्ट क्लाउडमा स्यान्डबक्ससँग काम गर्दै
• पहिचान जागरूकता API — गेटवेहरूमा पहिचान जागरूकता ब्लेडसँग काम गर्दै
• सुरक्षा व्यवस्थापन पोर्टल API - SMB गेटवे व्यवस्थापन पोर्टलसँग काम गर्नुहोस् (SMB गेटवे बारे थप)
• IoT API - IoT नियन्त्रकहरु संग अन्तरक्रिया
• CloudGuard Connect API - संग काम गर्नुहोस् CloudGuard जडान (SD-WAN सुरक्षा समाधान)
• Dome9 API - संग काम गर्नुहोस् डोम १

Python SDK ले हाल मात्र व्यवस्थापन API र अन्तरक्रियालाई समर्थन गर्दछ Gaia API। हामी यस मोड्युलमा सबैभन्दा महत्त्वपूर्ण वर्गहरू, विधिहरू र चरहरू हेर्नेछौं।

मोड्युल स्थापना गर्दै

मोड्युल cpapi बाट छिटो र सजिलै स्थापना गर्दछ Github मा आधिकारिक चेक पोइन्ट भण्डार सहयोगको साथ PIP। विस्तृत स्थापना निर्देशनहरू उपलब्ध छन् README.md। यो मोड्युल Python संस्करण 2.7 र 3.7 सँग काम गर्न अनुकूलित छ। यस लेखमा, पाइथन ३.७ प्रयोग गरी उदाहरणहरू दिइनेछ। यद्यपि, पाइथन SDK चेक पोइन्ट व्यवस्थापन सर्भर (स्मार्ट व्यवस्थापन) बाट सीधा चलाउन सकिन्छ, तर तिनीहरूले पाइथन २.७ लाई मात्र समर्थन गर्दछ, त्यसैले अन्तिम खण्डले संस्करण २.७ को लागि कोड प्रदान गर्नेछ। मोड्युल स्थापना गरेपछि तुरुन्तै, म निर्देशिकाहरूमा उदाहरणहरू हेर्न सिफारिस गर्दछु example_python2 и example_python3.

सुरुवात

हामीले cpapi मोड्युलका कम्पोनेन्टहरूसँग काम गर्न सक्षम हुनको लागि, हामीले मोड्युलबाट आयात गर्न आवश्यक छ। cpapi कम्तिमा दुई आवश्यक कक्षाहरू:

APIClient и APIClientArgs

from cpapi import APIClient, APIClientArgs

Класс APIClientArgs API सर्भर, र वर्गमा जडान प्यारामिटरहरूको लागि जिम्मेवार छ APIClient API सँग अन्तरक्रियाको लागि जिम्मेवार छ।

जडान प्यारामिटरहरू निर्धारण गर्दै

API मा जडान गर्नका लागि विभिन्न प्यारामिटरहरू परिभाषित गर्न, तपाईंले कक्षाको उदाहरण सिर्जना गर्न आवश्यक छ APIClientArgs। सिद्धान्तमा, यसको प्यारामिटरहरू पूर्वनिर्धारित छन् र नियन्त्रण सर्भरमा स्क्रिप्ट चलाउँदा, तिनीहरूलाई निर्दिष्ट गर्न आवश्यक छैन।

client_args = APIClientArgs()

तर तेस्रो-पक्ष होस्टमा चल्दा, तपाईंले कम्तिमा IP ठेगाना वा API सर्भरको होस्ट नाम निर्दिष्ट गर्न आवश्यक छ (व्यवस्थापन सर्भर पनि भनिन्छ)। तलको उदाहरणमा, हामी सर्भर जडान प्यारामिटर परिभाषित गर्छौं र यसलाई स्ट्रिङको रूपमा व्यवस्थापन सर्भरको आईपी ठेगाना तोक्छौं।

client_args = APIClientArgs(server='192.168.47.241')

सबै प्यारामिटरहरू र तिनीहरूको पूर्वनिर्धारित मानहरू हेरौं जुन API सर्भरमा जडान गर्दा प्रयोग गर्न सकिन्छ:

APIClientArgs वर्गको __init__ विधिका तर्कहरू

class APIClientArgs:
    """
    This class provides arguments for APIClient configuration.
    All the arguments are configured with their default values.
    """

    # port is set to None by default, but it gets replaced with 443 if not specified
    # context possible values - web_api (default) or gaia_api
    def __init__(self, port=None, fingerprint=None, sid=None, server="127.0.0.1", http_debug_level=0,
                 api_calls=None, debug_file="", proxy_host=None, proxy_port=8080,
                 api_version=None, unsafe=False, unsafe_auto_accept=False, context="web_api"):
        self.port = port
        # management server fingerprint
        self.fingerprint = fingerprint
        # session-id.
        self.sid = sid
        # management server name or IP-address
        self.server = server
        # debug level
        self.http_debug_level = http_debug_level
        # an array with all the api calls (for debug purposes)
        self.api_calls = api_calls if api_calls else []
        # name of debug file. If left empty, debug data will not be saved to disk.
        self.debug_file = debug_file
        # HTTP proxy server address (without "http://")
        self.proxy_host = proxy_host
        # HTTP proxy port
        self.proxy_port = proxy_port
        # Management server's API version
        self.api_version = api_version
        # Indicates that the client should not check the server's certificate
        self.unsafe = unsafe
        # Indicates that the client should automatically accept and save the server's certificate
        self.unsafe_auto_accept = unsafe_auto_accept
        # The context of using the client - defaults to web_api
        self.context = context

मलाई विश्वास छ कि APIClientArgs वर्गको उदाहरणहरूमा प्रयोग गर्न सकिने तर्कहरू चेक पोइन्ट प्रशासकहरूको लागि सहज छन् र थप टिप्पणीहरू आवश्यक पर्दैन।

APIClient र सन्दर्भ प्रबन्धक मार्फत जडान गर्दै

Класс APIClient यसलाई प्रयोग गर्ने सबैभन्दा सुविधाजनक तरिका सन्दर्भ प्रबन्धक मार्फत हो। APIClient वर्गको उदाहरणमा पास गर्न आवश्यक सबै जडान प्यारामिटरहरू हुन् जुन अघिल्लो चरणमा परिभाषित गरिएको थियो।

with APIClient(client_args) as client:

सन्दर्भ प्रबन्धकले स्वचालित रूपमा API सर्भरमा लगइन कल गर्दैन, तर यसले बाहिर निस्कँदा लगआउट कल गर्नेछ। यदि कुनै कारणले API कलहरूसँग काम गरिसकेपछि लगआउट आवश्यक छैन भने, तपाईंले सन्दर्भ प्रबन्धक प्रयोग नगरी काम सुरु गर्न आवश्यक छ:

client = APIClient(clieng_args)

जडान परीक्षण

जडानले निर्दिष्ट प्यारामिटरहरू पूरा गर्छ कि भनेर जाँच गर्ने सबैभन्दा सजिलो तरिका विधि प्रयोग गर्दैछ चेक_फिंगरप्रिन्ट। यदि सर्भर API प्रमाणपत्रको फिंगरप्रिन्टको लागि sha1 ह्यास योगको प्रमाणीकरण असफल भयो (विधि फिर्ता गरियो झूटा), तब यो सामान्यतया जडान समस्याहरूको कारणले गर्दा हुन्छ र हामी कार्यक्रमको कार्यान्वयन रोक्न सक्छौं (वा प्रयोगकर्तालाई जडान डेटा सच्याउने मौका दिनुहोस्):

    if client.check_fingerprint() is False:
        print("Could not get the server's fingerprint - Check connectivity with the server.")
        exit(1)

कृपया ध्यान दिनुहोस् कि भविष्यमा कक्षा APIClient प्रत्येक API कल जाँच गर्नेछ (विधिहरू api_call и api_query, हामी तिनीहरूको बारेमा अलि अगाडि कुरा गर्नेछौं) API सर्भरमा sha1 फिंगरप्रिन्ट प्रमाणपत्र। तर यदि, API सर्भर प्रमाणपत्रको sha1 फिंगरप्रिन्ट जाँच गर्दा, त्रुटि पत्ता लाग्यो (प्रमाणपत्र अज्ञात छ वा परिवर्तन गरिएको छ), विधि चेक_फिंगरप्रिन्ट स्थानीय मेसिनमा स्वचालित रूपमा यसको बारेमा जानकारी थप्न/परिवर्तन गर्ने अवसर प्रदान गर्नेछ। यो जाँचलाई पूर्ण रूपमा असक्षम गर्न सकिन्छ (तर यदि 127.0.0.1 मा जडान गर्दा, API सर्भरमा स्क्रिप्टहरू चलाइएमा मात्र यो सिफारिस गर्न सकिन्छ), APIClientArgs तर्क प्रयोग गरेर - unsafe_auto_accept (APIClientArgs को बारेमा पहिले "परिभाषित जडान प्यारामिटरहरू" मा हेर्नुहोस्)।

client_args = APIClientArgs(unsafe_auto_accept=True)

API सर्भरमा लगइन गर्नुहोस्

У APIClient एपीआई सर्भरमा लग इन गर्नका लागि 3 भन्दा बढी तरिकाहरू छन्, र तिनीहरूमध्ये प्रत्येकले अर्थ बुझ्दछ Sid(सत्र-आईडी), जुन हेडरमा प्रत्येक पछिल्ला API कलमा स्वचालित रूपमा प्रयोग गरिन्छ (यस प्यारामिटरको हेडरमा नाम हो। X-chkp-sid), त्यसैले यो प्यारामिटर थप प्रक्रिया गर्न आवश्यक छैन।

लगइन विधि

लगइन र पासवर्ड प्रयोग गर्ने विकल्प (उदाहरणका लागि, प्रयोगकर्ता नाम प्रशासक र पासवर्ड 1q2w3e पोजिशनल आर्गुमेन्टको रूपमा पारित गरिएको छ):

     login = client.login('admin', '1q2w3e')  

लगइन विधिमा अतिरिक्त वैकल्पिक प्यारामिटरहरू पनि उपलब्ध छन्; यहाँ तिनीहरूको नाम र पूर्वनिर्धारित मानहरू छन्:

continue_last_session=False, domain=None, read_only=False, payload=None

लगइन_with_api_key विधि

एपीआई कुञ्जी प्रयोग गर्ने विकल्प (व्यवस्थापन संस्करण R80.40/Management API v1.6 बाट सुरु गरी समर्थित, "3TsbPJ8ZKjaJGvFyoFqHFA==" यो API कुञ्जी प्राधिकरण विधिको साथ व्यवस्थापन सर्भरमा प्रयोगकर्ताहरू मध्ये एकको लागि API कुञ्जी मान हो):

     login = client.login_with_api_key('3TsbPJ8ZKjaJGvFyoFqHFA==') 

विधिमा लगइन_with_api_key उही वैकल्पिक प्यारामिटरहरू विधिमा उपलब्ध छन् लग - इन.

login_as_root विधि

एपीआई सर्भरको साथ स्थानीय मेसिनमा लगइन गर्ने विकल्प:

     login = client.login_as_root()

यस विधिको लागि केवल दुई वैकल्पिक प्यारामिटरहरू उपलब्ध छन्:

domain=None, payload=None

र अन्तमा API ले आफैलाई कल गर्दछ

विधिहरू मार्फत API कलहरू गर्न हामीसँग दुई विकल्पहरू छन् api_call и api_query। तिनीहरू बीचको भिन्नता के हो पत्ता लगाउनुहोस्।

api_call

यो विधि कुनै पनि कलहरूको लागि लागू हुन्छ। हामीले एपीआई कलको लागि अन्तिम भाग पास गर्न आवश्यक छ र आवश्यक भएमा अनुरोध मुख्य भागमा पेलोड। यदि पेलोड खाली छ भने, यो सबै स्थानान्तरण गर्न सकिँदैन:

api_versions = client.api_call('show-api-versions') 

कट तलको यो अनुरोधको लागि आउटपुट:

In [23]: api_versions                                                           
Out[23]: 
APIResponse({
    "data": {
        "current-version": "1.6",
        "supported-versions": [
            "1",
            "1.1",
            "1.2",
            "1.3",
            "1.4",
            "1.5",
            "1.6"
        ]
    },
    "res_obj": {
        "data": {
            "current-version": "1.6",
            "supported-versions": [
                "1",
                "1.1",
                "1.2",
                "1.3",
                "1.4",
                "1.5",
                "1.6"
            ]
        },
        "status_code": 200
    },
    "status_code": 200,
    "success": true
})

show_host = client.api_call('show-host', {'name' : 'h_8.8.8.8'})

कट तलको यो अनुरोधको लागि आउटपुट:

In [25]: show_host                                                              
Out[25]: 
APIResponse({
    "data": {
        "color": "black",
        "comments": "",
        "domain": {
            "domain-type": "domain",
            "name": "SMC User",
            "uid": "41e821a0-3720-11e3-aa6e-0800200c9fde"
        },
        "groups": [],
        "icon": "Objects/host",
        "interfaces": [],
        "ipv4-address": "8.8.8.8",
        "meta-info": {
            "creation-time": {
                "iso-8601": "2020-05-01T21:49+0300",
                "posix": 1588358973517
            },
            "creator": "admin",
            "last-modifier": "admin",
            "last-modify-time": {
                "iso-8601": "2020-05-01T21:49+0300",
                "posix": 1588358973517
            },
            "lock": "unlocked",
            "validation-state": "ok"
        },
        "name": "h_8.8.8.8",
        "nat-settings": {
            "auto-rule": false
        },
        "read-only": false,
        "tags": [],
        "type": "host",
        "uid": "c210af07-1939-49d3-a351-953a9c471d9e"
    },
    "res_obj": {
        "data": {
            "color": "black",
            "comments": "",
            "domain": {
                "domain-type": "domain",
                "name": "SMC User",
                "uid": "41e821a0-3720-11e3-aa6e-0800200c9fde"
            },
            "groups": [],
            "icon": "Objects/host",
            "interfaces": [],
            "ipv4-address": "8.8.8.8",
            "meta-info": {
                "creation-time": {
                    "iso-8601": "2020-05-01T21:49+0300",
                    "posix": 1588358973517
                },
                "creator": "admin",
                "last-modifier": "admin",
                "last-modify-time": {
                    "iso-8601": "2020-05-01T21:49+0300",
                    "posix": 1588358973517
                },
                "lock": "unlocked",
                "validation-state": "ok"
            },
            "name": "h_8.8.8.8",
            "nat-settings": {
                "auto-rule": false
            },
            "read-only": false,
            "tags": [],
            "type": "host",
            "uid": "c210af07-1939-49d3-a351-953a9c471d9e"
        },
        "status_code": 200
    },
    "status_code": 200,
    "success": true
})

api_query

मलाई तुरुन्तै आरक्षण गर्न दिनुहोस् कि यो विधि कलहरूको लागि मात्र लागू हुन्छ जसको आउटपुट अफसेट समावेश छ। यस्तो निष्कर्ष तब हुन्छ जब यसले धेरै मात्रामा जानकारी समावेश गर्दछ वा हुन सक्छ। उदाहरणका लागि, यो व्यवस्थापन सर्भरमा सबै सिर्जना गरिएका होस्ट वस्तुहरूको सूचीको लागि अनुरोध हुन सक्छ। त्यस्ता अनुरोधहरूको लागि, API ले पूर्वनिर्धारित रूपमा 50 वस्तुहरूको सूची फर्काउँछ (तपाईले प्रतिक्रियामा 500 वस्तुहरूमा सीमा बढाउन सक्नुहुन्छ)। र एपीआई अनुरोधमा अफसेट प्यारामिटर परिवर्तन गरेर धेरै पटक जानकारी तान्न नपरोस्, त्यहाँ एक api_query विधि छ जसले यो स्वचालित रूपमा काम गर्दछ। कलहरूको उदाहरणहरू जहाँ यो विधि आवश्यक छ: शो-सत्रहरू, शो-होस्टहरू, शो-नेटवर्कहरू, शो-वाइल्डकार्डहरू, शो-समूहहरू, शो-ठेगाना-दायराहरू, देखाउनुहोस्-सरल-गेटवेहरू, देखाउनुहोस्-सरल-क्लस्टरहरू, शो-पहुँच-भूमिकाहरू, शो-विश्वस्त-ग्राहकहरू, देखाउने प्याकेजहरू। वास्तवमा, हामी यी API कलहरूको नाममा बहुवचन शब्दहरू देख्छौं, त्यसैले यी कलहरू मार्फत ह्यान्डल गर्न सजिलो हुनेछ। api_query

show_hosts = client.api_query('show-hosts') 

कट तलको यो अनुरोधको लागि आउटपुट:

In [21]: show_hosts                                                             
Out[21]: 
APIResponse({
    "data": [
        {
            "domain": {
                "domain-type": "domain",
                "name": "SMC User",
                "uid": "41e821a0-3720-11e3-aa6e-0800200c9fde"
            },
            "ipv4-address": "192.168.47.1",
            "name": "h_192.168.47.1",
            "type": "host",
            "uid": "5d7d7086-d70b-4995-971a-0583b15a2bfc"
        },
        {
            "domain": {
                "domain-type": "domain",
                "name": "SMC User",
                "uid": "41e821a0-3720-11e3-aa6e-0800200c9fde"
            },
            "ipv4-address": "8.8.8.8",
            "name": "h_8.8.8.8",
            "type": "host",
            "uid": "c210af07-1939-49d3-a351-953a9c471d9e"
        }
    ],
    "res_obj": {
        "data": {
            "from": 1,
            "objects": [
                {
                    "domain": {
                        "domain-type": "domain",
                        "name": "SMC User",
                        "uid": "41e821a0-3720-11e3-aa6e-0800200c9fde"
                    },
                    "ipv4-address": "192.168.47.1",
                    "name": "h_192.168.47.1",
                    "type": "host",
                    "uid": "5d7d7086-d70b-4995-971a-0583b15a2bfc"
                },
                {
                    "domain": {
                        "domain-type": "domain",
                        "name": "SMC User",
                        "uid": "41e821a0-3720-11e3-aa6e-0800200c9fde"
                    },
                    "ipv4-address": "8.8.8.8",
                    "name": "h_8.8.8.8",
                    "type": "host",
                    "uid": "c210af07-1939-49d3-a351-953a9c471d9e"
                }
            ],
            "to": 2,
            "total": 2
        },
        "status_code": 200
    },
    "status_code": 200,
    "success": true
})

API कलहरूको परिणामहरू प्रशोधन गर्दै

यस पछि तपाईले कक्षाको चर र विधिहरू प्रयोग गर्न सक्नुहुन्छ API प्रतिक्रिया(दुबै सन्दर्भ प्रबन्धक भित्र र बाहिर)। कक्षामा API प्रतिक्रिया 4 विधिहरू र 5 चरहरू पूर्वनिर्धारित छन्; हामी थप विवरणमा सबैभन्दा महत्त्वपूर्णहरूमा बस्नेछौं।

सफलता

सुरुमा, एपीआई कल सफल भएको र नतिजा फर्काइयो भनी सुनिश्चित गर्नु राम्रो विचार हुनेछ। यसका लागि विधि छ सफलता:

In [49]: api_versions.success                                                   
Out[49]: True

API कल सफल भएमा True फर्काउँछ (प्रतिक्रिया कोड - 200) र असफल भएमा False (कुनै अन्य प्रतिक्रिया कोड)। प्रतिक्रिया कोडको आधारमा फरक जानकारी प्रदर्शन गर्न API कल पछि तुरुन्तै प्रयोग गर्न यो सुविधाजनक छ।

if api_ver.success: 
    print(api_versions.data) 
else: 
    print(api_versions.err_message) 

स्थितिकोड

API कल गरिसकेपछि प्रतिक्रिया कोड फर्काउँछ।

In [62]: api_versions.status_code                                               
Out[62]: 400

सम्भावित प्रतिक्रिया कोडहरू: 200,400,401,403,404,409,500,501.

set_success_status

यस अवस्थामा, यो सफलता स्थिति को मूल्य परिवर्तन गर्न आवश्यक हुन सक्छ। प्राविधिक रूपमा, तपाइँ त्यहाँ केहि पनि राख्न सक्नुहुन्छ, नियमित स्ट्रिङ पनि। तर एउटा वास्तविक उदाहरणले यो प्यारामिटरलाई केही निश्चित सर्तहरूमा False मा रिसेट गर्दैछ। तल, व्यवस्थापन सर्भरमा कार्यहरू चलिरहेको बेला उदाहरणमा ध्यान दिनुहोस्, तर हामी यो अनुरोधलाई असफल मान्नेछौं (हामी सफलता चर सेट गर्नेछौं। झूटा, API कल सफल भएको र कोड 200 फर्काइयो भन्ने तथ्यको बावजुद।

for task in task_result.data["tasks"]:
    if task["status"] == "failed" or task["status"] == "partially succeeded":
        task_result.set_success_status(False)
        break

प्रतिक्रिया()

प्रतिक्रिया विधिले तपाईंलाई प्रतिक्रिया कोड (status_code) र प्रतिक्रिया शरीर (शरीर) को साथ शब्दकोश हेर्न अनुमति दिन्छ।

In [94]: api_versions.response()                                                
Out[94]: 
{'status_code': 200,
 'data': {'current-version': '1.6',
  'supported-versions': ['1', '1.1', '1.2', '1.3', '1.4', '1.5', '1.6']}}

डाटा

तपाईंलाई अनावश्यक जानकारी बिना प्रतिक्रियाको मुख्य भाग (शरीर) हेर्न अनुमति दिन्छ।

In [93]: api_versions.data                                                      
Out[93]: 
{'current-version': '1.6',
 'supported-versions': ['1', '1.1', '1.2', '1.3', '1.4', '1.5', '1.6']}

त्रुटि सन्देश

एपीआई अनुरोध प्रशोधन गर्दा त्रुटि देखा पर्दा मात्र यो जानकारी उपलब्ध हुन्छ (प्रतिक्रिया कोड छैन 200)। उदाहरण आउटपुट

In [107]: api_versions.error_message                                            
Out[107]: 'code: generic_err_invalid_parameter_namenmessage: Unrecognized parameter [1]n'

उपयोगी उदाहरणहरू

व्यवस्थापन API 1.6 मा थपिएका API कलहरू प्रयोग गर्ने उदाहरणहरू निम्न छन्।

पहिले, कलहरू कसरी काम गर्छ भनी हेरौं add-host и थप-ठेगाना-दायरा। मानौं हामीले सबनेट 192.168.0.0/24 को सबै IP ठेगानाहरू सिर्जना गर्न आवश्यक छ, जसको अन्तिम अक्टेट 5 हो, होस्ट प्रकारको वस्तुको रूपमा, र अन्य सबै IP ठेगानाहरू ठेगाना दायरा प्रकारको वस्तुको रूपमा लेख्नुहोस्। यस अवस्थामा, सबनेट ठेगाना र प्रसारण ठेगाना बहिष्कार गर्नुहोस्।

त्यसोभए, तल एउटा स्क्रिप्ट छ जसले यो समस्या समाधान गर्दछ र होस्ट प्रकारको 50 वस्तुहरू र ठेगाना दायरा प्रकारको 51 वस्तुहरू सिर्जना गर्दछ। समस्या समाधान गर्न, 101 API कलहरू आवश्यक छन् (अन्तिम प्रकाशन कल गणना नगरी)। साथै, timeit मोड्युल प्रयोग गरेर, हामी परिवर्तनहरू प्रकाशित नभएसम्म लिपि कार्यान्वयन गर्न लाग्ने समय गणना गर्छौं।

add-host र add-address-range प्रयोग गरेर लिपि

import timeit
from cpapi import APIClient, APIClientArgs

start = timeit.default_timer()

first_ip = 1
last_ip = 4

client_args = APIClientArgs(server="192.168.47.240")

with APIClient(client_args) as client: 
     login = client.login_with_api_key('3TsbPJ8ZKjaJGvFyoFqHFA==')
     for ip in range(5,255,5):
         add_host = client.api_call("add-host", {"name" : f"h_192.168.0.{ip}", "ip-address": f'192.168.0.{ip}'})
     while last_ip < 255:
         add_range = client.api_call("add-address-range", {"name": f"r_192.168.0.{first_ip}-{last_ip}", "ip-address-first": f"192.168.0.{first_ip}", "ip-address-last": f"192.168.0.{last_ip}"})
         first_ip+=5
         last_ip+=5
     stop = timeit.default_timer() 
     publish = client.api_call("publish")
     
print(f'Time to execute batch request: {stop - start} seconds')

मेरो प्रयोगशाला वातावरणमा, यो स्क्रिप्टले व्यवस्थापन सर्भरमा लोडको आधारमा कार्यान्वयन गर्न 30 र 50 सेकेन्डको बीचमा लिन्छ।

अब एपीआई कल प्रयोग गरेर समान समस्या कसरी समाधान गर्ने हेरौं add-objects-batch, समर्थन जसको लागि API संस्करण 1.6 मा थपिएको थियो। यो कलले तपाईंलाई एउटै एपीआई अनुरोधमा धेरै वस्तुहरू सिर्जना गर्न अनुमति दिन्छ। यसबाहेक, यी विभिन्न प्रकारका वस्तुहरू हुन सक्छन् (उदाहरणका लागि, होस्टहरू, सबनेटहरू र ठेगाना दायराहरू)। यसैले, हाम्रो कार्य एक API कल को रूपरेखा भित्र समाधान गर्न सकिन्छ।

add-objects-batch प्रयोग गरेर लिपि

import timeit
from cpapi import APIClient, APIClientArgs

start = timeit.default_timer()

client_args = APIClientArgs(server="192.168.47.240")

objects_list_ip = []
objects_list_range = []

for ip in range(5,255,5):
    data = {"name": f'h_192.168.0.{ip}', "ip-address": f'192.168.0.{ip}'}
    objects_list_ip.append(data)
    
first_ip = 1
last_ip = 4


while last_ip < 255:
    data = {"name": f"r_192.168.0.{first_ip}-{last_ip}", "ip-address-first": f"192.168.0.{first_ip}", "ip-address-last": f"192.168.0.{last_ip}"}
    objects_list_range.append(data)
    first_ip+=5
    last_ip+=5

data_for_batch = {
  "objects" : [ {
    "type" : "host",
    "list" : objects_list_ip
}, {
    "type" : "address-range",
    "list" : objects_list_range
  }]
}


with APIClient(client_args) as client: 
     login = client.login_with_api_key('3TsbPJ8ZKjaJGvFyoFqHFA==')
     add_objects_batch = client.api_call("add-objects-batch", data_for_batch)
     stop = timeit.default_timer() 
     publish = client.api_call("publish")
     
print(f'Time to execute batch request: {stop - start} seconds')

र मेरो प्रयोगशाला वातावरणमा यो स्क्रिप्ट चलाउन 3 देखि 7 सेकेन्ड लाग्छ, व्यवस्थापन सर्भरमा लोडमा निर्भर गर्दछ। अर्थात्, औसतमा, १०१ API वस्तुहरूमा, ब्याच प्रकारको कल १० गुणा छिटो चल्छ। वस्तुहरूको ठूलो संख्यामा भिन्नता अझ प्रभावशाली हुनेछ।

अब कसरी काम गर्ने भनेर हेरौं सेट-वस्तुहरू-बैच। यो API कल प्रयोग गरेर, हामी कुनै पनि प्यारामिटर बल्क परिवर्तन गर्न सक्छौं। अघिल्लो उदाहरणबाट ठेगानाहरूको पहिलो आधा सेट गरौं (124 होस्टहरू, र दायराहरू पनि) रङ सिएनामा, र रङ खाकीलाई ठेगानाहरूको दोस्रो भागमा असाइन गरौं।

अघिल्लो उदाहरणमा सिर्जना गरिएका वस्तुहरूको रंग परिवर्तन गर्दै

from cpapi import APIClient, APIClientArgs

client_args = APIClientArgs(server="192.168.47.240")

objects_list_ip_first = []
objects_list_range_first = []
objects_list_ip_second = []
objects_list_range_second = []

for ip in range(5,125,5):
    data = {"name": f'h_192.168.0.{ip}', "color": "sienna"}
    objects_list_ip_first.append(data)
    
for ip in range(125,255,5):
    data = {"name": f'h_192.168.0.{ip}', "color": "khaki"}
    objects_list_ip_second.append(data)
    
first_ip = 1
last_ip = 4
while last_ip < 125:
    data = {"name": f"r_192.168.0.{first_ip}-{last_ip}", "color": "sienna"}
    objects_list_range_first.append(data)
    first_ip+=5
    last_ip+=5
    
while last_ip < 255:
    data = {"name": f"r_192.168.0.{first_ip}-{last_ip}", "color": "khaki"}
    objects_list_range_second.append(data)
    first_ip+=5
    last_ip+=5

data_for_batch_first  = {
  "objects" : [ {
    "type" : "host",
    "list" : objects_list_ip_first
}, {
    "type" : "address-range",
    "list" : objects_list_range_first
  }]
}

data_for_batch_second  = {
  "objects" : [ {
    "type" : "host",
    "list" : objects_list_ip_second
}, {
    "type" : "address-range",
    "list" : objects_list_range_second
  }]
}

with APIClient(client_args) as client: 
     login = client.login_with_api_key('3TsbPJ8ZKjaJGvFyoFqHFA==') 
     set_objects_batch_first = client.api_call("set-objects-batch", data_for_batch_first)
     set_objects_batch_second = client.api_call("set-objects-batch", data_for_batch_second)
     publish = client.api_call("publish")

तपाईं एक API कल प्रयोग गरेर धेरै वस्तुहरू मेटाउन सक्नुहुन्छ मेटाउने-वस्तुहरू-बैच। अब एक कोड उदाहरण हेरौं जसले पहिले मार्फत सिर्जना गरिएका सबै होस्टहरू मेटाउँछ add-objects-batch.

Delete-objects-batch प्रयोग गरेर वस्तुहरू मेटाउँदै

from cpapi import APIClient, APIClientArgs

client_args = APIClientArgs(server="192.168.47.240")

objects_list_ip = []
objects_list_range = []

for ip in range(5,255,5):
    data = {"name": f'h_192.168.0.{ip}'}
    objects_list_ip.append(data)

first_ip = 1
last_ip = 4
while last_ip < 255:
    data = {"name": f"r_192.168.0.{first_ip}-{last_ip}"}
    objects_list_range.append(data)
    first_ip+=5
    last_ip+=5

data_for_batch = {
  "objects" : [ {
    "type" : "host",
    "list" : objects_list_ip
}, {
    "type" : "address-range",
    "list" : objects_list_range
  }]
}

with APIClient(client_args) as client: 
     login = client.login_with_api_key('3TsbPJ8ZKjaJGvFyoFqHFA==')
     delete_objects_batch = client.api_call("delete-objects-batch", data_for_batch)
     publish = client.api_call("publish")

print(delete_objects_batch.data)

चेक प्वाइन्ट सफ्टवेयरको नयाँ रिलीजहरूमा देखा पर्ने सबै प्रकार्यहरूले तुरुन्तै API कलहरू प्राप्त गर्दछ। यसरी, R80.40 मा रिभर्ट टु रिभिजन र स्मार्ट टास्क जस्ता "सुविधाहरू" देखा पर्यो, र सम्बन्धित API कलहरू तुरुन्तै तिनीहरूका लागि तयार भए। यसबाहेक, लिगेसी कन्सोलबाट एकीकृत नीति मोडमा सर्दा सबै प्रकार्यताले पनि API समर्थन प्राप्त गर्दछ। उदाहरणका लागि, सफ्टवेयर संस्करण R80.40 मा लामो-प्रतीक्षित अपडेट लेगेसी मोडबाट एकीकृत नीति मोडमा HTTPS निरीक्षण नीतिको सारिएको थियो, र यो कार्यक्षमताले तुरुन्तै API कलहरू प्राप्त गर्यो। यहाँ कोडको एउटा उदाहरण छ जसले HTTPS निरीक्षण नीतिको शीर्ष स्थानमा नियम थप्छ जसले निरीक्षणबाट 3 कोटिहरू समावेश गर्दछ (स्वास्थ्य, वित्त, सरकारी सेवाहरू), जुन धेरै देशहरूमा कानून अनुसार निरीक्षण गर्न निषेध गरिएको छ।

HTTPS निरीक्षण नीतिमा नियम थप्नुहोस्

from cpapi import APIClient, APIClientArgs

client_args = APIClientArgs(server="192.168.47.240")

data = {
  "layer" : "Default Layer",
  "position" : "top",
  "name" : "Legal Requirements",
  "action": "bypass",
  "site-category": ["Health", "Government / Military", "Financial Services"]
}

with APIClient(client_args) as client: 
     login = client.login_with_api_key('3TsbPJ8ZKjaJGvFyoFqHFA==')
     add_https_rule = client.api_call("add-https-rule", data)
     publish = client.api_call("publish")

चेक पोइन्ट व्यवस्थापन सर्भरमा पाइथन स्क्रिप्टहरू चलाउँदै

सबै उस्तै छ README.md नियन्त्रण सर्भरबाट सिधै पाइथन स्क्रिप्टहरू कसरी चलाउने भन्ने बारे जानकारी समावेश गर्दछ। तपाईं अर्को मेसिनबाट API सर्भरमा जडान गर्न असमर्थ हुँदा यो सुविधाजनक हुन सक्छ। मैले छ मिनेटको भिडियो रेकर्ड गरें जसमा म मोड्युल स्थापना गरिरहेको देख्छु cpapi र नियन्त्रण सर्भरमा पाइथन स्क्रिप्टहरू चलाउने सुविधाहरू। उदाहरणको रूपमा, एउटा स्क्रिप्ट चलाइएको छ जसले नेटवर्क अडिटिङ जस्ता कार्यका लागि नयाँ गेटवेको कन्फिगरेसनलाई स्वचालित बनाउँछ। सुरक्षा जाँच। मैले सामना गर्नु पर्ने सुविधाहरू मध्ये: प्रकार्य अझै पाइजोन 2.7 मा देखा परेको छैन इनपुट, त्यसैले प्रयोगकर्ताले प्रविष्ट गरेको जानकारीलाई प्रशोधन गर्न, एउटा प्रकार्य प्रयोग गरिन्छ raw_input। अन्यथा, कोड अन्य मेशिनहरूबाट सुरु गर्नको लागि उस्तै छ, केवल यो प्रकार्य प्रयोग गर्न अधिक सुविधाजनक छ। login_as_root, ताकि तपाइँको आफ्नै प्रयोगकर्ता नाम, पासवर्ड र व्यवस्थापन सर्भरको IP ठेगाना पुन: निर्दिष्ट नगर्नुहोस्।

सुरक्षा जाँचको द्रुत सेटअपको लागि लिपि

from __future__ import print_function
import getpass
import sys, os
sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
from cpapi import APIClient, APIClientArgs

def main():
    with APIClient() as client:
       # if client.check_fingerprint() is False:
       #     print("Could not get the server's fingerprint - Check connectivity with the server.")
       #     exit(1)
        login_res = client.login_as_root()

        if login_res.success is False:
            print("Login failed:n{}".format(login_res.error_message))
            exit(1)

        gw_name = raw_input("Enter the gateway name:")
        gw_ip = raw_input("Enter the gateway IP address:")
        if sys.stdin.isatty():
            sic = getpass.getpass("Enter one-time password for the gateway(SIC): ")
        else:
            print("Attention! Your password will be shown on the screen!")
            sic = raw_input("Enter one-time password for the gateway(SIC): ")
        version = raw_input("Enter the gateway version(like RXX.YY):")
        add_gw = client.api_call("add-simple-gateway", {'name' : gw_name, 'ipv4-address' : gw_ip, 'one-time-password' : sic, 'version': version.capitalize(), 'application-control' : 'true', 'url-filtering' : 'true', 'ips' : 'true', 'anti-bot' : 'true', 'anti-virus' : 'true', 'threat-emulation' : 'true'})
        if add_gw.success and add_gw.data['sic-state'] != "communicating":
            print("Secure connection with the gateway hasn't established!")
            exit(1)
        elif add_gw.success:
            print("The gateway was added successfully.")
            gw_uid = add_gw.data['uid']
            gw_name = add_gw.data['name']
        else:
            print("Failed to add the gateway - {}".format(add_gw.error_message))
            exit(1)

        change_policy = client.api_call("set-access-layer", {"name" : "Network", "applications-and-url-filtering": "true", "content-awareness": "true"})
        if change_policy.success:
            print("The policy has been changed successfully")
        else:
            print("Failed to change the policy- {}".format(change_policy.error_message))
        change_rule = client.api_call("set-access-rule", {"name" : "Cleanup rule", "layer" : "Network", "action": "Accept", "track": {"type": "Detailed Log", "accounting": "true"}})
        if change_rule.success:
            print("The cleanup rule has been changed successfully")
        else:
            print("Failed to change the cleanup rule- {}".format(change_rule.error_message))

        # publish the result
        publish_res = client.api_call("publish", {})
        if publish_res.success:
            print("The changes were published successfully.")
        else:
                print("Failed to publish the changes - {}".format(install_tp_policy.error_message))

        install_access_policy = client.api_call("install-policy", {"policy-package" : "Standard", "access" : 'true',  "threat-prevention" : 'false', "targets" : gw_uid})
        if install_access_policy.success:
            print("The access policy has been installed")
        else:
                print("Failed to install access policy - {}".format(install_tp_policy.error_message))

        install_tp_policy = client.api_call("install-policy", {"policy-package" : "Standard", "access" : 'false',  "threat-prevention" : 'true', "targets" : gw_uid})
        if install_tp_policy.success:
            print("The threat prevention policy has been installed")
        else:
            print("Failed to install threat prevention policy - {}".format(install_tp_policy.error_message))
        
        # add passwords and passphrases to dictionary
        with open('additional_pass.conf') as f:
            line_num = 0
            for line in f:
                line_num += 1
                add_password_dictionary = client.api_call("run-script", {"script-name" : "Add passwords and passphrases", "script" : "printf "{}" >> $FWDIR/conf/additional_pass.conf".format(line), "targets" : gw_name})
                if add_password_dictionary.success:
                    print("The password dictionary line {} was added successfully".format(line_num))
                else:
                    print("Failed to add the dictionary - {}".format(add_password_dictionary.error_message))

main()

अतिरिक्त_pass.conf पासवर्ड शब्दकोशको साथ एउटा उदाहरण फाइल
{
"passwords" : ["malware","malicious","infected","Infected"],
"phrases" : ["password","Password","Pass","pass","codigo","key","pwd","пароль","Пароль","Ключ","ключ","шифр","Шифр"] }

निष्कर्षमा

यस लेखले कामको आधारभूत सम्भावनाहरू मात्र जाँच गर्दछ पाइथन एसडीके र मोड्युल cpapi(तपाईंले अनुमान गर्नुभएको हुन सक्छ, यी वास्तवमा समानार्थी शब्दहरू हुन्), र यस मोड्युलमा कोड अध्ययन गरेर तपाईंले यसमा काम गर्ने थप अवसरहरू पत्ता लगाउनुहुनेछ। यो सम्भव छ कि तपाइँ यसलाई तपाइँको आफ्नै कक्षाहरु, प्रकार्यहरु, विधिहरु र चरहरु संग पूरक गर्न चाहानुहुन्छ। तपाईले सधैं आफ्नो काम साझा गर्न सक्नुहुन्छ र सेक्सनमा चेक पोइन्टको लागि अन्य स्क्रिप्टहरू हेर्न सक्नुहुन्छ CodeHub समुदायमा चेकमेट्स, जसले उत्पादन विकासकर्ता र प्रयोगकर्ता दुवैलाई सँगै ल्याउँछ।

खुशी कोडिङ र अन्त सम्म पढ्न को लागी धन्यवाद!

स्रोत: www.habr.com