Authenticating with SAML
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

SAML管理者

サブスクリプション

SAMLインスタンスを設定するには、SAML管理パネルが最適です。 SAML管理を効率化するために、インスタンス設定の代わりにこれを使用してください。

注記

Liferay 7.4以降、SAMLは標準機能として利用可能です。 SAML Connector 2.0のインストールは不要です。

SAML Adminを使用すると、IDプロバイダー(IdP)、サービスプロバイダー(SP)、およびそれぞれへの接続を設定できます。 アクセスするには、 グローバルメニュー (Global Menu) → コントロールパネル → SAML 管理 を開きます。

タブは3つあります。

一般: SAML SP または IdP を有効または無効にし、必要なキーストアを管理します。

サービス/IDプロバイダー: 選択されたSAMLロールに基づいて、SPまたはIdPの基本構成と高度な構成を管理します。

ID/サービスプロバイダー接続: SP (SAML ロールが ID プロバイダーの場合) または IdP (SAML ロールがサービスプロバイダーの場合) への接続を管理します。 SP/IdP間の接続は複数存在する可能性があります。

一般タブ

「一般」タブには、SAMLの役割に関係なく適用されるオプションが表示されます。

有効: すべての設定が完了したら、このチェックボックスをオンにして SAML 認証を有効にします。

SAML ロール: SAML ロール (ID プロバイダーまたはサービス プロバイダー) を選択してください。

Liferay DXP 2025.Q4以降では、アイデンティティブローカーの役割も利用可能になりました。 詳細については、 アイデンティティブローカー を参照してください。

エンティティ ID: この SAML エンティティ (IdP または SP) の一意の識別子。 最大1024文字までです。

「証明書と秘密鍵」セクションは、最初の保存後に表示され、システム設定でキーストアを設定した際に生成された鍵が表示されます。 ここでは、新しい証明書を生成するか、他の場所で作成した証明書をインポートすることで、証明書を置き換えることができます。また、証明書をダウンロードして他の場所にインポートすることもできます。

自動生成された証明書を置き換える必要がある場合は、次のことができます。

  1. をクリックして証明書を置き換えます。

  2. [証明書を作成]タブは、デフォルトで有効になっています。 鍵の必要事項を入力してください。

  3. 完了したら、 保存 をクリックします。

新しいキーの詳細が表示されました。

既にキーを生成している場合は、そのキーを PKCS #12 アーカイブに保存して、Liferay DXP にインポートする必要があります。

  1. をクリックして証明書を置き換えます。

  2. 証明書のインポート タブをクリックします。

  3. キーストアのパスワードを入力し、PKCS #12キーファイルをアップロードエリアにドロップするか、ファイルセレクタを使用して選択します。

キーがインポートされました。

アイデンティティブローカー

  1. SAML ロール フィールドから アイデンティティ ブローカー ロールを選択します。 このモードでは、Liferayは外部のIDプロバイダーと、お客様の環境に設定されているサービスプロバイダーとの間の橋渡し役として機能します。

  2. アイデンティティブローカーの設定は、以下の2つの部分から構成されます。

両方の設定が完了すると、Liferay は各認証リクエストを適切な外部 IdP にルーティングし、返されたアサーションを検証し、下流の SP に新しいアサーションを発行します。 これにより、Liferayをブローカーとして、接続されているすべてのIdPおよびSP間で継続的な認証フローが確立されます。

サービスプロバイダー

  1. SAML ロール フィールドから サービス プロバイダー ロールを選択します。

  2. 「証明書と秘密鍵」セクションは、SAML用のキーストアを作成するためのものです。 証明書の作成 をクリックし、以下の情報を入力してください。

    • あなたの一般的な名前(姓と名)
    • 組織名
    • 組織単位の名前
    • あなたの住む都市または地域の名前
    • あなたの州または県の名前
    • あなたの国の名前
    • キーストアの有効期間(有効期限が切れるまでの日数)
    • 鍵アルゴリズム(デフォルトはRSA)
    • 鍵の長さ(ビット単位)(デフォルトは2048)
    • キーパスワード

    キーストアには、ファイルシステムストレージ(デフォルト)とドキュメントおよびメディアストレージの2つのストレージオプションがあることを覚えておいてください。 デフォルトでは、証明書は暗号化に SHA256 アルゴリズムを使用し、 MD5 および SHA256 を介してフィンガープリントおよび自己署名されます。 必要な情報をすべて入力したら、 保存 をクリックしてください。

  3. 保存をクリックした後、証明書に関する情報を表示したり、証明書をダウンロードしたりできることを確認してください。 可能であれば、キーストアの作成は成功です。

  4. 暗号化証明書を生成することもできます。 これはアサーションを暗号化するための別の鍵です。 アサーションを暗号化したい場合は、専用のキーを生成する必要があります。 手順は、上記のステップ2で証明書を生成する手順と全く同じです。

  5. 次に、IDプロバイダーとの接続を設定する必要があります。 ID プロバイダー接続 タブをクリックし、 ID プロバイダーの追加 をクリックします。

  6. IDプロバイダーの名前、エンティティID、およびメタデータURLを入力してください。 既に別のLiferay DXPインストールをIDプロバイダーとして構成している場合は、次の情報を入力します。

    • 名前: Liferay IdP
    • エンティティID: [IDプロバイダーのID]
    • クロックスキュー:SPとIdP間の許容誤差をミリ秒単位で設定します。
    • 強制認証: IdPが状況に関係なく再認証を強制するかどうか。
    • メタデータURL: http://localhost:8080/c/portal/saml/metadata (まずこのURLをテストしてください)
    • 名前識別子の形式: 設定 を参照してください。
    • 属性マッピング: 設定 を参照してください。
    • キープアライブ URL: 設定 を参照してください。
    重要

    Liferay Connector to SAML 2.0アプリでは、SAML IdPメタデータファイルへのURL、 または実際の(アップロードされた)SAMLメタデータXMLファイルの いずれかを使用できます。 メタデータ URL フィールドに入力された値は、メタデータ URL が存在し、かつメタデータ XML ファイルが指定されていない場合にのみデータベースに保持されます。 それ以外の場合、Liferay DXPは元のメタデータURLをデータベースに保持します。 この動作により、メタデータURLが指定されると、必ずデータベースにメタデータURLが保存されることが保証されます。 このようにすれば、以前に入力したメタデータURLやその形式を忘れてしまった場合でも、表示されているメタデータURLを確認し、表示されているメタデータURLを変更するか、メタデータXMLファイルを指定して以前に保存したメタデータURLを上書きすることができます。

  7. 最後に、証明書と秘密鍵の情報を保存し、IDプロバイダーへの接続を設定したら、「全般」タブの上部にある「有効」チェックボックスにチェックを入れ、「保存」をクリックしてください。 LiferayはSAMLサービスプロバイダーになりました!

SAMLサービスプロバイダーのセッションは、アプリケーションサーバー上の通常のセッションと関連付けられていることに注意してください。 アプリケーションサーバー上でのセッション有効期限切れは、サービスプロバイダー上のセッションを終了させますが、シングルログアウトは開始しません。

サービスプロバイダの設定

アサーション署名の要求: SAML メッセージ全体に加えて、SAML アサーションが IdP によって個別に署名されることを要求するには、このボックスをオンにします。

クロックスキュー: 設定を参照。

LDAP インポートが有効: この SP のインスタンス設定で宣言されている LDAP サーバーからユーザー属性をインポートするには、このボックスをオンにします。

認証リクエストに署名しますか?: SP として構成されている場合、認証リクエストにデジタル署名します。

メタデータに署名しますか?: ピアSAMLエンティティに送信されるメタデータに署名します。

SSL 必須: すべての SAML メッセージの転送に SSL を必須にするには、このボックスをオンにします。 ピアに送信されるメタデータ内のすべての URL には、 https プロトコルがプレフィックスとして付加されます。

ログインポートレットの表示を許可します。 ログイン要求に一致する SAML IdP がない場合にログインポートレットを表示することを許可します。 このシナリオでは、ユーザーはLiferay DXPにローカルでログインします。

重要

SAMLレスポンス自体に署名があれば、個々のアサーションに署名する必要はありません。 SPとIdPは常に https を介して通信し、トランスポートレベルで暗号化を行う必要があります。

Liferay DXPでは、署名付きSAMLレスポンスが必要です。 中間者攻撃の可能性があり、かつアサーションに含まれる情報が機密情報である場合は、署名と暗号化の両方を行うことができます。

複数のIdP接続を追加できます。 別のIDプロバイダーを追加するには、 IDプロバイダーの追加 をもう一度クリックし、別のプロバイダーの詳細を入力します。 ユーザーがログインする際、IDプロバイダーを選択するように求められるため、ユーザーが認識できるようにプロバイダー名を明記してください。

IDプロバイダー

  1. SAML ロール フィールドから ID プロバイダー ロールを選択します。

  2. 「証明書と秘密鍵」セクションは、SAML用のキーストアを作成するためのものです。 証明書の作成 をクリックし、以下の情報を入力してください。

    • あなたの一般的な名前(姓と名)
    • 組織名
    • 組織単位の名前
    • あなたの住む都市または地域の名前
    • あなたの州または県の名前
    • あなたの国の名前
    • キーストアの有効期間(有効期限が切れるまでの日数)
    • 鍵アルゴリズム(デフォルトはRSA)
    • 鍵の長さ(ビット単位)(デフォルトは2048)
    • キーパスワード

    キーストアには、ファイルシステムストレージ(デフォルト)とドキュメントおよびメディアストレージの2つのストレージオプションがあることを覚えておいてください。 デフォルトでは、証明書は暗号化に SHA256 アルゴリズムを使用し、 MD5 および SHA256 を介してフィンガープリントおよび自己署名されます。 必要な情報をすべて入力したら、 保存 をクリックしてください。

  3. 保存をクリックした後、証明書に関する情報を表示したり、証明書をダウンロードしたりできることを確認してください。 可能であれば、キーストアの作成は成功です。

  4. 暗号化証明書を生成することもできます。 これはアサーションを暗号化するための別の鍵です。 アサーションを暗号化したい場合は、専用のキーを生成する必要があります。 手順は、上記のステップ2で証明書を生成する手順と全く同じです。

  5. 次に、サービスプロバイダとの接続を設定する必要があります。 サービスプロバイダー接続 タブに移動し、 サービスプロバイダーの追加 をクリックします。

  6. サービスプロバイダーの名前、エンティティID、およびメタデータURLを入力してください。 既に別のLiferay DXPインストールをサービスプロバイダーとして構成している場合は、次の情報を入力します。

    • 名前: Liferay SP
    • エンティティID:サービスプロバイダーのID
    • 有効:このチェックボックスをオンにすると、サービスプロバイダーとの接続が有効になります。
    • 暗号化を強制するには、 設定 を参照してください。
    • メタデータURL: http://localhost:8080/c/portal/saml/metadata (まずこのURLをテストしてください)
    • 名前識別子の形式: 設定 を参照してください。
    • 属性が有効、属性、および属性名前空間が有効: 設定 を参照してください。
    • キープアライブ URL: 設定 を参照してください。
  7. 最後に、証明書と秘密鍵の情報を保存し、サービス・プロバイダー接続を設定したら、[一般]タブの上部にある [Enabled]にチェックを入れ、 [保存]をクリックします。 LiferayはSAML認証プロバイダーになりました。

ユーザーグループメンバーシップ属性

Liferay DXP 2025.Q4+

Liferay がアイデンティティ プロバイダーとして機能する場合、認証された各ユーザーのグループ メンバーシップを membership:userGroups SAML 属性としてサービス プロバイダーに公開できます。 Liferay は、サービス プロバイダー接続で 属性有効化 がチェックされ、 userGroups が 属性 にリストされている場合にのみ、この属性を公開します。 Attributes Namespace Enabled もチェックされている場合、Liferay は代わりに urn:liferay:membership:userGroups を公開します。

Liferay は、LPD-66611 の非推奨機能フラグが有効になっている間、非推奨となったuserGroups属性(または、「Attributes Namespace Enabled」にチェックが入っている場合はurn:liferay:userGroups)も公開します。 新規インストールではこのフラグは無効になりますが、アップグレードされたインスタンスでは有効のままになります。 この機能が有効になっている間は、Liferay は非推奨の属性を公開するたびに警告をログに記録し、将来のリリースでこの機能は削除されます。

重要

各サービスプロバイダを再構成して、 membership:userGroupsと読み、サービスプロバイダ自体で変更を行います。 Liferay サービス プロバイダー接続の 属性 フィールドを userGroupsに設定したままにしてください。これにより、公開属性名ではなく、公開するデータが選択されます。 LPD-66611 フラグを無効にすると、インスタンス内のすべてのサービスプロバイダに影響するため、無効にする前にすべてを再設定してください。

IDプロバイダーの設定

メタデータに署名しますか?: ピアSAMLエンティティに送信されるメタデータに署名します。

SSL 必須: すべての SAML メッセージの転送に SSL を必須にするには、このボックスをオンにします。 ピアに送信されるメタデータ内のすべての URL には、 https プロトコルがプレフィックスとして付加されます。

認証リクエストの署名を必須にする: 認証リクエストごとに送信サービスプロバイダによる署名を必須にするには、このボックスをオンにします。 ほとんどの場合、これは有効にしておくべきです。

セッションの最大有効期間: IdP によって管理される SSO セッションが継続する時間 (秒単位)。

セッションアイドルタイムアウト: アイドル状態のセッションが期限切れになるまでの時間(秒)。

SAML設定

サービスプロバイダーとIDプロバイダーの設定には、同じ項目が多数含まれています。 参考資料はこちらです。

名前: SP または IdP の名前を指定します。 これは単なる説明的な名前であり、設定では使用されません。

エンティティ ID: この SP または IdP の正式名称。 接続を設定する際は、この名前と一致させる必要があります。

有効: このSAMLプロバイダーを有効にするには、このボックスをオンにします。

クロックスキュー: SPとIdP間の時間差の許容値をミリ秒単位で設定します。

暗号化を強制: SP がアサーションを暗号化するための公開鍵を提供しない場合、シングルサインオンを中止します。

強制認証: このボックスをオンにすると、サービス プロバイダーは、ユーザーを検証する前に、ID プロバイダーにユーザーの再認証を要求します。 複数のIDプロバイダーを設定している場合は、ユーザーが使用するIDプロバイダーを選択できるように、この機能を無効にしてください。 既に選択したIDプロバイダーで認証済みの場合、ユーザーは再認証する必要はありません。

不明なユーザーは見知らぬ人です: 見知らぬ人の動作は、コントロール パネル → インスタンス設定 → プラットフォーム → ユーザー認証 → 一般で定義されています。

メタデータ: サービスプロバイダのメタデータ XML ファイルへの URL を指定するか、サービスプロバイダのメタデータ XML ファイルを手動でアップロードしてください。 URLを指定すると、XMLファイルが取得され、定期的に更新情報がポーリングされます。 更新間隔は、システム設定の「ランタイムメタデータ更新間隔」プロパティで秒数を指定することで設定できます。 URLによるメタデータXMLファイルの取得に失敗した場合、サービスプロバイダ接続を有効にすることはできません。 IDプロバイダーサーバーがURL経由でメタデータにアクセスできない場合は、XMLファイルを手動でアップロードできます。 この場合、メタデータXMLファイルは自動的に更新されません。

名前識別子: SAML 仕様のセクション 8.3 で使用可能なオプションから名前識別子の形式を選択してください 。 サービスプロバイダーが受け取ることを期待する内容に合わせて設定してください。 Liferayサービスプロバイダーの場合、メールアドレス以外の選択肢は、名前識別子がスクリーンネームを指すことを示します。 これらのフォーマットは、Liferayのアイデンティティプロバイダーにとって特別な意味を持ちません。 NameID の値は、Name Identifier 属性によって定義されます。

ユーザー解決: 一致なし、名前ID形式に基づいて動的に選択されたユーザーフィールドとの一致、または特定のSAML属性マッピングを使用した一致から選択します。 このアルゴリズムは、ユーザーをどのように見つけるか、またはユーザーを割り当てるかを決定します。 例えば、名前ID形式に基づいて選択し、名前ID形式がメールアドレスである場合、アルゴリズムはメールアドレスで照合します。

属性マッピング: SAML属性に一致させるLiferayのフィールドを選択します。 LiferayのUserオブジェクトから複数のフィールドを選択することも、Userオブジェクト用に作成したカスタムフィールドを選択することもできます。 これらの属性は、ユーザーがシステムにログインした際にSAMLアサーションから更新されます。 デフォルトでは、 NameID とサービスプロバイダーは、 emailAddress が少なくとも 1 回一致した後にユーザーにバインドされます。 バインディングはユーザー照合を行う前に優先的にチェックされるため、メールアドレスが変更されたユーザーがログインできなくなることはなく、SAML属性マッピングを通じてメールアドレスを修正することも可能です。 マッピングに使用できる Liferay 属性は、 emailAddress、 screenName、 firstName、 lastName、 modifiedDate、および uuid です。

属性の有効化: このサービスプロバイダに送信されるアサーションに属性ステートメントを含めるには、このボックスをオンにします。 チェックが外れている場合、Liferay は属性を一切公開しません。 この設定はサービスプロバイダー接続に関するものであり、LiferayがIDプロバイダーとして機能する場合に適用されます。

属性: アサーションに含める属性ステートメントの属性名を、1行に1つずつ入力してください。 ユーザーのグループメンバーシップを公開するには、 userGroups と入力します。 ユーザーグループメンバーシップ属性 を参照してください。

Liferay DXP は以下の値を認識します。

価値説明
expando:[フィールド名]Liferay DXPは、ユーザーのExpandoブリッジから指定されたカスタムフィールドの値を公開します。
グループLiferay DXPは、ユーザーが所属するサイトの名前を公開します。
マップ:[属性名]=[ユーザーフィールド名]Liferay DXPは、指定したLiferay Userフィールドの値を、ユーザーが選択したカスタム属性名で公開します。
組織の役割Liferay DXP は、ユーザーの組織スコープのロールを組織ごとに個別の属性として公開します。その属性名は organizationRole:[組織名] です。
組織Liferay DXPは、ユーザーが所属する組織名を公開します。
役割Liferay DXPは、直接割り当てられた役割だけでなく、サイト、組織、ユーザーグループを通じて割り当てられた役割も含め、ユーザーのすべての役割を公開します。
サイトロールLiferay DXP は、ユーザーのサイトスコープのロールをサイトごとに個別の属性として公開します。その属性名は siteRole:[サイト名] です。
static:[name]=[value]Liferay DXP は、ログインしているユーザーのデータに関係なく、すべてのユーザーに対して固定の [値] を公開します。
ユーザーグループロールLiferay DXP は、ユーザーグループのメンバーシップを通じて継承されたロールを含む、ユーザーのサイトスコープのロールを、サイトごとに userGroupRole:[サイト名] という名前の個別の属性として公開します。
ユーザーグループLiferay DXPは、ユーザーが所属するユーザーグループの名前を公開します。
その他の値Liferay DXP は、その値を Liferay User フィールド名 (たとえば、 emailAddress、 screenName、 firstName、または lastName) として扱い、そのフィールドの値を公開します。

属性名前空間の有効化: 公開属性名に名前空間を適用するには、このボックスをオンにします。 各ユーザー属性は、 urn:liferay:user で名前空間化され、その他すべては urn:liferay で名前空間化されます。

キープアライブ: ユーザーが Liferay IdP を介して複数の Liferay SP インスタンスにログインしている場合、いずれかのインスタンスのブラウザー ウィンドウを開いたままにしておけば、セッションを維持できます。 これは、サービスプロバイダーがLiferay DXPの場合にのみ設定してください。 URLは https://[SPホスト名]/c/portal/saml/keep*aliveです。

クラスタ環境でLiferay DXPをSAMLサービスプロバイダとして設定する

Liferay Connector to SAML 2.0アプリは、クラスタ環境におけるSSOソリューションとして使用できます。 マルチノードクラスタがロードバランサーの背後にある場合、すべてのノードをSPとして有効にし、同じキーストアマネージャを共有する必要があります。

ファイルシステムキーストアマネージャを使用する場合(デフォルト):

  1. 上記のように、 Liferay クラスター の各ノードを SAML サービス プロバイダーとして構成します。

  2. キーストアファイル([Liferay Home]/data/keystore.jks、デフォルト)を、最初のノードから残りのノードにコピーします。 このファイルは、SAMLプロバイダーアプリで作成されるJavaキーストアです。 キーストアには、SAMLコネクターアプリが管理する有効な証明書または自己署名証明書が含まれます。

  3. サービス・プロバイダーのメタデータが、URLまたはXMLファイルとして使用できるように生成されていることを確認します。 同じデータベースバックエンドを使用しているため、メタデータはすべてのノードで同じです。 IdPのリクエストはロードバランサーを経由します。

  4. この時点で、すべてのノードは同じSAML SP構成を持ち、それぞれがWebリクエストに応答し、SAMLプロトコルを処理できます。 SSOソリューションをテストするには、ロードバランサー経由でLiferayにサインインし、いくつかの異なるサイトのいくつかのページに移動し、ログアウトしてください。

ドキュメントライブラリキーストアマネージャを使用する場合は、キーストアファイルはすべてのノードで共有されるデータベースに保存されるため、手順2はスキップしてください。

これで、Liferay DXPをSAMLサービスプロバイダーとして設定する方法がわかりました。 また、クラスタ環境でのSAMLの設定方法もご存知でしょう。

注記

Liferay 7.4以降、SAMLは標準機能として利用可能です。 SAML Connector 2.0のインストールは不要です。

OSGi構成プロパティ

SAMLは、 OSGi構成ファイル を使用したり、メタデータXMLをアップロードして接続のネゴシエーション方法を設定することで、UI以外から構成できます。

前述のとおり、SP接続の設定に関するすべての操作は、SAML管理UIを通じて行う必要があり、設定はLiferayのデータベースに保存されます。

注記

OSGi .config ファイルや Liferay DXP のシステム設定コントロール パネル アプリケーションを使用して SAML プロバイダー (IdP または SP) を構成しないでください。 システム設定UIは自動生成されるもので、上級管理者向けです。 SAML管理UIが行うような、フィールドに対する高度な検証は行われないため、管理者は無効な設定を作成してしまう可能性があります。

これは、OSGi Configuration Admin を介して管理される、ポータルインスタンススコープの構成です。 以下のリストは、 SAMLProviderConfiguration メタタイプから選択されたプロパティを示しています。

  • keyStoreCredentialPassword()
  • keyStoreEncryptionCredentialPassword()
  • assertionSignatureRequired()
  • 認証要求署名必須()
  • authnRequestSigningAllowsDynamicACSURL()
  • クロックスキュー()
  • defaultAssertionLifetime()
  • エンティティID()
  • 有効化()
  • ldapImportEnabled
  • 役割()
  • セッションの最大年齢
  • セッションタイムアウト()
  • signAuthnRequest()
  • 署名メタデータ()
  • sslRequired()
  • allowShowTheLoginPortlet()

SAML管理UIは、ポータルインスタンスのスコープを持つ構成インスタンスを作成するための場所であり続けます。

システム全体の構成も存在し、それは SamlConfiguration メタタイプで表されます。

Liferay 6.2をご利用だった方は、以下のシステム全体のプロパティが削除されていることにご注意ください。

  • saml.metadata.paths (SP接続のデフォルト設定を削除した後は、何の役にも立たなくなりました)
  • saml.runtime.metadata.max.refresh.delay
  • saml.runtime.metadata.min.refresh.delay

後者の 2 つのプロパティは、単一のプロパティ com.liferay.saml.runtime.configuration.SamlConfiguration.getMetadataRefreshInterval() に置き換えられました。

また、「コントロールパネル」→「システム設定」→「セキュリティ」→「SSO」に、SAML KeyStoreManagerの実装設定が追加された点にもご留意ください。 この構成のオプションについては、上記の システムレベルでの SAML の構成 で説明されています。

最近のバージョンでは、 SHA256 が、設定およびキー生成に使用されるデフォルトの暗号化アルゴリズムです。 デフォルト設定では、 SHA256を試行し、次に SHA384を試行し、次に SHA512 を試行した後、 SHA1 にフォールバックします。 SHA1 は潜在的に脆弱であるため、このプロパティを使用してブラックリストに登録できます。

ブラックリストに登録されたアルゴリズム=["ブラックリストに登録されたアルゴリズムのURL"、 "別のブラックリストに登録されたアルゴリズムのURL"]

SHA1をブラックリストに登録するには、次の設定が必要です。

ブラックリストに登録されたアルゴリズム=["http://www.w3.org/2000/09/xmldsig#sha1"]

これらを以下の名前の設定ファイルに記述してください。

com.liferay.saml.opensaml.integration.internal.bootstrap.SecurityConfigurationBootstrap.config

メタデータXMLを設定すると、接続のネゴシエーション方法をより細かく制御できるようになります。

metadata.xml を介したネゴシエーションの設定

デフォルトの交渉設定がうまく機能しない場合は、独自の設定を作成してアップロードできます。 この操作を行う前に、ホストのメタデータURLにアクセスし、後で必要になる場合に備えて設定のコピーを保存してください。

http://[hostname]/c/portal/saml/metadata

例えば、SHA1 のみをサポートするレガシーな IdP に接続できない場合は、他のアルゴリズムを無効にする設定をアップロードできます。

<?xml version="1.0" encoding="UTF-8"?>
<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" entityID="samlidp">
   <md:IDPSSODescriptor WantAuthnRequestsSigned="true" protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
      <md:Extensions>
         <alg:SigningMethod xmlns:alg="urn:oasis:names:tc:SAML:metadata:algsupport" Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
      </md:Extensions>
      <md:KeyDescriptor use="signing">
         <ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
         <ds:X509Data>
            <ds:X509Certificate>...省略...</ds:X509Certificate>
         </ds:X509Data>
         </ds:KeyInfo>
      </md:KeyDescriptor>
      <md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="http://localhost:8080/c/portal/saml/slo"/>
      <md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="http://localhost:8080/c/portal/saml/slo"/>
      <md:SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="http://localhost:8080/c/portal/saml/sso"/>
      <md:SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="http://localhost:8080/c/portal/saml/sso"/>
   </md:IDPSSODescriptor>
</md:EntityDescriptor>

上記の構成では、 <md:Extensions> ブロックには署名アルゴリズムが 1 つだけあることに注意してください: SHA1。

注記

デフォルト設定では SHA1にフォールバックするため、レガシーシステムがフォールバックメカニズムを介してネゴシエートできない場合を除き、この操作を行う必要はありません。 また、 SHA1をブラックリストに登録した場合、これは機能しないことに注意してください。 SHA1には 脆弱性があるため、可能であれば使用を避けるのが最善です。

メタデータの設定を変更した場合、変更前に設定を保存していれば、デフォルト設定に戻すことができます。 そうでない場合は、アップロードしたXMLファイルの代わりに、ピアのメタデータ設定へのURLを指定できます。

バージョンごとの機能提供状況

機能Liferayバージョン注記
アイデンティティブローカー2025年第4四半期以降当初はベータ版機能としてリリースされました(SAML向けアイデンティティブローカーサポート - LPD-29737)。 Liferay 2026.Q1でGAに移行しました。