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

# Nastavení integrace Google Workspace

> Připojte Google Workspace k Living Security a získejte data o životním cyklu uživatelů, přihlašování, MFA, administrativní činnosti a ochraně dat.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Související zdroje</h2>
    <ul>
      <li>
        <a href="/cs/signals/data-sources">Zjistěte, jak se data z integrací mění na signály pro řízení lidských rizik</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Prozkoumejte integrace společnosti Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Otevřete Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Požádejte o demo společnosti Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Zadejte přihlašovací údaje v Living Security Platform">
    <p>
      Tento krok provádí osoba s přístupem do Living Security – vlastník programu, nebo správce
      systému, pokud byl pozván (delegované nastavení).
    </p>
    <ol>
      <li>
        Přejděte do části <strong>Nastavení → Integrace → Katalog</strong>, najděte dlaždici{' '}
        <strong>{tile}</strong> a klikněte na <strong>Připojení</strong>.
      </li>
      <li>
        Vyplňte níže uvedená pole a poté klikněte na <strong>Připojení</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Tento průvodce je určen správci systému {system}.</strong> Popisuje vytvoření přihlašovacích údajů API v systému {system}, k čemuž je nutný přístup správce k systému {system} — nikoli k Living Security Platform.
    </p>
    <p>
      Pokud jste <strong>vlastníkem programu</strong> Living Security a systém {system} nespravujete, odešlete tuto stránku osobě, která jej spravuje. Ta dokončí část A a předá vám přihlašovací údaje (nebo je zadá přímo, pokud jste ji pozvali do platformy).
      {recommendDelegated && <>
          {' '}Protože při nastavení vzniká citlivý klíčový materiál, doporučujeme postup{' '}
          <strong>delegovaného nastavení</strong>, při kterém vám tajný klíč nikdy nebude odeslán zpět.
        </>}
    </p>
  </Note>;

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

## Co tato integrace poskytuje

Google Workspace může poskytovat normalizovaná data o životním cyklu uživatelů, přihlašování, MFA, administrativní činnosti a ochraně dat. Mezi prověřené příklady patří:

* `account.compromised` — účet označený jako kompromitovaný
* `data.sensitive.downloaded` — stahuje citlivá data
* `auth.login.unusual` — přihlašuje se z neobvyklých kontextů

Přečtěte si, [jak se data z integrací stávají signály](/cs/signals/data-sources).

## Co Living Security potřebuje

| Přihlašovací údaj | Popis |
| - | - |
| **Klíč servisního účtu** | Klíč JSON vyhrazeného servisního účtu Google Cloud. |
| **Delegovaný administrátor** | E-mail správce Google Workspace, kterého může servisní účet zosobňovat. |

Povolte rozhraní Admin SDK API a autorizujte pouze ty obory (scopes), které připojení čte:

* `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`

## Nastavení

<Steps>
  <Step title="Vytvořte servisní účet Google Cloud">
    Vytvořte vyhrazený servisní účet, povolte delegování pravomocí v celé doméně (domain-wide delegation) a stáhněte jeho klíč JSON. Klíč bezpečně uložte.
  </Step>

  <Step title="Autorizujte delegování pravomocí v celé doméně">
    V konzole Google Admin otevřete **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Přidejte číselné ID klienta servisního účtu a tři výše uvedené obory pouze pro čtení.
  </Step>

  <Step title="Vyberte delegovaného administrátora">
    Vyberte aktivního správce Workspace, který může číst adresář, přiřazení rolí a auditní přehledy. Living Security tuto identitu používá pouze pro delegované čtení přes API.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Nahrajte nebo vložte přihlašovací údaje servisního účtu podle pokynů a zadejte e-mail delegovaného administrátora.
  </ConnectInPlatform>
</Steps>

## Ověření a řešení potíží

Ověřte, že připojení dokáže načíst jednoho uživatele z adresáře a nedávnou aktivitu přihlášení. Google uvádí, že šíření nově udělených oprávnění delegování v celé doméně může chvíli trvat.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Ověřte, že delegování v celé doméně používá číselné ID klienta servisního účtu, nikoli jeho e-mailovou adresu, a že všechny tři obory přesně odpovídají.
  </Accordion>

  <Accordion title="Adresář funguje, ale chybí přiřazení rolí">
    Přidejte `admin.directory.rolemanagement.readonly` do položky delegování a ověřte, že delegovaný administrátor může zobrazit přiřazení rolí.
  </Accordion>

  <Accordion title="Přehledy jsou prázdné">
    Ověřte, že je povoleno rozhraní Admin Reports API a že delegovaný administrátor má přístup k auditním přehledům pro tenanta Workspace.
  </Accordion>
</AccordionGroup>

Podrobnosti na straně dodavatele najdete v [průvodci Googlu k delegování pravomocí v celé doméně](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.