サービスとAPI

メディアハンドラー

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecoreヘッドレスサービスメディアハンドラーは、Sitecoreがメディアリクエストをどのように処理するかの設定をサポートします。

サーバー側Sitecoreメディアリサイズを、JavaScript ヘルパーコンポーネントのimageParamsやsrcSetプロパティを用いると、多くの任意の寸法を持つ画像をリスケーリングし、サービス拒否攻撃(DoS)攻撃にSitecoreサーバーをさらす可能性があります。

ホワイトリストは未知のリサイズパラメータセットを拒否します。アプリケーションコンポーネントで使用される画像のサイズパラメータセットはホワイトリスト化しなければなりません。パラメータセットがホワイトリスト化されていない場合、サーバーはサイズ 変更せずに画像を返します。

メディアハンドラーの設定

ヘッドレスサービスメディアハンドラーを使用するには、Web.configで設定パッチを提供する必要があります。設定パッチはヘッドレスサービスモジュールをインストールすると自動的に適用されます。

もし別のインストール手順を踏んで、SitecoreにHeadless Services Media Handlerの使用を指示した場合:

コンテンツデリバリーサーバーの ./Web.configファイルのノードに、次のキーを追加します:

ホワイトリスト画像のサイズ調整パラメータ

パラメータセットのサイズ変更をホワイトリストにし、レスポンシブ表示用の画像リサイズを有効にするには:

Sitecore構成の中、ノードで必要なサイズパラメータをホワイトリストに設定してください。例えば:

<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属性が与えられたとき、カンマ区切りパラメータセットをホワイトリストにしなければなりませんmw=100,h=50。レスポンシブ画像の使い方について詳しくはこちらをご覧ください。

この記事を改善するための提案がある場合は、お知らせください!