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.Allper 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è
Configuració
Obriu el tauler de configuració de Microsoft Teams
Connecteu el vostre tenant de Microsoft
Descarregueu el paquet regional de Teams
Carregueu i instal·leu el paquet al centre d'administració de Teams
- 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
Instal·leu o obriu l'aplicació
Configureu els missatges d'instal·lació
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{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.Valideu la configuració
Envieu notificacions de prova
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.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.
Descomprimiu el paquet
manifest.json, color.png i outline.png.Substituïu les icones
color.png i outline.png per les vostres pròpies icones. Mantingueu els mateixos dos
noms de fitxer.Definiu el nom de l'aplicació
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, definiuversionamb 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 deversiondemanifest.jsonque acabeu de descarregar i definiu un valor superior als dos. Mantingueu el formatMAJOR.MINOR.PATCHde tres números.Per exemple, si l’aplicació instal·lada és1.1.1i la vostra descàrrega nova és1.1.0, definiu1.1.2. Si incrementeu1.1.0descarregat a1.1.1, es repetiria la versió instal·lada i Teams rebutjaria la càrrega.
Deixeu els camps d'identitat sense canvis
-
id -
botIdabots -
webApplicationInfo -
validDomains -
contentUrliwebsiteUrlastaticTabs
Torneu a comprimir els tres fitxers
manifest.json es troba dins d’una carpeta.Carregueu i verifiqueu
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
developerdel 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:
- 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.
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
Un usuari no rep una notificació personal
Un usuari no rep una notificació personal
- 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.Alls’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
Un anunci de canal no apareix
Un anunci de canal no apareix
- 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.
La cerca opcional per correu electrònic/UPN o el consentiment falla
La cerca opcional per correu electrònic/UPN o el consentiment falla
- Confirmeu que un administrador de Microsoft Entra ha concedit el consentiment per a tot el tenant per a
Microsoft Graph
User.Read.Allal 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.
El Communication Log mostra que cal el consentiment de l'administrador de Microsoft
El Communication Log mostra que cal el consentiment de l'administrador de Microsoft
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.- Obriu Settings → Communications → Channels → Microsoft Teams. També podeu utilitzar Open Microsoft Teams setup des de l’error del Communication Log.
- Confirmeu que està connectat l’identificador correcte del tenant de Microsoft Entra.
- 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.Allper 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. - 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.
L'aplicació està instal·lada però les notificacions fallen
L'aplicació està instal·lada però les notificacions fallen
- 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ó
Seguretat
Living Security utilitza Microsoft GraphUser.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ó.

