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

# Einrichtung der KnowBe4-Integration

> Verbinden Sie KnowBe4 mit der Living Security Platform, um Benutzer, Schulungsanmeldungen und Ergebnisse von Phishing-Sicherheitstests zu importieren.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Weiterführende Ressourcen</h2>
    <ul>
      <li>
        <a href="/de/signals/data-sources">Erfahren Sie, wie Daten aus Integrationen zu Signalen für das Human Risk Management werden</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Living Security Integrationen entdecken</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Living Security Platform öffnen</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Living Security Demo anfordern</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Fügen Sie alle vier Egress-IP-Adressen der Living Security Synchronisierung</strong> in {system} zur Allowlist hinzu.{' '}
    Geben Sie jede Adresse als einzelnen Host mit <code>/32</code> an, wenn {system} die CIDR-Notation erwartet:
    <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 />
    Der Datenverkehr kann von jeder der vier Adressen ausgehen. Wenn nur einige davon in die Allowlist aufgenommen werden, kommt es daher zu sporadischen Synchronisierungsfehlern. Diese vier Adressen sind in jeder Living Security Region identisch. Die vollständige Liste, die Änderungsrichtlinie und Hinweise zur Fehlerbehebung finden Sie unter{' '}
    <a href="/de/integrations/managing/egress-ip-addresses">
      Egress-IP-Adressen für Integrationen konfigurieren
    </a>.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Zugangsdaten in der Living Security Platform eingeben">
    <p>
      Wird von der Person durchgeführt, die über Living Security-Zugriff verfügt – dem Programmverantwortlichen oder dem Systemadministrator, sofern dieser eingeladen wurde (delegierte Einrichtung).
    </p>
    <ol>
      <li>
        Gehen Sie zu <strong>Einstellungen → Integrationen → Catalog</strong>, suchen Sie die Kachel{' '}
        <strong>{tile}</strong> und klicken Sie auf <strong>Verbinden</strong>.
      </li>
      <li>
        Füllen Sie die folgenden Felder aus und klicken Sie anschließend auf <strong>Verbinden</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Diese Anleitung richtet sich an Ihre {system}-Administratorin bzw. Ihren {system}-Administrator.</strong> Sie beschreibt das Erstellen von API-Zugangsdaten in {system}. Dafür ist Administratorzugriff auf {system} erforderlich – nicht auf die
      Living Security Platform.
    </p>
    <p>
      Wenn Sie als <strong>Programmverantwortlicher</strong> von Living Security {system} nicht selbst administrieren,
      leiten Sie diese Seite an die zuständige Person weiter. Diese führt Teil A durch und übergibt Ihnen die Zugangsdaten
      (oder gibt sie direkt ein, sofern Sie sie in die Plattform eingeladen haben).
      {recommendDelegated && <>
          {' '}Da bei der Einrichtung sensibles Schlüsselmaterial entsteht, empfehlen wir den Weg der{' '}
          <strong>delegierten Einrichtung</strong>, damit das Secret nie an Sie zurückgesendet wird.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

## Was diese Integration beiträgt

KnowBe4 kann Ergebnisse zur Belegschaft, zur Schulung und zu Phishing-Simulationen beisteuern. Zu den geprüften Beispielen gehören:

* `training.completed` – schließt eine Sicherheitsschulung ab
* `training.past.due` – hat überfällige Schulungen
* `phishing.simulation.clicked` – hat in einer Simulation geklickt, ohne dies zu melden

Diese Beispiele zeigen die Arten normalisierter Aktivitäten, die Living Security verwenden kann. Weitere Informationen finden Sie unter [Wie Integrationsdaten zu Signalen werden](/de/signals/data-sources).

## Was Living Security benötigt

| Zugangsdaten | Beschreibung |
| - | - |
| **API-Schlüssel** | Ein Bearer-Token der Reporting API, das unter **Account Settings → API** generiert wird. Wird bei jeder Anfrage im Header `Authorization: Bearer` gesendet. |
| **Reporting API server region** | Die Region, in der Ihr KnowBe4-Konto bereitgestellt wird, auswählbar aus einer Liste (USA, EU, Kanada, Vereinigtes Königreich, Deutschland). |

**Scopes:** Es ist nichts zu konfigurieren – KnowBe4-Reporting-API-Tokens sind konzeptionell schreibgeschützt und haben keine Scopes. Das Token gewährt Lesezugriff auf Benutzer, Schulungsanmeldungen und Ergebnisse von Phishing-Sicherheitstests, also genau auf das, was die Synchronisierung liest.

**Erforderliche Rolle:** **Account Admin** in KnowBe4 (nur Kontoadministratoren können auf **Account Settings → API** zugreifen)

### Voraussetzungen

* Sie müssen in Ihrer KnowBe4-Konsole mit der Rolle **Account Admin** angemeldet sein. Nur Kontoadministratoren können auf **Account Settings → API** zugreifen, um die Reporting API zu aktivieren und Tokens zu generieren.

***

## Teil A – In KnowBe4

*Ihr KnowBe4-Administrator führt diese Schritte aus.*

<Steps>
  <Step title="Reporting API aktivieren und Token generieren">
    1. Melden Sie sich bei Ihrer KnowBe4-Konsole an.
    2. Klicken Sie oben rechts auf Ihren Kontonamen und wählen Sie **Account Settings**.
    3. Wählen Sie in der linken Navigation **API**.
    4. Aktivieren Sie die **Reporting API**, falls sie noch nicht aktiviert ist, und generieren Sie anschließend ein neues API-Token.

    Geben Sie dem Token einen aussagekräftigen Verwendungszweck (z. B. `Living Security Platform`), falls Ihre Konsole danach fragt.

    <Warning>
      KnowBe4 zeigt den Wert des API-Tokens **nur einmal** an, nämlich bei seiner Generierung. Kopieren Sie ihn sofort und bewahren Sie ihn an einem sicheren Ort auf (z. B. in einem Passwort-Tresor oder Secrets Manager). Wenn Sie die Seite verlassen, ohne ihn zu kopieren, müssen Sie ein neues Token generieren.
    </Warning>

    <Note>
      Die Reporting API ist schreibgeschützt. Sie stellt Benutzer, Schulungsanmeldungen und Ergebnisse von Phishing-Sicherheitstests bereit – die Daten, die Living Security für Bewertung und Berichte erfasst. Schreibzugriff ist nicht erforderlich.
    </Note>
  </Step>

  <Step title="Egress-IP-Adressen von Living Security zur Liste der zulässigen IP-Adressen hinzufügen">
    Mit KnowBe4 können Sie den Zugriff auf die Reporting API auf bestimmte Quell-IP-Adressen beschränken. Diese Einstellung befindet sich an derselben Stelle wie das Token:

    1. Rufen Sie in Ihrer KnowBe4-Konsole **Account Settings → API → Allowed IP Addresses** auf.
    2. Fügen Sie jede [Egress-IP-Adresse von Living Security](/de/integrations/managing/egress-ip-addresses) zur Zulassungsliste hinzu. Dieselben vier Adressen gelten in jeder Region.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Wenn die Liste der zulässigen IP-Adressen konfiguriert ist, wird sie auf Netzwerkebene durchgesetzt.** Der Verbindungsdialog ist bei der Authentifizierung erfolgreich, aber Datensynchronisierungen schlagen fehl (sie werden auf Netzwerkebene blockiert und äußern sich typischerweise als `403`), bis die Egress-IP-Adressen von Living Security zur Zulassungsliste hinzugefügt wurden. Wenn Sie dieser Liste eine beliebige Adresse hinzufügen, müssen Sie auch die Bereiche von Living Security hinzufügen, andernfalls werden unsere Anfragen abgelehnt, obwohl Ihr Token gültig ist.
    </Warning>

    <Note>
      Die Egress-IP-Adressen von Living Security können sich ändern, wenn die Infrastruktur aktualisiert wird, auch wenn wir solche Änderungen selten vornehmen. Wenn Datensynchronisierungen, die zuvor funktioniert haben, plötzlich fehlschlagen, lesen Sie [Egress-IP-Adressen für Integrationen konfigurieren](/de/integrations/managing/egress-ip-addresses) und prüfen Sie, ob die Liste der zulässigen IP-Adressen übereinstimmt.
    </Note>
  </Step>

  <Step title="KnowBe4-Serverregion ermitteln">
    KnowBe4 stellt die Reporting API über einen regionsspezifischen Host bereit. Sie wählen Ihre Region im Verbindungsdialog aus, anstatt einen Hostnamen einzugeben:

    | Region | Reporting-API-Host |
    | - | - |
    | USA | `us.api.knowbe4.com` |
    | Europa | `eu.api.knowbe4.com` |
    | Kanada | `ca.api.knowbe4.com` |
    | Vereinigtes Königreich | `uk.api.knowbe4.com` |
    | Deutschland | `de.api.knowbe4.com` |

    Wenn Sie nicht sicher sind, welche Region Ihr Konto verwendet, prüfen Sie die Domain der URL Ihrer KnowBe4-Konsole oder wenden Sie sich an Ihren KnowBe4-Administrator.

    <Note>
      Diese fünf Regionen kann Living Security erreichen. Wenn sich Ihr KnowBe4-Konto auf einem anderen Server befindet (zum Beispiel einer US-Government-Instanz), wenden Sie sich an den Living-Security-Support, bevor Sie die Verbindung einrichten.
    </Note>
  </Step>
</Steps>

***

## Teil B – In der Living Security Platform

*Der Programmverantwortliche führt diesen Schritt aus, bei delegierter Einrichtung der Systemadministrator.*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Feld | Wert |
    | - | - |
    | **API-Schlüssel** | Das Reporting-API-Token aus Teil A, Schritt 1 |
    | **Reporting API server region** | Die Region aus Teil A, Schritt 3 (z. B. USA) |
  </ConnectInPlatform>
</Steps>

Sie sind jetzt mit KnowBe4 verbunden.

***

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Das API-Token ist ungültig oder abgelaufen. Prüfen Sie, ob das Token korrekt ist und unter **Account Settings → API** nicht neu generiert wurde.
  </Accordion>

  <Accordion title="403 Forbidden">
    Entweder hat das Token keinen Zugriff auf die Reporting API, oder die IP-Adresse der Anfrage steht nicht auf der Liste der zulässigen IP-Adressen. Prüfen Sie, ob die Reporting API aktiviert ist und ob alle vier [Egress-IP-Adressen von Living Security](/de/integrations/managing/egress-ip-addresses) in der Zulassungsliste enthalten sind.
  </Accordion>

  <Accordion title="Leere Ergebnisse (200 OK, aber keine Daten)">
    Möglicherweise liegen in der Reporting API noch keine Daten zur Rückgabe vor, oder das Konto des Tokens hat keinen Einblick in die Benutzer und Kampagnen, die Living Security erfasst. Prüfen Sie, ob das Token von einem Account Admin generiert wurde.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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