checkHash (Hash Filter)
- 印刷する
- PDF
checkHash (Hash Filter)
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
概要
- chechHash APIは「File Safer」の「Hash Filter」が提供する機能で、Hash値を利用して悪意の有無を確認する APIです。
- この APIは NAVERクラウドプラットフォームで使用する IAM認証と API Gatewayを通して使用できます。
リクエスト
| Method | Request URI |
|---|---|
| GET | https://filesafer.apigw.ntruss.com/hashfilter/v1/checkHash |
リクエストヘッダ
| ヘッダ名 | 説明 |
|---|---|
| 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を使用 |
| accept | jsonを指定application/json |
リクエストパラメータ
| パラメータ名 | 必須有無 | タイプ | 説明 |
|---|---|---|---|
| hashCode | Yes | string | 照会したい Hash値 |
| hashType | Yes | string | 照会したい Hashを抽出したアルゴリズムを区別値として md5、sha1をサポートsha1 or md5 |
レスポンス
レスポンスボディ
| フィールド名 | 必須有無 | タイプ | 説明 |
|---|---|---|---|
| returnCode | Yes | string | リクエストに対する処理結果コード |
| returnMessage | Yes | string | リクエストに対する処理結果メッセージ |
| totalRows | Yes | int | hashCheckResultListの object数 |
| hashCheckResultList | Yes | List | - 照会した Hashに該当する検出件に関する情報 リストに objectがある場合: 악성코드リストに objectがない場合: 정상 |
| hashType | No | string | 악성코드로 탐지된 경우에만 포함hashcodeのアルゴリズム区分で、MD5、SHA-1をサポート |
| hashCode | No | string | 악성코드로 탐지된 경우에만 포함検出された Hash値 |
| group | No | String | 악성코드로 탐지된 경우에만 포함検出された Hash値が File objectの値である場合は「file」で表記され、URLの文字列である場合は「url」で表記 |
| result | No | string | 악성코드로 탐지된 경우에만 포함照会した Hashが検出された場合は「1」、検出されなかった場合は「0」の値を持つ |
| regDatetime | No | long | 악성코드로 탐지된 경우에만 포함Hash値が登録された時間 |
例
リクエスト例
curl -X GET "https://filesafer.apigw.ntruss.com/hashfilter/v1/checkHash?hashCode=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",
"totalRows": 1,
"hashCheckResultList": [
{
"hashType": "sha1",
"hashCode": "f093e7767bb63ac973b697d3fd1d40a78b87b8bf",
"group": "file",
"result": "1",
"regDatetime": 1497409737000
}
]
}
レスポンス例(マルウェアとして検出されなかった場合)
{
"returnCode": "0",
"returnMessage": "success",
"totalRows": 0,
"hashCheckResultList": [
]
}
この記事は役に立ちましたか?