Řízení a podávání zpráv

Cloud CNM SecuReporter

Zyxel SecuReporter OpenAPI

Najděte zdroje, které vám pomohou automatizovat a rychle vytvářet vlastní aplikace pomocí rozhraní API pro platformu Zyxel SecuReporter.

Přístup k datům zařízení pomocí služby SecuReporter OpenAPI

SecuReporter podporuje rozhraní pro software, který může přímo komunikovat s cloudovou platformou SecuReporter.
Tato rozhraní API umožňují uživatelům služby SecuReporter načítat protokoly zařízení za posledních 31 dní pomocí tokenu API.

Pomocí rozhraní SecuReporter OpenAPI můžete snadno přistupovat k datům zařízení prostřednictvím požadavků HTTP s využitím libovolného programovacího jazyka nebo příkazů cURL. Chcete-li tuto službu využívat, ujistěte se, že vaše zařízení má platnou licenci SecuReporter a token OpenAPI. Tato pověření jsou nezbytná k ověření a autorizaci vašich požadavků na rozhraní API.

Objevte hlavní výhody tokenu OpenAPI společnosti SecuReporter

Zjednodušte své pracovní postupy, zvyšte škálovatelnost a umožněte bezproblémovou automatizaci. Vyzkoušejte bezpečný, efektivní a uživatelsky přívětivý způsob přístupu k souborům protokolů firewallu, který je navržen tak, aby podporoval manuální i automatizované procesy.

Pohodlí a efektivita

Přístup k protokolům brány firewall přímo prostřednictvím požadavků HTTP s využitím libovolného programovacího jazyka nebo příkazů cURL - není nutné přihlášení k portálu. To zjednodušuje pracovní postupy, šetří čas a je ideální pro automatizované systémy nebo skripty vyžadující pravidelné načítání protokolů.

Škálovatelnost

Tokeny OpenAPI umožňují škálovatelný přístup k protokolům brány firewall. Generujte více tokenů pro různé uživatele nebo systémy, čímž zajistíte flexibilitu a kontrolu.

Možnost automatizace

Bezproblémová integrace s jinými systémy a softwarem pomocí tokenů API. Automatizujte načítání protokolů brány firewall a začleňte tato data do systémů správy bezpečnostních informací a událostí (SIEM) bez nutnosti ručního zásahu.

Proč integrovat token OpenAPI společnosti SecuReporter?

SecuReporter poskytuje bezpečný, efektivní a uživatelsky přívětivý způsob přístupu k souborům protokolů firewallu. Podporuje manuální i automatizované procesy při zachování vysokých bezpečnostních standardů. Podrobnější informace o integraci SecuReporter OpenAPI a další informace naleznete na našem GitHubu.

Zyxel GitHub

Nejčastější dotazy k bezproblémové integraci

Nebojte se, máme pro vás řešení! Zatímco budete zkoumat, jak integrovat rozhraní OpenAPI se SecuReporter, zde je několik užitečných tipů a často kladených otázek, které vás provedou celým procesem.

Služba Archivované protokoly je úvodní otevřenou službou nabízenou rozhraním SecuReporter OpenAPI. Umožňuje uživatelům načítat protokoly firewallu datované až 31 dní zpětně pomocí tokenu API. Každý token API poskytuje maximálně 50 požadavků API za hodinu. Sledujte další služby, které budou v budoucnu uvolněny.

Přepošlete prosím ticket/e-mail o případu místnímu prodejci nebo prodejnímu technikovi společnosti Zyxel, aby ověřil váš požadavek na funkci z hlediska jeho dopadu.

Předpoklady:

Zkontrolujte, zda má vaše zařízení firewall aktivní licenci SecuReporter a zda je služba SecuReporter povolena. Pokud platnost licence vypršela, kontaktujte majitele zařízení nebo si zakupte novou licenci na trhu Zyxel, abyste měli přístup ke službě OpenAPI.

Kroky k vygenerování tokenu OpenAPI v aplikaci SecuReporter:

Krok 1: Vyberte zařízení s platnou licencí SecuReporter a klikněte na tlačítko "API Access".

Krok 2: Klikněte na tlačítko "Vytvořit nový API Token".

Krok 3: Zkopírujte OpenAPI Token.

Pro testování rozhraní OpenAPI jsou k dispozici dvě metody: cURL a Python.

[1] Testování pomocí cURL

  • Nastavení: V případě, že je v systému CURL nainstalována funkce CURL, je možné provést nastavení pomocí tzv: Chcete-li zkontrolovat, zda je cURL nainstalován, otevřete Příkazový řádek nebo Terminál a zadejte curl. Pokud se zobrazí chybové hlášení, že cURL nebyl nalezen, postupujte podle pokynů k instalaci, které jsou k dispozici v repozitáři cURL GitHub.
  • Provedení prvního požadavku na OpenAPI: Otevřete Příkazový řádek/Terminál a použijte následující příkaz. Nahraďte yyyy-MM-dd datem za posledních 31 dní (kromě aktuálního data) ve formátu yyyy-mm-dd. mydir aktuální cestou ke složce pro stahování ve vašem 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" skutečným koncovým bodem API a "your_api_token" svým tokenem API.

[2] Testování pomocí Pythonu

  • Ověřte instalaci Pythonu: Chcete-li zkontrolovat, zda je Python nainstalován, otevřete příkazový řádek nebo terminál a zadejte příkaz 'python'. Pokud se zobrazí chybové hlášení, že Python nebyl nalezen, můžete jej nainstalovat podle pokynů dostupných na oficiálních webových stránkách Pythonu. Ujistěte se, že máte nainstalovaný Python 3.8 nebo novější, abyste mohli používat knihovnu Requests.
  • Vytvořte a aktivujte virtuální prostředí:
    Vytvořte adresář projektu a virtuální prostředí: Při vytváření virtuálního prostředí v adresáři projektu postupujte podle oficiální dokumentace Pythonu venv.

MacOS

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

Windows

your-virtual-environment-path\Scripts\activate

Nahraďte your-virtual-environment-path skutečnou cestou k adresáři virtuálního prostředí.

Každý web může vygenerovat jeden token API, který může být využíván více systémy nebo softwarovými aplikacemi. Pro každý token API však platí omezení použití na 50 požadavků za hodinu.