> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace

> フェデレーション認証とプロビジョニング用の組み込み接続テンプレートを使用して、ユーザーが Google Workspace アカウントで Iru Identity にサインインできるようにします。

**Google Workspace** を接続すると、ユーザーはすでに持っている Google アカウントを使用して Iru にサインイン (および割り当てられたアプリにアクセス) できます。Iru には標準構成を事前入力する **Google Workspace テンプレート**が用意されているため、最も迅速に接続できるプロバイダーの 1 つです。

<Info>
  Iru Identity を ID プロバイダーとして使用しているほとんどの組織では、ユーザーはパスキーまたは Iru Access アプリで直接サインインします。Iru Identity をプライマリ ID プロバイダーではなく Iru プラットフォームへの認証レイヤーとして使用する場合、または Iru Identity への移行を容易にする場合に Google Workspace を接続します。[フェデレーション認証](/ja/identity/connections/connections-overview)を参照してください。
</Info>

<Note>
  この接続を完了するには、Iru テナントの管理者アクセス権と、Google Workspace 組織の Google 管理コンソールへのアクセス権が必要です。
</Note>

## 始める前に

<Steps>
  <Step title="サインインドメインを確認する">
    ユーザーがサインインに使用するメール**ドメイン** (例: `yourcompany.com`) を控えておきます。接続をこれらのドメインに制限して、それらのドメインのユーザーのみが使用できるようにすることができます。
  </Step>

  <Step title="Iru によるユーザーの照合方法を決定する">
    ユーザーが Google を通じてサインインすると、Iru はそのユーザーをディレクトリ内のユーザーと照合します。照合に使用する値 (通常はユーザーのメールアドレスまたはユーザー名) を決定します。[ユーザーマッチング](/ja/identity/connections/connections-overview#what-you-configure-on-every-identity-provider-connection)を参照してください。
  </Step>

  <Step title="ユーザーが Iru に存在することを確認する">
    接続を通じたサインインは、既存の Iru ユーザーに解決されます。最初にユーザーを追加またはインポートしてください。[ユーザーのインポート](/ja/identity/directory/importing-users)または [Directory Sync](/ja/identity/directory/directory-sync) を参照してください。
  </Step>
</Steps>

## Google Workspace を接続する

<Steps>
  <Step title="接続を追加する">
    **Access → Authentication** で **authentication method** を追加し、**Google Workspace** テンプレートを選択します。テンプレートを使用すると、標準設定が自動的に入力されます。
  </Step>

  <Step title="Google で Iru を承認する">
    画面の指示に従って Google Workspace 組織に対して Iru を承認します。求められたら Google の**特権管理者**アカウントでサインインし、標準のサインインスコープ (`openid`、`email`、`profile`) に同意します。組織が独自の OAuth クライアントを提供する場合は、Google Cloud コンソールで作成し、Iru がこの接続に表示するリダイレクト URI を追加して、そのクライアント ID とシークレットを Iru にコピーします。Google のコンソール画面は変更される可能性があるため、指示が異なる場合は Google の最新のドキュメントに従ってください。
  </Step>

  <Step title="接続の用途を選択する">
    接続の**ユースケース**として、**エンドユーザーのサインイン**、**デバイス登録**、またはその両方を選択します。ほとんどの構成ではエンドユーザーのサインインを有効にします。
  </Step>

  <Step title="ドメインを制限する">
    特定のメールドメインのユーザーのみにこの接続を使用させたい場合は、**ドメイン制限**を有効にしてそれらのドメインを追加します。
  </Step>

  <Step title="ユーザーマッチングを設定する">
    Iru が Google のサインインを Iru ユーザーと照合する方法 (UPN、ユーザー名、外部 ID、またはカスタム属性) を選択します。すべてのユーザーで一意かつ安定した値を選択してください。
  </Step>

  <Step title="接続を保存する">
    保存してから、許可されたドメインのメールアドレスを持つテストユーザーとしてサインインし、Google への引き渡しがエンドツーエンドで機能することを確認します。
  </Step>
</Steps>

<Tip>
  接続を広く展開する前に、1 人のユーザーでテストしてください。サインインが正しいユーザーに解決されない場合は、**ユーザーマッチング**の選択を見直してください。照合される値は、接続を使用するすべてのユーザーに存在し、一意である必要があります。
</Tip>

## 接続後のサインインの仕組み

ユーザーがサインインすると、Iru はサインインを Google に引き渡し、Google がユーザーを確認します。Iru はセッションを続行し、アクセスを許可する前にアプリの[認証ポリシー](/ja/identity/authentication/authentication-policies)を評価します。全体像については、[システムアーキテクチャ](/ja/identity/getting-started/system-architecture)を参照してください。

## 関連情報

<CardGroup cols={2}>
  <Card title="フェデレーション認証" icon="plug" href="/ja/identity/connections/connections-overview">
    ユースケース、ドメイン制限、ユーザーマッチングを 1 か所で説明します。
  </Card>

  <Card title="Microsoft Entra ID" icon="microsoft" href="/ja/identity/connections/microsoft-entra-id">
    専用のテンプレートを使用して、サインイン用に Microsoft Entra ID を接続します。
  </Card>

  <Card title="サインインエクスペリエンス" icon="arrow-right-to-bracket" href="/ja/identity/authentication/sign-in-experience">
    サインイン時にユーザーに表示される内容を設定します。
  </Card>

  <Card title="カスタム SAML" icon="shield-halved" href="/ja/identity/connections/custom-saml">
    テンプレートでカバーされていないプロバイダーを接続します。
  </Card>
</CardGroup>
