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の画面の表記は、予告なく変わることがあります。

設定の流れ

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

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

サービスプロバイダーを追加する

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

重要

属性の名前は、半角小文字の email にしてください。「Email」のように大文字を含む名前では、HENNGE Oneでの認証は通っても、共通管理に戻ったところでログインに失敗します。

  1. HENNGE One(Access Control)の管理画面で、「システム」>「サービスプロバイダー設定」を開きます。
  2. 「+サービスの追加」をクリックし、表示された画面で「サービスの追加」をクリックします。
  3. 「新しいサービスのSSO設定」の「SAML手動設定」をクリックします。
  4. 次の値を入力します。
    • サービス名:任意の名前(例: 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
  5. 「属性の設定」の「属性の追加」をクリックし、「属性」に email、「値」に共通管理に登録したメールアドレスと同じ値になる項目(Email など)を設定して、「保存」をクリックします。

サービスの利用を許可する

追加したサービスを許可していないアクセスポリシーグループのユーザーは、SSOを使えません。

  1. 「アクセス設定」>「アクセスポリシーグループ」で、SSOを使うユーザーが所属するアクセスポリシーグループを開きます。
  2. 「許可するサービスプロバイダー」で、追加したサービスの「許可」のスイッチをオンにし、画面右下の「保存」か「変更する」をクリックします。

共通管理に登録する

サービスプロバイダーを保存すると、HENNGE Oneの値が表示されます。次の値を、共通管理のIdP連携の欄に入力します。

HENNGE Oneの値共通管理の入力欄
IdP IssuerEntity ID
シングルサインオンURLSSO(シングルサインオン)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でログインできないときを確認してください。