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.Allobejmują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
Konfiguracja
Otwórz panel konfiguracji Microsoft Teams
Połącz tenanta Microsoft
Pobierz regionalny pakiet Teams
Prześlij i zainstaluj pakiet w Teams admin center
- 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
Zainstaluj lub otwórz aplikację
Skonfiguruj komunikaty instalacyjne
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{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.Zweryfikuj konfigurację
Wyślij powiadomienia testowe
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.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.
Rozpakuj pakiet
manifest.json, color.png i outline.png.Zastąp ikony
color.png i outline.png własnymi ikonami. Zachowaj te same dwie
nazwy plików.Ustaw nazwę aplikacji
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, ustawversionwyż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ąversionwmanifest.jsonwłaśnie pobranym, a następnie ustaw wartość wyższą niż obie. Zachowaj trzyliczbowy formatMAJOR.MINOR.PATCH.Jeśli na przykład zainstalowana aplikacja ma wersję1.1.1, a nowo pobrany pakiet1.1.0, ustaw1.1.2. Podniesienie pobranej wersji1.1.0do1.1.1powtórzyłoby zainstalowaną wersję i Teams odrzuciłby przesłanie.
Pozostaw pola tożsamości bez zmian
-
id -
botIdwbots -
webApplicationInfo -
validDomains -
contentUrliwebsiteUrlwstaticTabs
Spakuj ponownie trzy pliki
manifest.json znajduje się wewnątrz katalogu.Prześlij i zweryfikuj
Wydawca i suma kontrolna
Zmiana marki ustawia nazwę aplikacji i ikony. Nie zmienia dwóch rzeczy:- Wydawcą nadal jest Living Security. Pola
developerw 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 GraphUser.Read.All dla regionalnej aplikacji
Living Security Teams.
Przepływ zgody administratora ma następujący wzorzec Microsoft Entra:
- 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.
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
Użytkownik nie otrzymuje powiadomienia osobistego
Użytkownik nie otrzymuje powiadomienia osobistego
- 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.Allzostał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ł
Ogłoszenie na kanale nie pojawia się
Ogłoszenie na kanale nie pojawia się
- 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.
Opcjonalne wyszukiwanie według adresu e-mail/UPN lub zgoda kończy się niepowodzeniem
Opcjonalne wyszukiwanie według adresu e-mail/UPN lub zgoda kończy się niepowodzeniem
- Sprawdź, czy administrator Microsoft Entra udzielił zgody obejmującej całego tenanta dla
Microsoft Graph
User.Read.Alldla 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.
Dziennik komunikacji pokazuje, że wymagana jest zgoda administratora Microsoft
Dziennik komunikacji pokazuje, że wymagana jest zgoda administratora Microsoft
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.- 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.
- Sprawdź, czy połączony jest prawidłowy identyfikator tenanta Microsoft Entra.
- 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.Alldla 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. - 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.
Aplikacja jest zainstalowana, ale powiadomienia kończą się niepowodzeniem
Aplikacja jest zainstalowana, ale powiadomienia kończą się niepowodzeniem
- 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
Bezpieczeństwo
Living Security używa Microsoft GraphUser.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.

