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

# Integracja z Microsoft Teams

> Połącz Living Security z Microsoft Teams, aby wysyłać powiadomienia o szkoleniach, alerty bezpieczeństwa i ogłoszenia na kanałach.

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.

<Warning>
  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).
</Warning>

<Note>
  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.
</Note>

## 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

| Rola | Zakres odpowiedzialności |
| - | - |
| **Administrator Living Security** | Łączy tenanta Microsoft, pobiera pakiet regionalny, konfiguruje komunikaty instalacyjne, weryfikuje konfigurację i wysyła testy |
| **Administrator Microsoft Teams** | Przesyła aplikację i zezwala na jej użycie, udostępnia ją docelowym użytkownikom lub grupom oraz przypisuje zasady konfiguracji aplikacji |
| **Administrator Microsoft Entra**, opcjonalnie | Udziela zgody aplikacji `User.Read.All` dla regionalnego identyfikatora aplikacji bota, gdy wymagane jest awaryjne wyszukiwanie według adresu e-mail/UPN |
| **Właściciel zespołu Teams**, gdy używane jest dostarczanie na kanały | Instaluje aplikację lub zatwierdza jej instalację dla docelowego zespołu i kanału |

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

<Steps>
  <Step title="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.

    <Check>
      Region wyświetlany w Living Security odpowiada regionowi, w którym hostowana jest Twoja organizacja.
    </Check>
  </Step>

  <Step title="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.

    <Check>
      Przed kontynuowaniem Living Security wyświetla komunikat **Microsoft tenant connected**.
    </Check>

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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](#zmiana-marki-pakietu-regionalnego).

    <Check>
      Suma kontrolna pobranego pliku zgadza się z sumą kontrolną SHA256 wyświetlaną w Living Security.
    </Check>
  </Step>

  <Step title="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ć.

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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.

    <Check>
      Docelowy użytkownik zainstalował lub otworzył aplikację osobistą albo aplikacja
      jest zainstalowana na docelowym kanale.
    </Check>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Check>
      Przed wysłaniem powiadomień produkcyjnych weryfikacja wyświetla komunikat **Validation passed**.
    </Check>
  </Step>

  <Step title="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.

    <Check>Jednokierunkowe powiadomienie testowe pojawia się w Microsoft Teams.</Check>

    Jeśli potrzebna jest diagnostyka dostarczania, sprawdź odpowiednią próbę w [dzienniku komunikacji](/pl/features/communications/log).
  </Step>
</Steps>

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

<Steps>
  <Step title="Rozpakuj pakiet">
    Wypakuj plik ZIP. Zawiera on dokładnie trzy pliki w katalogu głównym
    archiwum: `manifest.json`, `color.png` i `outline.png`.
  </Step>

  <Step title="Zastąp ikony">
    Zastąp `color.png` i `outline.png` własnymi ikonami. Zachowaj te same dwie
    nazwy plików.

    | Plik | Wymaganie |
    | - | - |
    | `color.png` | Pełnokolorowy plik PNG, 192 × 192 piksele, bez przezroczystości |
    | `outline.png` | Przezroczysty plik PNG, 32 × 32 piksele |
  </Step>

  <Step title="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.

          <Note>
            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.
          </Note>
  </Step>

  <Step title="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`

          <Warning>
            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.
          </Warning>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Check>
      Weryfikacja wyświetla komunikat **Validation passed**, a powiadomienie testowe
      dociera do Microsoft Teams pod Twoją nazwą aplikacji i z Twoimi ikonami.
    </Check>
  </Step>
</Steps>

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

```text theme={null}
https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}
```

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.

<Note>
  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.
</Note>

## Typy powiadomień

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

| Powiadomienie | Opis |
| - | - |
| Przypisanie szkoleń | Powiadamia użytkowników o przypisaniu szkolenia, zbliżającym się terminie lub gotowości do ukończenia |
| Przypomnienia o szkoleniach | Przypominają użytkownikom o zbliżających się terminach |
| Alerty o ryzyku związanym z czynnikiem ludzkim | Wysyłają spersonalizowane aktualizacje Indeksu ryzyka związanego z czynnikiem ludzkim i zalecane dalsze kroki |
| Komunikaty wdrożeniowe | Wysyłają jednokierunkowe powiadomienia wprowadzające lub wdrożeniowe w trakcie wdrożenia |
| Ogłoszenia na kanałach | Publikują komunikaty programu bezpieczeństwa na skonfigurowanych kanałach Teams |

## 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](#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](#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

<AccordionGroup>
  <Accordion title="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.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ł
  </Accordion>

  <Accordion title="Ogłoszenie na kanale nie pojawia się">
    <ul>
      <li>
        Sprawdź, czy aplikacja Living Security Teams jest zainstalowana w docelowym zespole lub
        kanale.
      </li>

      <li>
        Sprawdź, czy mapowanie kanału w Living Security wskazuje prawidłowy zespół i
        kanał.
      </li>

      <li>
        Sprawdź, czy kanał nie został usunięty, przemianowany, zarchiwizowany ani objęty ograniczeniami.
      </li>

      <li>
        Zainstaluj aplikację ponownie w docelowym zespole lub kanale i wyślij kolejne powiadomienie
        testowe.
      </li>
    </ul>
  </Accordion>

  <Accordion title="Opcjonalne wyszukiwanie według adresu e-mail/UPN lub zgoda kończy się niepowodzeniem">
    <ul>
      <li>
        Sprawdź, czy administrator Microsoft Entra udzielił zgody obejmującej całego tenanta dla
        Microsoft Graph `User.Read.All` dla wyświetlanego Bot app ID.
      </li>

      <li>
        Sprawdź, czy skonfigurowany identyfikator tenanta jest identyfikatorem tenanta, w którym znajdują się
        użytkownicy i Teams.
      </li>

      <li>
        Sprawdź, czy użytkownik istnieje w Microsoft Entra ID i nie jest gościem
        z innego tenanta.
      </li>
    </ul>
  </Accordion>

  <Accordion title="Dziennik komunikacji pokazuje, że wymagana jest zgoda administratora Microsoft">
    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.
  </Accordion>

  <Accordion title="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

    Przykładowe pola zdarzenia instalacji używane do rozwiązywania problemów:

    ```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"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## 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

<CardGroup cols={2}>
  <Card title="Integracja poczty e-mail" icon="envelope" href="/pl/integrations/outbound/email">
    Skonfiguruj pocztę e-mail jako kanał dostarczania.
  </Card>

  <Card title="Integracja ze Slack" icon="slack" href="/pl/integrations/outbound/slack">
    Skonfiguruj Slack jako kanał dostarczania.
  </Card>

  <Card title="Dziennik komunikacji" icon="clock-rotate-left" href="/pl/features/communications/log">
    Śledź stan i historię dostarczania w Teams.
  </Card>

  <Card title="Uwierzytelnianie" icon="shield-halved" href="/pl/features/settings/sso">
    Konfiguracja Microsoft Entra ID i SSO.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.