Google WorkspaceでSSOを設定する
Google Workspaceを会社のIdP(IDプロバイダー)にして、従業員がGoogleのアカウントでPeopleX AI共通管理にログインできるようにする、Google Workspace側の設定の手順です。
更新日
管理者向けの記事です。Google Workspaceの管理者のアカウントが必要です。共通管理での操作には、共通管理の「管理者」の権限が必要です。
Google Workspaceの画面の詳しい操作は、Googleのヘルプ「カスタム SAML アプリを設定する(新しいタブで開きます)」を確認してください。Google Workspaceの画面の表記は、予告なく変わることがあります。
設定の流れ
- Google Workspaceに、共通管理をカスタム SAML アプリとして追加する(この記事)
- 共通管理にIdP連携を追加する
- 連携を開始する
- ポリシーで「SSOを使用する」をオンにする(セキュリティポリシーの機能がある企業だけ)
- ログインを確認する
- テストモードを終了する
2〜6の手順は、SSO(シングルサインオン)を設定するにあります。SSOの対象になる従業員や、うまくいかないときにパスワードでのログインに戻す方法も、その記事で確認してください。
カスタム SAML アプリを追加する
<subdomain> は自社のサブドメインに置き換えてください。サブドメインは、自社のログイン画面のURL(https://<subdomain>.account.peoplex.jp)で確認できます。
「属性のマッピング」で、アプリの属性 email に従業員のメールアドレスを送る設定が必要です。設定しないと、Googleでの認証は通っても、共通管理に戻ったところでログインに失敗します。
- Google 管理コンソールで「アプリ」>「ウェブアプリとモバイルアプリ」を開き、「アプリを追加」>「カスタム SAML アプリを追加」をクリックします。
- アプリ名(例: PeopleX AI共通管理)を入力し、「続行」をクリックします。
- 「Google ID プロバイダの詳細」に表示される「SSO の URL」「エンティティ ID」「証明書」を控えて、「続行」をクリックします。
- 「サービス プロバイダの詳細」に次の値を入力し、「続行」をクリックします。
- 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
- ACS の URL:
- 「属性のマッピング」で「マッピングを追加」をクリックし、Google Directory の属性「Basic Information > Primary email」に、アプリの属性
emailを設定して、「完了」をクリックします。
アプリをユーザーに公開する
アプリを追加しただけでは、従業員はSSOを使えません。
- 追加したアプリの詳細の画面で、「ユーザー アクセス」を開きます。
- SSOを使う組織部門を選び、サービスのステータスを「オン」にして、「保存」をクリックします。
共通管理に登録する
控えた値を、共通管理のIdP連携の次の欄に入力します。
| Google Workspaceの値 | 共通管理の入力欄 |
|---|---|
| 「Google ID プロバイダの詳細」のエンティティ ID | Entity ID |
| SSO の URL | SSO(シングルサインオン)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でログイン」をクリックすると、ログインできます。
