Saltar al contenido principal

Integraciones

Integrations es donde Beak AI Security and Governance se conecta a las plataformas de IA, plataformas de agentes y herramientas de seguridad que su organización ya utiliza. Es un menú de nivel superior dentro de Administration; antes de esta versión, los mismos conectores eran una pestaña dentro de Settings, y el enlace anterior sigue funcionando redirigiendo aquí.

Hay trece integraciones disponibles. Cada una se presenta como una tarjeta, y al seleccionar una tarjeta se abre la página de configuración propia de esa integración.

Ver el catálogo requiere integrations:read. Guardar una integración y ejecutar Test connection ambos requieren integrations:update — una prueba escribe el resultado en la configuración almacenada, por lo que no es una lectura. Desactivar una requiere integrations:delete.

Las dos integraciones que preceden a ese permiso — la detección de amenazas de Copilot Studio y los hooks de inferencia de Anthropic — están gobernadas por settings:read y settings:update en su lugar. Sus tarjetas están ocultas para un usuario que no posee ninguno de los dos, y el menú Integrations aparece para un usuario que posee cualquiera de integrations:read o settings:read, de modo que un administrador que solo puede configurar esas dos todavía tiene un camino para acceder a ellas.

Encontrar una integración​

El catálogo puede agruparse de dos maneras, usando el control By type / By vendor encima de las tarjetas. El agrupamiento solo cambia cómo se organizan las mismas trece tarjetas — nada se añade ni se oculta al cambiar.

  • By type (el predeterminado) agrupa por lo que hace la integración: AI Platforms, Agent Platforms, Security Operations, Data Governance y Notifications. Use esto cuando conozca el resultado que desea — por ejemplo, reenviar bloqueos a un SIEM — pero no qué producto lo proporciona.
  • By vendor agrupa por quién lo proporciona: Anthropic, Microsoft, Amazon, Salesforce, OpenAI y A2A. Use esto para ver todo lo que hace Beak con la pila de un proveedor. A2A es un protocolo abierto y no una empresa; aparece como proveedor porque el proveedor es el eje de agrupamiento y necesita un lugar donde encontrarse.

Search integrations… filtra las tarjetas mientras escribe, y coincide con el nombre de la integración, su proveedor, su grupo y la descripción en la tarjeta — por lo que buscar audit encuentra Microsoft Sentinel sin saber que Sentinel es la respuesta.

Qué significa el estado en una tarjeta​

Cada tarjeta lleva como máximo una etiqueta de estado:

  • Connected — se ha almacenado una credencial y la integración está activada. Está enviando, sincronizando o aceptando llamadas.
  • Disabled — se ha almacenado una credencial pero la integración está desactivada. Nada se envía. Este es el estado que se debe buscar cuando una integración que antes funcionaba ha dejado de hacerlo.
  • Not connected — no se ha configurado nada.
  • Sin etiqueta — el estado no se pudo leer. Es posible que su cuenta no pueda leer la configuración de esa integración, o que la solicitud haya fallado. La tarjeta deliberadamente no muestra nada en lugar de reportar "not connected", lo cual sería una afirmación segura y posiblemente incorrecta sobre una integración activa.

AI Platforms​

Anthropic Inference Hooks​

Conecta Beak a una organización Claude Enterprise. Una vez configurado, Anthropic envía cada prompt de la organización a Beak para una decisión de permitir o denegar antes de que Claude lo vea. Seleccionar Create configuration genera la URL del endpoint que se pega en la consola de administración de Anthropic.

  • Endpoint URL — La dirección a la que Anthropic realiza la entrega. Cópiela con el botón adyacente y péguela sin volver a escribirla; el host, el prefijo /api y el segmento final son todos parte de la ruta. El segmento final es único para el tenant y es efectivamente una credencial, así que trate la URL completa como información sensible.
  • Signing secret — Anthropic lo revela una vez, cuando el endpoint se guarda por primera vez. Beak lo cifra en reposo y nunca lo vuelve a mostrar; el campo muestra Stored o Not set en lugar del valor. Pegar un nuevo valor rota el secreto, y el anterior sigue siendo válido brevemente para que las solicitudes en curso puedan verificarse — la tarjeta muestra el tiempo exacto de expiración mientras esa ventana está abierta.
  • Policy applied to Claude prompts — Selecciona qué política evalúa estos prompts. El predeterminado, All organization-wide policies (default), aplica todas las políticas activas que cubren el tráfico de API. Elegir una sola política restringe la evaluación a esa. Solo se listan las políticas de tipo api_guardrail o hybrid, porque el motor de reglas no considera ninguna otra en esta superficie.
  • If a policy says redact — Los hooks de inferencia no pueden devolver un prompt modificado, por lo que una política de redacción no tiene un equivalente exacto aquí. Deny the request (el predeterminado) lo bloquea; Allow it through unredacted permite que el prompt original llegue a Claude sin que se elimine nada, mientras que la política sigue registrándose como activada.
  • Enabled — Detiene o reanuda la evaluación sin eliminar la configuración.
  • Rotate endpoint URL — Genera un nuevo slug. No hay superposición: la URL anterior deja de resolverse inmediatamente, por lo que la consola de Anthropic debe actualizarse de inmediato.

Nota: Las políticas con alcance a usuarios individuales o grupos nunca se aplican a los prompts de Claude. Anthropic identifica a la persona que escribió el prompt, pero Beak aún no la resuelve como un usuario de Beak, por lo que solo se evalúan las políticas de toda la organización en esta superficie.

Nota: Si la política seleccionada se renombra, elimina o desactiva posteriormente, ninguna política coincide y se permite cada prompt. El campo reporta este estado como no longer available con una advertencia de que nada está siendo aplicado — seleccione una política nuevamente para restaurar la aplicación.

Agent Platforms​

Microsoft Copilot Studio​

Las llamadas de seguridad externas de Copilot Studio invocan a Beak cuando un agente está a punto de ejecutar una herramienta. Beak verifica qué agente está llamando y evalúa los argumentos de la herramienta contra la política. Esta dirección es entrante: Copilot Studio llama a Beak, y Beak no puede listar agentes a través de ella. El detalle completo de configuración está en Copilot Studio Configuration.

Power Platform​

Enumera los agentes de Copilot Studio que existen en los entornos de Power Platform que usted indique, para que aparezcan en el Agent Registry antes de que ninguno de ellos haya llamado a Beak. Esta dirección es saliente: Beak llama a Microsoft.

Campos de configuración: Client ID (Entra App) (requerido), Tenant ID (Entra Directory) (requerido), Power Platform environment IDs (requerido — separados por comas), y API base URL override (opcional, para endpoints de nube soberana). Campo secreto: Client Secret. La aplicación Entra necesita permiso para leer bots en cada entorno que indique.

Nota: Power Platform y la detección de amenazas de Copilot Studio no son la misma integración y ninguna reemplaza a la otra. La detección de amenazas es entrante y aplica; Power Platform es saliente y descubre. Configure la detección de amenazas para aplicar, y Power Platform para ver agentes que nunca han llamado. Test connection lista bots en cada entorno que indicó en lugar de solo intercambiar un token, porque una aplicación puede obtener un token de Power Platform y aun así ser rechazada por cada entorno.

Nota: Se requiere al menos un ID de entorno. Power Platform no tiene una llamada utilizable de "listar todos los entornos", por lo que el descubrimiento cubre exactamente los entornos que usted indique — configurar ninguno reportaría éxito sin enumerar nada.

Microsoft Agent 365​

Contiene la aplicación Entra que Beak utiliza para sincronizar el inventario de agentes de Agent 365 y para escribir su veredicto de gobernanza de vuelta en el objeto de directorio de cada agente. El inventario en sí, los permisos de escritura y la auditoría de escritura de propiedades se encuentran en la página Microsoft Agent 365; esta tarjeta contiene solo la credencial y la configuración de sincronización.

Amazon Bedrock​

Enumera los agentes de Bedrock que existen en una región de AWS, para que aparezcan en el Agent Registry antes de que ninguno de ellos haya llamado a Beak. Esta dirección es saliente: Beak llama a AWS.

Campos de configuración: AWS region (requerido), Access key ID (requerido), y Session token (opcional). Campo secreto: Secret access key. El principal de IAM necesita bedrock:ListAgents y bedrock:GetAgent.

Nota: Un Session token es solo para credenciales temporales de STS. El descubrimiento deja de funcionar cuando el token expira, sin previo aviso — use un principal de larga duración a menos que tenga la intención de volver a ingresar la credencial.

Salesforce Agentforce​

Enumera los agentes de Agentforce en una organización de Salesforce. Esta dirección es saliente: Beak llama a Salesforce.

Campos de configuración: Instance URL (requerido) y Consumer key (connected app) (requerido). Campo secreto: Consumer secret. La aplicación conectada necesita el alcance api.

OpenAI Assistants​

Enumera los asistentes en una cuenta de OpenAI. Esta dirección es saliente: Beak llama a OpenAI.

Campos de configuración: Organization ID y Project ID, ambos opcionales — proporcione la organización solo cuando la clave pueda ver más de una. Campo secreto: API key.

A2A​

Lee la tarjeta Agent2Agent publicada por cada agente cuya URL base usted indique, independientemente de quién lo haya creado. Esta dirección es saliente: Beak llama a cada agente.

Campos de configuración: Agent base URLs (requerido — separadas por comas). Campo secreto: Bearer token, opcional — esta es la única integración en el catálogo que se guarda sin un secreto, porque una tarjeta de agente A2A puede servirse sin autenticación.

Nota: Se requiere al menos una URL. A2A no tiene un registro que consultar, por lo que el descubrimiento cubre exactamente los agentes que usted indique. Beak agrega la ruta de la tarjeta de agente conocida a cada URL, así que ingrese la URL base del agente y no la ruta de la tarjeta en sí.

Nota: Una tarjeta inaccesible no descarta las demás — los agentes cuyas tarjetas se leyeron llegan igualmente. Si ninguna tarjeta pudo recuperarse, Test connection reporta un error en lugar de "no agents found", porque "no se pudo consultar" y "no se encontró nada" no deben interpretarse como el mismo resultado.

Qué proporciona y qué no proporciona el descubrimiento​

Las cinco integraciones salientes anteriores — Power Platform, Bedrock, Agentforce, OpenAI Assistants y A2A — responden todas a una misma pregunta: ¿qué agentes existen? Ninguna de ellas pone a Beak en la ruta de llamada de un agente.

Por lo tanto, cada agente que encuentran llega como un candidato, no como inventario gobernado:

  • Su estado de gobernanza es discovered, y su cobertura es observed.
  • Su nivel de gobernanza es registered — solo inventario e identidad. Sin autorización de herramientas, sin inspección de prompts ni completaciones, sin atribución de costos.
  • Nada se aplica para él hasta que lo incorpore. Consulte Governing an Agent from Any Platform.

Advertencia: Que una plataforma reporte un agente como proxied no significa que Beak intermedie sus llamadas. Varias de estas plataformas describen sus agentes de esa manera por defecto, y Beak lo ignora deliberadamente: un nivel se declara desde la fuente, nunca se infiere de cómo un proveedor describe sus propios agentes. Un agente que aparece en esta lista es evidencia de que existe, y nada más.

Security Operations​

Microsoft Defender XDR​

Replica eventos de bloqueo de DLP de endpoint en Defender como alertas personalizadas. Requiere un registro de aplicación Entra con SecurityAlert.ReadWrite.All concedido.

Campos de configuración: Client ID (Entra App) (requerido), Tenant ID (Entra Directory) (requerido), Portal URL (opcional — incluido como alertWebUrl para que los analistas puedan crear un enlace profundo de vuelta a Beak), y Alert URL override (opcional — para endpoints de nube soberana). Campo secreto: Client Secret.

Microsoft Sentinel​

Reenvía por lotes cada auditoría de moderación a un Data Collection Endpoint y una Data Collection Rule, escribiendo en una tabla personalizada de Log Analytics.

Campos de configuración: Client ID (requerido), Tenant ID (requerido), DCE URI (requerido), DCR Immutable ID (requerido), Stream name (opcional, predeterminado a Custom-BeakModerationAudit_CL), y API version (opcional). Campo secreto: Client Secret.

Defender for Cloud Apps​

Envía resúmenes diarios de uso de sitios de IA para que los paneles de shadow AI en Microsoft Defender for Cloud Apps (MCAS) reflejen la actividad a nivel de endpoint.

Campos de configuración: Portal URL (requerido) y Activities path (opcional). Campo secreto: API Token.

Data Governance​

Microsoft Purview​

Extrae etiquetas de sensibilidad en Beak mediante una sincronización nocturna para que los administradores puedan referenciar las clasificaciones de Purview al crear políticas de DLP de endpoint.

Campos de configuración: Client ID (requerido), Tenant ID (requerido), y List URL override (opcional — para endpoints de nube soberana). Campo secreto: Client Secret.

Notifications​

Microsoft Teams​

Publica una tarjeta adaptable en el webhook de un canal ante cada evento de bloqueo. Admite un campo Minimum severity para filtrar eventos de bajo ruido (low, medium, high o critical). Campo secreto: Incoming Webhook URL.

Guardar, probar y desactivar​

Cada integración configurada a través de un formulario de credenciales comparte las mismas tres acciones y el mismo manejo de secretos.

  • Save — Persiste los campos de configuración y, cuando se proporciona, actualiza el secreto. Los campos requeridos se validan antes del envío. El campo secreto es de solo escritura: déjelo en blanco para mantener el valor almacenado.
  • Test connection — Verifica que las credenciales guardadas puedan alcanzar el servicio externo. El resultado — éxito con el tiempo transcurrido, o error con un mensaje de error — aparece debajo de la tarjeta, y la marca de tiempo y el resultado de la última prueba se muestran en el pie de la tarjeta.
  • Disable — Detiene el pipeline de envío sin eliminar la configuración. La credencial almacenada se conserva, la tarjeta muestra Disabled, y al guardar nuevamente se reactiva.

Los secretos se cifran en reposo y nunca son devueltos por la API.

Dónde aparecen los datos de una integración​

Configurar una integración no crea un lugar donde verla. Cada una alimenta una pantalla existente, vinculada desde la esquina superior derecha de su página de configuración:

IntegraciónDónde es visible su efecto
Anthropic Inference HooksIncidents — prompts permitidos o denegados
Microsoft Copilot StudioIncidents, Agent Registry
Power PlatformAgent Registry — candidatos descubiertos
Microsoft Agent 365Microsoft Agent 365
Amazon BedrockAgent Registry — candidatos descubiertos
Salesforce AgentforceAgent Registry — candidatos descubiertos
OpenAI AssistantsAgent Registry — candidatos descubiertos
A2AAgent Registry — candidatos descubiertos
Microsoft Defender XDRIncidents — la sección External systems de un incidente
Microsoft SentinelRegistro de Auditoria, y la consulta KQL en un incidente
Defender for Cloud AppsShadow AI
Microsoft PurviewPolicies — etiquetas disponibles para las reglas de DLP de endpoint
Microsoft TeamsEstado de entrega en un incidente

Buenas prácticas​

  • Agrupe por tipo cuando conozca el resultado, por proveedor cuando conozca la pila. Los dos agrupamientos responden preguntas diferentes. "Cómo envío los bloqueos a mi SIEM" es una pregunta de tipo y aterriza en Security Operations sin conocer que la respuesta es Sentinel; "qué hace Beak con Microsoft" es una pregunta de proveedor.
  • Lea Disabled como un hallazgo activo, no como un estado de reposo. Una credencial almacenada con la integración desactivada no envía nada. Si algo que antes llegaba a su SIEM ha dejado de hacerlo, este es el primer estado de tarjeta que debe buscar — es distinto de Not connected exactamente por esa razón.
  • No interprete un estado ausente como Not connected. Una tarjeta sin etiqueta de estado significa que el estado no se pudo leer, ya sea porque su cuenta no puede leer la configuración de esa integración o porque la solicitud falló. No se puede concluir nada sobre la integración a partir de ello.
  • Ejecute Test connection después de cada cambio de credencial, y lea qué fue lo que se probó. Una prueba no es una formalidad: para Power Platform lista bots en cada entorno que indicó, porque una aplicación puede obtener un token y aun así ser rechazada por cada entorno. Un intercambio de token exitoso por sí solo no probaría nada.
  • Configure la detección de amenazas de Copilot Studio y Power Platform por separado. Ambos mencionan Copilot Studio y ninguno reemplaza al otro — uno es entrante y aplica, el otro es saliente y descubre. Configurar solo el primero deja invisibles a los agentes que nunca han llamado a Beak.
  • Deje el campo secreto en blanco al editar cualquier otra cosa. Cada campo secreto es de solo escritura; dejarlo en blanco conserva el valor almacenado. Volver a escribir un secreto que no está rotando deliberadamente es como se rompe una integración que funcionaba durante una edición no relacionada.
  • Verifique dónde aterrizan los datos antes de asumir que una integración no hace nada. Configurar un conector no crea una nueva pantalla — cada uno alimenta una página existente, listada en la tabla anterior.

Páginas relacionadas​