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

# NINJIO 集成設定

> 將 NINJIO 連接至 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 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="NINJIO" />

## 此集成提供的內容

NINJIO 可提供員工、培訓及網路釣魚模擬的成果。已審核的範例包括：

* `training.assigned` — 已被指派資安培訓
* `training.completed` — 完成資安培訓
* `training.passed` — 通過資安培訓評量
* `phishing.simulation.clicked` — 點擊模擬郵件但未回報
* `phishing.simulation.reported` — 回報網路釣魚模擬

這些範例顯示 Living Security 可使用的標準化活動類型。請參閱[集成資料如何成為訊號](/zh-Hant/signals/data-sources)。

## Living Security 所需資訊

| 憑證 | 說明 |
| - | - |
| **API 金鑰** | 具備員工、培訓及網路釣魚存取點讀取權限的 NINJIO API 金鑰。Living Security 會在每次請求時傳送此金鑰。 |

**權限範圍：** NINJIO 會依*存取點*為每個 API 金鑰設定範圍，並分別提供讀取與寫入權限。Living Security 需要三個存取點的**讀取**權限：員工、培訓及網路釣魚。不需要寫入權限，也不應授予。

**所需角色：** NINJIO 帳戶的**管理員**。只有管理員才能進入建立金鑰的集成區域。

<Warning>
  **NINJIO 僅會在建立新金鑰時顯示一次。** 請在離開頁面之前，立即將其複製到 Living Security Platform 或密碼保險庫中。未複製的金鑰無法再次取得，您必須產生新的金鑰。
</Warning>

### Living Security 擷取的內容

| 資料 | 詳細資訊 |
| - | - |
| **學習者** | 您的 NINJIO 員工目錄：姓名、電子郵件、部門、職稱、主管、國家/地區、分公司及主動狀態。 |
| **培訓** | 每項培訓的指派對象與完成者，包括完成日期、測驗分數及參與度分數。 |
| **網路釣魚** | 與模擬網路釣魚郵件互動的人員與回報該郵件的人員，以及發生的時間。 |

<Note>
  **不會儲存學習者的電話號碼。** NINJIO 的員工記錄中會傳回電話號碼。由於 Living Security 的任何功能都不會使用該資料，因此在儲存任何內容之前便會將其捨棄。
</Note>

### 先決條件

* 具備 API 存取權限的 NINJIO 帳戶。
* 具備 [admin.goninjio.com](https://admin.goninjio.com/) 的管理員存取權限。
* NINJIO 中的學習者電子郵件地址，須與您其他已連接系統所使用的地址一致。Living Security 會透過電子郵件將 NINJIO 學習者與人員相符。

***

## 第 A 部分 — 在 NINJIO 中

*由您的 NINJIO 管理員完成以下步驟。*

<Steps>
  <Step title="開啟集成區域">
    1. 以管理員身分登入 [admin.goninjio.com](https://admin.goninjio.com/)。
    2. 選取畫面右上角的 **Integration**。
  </Step>

  <Step title="建立 API 金鑰">
    1. 選取 **New API Key**。
    2. 為金鑰命名一個日後容易辨識的名稱，例如 `Living Security`。
    3. 授予 **employee**、**training** 及 **phishing** 存取點的**讀取**權限。
    4. 請勿選取寫入權限。Living Security 僅會從 NINJIO 讀取資料。
    5. 選取 **Generate Key**。

    <Warning>
      請立即複製金鑰。NINJIO 僅顯示一次，之後無法再次顯示。
    </Warning>
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | 欄位 | 值 |
    | - | - |
    | **API 金鑰** | 您在第 A 部分產生的金鑰 |
  </ConnectInPlatform>
</Steps>

您現在已連接至 NINJIO。

***

## 資料擷取頻率

| 資料 | 排程 |
| - | - |
| 學習者 | 每日 |
| 培訓結果 | 每 6 小時 |
| 網路釣魚結果 | 每 6 小時 |

首次連接時，Living Security 會擷取過去 12 個月的培訓完成記錄，之後以增量方式持續更新。網路釣魚模擬每次僅讀取一次，並會在模擬結束後的兩週內重新檢查，因此延遲的點擊與延遲的回報仍會被擷取。

<Note>
  大型 NINJIO 帳戶首次連接時，可能需要多次排程執行才能讀取完所有資料。每次執行會盡可能讀取更多資料，下一次則從上次中斷處繼續，因此數量會在第一兩天內逐步增加，而不是一次全部出現。
</Note>

***

## 疑難排解

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 金鑰錯誤或不完整。最常見的原因是金鑰只複製了一部分：NINJIO 僅顯示一次，因此很容易貼上被截斷的內容，且事後無法察覺。請在 NINJIO 中產生新金鑰，並使用該金鑰重新連接。
  </Accordion>

  <Accordion title="403 Forbidden">
    這**並非**憑證問題。金鑰已通過驗證，但所需的其中一個存取點未被授予讀取權限。

    重新貼上相同的金鑰並無幫助。請在 NINJIO 中建立一個對 employee、training 及 phishing 三個存取點皆具**讀取**權限的金鑰，並使用該金鑰重新連接。
  </Accordion>

  <Accordion title="已成功連接但沒有培訓資料">
    請在 NINJIO 中確認至少有一個培訓活動處於**主動**狀態，且已附加模擬。沒有模擬的活動會維持非主動狀態且不會傳送任何內容，因此沒有可擷取的結果。

    如果活動處於主動狀態，請確認其中的學習者在 NINJIO 記錄中具有電子郵件地址。沒有電子郵件地址的學習者無法與人員相符，將會被略過。
  </Accordion>

  <Accordion title="培訓顯示為已指派但從未完成">
    對於學習者尚未完成的培訓，這是預期的顯示方式。Living Security 會在 NINJIO 模擬開始時記錄指派，並在 NINJIO 回報完成日期時另行記錄完成情況。
  </Accordion>

  <Accordion title="部分學習者遺失">
    Living Security 會依**電子郵件地址**將 NINJIO 學習者與人員相符。若學習者在 NINJIO 中的電子郵件與您的目錄所儲存的地址不同（例如個人地址、舊網域或拼字錯誤），便無法相符。

    請在 NINJIO 中更正該地址，下次排程擷取時即可相符。
  </Accordion>

  <Accordion title="較舊模擬的網路釣魚結果遺失">
    Living Security 會在網路釣魚模擬結束後的兩週內重新檢查，之後即停止。NINJIO 在該期間之後記錄的結果不會被擷取。如需重新讀取較舊的模擬，請聯絡支援團隊。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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