Intégration de Microsoft Teams

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

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 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.

Connecter votre locataire Microsoft

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.

Télécharger le paquet Teams régional

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 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.

Téléverser et installer le paquet dans le centre d'administration Teams

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.

Installer ou ouvrir l'application

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é.

Configurer les messages d'installation

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.

Valider la configuration

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.

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é 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 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.

Décompresser le paquet

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

Remplacer les icônes

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

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é. 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.

Laisser les champs d'identité inchangés

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.

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 paquet dont le manifest.json se trouve dans un dossier.

Téléverser et vérifier

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 :

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.

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 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

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 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

Une annonce dans un 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 du 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 courriel ou UPN ou le consentement échoue

Vérifiez qu’un administrateur Microsoft Entra a accordé le consentement à l’échelle du locataire pour Microsoft Graph User.Read.All à l’ID d’application du robot affiché.
Vérifiez que l’ID du locataire configuré est celui du locataire où 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 locataire.

L'application est installée, mais les notifications échouent

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 :

{
  "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

Intégration du courriel

Configurez le courriel comme canal de diffusion.

Intégration de Slack

Configurez Slack comme canal de diffusion.

Journal des communications

Suivez l’état et l’historique de la livraison des messages Teams.

Authentification

Configuration de Microsoft Entra ID et de l’authentification unique.

Intégrations

Configuration des intégrations

Catalogue

Canaux sortants

Prérequis

Qui fait quoi

Configuration

Personnaliser l’image de marque du paquet régional

Éditeur et somme de contrôle

Facultatif : activer la recherche de secours par adresse courriel ou UPN

Types de notifications

Personnalisation

Mise à jour ou retrait de l’application

Dépannage

Sécurité

Voir aussi

Intégration du courriel

Intégration de Slack

Journal des communications

Authentification

Intégrations

Configuration des intégrations

Catalogue

Canaux sortants

​Prérequis

​Qui fait quoi

​Configuration

​Personnaliser l’image de marque du paquet régional

​Éditeur et somme de contrôle

​Facultatif : activer la recherche de secours par adresse courriel ou UPN

​Types de notifications

​Personnalisation

​Mise à jour ou retrait de l’application

​Dépannage

​Sécurité

​Voir aussi

Intégration du courriel

Intégration de Slack

Journal des communications

Authentification

Prérequis

Qui fait quoi

Configuration

Personnaliser l’image de marque du paquet régional

Éditeur et somme de contrôle

Facultatif : activer la recherche de secours par adresse courriel ou UPN

Types de notifications

Personnalisation

Mise à jour ou retrait de l’application

Dépannage

Sécurité

Voir aussi