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

# Adaptive Security 整合設定

> 將 Adaptive Security 連接至 Living Security Platform，為您的員工匯入網路釣魚、簡訊釣魚（smishing）及語音釣魚（vishing）模擬成果，以及資安意識訓練結果。

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="Adaptive Security" />

## 此整合提供的資料

Adaptive Security 可提供員工、訓練及多管道模擬成果。已審閱的範例包括：

* `phishing.simulation.clicked` — 點擊了模擬電子郵件但未通報
* `phishing.simulation.credential.submitted` — 在模擬登入頁面輸入了憑證
* `phishing.simulation.attachment.opened` — 開啟了模擬電子郵件中的附件
* `phishing.simulation.reported` — 通報了模擬電子郵件
* `smishing.simulation.replied` — 回覆了模擬簡訊
* `vishing.simulation.succeeded` — 依照模擬語音來電者的要求行事
* `training.assigned` — 被指派資安訓練
* `training.completed` — 完成了資安訓練
* `training.past.due` — 錯過了訓練期限

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

<Note>
  **Adaptive 透過三種管道進行模擬，Living Security 會分別為每種管道評分。**
  電子郵件成果以網路釣魚評分，簡訊成果以簡訊釣魚（smishing）評分，語音通話成果以語音釣魚（vishing）評分。點擊模擬電子郵件的人與回覆模擬簡訊的人，其行為不會被視為相同，因為兩者所做的判斷不同。
</Note>

## Living Security 所需的項目

| 憑證 | 說明 |
| - | - |
| **API 權杖** | Adaptive Security API 權杖。Living Security 會在每次請求時將其作為 bearer 權杖傳送。 |

**所需角色：** 您 Adaptive Security 帳戶中可存取 **設定 → API** 的管理員。Adaptive 以角色型權限管控 API 存取，因此該權杖必須屬於可讀取使用者、網路釣魚及訓練資料的角色。

**存取權限：** 唯讀。Living Security 僅從 Adaptive Security 讀取資料，絕不會在您的帳戶中建立、變更或刪除任何內容。

### Living Security 擷取的資料

| 資料 | 詳細資訊 |
| - | - |
| **人** | 您的 Adaptive 使用者目錄：姓名、電子郵件、部門、職稱、主管姓名與電子郵件、地點、事業部、僱用狀態及到職日期。 |
| **電子郵件模擬** | 每人每次模擬：郵件送達、開啟、點擊、回覆、附件開啟、QR 碼掃描、輸入憑證或通報的時間。 |
| **簡訊模擬** | 每人每次模擬：送達、開啟、點擊、回覆、輸入憑證或通報。 |
| **語音模擬** | 每人每次模擬：誘餌送達、撥打的號碼、該人員是否依照來電者的要求行事，以及是否通報。 |
| **訓練** | 每人每個活動：註冊時間、到期日、開始時間、完成時間，以及是否已確認活動政策。 |

<Note>
  **不會儲存電話號碼。** Adaptive 會在其使用者記錄中回傳辦公室與行動電話號碼。由於 Living Security 的任何功能都不會用到這些號碼，因此在儲存任何資料之前，Living Security 會先捨棄這兩項資料。
</Note>

<Note>
  **Adaptive 本身的風險分數會被記錄，但不會納入評分。** Adaptive 會為每個人計算一個 `current_risk_score`。Living Security 會保留該分數，以便您並排比較兩套系統，但人員風險指數一律依據所觀察到的行為，並採用 Living Security 自行公布的模型計算——絕不會採用其他廠商的綜合分數。
</Note>

### 先決條件

* 已啟用 API 的 Adaptive Security 帳戶。
* [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) 的管理員存取權限。
* Adaptive 中的使用者電子郵件地址須與您其他已連接系統所使用的地址相符。Living Security 透過電子郵件將 Adaptive 使用者與人員進行比對。

***

## A 部分 — 在 Adaptive Security 中

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

<Steps>
  <Step title="開啟 API 設定">
    1. 以管理員身分登入 [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com)。
    2. 前往 **設定 → API**。
  </Step>

  <Step title="產生 API 權杖">
    1. 產生新的 API 權杖。
    2. 為其命名一個日後容易辨識的名稱——例如 `Living Security`。
    3. 確認該權杖的角色可讀取使用者、網路釣魚活動及訓練活動。
    4. 複製該權杖。

    <Warning>
      請在離開頁面之前複製權杖。若您的 Adaptive 帳戶為權杖設定了到期日，請記下該日期——權杖到期後 Living Security 將無法擷取資料，且必須使用新的權杖更新連線。
    </Warning>
  </Step>
</Steps>

***

## B 部分 — 在 Living Security Platform 中

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

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | 欄位 | 值 |
    | - | - |
    | **API 權杖** | 您在 A 部分產生的權杖 |
  </ConnectInPlatform>
</Steps>

您現在已連接至 Adaptive Security。

***

## 資料擷取頻率

| 資料 | 排程 |
| - | - |
| 人 | 每 6 小時 |
| 模擬成果（電子郵件、簡訊、語音） | 每 6 小時 |
| 訓練結果 | 每 6 小時 |

Adaptive 的報告 API 未提供「自上次以來的變更」篩選功能，因此 Living Security 會在每個模擬與訓練活動仍持續產生成果期間讀取該活動，並在其關閉兩週後停止讀取。如此一來，較晚發生的點擊與通報仍可被擷取，而已結束的活動也不會被無限期重複讀取。

<Note>
  在大型 Adaptive 帳戶上首次連線時，可能需要經過數次排程執行才能讀完所有資料。每次執行都會盡可能多讀取資料，下一次則從上次停止之處繼續，因此數量會在最初一兩天內逐步增加，而非一次全部顯示。
</Note>

***

## 疑難排解

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 權杖有誤、已過期或已被撤銷。Adaptive 在此錯誤下會回傳空白的回應內容，因此沒有更多詳細資訊可供查閱。請在 **設定 → API** 中產生新的權杖，並使用該權杖重新連線。權杖只複製了一部分也會產生相同的錯誤，且這是最常見的原因。
  </Accordion>

  <Accordion title="403 Forbidden">
    權杖已通過驗證，但其角色無法讀取所請求的資料。重新貼上相同的權杖並無幫助。請在 Adaptive 中確認該權杖的角色具有使用者、網路釣魚及訓練的讀取權限，或改用具有這些權限之角色所發出的權杖。
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive 對該連線實施了速率限制。Living Security 會中止該次執行，並在下一次排程執行時從相同位置繼續，因此不會遺失資料——數量只是需要更長時間才會增加。若此情況持續數天，請聯絡 Adaptive Security 支援團隊，詢問適用於您帳戶的速率限制。
  </Accordion>

  <Accordion title="已出現人員，但沒有任何模擬成果">
    請確認您預期的活動確實已執行。Adaptive 僅會回報已發送之模擬的註冊資料，因此狀態仍為 **Draft**（草案）或 **Scheduled**（預定）的活動，在發出之前不會提供任何資料。Living Security 刻意不讀取這些活動，以便將其請求額度用於已有實際成果的活動。
  </Accordion>

  <Accordion title="缺少語音或簡訊模擬">
    Living Security 會依據附屬於每筆成果的情境來判斷其管道。如果某個情境在其模擬執行後於 Adaptive 中被刪除，由於已無法讀取其管道，該情境的成果會被記錄為電子郵件管道。將已停用的情境保留在 Adaptive 中而非刪除，即可避免此情況。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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