Skip to main content
La integració amb Microsoft Teams envia les notificacions de Living Security a usuaris i canals mitjançant l’aplicació Teams de Living Security. Feu-la servir per a assignacions de Training, alertes de risc humà, missatges de desplegament i anuncis de l’equip de seguretat. Aquesta integració només serveix per a notificacions. Els usuaris no envien ordres al bot a Microsoft Teams. Quan s’instal·la l’aplicació, el bot desa la referència de conversa de Teams per a futures notificacions proactives. Els missatges d’instal·lació són unidireccionals i es poden personalitzar o desactivar segons els requisits de desplegament de l’empresa.
Un administrador de Microsoft Teams ha de carregar, aprovar i distribuir igualment l’aplicació Teams de Living Security. El consentiment de l’administrador de Microsoft Entra User.Read.All és opcional i només habilita la cerca alternativa per correu electrònic o nom principal d’usuari (UPN).
Per configurar el lliurament de Nudges i Playbooks, comenceu a Settings → Communications → Channels i feu clic a la targeta Microsoft Teams. Aquesta pàgina tracta la configuració subjacent de l’aplicació Teams.

Prerequisits

Abans de configurar Microsoft Teams, assegureu-vos de disposar de:
  • Un administrador de Microsoft Teams que pugui carregar i aprovar aplicacions de l’organització. La mateixa persona pot tenir els dos rols d’administrador.
  • Un administrador de Microsoft Entra només si voleu habilitar la cerca alternativa opcional per correu electrònic/UPN amb el consentiment d’aplicació User.Read.All per a tot el tenant
  • Privilegis d’administrador de Living Security
  • Una organització activa de Living Security
  • Els noms de l’equip i del canal on s’han de lliurar els anuncis de seguretat, si els anuncis de canal estan habilitats
  • L’identificador del vostre tenant de Microsoft Entra, disponible a Microsoft Entra admin center → Identity → Overview

Qui fa què

Poden ser persones diferents. Compartiu amb l’administrador de Microsoft Teams la suma de verificació del paquet, l’identificador d’aplicació de Teams, el Bot app ID i la població prevista per al desplegament. Compartiu l’URL de consentiment generat amb un administrador de Microsoft Entra només quan habiliteu la cerca alternativa opcional per correu electrònic/UPN. No compartiu altres credencials de Living Security que no hi tinguin relació.

Configuració

1

Obriu el tauler de configuració de Microsoft Teams

A Living Security, aneu a Settings → Communications → Channels i seleccioneu Microsoft Teams.El tauler mostra la regió de la vostra organització, el nom del fitxer del paquet, l’identificador d’aplicació de Teams, l’identificador d’aplicació del bot, la suma de verificació SHA256, l’estat de la configuració del tenant de Microsoft, les instruccions d’instal·lació, els controls dels missatges d’instal·lació, la validació i les eines de notificació de prova.
La regió que es mostra a Living Security coincideix amb la regió on està allotjada la vostra organització.
2

Connecteu el vostre tenant de Microsoft

A Connect your tenant, introduïu l’identificador del tenant de Microsoft Entra que és propietari dels usuaris i dels canals de Teams que rebran les notificacions i, a continuació, feu clic a Save Microsoft tenant. Un tenant de Microsoft només pot pertànyer a una organització de Living Security.Si el control del tenant no està disponible, poseu-vos en contacte amb el responsable d’implementació de Living Security o amb el contacte d’assistència per connectar o canviar el tenant abans d’instal·lar l’aplicació.
Living Security mostra Microsoft tenant connected abans que continuïu.
Si és possible, connecteu el tenant abans d’instal·lar l’aplicació Teams. Si l’aplicació ja està instal·lada, deseu el tenant i seleccioneu primer Validate install. Living Security intenta associar automàticament la instal·lació existent; reinstal·leu l’aplicació només si la validació no la pot detectar.
3

Descarregueu el paquet regional de Teams

Feu clic a Download Teams package. Living Security proporciona un paquet ZIP específic de la regió per a la vostra organització.Verifiqueu el fitxer descarregat amb la suma de verificació SHA256 que es mostra a Living Security abans de canviar res. Per donar a l’aplicació el vostre propi nom i les vostres icones, seguiu Personalització de marca del paquet regional després d’aquesta comprovació i abans de carregar el paquet.
La suma de verificació del fitxer descarregat coincideix amb la suma de verificació SHA256 que es mostra a Living Security.
4

Carregueu i instal·leu el paquet al centre d'administració de Teams

Al centre d’administració de Microsoft Teams, aneu a Teams apps → Manage apps → Actions → Upload new app i carregueu el fitxer ZIP descarregat de Living Security.Confirmeu que:
  • L’identificador d’aplicació de Teams i l’identificador d’aplicació del bot coincideixen amb els valors que es mostren a Living Security
  • El nom de l’aplicació és el nom regional de Living Security, o el nom que hàgiu definit si heu personalitzat la marca del paquet
  • L’editor és Living Security. La personalització de marca del paquet no canvia l’editor
  • L’aplicació no està bloquejada
  • L’aplicació està disponible per als usuaris o grups previstos
  • L’aplicació s’instal·la mitjançant polítiques de configuració d’aplicacions o instal·lació dirigida per als usuaris i els equips/canals que han de rebre notificacions
Microsoft pot trigar a propagar la disponibilitat de l’aplicació i els canvis de les polítiques de configuració.
Si la validació o una prova falla immediatament després d’un canvi de política d’aplicacions, confirmeu l’assignació de la política al centre d’administració de Microsoft Teams i torneu-ho a provar quan Microsoft hagi acabat de propagar-la.
5

Instal·leu o obriu l'aplicació

Distribuïu l’aplicació personal als usuaris previstos. Perquè Living Security pugui enviar una prova personal a una instal·lació detectada, almenys un usuari ha d’instal·lar o obrir l’aplicació personal de Living Security a Microsoft Teams. Això permet que el bot capturi la identitat de confiança de l’usuari i la referència de conversa personal. Una instal·lació només en un canal no es pot utilitzar per a una prova personal d’instal·lació detectada.Per al lliurament a canals, instal·leu l’aplicació a l’equip i al canal previstos perquè el bot pugui capturar la referència de conversa d’aquest canal.
Un usuari de destinació ha instal·lat o obert l’aplicació personal, o l’aplicació està instal·lada al canal previst.
6

Configureu els missatges d'instal·lació

A la secció Install message controls, trieu si s’envien missatges d’instal·lació de Teams i personalitzeu el text unidireccional per a la vostra organització.Controls disponibles:
  • Send install messages
  • Send personal install messages
  • Send channel install messages
  • Default message
  • Personal message
  • Channel message
Els camps de missatge admeten {{installerName}}, que es resol amb el nom visible de l’usuari que ha instal·lat l’aplicació. Deixeu en blanc un missatge personal o de canal per utilitzar el missatge predeterminat configurat. Si el missatge predeterminat també està en blanc, Living Security utilitza el missatge integrat per a aquest àmbit.
7

Valideu la configuració

Feu clic a Validate install a Living Security. La validació comprova que el paquet regional està disponible, que la configuració del tenant de Microsoft existeix i és exclusiva d’aquesta organització de Living Security, que les credencials regionals del bot estan configurades i que s’ha detectat una instal·lació activa de l’aplicació per al tenant connectat.
La validació mostra Validation passed abans que envieu notificacions reals.
8

Envieu notificacions de prova

Per a la prova personal predeterminada, feu clic a Send test to detected installation. Living Security selecciona una instal·lació personal activa detectada i utilitza la identitat de confiança i la referència de conversa desades. Aquesta prova no crida Microsoft Graph i no requereix el consentiment User.Read.All.Si no es detecta cap instal·lació personal, demaneu a un usuari que instal·li o obri l’aplicació personal de Living Security, seleccioneu Validate install de nou i, a continuació, torneu a enviar la prova. Utilitzeu la prova avançada dirigida per correu electrònic/UPN només quan la cerca alternativa opcional estigui habilitada.
La notificació de prova unidireccional apareix a Microsoft Teams.
Reviseu l’intent corresponent al Communication Log quan necessiteu diagnòstics de lliurament.

Personalització de marca del paquet regional

El paquet regional és un arxiu ZIP de tres fitxers: manifest.json, color.png i outline.png. Podeu definir el vostre propi nom d’aplicació i les vostres icones en aquest paquet abans de carregar-lo. Living Security admet aquest procediment per als paquets regionals que un administrador de Teams carrega directament. Feu-ho després de descarregar i verificar el paquet, i abans de carregar-lo al centre d’administració de Teams.
1

Descomprimiu el paquet

Extraieu el fitxer ZIP. Conté exactament tres fitxers a l’arrel de l’arxiu: manifest.json, color.png i outline.png.
2

Substituïu les icones

Substituïu color.png i outline.png per les vostres pròpies icones. Mantingueu els mateixos dos noms de fitxer.
3

Definiu el nom de l'aplicació

A manifest.json, editeu aquests dos camps:
  • name.short: el nom que es mostra a la capçalera de l’aplicació de Teams i en altres àrees amb espai limitat. Màxim 30 caràcters.
  • name.full: el nom que es mostra al catàleg d’aplicacions i als detalls de l’aplicació. Màxim 100 caràcters.
    Si ja hi ha una aplicació de Living Security carregada al centre d’administració de Teams, definiu version amb un valor superior a la versió que hi ha instal·lada. Microsoft Teams rebutja una actualització que no incrementi la versió, i una descàrrega nova pot tenir la mateixa versió que el paquet que ja heu instal·lat, o una d’inferior.Consulteu la versió instal·lada al centre d’administració de Teams a Teams apps → Manage apps, a la pàgina de detalls de l’aplicació. Compareu-la amb el valor de version de manifest.json que acabeu de descarregar i definiu un valor superior als dos. Mantingueu el format MAJOR.MINOR.PATCH de tres números.Per exemple, si l’aplicació instal·lada és 1.1.1 i la vostra descàrrega nova és 1.1.0, definiu 1.1.2. Si incrementeu 1.1.0 descarregat a 1.1.1, es repetiria la versió instal·lada i Teams rebutjaria la càrrega.
4

Deixeu els camps d'identitat sense canvis

No canvieu aquests camps. Cadascun conté la identitat de l’aplicació, del bot o de l’inici de sessió únic:
  • id
  • botId a bots
  • webApplicationInfo
  • validDomains
  • contentUrl i websiteUrl a staticTabs
    Un canvi en un camp d’identitat pot deixar l’aplicació instal·lable però incapaç de lliurar notificacions o de completar l’inici de sessió únic. Validate install comprova el tenant, les credencials del bot i la instal·lació detectada. No compara el vostre manifest amb el paquet que ha creat Living Security.
5

Torneu a comprimir els tres fitxers

Creeu un arxiu ZIP nou amb els tres fitxers. Poseu-los a l’arrel de l’arxiu, sense cap carpeta contenidora. Microsoft Teams rebutja un paquet en què manifest.json es troba dins d’una carpeta.
6

Carregueu i verifiqueu

Carregueu el fitxer ZIP amb la marca personalitzada al centre d’administració de Teams, torneu a Living Security i feu clic a Validate install. Envieu una notificació de prova.
La validació mostra Validation passed i la notificació de prova arriba a Microsoft Teams amb el nom i les icones de la vostra aplicació.

Editor i suma de verificació

La personalització de marca defineix el nom i les icones de l’aplicació. No canvia dues coses:
  • L’editor continua sent Living Security. Els camps developer del manifest indiquen Living Security i enllacen amb el lloc web, la política de privadesa i les condicions del servei de Living Security. Conjuntament identifiquen l’empresa que opera el servei, de manera que Teams continua mostrant Living Security com a editor a la pàgina de detalls de l’aplicació, als diàlegs de consentiment de permisos i als informes d’ús de l’aplicació. El vostre nom i les vostres icones són el que els usuaris veuen a la capçalera de l’aplicació, al catàleg d’aplicacions i a les notificacions.
  • La suma de verificació SHA256 deixa de coincidir. La suma de verificació que es mostra a Living Security descriu el paquet tal com es descarrega. Verifiqueu-la abans d’editar els fitxers i, a continuació, registreu la suma de verificació del vostre propi paquet amb marca personalitzada per als vostres registres de desplegament.

Opcional: habiliteu la cerca alternativa per correu electrònic/UPN

El lliurament personal normal utilitza un identificador d’objecte de Microsoft Entra de confiança que Living Security ja coneix, juntament amb la referència de conversa del bot capturada quan l’usuari instal·la o obre l’aplicació. El lliurament a canals utilitza la referència de conversa del canal desada. Cap de les dues vies requereix Microsoft Graph. Si un destinatari no té un identificador d’objecte d’Entra de confiança, Living Security pot utilitzar opcionalment Microsoft Graph per resoldre el destinatari per adreça de correu electrònic o UPN. Per habilitar aquesta alternativa, demaneu a un administrador de Microsoft Entra que faci clic a Grant optional User.Read.All consent al tauler de configuració de Teams i aprovi el permís d’aplicació User.Read.All de Microsoft Graph per a l’aplicació Teams regional de Living Security. El flux de consentiment de l’administrador segueix aquest patró de Microsoft Entra:
Living Security genera aquest URL a partir de l’identificador del tenant connectat i del Bot app ID que es mostra al tauler de configuració. Els identificadors tenen finalitats diferents:
  • Teams app ID identifica el paquet d’aplicació instal·lable al centre d’administració de Microsoft Teams.
  • Bot app ID identifica l’aplicació de Microsoft Entra del bot regional i és l’identificador de client que s’utilitza per al flux opcional de consentiment de l’administrador.
No substituïu el Teams app ID a l’URL de consentiment. La integració Microsoft Entra ID (Client Credentials) que hi ha a Connected Integrations és una integració independent i genèrica. El bot regional de Teams no pot reutilitzar-ne les credencials ni el consentiment, i el consentiment concedit a una aplicació d’Entra sense relació no habilita aquesta alternativa.
El fet que el consentiment sigui opcional no elimina User.Read.All dels registres d’aplicació regionals existents de Living Security. Els clients que ja han concedit el consentiment poden continuar utilitzant l’alternativa per correu electrònic/UPN sense cap reconfiguració.

Tipus de notificació

Segons els drets de la vostra organització i els Playbooks configurats, Living Security pot enviar:

Personalització

Les notificacions de Teams utilitzen la configuració de la vostra organització de Living Security. Els camps admesos inclouen el nom visible del client, els camps de logotip i marca admesos, el text dels missatges, les crides a l’acció, els enllaços de destinació, el text de desplegament i el text d’assistència/contacte. Els missatges d’instal·lació es poden configurar a Settings → Communications → Channels → Microsoft Teams → Install message controls. Podeu desactivar completament els missatges d’instal·lació, desactivar només els missatges d’instal·lació personals o de canal, i configurar el text predeterminat, personal o específic del canal. El nom i les icones de l’aplicació Teams provenen del paquet regional. Per definir els vostres, consulteu Personalització de marca del paquet regional.

Actualització o eliminació de l’aplicació

  • Quan Living Security proporcioni un paquet regional actualitzat, descarregueu-lo des del tauler del canal de Microsoft Teams i carregueu aquest paquet mitjançant el centre d’administració de Teams. Verifiqueu l’identificador d’aplicació, l’identificador del bot i la suma de verificació que es mostren abans del desplegament.
  • Les edicions de marca no sobreviuen a una actualització del paquet. Cada paquet regional nou torna a portar el nom i les icones de l’aplicació de Living Security. Torneu a aplicar les vostres edicions amb Personalització de marca del paquet regional abans de carregar el paquet nou. Conserveu en un lloc accessible les vostres icones, els vostres dos valors de nom i la versió que vau carregar per última vegada, de manera que cada actualització sigui una repetició breu dels mateixos passos. Un paquet nou no sempre té una versió superior a la que heu instal·lat, de manera que definiu la versió a partir del que Teams mostra com a instal·lat.
  • Torneu a executar Validate install i envieu una altra prova després d’una actualització de l’aplicació o de les polítiques.
  • Eliminar o bloquejar l’aplicació impedeix les notificacions proactives a aquest usuari o canal. Reinstal·leu l’aplicació i envieu una prova nova perquè Living Security rebi un esdeveniment d’instal·lació de Teams actual.
  • Si deixeu d’utilitzar el lliurament per Teams, traieu Teams dels Playbooks corresponents abans d’eliminar l’aplicació de Microsoft Teams.

Resolució de problemes

  • Confirmeu que l’aplicació personal de Teams de Living Security està instal·lada i que l’usuari l’ha oberta perquè Living Security tingui una referència de conversa actual
  • Confirmeu que l’identificador del tenant de Microsoft configurat és el tenant on es troba l’usuari
  • Si els diagnòstics mostren que s’ha intentat l’alternativa per correu electrònic/UPN, confirmeu que el consentiment d’administrador User.Read.All s’ha concedit al Bot app ID mostrat per al tenant correcte
  • Quan s’utilitza l’alternativa per correu electrònic/UPN, verifiqueu que el correu electrònic o l’UPN de l’usuari a Living Security coincideix amb Microsoft Entra ID
  • Demaneu a l’usuari que desbloquegi o reinstal·li l’aplicació si abans l’havia eliminat o bloquejat
  • Confirmeu que l’aplicació Teams de Living Security està instal·lada a l’equip o canal de destinació.
  • Confirmeu que l’assignació de canal a Living Security utilitza l’equip i el canal correctes.
  • Comproveu si el canal s’ha eliminat, canviat de nom, arxivat o restringit.
  • Reinstal·leu l’aplicació a l’equip o canal de destinació i envieu una altra notificació de prova.
  • Confirmeu que un administrador de Microsoft Entra ha concedit el consentiment per a tot el tenant per a Microsoft Graph User.Read.All al Bot app ID mostrat.
  • Confirmeu que l’identificador del tenant configurat és el tenant on es troben els usuaris i Teams.
  • Verifiqueu que l’usuari existeix a Microsoft Entra ID i que no és un convidat d’un altre tenant.
La categoria d’error TEAMS_ADMIN_CONSENT_REQUIRED, o l’error de Microsoft AADSTS7000229, significa que una cerca de destinatari per correu electrònic/UPN ha intentat l’alternativa opcional de Microsoft Graph, però l’aplicació Teams regional de Living Security no té cap entitat de servei (aplicació empresarial) al tenant de Microsoft Entra connectat. Les vies predeterminades d’identificador de confiança i de conversa desada no requereixen aquest consentiment. No es tracta d’un secret de Living Security caducat.
  1. Obriu Settings → Communications → Channels → Microsoft Teams. També podeu utilitzar Open Microsoft Teams setup des de l’error del Communication Log.
  2. Confirmeu que està connectat l’identificador correcte del tenant de Microsoft Entra.
  3. Si cal l’alternativa per correu electrònic/UPN, demaneu a un administrador de Microsoft Entra que faci clic a Grant optional User.Read.All consent i aprovi User.Read.All per al Bot app ID mostrat. En cas contrari, assegureu-vos que el destinatari ha obert l’aplicació personal i que Living Security té el seu identificador d’objecte d’Entra de confiança.
  4. Quan Microsoft hagi acabat de processar el consentiment, envieu una prova avançada dirigida per correu electrònic/UPN des de la configuració de Microsoft Teams. El Communication Log mostra l’historial de lliurament i els diagnòstics; no torna a lliurar el missatge fallit.
Reconfigurar Microsoft Entra ID (Client Credentials) no resol aquest error perquè el lliurament de notificacions de Teams no utilitza aquesta integració.
  • Comproveu si el bot s’ha bloquejat, eliminat o desinstal·lat
  • Si l’aplicació es va instal·lar abans que el tenant es connectés a Living Security, deseu el tenant i seleccioneu Validate install perquè Living Security pugui associar la instal·lació existent
  • Reinstal·leu l’aplicació només si la validació no pot detectar la instal·lació existent
  • Confirmeu que l’usuari o el canal de destinació ha rebut l’últim esdeveniment d’instal·lació de l’aplicació
  • Envieu una notificació de prova nova després de reinstal·lar l’aplicació
Exemple de camps de l’esdeveniment d’instal·lació utilitzats per a la resolució de problemes:

Seguretat

Living Security utilitza Microsoft Graph User.Read.All només per a l’alternativa opcional de cerca de destinataris per correu electrònic/UPN. De manera predeterminada, l’encaminament de notificacions personals utilitza un identificador d’objecte d’Entra de confiança de les dades d’entitat de Living Security i la referència de conversa del bot capturada de Microsoft Teams. Els identificadors d’objecte i les referències de conversa proporcionats pel sol·licitant no es consideren dades d’encaminament de confiança. Els missatges de Microsoft Teams es lliuren mitjançant el bot de Teams de Living Security, exclusivament de notificacions, utilitzant la missatgeria proactiva de Microsoft Teams. Living Security no requereix que els clients creïn el seu propi registre d’aplicació de Microsoft Entra ni que comparteixin un secret de client propi per a la configuració estàndard de l’aplicació Teams. Els paquets de Teams específics de cada regió mantenen alineats l’identificador d’aplicació, l’identificador del bot i el punt final de missatgeria amb la regió de Living Security on està allotjada la vostra organització.

Relacionat

Integració amb el correu electrònic

Configureu el correu electrònic com a canal de lliurament.

Integració amb Slack

Configureu Slack com a canal de lliurament.

Communication Log

Feu el seguiment de l’estat i l’historial de lliurament de Teams.

Autenticació

Configuració de Microsoft Entra ID i SSO.