Explorar docs

Getting Started

Formato de URL del feed y claves de licencia

Construye una URL de feed Cybora con los parámetros requeridos de clave de licencia y tipo de indicador.

Última actualización: 15 de junio de 2026

En esta página

Las URLs de feed Cybora están diseñadas para pegarse en campos de configuración de firewall que esperan una lista de texto remota. El firewall realiza una solicitud HTTPS y recibe una respuesta TXT simple con un indicador por línea.

Cybora no usa formatos de archivo específicos de firewall. La misma estructura de URL se usa en todas las plataformas soportadas; la parte específica del firewall es dónde pegas la URL y cómo el firewall consume la lista devuelta.

Create your feed URL

Paste your license key, select the indicator category, and copy the generated URL into your firewall.

Indicator category

This generator runs only in your browser. The key is not stored by this page and is not sent to Cybora.

URL base

El endpoint estándar del feed es:

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

La URL tiene tres partes:

  • https://api.cybora.io/feed es el endpoint HTTPS que devuelve el feed TXT.
  • key autoriza el acceso a la suscripción del feed.
  • type selecciona la categoría de indicador que debe devolverse.

Parámetros GET requeridos

ParámetroRequeridoEjemploDescripción
keySíABCDE-12345-FGHIJ-67890-KLMNOTu clave de licencia Cybora única. Usa la clave exacta emitida para el dispositivo firewall, edge o feed de prueba.
typeSíipv4La categoría de indicador a devolver. Los valores soportados son ipv4, domain y url, según tu plan.

Las claves de licencia Cybora suelen emitirse como cinco bloques separados por guiones. Mantén los guiones cuando pegues la clave en una URL de feed o en el generador anterior.

El valor type debe coincidir con la categoría de indicador que quieres que el firewall importe:

  • ipv4 devuelve direcciones IPv4, subredes o rangos cuando la lista los soporta.
  • domain devuelve indicadores de dominio.
  • url devuelve indicadores URL.

Para integraciones firewall normales no se requiere ningún parámetro de formato adicional. Cybora devuelve por defecto un feed TXT plano.

URLs de ejemplo

Feed IPv4:

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

Feed de 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 de respuesta TXT

El cuerpo de respuesta es texto plano. No hay wrapper JSON, estructura anidada ni envoltorio específico del proveedor firewall. Cada línea contiene un indicador.

Salida IPv4 de ejemplo:

203.0.113.10
198.51.100.24
192.0.2.4

Salida estilo dominio de ejemplo:

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

Salida URL de ejemplo:

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

Elegir la categoría de indicador

Elige el valor type según lo que incluye tu plan y lo que el firewall puede aplicar de forma nativa:

  • Usa type=ipv4 para objetos de dirección firewall, alias, external dynamic lists o blocklists.
  • Usa type=domain para policy a nivel DNS o funciones firewall que soporten objetos de dominio.
  • Usa type=url solo donde la plataforma tenga enforcement consciente de URLs.

Si un firewall solo soporta listas externas basadas en IP, usa un feed IPv4 aunque tu plan también incluya cobertura de dominio o URL. Los feeds de dominio y URL solo deben añadirse a funciones que puedan parsear y aplicar esas categorías de indicadores.

Manejo de URLs en firewalls

Cuando pegues la URL del feed en un firewall, usa la URL completa incluida la query string:

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

No elimines la parte ?key=...&type=.... Sin la clave, Cybora no puede autorizar la solicitud. Sin el tipo, la API no puede saber qué categoría de indicador devolver.

La mayoría de firewalls almacenan la URL como fuente de lista remota y la consultan según una programación. Configura el intervalo de polling de acuerdo con tu plan Cybora y los ajustes de refresh soportados por el proveedor. Consultar más frecuentemente de lo permitido no produce datos más frescos y puede activar protección contra solicitudes excesivas.

Manejo de claves

Usa una clave de licencia única para el edge o dispositivo firewall permitido por tu plan. No reutilices una clave en dispositivos no relacionados salvo que tu acuerdo comercial lo permita explícitamente.

Si una clave queda expuesta, rótala a través de soporte y actualiza la configuración del firewall con la nueva URL de feed.