Management and Reporting

Cloud CNM SecuReporter

Zyxel SecuReporter OpenAPI

Vind bronnen die helpen bij het automatiseren en snel bouwen van op maat ontwikkelde toepassingen met API's voor het Zyxel SecuReporter-platform.

Toegang tot apparaatgegevens met SecuReporter OpenAPI Service

SecuReporter ondersteunt een interface voor software voor directe interactie met het SecuReporter-cloudplatform.
Deze API's stellen SecuReporter gebruikers in staat om apparaatlogs van de afgelopen 31 dagen op te halen met behulp van een API token.

Met de SecuReporter OpenAPI heb je eenvoudig toegang tot je apparaatgegevens via HTTP-verzoeken met behulp van een programmeertaal of cURL-opdrachten. Om deze service te gebruiken, moet je ervoor zorgen dat je apparaat een geldige SecuReporter licentie en een OpenAPI Token heeft. Deze gegevens zijn nodig om je verzoeken aan de API te verifiëren en autoriseren.

Ontdek de ultieme voordelen van SecuReporter's OpenAPI Token

Stroomlijn uw workflows, verbeter de schaalbaarheid en maak naadloze automatisering mogelijk. Ervaar een veilige, efficiënte en gebruiksvriendelijke methode voor toegang tot firewall logbestanden, ontworpen om zowel handmatige als geautomatiseerde processen te ondersteunen.

Gemak en efficiëntie

Krijg direct toegang tot uw firewall logs via HTTP verzoeken met behulp van elke programmeertaal of cURL commando's-geen portaal login nodig. Dit stroomlijnt uw workflow, bespaart tijd en is perfect voor geautomatiseerde systemen of scripts die regelmatig logs moeten ophalen.

Schaalbaarheid

OpenAPI tokens maken schaalbare toegang tot firewall logs mogelijk. Genereer meerdere tokens voor verschillende gebruikers of systemen en zorg zo voor flexibiliteit en controle.

Automatiseringsmogelijkheden

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

Waarom SecuReporter's OpenAPI Token integreren?

SecuReporter biedt een veilige, efficiënte en gebruiksvriendelijke methode voor toegang tot firewall logbestanden. Ondersteun zowel handmatige als geautomatiseerde processen met behoud van hoge beveiligingsstandaarden. Voor meer gedetailleerde informatie over SecuReporter OpenAPI integratie en meer, bezoek onze GitHub.

Zyxel GitHub

Naadloze Integratie FAQ

Maak je geen zorgen, wij dekken je! Terwijl je onderzoekt hoe je OpenAPI kunt integreren met SecuReporter, zijn hier enkele nuttige tips en FAQ's om je door het proces te leiden.

De Archived Logs Service is de eerste open service die wordt aangeboden door SecuReporter OpenAPI. Het stelt gebruikers in staat om firewall logs tot 31 dagen terug op te vragen met behulp van een API token. Elk API token staat een maximum van 50 API verzoeken per uur toe. Blijf op de hoogte van toekomstige services.

Stuur het ticket/de e-mailcase door naar uw lokale Zyxel-verkoopafdeling of sales engineer om de impact van uw functieaanvraag te valideren.

Voorwaarden:

Zorg ervoor dat uw firewall 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 van de Zyxel-marktplaats om toegang te krijgen tot de OpenAPI-service.

Stappen voor het genereren van OpenAPI Token op SecuReporter:

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

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

Stap 3: Kopieer het OpenAPI Token.

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

[1] Testen met cURL

  • Installatie: Om te controleren of cURL is geïnstalleerd, open je Command Prompt of Terminal en typ curl. Als je een foutmelding krijgt dat cURL niet gevonden is, volg dan de installatie instructies beschikbaar op de cURL GitHub repository.
  • Het maken van uw eerste OpenAPI verzoek: Open je Command Prompt/Terminal en gebruik het volgende commando. Vervang yyyy-MM-dd door een datum binnen de afgelopen 31 dagen (exclusief de huidige datum) in de notatie yyyy-mm-dd. mydir door het pad van je huidige downloadmap op je computer.

macOS

curl -X POST \

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

-H "Inhoudstype: toepassing/json" \

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

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

-o mijndir/archief.tar

Windows

curl -X POST ^

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

-H "Inhoudstype: toepassing/json" ^".

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

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

-o mydirarchive.tar

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

[2] Testen met Python

  • Controleer Python installatie: Om te controleren of Python is geïnstalleerd, opent u uw 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 Python 3.8 of nieuwer is geïnstalleerd om de Requests-bibliotheek te gebruiken.
  • Creëer en activeer een virtuele omgeving:
    Creëer een Projectmap en een Virtuele Omgeving: Volg de officiële Python venv documentatie om je virtuele omgeving aan te maken in een projectmap.

macOS

source uw-virtuele-omgeving-pad/bin/activeren

Windows

uw-virtuele-omgeving-pad

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

Elke site kan één API token genereren, die gebruikt kan worden door meerdere systemen of software applicaties. Er is echter een gebruiksbeperking van 50 aanvragen per uur voor elk API token.