getInputFileLog (File Filter)

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

概要

getInputFileLog APIは、「File Safer」の「File Filter」で提供する機能で inputFile APIを利用して分析リクエストされたファイルの分析結果を確認する APIです。
この APIは NAVERクラウドプラットフォームで使用する IAM認証と API Gatewayを通して使用できます。

リクエスト

Method	Request URI
GET	`https://filesafer.apigw.ntruss.com/filefilter/v1/getInputFileLog`

リクエストヘッダ

ヘッダ名	説明
x-ncp-apigw-timestamp	1970年1月1日 00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表したもの API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
x-ncp-apigw-api-key	API Gatewayから発行されたキー
x-ncp-iam-access-key	NAVERクラウドプラットフォームから発行された API Keyまたは IAMから発行された AccessKey
x-ncp-apigw-signature-v2	リクエストパスとヘッダを AccessKeyとマッピングされる SecretKeyで暗号化した署名として HMAC暗号化アルゴリズムは HmacSHA256を使用 IAM認証が必要な APIを呼び出すを参照
accept	jsonを指定します。 `application/json`

リクエストパラメータ

パラメータ名	要否	タイプ	説明
hash	Yes	string	照会したい Hash値
hashType	Yes	string	照会したい Hashを抽出したアルゴリズムを区別値として md5、sha1をサポート `sha1` or `md5`

レスポンス

レスポンスボディ

フィールド名	要否	タイプ	説明
returnCode	Yes	string	リクエストに対する処理結果コード
returnMessage	Yes	string	リクエストに対する処理結果メッセージ
inputFileLogList	Yes	string	分析結果リストであり、同じ Hashのファイルが 2回以上分析された場合にリストで表記
fileType	No	string	`分析されたファイルがある場合にのみ含まれる` 分析したファイルのフォーマット表記
fileSize	No	int	`分析されたファイルがある場合にのみ含まれる` 分析したファイルのサイズ
md5	No	string	`分析されたファイルがある場合にのみ含まれる` 分析したファイルの MD5 Hash値
sha1	No	string	`分析されたファイルがある場合にのみ含まれる` 分析したファイルの SHA1 Hash値
sha256	No	string	`分析されたファイルがある場合にのみ含まれる` 分析したファイルの SHA256 Hash値
analysisStatusCode	No	string	`分析されたファイルがある場合にのみ含まれる` 分析状態コードで、次の値をもつ [ Code : Desc : Status ] IPRG: Analyzing: 分析中 CMPL: Analysis completed: 分析完了 ERR: Analysis error: エラー EXCN: Exclude analysis: 例外
analysisResultCode	No	string	`分析されたファイルがある場合にのみ含まれる` 分析結果コードで、次の値をもつ [ Code : Desc : Status ] M: Malware detected: マルウェア(Hash Filterにアップデート) N: Malware not detected: 正常なファイル E: Detection error: エラー
notifyYmdt	No	long	`分析されたファイルがある場合にのみ含まれる` 通知を設定した場合、通知が送信された時間
registrationYmdt	No	long	`分析されたファイルがある場合にのみ含まれる` ファイルがインポートされた時間
serviceCode	No	string or null	`分析されたファイルがある場合にのみ含まれる` 特定の分析リクエストの場合のみ表記され、ほとんどの場合 null値が表記
applicationCode	No	string or null	`分析されたファイルがある場合にのみ含まれる됨` 特定の分析リクエストの場合のみ表記され、ほとんどの場合 null値が表記

例

リクエスト例

curl -X GET "https://filesafer.apigw.ntruss.com/filefilter/v1/getInputFileLog?hash=f093e7767bb63ac973b697d3fd1d40a78b87b8bf&hashType=sha1"
   -H "accept: application/json"
   -H "x-ncp-apigw-api-key: {x-ncp-apigw-api-key}"
   -H "x-ncp-iam-access-key: {x-ncp-iam-access-key}"
   -H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}"
   -H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"

レスポンス例(分析したファイルがある場合)

{
  "returnCode": "0",
  "returnMessage": "success",
  "inputFileLogList": [
    {
      "fileType": "application/x-msdownload; format=pe32",
      "fileSize": 740544,
      "md5": "a69acb01b99959efec7c0a2a8caa7545",
      "sha1": "f093e7767bb63ac973b697d3fd1d40a78b87b8bf",
      "sha256": "470a75fe3da2ddf9d27fb3f9c96e6c665506ea7ba26ab89f0c89606f678ae4a2",
      "analysisStatusCode": "CMPL",
      "analysisResultCode": "M",
      "notifyYmdt": 1544005507000,
      "registrationYmdt": 1544005472000,
      "serviceCode": null,
      "applicationCode": null
    },
    {
      "fileType": "application/x-msdownload; format=pe32",
      "fileSize": 740544,
      "md5": "a69acb01b99959efec7c0a2a8caa7545",
      "sha1": "f093e7767bb63ac973b697d3fd1d40a78b87b8bf",
      "sha256": "470a75fe3da2ddf9d27fb3f9c96e6c665506ea7ba26ab89f0c89606f678ae4a2",
      "analysisStatusCode": "CMPL",
      "analysisResultCode": "M",
      "notifyYmdt": 1544006407000,
      "registrationYmdt": 1544006150000,
      "serviceCode": null,
      "applicationCode": null
    },
  ]
}

レスポンス例(分析したファイルがない場合)

{
  "returnCode": "0",
  "returnMessage": "success",
  "inputFileLogList": [
  ]
}

この記事は役に立ちましたか?

What's Next

getInputFileLogByParentHash

概要
リクエスト
レスポンス
例

タグ

File Safer