Skip to main content

​
此整合提供的資料

KnowBe4 可提供員工、訓練及網路釣魚模擬的成果資料。已審查的範例包括：
  • training.completed — 完成資安訓練
  • training.past.due — 訓練已逾期
  • phishing.simulation.clicked — 點擊模擬郵件但未回報
這些範例說明 Living Security 可使用的標準化活動類型。請參閱整合資料如何轉換為訊號。

​
Living Security 所需資訊

範圍 (Scopes)： 無需設定 — KnowBe4 Reporting API 權杖在設計上為唯讀，且不限定範圍。此權杖可讀取使用者、訓練註冊資料及網路釣魚安全測試結果，而這正是同步作業所讀取的資料。 所需角色： KnowBe4 中的 Account Admin（僅帳戶管理員可存取 Account Settings → API）

​
先決條件

  • 您必須以 Account Admin 角色登入 KnowBe4 主控台。僅帳戶管理員可存取 Account Settings → API 以啟用 Reporting API 並產生權杖。

​
第 A 部分 — 在 KnowBe4 中

由您的 KnowBe4 管理員完成這些步驟。
1

啟用 Reporting API 並產生權杖

  1. 登入您的 KnowBe4 主控台。
  2. 按一下右上角的帳戶名稱，然後選取 Account Settings。
  3. 在左側導覽中選取 API。
  4. 若尚未啟用 Reporting API，請先啟用，然後產生新的 API 權杖。
若主控台提示輸入用途，請為該權杖提供具描述性的用途（例如 Living Security Platform）。
KnowBe4 僅會在產生時顯示一次 API 權杖的值。請立即複製並儲存在安全的位置（例如密碼保險庫或密鑰管理工具）。若未複製即離開該頁面，您必須重新產生新的權杖。
Reporting API 為唯讀。它提供使用者、訓練註冊資料及網路釣魚安全測試結果 — 即 Living Security 用於評分與報告所擷取的資料。無需寫入權限。
2

將 Living Security 的輸出 IP 新增至 Allowed IP Addresses 清單

KnowBe4 可讓您將 Reporting API 的存取限制在特定的來源 IP 位址。此設定與權杖位於同一處：
  1. 在 KnowBe4 主控台中，前往 Account Settings → API → Allowed IP Addresses。
  2. 將每個 Living Security 輸出 IP 位址新增至允許清單。所有區域皆適用相同的四個位址。
若已設定 Allowed IP Addresses 清單，則會在網路層強制執行。 連線對話方塊在驗證階段會成功，但資料同步會失敗（在網路層遭到封鎖，通常會顯示為 403），直到 Living Security 輸出 IP 新增至允許清單為止。若您在此清單中新增任何位址，也必須新增 Living Security 的範圍，否則即使您的權杖有效，我們的請求仍會遭到拒絕。
Living Security 的輸出 IP 位址可能會在基礎架構更新時變更，但我們會盡量減少此類變更。若資料同步原本正常但後來開始失敗，請查看設定整合輸出 IP 位址，並確認 Allowed IP Addresses 清單與其相符。
3

確認您的 KnowBe4 伺服器區域

KnowBe4 由各區域專屬的主機提供 Reporting API。您只需在連線對話方塊中選擇區域，而無需輸入主機名稱：若不確定您的帳戶使用哪個區域，請查看 KnowBe4 主控台 URL 的網域，或聯絡您的 KnowBe4 管理員。
這五個區域是 Living Security 可連線的區域。若您的 KnowBe4 帳戶位於其他伺服器（例如美國政府專用執行個體），請在開始連線前聯絡 Living Security 支援團隊。

​
第 B 部分 — 在 Living Security Platform 中

由計畫負責人完成此步驟；若使用委派設定，則由系統管理員完成。
您現在已連接至 KnowBe4。

​
疑難排解

API 權杖無效或已過期。請確認權杖正確，且未在 Account Settings → API 中被重新產生。
可能是權杖缺少 Reporting API 存取權限，或請求的 IP 不在 Allowed IP Addresses 清單中。請確認已啟用 Reporting API，且所有四個 Living Security 輸出 IP 位址皆已加入允許清單。
Reporting API 可能尚無可回傳的資料，或該權杖所屬帳戶無法檢視 Living Security 所擷取的使用者與活動。請確認權杖是由 Account Admin 產生。