SAMLを使用したPingOneによるLiferay認証の設定
このチュートリアルでは、セキュリティ アサーション マークアップ言語 (SAML) を使用して、アイデンティティ プロバイダー (IdP) である PingOne を Liferay 環境に統合するために必要な基本的な手順について説明します。
前提条件
- PingOne環境
- Liferay DXP環境
- PingOne環境への管理者アクセス権を持つユーザー
- Liferayのコントロールパネルへの管理者権限を持つユーザー
PingOneの設定
-
PingOne 環境にサインインします。
-
「アプリケーション」→「アプリケーション」に移動し、クリックして新しいアプリケーションを追加します。

-
アプリケーション名を入力し、アプリケーションの種類を選択します。
-
アプリケーション名: Liferay DXP - SAML
-
説明: (オプション) 説明を入力してください
-
アイコン: (オプション) アイコンをアップロードします
-
アプリケーションの種類: SAML アプリケーション

-
-
構成をクリックします。
-
SAML 構成セクションで、アプリケーションのメタデータを入力します。
-
アプリケーションメタデータの提供:
を選択、を手動で入力 -
ACS URL:
https://[your_instance_url]/c/portal/saml/acs -
エンティティID:
samlsp

-
-
[保存]をクリックします。
-
構成 タブに移動し、編集アイコンをクリックします。
-
署名証明書: 使用ケースに応じて、
署名レスポンスまたは署名アサーション & レスポンスのいずれかを選択します。 これらの選択肢の詳細については、PingOne の 署名ポリシーの定義 (SAML) を参照してください。 -
署名アルゴリズム:
RSA_SHA256 -
暗号化: チェックを外す。
注暗号化の使用をお勧めしますが、このチュートリアルではこれをチェックしないままにしておきます。 暗号化を有効にするには、インフラストラクチャで追加の構成が必要になる場合があります。
-
SLOエンドポイント:
https://[your_instance_url]/c/portal/saml/slo -
SLOバインディング:
HTTP POST -
アサーションの有効期間(秒):
3000
-
-
[保存]をクリックします。
-
「属性マッピング」タブに移動し、次の属性を追加します。
属性 PingOneマッピング saml_subject メールアドレス 電子メールアドレス メールアドレス ファーストネーム 名 苗字 苗字 ハンドルネーム ユーザーID -
[保存]をクリックします。
注「ディレクトリ」→「ユーザー」に移動してユーザーを作成します。
-
構成 タブに移動し、メタデータ .xml ファイルをダウンロードします。 Liferay DXPの設定時に使用します。
-
右上のトグルスイッチからこのアプリケーションへのアクセスを有効にします。

Liferay DXPの設定
-
Liferay DXPインスタンスで、 コントロールパネル → セキュリティ → SAML管理に移動します。
-
SAML ロールを サービス プロバイダーに設定し、エンティティ ID を samlspに設定します。 [保存]をクリックします。
-
証明書と秘密キーのセクションの下にある 証明書の作成 をクリックします。 証明書をインポートまたは作成します。

-
サービスプロバイダー タブに移動します。
-
Authnリクエストに署名しますか? - 有効にする
-
メタデータに署名しますか? - 有効にする
-
SSLが必要 - 有効
-
ログインポートレットの表示を許可する。 - 有効にする
-
PingOne を
アサーション署名 & レスポンスに設定している場合は、「アサーション署名が必要ですか?」を有効にします。
-
-
[保存]をクリックします。
-
アイデンティティプロバイダ接続 タブをクリックします。 [アイデンティティプロバイダーの追加] をクリックし、以下を設定します。
-
名前: PingOne
-
エンティティIDを入力します(前のセクションでダウンロードしたxmlファイルでは
エンティティIDとして見つかります) -
有効 ボックスをチェックします
-
メタデータ セクションで、IdP のメタデータ URL を入力します。 これは、PingOne 環境の [構成] タブにあります。
-
名前識別子形式 を メールアドレスに設定します
-
基本ユーザー フィールドに次の属性マッピングを入力します。
ユーザーフィールド表現 SAML 属性 電子メールアドレス 電子メールアドレス ファーストネーム ファーストネーム 苗字 苗字 ハンドルネーム ハンドルネーム -
「保存」をクリックします。

-
-
[全般] タブに戻り、
[有効]チェックボックスがオンになっていることを確認します。 [保存]をクリックします。
入力値の検証
-
Liferay インスタンスに移動し、新しいブラウザを開くか、アカウントからサインアウトします。
-
サインイン ボタンをクリックすると、PingOne のログイン ページにリダイレクトされます。

-
ユーザーのユーザー名とパスワードを入力します。 ログインに成功しました。
-
Liferay 管理者アカウントで再度サインインします。 コントロールパネル → ユーザーと組織に移動し、アカウントがLiferayに登録されていることを確認します。

さいごに
ユーザーは、PingOne を使用して環境に認証できるようになりました。
ヒントとトラブルシューティング
無効なACS_URL
ErrorCode: INVALID_ACS_URLが発生した場合は、PingOne で ACS URL が適切なパスとハイパーテキスト転送プロトコル (HTTP または HTTPS) を使用して正しく構成されていることを確認してください。 これらは、作成したアプリケーションに移動 → [構成] タブ → [編集] アイコンすると、PingOne アカウントで見つけることができます。
