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

> Připojte KnowBe4 k Living Security Platform a importujte uživatele, přihlášení do školení a výsledky testů zabezpečení proti phishingu.

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 EgressIpSafelist = ({system}) => <Note>
    <strong>Přidejte na seznam povolených všechny čtyři odchozí IP adresy synchronizace Living Security</strong> v systému{' '}
    {system}. Pokud {system} očekává zápis CIDR, zadejte každou adresu jako jednotlivého hostitele s příponou <code>/32</code>:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Provoz může odcházet z kterékoli ze čtyř adres, takže povolení pouze některých z nich způsobuje občasná
    selhání synchronizace. Tyto čtyři adresy jsou stejné ve všech regionech Living Security. Úplný seznam, zásady změn a řešení potíží najdete v článku{' '}
    <a href="/cs/integrations/managing/egress-ip-addresses">
      Konfigurace odchozích IP adres integrace
    </a>.
  </Note>;

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="KnowBe4" />

## Co tato integrace poskytuje

KnowBe4 může poskytovat data o pracovní síle, školení a výsledcích phishingových simulací. Prověřené příklady zahrnují:

* `training.completed` — dokončí školení v oblasti zabezpečení
* `training.past.due` — má školení po termínu
* `phishing.simulation.clicked` — kliknul na simulaci, aniž by ji nahlásil

Tyto příklady ukazují typy normalizované aktivity, které může Living Security využívat. Viz [jak se data z integrací stávají signály](/cs/signals/data-sources).

## Co Living Security potřebuje

| Přihlašovací údaj | Popis |
| - | - |
| **Klíč API** | Token nositele (bearer token) rozhraní Reporting API vygenerovaný v části **Account Settings → API**. Odesílá se v každém požadavku v hlavičce `Authorization: Bearer`. |
| **Oblast serveru Reporting API** | Oblast, ve které je váš účet KnowBe4 zřízen, vybraná ze seznamu (USA, EU, Kanada, Spojené království, Německo). |

**Rozsahy oprávnění (scopes):** Není nutné nic konfigurovat — tokeny rozhraní KnowBe4 Reporting API jsou ze své podstaty určeny pouze pro čtení a nemají přiřazené rozsahy. Token poskytuje přístup pro čtení k uživatelům, přihlášením do školení a výsledkům testů zabezpečení proti phishingu, což je přesně to, co synchronizace čte.

**Požadovaná role:** **Account Admin** v KnowBe4 (do části **Account Settings → API** mají přístup pouze správci účtu)

### Předpoklady

* Musíte být přihlášeni do konzoly KnowBe4 s rolí **Account Admin**. Pouze správci účtu mají přístup do části **Account Settings → API**, kde lze povolit Reporting API a generovat tokeny.

***

## Část A — v KnowBe4

*Tyto kroky provede váš správce KnowBe4.*

<Steps>
  <Step title="Povolte Reporting API a vygenerujte token">
    1. Přihlaste se do konzoly KnowBe4.
    2. Klikněte na název svého účtu v pravém horním rohu a vyberte **Account Settings**.
    3. V levé navigaci vyberte **API**.
    4. Pokud ještě není povoleno, povolte **Reporting API** a poté vygenerujte nový token API.

    Pokud vás konzole vyzve k zadání účelu, uveďte popisný účel tokenu (např. `Living Security Platform`).

    <Warning>
      KnowBe4 zobrazí hodnotu tokenu API **pouze jednou**, a to při jeho vygenerování. Ihned ji zkopírujte a uložte na bezpečné místo (např. do správce hesel nebo trezoru tajných klíčů). Pokud stránku opustíte, aniž byste token zkopírovali, musíte vygenerovat nový.
    </Warning>

    <Note>
      Reporting API je určeno pouze pro čtení. Zpřístupňuje uživatele, přihlášení do školení a výsledky testů zabezpečení proti phishingu — tedy data, která Living Security přijímá pro účely hodnocení a reportování. Přístup pro zápis není vyžadován.
    </Note>
  </Step>

  <Step title="Přidejte odchozí IP adresy Living Security do seznamu Allowed IP Addresses">
    KnowBe4 umožňuje omezit přístup k Reporting API na určitou sadu zdrojových IP adres. Toto nastavení se nachází na stejném místě jako token:

    1. V konzole KnowBe4 přejděte do části **Account Settings → API → Allowed IP Addresses**.
    2. Přidejte do seznamu povolených každou [odchozí IP adresu Living Security](/cs/integrations/managing/egress-ip-addresses). Stejné čtyři adresy platí ve všech oblastech.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Pokud je seznam Allowed IP Addresses nakonfigurován, je vynucován na síťové vrstvě.** Dialog připojení při ověřování uspěje, ale synchronizace dat selžou (budou zablokovány na síťové vrstvě, což se obvykle projeví jako `403`), dokud nebudou odchozí IP adresy Living Security přidány do seznamu povolených. Pokud do tohoto seznamu přidáte jakoukoli adresu, musíte přidat také rozsahy Living Security, jinak budou naše požadavky odmítnuty, i když je váš token platný.
    </Warning>

    <Note>
      Odchozí IP adresy Living Security se mohou při aktualizaci infrastruktury změnit, i když takové změny provádíme jen výjimečně. Pokud synchronizace dat začnou selhávat poté, co dříve fungovaly, zkontrolujte [Konfiguraci odchozích IP adres integrací](/cs/integrations/managing/egress-ip-addresses) a ověřte, že seznam Allowed IP Addresses odpovídá.
    </Note>
  </Step>

  <Step title="Zjistěte oblast svého serveru KnowBe4">
    KnowBe4 poskytuje Reporting API z hostitele specifického pro danou oblast. Oblast vyberete v dialogu připojení, název hostitele nezadáváte:

    | Oblast | Hostitel Reporting API |
    | - | - |
    | Spojené státy | `us.api.knowbe4.com` |
    | Evropa | `eu.api.knowbe4.com` |
    | Kanada | `ca.api.knowbe4.com` |
    | Spojené království | `uk.api.knowbe4.com` |
    | Německo | `de.api.knowbe4.com` |

    Pokud si nejste jisti, kterou oblast váš účet používá, zkontrolujte doménu v adrese URL konzoly KnowBe4 nebo se obraťte na svého správce KnowBe4.

    <Note>
      Těchto pět oblastí je dostupných pro Living Security. Pokud je váš účet KnowBe4 na jiném serveru (například v instanci pro vládu USA), obraťte se před zahájením připojení na podporu Living Security.
    </Note>
  </Step>
</Steps>

***

## Část B — v Living Security Platform

*Tento krok provede vlastník programu, nebo správce systému, pokud se používá delegované nastavení.*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Pole | Hodnota |
    | - | - |
    | **Klíč API** | Token Reporting API z části A, kroku 1 |
    | **Oblast serveru Reporting API** | Oblast z části A, kroku 3 (např. Spojené státy) |
  </ConnectInPlatform>
</Steps>

Nyní jste připojeni ke KnowBe4.

***

## Řešení potíží

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Token API je neplatný nebo mu vypršela platnost. Ověřte, že je token správný a že nebyl znovu vygenerován v části **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    Buď token nemá přístup k Reporting API, nebo IP adresa požadavku není v seznamu Allowed IP Addresses. Ověřte, že je Reporting API povoleno a že všechny čtyři [odchozí IP adresy Living Security](/cs/integrations/managing/egress-ip-addresses) jsou v seznamu povolených.
  </Accordion>

  <Accordion title="Prázdné výsledky (200 OK, ale žádná data)">
    Reporting API možná zatím nemá žádná data k vrácení, nebo účet, ke kterému token patří, nemá přístup k uživatelům a kampaním, které Living Security přijímá. Ověřte, že token vygeneroval uživatel s rolí Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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