Microsoft Entra IDをIdPとして使う場合のSSO（シングルサインオン）設定手順を説明します。
💡 ご確認ください
・SSO全体の流れとPeopleX AI共通管理側の設定については、会社のSSO（シングルサインオン）を設定するをご確認ください。
・Microsoft Entra ID側の詳しい操作方法は、Microsoft Entra IDヘルプページをご確認ください。
前提条件
必要な権限: 管理者
Microsoft Entra IDの管理者アカウント
SAMLアプリケーションを作成する
Microsoft Entra管理センターで「エンタープライズ アプリケーション」を開きます
「新しいアプリケーション」から「独自のアプリケーションの作成」をクリックします
アプリ名を入力し、「ギャラリーに見つからないその他のアプリケーションを統合します(ギャラリー以外)」を選択して「作成」をクリックします
基本的なSAML構成を設定する
作成したアプリケーションに、PeopleX AI共通管理をSP（サービスプロバイダー）として登録します。
「シングル サインオン」から「SAML」を選択します
「基本的なSAML構成」の「編集」をクリックします
「識別子(エンティティID)」に
https://<subdomain>.account.peoplex.jp/spを入力します「応答URL(Assertion Consumer Service URL)」に
https://<subdomain>.account.peoplex.jp/api/sso/saml/acsを入力します「保存」をクリックします
<subdomain> は自社のサブドメインに置き換えてください。サブドメインは、ログイン画面のURL https://<subdomain>.account.peoplex.jp で確認できます。
属性とクレームを設定する
PeopleX AI共通管理は、Microsoft Entra IDから連携されたメールアドレスで従業員を識別します。
1. 「属性とクレーム」の「編集」をクリックします。
2. 「一意のユーザー識別子(名前ID)」をクリックし、「名前識別子の形式」に「永続的」、「ソース属性」に「user.mail」を選択して「保存」をクリックします。
3. 「追加の要求」の「emailaddress」のクレームをクリックし、「名前」を email に変更し、「名前空間」を空欄にして「保存」をクリックします。
⚠️ クレームの設定は必須です
クレームの名前が email 以外の場合、または名前空間が設定されている場合は、Microsoft Entra IDでの認証は成功しますが、PeopleX AI共通管理に戻ったところでログインに失敗します。
ユーザーをアプリに割り当てる
「ユーザーとグループ」から「ユーザーまたはグループの追加」をクリックし、SSOを利用するユーザーを選択します
割り当てたユーザーのプロパティに、メールアドレスが設定されていることを確認します
⚠️ ご注意ください
・メールアドレスが設定されていないユーザーは、SSOでログインできません。
・SSOでは従業員は自動で作成されません。PeopleX AI共通管理に従業員として登録されていないユーザーは、Microsoft Entra ID側で割り当ててもログインできません。
IdPの情報を取得する
PeopleX AI共通管理に登録する以下の3つを取得します。
「SAML証明書」の「証明書(Base64)」から「ダウンロード」をクリックし、X.509証明書をダウンロードします
「(アプリ名)のセット アップ」から「Microsoft Entra識別子」と「ログインURL」をコピーします
取得した値は、PeopleX AI共通管理の以下の入力欄に対応します。
Microsoft Entra識別子 → Entity ID
ログインURL → SSO(シングルサインオン)URL
X.509証明書 → X.509証明書(PEM形式)
PeopleX AI共通管理に登録する
取得したMicrosoft Entra識別子・ログインURL・X.509証明書を、PeopleX AI共通管理の「設定 > セキュリティ > SSO」から登録します。手順は会社のSSO（シングルサインオン）を設定するを参照してください。
よくある質問
Q. Microsoft Entra IDの認証は通るのに、戻ってきたあとでログインに失敗します
A. 以下を確認してください。
「追加の要求」のクレームの名前が
emailで、名前空間が空欄になっているか「名前識別子の形式」が「永続的」になっているか
ログインしたアカウントのメールアドレスで、PeopleX AI共通管理に従業員が登録され、ログインできる状態か
登録したEntity ID・SSO(シングルサインオン)URL・X.509証明書が、Microsoft Entra IDの値と一致しているか
Q. サインイン時に、アプリケーションに割り当てられていないというエラーが表示されます
A. Microsoft Entra ID側で、対象のユーザーにアプリケーションが割り当てられていません。「ユーザーとグループ」から対象のユーザーを追加してください。
Q. サインイン時に、要求されたURLがアプリケーションの設定と一致しないというエラーが表示されます
A. 「基本的なSAML構成」の値を確認してください。
「識別子(エンティティID)」が
https://<subdomain>.account.peoplex.jp/spと完全に一致しているか（末尾の /sp の抜けや、サブドメインの誤りにご注意ください）「応答URL(Assertion Consumer Service URL)」が
https://<subdomain>.account.peoplex.jp/api/sso/saml/acsと完全に一致しているか
Q. 社員番号でログインする従業員もSSOを利用できますか？
A. 利用できません。社員番号でログインする従業員はSSOの対象外です。これまでどおり社員番号とパスワードでログインします。