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

# CultureAI 整合設定

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

## 此整合提供的內容

CultureAI 可提供網路釣魚、訓練、員工回報及資料保護相關活動。已審查的範例包括：

* `phishing.real.clicked` — 點擊真實網路釣魚電子郵件中的連結
* `data.transfer.blocked` — 資料傳輸遭封鎖
* `phishing.safe.reported` — 回報後來經判定為安全的電子郵件

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

## Living Security 所需資訊

| 憑證 | 說明 |
| - | - |
| **API 金鑰** | 從您的 CultureAI 管理主控台產生的金鑰。Living Security 在每次請求時都會傳送此金鑰，以向 CultureAI API 進行驗證。這是唯一必要的憑證。 |

**範圍：** CultureAI API 金鑰不限定範圍，只要金鑰有效即可取得 API 存取權。Living Security 僅讀取報表資料；若您的 CultureAI 主控台在建立金鑰時提供範圍或權限選項，請授予唯讀的報表存取權。

**必要角色：** CultureAI 中的 **管理員** 或 **所有者**（用於管理 API 存取）

### 先決條件

* 您必須以具備管理 API 存取權限的角色登入 CultureAI 管理主控台，通常為 **管理員** 或 **所有者** 角色。若您未看到 API 或開發人員設定區域，請聯絡您的 CultureAI 客戶代表，為貴組織啟用 API 存取。

***

## 第 A 部分 — 在 CultureAI 中操作

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

<Steps>
  <Step title="產生 API 金鑰">
    1. 登入您的 CultureAI 管理主控台。
    2. 開啟組織或帳戶設定，並找到 **API**（或 **API 金鑰** / **開發人員**）區域。
    3. 建立新的 API 金鑰，並為其命名一個具描述性的名稱（例如 `Living Security Platform`）。

    <Note>
      Living Security 使用此金鑰以唯讀方式存取其從 CultureAI 匯入的報表資料，不需要寫入權限。若 CultureAI 提示您選擇範圍或權限，請僅授予報表資料的讀取權限。
    </Note>

    <Warning>
      CultureAI 可能在建立 API 金鑰時**僅顯示一次**金鑰值。請立即複製並儲存於安全的位置（例如密碼保管庫或機密管理工具）。若您在未複製的情況下離開頁面，將需要重新產生新的金鑰。
    </Warning>

    <Note>
      若您找不到建立 API 金鑰的位置，或不確定應授予哪些權限，請聯絡您的 CultureAI 客戶代表。Living Security 無法代您產生 CultureAI 憑證。
    </Note>
  </Step>
</Steps>

***

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

*由計畫所有者完成此步驟；若採用委派式設定，則由系統管理員完成。*

<Steps>
  <ConnectInPlatform tile="CultureAI">
    | 欄位 | 值 |
    | - | - |
    | **API 金鑰** | 第 A 部分取得的 API 金鑰 |
  </ConnectInPlatform>
</Steps>

您現已連接至 CultureAI。

***

## 疑難排解

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 金鑰無效或已遭撤銷。請確認金鑰正確，且未在 CultureAI 中重新產生。
  </Accordion>

  <Accordion title="403 Forbidden">
    API 金鑰缺少報表資料的讀取權限。請在 CultureAI 中確認該金鑰已獲授予讀取權限，或以正確的權限產生新的金鑰。
  </Accordion>

  <Accordion title="空白結果（200 OK 但無資料）">
    API 金鑰可能缺少 Living Security 所匯入報表資料的存取權。請向您的 CultureAI 客戶代表確認該金鑰具備報表資料的讀取權限。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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