Google WorkspaceのSSO（シングルサインオン）設定手順を説明します。
💡ご確認ください
・SSO全体の流れについては、会社のSSO（シングルサインオン）を設定するをご確認ください。
・詳細な設定方法については、Google Workspaceヘルプページをご確認ください。
・設定には、Google Workspaceの特権管理者の権限が必要です。
・本記事の画像は作成時点の画面です。Google Workspaceの画面は更新されることがあるため、実際の画面と表示が異なる場合があります。
⚠️ご注意ください
設定に誤りがあると、SSOでログインできなくなり、PeopleX AI面接を利用できなくなるおそれがあります。PeopleX AI面接の設定画面はログインしたまま閉じずに残しておき、SSOでのログインの確認は必ずブラウザのシークレットウィンドウで行ってください。手順は「ログインを確認する」をご確認ください。
アプリを作成する
1. Google管理コンソール（https://admin.google.com）で、［アプリ］>［ウェブアプリとモバイルアプリ］を開きます。
2. ［アプリを追加］>［カスタムSAMLアプリを追加］を押します。
3. ［アプリの詳細］で［アプリ名］に任意の名前（例：PeopleX AI面接）を入力し、［続行］を押します。
4. ［Google Identityプロバイダの詳細］で、オプション2の［SSOのURL］［エンティティID］［証明書］を控えて、［続行］を押します。控えた値は、後の手順でPeopleX AI面接に登録します。
SAMLを設定する
PeopleX AI面接は、初回ログイン時にGoogle Workspaceから連携されたメールアドレスでメンバーを識別します。
1. ［サービスプロバイダの詳細］で、以下の項目を入力し、［続行］を押します。
・ACSのURL
以下の {subdomain} を会社アカウントのものに置き換えてください。
https://{subdomain}.company.ai-interview.peoplex.jp/api/company/sso/saml/acs
・エンティティID
以下の {subdomain} を会社アカウントのものに置き換えてください。
https://{subdomain}.company.ai-interview.peoplex.jp/sp
・名前IDの形式：PERSISTENT
・名前ID：Basic Information > Primary email
2. ［属性のマッピング］で［マッピングを追加］を押し、以下を設定して［完了］を押します。
・Google Directoryの属性：Primary email
・アプリの属性：email
⚠️ご注意ください
・属性名は、すべて半角小文字の「email」にしてください。「Email」「E-mail」「emailaddress」のような表記では、PeopleX AI面接がメールアドレスを読み取れず、ログインできません。
・SSOではメンバーは自動で作成されません。PeopleX AI面接にメンバーとして追加（招待）されていないユーザーは、ログインできません。
ユーザーアクセスをオンにする
1. 作成したアプリの画面で［ユーザーアクセス］を開きます。
2. ［オン（すべてのユーザー）］を選択して［保存］を押します。一部の組織部門だけで利用する場合は、左側で組織部門を選択して［オン］にします。
💡ポイント
設定が反映されるまでに、最長で24時間ほどかかることがあります。
IdPメタデータを取得する
PeopleX AI面接に登録する以下の項目を取得します。アプリ作成時に［Google Identityプロバイダの詳細］で控えた値を使います。
IdPのEntityID
SSO URL
X.509証明書
あとから確認する場合は、作成したアプリの画面で［メタデータをダウンロード］を押すと、［SSOのURL］［エンティティID］［証明書］が表示されます。［証明書］は、右側のコピーボタンを押して取得します。
PeopleX AI面接にIdP連携設定を追加する
IdP連携設定を追加して［決定］を押した時点で連携が始まり、ログイン画面はSSOでのログインのみになります。設定に誤りがあっても元に戻せるよう、操作している画面はログインしたまま閉じずに残しておいてください。
1. ［設定］>［システム設定］>［セキュリティ設定］を開きます。IdP連携設定がまだない場合は、［SSOを有効化］を押します。
2. ［IdP連携設定の追加］を押し、以下の項目を入力して［決定］を押します。
・IdP：設定を識別するための任意の名前（例：Google Workspace）
・Entity ID：Google Workspaceから取得したIdPのEntityID
・SSO (シングルサインオン) URL：Google Workspaceから取得したSSO URL
・X.509 証明書 (PEM形式)：Google Workspaceから取得したX.509証明書。「-----BEGIN CERTIFICATE-----」から「-----END CERTIFICATE-----」までのテキストを貼り付けます
・ドメイン：SSOでログインするメンバーのメールアドレスのドメイン（例：example.com）
⚠️ご注意ください
・ドメインと一致しないメールアドレスのメンバーは、ログインできなくなります。ご利用になるすべてのメールアドレスのドメインを登録してください。
・2要素認証を利用している場合は、SSOを有効化できません。先に2要素認証を無効にしてください。
ログインを確認する
1. ブラウザのシークレットウィンドウ（Edgeの場合はInPrivateウィンドウ）を開きます。
2. シークレットウィンドウで以下のログイン画面を開き、メールアドレスを入力して［ログイン］ボタンを押します。
https://{subdomain}.company.ai-interview.peoplex.jp/noauth/sign-in
3. Google Workspaceの認証画面に移るので、認証を済ませます。認証が終わると、PeopleX AI面接の画面に戻ります。
⚠️ご注意ください
・ログインできなかった場合は、残しておいた画面の［セキュリティ設定］で、IdP連携設定の［︙］ボタンから［連携停止］を選択し、［内容を確認しました］にチェックを入れて［停止］を押してください。パスワードでのログインに戻ります。
・Googleのアプリランチャーのアイコンからのログインには対応していません。SSOでのログインは、必ずPeopleX AI面接のログイン画面から始めてください。