Beheer en rapportage

Cloud CNM SecuReporter

Zyxel SecuReporter OpenAPI

Vind hulpmiddelen om op maat ontwikkelde applicaties te automatiseren en snel te bouwen met API's voor het Zyxel SecuReporter-platform.

Toegang tot apparaatgegevens met de SecuReporter OpenAPI-service

SecuReporter ondersteunt een interface waarmee software rechtstreeks kan communiceren met het SecuReporter-cloudplatform.
Met deze API's kunnen SecuReporter-gebruikers met behulp van een API-token apparaatlogboeken van de afgelopen 31 dagen ophalen.

Met de SecuReporter OpenAPI kunt u eenvoudig toegang krijgen tot uw apparaatgegevens via HTTP-verzoeken, met behulp van elke programmeertaal of cURL-opdrachten. Om van deze service gebruik te kunnen maken, moet uw apparaat beschikken over een geldige SecuReporter-licentie en een OpenAPI-token. Deze inloggegevens zijn nodig om uw verzoeken aan de API te authenticeren en te autoriseren.

Ontdek de ultieme voordelen van het OpenAPI-token van SecuReporter

Stroomlijn uw workflows, verbeter de schaalbaarheid en maak naadloze automatisering mogelijk. Ervaar een veilige, efficiënte en gebruiksvriendelijke methode voor toegang tot firewalllogbestanden, ontworpen ter ondersteuning van zowel handmatige als geautomatiseerde processen.

Gemak en efficiëntie

Krijg rechtstreeks toegang tot uw firewalllogbestanden via HTTP-verzoeken met behulp van elke programmeertaal of cURL-commando’s – u hoeft niet in te loggen via een portaal. Dit stroomlijnt uw workflow, bespaart tijd en is ideaal voor geautomatiseerde systemen of scripts die regelmatig logbestanden moeten ophalen.

Schaalbaarheid

OpenAPI-tokens maken schaalbare toegang tot firewalllogbestanden mogelijk. Genereer meerdere tokens voor verschillende gebruikers of systemen, wat zorgt voor flexibiliteit en controle.

Automatiseringsmogelijkheden

Integreer naadloos met andere systemen en software met behulp van API-tokens. Automatiseer het ophalen van firewalllogs en neem deze gegevens op in uw Security Information and Event Management (SIEM)-systemen zonder handmatige tussenkomst.

Waarom het OpenAPI-token van SecuReporter integreren?

SecuReporter biedt een veilige, efficiënte en gebruiksvriendelijke methode voor toegang tot firewall-logbestanden. Het ondersteunt zowel handmatige als geautomatiseerde processen, met behoud van hoge beveiligingsstandaarden. Ga voor meer gedetailleerde informatie over de SecuReporter OpenAPI-integratie en meer naar onze GitHub.

Zyxel GitHub

Veelgestelde vragen over naadloze integratie

Maak je geen zorgen, wij staan voor je klaar! Terwijl je onderzoekt hoe je OpenAPI met SecuReporter kunt integreren, vind je hier enkele handige tips en veelgestelde vragen om je door het proces te begeleiden.

De 'Archived Logs Service' is de eerste open service die door SecuReporter OpenAPI wordt aangeboden. Hiermee kunnen gebruikers met behulp van een API-token firewalllogs opvragen die tot 31 dagen teruggaan. Elk API-token geeft recht op maximaal 50 API-verzoeken per uur. Houd onze website in de gaten voor nieuwe services die in de toekomst worden uitgebracht.

Stuur de e-mail met het ticket/de case door naar uw lokale Zyxel-verkoopmedewerker of verkoopingenieur om uw functieverzoek te laten beoordelen op de impact ervan

Vereisten:

Zorg ervoor dat uw firewallapparaat een actieve SecuReporter-licentie heeft en dat de SecuReporter-service is ingeschakeld. Als uw licentie is verlopen, neem dan contact op met de eigenaar van het apparaat of koop een nieuwe licentie via de Zyxel-marktplaats om toegang te krijgen tot de OpenAPI-service.

Stappen om een OpenAPI-token te genereren in SecuReporter:

Stap 1: Selecteer het apparaat met een geldige SecuReporter-licentie en klik op de knop "API-toegang".

Stap 2: Klik op de knop "Create New API Token".

Stap 3: Kopieer het OpenAPI-token.

Er zijn twee methoden beschikbaar om de OpenAPI te testen: cURL en Python.

[1] Testen met cURL

  • Voorbereiding: Om te controleren of cURL is geïnstalleerd, opent u de opdrachtprompt of terminal en typt u `curl`. Als u een foutmelding krijgt dat cURL niet is gevonden, volgt u de installatie-instructies die beschikbaar zijn op de cURL GitHub-repository.
  • Je eerste OpenAPI-verzoek doen: Open je Opdrachtprompt/Terminal en gebruik de volgende opdracht. Vervang yyyy-MM-dd door een datum van de afgelopen 31 dagen (de huidige datum niet meegerekend) in de indeling yyyy-mm-dd. Vervang mydir door het daadwerkelijke pad naar de downloadmap op je computer.

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

Vervang "https://api.example.com/endpoint" door het daadwerkelijke API-eindpunt en "your_api_token" door uw API-token.

[2] Testen met Python

  • Controleer of Python is geïnstalleerd: Om te controleren of Python is geïnstalleerd, opent u de Opdrachtprompt of Terminal en typt u ‘python’. Als u een foutmelding krijgt dat Python niet is gevonden, kunt u het installeren door de instructies op de officiële Python-website te volgen. Zorg ervoor dat u Python 3.8 of nieuwer hebt geïnstalleerd om de Requests-bibliotheek te kunnen gebruiken.
  • Een virtuele omgeving aanmaken en activeren:
    Een projectmap en virtuele omgeving aanmaken: Volg de officiële Python venv-documentatie om uw virtuele omgeving in een projectmap aan te maken.

macOS

source je-pad-naar-virtuele-omgeving/bin/activate

Windows

pad-naar-je-virtuele-omgeving\Scripts\activate

Vervang 'pad-naar-je-virtuele-omgeving' door het daadwerkelijke pad naar de map van je virtuele omgeving.

Elke site kan één API-token genereren, dat door meerdere systemen of softwareapplicaties kan worden gebruikt. Er geldt echter een gebruiksbeperking van 50 verzoeken per uur per API-token.