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

# KnowBe4 整合設定

> 將 KnowBe4 連接至 Living Security Platform，以匯入使用者、訓練註冊資料及網路釣魚安全測試結果。

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>相關資源</h2>
    <ul>
      <li>
        <a href="/zh-Hant/signals/data-sources">了解整合資料如何轉換為人員風險管理訊號</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">探索 Living Security 整合</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">開啟 Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">申請 Living Security 示範</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>請將 Living Security 同步作業的全部四個輸出 IP 位址</strong>新增至{' '}
    {system} 的允許清單。若 {system} 要求使用 CIDR 表示法，請將每個位址分別以單一主機形式輸入，並加上 <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 />
    流量可能從這四個位址中的任何一個送出，因此僅將其中部分位址加入允許清單，會導致間歇性的同步失敗。這四個位址在 Living Security 的所有區域中皆相同。如需完整清單、變更政策及疑難排解資訊，請參閱{' '}
    <a href="/zh-Hant/integrations/managing/egress-ip-addresses">
      設定整合輸出 IP 位址
    </a>。
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="在 Living Security Platform 中輸入憑證">
    <p>
      由擁有 Living Security 存取權限的人員完成——即計畫負責人，或已受邀的系統管理員（委派設定）。
    </p>
    <ol>
      <li>
        前往 <strong>設定 → 集成 → 目錄</strong>，找到{' '}
        <strong>{tile}</strong> 圖磚，然後按一下 <strong>連接</strong>。
      </li>
      <li>
        填寫以下欄位，然後按一下 <strong>連接</strong>。
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>本指南適用於貴組織的 {system} 管理員。</strong>內容涵蓋在 {system} 中建立 API
      憑證的步驟，此操作需要 {system} 的管理員存取權限，而非 Living Security Platform 的存取權限。
    </p>
    <p>
      如果您是 Living Security 的<strong>方案負責人</strong>，且並非 {system} 的管理員，
      請將本頁面轉交給負責管理 {system} 的人員。對方完成 A 部分後，會將憑證交還給您
      （若您已邀請對方加入平台，對方也可以直接輸入憑證）。
      {recommendDelegated && <>
          {' '}由於設定過程會產生敏感的金鑰資料，建議採用{' '}
          <strong>委派設定</strong>方式，避免將密鑰傳回給您。
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

## 此整合提供的資料

KnowBe4 可提供員工、訓練及網路釣魚模擬的成果資料。已審查的範例包括：

* `training.completed` — 完成資安訓練
* `training.past.due` — 訓練已逾期
* `phishing.simulation.clicked` — 點擊模擬郵件但未回報

這些範例說明 Living Security 可使用的標準化活動類型。請參閱[整合資料如何轉換為訊號](/zh-Hant/signals/data-sources)。

## Living Security 所需資訊

| 憑證 | 說明 |
| - | - |
| **API 金鑰** | 在 **Account Settings → API** 下產生的 Reporting API 持有人權杖 (bearer token)。每個請求都會透過 `Authorization: Bearer` 標頭傳送。 |
| **Reporting API 伺服器區域** | 您的 KnowBe4 帳戶所佈建的區域，需從清單中選擇（美國、歐洲、加拿大、英國、德國）。 |

**範圍 (Scopes)：** 無需設定 — KnowBe4 Reporting API 權杖在設計上為唯讀，且不限定範圍。此權杖可讀取使用者、訓練註冊資料及網路釣魚安全測試結果，而這正是同步作業所讀取的資料。

**所需角色：** KnowBe4 中的 **Account Admin**（僅帳戶管理員可存取 **Account Settings → API**）

### 先決條件

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

***

## 第 A 部分 — 在 KnowBe4 中

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

<Steps>
  <Step title="啟用 Reporting API 並產生權杖">
    1. 登入您的 KnowBe4 主控台。
    2. 按一下右上角的帳戶名稱，然後選取 **Account Settings**。
    3. 在左側導覽中選取 **API**。
    4. 若尚未啟用 **Reporting API**，請先啟用，然後產生新的 API 權杖。

    若主控台提示輸入用途，請為該權杖提供具描述性的用途（例如 `Living Security Platform`）。

    <Warning>
      KnowBe4 **僅會在產生時顯示一次** API 權杖的值。請立即複製並儲存在安全的位置（例如密碼保險庫或密鑰管理工具）。若未複製即離開該頁面，您必須重新產生新的權杖。
    </Warning>

    <Note>
      Reporting API 為唯讀。它提供使用者、訓練註冊資料及網路釣魚安全測試結果 — 即 Living Security 用於評分與報告所擷取的資料。無需寫入權限。
    </Note>
  </Step>

  <Step title="將 Living Security 的輸出 IP 新增至 Allowed IP Addresses 清單">
    KnowBe4 可讓您將 Reporting API 的存取限制在特定的來源 IP 位址。此設定與權杖位於同一處：

    1. 在 KnowBe4 主控台中，前往 **Account Settings → API → Allowed IP Addresses**。
    2. 將每個 [Living Security 輸出 IP 位址](/zh-Hant/integrations/managing/egress-ip-addresses)新增至允許清單。所有區域皆適用相同的四個位址。

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **若已設定 Allowed IP Addresses 清單，則會在網路層強制執行。** 連線對話方塊在驗證階段會成功，但資料同步會失敗（在網路層遭到封鎖，通常會顯示為 `403`），直到 Living Security 輸出 IP 新增至允許清單為止。若您在此清單中新增任何位址，也必須新增 Living Security 的範圍，否則即使您的權杖有效，我們的請求仍會遭到拒絕。
    </Warning>

    <Note>
      Living Security 的輸出 IP 位址可能會在基礎架構更新時變更，但我們會盡量減少此類變更。若資料同步原本正常但後來開始失敗，請查看[設定整合輸出 IP 位址](/zh-Hant/integrations/managing/egress-ip-addresses)，並確認 Allowed IP Addresses 清單與其相符。
    </Note>
  </Step>

  <Step title="確認您的 KnowBe4 伺服器區域">
    KnowBe4 由各區域專屬的主機提供 Reporting API。您只需在連線對話方塊中選擇區域，而無需輸入主機名稱：

    | 區域 | Reporting API 主機 |
    | - | - |
    | 美國 | `us.api.knowbe4.com` |
    | 歐洲 | `eu.api.knowbe4.com` |
    | 加拿大 | `ca.api.knowbe4.com` |
    | 英國 | `uk.api.knowbe4.com` |
    | 德國 | `de.api.knowbe4.com` |

    若不確定您的帳戶使用哪個區域，請查看 KnowBe4 主控台 URL 的網域，或聯絡您的 KnowBe4 管理員。

    <Note>
      這五個區域是 Living Security 可連線的區域。若您的 KnowBe4 帳戶位於其他伺服器（例如美國政府專用執行個體），請在開始連線前聯絡 Living Security 支援團隊。
    </Note>
  </Step>
</Steps>

***

## 第 B 部分 — 在 Living Security Platform 中

*由計畫負責人完成此步驟；若使用委派設定，則由系統管理員完成。*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | 欄位 | 值 |
    | - | - |
    | **API 金鑰** | 第 A 部分步驟 1 中取得的 Reporting API 權杖 |
    | **Reporting API 伺服器區域** | 第 A 部分步驟 3 中確認的區域（例如美國） |
  </ConnectInPlatform>
</Steps>

您現在已連接至 KnowBe4。

***

## 疑難排解

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 權杖無效或已過期。請確認權杖正確，且未在 **Account Settings → API** 中被重新產生。
  </Accordion>

  <Accordion title="403 Forbidden">
    可能是權杖缺少 Reporting API 存取權限，或請求的 IP 不在 Allowed IP Addresses 清單中。請確認已啟用 Reporting API，且所有四個 [Living Security 輸出 IP 位址](/zh-Hant/integrations/managing/egress-ip-addresses)皆已加入允許清單。
  </Accordion>

  <Accordion title="空白結果（200 OK 但無資料）">
    Reporting API 可能尚無可回傳的資料，或該權杖所屬帳戶無法檢視 Living Security 所擷取的使用者與活動。請確認權杖是由 Account Admin 產生。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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