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

OpenAMを使用する

Liferay DXP 2024.Q4/Portal GA129で非推奨になりました

重要

OpenAM 13 は Liferay DXP 2024.Q4/Portal GA129 で非推奨となりました。 Liferay DXP 7.2以降、OpenAM 12以前のバージョンは非推奨となりました。

OpenSSO/OpenAMの各バージョンは、ベンダーによるサポート終了(EOL)のため、サポート対象外となっています。引き続きご利用いただくには、OpenID ConnectやSAMLなどの最新の認証プロトコルを活用した新しいバージョンへの移行をお勧めします。

OpenAMは、Sun社のSystem Access Manager製品のコードベースを基に開発された、オープンソースのシングルサインオンソリューションです。 OpenAMを使用すると、Liferay DXPを、異なるIDリポジトリに対する複数の異なる認証方式を含むインフラストラクチャに統合できます。

インストールに関する注意事項

OpenAMをインストールするには、付属のドキュメントに記載されている手順に従ってください。 OpenAMはアプリケーション間でのCookieの共有に依存していることに注意してください。したがって、OpenAMを正常に動作させるためには、SSOを必要とするすべてのアプリケーションが同一のWebドメイン内にある必要があります。 HTTPOnlyクッキーを有効にしている場合は、一部のWebコンテナ(Apache Tomcat™など)が特殊文字を含むクッキーを解析する方法の関係で、以下のプロパティも追加する必要があります。

com.iplanet.am.cookie.encode=true

OpenAMは、Liferay DXPと同じサーバー、または別のサーバーにインストールできます。 OpenAMサーバーのコンテキストパスとサーバーホスト名を必ず確認してください。

OpenAMをLiferay DXPと同じサーバーにインストールする場合は、ここからダウンロード可能なOpenAM .warをデプロイする必要があります。それ以外の場合は、 OpenAM 13 サイト の手順に従って OpenAM をインストールしてください。

OpenAMの設定

インストールが完了したら、次の2つのことを行う必要があります。

  1. OpenAMでLiferay DXPの管理者ユーザーを作成する

  2. 認証のためにOpenAMを有効にする

    ユーザーはスクリーン名に基づいて相互にマッピングされるため、OpenAMのユーザーIDとLiferay管理者ユーザーのスクリーン名が一致していることを確認してください。例えば、Liferay DXP 管理ユーザーのスクリーン名が adminの場合、OpenAM に ID admin と admin.email.from.address ポータル プロパティ で指定されたメールアドレスを使用してユーザーを登録します。ユーザーの設定が完了したら、そのユーザーを使用してOpenAMにログインしてください。

  3. 同じブラウザウィンドウで、管理者ユーザーとしてLiferay DXPにログインします(以前使用した管理者メールアドレスを使用します)。

  4. コントロール パネルに移動し、 インスタンス設定 → SSO をクリックします。次に、左側のリストから OpenSSO を選択します。

    統合を機能させるには、LiferayでOpenSSOの設定を有効にする必要があります。

  5. 3つのURLフィールド(ログインURL、ログアウトURL、サービスURL)を、お使いのOpenAMサーバーを指すように変更し(つまり、URLのホスト名部分のみを変更してください)、「有効」チェックボックスにチェックを入れ、「保存」をクリックします。

Liferay は、ユーザーが /c/portal/login URL をリクエストしたとき (たとえば、 サインイン リンクをクリックしたとき) に、OpenAM にリダイレクトします。

Liferayの異なるスコープでOpenAMを設定する

Liferay DXPのOpenAM構成は、システムスコープでもインスタンススコープでも適用できます。

システムスコープでOpenAM SSOモジュールを構成するには:

  1. コントロールパネルに移動します

  2. コントロール パネル → システム設定 → SSO → OpenSSO をクリックします。設定は以下のとおりです。ここで設定した値は、すべてのポータルインスタンスのデフォルト値となります。 Javaのプリミティブ型をリテラル値で初期化する場合と同じ形式で入力してください。

プロパティラベルプロパティキー説明種類
バージョンversion使用するOpenAMバージョン(12以下または13)String
有効enabledOpenAM認証を有効にするには、このボックスをオンにします。 OpenAMは、LDAP認証も有効になっていて、Liferay DXPの認証タイプが画面名に設定されている場合にのみ機能することに注意してください。boolean
LDAPからインポートimportFromLDAPこれをオンにすると、Liferay DXPに存在しないOpenAMから認証されたユーザがLDAPからインポートされます。 LDAPを有効にする必要があります。boolean
ログインURLloginURLOpenAMサーバーのログインページへのURLString
ログアウトURLlogoutURLOpenAMサーバーのログアウトページへのURLString
サービスURLserviceURL認証されたWebサービスを使用するためにOpenAMにアクセスできるURL。 OpenAM Express 8以降を使用している場合は、サーバーでJava 6を実行する必要があります。String
スクリーン名の属性screenNameAttrユーザーの画面名を表すOpenAM上の属性の名前String
電子メール アドレス属性emailAddressAttrユーザーの電子メールアドレスを表すOpenAM上の属性の名前String
名の属性firstNameAttrユーザーの名を表すOpenAM上の属性の名前String
姓の属性lastNameAttrユーザーの姓を表すOpenAM上の属性の名前String

特定のポータル インスタンスのこれらのデフォルト設定を上書きするには、コントロール パネルに移動し、 インスタンス設定 → SSO をクリックします。次に、左側のリストから OpenSSO を選択します。