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つのことを行う必要があります。
-
OpenAMでLiferay DXPの管理者ユーザーを作成する
-
認証のためにOpenAMを有効にする
ユーザーはスクリーン名に基づいて相互にマッピングされるため、OpenAMのユーザーIDとLiferay管理者ユーザーのスクリーン名が一致していることを確認してください。例えば、Liferay DXP 管理ユーザーのスクリーン名が adminの場合、OpenAM に ID admin と
admin.email.from.addressポータル プロパティ で指定されたメールアドレスを使用してユーザーを登録します。ユーザーの設定が完了したら、そのユーザーを使用してOpenAMにログインしてください。 -
同じブラウザウィンドウで、管理者ユーザーとしてLiferay DXPにログインします(以前使用した管理者メールアドレスを使用します)。
-
コントロール パネルに移動し、 インスタンス設定 → SSO をクリックします。次に、左側のリストから OpenSSO を選択します。

-
3つのURLフィールド(ログインURL、ログアウトURL、サービスURL)を、お使いのOpenAMサーバーを指すように変更し(つまり、URLのホスト名部分のみを変更してください)、「有効」チェックボックスにチェックを入れ、「保存」をクリックします。
Liferay は、ユーザーが /c/portal/login URL をリクエストしたとき (たとえば、 サインイン リンクをクリックしたとき) に、OpenAM にリダイレクトします。
Liferayの異なるスコープでOpenAMを設定する
Liferay DXPのOpenAM構成は、システムスコープでもインスタンススコープでも適用できます。
システムスコープでOpenAM SSOモジュールを構成するには:
-
コントロールパネルに移動します
-
コントロール パネル → システム設定 → SSO → OpenSSO をクリックします。設定は以下のとおりです。ここで設定した値は、すべてのポータルインスタンスのデフォルト値となります。 Javaのプリミティブ型をリテラル値で初期化する場合と同じ形式で入力してください。
| プロパティラベル | プロパティキー | 説明 | 種類 |
|---|---|---|---|
| バージョン | version | 使用するOpenAMバージョン(12以下または13) | String |
| 有効 | enabled | OpenAM認証を有効にするには、このボックスをオンにします。 OpenAMは、LDAP認証も有効になっていて、Liferay DXPの認証タイプが画面名に設定されている場合にのみ機能することに注意してください。 | boolean |
| LDAPからインポート | importFromLDAP | これをオンにすると、Liferay DXPに存在しないOpenAMから認証されたユーザがLDAPからインポートされます。 LDAPを有効にする必要があります。 | boolean |
| ログインURL | loginURL | OpenAMサーバーのログインページへのURL | String |
| ログアウトURL | logoutURL | OpenAMサーバーのログアウトページへのURL | String |
| サービスURL | serviceURL | 認証されたWebサービスを使用するためにOpenAMにアクセスできるURL。 OpenAM Express 8以降を使用している場合は、サーバーでJava 6を実行する必要があります。 | String |
| スクリーン名の属性 | screenNameAttr | ユーザーの画面名を表すOpenAM上の属性の名前 | String |
| 電子メール アドレス属性 | emailAddressAttr | ユーザーの電子メールアドレスを表すOpenAM上の属性の名前 | String |
| 名の属性 | firstNameAttr | ユーザーの名を表すOpenAM上の属性の名前 | String |
| 姓の属性 | lastNameAttr | ユーザーの姓を表すOpenAM上の属性の名前 | String |
特定のポータル インスタンスのこれらのデフォルト設定を上書きするには、コントロール パネルに移動し、 インスタンス設定 → SSO をクリックします。次に、左側のリストから OpenSSO を選択します。