Formato dell'URL del feed e chiavi di licenza

Gli URL dei feed Cybora sono progettati per essere incollati nei campi di configurazione firewall che si aspettano una lista di testo remota. Il firewall esegue una richiesta HTTPS e riceve una risposta TXT semplice con un indicatore per riga.

Cybora non usa formati di file specifici per firewall. La stessa struttura URL è usata su tutte le piattaforme supportate; la parte specifica del firewall è dove incolli l’URL e come il firewall consuma la lista restituita.

URL base

L’endpoint standard del feed è:

https://api.cybora.io/feed?key=<LICENSE_KEY>&type=<INDICATOR_TYPE>

L’URL ha tre parti:

• https://api.cybora.io/feed è l’endpoint HTTPS che restituisce il feed TXT.
• key autorizza l’accesso alla sottoscrizione del feed.
• type seleziona la categoria di indicatori da restituire.

Parametri GET richiesti

Le chiavi di licenza Cybora sono di solito emesse come cinque blocchi separati da trattini. Mantieni i trattini quando incolli la chiave in un URL di feed o nel generatore sopra.

Il valore type deve corrispondere alla categoria di indicatore che vuoi far importare al firewall:

• ipv4 restituisce indirizzi IPv4.
• domain restituisce indicatori di dominio.
• url restituisce indicatori URL.

Per le integrazioni firewall normali non è richiesto alcun parametro di formato aggiuntivo. Cybora restituisce un feed TXT piatto per default.

Esempi di URL

Feed IPv4:

https://api.cybora.io/feed?key=ABCDE-12345-FGHIJ-67890-KLMNO&type=ipv4

Feed dominio:

https://api.cybora.io/feed?key=ABCDE-12345-FGHIJ-67890-KLMNO&type=domain

Feed URL:

https://api.cybora.io/feed?key=ABCDE-12345-FGHIJ-67890-KLMNO&type=url

Formato della risposta TXT

Il corpo della risposta è testo semplice. Non c’è wrapper JSON, struttura annidata o envelope specifico del vendor firewall. Ogni riga contiene un indicatore.

Esempio di output IPv4:

203.0.113.10
198.51.100.24
192.0.2.4

Esempio di output stile dominio:

malicious-example.test
scanner-control.test
phishing-host.test

Esempio di output URL:

https://malicious-example.test/login
http://scanner-control.test/payload
/wp-admin/setup-config.php

Scegliere la categoria di indicatore

Scegli il valore type in base a ciò che include il tuo piano e a ciò che il firewall può applicare nativamente:

• Usa type=ipv4 per oggetti indirizzo firewall, alias, external dynamic lists o blocklist.
• Usa type=domain per policy a livello DNS o funzionalità firewall che supportano oggetti dominio.
• Usa type=url solo dove la piattaforma ha enforcement consapevole delle URL.

Se un firewall supporta solo liste esterne basate su IP, usa un feed IPv4 anche se il piano include anche copertura dominio o URL. I feed dominio e URL vanno aggiunti solo a funzionalità che possono fare parsing e applicare quelle categorie di indicatori.

Gestione degli URL nei firewall

Quando incolli l’URL del feed in un firewall, usa l’URL completo includendo la query string:

https://api.cybora.io/feed?key=<LICENSE_KEY>&type=ipv4

Non rimuovere la parte ?key=...&type=.... Senza la chiave, Cybora non può autorizzare la richiesta. Senza il tipo, l’API non può sapere quale categoria di indicatori restituire.

La maggior parte dei firewall salva l’URL come sorgente di lista remota e lo interroga su pianificazione. Imposta l’intervallo di polling secondo il piano Cybora e le impostazioni di refresh supportate dal vendor. Interrogare più spesso di quanto il piano consenta non produce dati più freschi e può attivare protezioni contro richieste eccessive.

Gestione delle chiavi

Usa una chiave di licenza univoca per l’edge o il dispositivo firewall consentito dal tuo piano. Non riutilizzare una chiave su dispositivi non correlati, salvo esplicita autorizzazione nel contratto commerciale.

Se una chiave viene esposta, ruotala tramite supporto e aggiorna la configurazione firewall con il nuovo URL del feed.