> ## 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. # Intégration de Microsoft Teams > Connectez Living Security à Microsoft Teams pour envoyer des notifications de formation, des alertes de sécurité et des annonces dans les canaux. L'intégration de Microsoft Teams envoie les notifications de Living Security aux utilisateurs et aux canaux par l'intermédiaire de l'application Teams de Living Security. Utilisez-la pour les affectations de formation, les alertes de risque humain, les messages de déploiement et les annonces de l'équipe de sécurité. Cette intégration sert uniquement à envoyer des notifications. Les utilisateurs n'envoient aucune commande au robot dans Microsoft Teams. Lorsque l'application est installée, le robot conserve la référence de conversation Teams en vue de futures notifications proactives. Les messages d'installation sont unidirectionnels et peuvent être personnalisés ou désactivés selon les exigences de déploiement de l'entreprise. Un administrateur de Microsoft Teams doit tout de même téléverser, approuver et distribuer l'application Teams de Living Security. Le consentement de l'administrateur Microsoft Entra `User.Read.All` est facultatif et active uniquement la recherche de secours par adresse courriel ou par nom d'utilisateur principal (UPN). Pour configurer la diffusion des coups de pouce et des guides d'intervention, commencez par **Paramètres → Communications → Canaux**, puis cliquez sur la carte **Microsoft Teams**. Cette page traite de la configuration sous-jacente de l'application Teams. ## Prérequis Avant de configurer Microsoft Teams, assurez-vous de disposer des éléments suivants : * Un administrateur de Microsoft Teams qui peut téléverser et approuver les applications de l'organisation. Une même personne peut détenir les deux rôles d'administrateur. * Un administrateur Microsoft Entra, seulement si vous souhaitez activer la recherche de secours facultative par adresse courriel ou UPN avec le consentement de l'application `User.Read.All` à l'échelle du locataire * Des privilèges d'administrateur Living Security * Une organisation Living Security active * Les noms des équipes et des canaux où les annonces de sécurité doivent être diffusées, si les annonces dans les canaux sont activées * L'ID de votre locataire Microsoft Entra, disponible sous **Centre d'administration Microsoft Entra → Identité → Vue d'ensemble** ## Qui fait quoi | Rôle | Responsabilité | | - | - | | **Administrateur Living Security** | Connecte le locataire Microsoft, télécharge le paquet régional, configure les messages d'installation, valide la configuration et envoie des tests | | **Administrateur de Microsoft Teams** | Téléverse et autorise l'application, la distribue aux utilisateurs ou aux groupes visés et attribue les stratégies de configuration d'application | | **Administrateur Microsoft Entra**, facultatif | Accorde le consentement de l'application `User.Read.All` à l'ID d'application du robot régional lorsque la recherche de secours par adresse courriel ou UPN est requise | | **Propriétaire Teams**, lorsque la diffusion dans les canaux est utilisée | Installe ou approuve l'application pour l'équipe et le canal visés | Ces rôles peuvent être tenus par des personnes différentes. Transmettez à l'administrateur de Microsoft Teams la somme de contrôle du paquet, l'ID de l'application Teams, l'**ID d'application du robot** et la population visée par le déploiement. Ne transmettez l'URL de consentement générée à un administrateur Microsoft Entra que si vous activez la recherche de secours facultative par adresse courriel ou UPN. Ne communiquez aucun autre identifiant de Living Security sans rapport avec cette configuration. ## Configuration Dans Living Security, accédez à **Paramètres → Communications → Canaux** et sélectionnez **Microsoft Teams**. Le panneau affiche la région de votre organisation, le nom du fichier du paquet, l'ID de l'application Teams, l'ID d'application du robot, la somme de contrôle SHA256, l'état de la configuration du locataire Microsoft, les instructions d'installation, les commandes des messages d'installation, ainsi que les outils de validation et de notification de test. La région affichée dans Living Security correspond à la région où votre organisation est hébergée. Dans **Connect your tenant**, saisissez l'ID du locataire Microsoft Entra auquel appartiennent les utilisateurs et les canaux Teams qui reçoivent les notifications, puis cliquez sur **Save Microsoft tenant**. Un locataire Microsoft ne peut appartenir qu'à une seule organisation Living Security. Si la commande du locataire n'est pas disponible, communiquez avec le responsable de la mise en œuvre de Living Security ou avec votre contact du soutien pour connecter ou modifier le locataire avant d'installer l'application. Living Security affiche **Microsoft tenant connected** avant que vous ne poursuiviez. Dans la mesure du possible, connectez le locataire avant d'installer l'application Teams. Si l'application est déjà installée, enregistrez le locataire et sélectionnez d'abord **Validate install**. Living Security tente d'associer automatiquement l'installation existante; ne réinstallez l'application que si la validation ne parvient pas à la détecter. Cliquez sur **Download Teams package**. Living Security fournit à votre organisation un paquet ZIP propre à votre région. Vérifiez le fichier téléchargé à l'aide de la somme de contrôle SHA256 affichée dans Living Security avant de modifier quoi que ce soit. Pour attribuer à l'application votre propre nom et vos propres icônes, suivez la section [Personnaliser l'image de marque du paquet régional](#personnaliser-l-image-de-marque-du-paquet-r%C3%A9gional) après cette vérification et avant de téléverser le paquet. La somme de contrôle du fichier téléchargé correspond à la somme de contrôle SHA256 affichée dans Living Security. Dans le centre d'administration de Microsoft Teams, accédez à **Teams apps → Manage apps → Actions → Upload new app**, puis téléversez le fichier ZIP téléchargé depuis Living Security. Vérifiez les points suivants : * L'ID de l'application Teams et l'ID d'application du robot correspondent aux valeurs affichées dans Living Security * Le nom de l'application est le nom régional de Living Security, ou celui que vous avez défini si vous avez personnalisé l'image de marque du paquet * L'éditeur est **Living Security**. La personnalisation de l'image de marque du paquet ne modifie pas l'éditeur * L'application est débloquée * L'application est accessible aux utilisateurs ou aux groupes visés * L'application est installée au moyen des stratégies de configuration d'application ou d'une installation ciblée pour les utilisateurs et les équipes ou canaux qui doivent recevoir les notifications Microsoft peut avoir besoin de temps pour propager la disponibilité de l'application et les modifications des stratégies de configuration. Si la validation ou un test échoue immédiatement après une modification de stratégie d'application, vérifiez l'attribution de la stratégie dans le centre d'administration de Microsoft Teams et réessayez une fois que Microsoft a terminé la propagation. Distribuez l'application personnelle aux utilisateurs visés. Pour que Living Security puisse envoyer un test personnel à une installation détectée, au moins un utilisateur doit installer ou ouvrir l'application personnelle Living Security dans Microsoft Teams. Cela permet au robot de saisir l'identité approuvée de l'utilisateur et la référence de conversation personnelle. Une installation dans un canal ne suffit pas pour un test personnel sur une installation détectée. Pour la diffusion dans un canal, installez l'application dans l'équipe et le canal visés afin que le robot puisse saisir la référence de conversation de ce canal. Un utilisateur cible a installé ou ouvert l'application personnelle, ou l'application est installée dans le canal visé. Dans la section **Install message controls**, indiquez si des messages d'installation Teams sont envoyés et personnalisez le texte unidirectionnel pour votre organisation. Commandes disponibles : * Send install messages * Send personal install messages * Send channel install messages * Default message * Personal message * Channel message Les champs de message prennent en charge `{{installerName}}`, qui est remplacé par le nom d'affichage de l'utilisateur qui a installé l'application. Laissez un message personnel ou un message de canal vide pour utiliser le message par défaut que vous avez configuré. Si le message par défaut est également vide, Living Security utilise le message intégré correspondant à cette portée. Cliquez sur **Validate install** dans Living Security. La validation vérifie que le paquet régional est disponible, que la configuration du locataire Microsoft est présente et propre à cette organisation Living Security, que les identifiants du robot régional sont configurés et qu'une installation active de l'application a été détectée pour le locataire connecté. La validation affiche **Validation passed** avant que vous n'envoyiez des notifications en production. Pour le test personnel par défaut, cliquez sur **Send test to detected installation**. Living Security sélectionne une installation personnelle active détectée et utilise l'identité approuvée et la référence de conversation qui y sont stockées. Ce test n'appelle pas Microsoft Graph et ne nécessite pas le consentement `User.Read.All`. Si aucune installation personnelle n'est détectée, demandez à un utilisateur d'installer ou d'ouvrir l'application personnelle Living Security, sélectionnez de nouveau **Validate install**, puis renvoyez le test. N'utilisez le test ciblé avancé par adresse courriel ou UPN que si la recherche de secours facultative est activée. La notification de test unidirectionnelle apparaît dans Microsoft Teams. Consultez la tentative correspondante dans le [journal des communications](/fr-CA/features/communications/log) lorsque des diagnostics de livraison sont nécessaires. ## Personnaliser l'image de marque du paquet régional Le paquet régional est une archive ZIP de trois fichiers : `manifest.json`, `color.png` et `outline.png`. Vous pouvez définir le nom et les icônes de votre application dans ce paquet avant de le téléverser. Living Security prend en charge cette méthode pour les paquets régionaux qu'un administrateur Teams téléverse directement. Effectuez cette opération après avoir téléchargé et vérifié le paquet, et avant de le téléverser dans le centre d'administration Teams. Extrayez le fichier ZIP. Il contient exactement trois fichiers à la racine de l'archive : `manifest.json`, `color.png` et `outline.png`. Remplacez `color.png` et `outline.png` par vos propres icônes. Conservez les mêmes noms de fichier. | Fichier | Exigence | | - | - | | `color.png` | PNG en couleurs, 192 × 192 pixels, sans transparence | | `outline.png` | PNG transparent, 32 × 32 pixels | Dans `manifest.json`, modifiez ces deux champs : * `name.short` : le nom affiché dans l'en-tête de l'application Teams et dans les autres zones où l'espace est limité. Maximum de 30 caractères. * `name.full` : le nom affiché dans le catalogue d'applications et dans les détails de l'application. Maximum de 100 caractères. Si une application Living Security est déjà téléversée dans le centre d'administration Teams, définissez `version` à une valeur supérieure à la version qui y est installée. Microsoft Teams refuse une mise à jour qui n'augmente pas la version, et un nouveau téléchargement peut porter la même version que le paquet déjà installé, ou une version inférieure. Consultez la version installée dans le centre d'administration Teams sous **Teams apps → Manage apps**, sur la page de détails de l'application. Comparez-la à la valeur `version` du `manifest.json` que vous venez de télécharger, puis définissez une valeur supérieure aux deux. Conservez le format `MAJOR.MINOR.PATCH` à trois nombres. Par exemple, si l'application installée est `1.1.1` et que votre nouveau téléchargement est `1.1.0`, définissez `1.1.2`. Augmenter le `1.1.0` téléchargé à `1.1.1` reproduirait la version installée, et Teams refuserait le téléversement. Ne modifiez pas ces champs. Chacun porte l'identité de l'application, du robot ou de l'authentification unique : * `id` * `botId` dans `bots` * `webApplicationInfo` * `validDomains` * `contentUrl` et `websiteUrl` dans `staticTabs` La modification d'un champ d'identité peut laisser l'application installable, mais incapable de livrer les notifications ou de réaliser l'authentification unique. **Validate install** vérifie le locataire, les identifiants du robot et l'installation détectée. Cette validation ne compare pas votre manifeste au paquet créé par Living Security. Créez une nouvelle archive ZIP à partir des trois fichiers. Placez-les à la racine de l'archive, sans dossier englobant. Microsoft Teams refuse un paquet dont le `manifest.json` se trouve dans un dossier. Téléversez le fichier ZIP personnalisé dans le centre d'administration Teams, puis retournez dans Living Security et cliquez sur **Validate install**. Envoyez une notification de test. La validation affiche **Validation passed**, et la notification de test arrive dans Microsoft Teams sous le nom et avec les icônes de votre application. ### Éditeur et somme de contrôle La personnalisation de l'image de marque définit le nom et les icônes de l'application. Elle ne modifie pas deux éléments : * **L'éditeur reste Living Security.** Les champs `developer` du manifeste désignent Living Security et renvoient au site Web, à la politique de confidentialité et aux conditions d'utilisation de Living Security. Ensemble, ils identifient l'entreprise qui exploite le service; Teams continue donc d'afficher **Living Security** comme éditeur sur la page de détails de l'application, dans les boîtes de dialogue de consentement aux autorisations et dans les rapports d'utilisation de l'application. Votre nom et vos icônes sont ce que les utilisateurs voient dans l'en-tête de l'application, le catalogue d'applications et les notifications. * **La somme de contrôle SHA256 ne correspond plus.** La somme de contrôle affichée dans Living Security décrit le paquet tel qu'il a été téléchargé. Vérifiez-la avant de modifier les fichiers, puis consignez la somme de contrôle de votre propre paquet personnalisé dans vos dossiers de déploiement. ## Facultatif : activer la recherche de secours par adresse courriel ou UPN La livraison personnelle normale utilise un ID d'objet Microsoft Entra approuvé déjà connu de Living Security, ainsi que la référence de conversation du robot saisie lorsque l'utilisateur installe ou ouvre l'application. La livraison dans un canal utilise la référence de conversation du canal qui a été stockée. Aucune de ces deux voies ne nécessite Microsoft Graph. Si un destinataire n'a pas d'ID d'objet Entra approuvé, Living Security peut utiliser Microsoft Graph pour retrouver le destinataire par adresse courriel ou UPN. Pour activer cette solution de secours, demandez à un administrateur Microsoft Entra de cliquer sur **Grant optional User.Read.All consent** dans le panneau de configuration de Teams et d'approuver l'autorisation d'application `User.Read.All` de Microsoft Graph pour l'application Teams régionale de Living Security. Le flux de consentement de l'administrateur suit ce modèle Microsoft Entra : ```text theme={null} https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id} ``` Living Security génère cette URL à partir de l'ID du locataire connecté et de l'**ID d'application du robot** affiché dans le panneau de configuration. Les ID ont des usages différents : * L'**ID de l'application Teams** identifie le paquet d'application installable dans le centre d'administration de Microsoft Teams. * L'**ID d'application du robot** identifie l'application Microsoft Entra du robot régional et correspond à l'ID client utilisé pour le flux facultatif de consentement de l'administrateur. Ne remplacez pas l'ID de l'application Teams dans l'URL de consentement. L'intégration **Microsoft Entra ID (Client Credentials)** sous Connected Integrations est une intégration distincte et générique. Ses identifiants ou son consentement ne peuvent pas être réutilisés par le robot Teams régional, et un consentement accordé à une application Entra sans rapport n'active pas cette solution de secours. Le fait de rendre le consentement facultatif ne retire pas `User.Read.All` des inscriptions d'application régionales existantes de Living Security. Les clients qui ont déjà accordé le consentement peuvent continuer à utiliser la solution de secours par adresse courriel ou UPN sans reconfiguration. ## Types de notifications Selon les droits de votre organisation et les guides d'intervention configurés, Living Security peut envoyer : | Notification | Description | | - | - | | Affectations de formation | Avisent les utilisateurs lorsqu'une formation est affectée, arrive à échéance ou est prête à être suivie | | Rappels de formation | Rappellent aux utilisateurs les échéances à venir | | Alertes de risque humain | Envoient des mises à jour personnalisées de l'Indice de risque humain et les prochaines étapes recommandées | | Messages de déploiement | Envoient des notifications unidirectionnelles d'accueil ou de déploiement pendant la mise en œuvre | | Annonces dans les canaux | Publient les communications du programme de sécurité dans les canaux Teams configurés | ## Personnalisation Les notifications Teams utilisent la configuration de votre organisation Living Security. Les champs pris en charge comprennent le nom d'affichage du client, les champs de logo et de marque pris en charge, le texte des messages, les appels à l'action, les liens de destination, le texte de déploiement et le texte de soutien et de contact. Les messages d'installation se configurent sous **Paramètres → Communications → Canaux → Microsoft Teams → Install message controls**. Vous pouvez désactiver complètement les messages d'installation, désactiver seulement les messages d'installation personnels ou ceux des canaux, et configurer un texte par défaut, personnel ou propre aux canaux. Le nom et les icônes de l'application Teams proviennent du paquet régional. Pour définir les vôtres, consultez la section [Personnaliser l'image de marque du paquet régional](#personnaliser-l-image-de-marque-du-paquet-r%C3%A9gional). ## Mise à jour ou retrait de l'application * Lorsque Living Security fournit un paquet régional mis à jour, téléchargez-le depuis le panneau du canal Microsoft Teams et téléversez-le par le centre d'administration Teams. Vérifiez l'ID d'application, l'ID du robot et la somme de contrôle affichés avant le déploiement. * Les modifications d'image de marque ne survivent pas à une mise à jour du paquet. Chaque nouveau paquet régional reprend le nom et les icônes de l'application Living Security. Appliquez de nouveau vos modifications en suivant la section [Personnaliser l'image de marque du paquet régional](#personnaliser-l-image-de-marque-du-paquet-r%C3%A9gional) avant de téléverser le nouveau paquet. Conservez vos icônes, vos deux valeurs de nom et la dernière version téléversée dans un endroit facile à retrouver, afin que chaque mise à niveau se résume à une courte répétition des mêmes étapes. Un nouveau paquet ne porte pas toujours une version supérieure à celle que vous avez installée; définissez donc la version d'après ce que Teams indique comme installé. * Relancez **Validate install** et envoyez un autre test après une mise à jour de l'application ou d'une stratégie. * Le retrait ou le blocage de l'application empêche les notifications proactives vers cet utilisateur ou ce canal. Réinstallez l'application et envoyez un nouveau test afin que Living Security reçoive un événement d'installation Teams à jour. * Si vous mettez fin à la diffusion par Teams, retirez Teams des guides d'intervention concernés avant de retirer l'application de Microsoft Teams. ## Dépannage * Vérifiez que l'application personnelle Teams de Living Security est installée et que l'utilisateur l'a ouverte afin que Living Security dispose d'une référence de conversation à jour * Vérifiez que l'ID du locataire Microsoft configuré est celui du locataire auquel appartient l'utilisateur * Si les diagnostics indiquent que la solution de secours par adresse courriel ou UPN a été tentée, vérifiez que le consentement de l'administrateur `User.Read.All` a été accordé à l'ID d'application du robot affiché, pour le bon locataire * Lorsque la solution de secours par adresse courriel ou UPN est utilisée, vérifiez que l'adresse courriel ou l'UPN de l'utilisateur dans Living Security correspond à celui de Microsoft Entra ID * Demandez à l'utilisateur de débloquer ou de réinstaller l'application s'il l'a précédemment retirée ou bloquée La catégorie d'erreur `TEAMS_ADMIN_CONSENT_REQUIRED`, ou l'erreur Microsoft `AADSTS7000229`, signifie qu'une recherche de destinataire par adresse courriel ou UPN a tenté d'utiliser la solution de secours facultative de Microsoft Graph, mais que l'application Teams régionale de Living Security n'a aucun principal de service (application d'entreprise) dans le locataire Microsoft Entra connecté. Les voies par défaut, soit l'ID approuvé et la conversation stockée, ne nécessitent pas ce consentement. Il ne s'agit pas d'un secret Living Security expiré. 1. Ouvrez **Paramètres → Communications → Canaux → Microsoft Teams**. Vous pouvez également utiliser **Open Microsoft Teams setup** à partir de l'erreur du journal des communications. 2. Vérifiez que l'ID du bon locataire Microsoft Entra est connecté. 3. Si la solution de secours par adresse courriel ou UPN est requise, demandez à un administrateur Microsoft Entra de cliquer sur **Grant optional User.Read.All consent** et d'approuver `User.Read.All` pour l'**ID d'application du robot** affiché. Sinon, assurez-vous que le destinataire a ouvert l'application personnelle et que Living Security dispose de son ID d'objet Entra approuvé. 4. Une fois que Microsoft a terminé le traitement du consentement, envoyez un test ciblé avancé par adresse courriel ou UPN à partir de la configuration de Microsoft Teams. Le journal des communications affiche l'historique de livraison et les diagnostics; il ne redistribue pas le message en échec. La reconfiguration de **Microsoft Entra ID (Client Credentials)** ne résout pas cette erreur, car cette intégration n'est pas utilisée pour la livraison des notifications Teams. * Vérifiez si le robot a été bloqué, retiré ou désinstallé * Si l'application a été installée avant la connexion du locataire dans Living Security, enregistrez le locataire et sélectionnez **Validate install** afin que Living Security puisse associer l'installation existante * Ne réinstallez l'application que si la validation ne parvient pas à détecter l'installation existante * Vérifiez que l'utilisateur ou le canal cible a reçu le plus récent événement d'installation de l'application * Envoyez une nouvelle notification de test après avoir réinstallé l'application Exemple de champs d'événement d'installation utilisés pour le dépannage : ```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" } } ``` ## Sécurité Living Security utilise Microsoft Graph `User.Read.All` uniquement pour la solution de secours facultative de recherche de destinataire par adresse courriel ou UPN. Par défaut, l'acheminement des notifications personnelles utilise un ID d'objet Entra approuvé provenant des données d'entité de Living Security et la référence de conversation du robot saisie depuis Microsoft Teams. Les ID d'objet et les références de conversation fournis par l'appelant ne sont pas des données d'acheminement fiables. Les messages Microsoft Teams sont livrés par le robot Teams de Living Security, dédié aux notifications, au moyen de la messagerie proactive de Microsoft Teams. Living Security n'exige pas que les clients créent leur propre inscription d'application Microsoft Entra ni qu'ils communiquent un secret client leur appartenant pour la configuration standard de l'application Teams. Les paquets Teams propres à chaque région maintiennent l'ID d'application, l'ID du robot et le point de terminaison de messagerie alignés sur la région de Living Security où votre organisation est hébergée. ## Voir aussi Configurez le courriel comme canal de diffusion. Configurez Slack comme canal de diffusion. Suivez l'état et l'historique de la livraison des messages Teams. Configuration de Microsoft Entra ID et de l'authentification unique. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.