Skip to main content

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

​
Was Living Security benötigt

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

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

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 zur Zulassungsliste hinzu. Dieselben vier Adressen gelten in jeder Region.
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.
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 und prüfen Sie, ob die Liste der zulässigen IP-Adressen übereinstimmt.
3

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

​
Teil B – In der Living Security Platform

Der Programmverantwortliche führt diesen Schritt aus, bei delegierter Einrichtung der Systemadministrator.
Sie sind jetzt mit KnowBe4 verbunden.

​
Fehlerbehebung

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.
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 in der Zulassungsliste enthalten sind.
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.