Management & Reporting

Cloud CNM SecuReporter

Zyxel SecuReporter OpenAPI

Trova risorse per automatizzare e sviluppare rapidamente applicazioni personalizzate utilizzando le API della piattaforma Zyxel SecuReporter.

Accesso ai dati dei dispositivi con il servizio SecuReporter OpenAPI

SecuReporter offre un'interfaccia che consente ai software di interagire direttamente con la piattaforma cloud di SecuReporter.
Queste API consentono agli utenti di SecuReporter di recuperare i log dei dispositivi degli ultimi 31 giorni utilizzando un token API.

Con l'OpenAPI di SecuReporter, puoi accedere facilmente ai dati dei tuoi dispositivi tramite richieste HTTP utilizzando qualsiasi linguaggio di programmazione o comandi cURL. Per utilizzare questo servizio, assicurati che il tuo dispositivo disponga di una licenza valida per SecuReporter e di un token OpenAPI. Queste credenziali sono necessarie per autenticare e autorizzare le tue richieste all'API.

Scopri i vantaggi del Token OpenAPI di SecuReporter

Ottimizza i tuoi flussi di lavoro, aumenta la scalabilità e abilita un'automazione senza interruzioni. Scopri un metodo sicuro, efficiente e intuitivo per accedere ai file di log del firewall, progettato per supportare processi sia manuali che automatizzati.

Comodità ed Efficienza

Accedi ai log del firewall direttamente tramite richieste HTTP utilizzando qualsiasi linguaggio di programmazione o comandi cURL, senza bisogno di accedere al portale. Questo semplifica il flusso di lavoro, consente di risparmiare tempo ed è ideale per sistemi automatizzati o script che richiedono un recupero regolare dei log.

Scalabilità

I token OpenAPI consentono un accesso scalabile ai log del firewall. È possibile generare più token per utenti o sistemi diversi, garantendo flessibilità e controllo.

Automazione

Integra facilmente con altri sistemi e software utilizzando i token API. Automatizza il recupero dei log del firewall e incorpora questi dati nei tuoi sistemi di gestione delle informazioni e degli eventi di sicurezza (SIEM) senza intervento manuale.

Perché integrare il Token OpenAPI di SecuReporter?

SecuReporter offre un metodo sicuro, efficiente e facile da usare per accedere ai file di log del firewall. Supporta sia i processi manuali che automatizzati, mantenendo alti standard di sicurezza. Per ulteriori informazioni sull'integrazione di SecuReporter OpenAPI e altro ancora, visita il nostro GitHub.

Zyxel GitHub

Domande Frequenti sull'Integrazione

Non preoccuparti, ci pensiamo noi! Mentre esplori come integrare OpenAPI con SecuReporter, ecco alcuni suggerimenti utili e domande frequenti per guidarti nel processo.

Il servizio di log archiviati è il primo servizio pubblico offerto da SecuReporter OpenAPI. Consente agli utenti di recuperare i log del firewall fino a 31 giorni precedenti, utilizzando un token API. Ogni token API consente fino a 50 richieste API all'ora. Rimani aggiornato per scoprire i prossimi servizi che saranno rilasciati in futuro.

Per favore inoltra il ticket/email caso al tuo commerciale di riferimento Zyxel per convalidare la tua richiesta.

Pre-requisiti:

Assicurati che il tuo dispositivo firewall abbia una licenza attiva per SecuReporter e che il servizio SecuReporter sia abilitato. Se la tua licenza è scaduta, contatta il proprietario del dispositivo o acquista una nuova licenza sul Marketplace Zyxel per accedere al Servizio OpenAPI.

Passaggi per generare un token OpenAPI su SecuReporter:

Step 1: Seleziona il dispositivo con una licenza SecuReporter valida e clicca sul pulsante "Accesso API".

Step 2: Clicca sul pulsante "Create New API Token".

Step 3: Copia il Token OpenAPI.

Sono disponibili due metodi per testare l'OpenAPI: cURL e Python.

[1] Testare con cURL

  • Configurazione: Per verificare se cURL è installato, apri il Prompt dei comandi o il Terminale e digita curl. Se ricevi un errore che indica che cURL non è stato trovato, segui le istruzioni per l'installazione disponibili nel repository GitHub di cURL.
  • Fai la tua prima richiesta OpenAPI: apri il Prompt dei comandi/Terminale e usa il comando seguente. Sostituisci yyyy-MM-dd con una data degli ultimi 31 giorni (escludendo la data odierna) nel formato yyyy-mm-dd. Sostituisci mydir con il percorso effettivo della tua cartella di download sul tuo 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

Sostituisci "https://api.example.com/endpoint" con l'endpoint API effettivo e "your_api_token" con il tuo token API.

[2] Testare con Python

  • Verifica l'installazione di Python: Per verificare se Python è installato, apri il Prompt dei comandi o il Terminale e digita "python". Se ricevi un errore che indica che Python non è stato trovato, puoi installarlo seguendo le istruzioni disponibili sul sito ufficiale di Python. Assicurati di avere installato Python 3.8 o una versione più recente per utilizzare la library Requests.
  • Creare e attivare il Virtual Environment:
    Crea una directory di progetto e un ambiente virtuale: Segui la documentazione ufficiale di Python venv per creare il tuo ambiente virtuale in una directory di progetto.

macOS

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

Windows

your-virtual-environment-path\Scripts\activate

Sostituisci "your-virtual-environment-path" con il percorso effettivo della tua directory dell'ambiente virtuale.

Ogni sito può generare un token API, che può essere utilizzato da più sistemi o applicazioni software. Tuttavia, c'è una limitazione di utilizzo di 50 richieste per ora per ogni token API.