Integración de Microsoft Teams

La integración de Microsoft Teams envía notificaciones de Living Security a usuarios y canales mediante la aplicación de Teams de Living Security. Utilícela para asignaciones de capacitación, alertas de riesgo humano, mensajes de implementación y anuncios del equipo de seguridad. Esta integración es solo de notificaciones. Los usuarios no envían comandos al bot en Microsoft Teams. Cuando se instala la aplicación, el bot almacena la referencia de conversación de Teams para futuras notificaciones proactivas. Los mensajes de instalación son unidireccionales y pueden personalizarse o desactivarse según los requisitos de implementación de la empresa.

Un administrador de Microsoft Teams debe cargar, aprobar y distribuir la aplicación de Teams de Living Security. El consentimiento de administrador de Microsoft Entra User.Read.All es opcional y solo habilita la búsqueda alternativa por correo electrónico o nombre principal de usuario (UPN).

Para configurar la entrega de recordatorios y Playbooks, comience en Configuración → Comunicaciones → Canales y haga clic en la tarjeta Microsoft Teams. Esta página describe la configuración de la aplicación de Teams subyacente.

Requisitos previos

Antes de configurar Microsoft Teams, asegúrese de contar con lo siguiente:

Un administrador de Microsoft Teams que pueda cargar y aprobar aplicaciones de la organización. La misma persona puede tener ambos roles de administrador.
Un administrador de Microsoft Entra, solo si desea habilitar la búsqueda alternativa opcional por correo electrónico/UPN con consentimiento de la aplicación User.Read.All para todo el tenant
Privilegios de administrador de Living Security
Una organización activa de Living Security
Los nombres del equipo y del canal donde se deben entregar los anuncios de seguridad, si los anuncios de canal están habilitados
El ID de su tenant de Microsoft Entra, disponible en Microsoft Entra admin center → Identity → Overview

Quién hace qué

Rol	Responsabilidad
Administrador de Living Security	Conecta el tenant de Microsoft, descarga el paquete regional, configura los mensajes de instalación, valida la configuración y envía pruebas
Administrador de Microsoft Teams	Carga y permite la aplicación, la distribuye a los usuarios o grupos previstos y asigna las directivas de configuración de aplicaciones
Administrador de Microsoft Entra, opcional	Otorga el consentimiento de la aplicación `User.Read.All` al ID de aplicación del bot regional cuando se requiere la búsqueda alternativa por correo electrónico/UPN
Propietario de Teams, cuando se usa la entrega por canal	Instala o aprueba la aplicación para el equipo y el canal previstos

Pueden ser personas distintas. Comparta con el administrador de Microsoft Teams la suma de comprobación del paquete, el ID de la aplicación de Teams, el ID de aplicación del bot y la población prevista para la implementación. Comparta la URL de consentimiento generada con un administrador de Microsoft Entra únicamente cuando habilite la búsqueda alternativa opcional por correo electrónico/UPN. No comparta credenciales de Living Security que no estén relacionadas.

Configuración

Abra el panel de configuración de Microsoft Teams

En Living Security, vaya a Configuración → Comunicaciones → Canales y seleccione Microsoft Teams.El panel muestra la región de su organización, el nombre del archivo del paquete, el ID de la aplicación de Teams, el ID de aplicación del bot, la suma de comprobación SHA256, el estado de la configuración del tenant de Microsoft, las instrucciones de instalación, los controles de mensajes de instalación, la validación y las herramientas de notificaciones de prueba.

La región que se muestra en Living Security coincide con la región en la que está alojada su organización.

Conecte su tenant de Microsoft

En Connect your tenant, introduzca el ID del tenant de Microsoft Entra al que pertenecen los usuarios y los canales de Teams que recibirán las notificaciones y, a continuación, haga clic en Save Microsoft tenant. Un tenant de Microsoft solo puede pertenecer a una organización de Living Security.Si el control del tenant no está disponible, comuníquese con el responsable de implementación de Living Security o con su contacto de soporte para conectar o cambiar el tenant antes de instalar la aplicación.

Living Security muestra Microsoft tenant connected antes de que continúe.

Siempre que sea posible, conecte el tenant antes de instalar la aplicación de Teams. Si la aplicación ya está instalada, guarde el tenant y seleccione primero Validate install. Living Security intenta asociar automáticamente la instalación existente; reinstale únicamente si la validación no puede detectarla.

Descargue el paquete regional de Teams

Haga clic en Download Teams package. Living Security proporciona un paquete ZIP específico de la región para su organización.Verifique el archivo descargado con la suma de comprobación SHA256 que se muestra en Living Security antes de cambiar nada. Para asignar a la aplicación su propio nombre e íconos, siga las instrucciones de Personalizar la marca del paquete regional después de esta verificación y antes de cargar el paquete.

La suma de comprobación del archivo descargado coincide con la suma de comprobación SHA256 que se muestra en Living Security.

Cargue e instale el paquete en el centro de administración de Teams

En el centro de administración de Microsoft Teams, vaya a Teams apps → Manage apps → Actions → Upload new app y cargue el archivo ZIP descargado de Living Security.Confirme lo siguiente:

El ID de la aplicación de Teams y el ID de aplicación del bot coinciden con los valores que se muestran en Living Security
El nombre de la aplicación es el nombre regional de Living Security, o el nombre que haya definido si personalizó la marca del paquete
El publicador es Living Security. Personalizar la marca del paquete no cambia el publicador
La aplicación está desbloqueada
La aplicación está disponible para los usuarios o grupos previstos
La aplicación se instala mediante directivas de configuración de aplicaciones o instalación dirigida para los usuarios y equipos/canales que deben recibir las notificaciones

Microsoft puede tardar en propagar los cambios de disponibilidad de la aplicación y de las directivas de configuración.

Si la validación o una prueba fallan inmediatamente después de un cambio en las directivas de la aplicación, confirme la asignación de la directiva en el centro de administración de Microsoft Teams y vuelva a intentarlo cuando Microsoft termine de propagarla.

Instale o abra la aplicación

Distribuya la aplicación personal a los usuarios previstos. Para que Living Security pueda enviar una prueba personal a una instalación detectada, al menos un usuario debe instalar o abrir la aplicación personal de Living Security en Microsoft Teams. Esto permite que el bot capture la identidad de confianza del usuario y la referencia de conversación personal. Una instalación en un canal por sí sola no puede utilizarse para una prueba personal de instalación detectada.Para la entrega por canal, instale la aplicación en el equipo y el canal previstos para que el bot pueda capturar la referencia de conversación de ese canal.

Un usuario de destino ha instalado o abierto la aplicación personal, o la aplicación está instalada en el canal previsto.

Configure los mensajes de instalación

En la sección Install message controls, elija si se envían mensajes de instalación de Teams y personalice el texto unidireccional para su organización.Controles disponibles:

Send install messages
Send personal install messages
Send channel install messages
Default message
Personal message
Channel message

Los campos de mensaje admiten {{installerName}}, que se sustituye por el nombre para mostrar del usuario que instaló la aplicación. Deje en blanco un mensaje personal o de canal para usar el mensaje predeterminado configurado. Si el mensaje predeterminado también está en blanco, Living Security utiliza el mensaje integrado para ese ámbito.

Valide la configuración

Haga clic en Validate install en Living Security. La validación comprueba que el paquete regional esté disponible, que la configuración del tenant de Microsoft exista y sea exclusiva de esta organización de Living Security, que las credenciales del bot regional estén configuradas y que se haya detectado una instalación activa de la aplicación para el tenant conectado.

La validación muestra Validation passed antes de que envíe notificaciones reales.

Envíe notificaciones de prueba

Para la prueba personal predeterminada, haga clic en Send test to detected installation. Living Security selecciona una instalación personal activa detectada y utiliza su identidad de confianza y su referencia de conversación almacenadas. Esta prueba no llama a Microsoft Graph y no requiere el consentimiento de User.Read.All.Si no se detecta ninguna instalación personal, pida a un usuario que instale o abra la aplicación personal de Living Security, seleccione Validate install de nuevo y, a continuación, vuelva a enviar la prueba. Utilice la prueba avanzada dirigida por correo electrónico/UPN solo cuando la búsqueda alternativa opcional esté habilitada.

La notificación de prueba unidireccional aparece en Microsoft Teams.

Revise el intento correspondiente en el Registro de comunicaciones cuando necesite diagnósticos de entrega.

Personalizar la marca del paquete regional

El paquete regional es un archivo ZIP con tres archivos: manifest.json, color.png y outline.png. Puede definir su propio nombre de aplicación e íconos en ese paquete antes de cargarlo. Living Security admite este procedimiento para los paquetes regionales que un administrador de Teams carga directamente. Hágalo después de descargar y verificar el paquete, y antes de cargarlo en el centro de administración de Teams.

Descomprima el paquete

Extraiga el archivo ZIP. Contiene exactamente tres archivos en la raíz del archivo comprimido: manifest.json, color.png y outline.png.

Reemplace los íconos

Reemplace color.png y outline.png por sus propios íconos. Conserve los mismos dos nombres de archivo.

Archivo	Requisito
`color.png`	PNG a todo color, 192 × 192 píxeles, sin transparencia
`outline.png`	PNG transparente, 32 × 32 píxeles

Defina el nombre de su aplicación

En manifest.json, edite estos dos campos:

name.short: el nombre que se muestra en el encabezado de la aplicación de Teams y en otras áreas con espacio limitado. Máximo de 30 caracteres.
name.full: el nombre que se muestra en el catálogo de aplicaciones y en los detalles de la aplicación. Máximo de 100 caracteres.
Si ya hay una aplicación de Living Security cargada en el centro de administración de Teams, defina version con un valor superior a la versión instalada allí. Microsoft Teams rechaza una actualización que no aumente la versión, y una descarga nueva puede tener la misma versión que el paquete que ya instaló, o una inferior.Consulte la versión instalada en el centro de administración de Teams, en Teams apps → Manage apps, en la página de detalles de la aplicación. Compárela con el valor de version en el manifest.json que acaba de descargar y, a continuación, defina un valor superior a ambos. Conserve el formato MAJOR.MINOR.PATCH de tres números.Por ejemplo, si la aplicación instalada es 1.1.1 y su nueva descarga es 1.1.0, defina 1.1.2. Aumentar el 1.1.0 descargado a 1.1.1 repetiría la versión instalada, y Teams rechazaría la carga.

Deje sin cambios los campos de identidad

No modifique estos campos. Cada uno contiene la identidad de la aplicación, del bot o del inicio de sesión único:

id
botId en bots
webApplicationInfo
validDomains
contentUrl y websiteUrl en staticTabs
Un cambio en un campo de identidad puede dejar la aplicación instalable pero incapaz de entregar notificaciones o de completar el inicio de sesión único. Validate install comprueba el tenant, las credenciales del bot y la instalación detectada. No compara su manifiesto con el paquete que creó Living Security.

Vuelva a comprimir los tres archivos

Cree un nuevo archivo ZIP con los tres archivos. Colóquelos en la raíz del archivo comprimido, sin ninguna carpeta contenedora. Microsoft Teams rechaza un paquete cuyo manifest.json se encuentre dentro de una carpeta.

Cargue y verifique

Cargue el archivo ZIP con la marca personalizada en el centro de administración de Teams y, a continuación, vuelva a Living Security y haga clic en Validate install. Envíe una notificación de prueba.

La validación muestra Validation passed y la notificación de prueba llega a Microsoft Teams con el nombre y los íconos de su aplicación.

Publicador y suma de comprobación

Personalizar la marca define el nombre y los íconos de la aplicación. No cambia dos aspectos:

El publicador sigue siendo Living Security. Los campos developer del manifiesto nombran a Living Security y enlazan al sitio web, la política de privacidad y los términos de servicio de Living Security. En conjunto, identifican a la empresa que opera el servicio, por lo que Teams sigue mostrando Living Security como publicador en la página de detalles de la aplicación, en los cuadros de diálogo de consentimiento de permisos y en los informes de uso de la aplicación. Su nombre y sus íconos son lo que los usuarios ven en el encabezado de la aplicación, en el catálogo de aplicaciones y en las notificaciones.
La suma de comprobación SHA256 deja de coincidir. La suma de comprobación que se muestra en Living Security describe el paquete tal como se descargó. Verifíquela antes de editar los archivos y, a continuación, registre la suma de comprobación de su propio paquete con marca personalizada para sus registros de implementación.

Opcional: habilitar la búsqueda alternativa por correo electrónico/UPN

La entrega personal normal utiliza un ID de objeto de Microsoft Entra de confianza que Living Security ya conoce, junto con la referencia de conversación del bot capturada cuando el usuario instala o abre la aplicación. La entrega por canal utiliza la referencia de conversación del canal almacenada. Ninguna de las dos rutas requiere Microsoft Graph. Si un destinatario no tiene un ID de objeto de Entra de confianza, Living Security puede utilizar opcionalmente Microsoft Graph para resolver al destinatario por dirección de correo electrónico o UPN. Para habilitar esa alternativa, pida a un administrador de Microsoft Entra que haga clic en Grant optional User.Read.All consent en el panel de configuración de Teams y apruebe el permiso de aplicación User.Read.All de Microsoft Graph para la aplicación de Teams regional de Living Security. El flujo de consentimiento de administrador sigue este patrón de Microsoft Entra:

https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}

Living Security genera esta URL a partir del ID del tenant conectado y del ID de aplicación del bot que se muestra en el panel de configuración. Los ID tienen fines distintos:

El ID de la aplicación de Teams identifica el paquete de aplicación instalable en el centro de administración de Microsoft Teams.
El ID de aplicación del bot identifica la aplicación de Microsoft Entra del bot regional y es el ID de cliente que se utiliza en el flujo opcional de consentimiento de administrador.

No sustituya el ID de la aplicación de Teams en la URL de consentimiento. La integración Microsoft Entra ID (Client Credentials) incluida en Integraciones conectadas es una integración genérica independiente. Sus credenciales o su consentimiento no pueden ser reutilizados por el bot regional de Teams, y el consentimiento otorgado a una aplicación de Entra no relacionada no habilita esta alternativa.

Hacer que el consentimiento sea opcional no elimina User.Read.All de los registros de aplicación regionales existentes de Living Security. Los clientes que ya otorgaron el consentimiento pueden seguir usando la alternativa por correo electrónico/UPN sin reconfigurar nada.

Tipos de notificación

Según los derechos de uso de su organización y los Playbooks configurados, Living Security puede enviar:

Notificación	Descripción
Asignaciones de capacitación	Notifican a los usuarios cuando se asigna una capacitación, vence o está lista para completarse
Recordatorios de capacitación	Recuerdan a los usuarios los plazos próximos
Alertas de riesgo humano	Envían actualizaciones personalizadas del Índice de riesgo humano y los siguientes pasos recomendados
Mensajes de implementación	Envían notificaciones unidireccionales de incorporación o implementación durante el despliegue
Anuncios de canal	Publican comunicaciones del programa de seguridad en los canales de Teams configurados

Personalización

Las notificaciones de Teams utilizan la configuración de su organización de Living Security. Los campos compatibles incluyen el nombre para mostrar del cliente, el logotipo compatible y los campos de marca, el texto de los mensajes, las llamadas a la acción, los enlaces de destino, el texto de implementación y el texto de soporte/contacto. Los mensajes de instalación se pueden configurar en Configuración → Comunicaciones → Canales → Microsoft Teams → Install message controls. Puede desactivar por completo los mensajes de instalación, desactivar solo los mensajes de instalación personales o de canal, y configurar el texto predeterminado, personal o específico del canal. El nombre y los íconos de la aplicación de Teams provienen del paquete regional. Para definir los suyos, consulte Personalizar la marca del paquete regional.

Actualización o eliminación de la aplicación

Cuando Living Security proporcione un paquete regional actualizado, descárguelo desde el panel del canal de Microsoft Teams y cargue ese paquete mediante el centro de administración de Teams. Verifique el ID de la aplicación, el ID del bot y la suma de comprobación que se muestran antes de la implementación.
Las modificaciones de marca no se conservan al actualizar el paquete. Cada nuevo paquete regional incluye de nuevo el nombre y los íconos de la aplicación de Living Security. Vuelva a aplicar sus modificaciones con Personalizar la marca del paquete regional antes de cargar el nuevo paquete. Guarde en un lugar accesible sus íconos, los dos valores de nombre y la última versión que cargó, de modo que cada actualización sea una repetición breve de los mismos pasos. Un paquete nuevo no siempre tiene una versión superior a la que instaló, por lo que debe definir la versión según lo que Teams muestre como instalado.
Vuelva a ejecutar Validate install y envíe otra prueba después de una actualización de la aplicación o de las directivas.
Eliminar o bloquear la aplicación impide las notificaciones proactivas a ese usuario o canal. Reinstale la aplicación y envíe una nueva prueba para que Living Security reciba un evento de instalación de Teams actual.
Si va a dejar de usar la entrega por Teams, quite Teams de los Playbooks pertinentes antes de eliminar la aplicación de Microsoft Teams.

Solución de problemas

Un usuario no recibe una notificación personal

Confirme que la aplicación personal de Teams de Living Security esté instalada y que el usuario la haya abierto, de modo que Living Security tenga una referencia de conversación actual
Confirme que el ID del tenant de Microsoft configurado sea el tenant en el que se encuentra el usuario
Si los diagnósticos muestran que se intentó la alternativa por correo electrónico/UPN, confirme que el consentimiento de administrador de User.Read.All se otorgó al ID de aplicación del bot que se muestra, para el tenant correcto
Cuando se utilice la alternativa por correo electrónico/UPN, verifique que el correo electrónico o el UPN del usuario en Living Security coincida con Microsoft Entra ID
Pida al usuario que desbloquee o reinstale la aplicación si antes la eliminó o la bloqueó

No aparece un anuncio de canal

Confirme que la aplicación de Teams de Living Security esté instalada en el equipo o canal de destino.
Confirme que la asignación de canal en Living Security utilice el equipo y el canal correctos.
Compruebe si el canal se eliminó, se cambió de nombre, se archivó o se restringió.
Reinstale la aplicación en el equipo o canal de destino y envíe otra notificación de prueba.

Falla la búsqueda opcional por correo electrónico/UPN o el consentimiento

Confirme que un administrador de Microsoft Entra otorgó el consentimiento para todo el tenant para Microsoft Graph User.Read.All al ID de aplicación del bot que se muestra.
Confirme que el ID del tenant configurado sea el tenant en el que se encuentran los usuarios y Teams.
Verifique que el usuario exista en Microsoft Entra ID y no sea un invitado de otro tenant.

El Registro de comunicaciones muestra que se requiere el consentimiento de administrador de Microsoft

La categoría de error TEAMS_ADMIN_CONSENT_REQUIRED, o el error de Microsoft AADSTS7000229, significa que una búsqueda de destinatario por correo electrónico/UPN intentó la alternativa opcional de Microsoft Graph, pero la aplicación de Teams regional de Living Security no tiene una entidad de servicio (aplicación empresarial) en el tenant de Microsoft Entra conectado. Las rutas predeterminadas de ID de confianza y de conversación almacenada no requieren este consentimiento. No se trata de un secreto caducado de Living Security.

Abra Configuración → Comunicaciones → Canales → Microsoft Teams. También puede usar Open Microsoft Teams setup desde el error del Registro de comunicaciones.
Confirme que esté conectado el ID de tenant de Microsoft Entra correcto.
Si se requiere la alternativa por correo electrónico/UPN, pida a un administrador de Microsoft Entra que haga clic en Grant optional User.Read.All consent y apruebe User.Read.All para el ID de aplicación del bot que se muestra. De lo contrario, asegúrese de que el destinatario haya abierto la aplicación personal y de que Living Security tenga su ID de objeto de Entra de confianza.
Cuando Microsoft termine de procesar el consentimiento, envíe una prueba avanzada dirigida por correo electrónico/UPN desde la configuración de Microsoft Teams. El Registro de comunicaciones muestra el historial de entrega y los diagnósticos; no vuelve a entregar el mensaje fallido.

Reconfigurar Microsoft Entra ID (Client Credentials) no resuelve este error, porque esa integración no se utiliza en la entrega de notificaciones de Teams.

La aplicación está instalada pero las notificaciones fallan

Compruebe si el bot se bloqueó, se eliminó o se desinstaló
Si la aplicación se instaló antes de conectar el tenant en Living Security, guarde el tenant y seleccione Validate install para que Living Security pueda asociar la instalación existente
Reinstale únicamente si la validación no puede detectar la instalación existente
Confirme que el usuario o canal de destino haya recibido el evento de instalación más reciente de la aplicación
Envíe una nueva notificación de prueba después de reinstalar la aplicación

Ejemplo de campos del evento de instalación utilizados para la solución de problemas:

{
  "type": "installationUpdate",
  "action": "add",
  "channelData": {
    "tenant": { "id": "278750d2-8df7-4262-a34d-08d79ad671d8" },
    "team": { "id": "19:team-id@thread.tacv2" },
    "channel": { "id": "19:channel-id@thread.tacv2" }
  },
  "conversation": {
    "id": "19:channel-id@thread.tacv2",
    "conversationType": "channel",
    "tenantId": "278750d2-8df7-4262-a34d-08d79ad671d8"
  }
}

Seguridad

Living Security utiliza User.Read.All de Microsoft Graph únicamente para la búsqueda alternativa opcional de destinatarios por correo electrónico/UPN. De forma predeterminada, el enrutamiento de notificaciones personales utiliza un ID de objeto de Entra de confianza procedente de los datos de entidad de Living Security y la referencia de conversación del bot capturada desde Microsoft Teams. Los ID de objeto y las referencias de conversación proporcionados por el llamador no se consideran datos de enrutamiento de confianza. Los mensajes de Microsoft Teams se entregan a través del bot de Teams de Living Security, exclusivo para notificaciones, mediante la mensajería proactiva de Microsoft Teams. Living Security no exige que los clientes creen su propio registro de aplicación de Microsoft Entra ni que compartan un secreto de cliente propio para la configuración estándar de la aplicación de Teams. Los paquetes de Teams específicos de cada región mantienen alineados el ID de la aplicación, el ID del bot y el extremo de mensajería con la región de Living Security en la que está alojada su organización.

Contenido relacionado

Integración de correo electrónico

Configure el correo electrónico como canal de entrega.

Integración de Slack

Configure Slack como canal de entrega.

Registro de comunicaciones

Haga un seguimiento del estado y el historial de entrega de Teams.

Autenticación

Configuración de Microsoft Entra ID y SSO.

Integraciones

Configuración de integraciones

Catálogo

Canales de salida

Requisitos previos

Quién hace qué

Configuración

Personalizar la marca del paquete regional

Publicador y suma de comprobación

Opcional: habilitar la búsqueda alternativa por correo electrónico/UPN

Tipos de notificación

Personalización

Actualización o eliminación de la aplicación

Solución de problemas

Seguridad

Contenido relacionado

Integración de correo electrónico

Integración de Slack

Registro de comunicaciones

Autenticación

Integraciones

Configuración de integraciones

Catálogo

Canales de salida

​Requisitos previos

​Quién hace qué

​Configuración

​Personalizar la marca del paquete regional

​Publicador y suma de comprobación

​Opcional: habilitar la búsqueda alternativa por correo electrónico/UPN

​Tipos de notificación

​Personalización

​Actualización o eliminación de la aplicación

​Solución de problemas

​Seguridad

​Contenido relacionado

Integración de correo electrónico

Integración de Slack

Registro de comunicaciones

Autenticación

Requisitos previos

Quién hace qué

Configuración

Personalizar la marca del paquete regional

Publicador y suma de comprobación

Opcional: habilitar la búsqueda alternativa por correo electrónico/UPN

Tipos de notificación

Personalización

Actualización o eliminación de la aplicación

Solución de problemas

Seguridad

Contenido relacionado