HENNGE OneでSSOを設定する
HENNGE Oneを会社のIdP(IDプロバイダー)にして、従業員がHENNGE OneのアカウントでPeopleX AI共通管理にログインできるようにする、HENNGE One側の設定の手順です。
更新日
管理者向けの記事です。HENNGE One(Access Control)の管理者のアカウントが必要です。共通管理での操作には、共通管理の「管理者」の権限が必要です。
HENNGE Oneの画面の詳しい操作は、HENNGE Oneのヘルプ「SAML 接続時の HENNGE One 側設定方法(カスタムでの登録の場合)(新しいタブで開きます)」を確認してください。HENNGE Oneの画面の表記は、予告なく変わることがあります。
設定の流れ
- HENNGE Oneに、共通管理をサービスプロバイダーとして追加する(この記事)
- 共通管理にIdP連携を追加する
- 連携を開始する
- ポリシーで「SSOを使用する」をオンにする(セキュリティポリシーの機能がある企業だけ)
- ログインを確認する
- テストモードを終了する
2〜6の手順は、SSO(シングルサインオン)を設定するにあります。SSOの対象になる従業員や、うまくいかないときにパスワードでのログインに戻す方法も、その記事で確認してください。
サービスプロバイダーを追加する
<subdomain> は自社のサブドメインに置き換えてください。サブドメインは、自社のログイン画面のURL(https://<subdomain>.account.peoplex.jp)で確認できます。
属性の名前は、半角小文字の email にしてください。「Email」のように大文字を含む名前では、HENNGE Oneでの認証は通っても、共通管理に戻ったところでログインに失敗します。
- HENNGE One(Access Control)の管理画面で、「システム」>「サービスプロバイダー設定」を開きます。
- 「+サービスの追加」をクリックし、表示された画面で「サービスの追加」をクリックします。
- 「新しいサービスのSSO設定」の「SAML手動設定」をクリックします。
- 次の値を入力します。
- サービス名:任意の名前(例: PeopleX AI共通管理)
- ACS URL:
https://<subdomain>.account.peoplex.jp/api/sso/saml/acs - SP Issuer(Audience):
https://<subdomain>.account.peoplex.jp/sp - Name ID:Email(共通管理に登録したメールアドレスと同じ値になる項目)
- Name IDフォーマット:persistent
- 「属性の設定」の「属性の追加」をクリックし、「属性」に
email、「値」に共通管理に登録したメールアドレスと同じ値になる項目(Email など)を設定して、「保存」をクリックします。
サービスの利用を許可する
追加したサービスを許可していないアクセスポリシーグループのユーザーは、SSOを使えません。
- 「アクセス設定」>「アクセスポリシーグループ」で、SSOを使うユーザーが所属するアクセスポリシーグループを開きます。
- 「許可するサービスプロバイダー」で、追加したサービスの「許可」のスイッチをオンにし、画面右下の「保存」か「変更する」をクリックします。
共通管理に登録する
サービスプロバイダーを保存すると、HENNGE Oneの値が表示されます。次の値を、共通管理のIdP連携の欄に入力します。
| HENNGE Oneの値 | 共通管理の入力欄 |
|---|---|
| IdP Issuer | Entity ID |
| シングルサインオンURL | SSO(シングルサインオン)URL |
| SAML署名証明書 | X.509証明書(PEM形式) |
SAML署名証明書は、表示された値をコピーするか、ダウンロードしたファイルをテキストエディタで開いて、「-----BEGIN CERTIFICATE-----」から「-----END CERTIFICATE-----」までを貼り付けます。
「ドメイン」には、SSOでログインする従業員のメールアドレスのドメインを入力します。IdP連携の追加からテストモードの終了までは、共通管理の管理者がSSO(シングルサインオン)を設定するの手順で行います。
よくある質問
Q. HENNGE Oneのポータル画面からログインできません
A. HENNGE Oneのポータル画面から始めたログインには対応していません。共通管理のログイン画面(https://<subdomain>.account.peoplex.jp)から、ログインしてください。ポータル画面から始めると、ログイン画面に「自動的にログインできませんでした」と表示されます。その画面でメールアドレスを入力し、「SSOでログイン」をクリックすると、ログインできます。
Q. HENNGE Oneの認証は通るのに、共通管理に戻ったところでログインに失敗します
A. 次を確認してください。
- 追加した属性の名前が、半角小文字の
emailになっているか - 「Name IDフォーマット」が「persistent」になっているか
- ログインしたアカウントと同じメールアドレスで、共通管理に従業員が登録され、アカウントを作成済みか
- 共通管理に登録した「Entity ID」「SSO(シングルサインオン)URL」「X.509証明書(PEM形式)」が、HENNGE Oneの値と同じか
- 「SP Issuer(Audience)」が
https://<subdomain>.account.peoplex.jp/spと完全に一致しているか
ほかの原因と対処は、従業員がSSOでログインできないときを確認してください。
