- Qué hace
- Cuándo usarla
- Cómo activarla
- Cómo se usa
- Configuración y controles
- Detrás de escena
- Límites
- Si algo no funciona
Qué hace
General Settings › Integrations conecta Threats con Microsoft Defender y tus herramientas. En Microsoft 365 conecta Microsoft Defender para enviar a Microsoft, para su análisis, los correos reportados por tus usuarios, y para permitir que LibraCyber bloquee remitentes en tu tenant de Microsoft 365. En cualquier plataforma de correo puede llamar a tu sistema cada vez que un usuario reporta un correo y remite a la Public API que lee tus amenazas.
Los administradores la configuran una sola vez, con ayuda de tu administrador de Microsoft 365 para las partes de Microsoft. Los usuarios finales nunca la ven.
General Settings › Integrations en una empresa Microsoft 365: las tres pestañas, con ambos consentimientos de Microsoft concedidos. ① API and Webhooks ② Microsoft Defender ③ Defender Block Senders · 2026-11
Cuándo usarla
- Bloquear remitentes de phishing en Microsoft 365, no solo en la consola. Activa Defender Block Senders: una política Block configurada en Threats se escribe en la lista de bloqueo de tu Microsoft Defender.
- Hacer que Microsoft Defender analice lo que reportan los usuarios y comunicarle el resultado de tu equipo. La pestaña Microsoft Defender sirve para enviar a Microsoft los correos reportados por los usuarios, seguidos de cada resultado que des en Threats. Está disponible bajo solicitud: pregunta al soporte de LibraCyber si puede activarse para tu empresa.
- Abrir un ticket en tu SOC, SIEM o herramienta de tickets cuando un usuario reporta un correo. Configura un webhook: tu sistema recibe una llamada en segundos tras el reporte, luego lee los detalles a través de la Public API.
- Crear tus propios informes sobre los correos reportados. Consulta tus amenazas, sus resultados y su análisis por IA a través de la Public API.
No sirve para: decidir qué remitentes están bloqueados o permitidos: eso es Threats › Sender policies. Elegir quién recibe el correo de aviso sobre amenazas: eso es Threats › Setup. El acceso a Microsoft 365 de Smart Banners: consulta Setup › ¿Cómo compruebo que se concedió el acceso?
Cómo activarla
Cada integración se activa por separado, en General Settings › Integrations. Microsoft Defender y Defender Block Senders solo aparecen para empresas con Microsoft 365. API and Webhooks aparece para todas las empresas.
Requisitos previos
- En la consola: un administrador con ambos permisos General Settings y Threats (General Settings › Admins). Sin Threats, las pestañas muestran errores en vez de la configuración.
- Para el envío a Microsoft Defender: está disponible bajo solicitud. Pregunta al soporte de LibraCyber si puede activarse para tu empresa.
- Para los dos consentimientos de Microsoft: una cuenta de Microsoft Global Administrator, para aceptar los permisos requeridos por LibraCyber.
- Para Defender Block Senders: una persona con el rol de Global Administrator o Exchange Administrator de Microsoft 365, para ejecutar un paso en PowerShell en Azure Cloud Shell, desde el portal de Azure. También funciona un ordenador con PowerShell 5.1 o superior.
- Para el webhook: una dirección de tu parte que acepte llamadas desde internet.
¿Cómo envío los correos reportados a Microsoft Defender?
Pide al soporte de LibraCyber si el envío puede activarse para tu empresa. Una vez activado, concede el consentimiento en la pestaña Microsoft Defender: el interruptor Office Defender Submission se activa solo.
Hasta que LibraCyber lo haya activado para tu empresa, la pestaña puede estar activa pero no se envía ningún correo a Microsoft.
- Pide al soporte de LibraCyber si el envío puede activarse para tu empresa y espera su confirmación.
- Abre General Settings y selecciona la pestaña Integrations. → La pestaña Microsoft Defender dice Allow LibraCyber to submit threats to Microsoft Defender. y muestra Not granted yet.
- Selecciona Grant Threat Submission to Microsoft Defender Consent to LibraCyber. → Se abre Warning: Granting Consent: You must use a Microsoft Global admin account to grant consent to LibraCyber.
- Selecciona Grant Consent, inicia sesión con una cuenta de Microsoft Global admin y acepta los permisos. → Una nueva pestaña dice Consent successfully granted. You can close this window.
- Cierra esa pestaña y recarga la pestaña Integrations. → La pestaña muestra Already granted y Office Defender Submission is enabled.
La pestaña Microsoft Defender tras el consentimiento: Already granted, envío activo. ① Already granted ② el interruptor · 2026-11
Si gestionas la empresa desde una cuenta de partner o de grupo, la ventana no tiene el botón Grant Consent: selecciona Copy link y envía el enlace al Global admin de Microsoft de la empresa.
Cómo desactivarlo: desactiva Office Defender Submission. Los nuevos reportes ya no se envían y los resultados ya no se comunican a Microsoft. Los correos ya enviados permanecen en Microsoft Defender. Puedes volver a activarlo en cualquier momento. El consentimiento sigue concedido: para retirarlo, elimina la aplicación Threats Submission desde Enterprise applications en el Microsoft Entra admin center. Después, la consola sigue mostrando Already granted.
La aplicación de envío de LibraCyber en el Microsoft Entra admin center: Enterprise applications › Threats Submission › Permissions. ① la aplicación a eliminar ② su único permiso, threat submissions · 2026-04
¿Cómo permito que LibraCyber bloquee remitentes en Microsoft Defender?
Cuatro pasos, en la pestaña Defender Block Senders: concede el consentimiento, haz que tu equipo de IT ejecute el módulo PowerShell, activa Automatic Sender Blocking y espera a que la pestaña confirme los permisos. Desde ese momento, cada política Block en Threats se escribe en la Tenant Allow/Block List de tu Microsoft Defender.
- En General Settings › Integrations, selecciona Grant Defender Block Senders Consent to LibraCyber, luego Grant Consent, y acepta los permisos con una cuenta de Microsoft Global admin. → La nueva pestaña dice Consent successfully granted. You can close this window.
- Recarga la pestaña Integrations. → La pestaña muestra Already granted, las instrucciones de PowerShell y el interruptor Automatic Sender Blocking, desactivado.
- En el portal de Azure abre Enterprise applications, busca Mantra Block Threats y abre Mantra Block Threats (production), la aplicación de bloqueo de remitentes de LibraCyber. Copia su Object ID. El enlace ScribeHow Documentation en la pestaña muestra estos pasos con imágenes.
- Pégalo en Application Object ID. → El comando en el recuadro gris ahora lo contiene. El App ID de LibraCyber y tu tenant ya están rellenados.
La pestaña Defender Block Senders configurada: Application Object ID rellenado, los dos comandos, bloqueo activado y permisos verificados. ① Application Object ID ② los comandos a ejecutar ③ el interruptor · 2026-11
- Tu administrador de Microsoft 365 accede al portal de Azure y abre Cloud Shell en PowerShell. Pega la primera línea del recuadro gris, que instala el módulo MantraBlockSenders. Luego pega el resto, que empieza con Connect-MantraBlockSenders, y accede con el mismo administrador cuando Microsoft lo solicite. → PowerShell ejecuta cinco pasos, desde [1/5] Checking Exchange module... hasta [5/5] Assigning permissions....
PowerShell en Azure Cloud Shell ejecutando el módulo: Mantra Threats Block - Configuration, pasos del 1 al 5. ① los cinco pasos · 2026-10
- Para verificar la conexión, escribe Test-MantraBlockSendersConnection. → Muestra Exchange Online connection: OK. Esto comprueba la conexión del propio administrador a Exchange Online; es la pestaña la que confirma que LibraCyber puede bloquear (siguiente acción).
- De nuevo en la pestaña, activa Automatic Sender Blocking. → Aparece Automatic sender blocking enabled y el texto bajo el interruptor dice Senders and domains can be blocked in Defender directly from the console. La pestaña muestra luego Starting the verification of your Microsoft 365 tenant...
- Espera la verificación. → La pestaña muestra Verifying the permissions in your Microsoft 365 tenant. This can take up to 2 hours after running the PowerShell module., luego Permissions verified: blocked senders are synchronized with Microsoft Defender. Mientras tanto puedes salir de la página.
Si la pestaña muestra LibraCyber cannot manage blocked senders in your tenant, el paso de PowerShell falta o está incompleto: ejecútalo de nuevo (paso 5), luego desactiva y vuelve a activar Automatic Sender Blocking para repetir la comprobación.
Si el comando muestra yourtenant.onmicrosoft.com, sustitúyelo por el dominio onmicrosoft.com de tu tenant o por su ID: el módulo no acepta otro valor.
Los bloqueos configurados antes de que aparezca Permissions verified se conservan y se envían una vez verificados los permisos. Si la verificación falla, LibraCyber lo comprueba de nuevo aproximadamente una vez al día: para comprobarlo al momento, desactiva y vuelve a activar Automatic Sender Blocking.
Qué concede el paso de PowerShell. Registra en Exchange Online la aplicación de bloqueo de remitentes de LibraCyber y le asigna un solo rol, Tenant AllowBlockList Manager, en un grupo de roles creado para ella. Ese rol solo gestiona la Tenant Allow/Block List: LibraCyber no puede leer ni modificar los buzones con ese permiso.
Cómo desactivarlo: desactiva Automatic Sender Blocking. Los bloqueos y desbloqueos hechos en Threats ya no llegan a Microsoft Defender y el control horario se detiene. Los remitentes ya bloqueados permanecen en Microsoft Defender: elimínalos desde allí si quieres quitarlos. Para retirar también los permisos, elimina Mantra Block Threats (production) en el portal de Azure, en Enterprise applications: esto elimina todos los permisos de LibraCyber. El grupo de roles creado por el módulo permanece en el Exchange admin center, sin uso: puedes eliminarlo también desde allí.
¿Cómo configuro un webhook?
Escribe tu dirección en Webhook URL en la pestaña API and Webhooks: se guarda automáticamente, para el evento Threat reported.
- En General Settings › Integrations, busca la sección Webhooks de la pestaña API and Webhooks.
- Escribe la dirección de tu endpoint en Webhook URL, por ejemplo
https://soc.example.com/threats-hook. → Un segundo después de dejar de escribir, aparece Webhook saved.La pestaña API and Webhooks con una dirección webhook guardada, evento Threat reported y el mensaje Webhook saved. ① Public API ② Webhook URL ③ Events · 2026-11
- Deja Events en Threat reported, el único evento.
La dirección debe empezar por http:// o https:// y apuntar a un servidor público. Las direcciones locales y privadas se rechazan, con el motivo en el mensaje. Cada empresa tiene una sola dirección webhook.
Cómo desactivarlo: vacía Webhook URL. → Aparece Webhook saved y las llamadas se detienen.
Cómo se usa
General Settings › Integrations. Una vez configuradas, las integraciones funcionan solas: esta sección explica qué envía cada una y cómo comprobarlo.
¿Qué recibe Microsoft Defender y qué pasa con su resultado?
Microsoft Defender recibe cada correo enviado como posible phishing, luego el resultado que das en Threats. El resultado de Microsoft no se muestra en la consola.
- Qué se envía: el correo electrónico completo reportado, para la bandeja del usuario que lo reportó, pocos segundos después del reporte. El envío no bloquea ni elimina nada en la bandeja de entrada.
- Qué no se envía: las alertas de Smart Banners, el mismo correo reportado nuevamente desde la misma bandeja y los correos de simulaciones de phishing.
- Tu resultado: cuando un administrador resuelve un correo enviado en Threats › Threats, Microsoft es informado: Safe como no spam, Spam como correo no deseado, Suspicious y Unsafe como phishing. Cambiar el resultado después envía el nuevo.
- El resultado de Microsoft: LibraCyber lo recoge, pero no lo muestra ni en la consola, ni en la exportación, ni en la Public API.
¿Cómo verifico que el bloqueo llegue a Microsoft Defender?
Busca el remitente en tu Tenant Allow/Block List: en el portal de Microsoft Defender abre Policies & rules › Threat policies › Tenant Allow/Block Lists, pestaña Domains & addresses.
- Cada remitente o dominio bloqueado desde Threats aparece como bloqueado, sin fecha de expiración y con una nota añadida por LibraCyber.
- Desbloquear en Threats elimina la entrada.
- Microsoft Defender sigue siendo la referencia: aproximadamente una vez por hora LibraCyber lee esta lista y actualiza Threats › Sender policies, incluyendo los remitentes bloqueados directamente en Microsoft Defender. Qué hace un bloqueo y qué cambia este control en la consola está descrito en Sender policies › ¿Qué hace Block en Microsoft 365?
¿Qué envía el webhook?
Una llamada cada vez que un usuario reporta un nuevo correo para Threats. La llamada indica que se ha reportado una amenaza y dónde encontrarla, nunca el contenido del correo.
- La llamada: un POST HTTP con un pequeño cuerpo JSON, enviado pocos segundos después del reporte.
- Qué contiene: el identificador de la amenaza, la fecha y hora del reporte, un enlace a la amenaza en la consola y el evento, threat reported.
- Qué nunca contiene: el remitente, el destinatario, el asunto, el contenido ni los adjuntos. Léelos a través de la Public API, con el identificador de la amenaza.
- Cuándo se envía: por cada nuevo reporte, sea cual sea el canal (reenvío, botón Report de Microsoft, complemento LibraCyber, Report email en un banner). No para alertas de banner, ni para el mismo correo reportado de nuevo desde la misma bandeja, ni para correos de simulaciones de phishing. Dos usuarios que reportan el mismo correo generan dos llamadas.
- Tu respuesta: responde en menos de 10 segundos con un código de éxito (2xx). Si no, la llamada se reintenta una vez de inmediato y luego se descarta: no se vuelve a enviar después.
- El enlace: abre la amenaza en una vista anterior de la lista Threats, no en Threats › Threats. Para trabajar sobre la amenaza, abre Threats › Threats y pega el identificador en el filtro Threat ID.
¿Cómo protejo el webhook?
La llamada no contiene contraseñas, tokens ni firmas, y por eso no incluye nada sensible: trátala solo como una señal. Para verificar que una amenaza es real, léela a través de la Public API con tus credenciales: una amenaza que la API no devuelve no ha sido reportada en tu empresa.
- Usa una dirección
https://, así la llamada va cifrada. - Tu endpoint solo debe aceptar la llamada y leer el identificador.
¿Puedo leer las amenazas a través de una API?
Sí, mediante la Public API, solo lectura. Devuelve las amenazas de tu empresa, sus resultados y su análisis de IA; no puede cambiar un resultado, eliminar una amenaza ni crear una nueva.
- Qué puedes leer: la lista de amenazas, tanto pendientes de resultado como ya resueltas. Para cada amenaza: los encabezados, el cuerpo, la lista de adjuntos y los resultados SPF, DKIM y DMARC, el correo original y el análisis de IA cuando exista.
- Cómo funciona la lista: el reporte más reciente primero, hasta 100 amenazas por página. No hay filtro por fecha: navega por las páginas hasta llegar a una amenaza que ya hayas visto. Lee ambas listas, pendientes y resueltas, para ver todo.
- Credenciales: no se crean en la consola. Solicita al soporte de LibraCyber las credenciales API para tu empresa: solo dan acceso a las amenazas de tu empresa.
- Documentación: el enlace Public API en la pestaña API and Webhooks.
¿Puedo enviar cada reporte a mi SIEM o SOC?
Sí, usando el webhook y la Public API juntos: el webhook avisa a tu sistema de que se ha reportado una amenaza y la API le da los detalles. No existe un conector integrado para un SIEM específico. Otra opción es el correo de alerta sobre amenazas, enviado a tu equipo de seguridad por cada reporte: consulta Threats › Setup.
Configuraciones y controles
Cada configuración se aplica a toda la empresa y la modifica un administrador con permisos de General Settings y Threats.
| Configuración / control | Predeterminado | Efecto | Quién puede modificarla |
|---|---|---|---|
| Grant Threat Submission to Microsoft Defender Consent to LibraCyber (Microsoft 365) | No concedido aún | Da a la aplicación de envío de LibraCyber acceso a tu tenant y activa Office Defender Submission. | Administrador, con una cuenta Microsoft Global admin |
| Office Defender Submission | Activado una vez concedido el consentimiento | Activado: para enviar los nuevos reportes a Microsoft Defender, seguidos de tus resultados, una vez que LibraCyber haya activado el envío para tu empresa. Desactivado: no se envía nada a Microsoft. | Administrador |
| Activación del envío a Microsoft Defender | No activada | Permite que Office Defender Submission envíe correos a Microsoft. No activada: no se envía nada, incluso con el interruptor activado. | Soporte LibraCyber, bajo solicitud |
| Grant Defender Block Senders Consent to LibraCyber (Microsoft 365) | No concedido aún | Da a la aplicación de bloqueo de remitentes de LibraCyber acceso a tu tenant y muestra el paso de PowerShell y el interruptor Automatic Sender Blocking. | Administrador, con una cuenta Microsoft Global admin |
| Application Object ID | Vacío | Completa el comando PowerShell. No se guarda: escríbelo de nuevo si recargas la página. | Administrador |
| Automatic Sender Blocking | Desactivado | Activado: LibraCyber verifica sus permisos en tu tenant y muestra el resultado bajo el interruptor; luego las políticas Block se escriben en la Tenant Allow/Block List de tu Microsoft Defender y Microsoft Defender se revisa cada hora. Desactivado: no se envía nada a Microsoft Defender. | Administrador |
| Webhook URL | Vacío | La dirección a la que se llama por cada nueva amenaza reportada. Vacío: no se realiza ninguna llamada. | Administrador |
| Events | Threat reported | El evento que activa el webhook. Es el único. | Administrador |
| Credenciales Public API | Ninguna | Dan acceso de solo lectura a las amenazas de tu empresa a través de la Public API. | Soporte LibraCyber, bajo solicitud |
Detrás de escena
Cada integración parte de un reporte o de un resultado, nunca de una programación que configures tú.
- Un usuario reporta un correo → el webhook se llama en pocos segundos; en Microsoft 365, el envío a Microsoft Defender también parte del reporte, una vez activado para tu empresa.
- Un administrador da un resultado → se envía a Microsoft Defender, si ese correo fue enviado.
- Un administrador bloquea o desbloquea un remitente → el cambio se envía a tu Tenant Allow/Block List en segundo plano, tan pronto como se guarda.
- Cada hora → LibraCyber lee tu Tenant Allow/Block List y actualiza Threats › Sender policies.
Actualización de datos: el estado de los consentimientos se lee al abrir la pestaña. Tras conceder un consentimiento, recarga la pestaña para ver Already granted.
Microsoft 365 y Google Workspace: en Google Workspace solo se muestra la pestaña API and Webhooks. Los correos reportados no se envían a ningún sitio y Block no está disponible en Sender policies; Allow funciona a través de Smart Banners.
Límites
- Microsoft Defender y Defender Block Senders solo funcionan en Microsoft 365 (al 03/11/2026).
- El envío a Microsoft Defender solo funciona después de que LibraCyber lo haya activado para tu empresa (al 03/11/2026).
- El resultado de Microsoft Defender sobre un correo enviado no se muestra en la consola, en la exportación ni en la Public API (al 03/11/2026).
- Las alertas de banner no se envían ni a Microsoft Defender ni al webhook (al 03/11/2026).
- Solo una dirección de webhook por empresa y solo un evento, Threat reported. No existe un evento cuando una amenaza se resuelve (al 03/11/2026).
- Una llamada de webhook que falla dos veces no se vuelve a enviar y la consola no muestra las llamadas fallidas (al 03/11/2026).
- La Public API es solo de lectura, sin filtro por fecha. Las credenciales API no se gestionan en la consola (al 03/11/2026).
- La eliminación de un consentimiento en Microsoft Entra no se muestra en la consola: sigue mostrando Already granted (al 03/11/2026).
Si algo no funciona
| Síntoma | Causa probable | Qué puedes hacer | Cuándo contactar al soporte |
|---|---|---|---|
| Faltan las pestañas Microsoft Defender y Defender Block Senders | Tu empresa no está configurada en Microsoft 365: estas pestañas solo existen para Microsoft 365. | Verifica en LibraCyber qué plataforma de correo usa tu empresa. | Si tu empresa está en Microsoft 365 y las pestañas siguen sin aparecer. |
| Las pestañas muestran An error occurred o Failed to load… | Tu cuenta de administrador no tiene el permiso Threats. | Pídele a un administrador que te asigne el permiso Threats. | Si los errores persisten teniendo ambos permisos. |
| La pestaña sigue mostrando Not granted yet después de dar el consentimiento | El estado se lee cuando se abre la pestaña. | Recarga la pestaña Integrations. | Si sigue diciendo Not granted yet después de una página de consentimiento exitosa. |
| La ventana de consentimiento no tiene el botón Grant Consent | Gestionas esta empresa desde una cuenta de partner o de grupo. | Selecciona Copy link y envíalo al administrador global de la empresa. | — |
| La página de consentimiento dice The Administrator consent has failed | La cuenta no es un administrador global de Microsoft, se rechazaron los permisos o el enlace ha caducado. | Vuelve a empezar desde la pestaña con una cuenta de administrador global de Microsoft. | Si falla con una cuenta de administrador global. |
| Los correos reportados nunca llegan a Microsoft Defender aunque el interruptor esté activo | El envío no ha sido activado para tu empresa. | Pide al soporte de LibraCyber si puede activarse para tu empresa. | Si ya fue activado y los correos aún no llegan a Microsoft Defender. |
| La pestaña dice LibraCyber cannot manage blocked senders in your tenant | No se realizó el paso de PowerShell, falló, o se usó un Object ID o tenant incorrecto. | Realiza de nuevo el paso de PowerShell, luego desactiva y vuelve a activar Automatic Sender Blocking. | Si el mensaje vuelve después de un paso de PowerShell exitoso: envía al soporte el código de error mostrado. |
| El paso de PowerShell falla con un error de acceso o permisos | La cuenta que inició sesión no es Administrador Global ni Administrador de Exchange. | Hazlo de nuevo, iniciando sesión como Administrador Global o Administrador de Exchange. | Si falla con uno de estos roles: envía al soporte el texto del error. |
| El paso de PowerShell dice You are signed in to another tenant | El administrador inició sesión en un tenant de Microsoft 365 diferente al indicado en el comando. | Ejecuta de nuevo el comando e inicia sesión con una cuenta de administrador de tu tenant. | — |
| El paso de PowerShell dice The Object ID belongs to another application | El Object ID escrito en la pestaña no es el de Mantra Block Threats (production). | Copia el Object ID de Mantra Block Threats (production) desde Enterprise applications, pégalo en la pestaña y luego ejecuta de nuevo el comando. | — |
| El paso de PowerShell dice que el grupo de roles existente does not have the 'Tenant AllowBlockList Manager' role | En tu Exchange Online ya existe un grupo de roles con el mismo nombre, pero sin ese rol. | Agrega el rol a ese grupo de roles, o elimínalo, luego ejecuta de nuevo el comando. | — |
| El paso de PowerShell rechaza la organización | El comando aún contiene yourtenant.onmicrosoft.com. | Sustitúyelo por tu dominio onmicrosoft.com o por el ID del tenant. | — |
| Los bloqueos configurados en Threats nunca aparecen en la Tenant Allow/Block List de Microsoft Defender | Los permisos aún no están verificados: la pestaña no muestra Permissions verified. | Espera a que aparezca Permissions verified, hasta 2 horas. Si la pestaña muestra un error, ejecuta el paso de PowerShell, luego desactiva y vuelve a activar Automatic Sender Blocking. | Si los bloqueos siguen faltando una hora después de Permissions verified. |
| Al guardar el webhook aparece un error | La dirección no es http o https, o apunta a un servidor local o privado. | Usa una dirección pública que empiece con https://. |
— |
| Las llamadas webhook no llegan | Tu endpoint no respondió con un código de éxito en 10 segundos, dos veces. | Asegúrate de que tu endpoint responda en menos de 10 segundos con un código 2xx. | Si tu endpoint estaba activo: envía al soporte la hora del reporte y la dirección. |
| Algunos correos reportados no generan ninguna llamada webhook | Son avisos de banner, correos de simulación, o correos ya reportados desde la misma casilla o ya marcados ahí por un aviso de banner. | No necesitas hacer nada: solo los nuevos reportes de los usuarios activan el webhook. | Si un nuevo reporte de un usuario no generó ninguna llamada. |
| El enlace en una llamada webhook abre una versión anterior de la lista Threats | El enlace apunta a la lista Threats anterior. | Pega el identificador en el filtro Threat ID de Threats › Threats. | — |
| El resultado de Microsoft Defender sobre un correo reportado no aparece en la consola | La consola no lo muestra. | No hay nada que corregir: LibraCyber no muestra el resultado de Microsoft. | — |