> ## 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. # Integrarea Microsoft Teams > Conectați Living Security la Microsoft Teams pentru a trimite notificări de instruire, alerte de securitate și anunțuri pe canale. Integrarea Microsoft Teams trimite notificările Living Security către utilizatori și canale prin aplicația Living Security pentru Teams. Utilizați-o pentru atribuiri de instruire, alerte privind riscul uman, mesaje de implementare și anunțuri ale echipei de securitate. Această integrare este destinată exclusiv notificărilor. Utilizatorii nu trimit comenzi către bot în Microsoft Teams. La instalarea aplicației, botul stochează referința conversației din Teams pentru notificările proactive viitoare. Mesajele de instalare sunt unidirecționale și pot fi personalizate sau dezactivate în funcție de cerințele de implementare ale întreprinderii. Un administrator Microsoft Teams trebuie în continuare să încarce, să aprobe și să distribuie aplicația Living Security pentru Teams. Consimțământul administratorului pentru Microsoft Entra `User.Read.All` este opțional și activează doar soluția de rezervă de căutare după adresa de e-mail sau după numele principal de utilizator (UPN). Pentru configurarea livrării Îndemnurilor și a Playbook-urilor, începeți din **Setări → Comunicații → Canale** și faceți clic pe cardul **Microsoft Teams**. Această pagină acoperă configurarea de bază a aplicației Teams. ## Cerințe preliminare Înainte de a configura Microsoft Teams, asigurați-vă că aveți: * Un administrator Microsoft Teams care poate încărca și aproba aplicații ale organizației. Aceeași persoană poate deține ambele roluri de administrator. * Un administrator Microsoft Entra, doar dacă doriți să activați soluția de rezervă opțională de căutare după e-mail/UPN cu consimțământ `User.Read.All` pentru aplicație la nivel de tenant * Privilegii de administrator Living Security * O organizație Living Security activă * Numele echipelor și ale canalelor în care trebuie livrate anunțurile de securitate, dacă anunțurile pe canale sunt activate * ID-ul tenantului dvs. Microsoft Entra, disponibil în **Microsoft Entra admin center → Identitate → Prezentare generală** ## Cine ce face | Rol | Responsabilitate | | - | - | | **Administrator Living Security** | Conectează tenantul Microsoft, descarcă pachetul regional, configurează mesajele de instalare, validează configurarea și trimite teste | | **Administrator Microsoft Teams** | Încarcă și permite aplicația, o distribuie utilizatorilor sau grupurilor vizate și atribuie politici de configurare a aplicației | | **Administrator Microsoft Entra**, opțional | Acordă consimțământul `User.Read.All` pentru aplicație ID-ului aplicației Bot regionale atunci când este necesară soluția de rezervă de căutare după e-mail/UPN | | **Proprietar Teams**, când se utilizează livrarea pe canale | Instalează sau aprobă aplicația pentru echipa și canalul vizate | Aceste roluri pot fi deținute de persoane diferite. Transmiteți administratorului Microsoft Teams suma de control a pachetului, ID-ul aplicației Teams, **ID-ul aplicației Bot** și populația vizată de implementare. Transmiteți URL-ul de consimțământ generat unui administrator Microsoft Entra numai atunci când activați soluția de rezervă opțională de căutare după e-mail/UPN. Nu partajați alte credențiale Living Security fără legătură. ## Configurare În Living Security, accesați **Setări → Comunicații → Canale** și selectați **Microsoft Teams**. Panoul afișează regiunea organizației dvs., numele fișierului pachetului, ID-ul aplicației Teams, ID-ul aplicației bot, suma de control SHA256, starea configurării tenantului Microsoft, instrucțiunile de instalare, controalele mesajelor de instalare, validarea și instrumentele pentru notificări de test. Regiunea afișată în Living Security corespunde regiunii în care este găzduită organizația dvs. În **Connect your tenant**, introduceți ID-ul tenantului Microsoft Entra care deține utilizatorii și canalele Teams ce primesc notificări, apoi faceți clic pe **Save Microsoft tenant**. Un tenant Microsoft poate aparține unei singure organizații Living Security. Dacă controlul pentru tenant nu este disponibil, colaborați cu responsabilul dvs. de implementare Living Security sau cu persoana de contact din asistență pentru a conecta sau a schimba tenantul înainte de instalarea aplicației. Living Security afișează **Microsoft tenant connected** înainte de a continua. Conectați tenantul înainte de a instala aplicația Teams, atunci când este posibil. Dacă aplicația este deja instalată, salvați tenantul și selectați mai întâi **Validate install**. Living Security încearcă să asocieze automat instalarea existentă; reinstalați doar dacă validarea nu o poate detecta. Faceți clic pe **Download Teams package**. Living Security furnizează un pachet ZIP specific regiunii pentru organizația dvs. Verificați fișierul descărcat în raport cu suma de control SHA256 afișată în Living Security înainte de a modifica orice. Pentru a atribui aplicației propriul nume și propriile pictograme, urmați [Personalizarea identității vizuale a pachetului regional](#personalizarea-identit%C4%83%C8%9Bii-vizuale-a-pachetului-regional) după această verificare și înainte de a încărca pachetul. Suma de control a fișierului descărcat corespunde sumei de control SHA256 afișate în Living Security. În Microsoft Teams admin center, accesați **Teams apps → Manage apps → Actions → Upload new app**, apoi încărcați fișierul ZIP descărcat din Living Security. Confirmați: * ID-ul aplicației Teams și ID-ul aplicației bot corespund valorilor afișate în Living Security * Numele aplicației este numele regional Living Security sau numele pe care l-ați setat dacă ați personalizat pachetul * Editorul este **Living Security**. Personalizarea identității vizuale a pachetului nu schimbă editorul * Aplicația este deblocată * Aplicația este disponibilă utilizatorilor sau grupurilor vizate * Aplicația este instalată prin politici de configurare a aplicației sau prin instalare țintită pentru utilizatorii și echipele/canalele care trebuie să primească notificări Microsoft poate avea nevoie de timp pentru a propaga disponibilitatea aplicației și modificările politicilor de configurare. Dacă validarea sau un test eșuează imediat după o modificare a politicii aplicației, confirmați atribuirea politicii în Microsoft Teams admin center și reîncercați după ce Microsoft termină propagarea acesteia. Distribuiți aplicația personală utilizatorilor vizați. Înainte ca Living Security să poată trimite un test personal către o instalare detectată, cel puțin un utilizator trebuie să instaleze sau să deschidă aplicația personală Living Security în Microsoft Teams. Astfel, botul poate captura identitatea de încredere a utilizatorului și referința conversației personale. O instalare pe un canal nu poate fi utilizată singură pentru un test personal pe o instalare detectată. Pentru livrarea pe canale, instalați aplicația în echipa și canalul vizate, astfel încât botul să poată captura referința conversației canalului respectiv. Un utilizator țintă a instalat sau a deschis aplicația personală ori aplicația este instalată în canalul vizat. În secțiunea **Install message controls**, alegeți dacă se trimit mesaje de instalare în Teams și personalizați textul unidirecțional pentru organizația dvs. Controale disponibile: * Send install messages * Send personal install messages * Send channel install messages * Default message * Personal message * Channel message Câmpurile de mesaj acceptă `{{installerName}}`, care se înlocuiește cu numele afișat al utilizatorului care a instalat aplicația. Lăsați necompletat un mesaj personal sau de canal pentru a utiliza mesajul implicit configurat. Dacă și mesajul implicit este necompletat, Living Security utilizează mesajul încorporat pentru acel domeniu. Faceți clic pe **Validate install** în Living Security. Validarea verifică dacă pachetul regional este disponibil, dacă configurarea tenantului Microsoft este prezentă și unică pentru această organizație Living Security, dacă credențialele botului regional sunt configurate și dacă a fost detectată o instalare activă a aplicației pentru tenantul conectat. Validarea afișează **Validation passed** înainte de a trimite notificări reale. Pentru testul personal implicit, faceți clic pe **Send test to detected installation**. Living Security selectează o instalare personală activă detectată și utilizează identitatea de încredere și referința conversației stocate. Acest test nu apelează Microsoft Graph și nu necesită consimțământul `User.Read.All`. Dacă nu este detectată nicio instalare personală, rugați un utilizator să instaleze sau să deschidă aplicația personală Living Security, selectați din nou **Validate install**, apoi retrimiteți testul. Utilizați testul avansat țintit după e-mail/UPN numai atunci când soluția de rezervă opțională de căutare este activată. Notificarea de test unidirecțională apare în Microsoft Teams. Consultați încercarea corespunzătoare în [Jurnalul de comunicații](/ro/features/communications/log) atunci când sunt necesare diagnostice de livrare. ## Personalizarea identității vizuale a pachetului regional Pachetul regional este o arhivă ZIP cu trei fișiere: `manifest.json`, `color.png` și `outline.png`. Puteți seta propriul nume de aplicație și propriile pictograme în acest pachet înainte de a-l încărca. Living Security acceptă această metodă pentru pachetele regionale pe care un administrator Teams le încarcă direct. Efectuați această operațiune după ce descărcați și verificați pachetul și înainte de a-l încărca în Teams admin center. Extrageți fișierul ZIP. Acesta conține exact trei fișiere în rădăcina arhivei: `manifest.json`, `color.png` și `outline.png`. Înlocuiți `color.png` și `outline.png` cu propriile pictograme. Păstrați aceleași două nume de fișiere. | Fișier | Cerință | | - | - | | `color.png` | PNG color, 192 × 192 pixeli, fără transparență | | `outline.png` | PNG transparent, 32 × 32 pixeli | În `manifest.json`, editați aceste două câmpuri: * `name.short` — numele afișat în antetul aplicației Teams și în alte zone cu spațiu limitat. Maximum 30 de caractere. * `name.full` — numele afișat în catalogul de aplicații și în detaliile aplicației. Maximum 100 de caractere. Dacă o aplicație Living Security este deja încărcată în Teams admin center, setați `version` la o valoare mai mare decât versiunea instalată acolo. Microsoft Teams refuză o actualizare care nu mărește versiunea, iar o descărcare nouă poate avea aceeași versiune ca pachetul deja instalat sau una mai mică. Citiți versiunea instalată în Teams admin center, la **Teams apps → Manage apps**, pe pagina cu detaliile aplicației. Comparați-o cu valoarea `version` din `manifest.json` pe care tocmai l-ați descărcat, apoi setați o valoare mai mare decât ambele. Păstrați formatul `MAJOR.MINOR.PATCH` cu trei numere. De exemplu, dacă aplicația instalată este `1.1.1`, iar noua descărcare este `1.1.0`, setați `1.1.2`. Creșterea valorii `1.1.0` descărcate la `1.1.1` ar repeta versiunea instalată, iar Teams ar refuza încărcarea. Nu modificați aceste câmpuri. Fiecare dintre ele poartă identitatea aplicației, a botului sau a autentificării unice: * `id` * `botId` în `bots` * `webApplicationInfo` * `validDomains` * `contentUrl` și `websiteUrl` în `staticTabs` Modificarea unui câmp de identitate poate lăsa aplicația instalabilă, dar incapabilă să livreze notificări sau să finalizeze autentificarea unică. **Validate install** verifică tenantul, credențialele botului și instalarea detectată. Nu compară manifestul dvs. cu pachetul creat de Living Security. Creați o nouă arhivă ZIP din cele trei fișiere. Plasați-le în rădăcina arhivei, fără un folder care să le includă. Microsoft Teams refuză un pachet al cărui `manifest.json` se află într-un folder. Încărcați fișierul ZIP cu identitate vizuală personalizată în Teams admin center, apoi reveniți în Living Security și faceți clic pe **Validate install**. Trimiteți o notificare de test. Validarea afișează **Validation passed**, iar notificarea de test ajunge în Microsoft Teams sub numele și pictogramele aplicației dvs. ### Editor și sumă de control Personalizarea identității vizuale setează numele și pictogramele aplicației. Nu modifică două aspecte: * **Editorul rămâne Living Security.** Câmpurile `developer` din manifest indică Living Security și trimit către site-ul web Living Security, politica de confidențialitate și termenii și condițiile. Împreună, acestea identifică firma care operează serviciul, astfel că Teams continuă să afișeze **Living Security** ca editor pe pagina cu detaliile aplicației, în dialogurile de consimțământ pentru permisiuni și în rapoartele de utilizare a aplicației. Numele și pictogramele dvs. sunt ceea ce văd utilizatorii în antetul aplicației, în catalogul de aplicații și în notificări. * **Suma de control SHA256 nu se mai potrivește.** Suma de control afișată în Living Security descrie pachetul așa cum a fost descărcat. Verificați-o înainte de a edita fișierele, apoi înregistrați suma de control a propriului pachet cu identitate vizuală personalizată pentru evidențele dvs. de implementare. ## Opțional: activați soluția de rezervă de căutare după e-mail/UPN Livrarea personală obișnuită utilizează un ID de obiect Microsoft Entra de încredere, deja cunoscut de Living Security, împreună cu referința conversației botului capturată atunci când utilizatorul instalează sau deschide aplicația. Livrarea pe canale utilizează referința conversației canalului stocată. Niciuna dintre aceste căi nu necesită Microsoft Graph. Dacă un destinatar nu are un ID de obiect Entra de încredere, Living Security poate utiliza opțional Microsoft Graph pentru a identifica destinatarul după adresa de e-mail sau UPN. Pentru a activa această soluție de rezervă, rugați un administrator Microsoft Entra să facă clic pe **Grant optional User.Read.All consent** în panoul de configurare Teams și să aprobe permisiunea de aplicație Microsoft Graph `User.Read.All` pentru aplicația regională Living Security pentru Teams. Fluxul de consimțământ al administratorului urmează acest model Microsoft Entra: ```text theme={null} https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id} ``` Living Security generează acest URL pornind de la ID-ul tenantului conectat și de la **ID-ul aplicației Bot** afișat în panoul de configurare. ID-urile au scopuri diferite: * **ID-ul aplicației Teams** identifică pachetul de aplicație instalabil în Microsoft Teams admin center. * **ID-ul aplicației Bot** identifică aplicația Microsoft Entra a botului regional și este ID-ul de client utilizat pentru fluxul opțional de consimțământ al administratorului. Nu înlocuiți ID-ul aplicației Bot cu ID-ul aplicației Teams în URL-ul de consimțământ. Integrarea **Microsoft Entra ID (Client Credentials)** din Integrări conectate este o integrare generică, separată. Credențialele sau consimțământul acesteia nu pot fi reutilizate de botul regional Teams, iar consimțământul acordat unei aplicații Entra fără legătură nu activează această soluție de rezervă. Faptul că acordarea consimțământului este opțională nu elimină `User.Read.All` din înregistrările existente ale aplicațiilor regionale Living Security. Clienții care au acordat deja consimțământul pot continua să utilizeze soluția de rezervă după e-mail/UPN fără reconfigurare. ## Tipuri de notificări În funcție de drepturile organizației dvs. și de Playbook-urile configurate, Living Security poate trimite: | Notificare | Descriere | | - | - | | Atribuiri de instruire | Notifică utilizatorii când o instruire este atribuită, scadentă sau gata de finalizat | | Mementouri de instruire | Reamintesc utilizatorilor termenele limită apropiate | | Alerte privind riscul uman | Trimit actualizări personalizate ale Indicelui riscului uman și pașii următori recomandați | | Mesaje de implementare | Trimit notificări unidirecționale de integrare sau de implementare în timpul desfășurării | | Anunțuri pe canale | Publică comunicări ale programului de securitate în canalele Teams configurate | ## Personalizare Notificările Teams utilizează configurația organizației dvs. Living Security. Câmpurile acceptate includ numele afișat al clientului, câmpurile acceptate pentru siglă și identitate de brand, textul mesajelor, apelurile la acțiune, linkurile de destinație, textul de implementare și textul de asistență/contact. Mesajele de instalare pot fi configurate din **Setări → Comunicații → Canale → Microsoft Teams → Install message controls**. Puteți dezactiva complet mesajele de instalare, puteți dezactiva doar mesajele de instalare personale sau de canal și puteți configura texte implicite, personale sau specifice canalului. Numele și pictogramele aplicației Teams provin din pachetul regional. Pentru a le seta pe ale dvs., consultați [Personalizarea identității vizuale a pachetului regional](#personalizarea-identit%C4%83%C8%9Bii-vizuale-a-pachetului-regional). ## Actualizarea sau eliminarea aplicației * Când Living Security furnizează un pachet regional actualizat, descărcați-l din panoul canalului Microsoft Teams și încărcați-l prin Teams admin center. Verificați ID-ul aplicației, ID-ul botului și suma de control afișate înainte de implementare. * Modificările de identitate vizuală nu se păstrează la actualizarea unui pachet. Fiecare pachet regional nou conține din nou numele și pictogramele aplicației Living Security. Reaplicați modificările urmând [Personalizarea identității vizuale a pachetului regional](#personalizarea-identit%C4%83%C8%9Bii-vizuale-a-pachetului-regional) înainte de a încărca noul pachet. Păstrați într-un loc accesibil pictogramele, cele două valori de nume și versiunea pe care ați încărcat-o ultima dată, astfel încât fiecare actualizare să fie o scurtă repetare a acelorași pași. Un pachet nou nu are întotdeauna o versiune mai mare decât cea instalată, așa că setați versiunea în funcție de ceea ce afișează Teams ca instalat. * Rulați din nou **Validate install** și trimiteți un alt test după o actualizare a aplicației sau a politicii. * Eliminarea sau blocarea aplicației împiedică notificările proactive către utilizatorul sau canalul respectiv. Reinstalați aplicația și trimiteți un test nou, astfel încât Living Security să primească un eveniment de instalare Teams actual. * Dacă opriți livrarea prin Teams, eliminați Teams din Playbook-urile relevante înainte de a elimina aplicația din Microsoft Teams. ## Depanare * Confirmați că aplicația personală Living Security pentru Teams este instalată și că utilizatorul a deschis-o, astfel încât Living Security să aibă o referință de conversație actuală * Confirmați că ID-ul tenantului Microsoft configurat este tenantul în care se află utilizatorul * Dacă diagnosticele arată că s-a încercat soluția de rezervă după e-mail/UPN, confirmați că consimțământul administratorului `User.Read.All` a fost acordat ID-ului aplicației Bot afișat, pentru tenantul corect * Când se utilizează soluția de rezervă după e-mail/UPN, verificați dacă adresa de e-mail sau UPN a utilizatorului din Living Security corespunde celei din Microsoft Entra ID * Rugați utilizatorul să deblocheze sau să reinstaleze aplicația dacă a eliminat-o sau a blocat-o anterior Categoria de eroare `TEAMS_ADMIN_CONSENT_REQUIRED` sau eroarea Microsoft `AADSTS7000229` înseamnă că o căutare a destinatarului după e-mail/UPN a încercat soluția de rezervă opțională Microsoft Graph, dar aplicația regională Living Security pentru Teams nu are un principal de serviciu (aplicație enterprise) în tenantul Microsoft Entra conectat. Căile implicite, bazate pe ID de încredere și pe conversația stocată, nu necesită acest consimțământ. Nu este vorba despre un secret Living Security expirat. 1. Deschideți **Setări → Comunicații → Canale → Microsoft Teams**. Puteți utiliza și **Open Microsoft Teams setup** din eroarea din Jurnalul de comunicații. 2. Confirmați că este conectat ID-ul corect al tenantului Microsoft Entra. 3. Dacă soluția de rezervă după e-mail/UPN este necesară, rugați un administrator Microsoft Entra să facă clic pe **Grant optional User.Read.All consent** și să aprobe `User.Read.All` pentru **ID-ul aplicației Bot** afișat. În caz contrar, asigurați-vă că destinatarul a deschis aplicația personală și că Living Security are ID-ul său de obiect Entra de încredere. 4. După ce Microsoft termină procesarea consimțământului, trimiteți un test avansat țintit după e-mail/UPN din configurarea Microsoft Teams. Jurnalul de comunicații afișează istoricul livrărilor și diagnosticele; nu retrimite mesajul eșuat. Reconfigurarea **Microsoft Entra ID (Client Credentials)** nu rezolvă această eroare, deoarece integrarea respectivă nu este utilizată de livrarea notificărilor Teams. * Verificați dacă botul a fost blocat, eliminat sau dezinstalat * Dacă aplicația a fost instalată înainte ca tenantul să fie conectat în Living Security, salvați tenantul și selectați **Validate install**, astfel încât Living Security să poată asocia instalarea existentă * Reinstalați numai dacă validarea nu poate detecta instalarea existentă * Confirmați că utilizatorul sau canalul țintă a primit cel mai recent eveniment de instalare a aplicației * Trimiteți o nouă notificare de test după reinstalarea aplicației Exemplu de câmpuri ale evenimentului de instalare utilizate pentru depanare: ```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" } } ``` ## Securitate Living Security utilizează Microsoft Graph `User.Read.All` numai pentru soluția de rezervă opțională de căutare a destinatarului după e-mail/UPN. În mod implicit, rutarea notificărilor personale utilizează un ID de obiect Entra de încredere din datele de entitate ale Living Security și referința conversației botului capturată din Microsoft Teams. ID-urile de obiect și referințele de conversație furnizate de apelant nu sunt date de rutare de încredere. Mesajele Microsoft Teams sunt livrate prin botul Teams Living Security destinat exclusiv notificărilor, utilizând mesageria proactivă Microsoft Teams. Living Security nu solicită clienților să creeze propria înregistrare de aplicație Microsoft Entra sau să partajeze un secret de client deținut de client pentru configurarea standard a aplicației Teams. Pachetele Teams specifice regiunii mențin ID-ul aplicației, ID-ul botului și punctul final de mesagerie aliniate cu regiunea Living Security în care este găzduită organizația dvs. ## Resurse conexe Configurați e-mailul drept canal de livrare. Configurați Slack drept canal de livrare. Urmăriți starea și istoricul livrărilor Teams. Configurarea Microsoft Entra ID și a SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.