Skip to main content
L’intégration 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 est réservée aux notifications. Les utilisateurs n’envoient aucune commande au bot dans Microsoft Teams. Lorsque l’application est installée, le bot enregistre la référence de conversation Teams pour les 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 Microsoft Teams doit toujours téléverser, approuver et distribuer l’application Teams de Living Security. Le consentement administrateur Microsoft Entra User.Read.All est facultatif et active uniquement la recherche de secours par adresse e-mail ou nom d’utilisateur principal (UPN).
Pour configurer la diffusion des coups de pouce et des Playbooks, commencez par Paramètres → Communications → Canaux et 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 Microsoft Teams capable de téléverser et d’approuver les applications de l’organisation. La même personne peut cumuler les deux rôles d’administrateur.
  • Un administrateur Microsoft Entra, uniquement si vous souhaitez activer la recherche de secours facultative par adresse e-mail/UPN avec le consentement d’application User.Read.All à l’échelle du tenant
  • Des privilèges d’administrateur Living Security
  • Une organisation Living Security active
  • Les noms de l’équipe et du canal où les annonces de sécurité doivent être diffusées, si les annonces de canal sont activées
  • L’ID de votre tenant Microsoft Entra, disponible dans Centre d’administration Microsoft Entra → Identité → Vue d’ensemble

Répartition des responsabilités

Ces rôles peuvent être tenus par des personnes différentes. Communiquez à l’administrateur Microsoft Teams la somme de contrôle du package, l’ID de l’application Teams, l’ID d’application du bot et la population visée par le déploiement. Ne communiquez l’URL de consentement générée à un administrateur Microsoft Entra que pour activer la recherche de secours facultative par adresse e-mail/UPN. Ne partagez aucun identifiant Living Security sans rapport avec cette configuration.

Configuration

1

Ouvrir le panneau de configuration de Microsoft Teams

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 package, l’ID de l’application Teams, l’ID d’application du bot, la somme de contrôle SHA256, l’état de la configuration du tenant Microsoft, les instructions d’installation, les contrôles 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 dans laquelle votre organisation est hébergée.
2

Connecter votre tenant Microsoft

Dans Connect your tenant, saisissez l’ID du tenant Microsoft Entra auquel appartiennent les utilisateurs et les canaux Teams qui recevront les notifications, puis cliquez sur Save Microsoft tenant. Un tenant Microsoft ne peut appartenir qu’à une seule organisation Living Security.Si le contrôle du tenant n’est pas disponible, contactez le responsable de la mise en œuvre de Living Security ou votre contact du support pour connecter ou modifier le tenant avant d’installer l’application.
Living Security affiche Microsoft tenant connected avant que vous ne poursuiviez.
Connectez le tenant avant d’installer l’application Teams dans la mesure du possible. Si l’application est déjà installée, enregistrez le tenant 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.
3

Télécharger le package Teams régional

Cliquez sur Download Teams package. Living Security fournit un package ZIP propre à la région de votre organisation.Vérifiez le fichier téléchargé par rapport à 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 package régional après cette vérification et avant de téléverser le package.
La somme de contrôle du fichier téléchargé correspond à la somme de contrôle SHA256 affichée dans Living Security.
4

Téléverser et installer le package dans le centre d’administration Teams

Dans le centre d’administration 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 bot correspondent aux valeurs affichées dans Living Security
  • Le nom de l’application est le nom régional Living Security, ou le nom que vous avez défini si vous avez personnalisé l’image de marque du package
  • L’éditeur est Living Security. La personnalisation de l’image de marque du package ne modifie pas l’éditeur
  • L’application est débloquée
  • L’application est disponible pour les utilisateurs ou groupes concernés
  • L’application est installée au moyen de stratégies de configuration d’application ou d’une installation ciblée pour les utilisateurs et les équipes/canaux qui doivent recevoir les notifications
Microsoft peut mettre un certain temps à 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 Microsoft Teams et réessayez une fois que Microsoft a terminé la propagation.
5

Installer ou ouvrir l’application

Distribuez l’application personnelle aux utilisateurs concerné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 bot de capturer l’identité fiable de l’utilisateur et sa référence de conversation personnelle. Une installation dans un canal seule ne peut pas être utilisée 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 concernés afin que le bot puisse capturer 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 concerné.
6

Configurer les messages d’installation

Dans la section Install message controls, choisissez si les messages d’installation Teams sont envoyés et personnalisez le texte unidirectionnel pour votre organisation.Contrôles 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 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 à ce périmètre.
7

Valider la configuration

Cliquez sur Validate install dans Living Security. La validation vérifie que le package régional est disponible, que la configuration du tenant Microsoft est présente et propre à cette organisation Living Security, que les identifiants du bot régional sont configurés et qu’une installation active de l’application a été détectée pour le tenant connecté.
La validation affiche Validation passed avant que vous n’envoyiez des notifications en production.
8

Envoyer des notifications de test

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é fiable et la référence de conversation qui y sont enregistrées. Ce test n’appelle pas Microsoft Graph et ne nécessite pas de 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 à nouveau Validate install, puis renvoyez le test. N’utilisez le test ciblé avancé par adresse e-mail/UPN que lorsque 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 lorsque des diagnostics de diffusion sont nécessaires.

Personnaliser l’image de marque du package régional

Le package régional est une archive ZIP de trois fichiers : manifest.json, color.png et outline.png. Vous pouvez définir votre propre nom d’application et vos propres icônes dans ce package avant de le téléverser. Living Security prend en charge cette méthode pour les packages régionaux qu’un administrateur Teams téléverse directement. Effectuez cette opération après avoir téléchargé et vérifié le package, et avant de le téléverser dans le centre d’administration Teams.
1

Décompresser le package

Extrayez le fichier ZIP. Il contient exactement trois fichiers à la racine de l’archive : manifest.json, color.png et outline.png.
2

Remplacer les icônes

Remplacez color.png et outline.png par vos propres icônes. Conservez les deux mêmes noms de fichier.
3

Définir le nom de votre application

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é. 30 caractères maximum.
  • name.full : le nom affiché dans le catalogue d’applications et dans les détails de l’application. 100 caractères maximum.
    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 package déjà installé, voire une version inférieure.Consultez la version installée dans le centre d’administration Teams sous Teams apps → Manage apps, sur la page des 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. Passer le 1.1.0 téléchargé à 1.1.1 reviendrait à répéter la version installée, et Teams refuserait le téléversement.
4

Laisser les champs d’identité inchangés

Ne modifiez pas ces champs. Chacun porte l’identité de l’application, du bot 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 diffuser des notifications ou de mener à bien l’authentification unique. Validate install vérifie le tenant, les identifiants du bot et l’installation détectée. Il ne compare pas votre manifeste au package créé par Living Security.
5

Recompresser les trois fichiers

Créez une nouvelle archive ZIP à partir des trois fichiers. Placez-les à la racine de l’archive, sans dossier englobant. Microsoft Teams refuse un package dont le fichier manifest.json se trouve dans un dossier.
6

Téléverser et vérifier

Téléversez le fichier ZIP personnalisé dans le centre d’administration Teams, puis revenez 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 vers le site web, la politique de confidentialité et les 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 des détails de l’application, dans les boîtes de dialogue de consentement aux autorisations et dans les rapports d’utilisation des applications. 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 package 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 package personnalisé dans vos dossiers de déploiement.

Facultatif : activer la recherche de secours par adresse e-mail/UPN

La diffusion personnelle normale utilise un ID d’objet Microsoft Entra fiable déjà connu de Living Security, associé à la référence de conversation du bot capturée lorsque l’utilisateur installe ou ouvre l’application. La diffusion dans un canal utilise la référence de conversation du canal enregistrée. Aucune de ces deux voies ne nécessite Microsoft Graph. Si un destinataire ne possède pas d’ID d’objet Entra fiable, Living Security peut utiliser, à titre facultatif, Microsoft Graph pour identifier le destinataire par son adresse e-mail ou son UPN. Pour activer cette recherche de secours, demandez à un administrateur Microsoft Entra de cliquer sur Grant optional User.Read.All consent dans le panneau de configuration Teams et d’approuver l’autorisation d’application Microsoft Graph User.Read.All pour l’application Teams régionale de Living Security. Le flux de consentement administrateur suit ce modèle Microsoft Entra :
Living Security génère cette URL à partir de l’ID du tenant connecté et de l’ID d’application du bot affiché dans le panneau de configuration. Ces ID ont des usages différents :
  • L’ID de l’application Teams identifie le package d’application installable dans le centre d’administration Microsoft Teams.
  • L’ID d’application du bot identifie l’application Microsoft Entra du bot régional et constitue l’ID client utilisé pour le flux de consentement administrateur facultatif.
Ne remplacez pas l’ID d’application Teams dans l’URL de consentement. L’intégration Microsoft Entra ID (Client Credentials) sous Intégrations connectées est une intégration distincte et générique. Ses identifiants ou son consentement ne peuvent pas être réutilisés par le bot Teams régional, et le consentement accordé à une application Entra sans rapport n’active pas cette recherche de secours.
Le fait de rendre le consentement facultatif ne supprime pas User.Read.All des enregistrements d’application Living Security régionaux existants. Les clients qui ont déjà accordé le consentement peuvent continuer à utiliser la recherche de secours par adresse e-mail/UPN sans reconfiguration.

Types de notifications

Selon les droits de votre organisation et les Playbooks configurés, Living Security peut envoyer :

Personnalisation

Les notifications Teams utilisent la configuration de votre organisation Living Security. Les champs pris en charge comprennent le nom d’affichage du client, le logo et les champs 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 d’assistance/de contact. Les messages d’installation sont configurables depuis Paramètres → Communications → Canaux → Microsoft Teams → Install message controls. Vous pouvez désactiver entièrement les messages d’installation, désactiver uniquement les messages d’installation personnels ou de canal, et configurer un texte par défaut, personnel ou propre au canal. Le nom et les icônes de l’application Teams proviennent du package régional. Pour définir les vôtres, consultez la section Personnaliser l’image de marque du package régional.

Mise à jour ou suppression de l’application

  • Lorsque Living Security fournit un package 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 bot et la somme de contrôle affichés avant le déploiement.
  • Les modifications de l’image de marque ne survivent pas à une mise à jour du package. Chaque nouveau package régional reprend le nom et les icônes de l’application Living Security. Appliquez à nouveau vos modifications en suivant la section Personnaliser l’image de marque du package régional avant de téléverser le nouveau package. Conservez à un endroit accessible vos icônes, vos deux valeurs de nom et la dernière version que vous avez téléversée, afin que chaque mise à niveau soit une courte répétition des mêmes étapes. Un nouveau package ne porte pas toujours une version supérieure à celle que vous avez installée ; définissez donc la version à partir de ce que Teams indique comme installé.
  • Relancez Validate install et envoyez un nouveau test après une mise à jour de l’application ou de la stratégie.
  • La suppression 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 Playbooks concernés avant de supprimer 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 tenant Microsoft configuré est celui du tenant dans lequel se trouve l’utilisateur
  • Si les diagnostics indiquent qu’une recherche de secours par adresse e-mail/UPN a été tentée, vérifiez que le consentement administrateur User.Read.All a été accordé à l’ID d’application du bot affiché pour le bon tenant
  • Lorsque la recherche de secours par adresse e-mail/UPN est utilisée, vérifiez que l’adresse e-mail 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 supprimée ou bloquée
  • Vérifiez que l’application Teams de Living Security est installée dans l’équipe ou le canal cible.
  • Vérifiez que le mappage de canal dans Living Security utilise la bonne équipe et le bon canal.
  • Vérifiez si le canal a été supprimé, renommé, archivé ou restreint.
  • Réinstallez l’application dans l’équipe ou le canal cible et envoyez une autre notification de test.
  • Vérifiez qu’un administrateur Microsoft Entra a accordé le consentement à l’échelle du tenant pour Microsoft Graph User.Read.All à l’ID d’application du bot affiché.
  • Vérifiez que l’ID de tenant configuré est celui du tenant dans lequel se trouvent les utilisateurs et Teams.
  • Vérifiez que l’utilisateur existe dans Microsoft Entra ID et qu’il n’est pas un invité d’un autre tenant.
La catégorie d’erreur TEAMS_ADMIN_CONSENT_REQUIRED, ou l’erreur Microsoft AADSTS7000229, signifie qu’une recherche de destinataire par adresse e-mail/UPN a tenté d’utiliser la solution de secours facultative Microsoft Graph, mais que l’application Teams régionale de Living Security ne possède aucun principal de service (application d’entreprise) dans le tenant Microsoft Entra connecté. Les voies par défaut, fondées sur l’ID fiable et la conversation enregistré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 le bon ID de tenant Microsoft Entra est connecté.
  3. Si la recherche de secours par adresse e-mail/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 bot affiché. Sinon, assurez-vous que le destinataire a ouvert l’application personnelle et que Living Security dispose de son ID d’objet Entra fiable.
  4. Une fois que Microsoft a terminé le traitement du consentement, envoyez un test ciblé avancé par adresse e-mail/UPN depuis la configuration de Microsoft Teams. Le Journal des communications affiche l’historique de diffusion et les diagnostics ; il ne rediffuse 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 diffusion des notifications Teams.
  • Vérifiez si le bot a été bloqué, supprimé ou désinstallé
  • Si l’application a été installée avant la connexion du tenant dans Living Security, enregistrez le tenant 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 dernier événement d’installation de l’application
  • Envoyez une nouvelle notification de test après la réinstallation de l’application
Exemple de champs d’événement d’installation utilisés pour le dépannage :

Sécurité

Living Security utilise Microsoft Graph User.Read.All uniquement pour la recherche de secours facultative des destinataires par adresse e-mail/UPN. Par défaut, l’acheminement des notifications personnelles utilise un ID d’objet Entra fiable issu des données d’entité de Living Security et la référence de conversation du bot capturée 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 diffusés par le bot Teams de Living Security, réservé aux notifications, à l’aide de la messagerie proactive de Microsoft Teams. Living Security n’exige pas que les clients créent leur propre enregistrement d’application Microsoft Entra ni qu’ils partagent un secret client leur appartenant pour la configuration standard de l’application Teams. Les packages Teams propres à chaque région maintiennent l’ID d’application, l’ID du bot et le point de terminaison de messagerie alignés sur la région Living Security dans laquelle votre organisation est hébergée.

Voir aussi

Intégration e-mail

Configurez l’e-mail comme canal de diffusion.

Intégration Slack

Configurez Slack comme canal de diffusion.

Journal des communications

Suivez l’état et l’historique de diffusion de Teams.

Authentification

Configuration de Microsoft Entra ID et de l’authentification unique (SSO).