Riadenie a podávanie správ

Cloud CNM SecuReporter

Zyxel SecuReporter OpenAPI

Nájdite zdroje, ktoré vám pomôžu automatizovať a rýchlo vytvárať vlastné aplikácie s API pre platformu Zyxel SecuReporter.

Prístup k údajom zariadenia pomocou služby SecuReporter OpenAPI

SecuReporter podporuje rozhranie pre softvér na priamu interakciu s cloudovou platformou SecuReporter.
Tieto rozhrania API umožňujú používateľom aplikácie SecuReporter načítať protokoly zariadení za posledných 31 dní pomocou tokenu API.

Pomocou rozhrania SecuReporter OpenAPI môžete jednoducho pristupovať k údajom zariadenia prostredníctvom požiadaviek HTTP s použitím ľubovoľného programovacieho jazyka alebo príkazov cURL. Ak chcete využívať túto službu, uistite sa, že vaše zariadenie má platnú licenciu SecuReporter a token OpenAPI. Tieto poverenia sú potrebné na overenie a autorizáciu vašich požiadaviek na API.

Objavte hlavné výhody tokenu OpenAPI spoločnosti SecuReporter

Zefektívnite svoje pracovné postupy, zvýšte škálovateľnosť a umožnite bezproblémovú automatizáciu. Vyskúšajte bezpečnú, efektívnu a používateľsky prívetivú metódu prístupu k súborom protokolov firewallu, ktorá je navrhnutá na podporu manuálnych aj automatizovaných procesov.

Pohodlie a efektivita

Pristupujte k protokolom firewallu priamo prostredníctvom požiadaviek HTTP pomocou ľubovoľného programovacieho jazyka alebo príkazov cURL - nie je potrebné prihlásenie na portál. To zefektívňuje váš pracovný postup, šetrí čas a je ideálne pre automatizované systémy alebo skripty vyžadujúce pravidelné načítanie protokolov.

Škálovateľnosť

Tokeny OpenAPI umožňujú škálovateľný prístup k protokolom firewallu. Generujte viacero tokenov pre rôznych používateľov alebo systémy, čím zabezpečíte flexibilitu a kontrolu.

Možnosť automatizácie

Bezproblémová integrácia s inými systémami a softvérom pomocou tokenov API. Automatizujte načítanie protokolov brány firewall a začleňte tieto údaje do systémov správy bezpečnostných informácií a udalostí (SIEM) bez manuálneho zásahu.

Prečo integrovať token OpenAPI spoločnosti SecuReporter?

SecuReporter poskytuje bezpečný, efektívny a používateľsky prívetivý spôsob prístupu k súborom protokolov firewallu. Podporuje manuálne aj automatizované procesy pri zachovaní vysokých bezpečnostných štandardov. Podrobnejšie informácie o integrácii SecuReporter OpenAPI a ďalšie informácie nájdete na našom GitHube.

Zyxel GitHub

Často kladené otázky k bezproblémovej integrácii

Nemajte obavy, máme pre vás riešenie! Kým budete skúmať, ako integrovať OpenAPI so SecuReporter, tu je niekoľko užitočných tipov a často kladených otázok, ktoré vás prevedú celým procesom.

Služba Archived Logs Service je úvodná otvorená služba, ktorú ponúka SecuReporter OpenAPI. Umožňuje používateľom načítať protokoly firewallu spred 31 dní pomocou tokenu API. Každý token API poskytuje maximálne 50 požiadaviek API za hodinu. Zostaňte naladení na ďalšie služby, ktoré sa majú v budúcnosti uvoľniť.

Prepošlite ticket/e-mail s prípadom miestnemu predajcovi alebo obchodnému inžinierovi spoločnosti Zyxel, aby overil vašu požiadavku na funkciu z hľadiska jej vplyvu

Predpoklady:

Uistite sa, že vaše zariadenie firewall má aktívnu licenciu SecuReporter a že služba SecuReporter je povolená. Ak platnosť vašej licencie vypršala, obráťte sa na vlastníka zariadenia alebo si zakúpte novú licenciu na trhu spoločnosti Zyxel, aby ste mali prístup k službe OpenAPI.

Kroky na generovanie tokenu OpenAPI v službe SecuReporter:

Krok 1: Vyberte zariadenie s platnou licenciou SecuReporter a kliknite na tlačidlo "API Access".

Krok 2: Kliknite na tlačidlo "Vytvoriť nový token API".

Krok 3: Skopírujte token OpenAPI.

Na testovanie OpenAPI sú k dispozícii dve metódy: cURL a Python.

[1] Testovanie pomocou cURL

  • Nastavenie: V prípade, že je potrebné nastaviť funkciu CURL, môžete ju nastaviť tak, aby bola v súlade so štandardom CURL: Ak chcete skontrolovať, či je cURL nainštalovaný, otvorte Príkazový riadok alebo Terminál a zadajte curl. Ak sa zobrazí chyba, že cURL sa nenašiel, postupujte podľa pokynov na inštaláciu, ktoré sú k dispozícii na úložisku cURL GitHub.
  • Vytvorenie prvej požiadavky OpenAPI: Otvorte si Príkazový riadok/Terminál a použite nasledujúci príkaz. Nahraďte yyyy-MM-dd dátumom za posledných 31 dní (okrem aktuálneho dátumu) vo formáte yyyy-mm-dd. mydir aktuálnou cestou k priečinku na stiahnutie vo vašom počítači.

macOS

curl -X POST \

https://secureporter.cloudcnm.zyxel.com/open-api/v1/archive-logs/download \

-H "Content-Type: application/json" \

-H "X-Authorization: Bearer $OPEN_API_TOKEN" \

-d "{\"device_date\":\"yyyy-MM-dd\"}" \

-o mydir/archive.tar

Windows

curl -X POST ^

https://secureporter.cloudcnm.zyxel.com/open-api/v1/archive-logs/download ^

-H "Content-Type: application/json" ^

-H "X-Authorization: Bearer %OPEN_API_TOKEN%" ^

-d "{\"device_date\":\"yyyy-MM-dd\"}" ^

-o mydir\archive.tar

Nahraďte "https://api.example.com/endpoint" skutočným koncovým bodom API a "your_api_token" svojím tokenom API.

[2] Testovanie pomocou jazyka Python

  • Overte inštaláciu Pythonu: Ak chcete skontrolovať, či je nainštalovaný Python, otvorte príkazový riadok alebo terminál a zadajte príkaz 'python'. Ak sa zobrazí chybové hlásenie, že Python nebol nájdený, môžete ho nainštalovať podľa pokynov dostupných na oficiálnej webovej lokalite Python. Uistite sa, že máte nainštalovaný Python 3.8 alebo novší, aby ste mohli používať knižnicu Requests.
  • Vytvorte a aktivujte virtuálne prostredie:
    Vytvorte adresár projektu a virtuálne prostredie: Pri vytváraní virtuálneho prostredia v adresári projektu postupujte podľa oficiálnej dokumentácie Python venv.

MacOS

source your-virtual-environment-path/bin/activate

Windows

your-virtual-environment-path\Scripts\activate

Nahraďte your-virtual-environment-path skutočnou cestou k adresáru vášho virtuálneho prostredia.

Každá lokalita môže vygenerovať jeden token API, ktorý môže využívať viacero systémov alebo softvérových aplikácií. Pre každý token API však platí obmedzenie používania na 50 požiadaviek za hodinu.