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
Configuration
Ouvrir le panneau de configuration de Microsoft Teams
Connecter votre tenant Microsoft
Télécharger le package Teams régional
Téléverser et installer le package dans le centre d’administration Teams
- 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
Installer ou ouvrir l’application
Configurer les messages d’installation
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{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.Valider la configuration
Envoyer des notifications de test
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.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.
Décompresser le package
manifest.json, color.png et outline.png.Remplacer les icônes
color.png et outline.png par vos propres icônes. Conservez les deux mêmes
noms de fichier.Définir le nom de votre application
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éfinissezversionà 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 valeurversiondumanifest.jsonque vous venez de télécharger, puis définissez une valeur supérieure aux deux. Conservez le formatMAJOR.MINOR.PATCHà trois nombres.Par exemple, si l’application installée est1.1.1et que votre nouveau téléchargement est1.1.0, définissez1.1.2. Passer le1.1.0téléchargé à1.1.1reviendrait à répéter la version installée, et Teams refuserait le téléversement.
Laisser les champs d’identité inchangés
-
id -
botIddansbots -
webApplicationInfo -
validDomains -
contentUrletwebsiteUrldansstaticTabs
Recompresser les trois fichiers
manifest.json se trouve dans un dossier.Téléverser et vérifier
É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
developerdu 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 GraphUser.Read.All pour l’application Teams régionale de Living
Security.
Le flux de consentement administrateur suit ce modèle Microsoft Entra :
- 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.
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
Un utilisateur ne reçoit pas de notification personnelle
Un utilisateur ne reçoit pas de notification personnelle
- 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.Alla é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
Une annonce de canal n’apparaît pas
Une annonce de canal n’apparaît pas
- 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.
La recherche facultative par adresse e-mail/UPN ou le consentement échoue
La recherche facultative par adresse e-mail/UPN ou le consentement échoue
- 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.
Le Journal des communications indique qu’un consentement administrateur Microsoft est requis
Le Journal des communications indique qu’un consentement administrateur Microsoft est requis
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é.- Ouvrez Paramètres → Communications → Canaux → Microsoft Teams. Vous pouvez également utiliser Open Microsoft Teams setup à partir de l’erreur du Journal des communications.
- Vérifiez que le bon ID de tenant Microsoft Entra est connecté.
- 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.Allpour 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. - 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.
L’application est installée, mais les notifications échouent
L’application est installée, mais les notifications échouent
- 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
Sécurité
Living Security utilise Microsoft GraphUser.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.

