> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Integració amb Microsoft Teams > Connecteu Living Security amb Microsoft Teams per enviar notificacions de Training, alertes de seguretat i anuncis als canals. 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è | Rol | Responsabilitat | | - | - | | **Administrador de Living Security** | Connecta el tenant de Microsoft, descarrega el paquet regional, configura els missatges d'instal·lació, valida la configuració i envia proves | | **Administrador de Microsoft Teams** | Carrega i permet l'aplicació, la distribueix als usuaris o grups previstos i assigna les polítiques de configuració d'aplicacions | | **Administrador de Microsoft Entra**, opcional | Concedeix el consentiment d'aplicació `User.Read.All` a l'identificador d'aplicació del bot regional quan cal la cerca alternativa per correu electrònic/UPN | | **Propietari de Teams**, quan s'utilitza el lliurament a canals | Instal·la o aprova l'aplicació per a l'equip i el canal previstos | 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ó 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ó. 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. 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](#personalitzaci%C3%B3-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. 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. 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. 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. 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. 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](/ca/features/communications/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. Extraieu el fitxer ZIP. Conté exactament tres fitxers a l'arrel de l'arxiu: `manifest.json`, `color.png` i `outline.png`. Substituïu `color.png` i `outline.png` per les vostres pròpies icones. Mantingueu els mateixos dos noms de fitxer. | Fitxer | Requisit | | - | - | | `color.png` | PNG en color, 192 × 192 píxels, sense transparència | | `outline.png` | PNG transparent, 32 × 32 píxels | 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. 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. 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. 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: ```text theme={null} https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id} ``` 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: | Notificació | Descripció | | - | - | | Assignacions de Training | Notifiquen als usuaris quan s'assigna un Training, quan venç o quan està llest per completar | | Recordatoris de Training | Recorden als usuaris els terminis que s'acosten | | Alertes de risc humà | Envien actualitzacions personalitzades del Human Risk Index i els passos següents recomanats | | Missatges de desplegament | Envien notificacions unidireccionals d'incorporació o de desplegament durant la implementació | | Anuncis de canal | Publiquen comunicacions del programa de seguretat als canals de Teams configurats | ## 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](#personalitzaci%C3%B3-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](#personalitzaci%C3%B3-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 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: ```json theme={null} { "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" } } ``` ## 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 Configureu el correu electrònic com a canal de lliurament. Configureu Slack com a canal de lliurament. Feu el seguiment de l'estat i l'historial de lliurament de Teams. Configuració de Microsoft Entra ID i SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.