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

CORSの設定

CORSは、クロスオリジンリソース共有（Cross-Origin Resource Sharing）の略です。オリジンとは別のドメインにあるWebサーバーであり、リソースは画像、PDF、HTMLファイルなど、サーバーに保存されているアセットです。別のオリジンに保存されているリソースを要求する必要がある場合があります。これはクロスオリジン要求と呼ばれ、Webサーバーにはそのような要求を許可または拒否するポリシーがあります。

たとえば、ブラウザ自体は、クロスサイトスクリプティング（XSS）攻撃を軽減するために、スクリプトからのクロスオリジン AJAX スタイルのリクエストを許可しません。これらのAPIは同一オリジンのポリシーに従います。ただし、特定のリソースについては、Liferay DXPがそれらを異なるオリジンに提供できるようにすると便利な場合があります。

たとえば、ドキュメント & メディアで画像を管理する場合、それらの画像に対してクロスオリジンリクエストを許可する必要がある場合があります。 Liferay DXP 内の一致する URL または JAX-RS アプリケーションリソースに対して CORS を有効にすることができます。

Liferay DXPサービス用にCORSを有効にする

これらの設定にアクセスするには、

グローバルメニュー () を開き、 コントロールパネル → インスタンス設定に移動します。
セキュリティ → セキュリティツール → ポータルクロスオリジン共有 (CORS)に移動します。
［Add］をクリックして構成エントリを作成します。
フォームのフィールドに入力します。
[保存]をクリックします。

CORS システム設定は、Liferay サービスの CORS ヘッダーを構成する方法を提供します。

ポータルCORS構成リファレンス

設定	説明
有効	エントリを有効にするには、このボックスをオンにします。
名前	構成エントリに名前を付けます。
URLパターン	プラスボタンを使用して、必要な数のパターンを追加します。共有するリソースへのURLと一致するパターンを定義します。たとえば、ナレッジベースアプリケーションに多くの添付ファイルがある場合、パターン `/knowledge_base/*` を定義できます。これにより、以下の応答ヘッダーで設定したポリシーに適用できるように、ナレッジベースに格納されているリソースが定義されます。
CORS応答ヘッダー	プラスボタンを使用して、必要な数のヘッダーを追加します。ここで、 CORS ヘッダーのいずれかのポリシーを定義します。

設定ファイルを使用することもできます CORS を設定します。

注

システム設定の仮想インスタンススコープの下に、ポータルクロスオリジンリソース共有 (CORS) エントリもあります。これには、仮想インスタンスに対してすでに有効になっているデフォルトのポータル CORS 構成が含まれています。

JAX-RSアプリケーション用にCORSを有効にする

これらの設定にアクセスするには、

グローバルメニュー () を開き、 コントロールパネル → システム設定に移動します。
セキュリティ → セキュリティツール → Web コンテキストクロスリソースオリジン共有 (CORS)に移動します。
［Add］をクリックして構成エントリを作成します。
フォームのフィールドに入力します。完了したら、 「保存」をクリックします。

JAX-RS CORS構成リファレンス

設定	説明
動的WebコンテンツのOSGiフィルター	LDAP スタイルのフィルターを定義して、このエントリの CORS ヘッダーが適用される JAX-RS ホワイトボードアプリケーションを定義します。デフォルトのフィルターは `(&(!(liferay.cors=false))(osgi.jaxrs.name=*))` です。このフィルターは、CORSヘッダーを、`liferay.cors=false` プロパティなしでデプロイされたすべてのJAX-RSホワイトボードアプリケーションに適用します。これは開発時に役立ちますが、本番環境では可能な限り狭い構成を使用してください。
URLパターン	プラスボタンを使用して、必要な数のパターンを追加します。アクセスするWebサービスへのURLに一致するパターンを定義します。
CORS応答ヘッダー	プラスボタンを使用して、必要な数のヘッダーを追加します。ここで、 CORS ヘッダーのいずれかのポリシーを定義します。