Una guardia es el punto de aplicación para la Seguridad AI en tus aplicaciones AI personalizadas. Usas guardias para inspeccionar interacciones AI, aplicar acciones de política y obtener visibilidad sobre cómo se utilizan las aplicaciones protegidas. Para más información sobre conceptos de guardias y casos de uso, consulte Trabajando con Guardias de Seguridad AI.
Este artículo explica cómo crear una guardia, usar la clave de autenticación generada para conectarla a tu aplicación AI, y monitorear la actividad de la guardia después de la implementación.
Definiendo una Guardia
Creas y administras guardias desde la página Seguridad AI > Guardias. Esta página lista todas las guardias en tu cuenta e incluye información resumida como el tipo de guardia, ubicación de hospedaje, interacciones AI, cantidad de violaciones y fecha de creación.
Para crear una guardia
Desde el menú de navegación, selecciona Seguridad AI > Guardias, y haz clic en Nuevo.
Introduce el Nombre de la Guardia. Cato recomienda proporcionar un nombre descriptivo para ayudarte a recordar a qué aplicación se aplica la guardia.
Selecciona el Tipo de Guardia:
Proxy: La guardia intercepta solicitudes integradas, y Cato realiza la acción configurada
API: La guardia escanea solicitudes sin interceptarlas, y Cato devuelve el resultado de la detección para que tu aplicación pueda aplicar la acción
Puerta de enlace AI: La guardia se integra con una puerta de enlace AI existente para escanear solicitudes e interceptarlas automáticamente
Si seleccionaste un tipo de guardia proxy, selecciona el Servicio de AI con el cual la guardia interactuará, e introduce la clave API para el servicio.
Haz clic en Validar para asegurarte de que introduciste la clave correcta
Si seleccionaste un tipo de guardia API, determina si alojar la guardia en un Puesto Avanzado.
Haz clic en Guardar.
Implementando la Guardia en tu Aplicación AI
Después de crear una guardia, ábrela desde la página de Guardias para ver los detalles de implementación para tu aplicación. La página de detalles de la guardia proporciona la información que necesitas para conectar el tráfico de tu aplicación a la guardia.
Dependiendo del tipo de guardia y servicio, la página puede incluir:
Detalles del punto final
Encabezados requeridos
Formato del cuerpo de la solicitud
Claves API de la Guardia
La página también incluye código de solicitud de ejemplo que puedes copiar y usar como punto de partida para la integración de tu aplicación.
Usa el fragmento generado para actualizar tu aplicación para que el tráfico se envíe a través de la guardia o sea evaluado por la guardia, basado en el tipo de integración seleccionado.
Monitorizando la Actividad de la Guardia
Después de implementar una guardia, puedes revisar su actividad para entender cómo se utiliza, qué reglas se aplican a ella y si detecta violaciones de política. Si haces clic en una sesión específica, también puedes ver los datos de interacción real que fueron enviados hacia y desde el modelo.
Nota: Ver los datos de la sesión solo es posible si tienes los permisos necesarios para Leer Contenido Sensible. Para más información sobre los roles y permisos, consulte Gestión de Roles de Administrador Usando RBAC.
La página de resumen de la guardia muestra información resumida para la guardia seleccionada, incluyendo Interacciones, Tasa de Violación, Reglas Activas y más.
Puedes usar estos datos para entender con qué frecuencia se utiliza la guardia, qué políticas se aplican activamente a ella y con qué frecuencia las interacciones desencadenan detecciones o violaciones.
Registro de Guardias
La página de Registro de Guardias proporciona visibilidad a nivel de sesión en el tráfico manejado por la guardia. Para cada sesión, puedes revisar campos de resumen como:
ID de Sesión
Invocaciones
Detecciones
Primera Actividad
Última Actividad
Expande una sesión para ver información más detallada, como qué acción se tomó, una marca de tiempo para la sesión y más.
Estos datos te ayudan a investigar la actividad de la guardia con más detalle y verificar que está aplicando la política como se esperaba.