> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloudflare Zero Trust (Gateway)

> Descubra la IA que usa su organización a través de Cloudflare Gateway y bloquéela desde SecureAI

SecureAI lee lo que registra Cloudflare Gateway (consultas DNS, pedidos HTTP y sesiones de red), le muestra qué
servicios de IA usa su gente y los bloquea en Gateway cuando usted los prohíbe en SecureAI. Después de conectar,
no hace falta volver al dashboard de Cloudflare: SecureAI crea y mantiene sus propias listas y reglas.

> [!NOTE]
>
> La lectura por Logpush requiere Cloudflare Zero Trust Enterprise y está en beta: todavía no se validó contra una
> cuenta real.

## Qué ve SecureAI según su plan de Cloudflare

| | Free | Standard | Enterprise |
| - | - | - | - |
| Analíticas de Gateway por API (lo que lee SecureAI) | 31 días | 31 días | 31 días |
| DNS: dominio y ubicación | Sí | Sí | Sí |
| DNS: usuario y dispositivo | No | No | Solo con Logpush |
| HTTPS sin inspección TLS: dominio (SNI), dispositivo e IP | Con el cliente WARP | Con WARP | Con WARP o proxy endpoint |
| HTTP: host, usuario y dispositivo | WARP con inspección TLS | WARP con inspección TLS | WARP o proxy endpoint, con inspección TLS |
| Proxy endpoint por IP de origen | No | No | Sí |
| Logpush | No | No | Sí |
| Entradas por lista de Zero Trust | 1.000 | 1.000 | 5.000 |

Tres puntos de esta tabla cambian lo que ve en la consola:

* **DNS no trae usuario.** La API de analíticas de Cloudflare entrega el dominio consultado, la ubicación DNS y
  la categoría, sin IP de origen ni usuario. SecureAI muestra cada ubicación como una fuente
  (`cf-location:<nombre>`). Para saber quién hizo la consulta, el tráfico tiene que pasar por WARP.
* **HTTP con usuario solo vía WARP.** El cliente WARP identifica a la persona, y Gateway registra su email y su
  dispositivo. Sin inspección TLS, Gateway no ve el pedido HTTPS: lo registra como sesión de red con el SNI, y
  SecureAI lo lee de ahí. Un equipo enrolado con un service token, sin persona, aparece como
  `non_identity@<su-equipo>`: SecureAI lo muestra con su dispositivo y sin usuario.
* **Proxy endpoints por IP solo en Enterprise.** En Free y Standard, el proxy endpoint pide que cada navegador
  inicie sesión y tenga instalado el certificado de Cloudflare.

## Qué lee y qué no

* SecureAI lee el **dominio** (DNS), el **host** (HTTP) y el **SNI** (red). No pide URLs, rutas ni contenido,
  aunque usted tenga la inspección TLS prendida.
* La consulta filtra del lado de Cloudflare: SecureAI pide solo el tráfico de la categoría *Artificial
  Intelligence* o de los dominios de su catálogo de IA. El resto de la navegación no sale de Cloudflare.
* Las cifras son las estimaciones de Cloudflare, que muestrea el tráfico. Con poco volumen, un dominio
  consultado pocas veces puede no aparecer. Con Logpush llega cada registro.
* Cloudflare publica las analíticas con algunos minutos de demora. Una consulta suele aparecer en SecureAI entre
  15 y 45 minutos después.

## 1. Crear el token de API

En el dashboard de Cloudflare: **My Profile → API Tokens → Create Token → Custom token**.

| Permiso | Para qué |
| - | - |
| Account → Account Analytics → Read | Leer las analíticas de Gateway |
| Account → Zero Trust → Read | Leer listas, reglas y categorías |
| Account → Zero Trust → Edit | Solo si quiere que SecureAI bloquee |

En **Account Resources** elija solo su cuenta. Copie también el **Account ID** (página de inicio de la cuenta →
menú de la cuenta → *Copy account ID*).

## 2. Conectar en SecureAI

En **Integraciones**, filtro **Network / SWG**, abra **Cloudflare Zero Trust** y pegue el Account ID y el token.
Al tocar **Connect**, SecureAI prueba que el token lee Zero Trust y las analíticas; si falla, no guarda nada y le
dice qué falta. Desde ahí SecureAI consulta Gateway cada 30 minutos, y lo que encuentra aparece en **Fuentes de
red**. Para no esperar la primera vuelta, toque **Sync now** en Fuentes de red: lee los últimos 30 días en segundo
plano.

## 3. Prender el bloqueo

En **Fuentes de red → Respuesta y auto-bloqueo → Bloqueo por Cloudflare Gateway**. Antes de prenderlo, la consola
le pide confirmar esto:

> [!WARNING]
>
> SecureAI crea sus propias listas de Zero Trust y tres reglas de Gateway (DNS, HTTP y red) **delante de sus reglas
> de allow**. Un dominio que SecureAI bloquea queda bloqueado aunque una regla suya lo permita.

Prenderlo pide MFA reciente y queda en el Activity Log con su usuario.

### Qué crea SecureAI en su cuenta

| Objeto | Nombre | Qué hace |
| - | - | - |
| Listas de tipo Domain | `SecureAI — AI block 1`, `2`, … | Guardan los dominios que SecureAI bloquea |
| Regla DNS | `SecureAI — block AI (DNS)` | Bloquea la resolución de esos dominios |
| Regla HTTP | `SecureAI — block AI (HTTP)` | Bloquea el pedido, si la inspección TLS está prendida |
| Regla de red | `SecureAI — block AI (network)` | Corta la conexión HTTPS por el SNI |

Las encuentra en **Traffic controls → Firewall policies** y en **Reusable components → Lists** (Cloudflare muestra
el tipo Domain como "Hostnames"):

![La regla DNS de SecureAI en Firewall policies](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/cloudflare/dns-policy-secureai.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=1015bd421ca6fbca44f17c20fdf52683)

![La lista de SecureAI en Reusable components → Lists](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/cloudflare/list-secureai.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=606dfd512df00b4c6084a0569fe5449d)

Una entrada de una lista Domain cubre el dominio y sus subdominios: `openai.com` bloquea también
`api.openai.com`.

La lista sale de los proveedores que usted marca como **prohibidos** (Fuentes de red → **AI governance**), los
sitios bloqueados de la extensión y los bloqueos temporales activos, menos los sitios aprobados.

### Comprobar que bloquea

En **Insights & Logs → Logs → DNS query logs**, las consultas a un proveedor prohibido aparecen con acción
**Block** y Gateway responde `0.0.0.0`. En SecureAI, la fuente muestra esas consultas como bloqueadas en el
siguiente sync.

![Consultas a chatgpt.com y api.openai.com bloqueadas por la regla de SecureAI](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/cloudflare/dns-logs-blocked.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=e49ba8043e3af44549a54b8c7c2803dd)

### Cómo se mantiene

* SecureAI sincroniza cada 5 minutos, y en el momento en que usted prohíbe o permite un proveedor, o crea o libera
  un bloqueo temporal.
* Si nada cambió, no escribe en Cloudflare. En cada vuelta igual lee sus listas y sus reglas, y repara en esa vuelta
  una regla `SecureAI —` deshabilitada o borrada, o una entrada que alguien sacó a mano. Una vez por día compara
  además entrada por entrada.
* Si la lista pasa el tope de entradas de su plan, SecureAI la parte en varias listas que cubren las mismas
  reglas.
* Cloudflare admite 100 listas por cuenta. Cuando la cuenta usa 80 o más (contando las suyas), SecureAI avisa al
  administrador.

### Si algo falla

* Si SecureAI no puede armar la lista de bloqueo, no escribe nada y Cloudflare sigue con la lista anterior.
* Si Cloudflare rechaza un cambio a mitad del sync, SecureAI corta ahí y reintenta en el siguiente. Primero agrega
  lo nuevo y al final saca lo que sobra, así que nunca deja una lista vacía en el medio.
* El último error queda a la vista en la tarjeta de bloqueo.

### El orden de las reglas

Cloudflare exige una precedencia distinta para cada regla de la cuenta. SecureAI pone las suyas en el primer lugar
libre delante de sus reglas del mismo tipo. Si no hay lugar libre, las pone al final y la consola le avisa que sus
reglas corren antes. Puede moverlas a mano: SecureAI respeta el lugar que les dé.

### Pausar sin desbloquear

El interruptor general de enforcement de SecureAI **congela** la cuenta: SecureAI deja de escribir en Cloudflare,
y las listas y reglas quedan como están, bloqueando lo que ya bloqueaban. Un cambio de política hecho mientras
tanto llega a Cloudflare cuando vuelve a prender el interruptor.

### Apagar el bloqueo

**Apagar** deshabilita las tres reglas, así que **desbloquea todo** lo que SecureAI bloqueaba por Cloudflare. Pide
confirmación y MFA reciente, y queda en el Activity Log. Las listas quedan en la cuenta: volver a prenderlo es un
solo sync.

SecureAI no deja desconectar la integración con el bloqueo prendido: las reglas seguirían bloqueando sin nadie que
las mantenga.

Para sacar a SecureAI de la cuenta por completo: apague el bloqueo, desconecte la integración, borre las tres
reglas `SecureAI — block AI`, después las listas `SecureAI — AI block` (Cloudflare no deja borrar una lista que una regla usa) y revoque el
token.

## A quién alcanza un bloqueo

A todo lo que pasa por Gateway: los dispositivos con WARP y las redes que usan sus ubicaciones DNS. Las reglas no
distinguen usuarios ni IPs. Un bloqueo temporal que un analista crea desde una fuente bloquea esos dominios para
toda la organización hasta que vence.

## Logpush

> [!WARNING]
>
> Logpush requiere Cloudflare Zero Trust **Enterprise**. Está en beta y **sin validar**: SecureAI lo probó con
> registros de ejemplo en el formato que publica Cloudflare, no contra una cuenta Enterprise real.

Con Logpush, Cloudflare le manda a SecureAI cada registro en lugar de las analíticas: llega también el usuario en
DNS, y llega en minutos.

En beta, el equipo de SecureAI acompaña la configuración.

1. En su tenant se crea una fuente de ingesta con el conector **Cloudflare Zero Trust (Logpush)**. Guarde la URL
   y el token, que SecureAI muestra una sola vez.

2. En Cloudflare, cree un job de Logpush por dataset (`gateway_dns`, `gateway_http`, `gateway_network`) con
   destino HTTP:

   ```text theme={null}
   https://<su-tenant>/api/network-ingest/<id-de-la-fuente>?header_Authorization=Bearer%20<token>
   ```

   Con estas `output_options`:

   ```json theme={null}
   { "output_type": "ndjson", "batch_prefix": "{\"events\":[", "batch_suffix": "]}", "record_delimiter": "," }
   ```

3. No incluya el campo `URL` en el job: SecureAI no lo usa.

El bloqueo sigue saliendo de la conexión **Cloudflare Zero Trust** del paso 2. Logpush solo reemplaza la lectura.

## Problemas comunes

| Síntoma | Causa probable |
| - | - |
| Connect falla con `CF_AUTH` | Cloudflare rechazó el token: está mal copiado, venció o lo revocaron |
| Connect falla con `NO_ANALYTICS_SCOPE` | Al token le falta Account Analytics Read |
| Connect falla con `NO_ZT_READ` | Al token le falta Zero Trust Read, o el Account ID es de otra cuenta |
| Desconectar falla con `ENFORCEMENT_ON` | El bloqueo está prendido: apáguelo primero |
| El bloqueo queda con error `CF_FORBIDDEN` | Al token le falta Zero Trust Edit |
| Error `CF_LIMIT` | No quedan listas libres en la cuenta (máximo 100) |
| Fuentes `cf-location:…` sin usuario | Es DNS por ubicación: el usuario solo llega con WARP |
| Nada en Fuentes de red después de una hora | El tráfico no pasa por Gateway, o no fue a dominios de IA |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.