> ## 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="/ja/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 認証情報を作成する手順を説明します。この作業には、Living Security Platform ではなく、{system} の管理者権限が必要です。
    </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` — 通常とは異なる状況でのサインイン

[連携データがどのようにシグナルになるか](/ja/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 と、上記の 3 つの読み取り専用スコープを追加します。
  </Step>

  <Step title="委任された管理者を選択する">
    ディレクトリ、ロールの割り当て、監査レポートを読み取ることができる、有効な Workspace 管理者を選択します。Living Security は、このIDを委任された API の読み取りにのみ使用します。
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    画面の指示に従ってサービスアカウントの認証情報をアップロードまたは貼り付け、委任された管理者のメールアドレスを入力します。
  </ConnectInPlatform>
</Steps>

## 確認とトラブルシューティング

接続によってディレクトリ内のユーザー 1 名と最近のログインアクティビティを読み取れることを確認してください。Google によると、新しいドメイン全体の委任の付与が反映されるまでには時間がかかる場合があります。

<AccordionGroup>
  <Accordion title="unauthorized_client">
    ドメイン全体の委任に、メールアドレスではなくサービスアカウントの数値のクライアント ID を使用していること、および 3 つのスコープがすべて完全に一致していることを確認してください。
  </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.