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

# Konfiguracja integracji z Google Workspace

> Połącz Google Workspace z Living Security, aby uwzględnić aktywność dotyczącą cyklu życia użytkowników, logowania, MFA, działań administracyjnych i ochrony danych.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Powiązane zasoby</h2>
    <ul>
      <li>
        <a href="/pl/signals/data-sources">Dowiedz się, w jaki sposób dane z integracji stają się sygnałami w ramach zarządzania ryzykiem związanym z czynnikiem ludzkim (Human Risk Management)</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Poznaj integracje Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Otwórz Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Poproś o demonstrację Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Wprowadź dane uwierzytelniające w Living Security Platform">
    <p>
      Czynność wykonuje osoba posiadająca dostęp do Living Security — właściciel programu lub
      administrator systemu, jeśli został zaproszony (konfiguracja delegowana).
    </p>
    <ol>
      <li>
        Przejdź do <strong>Ustawienia → Integracje → Katalog</strong>, znajdź kafelek{' '}
        <strong>{tile}</strong> i kliknij <strong>Połącz</strong>.
      </li>
      <li>
        Wypełnij poniższe pola, a następnie kliknij <strong>Połącz</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Ten przewodnik jest przeznaczony dla administratora systemu {system}.</strong> Opisuje tworzenie
      poświadczeń API w systemie {system}, co wymaga uprawnień administracyjnych w systemie {system}, a nie w
      Living Security Platform.
    </p>
    <p>
      Jeśli jesteś <strong>właścicielem programu</strong> Living Security i nie administrujesz systemem {system},
      przekaż tę stronę osobie, która nim administruje. Osoba ta wykona część A i przekaże Ci poświadczenia
      (lub wprowadzi je bezpośrednio, jeśli została zaproszona do platformy).
      {recommendDelegated && <>
          {' '}Ponieważ konfiguracja generuje poufny materiał kluczowy, zalecamy skorzystanie ze ścieżki{' '}
          <strong>konfiguracji delegowanej</strong>, dzięki której tajny klucz nigdy nie zostanie do Ciebie odesłany.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Google Workspace" recommendDelegated={true} />

## Co wnosi ta integracja

Google Workspace może dostarczać znormalizowane dane o aktywności dotyczącej cyklu życia użytkowników, logowania, MFA, działań administracyjnych i ochrony danych. Przykłady, które zostały zweryfikowane:

* `account.compromised` — konto oznaczone jako przejęte
* `data.sensitive.downloaded` — pobiera dane wrażliwe
* `auth.login.unusual` — loguje się w nietypowych kontekstach

Zobacz [jak dane z integracji stają się sygnałami](/pl/signals/data-sources).

## Czego wymaga Living Security

| Poświadczenie | Opis |
| - | - |
| **Klucz konta usługi** | Klucz JSON dedykowanego konta usługi Google Cloud. |
| **Administrator delegowany** | Adres e-mail administratora Google Workspace, którego tożsamość może przyjmować konto usługi. |

Włącz interfejsy API Admin SDK i autoryzuj wyłącznie te zakresy, które są odczytywane przez połączenie:

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## Konfiguracja

<Steps>
  <Step title="Utwórz konto usługi Google Cloud">
    Utwórz dedykowane konto usługi, włącz delegowanie uprawnień w całej domenie i pobierz jego klucz JSON. Przechowuj klucz w bezpiecznym miejscu.
  </Step>

  <Step title="Autoryzuj delegowanie uprawnień w całej domenie">
    W konsoli administracyjnej Google otwórz **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Dodaj numeryczny identyfikator klienta konta usługi oraz trzy powyższe zakresy tylko do odczytu.
  </Step>

  <Step title="Wybierz administratora delegowanego">
    Wybierz aktywnego administratora Workspace, który może odczytywać katalog, przypisania ról i raporty z audytu. Living Security używa tej tożsamości wyłącznie do delegowanych odczytów API.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Prześlij lub wklej poświadczenie konta usługi zgodnie z monitem i wprowadź adres e-mail administratora delegowanego.
  </ConnectInPlatform>
</Steps>

## Weryfikacja i rozwiązywanie problemów

Sprawdź, czy połączenie może odczytać jednego użytkownika katalogu oraz ostatnią aktywność logowania. Google informuje, że propagacja nowych uprawnień delegowania w całej domenie może zająć trochę czasu.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Upewnij się, że delegowanie uprawnień w całej domenie korzysta z numerycznego identyfikatora klienta konta usługi, a nie z jego adresu e-mail, oraz że wszystkie trzy zakresy są dokładnie zgodne.
  </Accordion>

  <Accordion title="Katalog działa, ale brakuje przypisań ról">
    Dodaj `admin.directory.rolemanagement.readonly` do wpisu delegowania i upewnij się, że administrator delegowany może wyświetlać przypisania ról.
  </Accordion>

  <Accordion title="Raporty są puste">
    Upewnij się, że interfejs Admin Reports API jest włączony oraz że administrator delegowany ma dostęp do raportów z audytu dla dzierżawy Workspace.
  </Accordion>
</AccordionGroup>

Szczegółowe informacje po stronie dostawcy znajdziesz w [przewodniku Google dotyczącym delegowania uprawnień w całej domenie](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority).

<PublicIntegrationNextSteps />


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