OpenAMの使用

Liferay DXP 2024.Q4/Portal GA129 で廃止

OpenAMは、SunのSystem Access Manager製品のコードベースから提供されるオープンソースのシングルサインオンソリューションです。 OpenAMを使用して、IDのさまざまなリポジトリに対するいくつかの異なる認証スキームを含むインフラストラクチャーにLiferay DXPを統合できます。

インストールに関する注記

ドキュメントの指示に従ってOpenAMをインストールしてください。 OpenAMはアプリケーション間のCookie共有に依存していることに注意してください。 したがって、OpenAMが機能するためには、SSOを必要とするすべてのアプリケーションが同じWebドメインにある必要があります。 一部のWebコンテナ（Apache Tomcat™など）が特殊文字を含むCookieを解析するためにHTTPOnly Cookieを有効にしている場合は、次のプロパティも追加する必要があります。

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の場合、IDが admin で、ポータルプロパティ admin.email.from.address で指定されたメールアドレスを使用して、OpenAMにユーザーを登録します。 ユーザーを設定したら、このユーザーを使用してOpenAMにログインします。

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

4. コントロール パネルに移動し、 構成 → インスタンス設定 → セキュリティ → SSOをクリックします。 次に、左側のリストで［OpenSSO］を選択します。

   

5. OpenAMサーバーを指すように3つのURLフィールド（［Login URL］、［Logout URL］、および［Service URL］）を変更し（つまり、URLのホスト名部分のみを変更）、［Enabled］ チェックボックスをオンにして、［保存］をクリックします。

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

別のLiferayスコープでOpenAMを構成する

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

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

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

2. 構成 → システム設定 → セキュリティ → SSO → OpenSSOをクリックします。 以下の設定が表示されます。 ここで設定されている値は、すべてのポータルインスタンスのデフォルト値です。 リテラル値を使用してJavaプリミティブ型を初期化する場合と同じ形式で入力します。

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