Verwaltung und Berichterstattung

Cloud CNM SecuReporter

Zyxel SecuReporter OpenAPI

Hier finden Sie Ressourcen, die Sie bei der Automatisierung und schnellen Erstellung von kundenspezifischen Anwendungen mit APIs für die Zyxel SecuReporter-Plattform unterstützen.

Zugriff auf Gerätedaten mit SecuReporter OpenAPI Service

SecuReporter unterstützt eine Schnittstelle für Software zur direkten Interaktion mit der SecuReporter Cloud-Plattform.
Diese APIs ermöglichen es SecuReporter-Benutzern, Geräteprotokolle der letzten 31 Tage mit einem API-Token abzurufen.

Mit der SecuReporter OpenAPI können Sie einfach auf Ihre Gerätedaten über HTTP-Anfragen mit einer beliebigen Programmiersprache oder cURL-Befehlen zugreifen. Um diesen Dienst nutzen zu können, muss Ihr Gerät über eine gültige SecuReporter-Lizenz und ein OpenAPI-Token verfügen. Diese Anmeldedaten sind erforderlich, um Ihre Anfragen an die API zu authentifizieren und zu autorisieren.

Entdecken Sie die ultimativen Vorteile von SecuReporters OpenAPI Token

Optimieren Sie Ihre Arbeitsabläufe, verbessern Sie die Skalierbarkeit und ermöglichen Sie eine nahtlose Automatisierung. Erleben Sie eine sichere, effiziente und benutzerfreundliche Methode für den Zugriff auf Firewall-Protokolldateien, die sowohl manuelle als auch automatisierte Prozesse unterstützt.

Bequemlichkeit und Effizienz

Greifen Sie auf Ihre Firewall-Protokolle direkt über HTTP-Anfragen zu, indem Sie eine beliebige Programmiersprache oder cURL-Befehle verwenden - eine Portalanmeldung ist nicht erforderlich. Dies strafft Ihren Arbeitsablauf, spart Zeit und ist ideal für automatisierte Systeme oder Skripte, die einen regelmässigen Log-Abruf erfordern.

Skalierbarkeit

OpenAPI-Tokens ermöglichen einen skalierbaren Zugriff auf Firewall-Protokolle. Generieren Sie mehrere Token für verschiedene Benutzer oder Systeme, um Flexibilität und Kontrolle zu gewährleisten.

Automatisierungsfähigkeit

Nahtlose Integration in andere Systeme und Software mithilfe von API-Tokens. Automatisieren Sie den Abruf von Firewall-Protokollen und integrieren Sie diese Daten ohne manuelle Eingriffe in Ihre SIEM-Systeme (Security Information and Event Management).

Warum den OpenAPI Token von SecuReporter integrieren?

SecuReporter bietet eine sichere, effiziente und benutzerfreundliche Methode für den Zugriff auf Firewall-Logdateien. Unterstützt sowohl manuelle als auch automatisierte Prozesse unter Beibehaltung hoher Sicherheitsstandards. Weitere Informationen zur SecuReporter OpenAPI-Integration und mehr finden Sie auf unserem GitHub.

Zyxel GitHub

Nahtlose Integration FAQ

Keine Sorge, wir haben alles für Sie vorbereitet! Während Sie erforschen, wie Sie OpenAPI mit SecuReporter integrieren können, finden Sie hier einige hilfreiche Tipps und FAQs, die Sie durch den Prozess führen.

Der Archived Logs Service ist der erste offene Dienst, der von SecuReporter OpenAPI angeboten wird. Er ermöglicht es Benutzern, Firewall-Protokolle, die bis zu 31 Tage zurückreichen, mit einem API-Token abzurufen. Jedes API-Token erlaubt maximal 50 API-Anfragen pro Stunde. Bleiben Sie dran, wenn in Zukunft weitere Dienste veröffentlicht werden.

Bitte leiten Sie das Ticket/die Fall-E-Mail an Ihren lokalen Zyxel-Vertriebsmitarbeiter oder Vertriebsingenieur weiter, um Ihre Funktionsanforderung im Hinblick auf ihre Auswirkungen zu validieren.

Vorraussetzungen:

Stellen Sie sicher, dass Ihr Firewall-Gerät über eine aktive SecuReporter-Lizenz verfügt und dass der SecuReporter-Dienst aktiviert ist. Wenn Ihre Lizenz abgelaufen ist, wenden Sie sich bitte an den Eigentümer des Geräts oder erwerben Sie eine neue Lizenz auf dem Zyxel-Marktplatz, um auf den OpenAPI-Service zuzugreifen.

Schritte zur Generierung eines OpenAPI-Tokens auf SecuReporter:

Schritt 1: Wählen Sie das Gerät mit einer gültigen SecuReporter-Lizenz aus und klicken Sie auf die Schaltfläche "API Access".

Schritt 2: Klicken Sie auf die Schaltfläche "Create New API Token".

Schritt 3: Kopieren Sie das OpenAPI Token.

Es gibt zwei Methoden zum Testen der OpenAPI: cURL und Python.

[1] Testen mit cURL

  • Einrichten: Um zu prüfen, ob cURL installiert ist, öffnen Sie Ihre Eingabeaufforderung oder Ihr Terminal und geben Sie curl ein. Wenn Sie eine Fehlermeldung erhalten, dass cURL nicht gefunden wurde, folgen Sie den Installationsanweisungen, die im cURL-GitHub-Repository verfügbar sind.
  • Erstellen Sie Ihre erste OpenAPI-Anfrage: Öffnen Sie Ihre Eingabeaufforderung/Terminal und verwenden Sie den folgenden Befehl. Ersetzen Sie yyyy-MM-dd durch ein Datum innerhalb der letzten 31 Tage (ohne das aktuelle Datum) im Format yyyy-mm-dd. mydir durch den tatsächlichen Pfad des Download-Ordners auf Ihrem 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

Ersetzen Sie "https://api.example.com/endpoint" durch den tatsächlichen API-Endpunkt und "your_api_token" durch Ihr API-Token.

[2] Testen mit Python

  • Überprüfen Sie die Python-Installation: Um zu prüfen, ob Python installiert ist, öffnen Sie Ihre Eingabeaufforderung oder Ihr Terminal und geben Sie "python" ein. Wenn Sie die Fehlermeldung erhalten, dass Python nicht gefunden wurde, können Sie es installieren, indem Sie den Anweisungen auf der offiziellen Python-Website folgen. Stellen Sie sicher, dass Sie Python 3.8 oder eine neuere Version installiert haben, um die Requests-Bibliothek verwenden zu können.
  • Erstellen und aktivieren Sie eine virtuelle Umgebung:
    Erstellen Sie ein Projektverzeichnis und eine virtuelle Umgebung: Folgen Sie der offiziellen Python venv-Dokumentation, um Ihre virtuelle Umgebung in einem Projektverzeichnis zu erstellen.

macOS

source ihre-virtuelle-umgebung-pfad/bin/activate

Windows

ihr-virtueller-umgebungspfad\Scripts\aktivieren

Ersetzen Sie your-virtual-environment-path durch den tatsächlichen Pfad zu Ihrem virtuellen Umgebungsverzeichnis.

Jeder Standort kann ein API-Token generieren, das von mehreren Systemen oder Softwareanwendungen verwendet werden kann. Es gibt jedoch eine Nutzungsbeschränkung von 50 Anfragen pro Stunde für jedes API-Token.