"Visión general"
Este libro de jugadas cubre toda la gama de problemas de Seguridad de AI para Aplicaciones en CMA, incluyendo Guardias que no inspeccionan o actúan sobre el tráfico del agente/LLM, integraciones de la Puerta de enlace de AI que no reenvían Eventos, Integraciones de Agente Administrado que fallan al conectar o sincronizar, y Reglas de la Política de implementación de Guardias que no surten efecto como se esperaba.
Los componentes afectados abarcan los Guardias de Seguridad AI (Proxy, API y modo Puerta de enlace AI), las reglas de la Política de implementación de Guardias y sus Perfiles de Motor, integraciones de la Puerta de enlace AI, Integraciones de Agente Administrado y la Licencia subyacente de Seguridad AI para Aplicaciones. Cuando cualquiera de estos falla, los clientes pierden Visibilidad del tráfico del agente/LLM y de la Actividad del agente administrado, la Aplicación de políticas no puede ocurrir, y los objetivos de gobernanza y Cumplimiento no se cumplen.
Síntomas
- Un Guardia muestra cero invocaciones en la CMA a pesar de que la aplicación conectada está enviando tráfico activamente
- Una regla de Política de Guardias está configurada pero nunca coincide, o coincide de manera inconsistente en solicitudes similares
- Una regla de Bloquear o Anonimizar y Bloquear es coincidente, pero la solicitud solo se supervisa, o no se aplica ninguna acción visible
- Una integración de AI Gateway (Portkey, LiteLLM o Kong) está configurada, pero el tráfico enrutado a través de la puerta de enlace nunca aparece como inspeccionado en CMA
- Una integración de Agente Gestionado aparece como desconectada, falla la Prueba de Conexión o falla durante su instalación de script/setup de pila CloudFormation
- Una integración de Agente Gestionado aparece como Activa, pero no aparecen configuraciones de agente o sesiones de agente en CMA
Posibles causas
- Licencia de Seguridad AI para Aplicaciones caducada o no habilitada
- El interruptor global de la Política de Guardias está desactivado en la CMA
- El Guardia está creado pero no está recibiendo tráfico realmente. La aplicación o puerta de enlace no está apuntando al punto de conexión del Guardia (Modo Proxy/API) o la baranda de AI Gateway no está incluida en la configuración de la puerta de enlace.
- Una regla de Política de Interacción de Guardias está deshabilitada, no publicada, o asignada al Perfil de Motor, Dirección (Usuario, Asistente, Entrada de Herramienta, Salida de Herramienta) o Acción incorrectos
- No se ha habilitado una configuración específica de la plataforma requerida para la visibilidad del Agente Gestionado
- La latencia esperada de actualización de datos aún no ha transcurrido.
- El proveedor LLM afectado, la plataforma de agente o el tipo de puerta de enlace no son compatibles actualmente con la integración del Guardia o el Agente Gestionado en cuestión
Evaluación Inicial
Complete estas verificaciones antes de una resolución de problemas más profunda. La mayoría de los problemas se remontan a uno de estos requisitos previos.
Validar Licencia de Seguridad AI
Verifique que la licencia de los Usuarios Finales de Seguridad de IA (esta cubre la Seguridad de IA para Agentes) esté habilitada y no haya expirado. Navegue a CMA > Cuenta > Licencias > Seguridad Premium y confirme que la licencia esté presente, activa y dentro de su período de validez.
{height="" width=""}
Si la licencia está ausente, deshabilitada o expirada, las características de Seguridad AI para Aplicaciones, incluyendo la creación de Guardias, la aplicación de Políticas de Interacción de Guardias, las integraciones de AI Gateway y las Integraciones de Agente Gestionado, no funcionarán independientemente de la configuración. Resuelva cualquier problema de licencia antes de continuar con los pasos en este documento.
Validar Política de Implementación de Guardias Activada
Navegue a CMA > Seguridad AI > Política de Implementación y asegúrese de que el interruptor Política de Implementación Activada esté marcado. Este es un paso simple que es fácil de pasar por alto, y ninguna regla tendrá efecto mientras esté desactivado.
.png?sv=2026-02-06&spr=https&st=2026-11-22T19%3A08%3A32Z&se=2026-11-22T19%3A31%3A32Z&sr=b&sp=r&sig=28g6oHLgGzEyC2mjWdmul3BdGyti%2BVSzLSWLnkZ5RUI%3D)
Validar Despliegue de Guard y Enrutamiento de Tráfico
Un Guard solo inspecciona el tráfico que realmente recibe. Antes de asumir un problema de política o detección, confirme que el Guard esté correctamente en el camino del tráfico.
- Navegue a Seguridad AI > Guards y confirme que el Guard afectado existe y esté configurado con el Tipo correcto (Proxy, API o AI Gateway) para el despliegue en cuestión.
- Generar un mensaje de solicitud del agente interno. El recuento de invocaciones mostrado en CMA debería aumentar con cada solicitud. Si las invocaciones no aumentan, esto indica una posible mala configuración de la aplicación.
.png?sv=2026-02-06&spr=https&st=2026-11-22T19%3A08%3A32Z&se=2026-11-22T19%3A31%3A32Z&sr=b&sp=r&sig=WXBFgaCvj0kG02tadGR64kWYYZDAb7MmMUYWUB%2BxxlA%3D)
- Abra el Guard afectado y navegue a la pestaña de Despliegue. Dependiendo del tipo de Guard, valores específicos de esta pestaña deben estar presentes en la configuración de la aplicación:
- Para todos los tipos de Guard, confirme que la clave API configurada en la aplicación coincida con una clave activa y no revocada mostrada en CMA. Puede regenerar la clave API en CMA si es necesario; esto invalida la clave anterior, por lo que debe actualizar la aplicación inmediatamente después de regenerar.
.png?sv=2026-02-06&spr=https&st=2026-11-22T19%3A08%3A32Z&se=2026-11-22T19%3A31%3A32Z&sr=b&sp=r&sig=CEaE9t4WKM%2FvQJncPJWaEsJi9HxJd7H6Y8nRkJnInf4%3D)
- Para Guards de Proxy y API, confirme que la aplicación esté dirigida a la URL de endpoint del Guard editando el archivo de configuración de la aplicación (por ejemplo, config.py) y añadiendo GUARD_API_KEY, BASE_URL, MODEL_ID, y cuando el guard sea tipo proxy y la clave LLM no haya sido proporcionada en CMA, LLM_PROVIDER_API_KEY.
- Asegúrese de que todos los encabezados de solicitud requeridos, especialmente los marcados con un asterisco (*), estén incluidos en el código del cliente de la aplicación (por ejemplo, client.py). Para obtener más información sobre el despliegue de Guards, consulte Ejemplo de Implementación de Guards para un Chat Bot{target=
_blank} . - Para un Guard de AI Gateway, confirme que la integración de la puerta de enlace correspondiente (Portkey, LiteLLM o Kong) esté configurada para enrutamiento de tráfico a través de Cato. La clave API emitida por Cato y la barrera de seguridad deben añadirse a la propia configuración de la puerta de enlace (por ejemplo, config.yaml para LiteLLM).
- Para todos los tipos de Guard, confirme que la clave API configurada en la aplicación coincida con una clave activa y no revocada mostrada en CMA. Puede regenerar la clave API en CMA si es necesario; esto invalida la clave anterior, por lo que debe actualizar la aplicación inmediatamente después de regenerar.
Validar Conexión de Integración de Agente Gestionado
Las Integraciones de Agentes Gestionados son conexiones de solo lectura con plataformas de agentes de terceros y utilizan un modelo diferente al de los Guards. No hay inspección de tráfico, solo inventario y sondas de sesión.
- Navega a Seguridad AI > Integraciones > Plataforma de Agentes Gestionados y confirma que la integración relevante (Amazon Bedrock, Amazon Quick, Microsoft Foundry, Copilot Studio o Plataforma de Agentes Empresariales Gemini) muestra un estado Activo y que la integración fue completamente configurada.
- Para Amazon Bedrock o Amazon Quick, confirma que la pila de CloudFormation completó la instalación exitosamente en la cuenta correcta de AWS (o, para una implementación multi-cuenta, en la cuenta de gestión de AWS Organizations) y que se cumplieron todos los prerrequisitos{target=
_blank} documentados de AWS. - Para Microsoft Foundry o Copilot Studio, confirma que cada paso de configuración fue completado por el titular del rol correspondiente y que se cumplieron los prerrequisitos{target=
_blank} documentados:- Un administrador de Entra ID (Administrador de Aplicaciones, Administrador de Aplicaciones en la Nube o Administrador Global) concedió consentimiento a nivel de inquilino a la aplicación de Integración de Seguridad AI de Cato Networks a través del enlace de consentimiento administrador de Cato Networks.
- Para Foundry, un Propietario de suscripción o Administrador de Acceso de Usuario asignó el rol de Usuario de Servicios Cognitivos a la aplicación Cato en cada suscripción que contiene recursos de Foundry.
- Para Copilot Studio, un Administrador de la Plataforma Power (o Administrador Global) registró la aplicación Cato como una aplicación de gestión utilizando el script de registro de PowerShell en Azure Cloud Shell, y habilitó Sesiones de Agentes para cada entorno relevante no desarrollado.
- Un administrador de Cato ingresó el Tenant ID de Microsoft Entra ID correcto en el CMA y clicó exitosamente en Probar Conexión antes de guardar. Un ID de inquilino no coincidente es una causa frecuente de fallos en Probar Conexión.
- Para Gemini Enterprise Agent Platform, confirma que el script de configuración de Google Cloud se ejecutó en el proyecto correcto de Google Cloud (ejecutar
gcloud config set project PROJECT_IDsi es necesario), que la identidad que ejecuta el script tenía permiso para habilitar API y crear recursos de IAM/Federación de Identidad de Cargas de Trabajo, y que el token de incorporación no había expirado antes de que se ejecutara el script. Si no se puede verificar la conexión inmediatamente después de ejecutar correctamente un script, espera varios minutos para que los cambios de IAM de Google Cloud se propaguen antes de volver a intentar. - Confirma la sincronización esperada de actualización de datos antes de concluir que una integración está rota:
- Foundry y Copilot Studio obtienen datos inmediatamente en la conexión y luego cada hora.
- La actividad de Bedrock AgentCore depende de la entrega de trazas de CloudWatch de AWS, lo que puede tomar tiempo después de la primera invocación del agente.
Solucionando el Problema
Los pasos para solucionar los síntomas que los administradores o usuarios puedan encontrar se enumeran a continuación. Estos pasos están destinados a identificar posibles causas de los problemas enfrentados.
Solución de problemas de un Guard que no muestra invocaciones
Esto se aplica cuando la página de Guards (Seguridad AI > Guards) muestra cero invocaciones en CMA.
- Confirmar que la licencia de Seguridad de IA para Aplicaciones es válida y que se han generado solicitudes de usuario desde la aplicación afectada.
- Para los guardias proxy, confirmar que el proveedor de IA es compatible con Cato como se documenta en Trabajando con Guardias de Seguridad IA{target=
_blank} . - Navegar a Inicio > Eventos, filtrar por Tipo de Evento = Seguridad de IA y confirmar si se generan eventos relacionados con guardias. Si no llegan, asegúrese de que el guardia haya sido implementado en la configuración de la aplicación, como se explica en Validar Implementación y Enrutamiento del Guard .
.png?sv=2026-02-06&spr=https&st=2026-11-22T19%3A08%3A32Z&se=2026-11-22T19%3A31%3A32Z&sr=b&sp=r&sig=7x%2Bn98io%2BphJmP5uG9Dk%2FuNgliRAfuljVceniE2%2Bq%2B8%3D)
- Verifique la accesibilidad a la API de Seguridad de IA ejecutando curl -v https://api.aisec.catonetworks.com vía CLI. La salida debe mostrar la resolución de FQDN, un handshake TLS exitoso y una respuesta HTTP (usualmente HTTP 404).
- Para confirmar que un guardia específico es accesible y responde, puede ejecutar un comando curl usando el ejemplo de solicitud (incluya una clave de guardia válida) desde Seguridad de IA > Guardias > Implementación. Una respuesta exitosa debe incluir la regla de política de guardia coincidente y la acción que se aplicaría.
.png?sv=2026-02-06&spr=https&st=2026-11-22T19%3A08%3A32Z&se=2026-11-22T19%3A31%3A32Z&sr=b&sp=r&sig=05dfv9nEkO3ExNgyHhs0ls82nFKl48v0xUBGYyRVyKo%3D)
- Si el guardia está correctamente configurado en la aplicación, el guardia es accesible vía curl y no se generan eventos CMA, escale al Soporte de Cato con el tipo/configuración de Guard (Proxy, API, o Gateway de IA), detalles de la aplicación y archivos de configuración (reponga claves API)
Solucionando problemas de Reglas de Política de Guardias que no Surten Efecto
Esto aplica cuando la página de Guardias muestra invocaciones, pero las reglas de política de guardias no ejecutan la acción configurada.
- Navegar a Seguridad de IA > Política de Guardias, confirmar que Política de Guardias Habilitada esté marcada y que la regla afectada esté publicada.
- Confirmar que el Perfil de Motor adjunto a la regla incluye efectivamente el detector esperado para identificar el contenido en cuestión. Puede usar el Patio de Juegos del Motor{target=
_blank} para validar que el contenido del prompt activa el detector dentro del perfil del motor antes de continuar con la resolución de problemas. - Confirmar que la Dirección de la regla coincide con donde el contenido se presenta realmente. Un detector dirigido a la Salida de Herramienta no evaluará una solicitud de dirección de Usuario y viceversa.
- Confirmar que la Acción configurada en la regla sea la acción esperada. Una regla configurada para Anonimizar y Bloquear o Anonimizar y Monitorear aplicará una acción basada en el tipo de contenido detectado dentro del solicitante, como se explica en Acción Inesperada Aplicada por la Política{target=
_blank} . - Si múltiples reglas podrían aplicarse al mismo evento, confirme qué regla realmente se ejecutó revisando el detalle del evento. Las reglas se evalúan de forma independiente y no dependen del orden. Cuando más de una regla coincide, se aplica la acción más estricta. Un evento accionado menos estrictamente de lo esperado usualmente significa que el alcance, el Perfil de Motor o la Dirección de la regla más estricta no coincidían realmente con ese evento.
- Si la regla está activada, correctamente delimitada y el contenido debería coincidir, pero la acción esperada aún no se aplica, escale al Soporte de Cato con la ID del evento, una captura de pantalla de la regla (Perfil de Motor, Dirección, Acción) y el Guard o integración a través de la cual se recibió el tráfico.
Resolución de problemas de configuraciones o sesiones de agente faltantes
Esto se aplica cuando las configuraciones del Agente Gestionado esperadas o las sesiones de agente están faltantes o incompletas en CMA.
- Confirmar que la integración misma se muestra como Activa, ver Validar Conexión de Integración del Agente Gestionado antes de solucionar datos faltantes dentro de ella.
- Permitir el ritmo normal de actualización de la plataforma: al menos un ciclo por hora para Microsoft Foundry y Copilot Studio, y hasta el tiempo necesario para que AWS genere y entregue trazas de CloudWatch para Bedrock AgentCore.
- Validar que Cato admite la visibilidad de sesiones de agente en CMA para la aplicación gestionada afectada, como se documenta en Trabajando con Agentes Gestionados{target=
_blank}. - Para Amazon Bedrock AgentCore, confirmar que Búsqueda de Transacciones CloudWatch está habilitada (AWS Console > Application Signals (APM) > búsqueda de transacciones, con ingesta de spans como registros estructurados). Sin esto, Cato puede mostrar agentes de AgentCore en el inventario, pero nunca su actividad.
- Para Copilot Studio, confirmar que Sesiones de Agente están habilitadas para el entorno específico al que pertenece el agente faltante (Centro de administración de Power Platform > Gestionar > Entornos > [entorno] > Configuración > Producto > Características > agentes de Copilot Studio), y confirmar que el entorno no es un entorno de desarrollador, lo que no es compatible con esta configuración.
- Para Microsoft Foundry, confirmar que la suscripción específica que contiene el recurso de Foundry faltante tiene el rol de Usuario de Servicios Cognitivos asignado a la aplicación de Cato. La asignación de roles no se aplica a nivel de inquilino y debe repetirse por suscripción.
- Para Gemini Enterprise Agent Platform, confirmar expectativas: solo se muestran sesiones de agente y eventos de sesión; el uso de herramientas, integraciones y servicios externos dentro de una sesión no se recopila por diseño.
- Si el intervalo de actualización relevante ha transcurrido y la configuración de trazado/rol/sesión específica de la plataforma están todas confirmadas correctas, escalar al Soporte de Cato con el tipo de integración, la suscripción/entorno/proyecto específico afectado, y los datos esperados versus los observados.
Elevando casos al soporte de Cato
Antes de levantar un caso con Soporte de Cato, asegúrese de que se hayan completado todos los pasos relevantes de solución de problemas mencionados en este manual. Si el problema sigue sin resolverse, escale a Soporte de Cato con la siguiente información:
- Descripción del Problema — Una descripción clara y concisa del síntoma observado y el comportamiento esperado
- Componente Afectado — Nombre del Guard y tipo (Proxy, API o AI Gateway), integración de AI Gateway (Portkey, LiteLLM o Kong), o integración de Agente Gestionado (Amazon Bedrock, Amazon Quick, Microsoft Foundry, Copilot Studio o Gemini Enterprise Agent Platform)
- Detalles del Entorno — Para Guardias: detalles de la aplicación y archivos de configuración (eliminar claves API). Para integraciones de Agente Gestionado: confirmar que los requisitos previos documentados se cumplen y proporcionar cualquier error de configuración observado.
- Detalles de Conexión/Política — Nombre(s) de la regla de Política de Guardias, Perfil del Motor, Dirección y Acción; o el paso específico de configuración de integración completado por última vez y su resultado
- Pasos de Solución de Problemas Completados — Un resumen de los pasos ya tomados de este manual y el resultado de cada uno
- Evidencia de Apoyo — enlaces a eventos de seguridad de AI, capturas de pantalla de la regla o configuración de integración, estado de pila de CloudFormation o mensajes de error de Probar Conexión, y marcas de tiempo exactas (UTC y zona horaria del cliente)
Cuanto más contexto y evidencia se proporcione de antemano, más rápido el Soporte de Cato podrá investigar y resolver el problema.