1. Sitecore Content Hub

ウイルス対策のスキャンをセットアップしてください

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

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

!注Content Hubを設定するには、スーパーユーザーであるか、ユーザーグループポリシーを通じて必要な権限が付与されている必要があります。

Sitecore Content Hubには、ユーザーがCreationコンポーネント やExcelインポートを通じてアセットをアップロードすると起動するアンチウイルススキャン機能があります。アンチウイルスパッケージの一部として、この機能はウイルスや有害なアイテムのスキャンを行います。

!重要当社のアンチウイルススキャン機能は独立したツールではなく、アンチウイルスパッケージの一部です。使用するには、独自のアンチウイルスツールをプロビジョニングし、Content Hub内のアンチウイルススキャンと統合する必要があります。

アンチウイルス機能が有効になり、アセットをアップロードすると、アップロードされたファイルにはウイルススキャン結果の価値が割り当てられます。この値はアセット詳細ページの システム タブに表示され、以下のいずれかのものになります。

  • Ok - スキャンが通過するか、ウイルス対策が無効化される。ファイルをダウンロードできる。

  • Unknown - ウイルス対策機能が有効ですが、外部タスクは設定されていません。ファイルをダウンロード可能です。

  • Pending - ウイルス対策スキャンがまだ完了していないこと。ウイルス対策スキャンの設定方法によっては、関連する資産の引き渡しステータスやM.Fileエンティティの定義も「 Pending」とマークされることがあります。ファイルをダウンロードすることはできません。

    !注外部処理タスクのフォーマットが不適切になっていたり、外部タスクからのリクエストが成功しなかったり、ウイルス対策スキャンが有効なContent Hub応答を返さなかった場合、ウイルススキャンの結果と関連する バックグラウンド処理ジョブ は、ジョブ内の他のすべてのタスクが完了していてもPending状態のままになります。

  • Malicious - ウイルスが検出されました。ファイルをダウンロードできません。

  • Error - ウイルス対策スキャンに失敗しました。ファイルをダウンロードできません。

このウォークスルーでは、以下の方法を説明します:

  1. ウイルス対策スキャンを有効にしてください
  2. メディア処理セットの作成
  3. 外部ウェブタスクを設定しましょう
  4. M.MediaMatrixエンティティの設定
  5. ウイルス対策スキャンを完了してください
  6. 悪意のあるファイルアラートトリガーをテストしてください

ウイルス対策スキャンを有効にしてください

アンチウイルススキャンを有効にするには:

  1. メニューバーで 「管理 」をクリックします。

  2. 管理ページで設定をクリックします。

  3. 設定ページでAntivirusSettingを探してクリックします。

  4. AntivirusSettingのセクションで、エディターモードをtrueに変更し、antivirusEnabledフラグをtrueに設定します。

    { "antivirusEnabled": true, "renditionBagsToClear": "Renditions", "ExtraRenditions" , "renditionsToMarkMalicious": { "Renditions": "thumbnail", "thumbnail_cropped", "preview" , "ExtraRenditions": }, "flowOnly": false }

  5. 「保存」をクリックします。

メディア処理セットの作成

メディア処理セットを作成するには:

  1. メニューバーで 「管理 」をクリックします。
  2. 管理 ページで 「 メディア処理」をクリックします。
  3. メディア処理ページで「新しいセット」をクリックします。
  4. 新しい集合ダイアログでは、例えば適切な名前を入力してください。Antivirus。
  5. オプションで、このセットをすべての新しいアセットに自動適用したい場合は、 自動実行 スイッチをオンにしてください。
  6. 「作成」をクリックします。

外部ウェブタスクを設定しましょう

ウイルス対策スキャン機能は外部サービスAPIに呼び出しを行うため、関連するメディアフローのためにM.MediaMatrixエンティティで設定されたRunExternalWebTask処理タスクが必要です。

!注外部ウェブタスクとは、Content Hubがファイル処理で使用し、あらかじめ定義された変換( レンディション)を作成するためのウェブフックです。

外部ウェブタスクを設定するには:

  1. メニューバーで 「管理 」をクリックします。
  2. 管理 ページで 「 メディア処理」をクリックします。
  3. メディア処理ページで作成したセット(例:Antivirus)をクリックし、その後「**フローを追加」**をクリックします。
  4. フロー設定ダイアログで、名前欄に名前を入力してください。例えばAntivirus。
  5. フローで特定のファイルタイプだけをスキャンしたい場合は、 ファイルタイプ 欄に zip、 7z、 tar、 gzなどのタイプを入力してください。
  6. 「保存」をクリックします。
  7. メディア処理セットの詳細ページで、新しいフローをクリックします。
  8. 新しいフローの詳細ページで:mdiPlusCircle
    、右側のペインで 「外部ウェブタスクを実行する」をクリックしてください。
  9. パラメータタブで、以下のようにフィールドを埋めてください:
    • 名前 - Antivirusを入力してください。
    • 内容タイプ - 空欄のままにしてください。
    • 内容の配置 - リストから 添付ファイルをクリックしてください。
    • URL - お好みの外部ウイルス対策サービスへのURLを入力してください。
  10. 出力タブで出力を有効にするにはストア出力スイッチをオンにし、以下のようにフィールドを埋めてください:
    • 出力タイプ - ドロップダウンリストの Property をクリックします。
    • プロパティ - ドロップダウンリストの Virusscan result をクリックします。
  11. タスク を保存し、その後 保存 して 閉じます。
  12. 「公開」をクリックします。

M.MediaMatrixエンティティの設定

M.MediaMatrixエンティティを設定する前に、まずURLに表示されるメディアセットIDを取得しなければなりません。

メディアセットIDを取得するには:

  1. メニューバーで 「管理 」をクリックします。

  2. 管理 ページで 「 メディア処理」をクリックします。

  3. メディア処理ページで、リスト内のメディアセットのいずれかをクリックしてください。

  4. URLの最後に表示されるIDをコピーします。以下の例では、コンテンツ メディアセットのIDは1014です。

    `https:///en-us/admin/media-processing-mgmt?mediaMatrixManagementSelectedMatrix=1014`

M.MediaMatrixエンティティを設定するには:

  1. 管理ページで「エンティティ」をクリックします。

  2. エンティティページのURLに付け加え、**/entity/**を付け加えてメディアセットIDを付け加え、Enterキーを押します。

    https:///en-us/admin/entitymgmt/entity/1014

  3. エンティティ詳細ページの****システムタブで、「編集」をクリックしてください。

  4. 変換行列JSONを変更するには、ドロップダウンリストのマトリックスセクションからTextをクリックしてください。

  5. 例えばアーカイブのアンチウイルスを設定するには、Archivesノードを検索し、タスクの先に以下のJSONコードがあることを確認してください。

    "antivirus": { "type": "RunExternalWebTask", "do update": true, "input": "source", "output": "antivirus", "outputfileprovider": "local", "contentdisposition": "attachment", "url": "http://beeceptor.com/console/testsitecore-antivirus", "parameters": {}, "headers": {} }

    同じ手順は、アンチウイルスを設定したい他のカテゴリにも当てはまります。

  6. アーカイブノードの****メタデータエントリに以下のようにアンチウイルス依存関係を追加します:

    "deps": "antivirus"

  7. スキャン出力はファイルのアンチウイルスプロパティに以下のように保存します:

    "properties": { "VirusScanResult": "antivirus" }

  8. 「保存」をクリックします。

ウイルス対策スキャンを完了してください

完全にするためには、ウイルス対策スキャンがContent Hubに有効な応答を返す必要があります。これが事実かどうかは 、POSTリクエストを送信することで確認できます。

ウイルス対策スキャンを完了するには:

  1. アセットをアップロードします。これにより外部ウェブタスクがトリガーされ、本文に以下の形式のリクエストが送信されます。

    { "callback": "https://callback-url", "sources": "https://blob-sas-url" , "parameters": {} }

  2. SendコールバックURLへの以下のリクエスト本文を含むPOSTリクエストを用意します。

    { "value": "Malicious" }

リクエスト本体の値は、以下のいずれかである場合があります。

  • Malicious - 問題が検出されました。
  • Ok - 問題は見つかりませんでした。
  • Error - ウイルス対策スキャンが失敗した。

POSTリクエストが成功すれば、アンチウイルスは期待通りに動作しています。Content Hub POSTリクエストに応答がなければ、VirusScanResultと対応する処理ジョブはPending状態のままです。

!注Content HubインターフェースのCreationコンポーネント やExcelインポートを通じてアセットをアップロードした場合、選択したアンチウイルスサービスがファイルが悪意あると判断した場合、ファイル詳細ページにダウンロードが無効化されたという警告が表示されます。この場合、ファイルのサムネイルや関連する描写はプレースホルダーに置き換えられます。

悪意のあるファイルアラートトリガーをテストしてください

APIコールを使えば、ファイルが悪意あるとフラグが立てられたときに何が起こるかをテストできます。

悪意のあるファイルアラートトリガーをテストするために:

  1. URLをhttp://beeceptor.com/console/testsitecore-antivirusのようなAPIエンドポイントに設定します。

  2. 外部ウェブタスクをトリガーするためにアセットをアップロードします。リクエスト本体の形式は以下の通りです:

    { "callback": "https://callback-url", "sources": "https://blob-sas-url" , "parameters": {} }

  3. エンドポイントからコールバックURLをコピーします。

  4. Sendは以下のコードを含むPOSTリクエストをコールバックURLに送ります:

    { "value": "Malicious" }

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