OpenID Connectを使用する
OpenID Connectは、ユーザーが他のシステムにあるアカウントを使用して認証できるようにする軽量の認証レイヤーです。これはOAuth 2.0認証プロトコルに基づいて構築されています。 OpenID Connectを使用することで、ユーザー認証を他のプロバイダーに委任できるため、既存のアカウントを持つユーザーはLiferayインストール環境への認証を容易に行うことができます。
インストール環境に複数のプロバイダーを追加することは可能ですが、Liferay DXPはOpenID Connectプロバイダー(OP)にはなれません。
OpenID ConnectのトークンフローはOAuth 2.0の機能の上に構築されているため、OAuth 2.0に似ています。 OAuth 2.0は認証プロトコルに過ぎないため、特定のAPIへのアクセスを許可するアクセストークンを送信します。 OpenID Connectは、ユーザーが認証され、権限を付与されている場合に限り、名前やメールアドレスなどのユーザー情報を渡すIDトークンをこれに追加します。
技術規格および仕様
Liferayは、OpenID Foundationが管理する公開仕様に基づいてOpenID Connectを実装しています。 OpenID ConnectはOAuth 2.0の上に認証レイヤーを追加するため、Liferayは外部のOpenID Connectプロバイダーを使用する際に、依拠当事者(RP)として機能できます。
Liferayは、ベンダー固有の機能よりも標準化された動作を優先します。このアプローチにより、同じ仕様に従うプロバイダー間での相互運用性が確保されます。ベンダー拡張機能は引き続き動作しますが、オプションとして扱われ、Liferayのコア実装の一部ではありません。
以下の表では、「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、「OPTIONAL」というキーワードは、 RFC 2119に記載されているとおりに解釈されるものとします。
- 「MUST」とマークされた部分は、Liferayが仕様の必須要件に準拠していることを示します。
- SHOULDおよびMAY (および関連する用語)で示された部分は、Liferayの裁量により、既に実装されている場合もあれば、リクエストに応じて実装される場合もあります。
| 仕様 | 説明 | Liferay DXPに実装されています | リンク |
|---|---|---|---|
| OpenID Connect Core 1.0 | 依拠当事者に対する認証、IDトークン、クレーム、および標準フローを定義します。 | RPの必須要件はすべて実装され、サポートされています。 | 仕様 |
| OpenID Connect バックチャネルログアウト 1.0 | RPセッション終了のためのサーバー間メカニズムを定義します。これは、LiferayのOpenID Connect向けシングルログアウト(SLO)メカニズムです。 | Liferay DXP 2026.Q1以降でサポートされているオプション仕様です。シングルログアウト(SLO)を参照してください。 | 仕様 |
OAuth 2.0 に関連するその他の仕様 (OAuth 2.0 認可フレームワーク、PKCE、JWT ベアラー グラント、アクセス トークン用の JWT プロファイルなど) は、OAuth 2.0 - 技術標準および仕様に記載されています。
OpenID Connectプロバイダーでクライアントを作成する
OpenID Connectを使用するには、まずプロバイダにクライアントとして登録する必要があります。これはOAuth 2.0クライアントです。手続きはプロバイダーによって異なります。
-
プロバイダーのWebサイトに移動し、クライアントを作成します。
-
作成プロセス中に、プロバイダーから送信されるトークンを処理できる、承認済みのリダイレクトURLを指定する必要があります。 Liferay DXPのURLは次のとおりです。
https://[server.domain]/c/portal/login/openidconnect -
プロバイダーはいくつかの情報を送信します。検出エンドポイント、承認エンドポイント、発行者URLなど、これらのいくつかはクライアントに関係なく同じです。リクエストに固有の2つの情報は、
client_idとclient_secretです。
提供元から情報を収集してください。プロバイダー接続を作成するために必要です。
OpenID Connectプロバイダー接続の設定
Liferayは、プロバイダ接続用の新しいインターフェースに関するフィードバックを求めています。そのため、接続を確立する方法は、標準的な方法と新しい方法の2つがあります。
新しいプロバイダーの開発が進むにつれて、スムーズな移行を実現するために、Liferayは2つのインターフェース間でOpenID Connectの設定を変換および同期します。
OAuth 2.0向けの新しいOpenID Connectプロバイダー接続**
このインターフェースは、クライアント接続をきめ細かく制御したいユーザー向けです。すべての設定は、 OpenID Connect 設定仕様で定義されているプロバイダーの Well-Known Configuration Endpoint を介して行われます。
-
グローバルメニュー(
)→コントロールパネル→セキュリティ→ OAuthクライアント管理を開きます。 -
2つのタブがあります。 1つ目は、認証サーバーのクライアントを作成します。 2つ目は、Well Known URIを持たない認証サーバー用です。常に最初のタブを使用してください。2番目のタブは、既知のURIを持たないサーバーに対して「擬似的な」既知のURIを作成する場合にのみ使用してください。
よく知られたURIがない場合は、
-
2番目のタブに移動して、 「新規」をクリックします。
-
プロバイダーからの認証サーバーのメタデータを入力します。 JSONの
issuerフィールドに値があることを確認してください。これにより、[保存]をクリックすると、「ローカル」なwell-known URIが生成されます。 -
「保存」をクリックしてください。 OAuth クライアント管理ページに戻り、生成されたURIを確認することができます。このURIをクリップボードにコピーしてください。次のステップでこのURIを使用します。
よく知られたURIをお持ちの場合は、
-
最初のタブで「新規」をクリックします。
-
認証サーバーのWell Known URIをWell Known URIフィールドに貼り付けます。例えば、Google の場合は
https://accounts.google.com/.well-known/openid-configurationです。上記のように生成した場合は、ここに貼り付けます。 -
ほとんどの場合、これだけで十分です。 Well Known URIをお持ちでない場合は、以下のフィールドを使用して接続を設定します。完了したら、 「保存」をクリックしてください。
フォーム上のその他のフィールドは、プロバイダーによって生成される特定の構成情報用です。
メタデータキャッシュ時間:既知のURIからの情報がキャッシュされる間隔(秒単位)を指定します。 0を入力すると、デフォルト値として600秒(Ehcacheで使用される値)が適用されます。
OAuthクライアント情報: RFC-7591 JSON 形式に従ったクライアント設定情報を追加します。既知のURIを使用した場合は、この欄は空白のままで構いません。
OAuthクライアントのデフォルト認証リクエストパラメータ: Liferayアプリケーションで認証リクエストパラメータが明示的に指定されていない場合は、このOAuthクライアントを使用するためのデフォルトパラメータをJSON形式でここに指定してください。カスタムパラメータの値は、文字列のJSON配列である必要があります。
OAuthクライアントのデフォルトトークンリクエストパラメータ: Liferayアプリケーションでトークンリクエストパラメータが明示的に指定されていない場合は、このOAuthクライアントを使用するためのデフォルトパラメータをJSON形式でここに指定してください。カスタムパラメータの値は、文字列のJSON配列である必要があります。
OpenID Connectユーザー情報マッパーJSON:以下を参照
OpenID Connectユーザー情報マッパーJSON
Liferay DXP 7.4 U47+/GA47+
このセクションを使用すると、LiferayユーザーとOIDCプロバイダーのユーザー間でフィールドをマッピングできます。 emailAddress 、 firstName 、 lastName 、 screenNameの値は必須です。スクリーンネームのマッピングがない場合、またはクレームが空の場合、Liferay はそのユーザーのスクリーンネームを生成します。
この地図は5つのセクションで構成されています。
- 住所
- 電話
- 接触
- ユーザーロール
- ユーザー

マッピングの左側はLiferayにおけるユーザー属性名を指定し、マッピングの右側はOIDCプロバイダからのユーザー属性名を指定します。例えば、 firstNameはuser下でgiven_nameにマッピングされます。これは、OIDCプロバイダが、ユーザーのファーストネームを含むgiven_nameという属性を送信することを意味します。これは、Liferay のユーザー属性firstNameにマッピングされます。
ネストされた属性には、→ が使用されます。例えば、Liferay ユーザーのアドレス属性zipはaddress->postal_codeにマッピングされます。これは、OIDC プロバイダが"address": { "postal_code": "[SOME_POSTAL_CODE]" }という属性を送信し、それが Liferay ユーザーのアドレス属性zipにマッピングされることを意味します。
OIDCプロバイダーによっては、JSONに記載されているすべての情報を送信しない場合があります。マッピングが正しく行われるように、プロバイダーに適切な属性名を確認してください。場合によっては、特定の属性を取得するためにカスタムマッピングを作成する必要もあります。
自動役割割り当て
ユーザーがOIDCプロバイダーで役割を持っている場合、以下の条件を満たしていれば、その役割はLiferayユーザーにマッピングされます。
- この役割はLiferayに存在します。
- これは通常の役職です。
OIDCプロバイダがLiferayに存在しないロール情報を送信した場合、またはそれが通常のロールでない場合は、マッピングは実行されません。
標準OpenID Connectプロバイダー接続
-
グローバルメニュー(
)を開き、コントロールパネル→インスタンス設定→セキュリティ→ SSOに移動します。 -
仮想インスタンススコープで「OpenID Connectプロバイダー」を選択してください。

-
「追加」をクリックしてプロバイダーを追加します。
-
提供元から受け取った情報を使ってフォームに記入してください。
分野 説明 プロバイダー名 ユーザーがOpenID Connectを使用してログインする際に、この名前がサインインポートレットに表示されます。 スコープ デフォルト設定のままにしておいてください。ユーザー名とメールアドレスの入力を求められます。プロバイダーによっては、その他の範囲のユーザー情報を提供する場合があります。 検出エンドポイント このURLから他のURLを取得できる場合があり、それらはプロバイダーによって異なります。 検出エンドポイントキャッシュ(ミリ秒単位) 検出されたエンドポイント(URL)をこの期間キャッシュします。 認証エンドポイント このURLは、ユーザー認証(つまり、ユーザーのログイン)を行うためのプロバイダーのURLを指しています。 発行者URL ユーザー情報を発行しているプロバイダーに関する情報へのリンクとなる、プロバイダーのURL。 JWKS URI プロバイダーのトークンを検証できる公開鍵を含む、プロバイダーのJSON Webキーセットを指すURL。 IDトークン署名アルゴリズム 対応するIDトークンアルゴリズムを手動で設定します。通常、これは検出エンドポイントで「検出」されます。必要なだけいくつでも追加できます。 科目タイプ 主体識別子とは、プロバイダがユーザーを識別するために使用する、一意で再割り当てされない識別子であり、クライアント(Liferay DXPなど)によって利用されます。 2種類あります。パブリック(すべてのクライアントに同じ値を提供する)とペアワイズ(各クライアントに異なる値を提供する)です。 トークンエンドポイント トークンをリクエストできるプロバイダーのURL。 トークン接続タイムアウト(ミリ秒) 検証用のトークンを要求する際に、タイムアウトするまでの待機時間。値が 0の場合は永久に待機することを意味し、推奨されません。ユーザー情報エンドポイント ユーザー情報を取得できる、OAuth 2.0で保護されたURL。 OpenID ConnectクライアントID プロバイダーから受け取ったOAuth 2.0クライアントIDを入力してください。 OpenID Connectクライアントシークレット プロバイダーから受け取ったOAuth 2.0クライアントシークレットを入力してください。 カスタムクレーム プロバイダーから返された追加の請求内容を指定してください。これらのクレームは、既存のLiferayユーザーカスタムフィールドにマッピングされます。詳細については、 「OpenID Connect属性をカスタムフィールドにマッピングする」を参照してください。 (Liferay DXP 2025.Q4以降)マッチャーフィールド Liferayが、保存されているOIDC sub値を見つけられない場合に、ユーザーをどのように識別するか(メールアドレスまたはスクリーンネーム)を定義します。これは、ユーザーの最初の OIDC ログイン時、またはプロバイダーがまだsubを提供していない場合にのみ適用されます。フォールバックフィールドを使用した最初のログインが成功すると、Liferay はユーザーのsub値を保存し、以降のすべてのログインに使用します。重要Liferayは、OpenID仕様によるとオプションであるため、OpenID Connect用の暗号化IDトークン(JWE)をサポートしていません。ただし、必須の署名付きIDトークン(JWS)はサポートしています。
-
「保存」をクリックしてください。これでOpenID Connect認証を有効にする準備が整いました。
この構成は、接続のアクション(
)ボタンをクリックしてエクスポートすることでエクスポートできます。エクスポートされた構成は、一意の[name]フィールドを持つシステム設定構成ファイルになります。
com.liferay.portal.security.sso.openid.connect.internal.configuration.OpenIdConnectProviderConfiguration-[name].config
OpenID Connect属性をカスタムフィールドにマッピングする
Liferayでは、OpenIDクレームをユーザーカスタムフィールドにマッピングできます。
-
ユーザーカスタムフィールドを作成します。グローバルメニュー→コントロールパネル→カスタムフィールド(1) に移動します。
または、ユーザーを作成または編集する際にカスタムフィールドを追加します(2)。
注記適切なマッピングと保存を確実にするため、カスタムフィールドのデータ型がOpenIDクレームの型(文字列、数値、ブール値など)と一致していることを確認してください。

-
プロバイダー接続ページの最下部で、ユーザーカスタムフィールドを選択し、対応するOpenIDクレームに関連付けます。

-
カスタムフィールドのマッピングを追加または削除するには、(
) または (
) を使用します。 -
変更を適用するには、 「保存」をクリックしてください。
OpenID Connect認証を有効にする
-
グローバルメニュー(
)を開き、コントロールパネル→インスタンス設定→セキュリティ→ SSOに移動します。 -
仮想インスタンススコープで「OpenID Connect」を選択してください。

-
「有効」チェックボックスをクリックし、 「保存」をクリックします。
ユーザーはOpenID Connectを使用してサインインできるようになりました。
OpenID Connectオプションが表示されない場合、または設定が想定どおりに読み込まれない場合は、プロバイダーの検出エンドポイントにLiferayサーバーからアクセスできない可能性があります。サーバーからエンドポイントにアクセスしてネットワーク接続を確認します(例: curl https://your-provider/.well-known/openid-configuration )。リクエストが失敗した場合、通常はファイアウォールまたはネットワーク制限によってエンドポイントがブロックされていることを示しています。
ユーティリティページでOpenID Connectにアクセスする
Liferay DXP 2026.Q2+
OpenID Connectを有効にすると、インスタンスレベルでの認証が制御されます。 OpenID ConnectまたはFacebook Connectが設定され有効化されている場合、デフォルトのサインインユーティリティページのサインインウィジェットには、利用可能な認証オプションが自動的に表示されます。
OpenID Connect認証を設定するには、以下を参照してください。
2026年第2四半期より前にユーティリティページでOpenID Connectにアクセスする
Liferay DXP 2024.Q3 → Liferay DXP 2026.Q1
Liferay DXP 2024.Q3から2026.Q1の間では、OpenID Connectを有効にするとインスタンスレベルでの認証が制御されましたが、デフォルトのサインインユーティリティページのサインインウィジェットはローカル認証のみをサポートしていました。 OpenID ConnectまたはFacebook Connect認証を提供するには、以下のいずれかの方法を使用してください。
-
デフォルトのサインインポートレットにフォールバックします。
-
サイトメニュー(
)を開き、サイトビルダーを展開して、ページに移動します。 -
ユーティリティページタブを開き、サインインページのアクション(
)をクリックします。 -
確認ダイアログで「デフォルトとしてマークを解除」をクリックし、 「OK」をクリックします。
Liferay はデフォルトのサインイン ポートレットを使用し、OpenID Connect リンクは「OpenID Connect を使用したサインイン」で説明されているとおりに表示されます。
-
-
ユーザーを
/c/portal/loginにリダイレクトするか、プロバイダとの認証をトリガーするカスタムサインインユーティリティページを作成します。例えば、フラグメントやボタンを使ってユーザーをURLにリダイレクトします。
OpenID Connectでサインイン
OpenID Connectでサインインするための新しいリンクがサインインポートレットに表示されます。
-
サインインポートレットの下部にある「OpenID Connect」をクリックします。
-
プロバイダーを選択し、 「サインイン」をクリックしてください。
-
これにより、ご利用のプロバイダのログインページに移動します。認証情報を入力してログインしてください。
-
認証が成功すると、認証済みの状態でLiferay DXPにリダイレクトされます。
今後は、ユーザー認証時にユーザーグループとグループメンバーシップが同期されます。 Liferayは、グループとグループメンバーシップの元のソースを保存することで、複数のグループソース(OpenID ConnectとLDAPなど)が存在する場合に競合が発生しないようにします。
Liferayは、ユーザーの既存のアカウントが見つからない場合、ユーザーがOpenID Connectプロバイダー経由で初めてサインインしたときにアカウントを作成することができます。 Liferayは、プロバイダーとインスタンスが以下のすべての条件を満たしている場合にのみアカウントを作成します。
- プロバイダーはユーザーの名字と姓を送信します。
- プロバイダーは、マッチングフィールドが「Email」の場合、またはユーザーがメールアドレスを持っている必要がある場合に、ユーザーのメールアドレスを送信します。メールアドレスはデフォルトで必須です (
users.email.address.required=true)。 - マッチングフィールドが「スクリーンネーム」の場合、プロバイダーはユーザーのスクリーンネームを送信します。
- このインスタンスでは、アカウントを持っていない人も登録できます。ユーザーのメールアドレスがインスタンスの企業ドメインを使用している場合、インスタンスはユーザーが企業メールアドレスでサインアップできるようにする必要がある。ユーザー認証を参照してください。
クライアントとして、LiferayはOpenID Connectを使用する際にPKCE(Proof Key for Code Exchange)をサポートします。詳細については、 PKCE仕様書を参照してください。値をチェックし、リクエストを適切に承認または拒否するのは、プロバイダーの責任です。
シングルログアウト(SLO)
Liferayは、OpenID Connectバックチャネルログアウト1.0仕様を通じて、OpenID Connectのシングルログアウト(SLO)をサポートしています。 OpenID Connect Provider (OP) でユーザーのセッションが終了すると、OP は Liferay に通知し、Liferay は対応するセッションを終了します。
Liferayは依拠当事者(RP)として機能し、オペレーター(OP)になることはできません。バックチャネルログアウトはLiferayが実装する唯一のログアウト仕様であるため、SLOは常にOPによって開始されます。
- OpenID Connect RP開始ログアウト1.0はサポートされていません。 Liferayからサインアウトすると、Liferayのセッションのみが終了し、OPにおけるユーザーのセッションは終了しません。
- OpenID Connect Front-Channel Logout 1.0はサポートされていません。
OpenID Connect バックチャネルログアウト
Liferay DXP 2026.Q1+
バックチャネルログアウトは、プロバイダのログアウト通知をユーザーのブラウザを経由するのではなく、サーバー間直接リクエストとして送信するため、ユーザーのブラウザが閉じている場合やアクセスできない場合でも、Liferayに通知が届きます。
バックチャネルログアウトエンドポイント
Liferayは、バックチャネルログアウト要求を受信するためのエンドポイントとして/o/open_id_connect/backchannel_logoutを公開しています。例えば、Liferayがローカルでポート8080で実行されている場合:
http://localhost:8080/o/open_id_connect/backchannel_logout
OpenID Connectプロバイダ接続を設定したら、このURLをバックチャネルログアウトエンドポイントとしてOPに登録してください。
Liferayは、各リクエストに対して、トークンの発行者とセッション識別子(またはサブジェクト)を使用して一致するOpenID Connectセッションを特定し、そのプロバイダーが公開している署名キーに対してトークンの署名を検証し、トークンが設定されたクライアントIDに対して発行されたものであることを確認します。 Liferayは、検証に失敗したトークン、またはアクティブなセッションと一致しないトークンをすべて拒否します。このエンドポイントは汎用ログアウトAPIではありません。設定されたプロバイダからの有効な署名付きトークンがない場合、このエンドポイントへのリクエストは無効です。
OPはログアウト要求をユーザーのブラウザ経由ではなくLiferayに直接送信するため、ネットワーク経由でこのURLにアクセスできる必要があります。エンドポイントのリバースプロキシルール、ファイアウォールルール、DNS解決、およびTLS証明書を確認してください。プロバイダがログアウトトークンを提供できない場合、Liferayには通知されず、試行が失敗したことを示すログも記録されません。 OpenID Connectセッションは、アクセストークンの有効期限が近づくまで継続されます。Liferayはトークンの更新を試み、プロバイダがそれを拒否した場合、Liferayはセッションを削除し、ユーザーが次回リクエストを行った際にログアウトさせます。プロバイダがリフレッシュトークンを引き続き有効とする場合、Liferayセッションは継続されます。
バックチャネルログアウトはサーバー間のやり取りであるため、ユーザーのブラウザには即座に変化は現れません。 Liferayはログアウトトークンを検証するとすぐにOpenID Connectセッションを終了しますが、ブラウザセッションはユーザーが次のリクエストを行い、ホームページにリダイレクトされるまで無効化されません。
機能の利用可能性
| 機能 | ベータ版として利用可能 | リリースとして入手可能 | 一般的に入手可能 |
|---|---|---|---|
| OpenID Connectユーザー向けのマッチングフィールド | Liferay DXP 2025.Q4 (LPD-20879) | Liferay DXP 2026.Q1 (LPD-20879) | Liferay DXP 2026.Q1 |
| OpenID Connect属性をカスタムフィールドにマッピングする | - | Liferay DXP 2025.Q4 (LPD-57332) | Liferay DXP 2026.Q1 |
| OpenID Connect のシングルログアウト (SLO) | - | - | Liferay DXP 2026.Q1 (LPD-67469) |
| サインインユーティリティページでのOpenID Connect | - | - | Liferay DXP 2026.Q2 |