Google WorkspaceでSSOを設定する

Google Workspaceを会社のIdP(IDプロバイダー)にして、従業員がGoogleのアカウントでPeopleX AI共通管理にログインできるようにする、Google Workspace側の設定の手順です。

更新日

補足

管理者向けの記事です。Google Workspaceの管理者のアカウントが必要です。共通管理での操作には、共通管理の「管理者」の権限が必要です。

Google Workspaceの画面の詳しい操作は、Googleのヘルプ「カスタム SAML アプリを設定する(新しいタブで開きます)」を確認してください。Google Workspaceの画面の表記は、予告なく変わることがあります。

設定の流れ

  1. Google Workspaceに、共通管理をカスタム SAML アプリとして追加する(この記事)
  2. 共通管理にIdP連携を追加する
  3. 連携を開始する
  4. ポリシーで「SSOを使用する」をオンにする(セキュリティポリシーの機能がある企業だけ)
  5. ログインを確認する
  6. テストモードを終了する

2〜6の手順は、SSO(シングルサインオン)を設定するにあります。SSOの対象になる従業員や、うまくいかないときにパスワードでのログインに戻す方法も、その記事で確認してください。

カスタム SAML アプリを追加する

<subdomain> は自社のサブドメインに置き換えてください。サブドメインは、自社のログイン画面のURL(https://<subdomain>.account.peoplex.jp)で確認できます。

重要

「属性のマッピング」で、アプリの属性 email に従業員のメールアドレスを送る設定が必要です。設定しないと、Googleでの認証は通っても、共通管理に戻ったところでログインに失敗します。

  1. Google 管理コンソールで「アプリ」>「ウェブアプリとモバイルアプリ」を開き、「アプリを追加」>「カスタム SAML アプリを追加」をクリックします。
  2. アプリ名(例: PeopleX AI共通管理)を入力し、「続行」をクリックします。
  3. 「Google ID プロバイダの詳細」に表示される「SSO の URL」「エンティティ ID」「証明書」を控えて、「続行」をクリックします。
  4. 「サービス プロバイダの詳細」に次の値を入力し、「続行」をクリックします。
    • ACS の URL:https://<subdomain>.account.peoplex.jp/api/sso/saml/acs
    • エンティティ ID:https://<subdomain>.account.peoplex.jp/sp
    • 名前 ID の形式:PERSISTENT
    • 名前 ID:Basic Information > Primary email
  5. 「属性のマッピング」で「マッピングを追加」をクリックし、Google Directory の属性「Basic Information > Primary email」に、アプリの属性 email を設定して、「完了」をクリックします。

アプリをユーザーに公開する

アプリを追加しただけでは、従業員はSSOを使えません。

  1. 追加したアプリの詳細の画面で、「ユーザー アクセス」を開きます。
  2. SSOを使う組織部門を選び、サービスのステータスを「オン」にして、「保存」をクリックします。

共通管理に登録する

控えた値を、共通管理のIdP連携の次の欄に入力します。

Google Workspaceの値共通管理の入力欄
「Google ID プロバイダの詳細」のエンティティ IDEntity ID
SSO の URLSSO(シングルサインオン)URL
証明書X.509証明書(PEM形式)

「ドメイン」には、SSOでログインする従業員のメールアドレスのドメインを入力します。IdP連携の追加からテストモードの終了までは、共通管理の管理者がSSO(シングルサインオン)を設定するの手順で行います。

よくある質問

Q. 「app_not_configured_for_user」と表示されます

A. Googleで、アプリがそのユーザーに公開されていないか、エンティティ IDが一致していません。次を確認してください。

  • アプリの「ユーザー アクセス」が、そのユーザーの組織部門で「オン」になっているか
  • 「サービス プロバイダの詳細」のエンティティ IDが https://<subdomain>.account.peoplex.jp/sp と完全に一致しているか。末尾の /sp の抜けや、サブドメインの誤りがないか
  • ブラウザで、別のGoogleアカウントにログインしていないか

Q. Googleの認証は通るのに、共通管理に戻ったところでログインに失敗します

A. 次を確認してください。

  • 「属性のマッピング」で、アプリの属性が email になっているか
  • 「名前 ID の形式」が PERSISTENT になっているか
  • ログインしたGoogleアカウントと同じメールアドレスで、共通管理に従業員が登録され、アカウントを作成済みか

ほかの原因と対処は、従業員がSSOでログインできないときを確認してください。

Q. Googleのアプリ ランチャーや「SAML ログインをテスト」からログインできません

A. Google Workspace側から始めたログインには対応していません。共通管理のログイン画面(https://<subdomain>.account.peoplex.jp)から、ログインしてください。Google Workspace側から始めると、ログイン画面に「自動的にログインできませんでした」と表示されます。その画面でメールアドレスを入力し、「SSOでログイン」をクリックすると、ログインできます。