Skip to main content
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

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

1

Deschideți panoul de configurare Microsoft Teams

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

Conectați tenantul Microsoft

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

Descărcați pachetul regional Teams

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

Încărcați și instalați pachetul în Teams admin center

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

Instalați sau deschideți aplicația

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

Configurați mesajele de instalare

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

Validați configurarea

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

Trimiteți notificări de test

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

Dezarhivați pachetul

Extrageți fișierul ZIP. Acesta conține exact trei fișiere în rădăcina arhivei: manifest.json, color.png și outline.png.
2

Înlocuiți pictogramele

Înlocuiți color.png și outline.png cu propriile pictograme. Păstrați aceleași două nume de fișiere.
3

Setați numele aplicației

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

Lăsați câmpurile de identitate neschimbate

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

Rearhivați cele trei fișiere

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

Încărcați și verificați

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

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.

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 î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
  • Confirmați că aplicația Living Security pentru Teams este instalată în echipa sau canalul țintă.
  • Confirmați că maparea canalului din Living Security utilizează echipa și canalul corecte.
  • Verificați dacă canalul a fost eliminat, redenumit, arhivat sau restricționat.
  • Reinstalați aplicația în echipa sau canalul țintă și trimiteți o altă notificare de test.
  • Confirmați că un administrator Microsoft Entra a acordat consimțământ la nivel de tenant pentru Microsoft Graph User.Read.All ID-ului aplicației Bot afișat.
  • Confirmați că ID-ul tenantului configurat este tenantul în care se află utilizatorii și Teams.
  • Verificați dacă utilizatorul există în Microsoft Entra ID și nu este un invitat din alt tenant.
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:

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

Integrarea e-mail

Configurați e-mailul drept canal de livrare.

Integrarea Slack

Configurați Slack drept canal de livrare.

Jurnalul de comunicații

Urmăriți starea și istoricul livrărilor Teams.

Autentificare

Configurarea Microsoft Entra ID și a SSO.