Sav potencijal interakcije s API-jem otkriva se u kombinaciji s programske kodom, kada se pojavljuju mogućnosti dinamičkog formiranja API zahtjeva i alata za analizu API odgovora. Međutim, još uvijek ostaje nedovoljno primjećeno Python razvojni paket (dalje — Python SDK) za Check Point Management API, što je šteta. Značajno olakšava život programerima i ljubiteljima automatizacije. Python je nedavno stekao ogromnu popularnost, pa sam odlučio eliminirati prazninu i napraviti pregled osnovnih mogućnosti . Ovaj članak služi kao odličan dodatak drugom članku na Habr . Razmotrit ćemo kako napisati skripte koristeći Python SDK i posebno ćemo se osvrnuti na nove funkcionalnosti Management API-ja u verziji 1.6 (podržava se od R80.40). Za razumijevanje članka potrebna su osnovna znanja o radu s API-jem i Python-om.
Check Point aktivno razvija API i trenutno su dostupni:
- — rad s upravljačkim serverom putem API-ja (i mogućnost izvršavanja skripti na prolazima pod upravljanjem upravljačkog servera)
- — rad s sigurnosnim prolazima
- — rad s sandboxom u oblaku Check Point
- — rad s Identity Awareness blade-om na prolazima
- — rad s portalom upravljanja SMB prolazima ()
- — interakcija s IoT kontrolerima
- — rad s (rješenje za sigurnost SD-WAN)
- — rad s
Python SDK trenutno podržava interakciju samo s Management API i Gaia API. Razmotrit ćemo najvažnije klase, metode i varijable u ovom modu.

Instalacija modula
Modul cpapi brzo se i jednostavno instalira iz pomoću pip. Detaljne upute za instalaciju nalaze se u . Ovaj modul je prilagođen za rad s verzijama Python 2.7 i 3.7. U ovom članku primjeri će biti navedeni s korištenjem Python 3.7. Međutim, Python SDK može se pokrenuti direktno sa Check Point upravljačkog servera (Smart Management), ali na njima se podržava samo verzija Python 2.7, stoga će u posljednjem dijelu biti dani kodovi za verziju 2.7. Odmah nakon instalacije modula preporučujem pogledati primjere u direktorijima examples_python2 i examples_python3.
Početak rada
Kako bismo mogli raditi s komponentama modula cpapi, potrebno je uvesti iz modula cpapi najmanje dva potrebna klasa:
APIClient i APIClientArgs
from cpapi import APIClient, APIClientArgs
Klasa APIClientArgs odgovara za parametre veze s API poslužiteljem, a klasa APIClient odgovara za interakciju s API-jem.
Definiramo parametre veze
Da bismo definirali različite parametre veze s API-jem, potrebno je stvoriti instancu klase APIClientArgs. U načelnosti, njezini parametri su unaprijed definirani i pri pokretanju skripte na upravljačkom poslužitelju ne moraju se navoditi.
client_args = APIClientArgs()No pri pokretanju na trećem hostu potrebno je navesti najmanje IP adresu ili naziv hosta API poslužitelja (to jest, upravljačkog poslužitelja). U donjem primjeru definiramo parametar veze server i dodjeljujemo mu IP adresu upravljačkog poslužitelja kao string.
client_args = APIClientArgs(server='192.168.47.241')Pogledajmo sve parametre i njihova unaprijed postavljena vrijednosti koje se mogu koristiti za povezivanje s API poslužiteljem:
Argumenti metode __init__ klase APIClientArgs
class APIClientArgs:
"""
Ova klasa pruža argumente za konfiguraciju APIClient-a.
Svi argumenti su konfigurirani s njihovim zadanim vrijednostima.
"""
# port je zadano postavljen na None, ali se zamjenjuje s 443 ako nije specificiran
# mogući kontekst - web_api (zadano) ili 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
# otisak upravljačkog poslužitelja
self.fingerprint = fingerprint
# session-id.
self.sid = sid
# ime ili IP-adresa upravljačkog poslužitelja
self.server = server
# razina debagiranja
self.http_debug_level = http_debug_level
# niz sa svim API pozivima (za debagiranje)
self.api_calls = api_calls if api_calls else []
# naziv debag datoteke. Ako ostavite prazno, podaci o debagiranju neće se spremiti na disk.
self.debug_file = debug_file
# adresa HTTP proxy poslužitelja (bez "http://")
self.proxy_host = proxy_host
# HTTP proxy port
self.proxy_port = proxy_port
# verzija API-ja upravljačkog poslužitelja
self.api_version = api_version
# Označava da klijent ne bi trebao provjeravati certifikat poslužitelja
self.unsafe = unsafe
# Označava da klijent automatski prihvaća i sprema certifikat poslužitelja
self.unsafe_auto_accept = unsafe_auto_accept
# Kontekst korištenja klijenta - zadano je web_api
self.context = contextPretpostavljam da su argumenti koji se mogu koristiti u instancama klase APIClientArgs intuitivno jasni administratorima Check Point-a i ne trebaju dodatne komentare.
Povezujemo se putem APIClient te upravljača kontekstom
Klasa APIClient najlakše je koristiti putem upravljača kontekstom. Sve što treba prenijeti instanci klase APIClient su parametri veze koje smo definirali u prethodnom koraku.
with APIClient(client_args) as client:
Upravitelj konteksta neće automatski izvršiti login poziv na API server, no izvršit će logout poziv prilikom izlaska. Ako je iz nekog razloga logout nakon korištenja API poziva nepotrebno, potrebno je započeti rad bez korištenja upravitelja konteksta:
client = APIClient(client_args)Provjera veze
Najlakše je provjeriti prolazi li veza prema zadanom parametrima pomoću metode check_fingerprint. Ako provjera hash-sume sha1 za fingerprint certifikata API servera ne prođe (metoda vrati False), to je obično uzrokovano problemima s vezom i možemo prekinuti izvršavanje programa (ili omogućiti korisniku da ispravi podatke za povezivanje):
if client.check_fingerprint() is False:
print("Nije moguće dobiti fingerprint servera - Provjerite povezivanje sa serverom.")
exit(1)
Imajte na umu da će u budućnosti klasa APIClient provjeravati pri svakom API pozivu (metode api_call i api_query, o kojima će se raspravljati malo kasnije) sha1 fingerprint certifikata na API serveru. Ako se prilikom provjere sha1 fingerprint certifikata API servera otkrije greška (certifikat je nepoznat ili je izmijenjen), metoda check_fingerprint omogućit će dodavanje/izmjenu informacija o njemu na lokalnoj mašini automatski. Ovu provjeru može se potpuno isključiti (ali to se može preporučiti samo u slučaju pokretanja skripti na samom API serveru, pri povezivanju na 127.0.0.1), koristeći argument APIClientArgs — unsafe_auto_accept (vidi više o APIClientArgs ranije u "Definiranje parametara povezanosti").
client_args = APIClientArgs(unsafe_auto_accept=True)Login na API server
U APIClient postoji ukupno 3 metode za login na API server, i svaka od njih pohranjuje vrijednost sid(session-id), koju automatski koristi u svakom sljedećem API pozivu u zaglavlju (ime ovog parametra u zaglavlju — X-chkp-sid), tako da nije potrebno dodatno obraditi ovaj parametar.
Metoda login
Varijanta s korištenjem korisničkog imena i lozinke (u primjeru su korisničko ime admin i lozinka 1q2w3e proslijeđeni kao pozicijski argumenti):
login = client.login('admin', '1q2w3e') U metodi login također su dostupni dodatni opcijski parametri, navodim njihova imena i zadane vrijednosti:
continue_last_session=False, domain=None, read_only=False, payload=NoneMetoda login_with_api_key
Varijanta s korištenjem api ključa (podržava se od verzije menadžmenta R80.40/Management API v1.6, «3TsbPJ8ZKjaJGvFyoFqHFA==» ovo je vrijednost API ključa za jednog od korisnika na upravljačkom serveru s metodom autorizacije API ključa:
login = client.login_with_api_key('3TsbPJ8ZKjaJGvFyoFqHFA==') U metodi login_with_api_key dostupni su isti opcionalni parametri kao i u metodi login.
Metoda login_as_root
Mogućnost loginanja na lokalnu mašinu s API serverom:
login = client.login_as_root()Za ovu metodu dostupna su samo dva opcionalna parametra:
domain=None, payload=NoneI konačno, sami API pozivi
Imamo dvije mogućnosti za izvođenje API poziva kroz metode api_call i api_query. Razjasnimo razliku između njih.
api_call
Ova metoda je primjenjiva za sve pozive. Moramo proslijediti zadnji dio za api poziv i payload u tijelu zahtjeva ako je potrebno. Ako je payload prazan, ne treba ga uopće proslijediti:
api_versions = client.api_call('show-api-versions') Izlaz za ovaj zahtjev ispod:
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'})Izlaz za ovaj zahtjev ispod:
U [25]: show_host
Izlaz[25]:
APIResponse({
"data": {
"color": "crna",
"comments": "",
"domain": {
"domain-type": "domena",
"name": "SMC Korisnik",
"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": "otključano",
"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": "crna",
"comments": "",
"domain": {
"domain-type": "domena",
"name": "SMC Korisnik",
"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": "otključano",
"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
Odmah da napomenem da je ova metoda primjenjiva samo za pozive čiji su izlazi predviđeni s offset (pomak). Takav izlaz nastaje kada sadrži ili može sadržavati veliku količinu informacija. Na primjer, to može biti upit popisa svih stvorenih objekata tipa host na upravljačkom poslužitelju. Za takve upite API vraća popis od 50 objekata prema zadanim postavkama (možete povećati limit do 500 objekata u odgovoru). I kako ne biste više puta dohvaćali informacije mijenjajući offset parametar u API upitu, postoji metoda api_query koja tu zadaću obavlja automatski. Primjeri poziva gdje je potrebna ova metoda: show-sessions, show-hosts, show-networks, show-wildcards, show-groups, show-address-ranges, show-simple-gateways, show-simple-clusters, show-access-roles, show-trusted-clients, show-packages. U stvari, u nazivima ovih API poziva vidimo riječi u množini, pa će se s tim pozivima lakše rukovati preko api_query
show_hosts = client.api_query('show-hosts') Izlaz za ovaj zahtjev ispod:
U [21]: show_hosts
Izlaz[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
})
Obrada rezultata API poziva
Nakon ovoga možete koristiti varijable i metode klase APIResponse(kako unutar menadžera konteksta, tako i izvan njega). Klasa APIResponse ima definirana 4 metode i 5 varijabli, na najvažnijima ćemo se zadržati detaljnije.

success
Za početak, bilo bi dobro osigurati da je API poziv uspio i vratio rezultat. Za to postoji metoda success:
U [49]: api_versions.success
Izlaz[49]: True
Vraća True ako je API poziv uspio (kod odgovora — 200) i False ako nije uspio (bilo koji drugi kod odgovora). Praktično je koristiti odmah nakon API poziva, kako bi se na temelju koda odgovora prikazale različite informacije.
if api_ver.success:
print(api_versions.data)
else:
print(api_versions.err_message) statuscode
Vraća kod odgovora nakon izvršenja API poziva.
U [62]: api_versions.status_code
Izlaz[62]: 400
Mogući kodovi odgovora: 200,400,401,403,404,409,500,501.
set_success_status
U ovom slučaju može biti potrebno promijeniti status na success. Tehnički, možete staviti bilo što, čak i običnu string. Stvarni primjer može biti resetiranje ovog parametra na False pod određenim uvjetima. Ispod je primjer kada postoje zadaci koji se izvršavaju na upravljačkom poslužitelju, ali ćemo smatrati da je ovaj zahtjev propao (postaviti varijablu success na False, iako je API poziv bio uspješan i vratio kod 200).
for task in task_result.data["tasks"]:
if task["status"] == "failed" or task["status"] == "partially succeeded":
task_result.set_success_status(False)
breakresponse()
Metoda response omogućuje pregled rječnika s kodom odgovora (status_code) i tijelom odgovora (body).
U [94]: api_versions.response()
Izlaz[94]:
{'status_code': 200,
'data': {'current-version': '1.6',
'supported-versions': ['1', '1.1', '1.2', '1.3', '1.4', '1.5', '1.6']}}
data
Omogućuje prikaz samo tijela odgovora (body) bez suvišnih informacija.
U [93]: api_versions.data
Izlaz[93]:
{'current-version': '1.6',
'supported-versions': ['1', '1.1', '1.2', '1.3', '1.4', '1.5', '1.6']}
error_message
Ove informacije su dostupne samo kada je došlo do pogreške prilikom obrade API zahtjeva (status kod ne 200). Primjer izlaza
U [107]: api_versions.error_message
Izlaz[107]: 'code: generic_err_invalid_parameter_nnamenmessage: Unrecognized parameter [1]n'
Korisni primjeri
Ispod su navedeni primjeri koji koriste API pozive koji su dodani u verziju Management API 1.6.
Za početak, razmotrite kako rade pozivi add-host i add-address-range. Pretpostavimo da trebamo stvoriti objekte tipa host za sve IP adrese podmreže 192.168.0.0/24, čiji je posljednji oktet 5, dok ćemo sve ostale IP adrese zapisati kao objekte tipa raspon adresa. Pri tome ćemo isključiti adresu podmreže i širokopojasnu adresu.
Dakle, ispod je skripta koja rješava ovaj zadatak i kreira 50 objekata tipa host i 51 objekt tipa raspon adresa. Za rješavanje zadatka potrebno je 101 API poziv (ne računajući završni poziv publish). Također, uz pomoć modula timeit mjerimo vrijeme izvršenja skripte do trenutka objave promjena.
Skripta s korištenjem add-host i 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')
U svom laboratorijskom okruženju, izvršenje ovog skripta traje od 30 do 50 sekundi, ovisno o opterećenju poslužitelja za upravljanje.
Sada ćemo vidjeti kako riješiti isti problem pomoću API poziva add-objects-batch, čija podrška je dodana u verziji API-ja 1.6. Ovaj poziv omogućuje stvaranje više objekata u jednom API zahtjevu. To mogu biti objekti različitih tipova (na primjer, hotele, podmreže i rasponi adresa). Tako možemo riješiti naš problem u okviru jednog API poziva.
Skripta s upotrebom 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')
Izvršenje ovog skripta u mom laboratorijskom okruženju traje od 3 do 7 sekundi, ovisno o opterećenju poslužitelja za upravljanje. Dakle, u prosjeku, za 101 objekt, API poziv tipa batch traje 10 puta brže. Sa većim brojem objekata razlika će biti još impresivnija.
Sada pogledajmo kako raditi s set-objects-batch. Ovim API pozivom možemo masovno promijeniti bilo koju svojstvo. Uzmimo da prvoj polovini adresa iz prethodnog primjera (do .124 hosta, uključujući i raspon) postavimo boju sienna, a drugoj polovini adresa postavimo boju khaki.
Promjena boje objekata stvorenih u prethodnom primjeru
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")
Mnogi objekti se mogu izbrisati u jednom API pozivu pomoću delete-objects-batch. Sada ćemo pogledati primjer koda koji uklanja sve hostove kreirane ranije putem add-objects-batch.
Brisanje objekata pomoću 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)
Sve funkcije koje se pojavljuju u novim verzijama softvera Check Point odmah dobijaju API pozive. Tako su u R80.40 dodane 'funkcije' kao što su Revert to revision i Smart Task, a za njih su odmah pripremljeni odgovarajući API pozivi. Štaviše, cela funkcionalnost prilikom prelaska iz Legacy konzola u režim Unified Policy takođe dobija podršku za API. Na primer, dugo očekivano ažuriranje u verziji softvera R80.40 bila je migracija politike HTTPS Inspekcije iz Legacy režima u režim Unified Policy, a ova funkcionalnost odmah je dobila API pozive. Evo primera koda koji dodaje na vrh politike HTTPS Inspekcije pravilo koje isključuje iz inspekcije 3 kategorije (Zdravstvo, Finansije, Državne usluge), koje je zabranjeno inspektirati prema zakonodavstvu u nekim zemljama.
Dodaj pravilo u politiku HTTPS Inspekcije
from cpapi import APIClient, APIClientArgs
client_args = APIClientArgs(server="192.168.47.240")
data = {
"layer" : "Default Layer",
"position" : "top",
"name" : "Pravni zahtevi",
"action": "bypass",
"site-category": ["Zdravstvo", "Vlada / Vojska", "Finansijske usluge"]
}
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")
Pokretanje Python skripti na upravljačkom serveru Check Point
Sve u istom sadrži informacije o tome kako pokretati skripte na Pythonu direktno sa upravljačkog servera. Ovo može biti zgodno kada nemate mogućnost povezivanja na API server sa druge mašine. Snimio sam šestominutni video u kojem objašnjavam instalaciju modula cpapi i osobitosti pokretanja Python skripti na upravljačkom serveru. Kao primer se pokreće skripta koja automatizuje konfiguraciju novog prolaza za zadatak kao što je audit mreže Security CheckUp. Od osobitosti s kojima sam se suočio: u verziji Python 2.7 još nije uvedena funkcija input, stoga se za obradu informacija koje unosi korisnik koristi funkcija raw_input. U ostalom, kod je isti kao za pokretanje s drugih mašina, samo je praktičnije koristiti funkciju login_as_root, kako ne biste ponovo unosili svoje korisničko ime, lozinku i IP adresu upravljačkog servera.

Skripta za brzu konfiguraciju Security CheckUp
iz __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("Nije moguće dobiti otisak poslužitelja - Provjerite povezanost s poslužiteljem.")
# exit(1)
login_res = client.login_as_root()
if login_res.success is False:
print("Prijava nije uspjela:n{}".format(login_res.error_message))
exit(1)
gw_name = input("Unesite ime gateway-a:")
gw_ip = input("Unesite IP adresu gateway-a:")
if sys.stdin.isatty():
sic = getpass.getpass("Unesite jednokratnu lozinku za gateway (SIC): ")
else:
print("Pozor! Vaša lozinka će biti prikazana na ekranu!")
sic = input("Unesite jednokratnu lozinku za gateway (SIC): ")
version = input("Unesite verziju gateway-a (poput 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("Sigurna veza s gateway-em nije uspostavljena!")
exit(1)
elif add_gw.success:
print("Gateway je uspješno dodan.")
gw_uid = add_gw.data['uid']
gw_name = add_gw.data['name']
else:
print("Neuspješno dodavanje gateway-a - {}".format(add_gw.error_message))
exit(1)
change_policy = client.api_call("set-access-layer", {"name" : "Mreža", "applications-and-url-filtering": "true", "content-awareness": "true"})
if change_policy.success:
print("Politika je uspješno promijenjena")
else:
print("Neuspješna promjena politike - {}".format(change_policy.error_message))
change_rule = client.api_call("set-access-rule", {"name" : "Pravilo čišćenja", "layer" : "Mreža", "action": "Prihvati", "track": {"type": "Detaljan dnevnik", "accounting": "true"}})
if change_rule.success:
print("Pravilo čišćenja je uspješno promijenjeno")
else:
print("Neuspješna promjena pravila čišćenja - {}".format(change_rule.error_message))
# objavi rezultat
publish_res = client.api_call("publish", {})
if publish_res.success:
print("Promjene su uspješno objavljene.")
else:
print("Neuspješno objavljivanje promjena - {}".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("Pristupna politika je instalirana")
else:
print("Neuspješna instalacija pristupne politike - {}".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("Politika prevencije prijetnji je instalirana")
else:
print("Neuspješna instalacija politike prevencije prijetnji - {}".format(install_tp_policy.error_message))
# dodajte lozinke i fraze u rječnik
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" : "Dodaj lozinke i fraze", "script" : "printf "{}" >> $FWDIR/conf/additional_pass.conf".format(line), "targets" : gw_name})
if add_password_dictionary.success:
print("Redak rječnika lozinki {} je uspješno dodan".format(line_num))
else:
print("Neuspješno dodavanje rječnika - {}".format(add_password_dictionary.error_message))
main() Primjer datoteke sa rječnikom lozinki additional_pass.conf
{
"passwords" : ["malware","malicious","infected","Infected"],
"phrases" : ["password","Password","Pass","pass","codigo","key","pwd","lozinka","Lozinka","ključ","ključi","šifriranje","Šifriranje"]
}
Zaključak
Ovaj članak razmatra samo osnovne mogućnosti rada Python SDK i modula cpapi(kako ste mogli pogoditi, to su zapravo sinonimi), a proučavanjem koda u ovom modulu otkrit ćete još više mogućnosti u radu s njime. Nije isključeno da će vam se pojaviti želja da ga dopunite svojim klasama, funkcijama, metodama i varijablama. Uvijek možete dijeliti svoje radove i pregledavati druge skripte za Check Point u odjeljku u zajednici , koja okuplja kako programere proizvoda tako i korisnike.
Sretno kodiranje i hvala što ste pročitali do kraja!
Izvor: habr.com
