> ## 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.

# Palo Alto Networks (PAN-OS)

> Descubra la IA que pasa por sus firewalls Palo Alto y bloquéela con una External Dynamic List de SecureAI

SecureAI lee los logs de URL Filtering y de Traffic de sus firewalls Palo Alto, le muestra qué servicios de IA usa
su gente y publica las External Dynamic Lists (EDL) con lo que usted prohíbe. El firewall las descarga y las aplica
con sus propios perfiles y reglas. No hace falta la suscripción de AI Access Security.

> [!NOTE]
>
> La consola todavía no tiene una pantalla para crear las fuentes de logs y los feeds: el equipo de SecureAI lo hace con usted y le entrega los identificadores y los tokens.

## Cómo funciona

1. El firewall manda a SecureAI sus logs de URL Filtering y de Traffic, por syslog a través del colector de
   SecureAI o directo por HTTP log forwarding.
2. SecureAI lee de cada log el equipo de origen, el usuario (si el firewall lo conoce), el destino, la decisión y la
   clasificación de Palo Alto: el App-ID y la categoría de PAN-DB. Los App-IDs con la etiqueta *Generative AI*
   (`openai-chatgpt`, `claude-base`, `google-gemini`, `github-copilot` y unos 500 más) y las categorías
   `artificial-intelligence` y `AI-*` cuentan como IA.
3. Usted ve el resultado en **Inventario > Fuentes de red**.
4. Cuando usted prohíbe un proveedor o bloquea dominios, SecureAI los agrega a las EDL. El firewall las descarga
   cada cinco minutos y bloquea con un perfil de URL Filtering, una regla de seguridad y la política DNS de un perfil
   Anti-Spyware.

## Qué ve SecureAI y qué no

* **Sin descifrado TLS, el firewall ve el dominio y no el contenido.** Lee el SNI de la conexión HTTPS y la consulta
  DNS. SecureAI sabe que alguien usó ChatGPT, desde qué equipo y cuántas veces; no qué escribió.
* **El log de URL Filtering trae el dominio** (`chatgpt.com/`). El log de Traffic trae la IP de destino y el App-ID:
  cuando es lo único que llega, SecureAI muestra la IP y nombra el proveedor por el App-ID.
* **El usuario aparece si el firewall tiene User-ID** (agente, Cloud Identity Engine o la API de User-ID) y la zona de
  origen tiene **Enable User Identification**. SecureAI lo muestra sin el dominio (`ACME\ana.perez` aparece como
  `ana.perez`) y no toma las cuentas de máquina como personas. Sin User-ID, SecureAI agrupa por la IP del equipo.

## Qué licencia pide cada pieza

Según la documentación de Palo Alto. En el laboratorio de SecureAI usamos VM-Series con la licencia Bundle2, que
incluye todas las suscripciones: no pudimos probar qué pasa sin cada una.

| Pieza | Licencia |
| - | - |
| App-ID y sus actualizaciones de contenido | Ninguna suscripción: alcanza el contrato de soporte ([Dynamic Content Updates](https://docs.paloaltonetworks.com/pan-os/11-1/pan-os-upgrade/software-and-content-updates/dynamic-content-updates)) |
| Perfil de URL Filtering, categorías de PAN-DB y log de URL Filtering | Advanced URL Filtering, o la licencia de URL Filtering anterior. Si vence, el firewall deja de hacer URL Filtering ([Configure URL Filtering](https://docs.paloaltonetworks.com/advanced-url-filtering/administration/configuring-url-filtering/configure-url-filtering), [Activate URL Filtering License](https://docs.paloaltonetworks.com/advanced-url-filtering/administration/configuring-url-filtering/activate-url-filtering-license)) |
| EDL de tipo URL en un perfil de URL Filtering | La del perfil: Advanced URL Filtering |
| EDL de tipo URL como categoría en una regla de seguridad | La documentación de Palo Alto no lo dice, y no lo probamos sin licencia |
| EDL de tipo dominio en la política DNS de un perfil Anti-Spyware | Threat Prevention o Advanced Threat Prevention. DNS Security no hace falta ([Configure DNS Sinkholing for a List of Custom Domains](https://docs.paloaltonetworks.com/advanced-threat-prevention/administration/configure-threat-prevention/use-dns-queries-to-identify-infected-hosts-on-the-network/configure-dns-sinkholing-for-a-list-of-custom-domains)) |
| EDL de tipo IP | La documentación no menciona una licencia para las EDL propias. Las EDL de IP predefinidas de Palo Alto piden Threat Prevention ([Built-in EDLs](https://docs.paloaltonetworks.com/pan-os/11-1/pan-os-admin/policy/use-an-external-dynamic-list-in-policy/built-in-edls)) |

Con solo el contrato de soporte, SecureAI ve la IA por el App-ID del log de Traffic. Para bloquear con las EDL de
SecureAI necesita Advanced URL Filtering o Threat Prevention.

## Lo que necesita

* PAN-OS 11.1 o posterior, y un administrador con permiso de escritura en Device, Objects y Policies.
* Que el firewall salga por HTTPS a su tenant (`https://<tenant>.hiperai.com`) desde su interfaz de administración,
  o desde la que fije en **Device > Setup > Services > Service Route Configuration**.
* Para syslog, una máquina Linux con Docker en la red del firewall, donde corre el colector de SecureAI. Con HTTP
  log forwarding no hace falta.
* Del equipo de SecureAI: el id y el token de la fuente de logs, y el id y el token de los dos feeds (`panos-url` y
  `panos-domain`). Guarde los tokens en su gestor de secretos.

## 1. Mandar los logs a SecureAI

Elija una de las dos vías.

### Opción A: HTTP log forwarding, sin colector

**Device > Server Profiles > HTTP > Add**. En **Servers**:

| Campo | Valor |
| - | - |
| Address | `<tenant>.hiperai.com` |
| Protocol | HTTPS |
| Port | 443 |
| TLS Version | 1.2 |
| HTTP Method | POST |

En **Payload Format**, configure un formato para **Traffic** y otro para **URL**, cada uno con:

| Campo | Valor |
| - | - |
| URI Format | `/api/network-ingest/<id de la fuente>` |
| Headers | `Content-Type: text/plain` y `Authorization: Bearer <token de la fuente>` |

Payload de **Traffic**:

```json theme={null}
{"type":"$type","subtype":"$subtype","receive_time":"$receive_time","high_res_timestamp":"$high_res_timestamp","serial":"$serial","src":"$src","dst":"$dst","natsrc":"$natsrc","srcuser":"$srcuser","app":"$app","category":"$category","action":"$action","sessionid":"$sessionid","seqno":"$seqno","repeatcnt":"$repeatcnt"}
```

Payload de **URL**: el mismo, con `,"url":"$misc"` antes de la llave final.

![Payload del HTTP server profile](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/http-payload.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=62a736b2f3dd99dd44a84de30b73afcb)

El token viaja en un header, nunca en la URL. Use `text/plain` y no `application/json`: PAN-OS no escapa los valores
que reemplaza (un usuario `ACME\ana` llega con la barra sin escapar, y `$misc` llega con comillas propias), y
SecureAI corrige cada línea al leerla.

PAN-OS valida el certificado del servidor contra sus CA raíz de confianza (**Device > Certificate Management >
Certificates > Default Trusted Certificate Authorities**). El certificado de su tenant es de una CA pública.

### Opción B: syslog al colector

1. Instale el colector de SecureAI: en la consola, **Integraciones > Red / SWG > Palo Alto Networks > Conectar**
   descarga el `.zip` con el id y el token de la fuente. Descomprímalo en un equipo Linux con Docker y corra
   `docker compose up -d`.
2. **Device > Server Profiles > Syslog > Add**: la IP del colector, UDP o TCP 514, formato **BSD**. Con el formato por
   defecto (CSV) no hay nada más que configurar. Si su SIEM ya espera CEF o LEEF, cargue en **Custom Log Format**,
   para **Traffic** y **URL**:

   CEF (Traffic; para URL, agregue ` request=$misc` al final):

   ```
   CEF:0|Palo Alto Networks|PAN-OS|$sender_sw_version|$subtype|$type|1|rt=$cef-formatted-receive_time deviceExternalId=$serial src=$src dst=$dst sourceTranslatedAddress=$natsrc cs1Label=Rule cs1=$rule suser=$srcuser app=$app cn1Label=SessionID cn1=$sessionid cnt=$repeatcnt act=$action cs2Label=URL Category cs2=$category externalId=$seqno
   ```

   LEEF (Traffic; para URL, agregue `|Miscellaneous=$misc` al final):

   ```
   LEEF:1.0|Palo Alto Networks|PAN-OS Syslog Integration|$sender_sw_version|$subtype|cat=$type|devTime=$cef-formatted-receive_time|SerialNumber=$serial|src=$src|dst=$dst|srcPostNAT=$natsrc|usrName=$srcuser|Application=$app|SessionID=$sessionid|RepeatCount=$repeatcnt|action=$action|URLCategory=$category|sequence=$seqno
   ```

PAN-OS manda el syslog desde la interfaz de gestión. Si el colector no es alcanzable desde esa red, agregue una ruta
de servicio: **Device > Setup > Services > Service Route Configuration > Customize**, **Syslog** por una interfaz
interna con IP fija.

El colector manda a SecureAI solo los logs de URL Filtering con destino de IA, y el resto de la navegación no sale
de su red. El log de Traffic no trae el dominio y el colector no lo deja pasar: por syslog, SecureAI ve la IA por el
log de URL Filtering.

### Log Forwarding

**Objects > Log Forwarding > Add**, con dos entradas: **Log Type** `traffic` y `url`, filtro **All Logs**, y el
server profile de la opción A o B. Con HTTP log forwarding puede filtrar en el firewall, por ejemplo
`(category eq artificial-intelligence)` en la entrada `url`.

En cada regla de seguridad que lleva tráfico a internet (**Policies > Security**), en **Actions**, elija el perfil en
**Log Forwarding** y marque **Log at Session End**.

## 2. Registrar la IA en el log de URL Filtering

**Objects > Security Profiles > URL Filtering**: en su perfil, ponga en **Alert** la categoría
`artificial-intelligence`, las `AI-*` (`AI-conversational-assistant`, `AI-code-assistant` y las demás) y
`computer-and-internet-info`. Las categorías en **Allow** no generan log. Asigne el perfil a las reglas de salida a
internet.

`computer-and-internet-info` hace falta por las APIs: PAN-DB clasifica ahí la mayoría de los endpoints de inferencia,
como `api.anthropic.com`, `generativelanguage.googleapis.com` (Gemini) y Azure OpenAI. Sin Alert en esa categoría, el
uso de un modelo desde un script o una herramienta de desarrollo no deja log. El colector reenvía solo los dominios
de IA: el resto de esos logs no sale de su red.

![Perfil de URL Filtering](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/url-filtering.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=afcc49a94abf83eadfc734ed9db1c24e)

## 3. Bloquear con las EDL de SecureAI

### Las dos EDL

**Objects > External Dynamic Lists > Add**:

| Campo | EDL de URL | EDL de dominio |
| - | - | - |
| Type | URL List | Domain List |
| Source | `https://<tenant>.hiperai.com/api/network-feeds/<id del feed panos-url>` | `https://<tenant>.hiperai.com/api/network-feeds/<id del feed panos-domain>` |
| Server Authentication | El certificate profile `secureai` (ver abajo) | El mismo |
| Client Authentication | Usuario: cualquiera, por ejemplo `feed`. Contraseña: el token del feed | Usuario `feed` y el token del otro feed |
| Automatically expand to include subdomains | | Activado |
| Check for updates | Five Minute | Five Minute |

![External Dynamic List de tipo URL](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/edl-url.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=b9c186e7d0fd0405c05714fcb0d4c8f5)

PAN-OS acepta usuario y contraseña en una EDL solo con un certificate profile, o sea con una fuente HTTPS. El token
viaja como contraseña de HTTP Basic, nunca en la URL.

El certificado de su tenant lo emite Google Trust Services o Let's Encrypt, y la CA puede cambiar en una renovación.
Importe las cuatro raíces (**Device > Certificate Management > Certificates > Import**, PEM, sin clave privada) y
póngalas juntas en el certificate profile `secureai`: **GTS Root R1**, **GTS Root R4**, **ISRG Root X1** e **ISRG Root
X2**. Con una sola raíz, el día que cambie la CA las EDL dejan de actualizarse y el firewall se queda con la lista
vieja. Si SecureAI corre en su propio dominio, use la CA raíz de ese certificado.

PAN-OS descarga las EDL desde la interfaz de gestión. Para **Acciones → IP permitida**, use la IP pública con la que
sale esa interfaz, que puede no ser la de las interfaces de datos. Acepta IPv4 e IPv6; si deja el campo vacío, la
descarga cualquiera que tenga el token. **Tokens nuevos** no cambia la IP permitida.

**List Entries And Exceptions** muestra lo que descargó el firewall. SecureAI escribe cada dominio dos veces en la
EDL de URL (`chatgpt.com/` y `*.chatgpt.com/`) y una vez en la de dominio (`chatgpt.com`; la opción de subdominios
cubre el resto). Mientras no haya nada prohibido, las listas están vacías.

![Entradas de la EDL de URL](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/edl-entries.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=ac226c8d9cb8f9dbcec41591952197ad)

Por CLI:

```
set profiles certificate-profile secureai CA [ gts-root-r1 gts-root-r4 isrg-root-x1 isrg-root-x2 ]
set external-list secureai-ia-url type url url https://<tenant>.hiperai.com/api/network-feeds/<id>
set external-list secureai-ia-url type url certificate-profile secureai
set external-list secureai-ia-url type url auth username feed password <token del feed panos-url>
set external-list secureai-ia-url type url recurring five-minute
set external-list secureai-ia-dominios type domain url https://<tenant>.hiperai.com/api/network-feeds/<id>
set external-list secureai-ia-dominios type domain certificate-profile secureai
set external-list secureai-ia-dominios type domain auth username feed password <token del feed panos-domain>
set external-list secureai-ia-dominios type domain recurring five-minute
set external-list secureai-ia-dominios type domain expand-domain yes
```

### Dónde se usan

* **Perfil de URL Filtering**: en el perfil del paso 2, la EDL de URL aparece entre las categorías. Póngala en
  **Block**.

* **Regla de seguridad**: una regla arriba de las de salida a internet, con la EDL de URL en **Service/URL
  Category** y acción **Reset both** o **Deny**. Bloquea aunque la regla de abajo no tenga perfil de URL Filtering.

  ![Regla de seguridad con la EDL como categoría](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/security-rule.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=5bc3a22ca63223b1d8a09031d958f272)

* **Anti-Spyware**: en **Objects > Security Profiles > Anti-Spyware > DNS Policies**, agregue la EDL de dominio con
  acción **Sinkhole**. Asigne el perfil a las reglas por las que pasa el DNS de los equipos.

## 4. Comprobar

1. Desde un equipo detrás del firewall, abra chatgpt.com. En uno o dos minutos el equipo aparece en **Inventario >
   Fuentes de red** de SecureAI.

   ![Fuentes de red con el equipo detectado por el firewall](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/console-network-sources.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=001eb0ae8857b3db222dbca5e2900873)

   En el detalle (**Actions > Ver detalles**), **Conectores** dice `paloalto-panos`.

   ![Detalle de la fuente](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/console-source-detail.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=3f4a29c287d6041182d7884e364d41ea)

2. En la fila del equipo, **Actions > Bloquear**: marque los dominios, la duración y el motivo. **Aplicado vía** tiene
   que decir **Feed de bloqueo para firewalls**.

   ![Bloqueo temporal desde Fuentes de red](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/console-block.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=0d84465af3325faadcb4e67c026185bc)

3. Para no esperar el refresco, en el firewall:

   ```
   request system external-list refresh type url name secureai-ia-url
   request system external-list show type url name secureai-ia-url
   ```

4. El equipo ya no abre chatgpt.com, y el bloqueo vuelve a SecureAI como una llamada bloqueada.

5. **Liberar** en la misma fila saca los dominios de la lista, y el firewall los deja pasar en su refresco siguiente.

Con la EDL en **Five Minute**, el firewall aplica un bloqueo o una liberación en hasta cinco minutos. En nuestras
pruebas, el bloqueo hecho desde la consola llegó al equipo en poco más de un minuto.

### Bloqueo automático

En **Respuesta y auto-bloqueo**, arriba de la lista de Fuentes de red, prenda **Auto-bloquear fuentes que superen
el umbral** y elija el umbral de llamadas (por día o por 7 días), cuánto dura el bloqueo y cuántos bloqueos
automáticos puede haber a la vez. Cuando un equipo pasa el umbral, SecureAI bloquea los dominios de IA que más usa
y los libera al vencer, sin que nadie toque la consola.

![Respuesta y auto-bloqueo con el umbral prendido](https://mintcdn.com/hiper-ai/jV3DiGpzPzQbDW62/img/paloalto/console-auto-block.png?fit=max\&auto=format\&n=jV3DiGpzPzQbDW62\&q=85\&s=b2890b0deab8d6081048097915ff86b9)

## Cuando el feed falla

En las pruebas de laboratorio, con el feed deshabilitado, con un error del servidor de SecureAI y con un token
equivocado, el firewall conservó la última lista que descargó y siguió bloqueando. SecureAI nunca responde una lista
vacía por un error.

Con el token equivocado, la documentación de Palo Alto dice que el firewall deja de aplicar la EDL; en nuestras
pruebas no pasó durante el minuto que lo medimos. Si rota el token de un feed, actualice la EDL en el mismo cambio.
Después de **Tokens nuevos**, el panel avisa en cada EDL y en la fuente de logs hasta que el firewall y el colector
usen los tokens nuevos.

Cuando no queda nada bloqueado, la EDL trae una sola entrada, `secureai-empty.invalid`. PAN-OS no acepta una EDL
vacía (se queda con la anterior y no desbloquearía), y `.invalid` es un dominio reservado que no coincide con ningún
sitio real.

Deshabilitar o borrar un feed no desbloquea nada, y **Desconectar** tampoco: el firewall sigue bloqueando con la
última lista que descargó. Para desbloquear, libere el bloqueo en SecureAI antes de desconectar, o saque las EDL de la
política.

## Panorama

La integración corre en cada firewall, así que con Panorama es la misma: las EDL, el perfil de URL Filtering, el log
forwarding profile y la regla de bloqueo se cargan en un device group (y el server profile en un template) y Panorama
los empuja a los firewalls. Los logs pueden salir de cada firewall o reenviarse desde Panorama a un server profile de
syslog.

## Límites

* **El bloqueo alcanza a toda la red detrás del firewall**: las EDL son listas de dominios, no de usuarios.
* **Los contadores son aproximados.** SecureAI cuenta una vez cada sesión por firewall en cada tipo de log, con
  memoria de 10 minutos.
* **Las IP no se bloquean.** Las EDL de SecureAI son listas de dominios. Una IP que llegó por el log de Traffic
  aparece en la consola pero no entra a la lista.
* **Tope de entradas por modelo**: de 50.000 URLs en VM-50 y PA-220 a 250.000 en PA-5200 y PA-5400
  ([External Dynamic List](https://docs.paloaltonetworks.com/pan-os/11-1/pan-os-admin/policy/use-an-external-dynamic-list-in-policy/external-dynamic-list)).
  La lista de SecureAI tiene decenas o cientos de entradas.
* **Prisma Access**: SecureAI tiene además un conector para Prisma Access que lee Strata Logging. Todavía no se
  validó contra una cuenta real.

## Versiones probadas

| Componente | Versión |
| - | - |
| PAN-OS | 12.2.3, 11.2.15 y 11.1.6-h7 (VM-Series) |
| Formatos de log | Syslog (CEF y LEEF) y HTTP log forwarding |
| Colector | Vector 0.46.1 |


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