跳到正文

漏洞 CVENO 检索样本查询

接口说明

该接口用于通过文件样本的CVE编号(CVE编号:在样本被发现安全漏洞时上报并关联的漏洞编号。),查询与之关联的MD5值(MD5是根据文件内容计算出的哈希值),通过添加limit键值对,可以设定返回数据的条数,上限为500。

推荐应用场景

用于后台管理和风控系统

请求地址

https://api.f.360.cn/files/std/internal/v2/cveno2md5

请求方法

POST

请求参数

参数名类型位置是否必填示例值说明
queryobjectbody是
{
  "keywords": [
    {
      "field": "cve_no",
      "value": "CVE-1999-0009"
    },
    {
      "field": "limit",
      "value": "10"
    }
  ]
}
查询条件,所有请求参数的父级结构 枚举说明
query.keywordsArray(object)body是
[
  {
    "field": "cve_no",
    "value": "CVE-1999-0009"
  },
  {
    "field": "limit",
    "value": "10"
  }
]
查询条件,所有请求参数的子级结构
query.keywords[].fieldstringbody是cve_no查询条件的字段名,支持的字段有:cve_no
query.keywords[].valuestringbody是CVE-1999-0009查询条件的字段值,为具体的cve_no
query.keywords[].fieldstringbody否limit需要限制返回的数据的条数,默认10条,最大500条. 仅支持limit
query.keywords[].valuestringbody否2返回的数据的条数

参数请求示例

POST  /files/std/internal/v2/cveno2md5 HTTP/1.1
Content-Type:application/json
Host: {{host}}
 
{
  "query": {
      "keywords": [
	          {
              "field": "cve_no",
              "value": "CVE-1999-0009"
          },
          {
              "field": "limit",
              "value": "10" 
          }
      ]
  }
}

响应参数

名称类型示例值描述
codestring0响应状态码 枚举说明
msgstringok响应状态信息
dataArray(string)
[
  "6f0682ace8d90f1a235bd93d36f6447f",
  "f19ec10792941e569eff204cffd1a214"
]
md5列表

请求示例

支持cUrl、Python、Java、PHP、Go语言的请求,示例如下

#!/usr/bin/env bash
set -euo pipefail

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/files/std/internal/v2/cveno2md5"
BODY='{"query":{"keywords":[{"field":"cve_no","value":"CVE-1999-0009"},{"field":"limit","value":"10"}]}}'

NONCE=$(printf '%08d' $((RANDOM % 100000000)))
TIMESTAMP=$(date +%s)
BODY_MD5=$(printf '%s' "$BODY" | openssl dgst -md5 -hex | awk '{print $NF}')
SIGNATURE=$(printf '%s' "${BODY_MD5}${APPID}${NONCE}${TIMESTAMP}${SECRET}" | openssl dgst -md5 -hex | awk '{print $NF}')
SIGNATURE=${SIGNATURE:16}

curl --location --request POST "$URL" \
  --header "Content-Type: application/json" \
  --header "X-360-Key: ${APPID}" \
  --header "X-360-Nonce: ${NONCE}" \
  --header "X-360-Timestamp: ${TIMESTAMP}" \
  --header "X-360-Signature: ${SIGNATURE}" \
  --data "${BODY}"

响应示例

业务正常响应

{
    "_oid": 1,
    "code": "0",
    "data": [
        "6f0682ace8d90f1a235bd93d36f6447f",
        "f19ec10792941e569eff204cffd1a214"
    ],
    "msg": "ok",
    "status": 0
}

业务异常响应

{
  "code": "GS00301",
  "msg": "param missing"
}

错误码说明

错误码错误消息解决办法
0success成功
AC11001The id is not existed输入一个存在的id
AC11002The app is not authed申请授权的app id(即APIKEY)