メディアハンドラー
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecoreヘッドレス サービス メディア ハンドラーは、Sitecoreがメディア リクエストを処理する方法の設定をサポートしています。
Sitecoreサーバー側のメディアサイズ変更をJavaScript <Image/> ヘルパー コンポーネントのimageParamsプロパティまたはsrcSetプロパティと共に使用すると、多くの任意のディメンションを持つイメージを再スケーリングすることで、Sitecoreサーバーがサービス拒否攻撃にさらされる可能性があります。
ホワイトリストは、不明なサイズ変更パラメータセットを拒否します。アプリケーションコンポーネントで使用される画像サイズ設定パラメータのセットは、ホワイトリストに登録する必要があります。パラメータ セットがホワイトリストに登録されていない場合、サーバはイメージwithout resizing itを返します。
メディアハンドラの設定
ヘッドレス サービス メディア ハンドラを使用するには、Web.configで設定パッチを提供する必要があります。設定パッチは 、ヘッドレスサービスモジュールをインストールすると自動的に適用されます。
別のインストール プロセスに従った場合、Sitecoreにヘッドレス サービス メディア ハンドラーを使用するように指示するには、次の手順を実行します。
-
コンテンツ配信サーバーの ./Web.configファイルの <handlers /> ノードに、次のキーを追加します。
RequestResponse<add verb="*" path="sitecorejss_media.ashx" type="Sitecore.JavaScriptServices.Media.MediaRequestHandler, Sitecore.JavaScriptServices.Media" name="Sitecore.JavaScriptServices.Media.MediaRequestHandler" />
ホワイトリスト画像のサイズ変更パラメータ
サイズ変更パラメータセットをホワイトリストに登録し、レスポンシブ表示の画像サイズ変更を有効にするには:
-
Sitecore設定の <allowedMediaParams /> ノードで、必要なサイズ パラメーターをホワイトリストに登録します。例えば：
RequestResponse<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/"> <sitecore> <javaScriptServices> <!-- You can use configuration patch(es) to add sets of media parameters that should be allowed without a request protection hash in the URL. Parameter order is not important. --> <allowedMediaParams> <example>mw=100,mh=50</example> <example2>mw=100</example2> <example3>mw=101,mh=51</example3> </allowedMediaParams> </javaScriptServices> </sitecore> </configuration>
使用されているイメージ パラメータを確認するには、レンダリングされたイメージのsrc属性のクエリ文字列を確認します。たとえば、値が /img.jpg?mw=100&h=50の画像src属性がある場合、comma-delimitedパラメータ セットmw=100,h=50をホワイトリストに登録する必要があります。レスポンシブ画像の使用についての詳細をご覧ください。