Skip to main content
Integracja z Microsoft Teams wysyła powiadomienia Living Security do użytkowników i na kanały za pośrednictwem aplikacji Living Security Teams. Można jej używać do powiadomień o przypisanych szkoleniach, alertów dotyczących ryzyka związanego z czynnikiem ludzkim, komunikatów wdrożeniowych oraz ogłoszeń zespołu ds. bezpieczeństwa. Ta integracja służy wyłącznie do wysyłania powiadomień. Użytkownicy nie wysyłają poleceń do bota w Microsoft Teams. Po zainstalowaniu aplikacji bot zapisuje odwołanie do konwersacji w Teams, aby móc wysyłać kolejne proaktywne powiadomienia. Komunikaty instalacyjne są jednokierunkowe i można je dostosować lub wyłączyć zgodnie z wymaganiami wdrożenia w przedsiębiorstwie.
Administrator Microsoft Teams nadal musi przesłać, zatwierdzić i udostępnić aplikację Living Security Teams. Zgoda administratora w Microsoft Entra User.Read.All jest opcjonalna i umożliwia wyłącznie awaryjne wyszukiwanie według adresu e-mail lub nazwy UPN (user principal name).
Aby skonfigurować dostarczanie podpowiedzi i Playbooków, przejdź do Ustawienia → Komunikacja → Kanały i kliknij kartę Microsoft Teams. Ta strona opisuje podstawową konfigurację aplikacji Teams.

Wymagania wstępne

Przed skonfigurowaniem Microsoft Teams upewnij się, że dysponujesz następującymi elementami:
  • Administrator Microsoft Teams, który może przesyłać i zatwierdzać aplikacje organizacji. Obie role administratora może pełnić ta sama osoba.
  • Administrator Microsoft Entra — tylko jeśli chcesz włączyć opcjonalne awaryjne wyszukiwanie według adresu e-mail/UPN ze zgodą aplikacji User.Read.All obejmującą całego tenanta
  • Uprawnienia administratora Living Security
  • Aktywna organizacja Living Security
  • Nazwy zespołów i kanałów, na które mają być dostarczane ogłoszenia dotyczące bezpieczeństwa, jeśli ogłoszenia na kanałach są włączone
  • Identyfikator tenanta Microsoft Entra, dostępny w Microsoft Entra admin center → Tożsamość → Przegląd

Podział odpowiedzialności

Role te mogą pełnić różne osoby. Przekaż administratorowi Microsoft Teams sumę kontrolną pakietu, identyfikator aplikacji Teams, identyfikator aplikacji bota (Bot app ID) oraz docelową grupę użytkowników wdrożenia. Wygenerowany adres URL zgody przekaż administratorowi Microsoft Entra tylko wtedy, gdy włączasz opcjonalne awaryjne wyszukiwanie według adresu e-mail/UPN. Nie udostępniaj żadnych niezwiązanych poświadczeń Living Security.

Konfiguracja

1

Otwórz panel konfiguracji Microsoft Teams

W Living Security przejdź do Ustawienia → Komunikacja → Kanały i wybierz Microsoft Teams.Panel wyświetla region organizacji, nazwę pliku pakietu, identyfikator aplikacji Teams, identyfikator aplikacji bota, sumę kontrolną SHA256, stan konfiguracji tenanta Microsoft, instrukcje instalacji, opcje komunikatów instalacyjnych oraz narzędzia do weryfikacji i wysyłania powiadomień testowych.
Region wyświetlany w Living Security odpowiada regionowi, w którym hostowana jest Twoja organizacja.
2

Połącz tenanta Microsoft

W sekcji Connect your tenant wprowadź identyfikator tenanta Microsoft Entra, do którego należą użytkownicy i kanały Teams otrzymujące powiadomienia, a następnie kliknij Save Microsoft tenant. Jeden tenant Microsoft może należeć tylko do jednej organizacji Living Security.Jeśli kontrolka tenanta jest niedostępna, skontaktuj się z osobą odpowiedzialną za wdrożenie Living Security lub z pomocą techniczną, aby połączyć lub zmienić tenanta przed zainstalowaniem aplikacji.
Przed kontynuowaniem Living Security wyświetla komunikat Microsoft tenant connected.
Jeśli to możliwe, połącz tenanta przed zainstalowaniem aplikacji Teams. Jeśli aplikacja jest już zainstalowana, zapisz tenanta i najpierw wybierz Validate install. Living Security podejmie próbę automatycznego powiązania istniejącej instalacji; zainstaluj aplikację ponownie tylko wtedy, gdy weryfikacja nie wykryje instalacji.
3

Pobierz regionalny pakiet Teams

Kliknij Download Teams package. Living Security udostępnia pakiet ZIP dla regionu Twojej organizacji.Przed wprowadzeniem jakichkolwiek zmian zweryfikuj pobrany plik na podstawie sumy kontrolnej SHA256 wyświetlanej w Living Security. Aby nadać aplikacji własną nazwę i ikony, po tej weryfikacji i przed przesłaniem pakietu wykonaj czynności opisane w sekcji Zmiana marki pakietu regionalnego.
Suma kontrolna pobranego pliku zgadza się z sumą kontrolną SHA256 wyświetlaną w Living Security.
4

Prześlij i zainstaluj pakiet w Teams admin center

W Microsoft Teams admin center przejdź do Teams apps → Manage apps → Actions → Upload new app, a następnie prześlij plik ZIP pobrany z Living Security.Sprawdź, czy:
  • identyfikator aplikacji Teams i identyfikator aplikacji bota zgadzają się z wartościami wyświetlanymi w Living Security
  • nazwa aplikacji jest regionalną nazwą Living Security albo nazwą ustawioną po zmianie marki pakietu
  • wydawcą jest Living Security. Zmiana marki pakietu nie zmienia wydawcy
  • aplikacja jest odblokowana
  • aplikacja jest dostępna dla docelowych użytkowników lub grup
  • aplikacja jest zainstalowana za pomocą zasad konfiguracji aplikacji lub instalacji ukierunkowanej dla użytkowników oraz zespołów/kanałów, które mają otrzymywać powiadomienia
Propagowanie dostępności aplikacji i zmian zasad konfiguracji przez Microsoft może potrwać.
Jeśli weryfikacja lub test zakończy się niepowodzeniem bezpośrednio po zmianie zasad aplikacji, sprawdź przypisanie zasad w Microsoft Teams admin center i ponów próbę po zakończeniu propagacji przez Microsoft.
5

Zainstaluj lub otwórz aplikację

Udostępnij aplikację osobistą docelowym użytkownikom. Aby Living Security mogło wysłać test osobisty do wykrytej instalacji, co najmniej jeden użytkownik musi zainstalować lub otworzyć aplikację osobistą Living Security w Microsoft Teams. Dzięki temu bot może przechwycić zaufaną tożsamość użytkownika i osobiste odwołanie do konwersacji. Sama instalacja na kanale nie może zostać użyta do osobistego testu wykrytej instalacji.W przypadku dostarczania na kanały zainstaluj aplikację w docelowym zespole i kanale, aby bot mógł przechwycić odwołanie do konwersacji tego kanału.
Docelowy użytkownik zainstalował lub otworzył aplikację osobistą albo aplikacja jest zainstalowana na docelowym kanale.
6

Skonfiguruj komunikaty instalacyjne

W sekcji Install message controls wybierz, czy komunikaty instalacyjne Teams mają być wysyłane, i dostosuj jednokierunkową treść dla swojej organizacji.Dostępne opcje:
  • Send install messages
  • Send personal install messages
  • Send channel install messages
  • Default message
  • Personal message
  • Channel message
Pola komunikatów obsługują {{installerName}}, które jest zastępowane nazwą wyświetlaną użytkownika, który zainstalował aplikację. Pozostaw komunikat osobisty lub komunikat kanału pusty, aby użyć skonfigurowanego komunikatu domyślnego. Jeśli komunikat domyślny również jest pusty, Living Security używa wbudowanego komunikatu dla danego zakresu.
7

Zweryfikuj konfigurację

Kliknij Validate install w Living Security. Weryfikacja sprawdza, czy pakiet regionalny jest dostępny, czy konfiguracja tenanta Microsoft istnieje i jest unikatowa dla tej organizacji Living Security, czy poświadczenia regionalnego bota są skonfigurowane oraz czy dla połączonego tenanta wykryto aktywną instalację aplikacji.
Przed wysłaniem powiadomień produkcyjnych weryfikacja wyświetla komunikat Validation passed.
8

Wyślij powiadomienia testowe

Aby wykonać domyślny test osobisty, kliknij Send test to detected installation. Living Security wybiera wykrytą aktywną instalację osobistą i używa jej zapisanej zaufanej tożsamości oraz odwołania do konwersacji. Ten test nie wywołuje Microsoft Graph i nie wymaga zgody User.Read.All.Jeśli nie wykryto żadnej instalacji osobistej, poproś użytkownika o zainstalowanie lub otwarcie aplikacji osobistej Living Security, ponownie wybierz Validate install, a następnie wyślij test ponownie. Zaawansowanego testu ukierunkowanego według adresu e-mail/UPN używaj tylko wtedy, gdy opcjonalne awaryjne wyszukiwanie jest włączone.
Jednokierunkowe powiadomienie testowe pojawia się w Microsoft Teams.
Jeśli potrzebna jest diagnostyka dostarczania, sprawdź odpowiednią próbę w dzienniku komunikacji.

Zmiana marki pakietu regionalnego

Pakiet regionalny jest archiwum ZIP zawierającym trzy pliki: manifest.json, color.png i outline.png. Przed przesłaniem pakietu możesz ustawić w nim własną nazwę aplikacji i własne ikony. Living Security obsługuje ten sposób w przypadku pakietów regionalnych przesyłanych bezpośrednio przez administratora Teams. Wykonaj te czynności po pobraniu i zweryfikowaniu pakietu oraz przed jego przesłaniem w Teams admin center.
1

Rozpakuj pakiet

Wypakuj plik ZIP. Zawiera on dokładnie trzy pliki w katalogu głównym archiwum: manifest.json, color.png i outline.png.
2

Zastąp ikony

Zastąp color.png i outline.png własnymi ikonami. Zachowaj te same dwie nazwy plików.
3

Ustaw nazwę aplikacji

W manifest.json zmień te dwa pola:
  • name.short — nazwa wyświetlana w nagłówku aplikacji Teams i w innych miejscach o ograniczonej przestrzeni. Maksymalnie 30 znaków.
  • name.full — nazwa wyświetlana w katalogu aplikacji i w szczegółach aplikacji. Maksymalnie 100 znaków.
    Jeśli aplikacja Living Security została już przesłana w Teams admin center, ustaw version wyżej niż wersja zainstalowana w tym miejscu. Microsoft Teams odrzuca aktualizację, która nie zwiększa numeru wersji, a świeżo pobrany pakiet może mieć taką samą lub niższą wersję niż pakiet, który został już zainstalowany.Zainstalowaną wersję odczytasz w Teams admin center w sekcji Teams apps → Manage apps, na stronie szczegółów aplikacji. Porównaj ją z wartością version w manifest.json właśnie pobranym, a następnie ustaw wartość wyższą niż obie. Zachowaj trzyliczbowy format MAJOR.MINOR.PATCH.Jeśli na przykład zainstalowana aplikacja ma wersję 1.1.1, a nowo pobrany pakiet 1.1.0, ustaw 1.1.2. Podniesienie pobranej wersji 1.1.0 do 1.1.1 powtórzyłoby zainstalowaną wersję i Teams odrzuciłby przesłanie.
4

Pozostaw pola tożsamości bez zmian

Nie zmieniaj tych pól. Każde z nich zawiera tożsamość aplikacji, bota lub logowania jednokrotnego:
  • id
  • botId w bots
  • webApplicationInfo
  • validDomains
  • contentUrl i websiteUrl w staticTabs
    Zmiana pola tożsamości może sprawić, że aplikacja będzie dawała się zainstalować, ale nie będzie w stanie dostarczać powiadomień ani zrealizować logowania jednokrotnego. Validate install sprawdza tenanta, poświadczenia bota i wykrytą instalację. Nie porównuje Twojego manifestu z pakietem zbudowanym przez Living Security.
5

Spakuj ponownie trzy pliki

Utwórz nowe archiwum ZIP z trzech plików. Umieść je w katalogu głównym archiwum, bez katalogu nadrzędnego. Microsoft Teams odrzuca pakiet, w którym manifest.json znajduje się wewnątrz katalogu.
6

Prześlij i zweryfikuj

Prześlij plik ZIP z nową marką w Teams admin center, a następnie wróć do Living Security i kliknij Validate install. Wyślij powiadomienie testowe.
Weryfikacja wyświetla komunikat Validation passed, a powiadomienie testowe dociera do Microsoft Teams pod Twoją nazwą aplikacji i z Twoimi ikonami.

Wydawca i suma kontrolna

Zmiana marki ustawia nazwę aplikacji i ikony. Nie zmienia dwóch rzeczy:
  • Wydawcą nadal jest Living Security. Pola developer w manifeście wskazują Living Security i prowadzą do witryny internetowej Living Security, polityki prywatności oraz warunków korzystania z usługi. Razem identyfikują firmę obsługującą usługę, dlatego Teams nadal wyświetla Living Security jako wydawcę na stronie szczegółów aplikacji, w oknach dialogowych zgody na uprawnienia oraz w raportach użycia aplikacji. Użytkownicy widzą Twoją nazwę i ikony w nagłówku aplikacji, w katalogu aplikacji oraz w powiadomieniach.
  • Suma kontrolna SHA256 przestaje się zgadzać. Suma kontrolna wyświetlana w Living Security opisuje pakiet w postaci, w jakiej został pobrany. Zweryfikuj ją przed edycją plików, a następnie zapisz sumę kontrolną własnego pakietu ze zmienioną marką w dokumentacji wdrożenia.

Opcjonalnie: włączenie awaryjnego wyszukiwania według adresu e-mail/UPN

Standardowe dostarczanie osobiste wykorzystuje zaufany identyfikator obiektu Microsoft Entra znany już Living Security wraz z odwołaniem do konwersacji z botem, przechwyconym w chwili, gdy użytkownik instaluje lub otwiera aplikację. Dostarczanie na kanały korzysta z zapisanego odwołania do konwersacji kanału. Żadna z tych ścieżek nie wymaga Microsoft Graph. Jeśli odbiorca nie ma zaufanego identyfikatora obiektu Entra, Living Security może opcjonalnie użyć Microsoft Graph do odnalezienia odbiorcy na podstawie adresu e-mail lub UPN. Aby włączyć to rozwiązanie awaryjne, poproś administratora Microsoft Entra o kliknięcie Grant optional User.Read.All consent w panelu konfiguracji Teams i zatwierdzenie uprawnienia aplikacji Microsoft Graph User.Read.All dla regionalnej aplikacji Living Security Teams. Przepływ zgody administratora ma następujący wzorzec Microsoft Entra:
Living Security generuje ten adres URL na podstawie identyfikatora połączonego tenanta oraz Bot app ID wyświetlanego w panelu konfiguracji. Identyfikatory te mają różne zastosowania:
  • Teams app ID identyfikuje instalowalny pakiet aplikacji w Microsoft Teams admin center.
  • Bot app ID identyfikuje aplikację Microsoft Entra regionalnego bota i jest identyfikatorem klienta używanym w opcjonalnym przepływie zgody administratora.
Nie podstawiaj identyfikatora Teams app ID w adresie URL zgody. Integracja Microsoft Entra ID (Client Credentials) w sekcji Connected Integrations jest odrębną, ogólną integracją. Regionalny bot Teams nie może ponownie wykorzystać jej poświadczeń ani zgody, a zgoda udzielona niepowiązanej aplikacji Entra nie włącza tego rozwiązania awaryjnego.
Uczynienie zgody opcjonalną nie usuwa User.Read.All z istniejących rejestracji regionalnych aplikacji Living Security. Klienci, którzy już udzielili zgody, mogą nadal korzystać z rozwiązania awaryjnego według adresu e-mail/UPN bez ponownej konfiguracji.

Typy powiadomień

W zależności od uprawnień Twojej organizacji i skonfigurowanych Playbooków Living Security może wysyłać:

Dostosowywanie

Powiadomienia Teams korzystają z konfiguracji Twojej organizacji w Living Security. Obsługiwane pola obejmują wyświetlaną nazwę klienta, obsługiwane pola logo i marki, treść komunikatów, wezwania do działania, linki docelowe, tekst wdrożeniowy oraz tekst dotyczący wsparcia/kontaktu. Komunikaty instalacyjne można konfigurować w Ustawienia → Komunikacja → Kanały → Microsoft Teams → Install message controls. Można całkowicie wyłączyć komunikaty instalacyjne, wyłączyć tylko osobiste lub kanałowe komunikaty instalacyjne oraz skonfigurować treść domyślną, osobistą lub właściwą dla kanału. Nazwa aplikacji Teams i ikony pochodzą z pakietu regionalnego. Aby ustawić własne, zobacz Zmiana marki pakietu regionalnego.

Aktualizowanie lub usuwanie aplikacji

  • Gdy Living Security udostępni zaktualizowany pakiet regionalny, pobierz go z panelu kanału Microsoft Teams i prześlij przez Teams admin center. Przed wdrożeniem zweryfikuj wyświetlany identyfikator aplikacji, identyfikator bota i sumę kontrolną.
  • Zmiany marki nie są zachowywane po aktualizacji pakietu. Każdy nowy pakiet regionalny ponownie zawiera nazwę aplikacji i ikony Living Security. Przed przesłaniem nowego pakietu ponownie wprowadź zmiany, postępując zgodnie z sekcją Zmiana marki pakietu regionalnego. Przechowuj w łatwo dostępnym miejscu swoje ikony, dwie wartości nazw oraz ostatnio przesłaną wersję, aby każda aktualizacja sprowadzała się do krótkiego powtórzenia tych samych kroków. Nowy pakiet nie zawsze ma wyższą wersję niż zainstalowany, dlatego ustaw wersję na podstawie tego, co Teams pokazuje jako zainstalowane.
  • Po aktualizacji aplikacji lub zasad ponownie uruchom Validate install i wyślij kolejny test.
  • Usunięcie lub zablokowanie aplikacji uniemożliwia proaktywne powiadomienia dla danego użytkownika lub kanału. Zainstaluj aplikację ponownie i wyślij nowy test, aby Living Security otrzymało aktualne zdarzenie instalacji w Teams.
  • Jeśli rezygnujesz z dostarczania przez Teams, usuń Teams z odpowiednich Playbooków przed usunięciem aplikacji z Microsoft Teams.

Rozwiązywanie problemów

  • Sprawdź, czy osobista aplikacja Living Security Teams jest zainstalowana i czy użytkownik ją otworzył, aby Living Security miało aktualne odwołanie do konwersacji
  • Sprawdź, czy skonfigurowany identyfikator tenanta Microsoft jest identyfikatorem tenanta, w którym znajduje się użytkownik
  • Jeśli diagnostyka wskazuje, że podjęto próbę awaryjnego wyszukiwania według adresu e-mail/UPN, sprawdź, czy zgoda administratora User.Read.All została udzielona dla wyświetlanego Bot app ID w prawidłowym tenancie
  • Gdy używane jest awaryjne wyszukiwanie według adresu e-mail/UPN, sprawdź, czy adres e-mail lub UPN użytkownika w Living Security zgadza się z danymi w Microsoft Entra ID
  • Poproś użytkownika o odblokowanie lub ponowne zainstalowanie aplikacji, jeśli wcześniej ją usunął lub zablokował
  • Sprawdź, czy aplikacja Living Security Teams jest zainstalowana w docelowym zespole lub kanale.
  • Sprawdź, czy mapowanie kanału w Living Security wskazuje prawidłowy zespół i kanał.
  • Sprawdź, czy kanał nie został usunięty, przemianowany, zarchiwizowany ani objęty ograniczeniami.
  • Zainstaluj aplikację ponownie w docelowym zespole lub kanale i wyślij kolejne powiadomienie testowe.
  • Sprawdź, czy administrator Microsoft Entra udzielił zgody obejmującej całego tenanta dla Microsoft Graph User.Read.All dla wyświetlanego Bot app ID.
  • Sprawdź, czy skonfigurowany identyfikator tenanta jest identyfikatorem tenanta, w którym znajdują się użytkownicy i Teams.
  • Sprawdź, czy użytkownik istnieje w Microsoft Entra ID i nie jest gościem z innego tenanta.
Kategoria błędu TEAMS_ADMIN_CONSENT_REQUIRED lub błąd Microsoft AADSTS7000229 oznacza, że wyszukiwanie odbiorcy według adresu e-mail/UPN podjęło próbę skorzystania z opcjonalnego rozwiązania awaryjnego Microsoft Graph, ale regionalna aplikacja Living Security Teams nie ma jednostki usługi (aplikacji przedsiębiorstwa) w połączonym tenancie Microsoft Entra. Domyślne ścieżki oparte na zaufanym identyfikatorze i zapisanej konwersacji nie wymagają tej zgody. Nie jest to wygasły sekret Living Security.
  1. Otwórz Ustawienia → Komunikacja → Kanały → Microsoft Teams. Możesz również użyć Open Microsoft Teams setup z poziomu błędu w dzienniku komunikacji.
  2. Sprawdź, czy połączony jest prawidłowy identyfikator tenanta Microsoft Entra.
  3. Jeśli wymagane jest awaryjne wyszukiwanie według adresu e-mail/UPN, poproś administratora Microsoft Entra o kliknięcie Grant optional User.Read.All consent i zatwierdzenie User.Read.All dla wyświetlanego Bot app ID. W przeciwnym razie upewnij się, że odbiorca otworzył aplikację osobistą i że Living Security dysponuje jego zaufanym identyfikatorem obiektu Entra.
  4. Po zakończeniu przetwarzania zgody przez Microsoft wyślij zaawansowany test ukierunkowany według adresu e-mail/UPN z poziomu konfiguracji Microsoft Teams. Dziennik komunikacji pokazuje historię dostarczania i diagnostykę; nie dostarcza ponownie nieudanej wiadomości.
Ponowna konfiguracja integracji Microsoft Entra ID (Client Credentials) nie rozwiązuje tego błędu, ponieważ ta integracja nie jest używana do dostarczania powiadomień Teams.
  • Sprawdź, czy bot nie został zablokowany, usunięty lub odinstalowany
  • Jeśli aplikacja została zainstalowana przed połączeniem tenanta w Living Security, zapisz tenanta i wybierz Validate install, aby Living Security mogło powiązać istniejącą instalację
  • Zainstaluj aplikację ponownie tylko wtedy, gdy weryfikacja nie wykryje istniejącej instalacji
  • Sprawdź, czy docelowy użytkownik lub kanał otrzymał najnowsze zdarzenie instalacji aplikacji
  • Po ponownym zainstalowaniu aplikacji wyślij nowe powiadomienie testowe
Przykładowe pola zdarzenia instalacji używane do rozwiązywania problemów:

Bezpieczeństwo

Living Security używa Microsoft Graph User.Read.All wyłącznie w opcjonalnym awaryjnym wyszukiwaniu odbiorców według adresu e-mail/UPN. Domyślnie routing powiadomień osobistych wykorzystuje zaufany identyfikator obiektu Entra z danych encji Living Security oraz odwołanie do konwersacji z botem przechwycone z Microsoft Teams. Identyfikatory obiektów i odwołania do konwersacji przekazane przez wywołującego nie są traktowane jako zaufane dane routingu. Wiadomości Microsoft Teams są dostarczane za pośrednictwem bota Teams Living Security przeznaczonego wyłącznie do powiadomień, z wykorzystaniem proaktywnych wiadomości Microsoft Teams. Living Security nie wymaga od klientów tworzenia własnej rejestracji aplikacji Microsoft Entra ani udostępniania sekretu klienta należącego do klienta w standardowej konfiguracji aplikacji Teams. Pakiety Teams dla poszczególnych regionów zapewniają zgodność identyfikatora aplikacji, identyfikatora bota i punktu końcowego komunikatów z regionem Living Security, w którym hostowana jest Twoja organizacja.

Powiązane

Integracja poczty e-mail

Skonfiguruj pocztę e-mail jako kanał dostarczania.

Integracja ze Slack

Skonfiguruj Slack jako kanał dostarczania.

Dziennik komunikacji

Śledź stan i historię dostarczania w Teams.

Uwierzytelnianie

Konfiguracja Microsoft Entra ID i SSO.