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

# Google Workspace 整合設定

> 將 Google Workspace 連接至 Living Security，以取得使用者生命週期、登入、MFA、管理及資料保護活動。

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="Google Workspace" recommendDelegated={true} />

## 此整合提供的內容

Google Workspace 可提供經過標準化的使用者生命週期、登入、MFA、管理及資料保護活動。已審查的範例包括：

* `account.compromised` — 帳戶被標記為已遭入侵
* `data.sensitive.downloaded` — 下載敏感資料
* `auth.login.unusual` — 從異常情境登入

請參閱[整合資料如何轉換為訊號](/zh-Hant/signals/data-sources)。

## Living Security 所需的項目

| 憑證 | 說明 |
| - | - |
| **服務帳戶金鑰** | 專用 Google Cloud 服務帳戶的 JSON 金鑰。 |
| **委派管理員** | 服務帳戶可模擬的 Google Workspace 管理員電子郵件地址。 |

啟用 Admin SDK API，並僅授權該連線所讀取的範圍：

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## 設定

<Steps>
  <Step title="建立 Google Cloud 服務帳戶">
    建立專用服務帳戶，啟用網域全域委派，並下載其 JSON 金鑰。請妥善保管該金鑰。
  </Step>

  <Step title="授權網域全域委派">
    在 Google 管理控制台中，開啟 **Security → Access and data control → API controls → Manage Domain Wide Delegation**。新增服務帳戶的數字用戶端 ID 以及上述三個唯讀範圍。
  </Step>

  <Step title="選擇委派管理員">
    選擇一位可讀取目錄、角色指派及稽核報告的有效 Workspace 管理員。Living Security 僅將此身分用於委派的 API 讀取作業。
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    依提示上傳或貼上服務帳戶憑證，並輸入委派管理員的電子郵件地址。
  </ConnectInPlatform>
</Steps>

## 驗證與疑難排解

請確認該連線能夠讀取一位目錄使用者及近期的登入活動。Google 指出，新的網域全域委派授權可能需要一段時間才會生效。

<AccordionGroup>
  <Accordion title="unauthorized_client">
    請確認網域全域委派使用的是服務帳戶的數字用戶端 ID，而非其電子郵件地址，且三個範圍完全相符。
  </Accordion>

  <Accordion title="目錄可正常運作，但缺少角色指派">
    將 `admin.directory.rolemanagement.readonly` 新增至委派項目，並確認委派管理員可檢視角色指派。
  </Accordion>

  <Accordion title="報告為空">
    請確認已啟用 Admin Reports API，且委派管理員可存取該 Workspace 租用戶的稽核報告。
  </Accordion>
</AccordionGroup>

如需供應商端的詳細資訊，請參閱 [Google 的網域全域委派指南](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority)。

<PublicIntegrationNextSteps />


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