Security Center:CreateFileDetect

この操作は、ファイルをクラウドに送信して検出するために使用します。悪意のあるファイルの検出とスキルアーカイブの検出という 2 つのシナリオをサポートしています。

ファイルの送信方法

ファイルを送信するには、事前アップロードまたはダウンロードリンクの提供のいずれかの方法を使用します。

事前アップロード方式を使用する場合は、この操作を呼び出す前にファイルが正常にアップロードされていることを確認してください。ファイルのアップロード方法の詳細については、CreateFileDetectUploadUrl 操作をご参照ください。

ダウンロードリンクを使用する場合は、`DownloadUrl` パラメーターでパブリックにアクセス可能な URL を指定します。

悪意のあるファイルの検出シナリオでは、両方の方法がサポートされています。スキルアーカイブの検出シナリオ (`Type` が `6` の場合) では、事前アップロード方式はサポートされていないため、ダウンロードリンクを提供する必要があります。

一意の識別子

ファイル検出に関連するすべての API オペレーションには、`HashKey` パラメーターが含まれています。このパラメーターは、検出タスクに対するファイルの一意の識別子を指定します。この識別子を使用して結果をクエリします。

スキルアーカイブの検出 (`Type` が `6` の場合) では、事前に `HashKey` を計算する必要はありません。この操作は、ファイルの一意の識別子としてグローバルに一意な UUID を返します。この識別子を使用して結果をクエリできます。

悪意のあるファイルの検出 (`Type` が `0` の場合) では、この操作を呼び出す前に `HashKey` を計算する必要があります。`HashKey` の値は、ファイル全体の MD5 ハッシュまたは SHA-256 ハッシュである必要があります。

ファイルの MD5 ハッシュまたは SHA-256 ハッシュを計算するには、次の手順に従います。

1. MD5 または SHA-256 アルゴリズムを使用して、128 ビットまたは 256 ビットのハッシュ値を生成します。Java の `MessageDigest` や Python の `hashlib` ライブラリなどの一般的なライブラリを使用できます。

2. ハッシュ値を 16 進数文字列にエンコードします。Java の `Codec` ユーティリティや Python の `hex()` 関数などのツールを使用できます。最終的な文字列が数字と小文字のみで構成されていることを確認してください。MD5 ハッシュは 32 文字、SHA-256 ハッシュは 64 文字の長さです。

注：ファイルを検出のために送信するときと、結果をクエリするときは、同じ `HashKey` 値を使用する必要があります。そうしないと、送信とクエリの両方が失敗します。