> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Integración de Microsoft Teams > Conecte Living Security con Microsoft Teams para enviar notificaciones de capacitación, alertas de seguridad y anuncios de canal. 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 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. 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. 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](#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. 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. 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. 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. 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. 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](/es/features/communications/log) 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. Extraiga el archivo ZIP. Contiene exactamente tres archivos en la raíz del archivo comprimido: `manifest.json`, `color.png` y `outline.png`. 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 | 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. 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. 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 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: ```text theme={null} 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](#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](#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 * 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ó 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. 1. Abra **Configuración → Comunicaciones → Canales → Microsoft Teams**. También puede usar **Open Microsoft Teams setup** desde el error del Registro de comunicaciones. 2. Confirme que esté conectado el ID de tenant de Microsoft Entra correcto. 3. 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. 4. 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. * 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: ```json theme={null} { "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 Configure el correo electrónico como canal de entrega. Configure Slack como canal de entrega. Haga un seguimiento del estado y el historial de entrega de Teams. Configuración de Microsoft Entra ID y SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.