> ## 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 によるシングルサインオン (ネイティブ)

> OAuth2 と OpenID Connect を使用して、Iru Endpoint 用のネイティブ Google Workspace SSO を構成します。管理者が Google の資格情報でワンクリックサインインできるようにします。

### Google Workspace ネイティブ連携について

Iru Endpoint の Google Workspace ネイティブ連携を使用すると、SSO 用のネイティブ Google Workspace 連携を設定できます。ユーザーは、カスタム SAML 構成を必要とせずに Google Workspace の資格情報で認証します。

#### 仕組み

ユーザーが Iru Endpoint にアクセスしようとすると、OAuth2/OpenID Connect プロトコルを使用した認証のために Google Workspace にリダイレクトされます。認証が成功すると、Google Workspace はアクセストークンを Iru Endpoint に返送し、Iru Endpoint がユーザーの身元を検証してプラットフォームへのアクセスを許可します。

<Warning>
  iOS の登録で [Automated Device Enrollment での認証を要求](/ja/endpoint/enrollment/configure-require-authentication-for-enrollment)しており、IdP として Google Workspace を使用している場合は、シングルサインオンのエントリを [Custom SAML を使用して](/ja/endpoint/integrations/single-sign-on-integrations/single-sign-on-with-google-workspace-saml)作成する必要があります。組み込みの Google Workspace 連携はサポートされていません。
</Warning>

### 前提条件

開始する前に、次のものがあることを確認してください。

* Admin または Account Owner としての [Iru Endpoint Web App へのアクセス](/ja/endpoint/getting-started/foundation/admins-and-access)
* Google Workspace の構成手順を完了するための Google Workspace 特権管理者アカウント

<Tabs>
  <Tab title="Iru Web App の構成">
    ### Iru Endpoint 接続の構成

    Iru で接続を構成するには、次の手順に従います。

    <Steps>
      <Step title="アカウントメニューボタンに移動する">
        Iru Endpoint のサイドバーで、[**アカウントメニューボタン**](/ja/iru/platform-overview/account-menu) を選択します。
      </Step>

      <Step title="認証設定にアクセスする">
        メニューで **アクセス** オプションを選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-access.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=466fdf5fb47efd6bab8b450a5a1e8302" alt="Access オプションが強調表示されたアカウントメニューのスクリーンショット" width="562" height="1040" data-path="assets/media/images/iru-nav-access.png" />
        </Frame>
      </Step>

      <Step title="管理と認証を選択する">
        **管理と認証** タブ (デフォルトで選択されています) を選択し、**認証方法** までスクロールします。
      </Step>

      <Step title="認証方法を追加する">
        **+ 認証方法** を選択します。
      </Step>

      <Step title="表示名を入力する">
        SSO 接続の表示名を入力します。
      </Step>

      <Step title="Google Workspace を選択する">
        **Google Workspace** を選択します。
      </Step>

      <Step title="接続を作成する">
        **作成** を選択します。
      </Step>

      <Step title="Redirect URL をコピーする">
        後で使用するために、**Redirect URL** をテキストドキュメントにコピーします。これは Google Workspace の構成に必要です。

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-32-18.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=8e9eb7c658d0c596801cb59a4e78a609" alt="Google Workspace 用にコピーする Iru Endpoint SSO の Redirect URL" width="1318" height="520" data-path="assets/media/images/google-native_09-32-18.png" />
        </Frame>
      </Step>

      <Step title="タブを開いたままにする">
        Iru Web App の構成モーダルを開いたまま、[**Google Workspace の構成**](#google-workspace-configuration) タブに切り替えて、[**Google Workspace アプリケーションの設定**](#setting-up-google-workspace-application)に進みます。
      </Step>
    </Steps>

    <Note>
      [**Google Workspace の構成**](#google-workspace-configuration)を完了したら、ここに戻って Iru Endpoint での SSO 接続の設定を完了します。Google Workspace からコピーした Client ID と Client secret が必要です。
    </Note>

    ### Iru Endpoint 接続の完了

    構成を完了するには、次の手順に従います。

    <Steps>
      <Step title="Google Workspace ドメインを入力する">
        Google Workspace の **Google Workspace domain** を入力します。
      </Step>

      <Step title="Client ID を貼り付ける">
        Google Workspace からコピーした **Client ID** を **Client ID** フィールドに貼り付けます。
      </Step>

      <Step title="Client Secret を貼り付ける">
        Google Workspace からコピーした **Client secret** を **Client secret** フィールドに貼り付けます。

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_10-05-01.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=ce0bce036daf3da619b3c8aa25745d8c" alt="Google Workspace 用の Iru Endpoint の Client secret フィールド" width="2118" height="1646" data-path="assets/media/images/google-native_10-05-01.png" />
        </Frame>
      </Step>

      <Step title="構成を保存する">
        **保存** を選択します。
      </Step>

      <Step title="設定を確認する">
        これで接続が正常に構成され、有効化してテストできるようになりました。
      </Step>
    </Steps>

    ### テナント認証を許可する

    Iru Endpoint と IdP で OIDC 接続を構成したら、テナント認証での使用を許可できます。手順については、[シングルサインオンのサポート記事](/ja/endpoint/integrations/single-sign-on-integrations/single-sign-on)の **テナント認証の許可と接続の管理** セクションを参照してください。

    ### 認証をドメインに制限する

    OIDC 接続を構成する際に、必要に応じて認証を 1 つ以上のドメインに制限できます。これは、SSO 接続が複数のドメインに対して認証できる場合に便利です。Iru テナントへの認証を、利用可能なドメインの一部に制限できます。

    ### シングルサインオンの強制

    少なくとも 1 つのシングルサインオン接続を構成したら、Passkey、Google Social、Microsoft Social 接続を無効にできます。これらの接続を無効にすると、テナント内の Iru Endpoint 管理者はそれらの方法で認証できなくなります。手順については、[シングルサインオンのサポート記事](/ja/endpoint/integrations/single-sign-on-integrations/single-sign-on)を参照してください。
  </Tab>

  <Tab title="Google Workspace の構成">
    ### Google Workspace アプリケーションの設定

    <Note>
      Google Workspace の構成を開始する前に、[**Iru Web App の構成**](#iru-web-app-configuration) タブの [**Iru Endpoint 接続の構成**](#configuring-iru-endpoint-connection)で初期設定を完了し、Redirect URL を取得してください。この値は Google Workspace アプリケーションの構成に必要です。
    </Note>

    Google Workspace アプリケーションを構成するには、次の手順に従います。

    <Steps>
      <Step title="Google Cloud コンソールにアクセスする">
        [Google Cloud コンソール](https://console.cloud.google.com/)に**サインイン**します。
      </Step>

      <Step title="プロジェクトを作成する">
        **Create project** を選択します。

        **Create project** が利用できない場合は、画面左上のプロジェクトセレクターを選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-native-sso-create-project-or-project-selector.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=b7dd8b28183ead2f419e234ae8ed2f46" alt="Create project とプロジェクトセレクターが表示された Google Cloud の APIs & Services ページ" width="2300" height="886" data-path="assets/media/images/iru-google-native-sso-create-project-or-project-selector.png" />
        </Frame>
      </Step>

      <Step title="組織と新しいプロジェクトを選択する">
        **Create project** を選択した場合は、この手順をスキップします。**Create project** が利用できなかった場合は、プロジェクトセレクターで組織を選択し、**New project** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-native-sso-select-org-and-new-project.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=3d441441c38efc5d951512896772c464" alt="組織が選択され New project が表示された Google Cloud の Select a resource ダイアログ" width="1584" height="600" data-path="assets/media/images/iru-google-native-sso-select-org-and-new-project.png" />
        </Frame>
      </Step>

      <Step title="プロジェクトの詳細を構成する">
        **Project name** を入力します。
      </Step>

      <Step title="組織を選択する">
        ドロップダウンメニューから **組織** を選択します。
      </Step>

      <Step title="場所を選択する">
        **Location** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-30-58.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=54f4d8f6168d88108d525e7efa484cc8" alt="Google API Console のプロジェクトの Location ドロップダウン" width="2598" height="874" data-path="assets/media/images/google-native_08-30-58.png" />
        </Frame>
      </Step>

      <Step title="プロジェクトを作成する">
        **作成** を選択します。
      </Step>

      <Step title="認証情報にアクセスする">
        サイドバーで **Credentials** を選択します。
      </Step>

      <Step title="同意画面を構成する">
        クライアント ID を初めて作成する場合は、[同意画面の構成](https://support.google.com/googleapi/answer/6158849#zippy=%2Cuser-consent)を求められることもあります。

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-45-03.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=3370df7712a2cd9e0d3d11cd3425bf17" alt="Google の同意画面の構成プロンプト" width="2888" height="1204" data-path="assets/media/images/google-native_08-45-03.png" />
        </Frame>
      </Step>

      <Step title="認証情報を作成する">
        ウィンドウの右側上部付近で **+ Create credentials** を選択します。
      </Step>

      <Step title="OAuth Client ID を選択する">
        表示されるメニューから **OAuth Client ID** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-50-16.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=de24f6c68f2f98e2bad93052d10646c6" alt="Google の Create credentials の OAuth Client ID" width="2600" height="972" data-path="assets/media/images/google-native_08-50-16.png" />
        </Frame>
      </Step>

      <Step title="アプリケーションの種類を構成する">
        "**Application Type**" のメニューを選択し、"**Web application**" を選択します。
      </Step>

      <Step title="OAuth クライアントに名前を付ける">
        **名前** フィールドに、OAuth クライアントの **名前** を入力します。
      </Step>

      <Step title="承認済みの JavaScript 生成元を構成する">
        **Authorized JavaScript Origins** には、[**Iru Web App の構成**](#iru-web-app-configuration) タブからコピーした Redirect URL のドメイン部分のみを使用します (例: `https://vpriix.id.iru.com`)。このドメインは Iru テナントごとに固有です。
      </Step>

      <Step title="承認済みのリダイレクト URI を構成する">
        **Authorized redirect URIs** には、[**Iru Web App の構成**](#iru-web-app-configuration) タブからコピーした完全な Redirect URL を入力します (例: `https://vpriix.id.iru.com/federated-auth/oidc/callback`)。

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-26-03.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=c5f3ce845da4a0d0ace07f6ab0d2829b" alt="Authorized redirect URIs の構成を示す Google Workspace によるシングルサインオン (ネイティブ) のドキュメント" width="3090" height="2136" data-path="assets/media/images/google-native_09-26-03.png" />
        </Frame>
      </Step>

      <Step title="OAuth クライアントを作成する">
        **作成** を選択します。
      </Step>

      <Step title="Client ID をコピーする">
        **Client ID** フィールドのテキストをコピーし、後で使用するために保存します。
      </Step>

      <Step title="Client Secret をコピーする">
        **Client Secret** フィールドのテキストをコピーし、後で使用するために保存します。

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-27-24.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=dc6b3de9f1f68cacf3d4c0f3a4757584" alt="Google OAuth の Client ID と Client Secret フィールド" width="1112" height="1314" data-path="assets/media/images/google-native_09-27-24.png" />
        </Frame>
      </Step>

      <Step title="OK を選択する">
        **OK** を選択します。
      </Step>
    </Steps>

    <Note>
      Google Workspace の構成を完了したら、[**Iru Web App の構成**](#iru-web-app-configuration) タブに戻り、[**Iru Endpoint 接続の完了**](#completing-the-iru-endpoint-connection)に進んで、Google Workspace からコピーした Client ID と Client secret を使用して SSO 接続の設定を完了します。
    </Note>
  </Tab>
</Tabs>