跳到正文

样本网络行为查询

接口说明

根据样本文件hash的md5查询网络行为,主要10种通讯行为(通讯协议)http,dns,adb,usb,ftp,ghost,smtp,icmp,tcp,udp的目的IP和端口,域名,URL,数据包长度,数据包大小,提交方式,客户端基本信息等。可选择添加字段startDate、endDate控制网络行为数据的时间范围。

请求地址

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

请求方法

POST

请求参数

参数名类型位置是否必填示例值说明
queryobjectbody是
{
  "keywords": [
    {
      "field": "md5",
      "value": "0000fafed5a62f93e7c31c001f83f575"
    },
    {
      "field": "limit",
      "value": "10"
    }
  ]
}
查询条件,所有请求参数的父级结构
query.keywordsArray(object)body是
[
  {
    "field": "md5",
    "value": "0000e75ad071b5b5a7a35a0ba42c35c5"
  },
  {
    "field": "limit",
    "value": "10"
  }
]
查询条件,所有请求参数的子级结构
query.keywords.[0].fieldstringbody是md5查询条件的字段名,支持的字段有:md5
query.keywords.[0].valuestringbody是0000e75ad071b5b5a7a35a0ba42c35c5查询条件的字段值
query.keywords.[1].fieldstringbody否startDate查询控制字段,支持的key为startDate,控制网络行为数据的开始日期
query.keywords.[1].valuestringbody否“202110”日期格式:“yyyyMM”,默认值:近36个月
query.keywords.[2].fieldstringbody否endDate查询控制字段,支持的key为endDate,控制网络行为数据的结束日期
query.keywords.[2].valuestringbody否“202112”日期格式:“yyyyMM”,默认值:当前时间

响应参数

名称类型示例值描述应用说明
codeinteger0返回代码
dataobject
data.additionalobject除以上网络行为外的一些额外补充
data.additional.related_catstring456gameAD下行报文当中设置的NDCAT域的标识符(ND Category);云端下发进程相关的标记
data.additional.related_domainstringandroidworldit.disqus.comDNS反查域名 : nd.ip在本地缓存里反查出的域名
data.ConnectArray(object)未知的通讯协议
data.Connect.ipstring87.5.4.3网络访问目标IP
data.Connect.portstring9887网络访问目标端口
data.dnsArray(object)通讯协议的一种
data.dns.domainstringwwww.so.com域名
data.dns.ipstring31.130.251.70网络访问目标IP
data.ghostArray(object)通讯协议的一种
data.ghost.hdatastring27ed2408...Ghost远控协议数据包头部数据Hex值,前256字节,hex编码
data.ghost.ipstring12.43.56.88网络访问目标IP
data.ghost.portstring7654网络访问目标端口
data.httpArray(object)通讯协议的一种
data.http.methodstringPOSTHTTP协议Method协议只要有:'GET', 'POST', 'HEAD', 'PUT', 'DELETE',
data.http.portstring8090网络访问目标端口
data.http.refernumberhttp://so.com/index.htmlHTTP Referer,父通讯地址
data.http.urlstringhttp://so.com/index.htmlHttp Url,完整URL
data.httpsArray(object)通讯协议的一种
data.https.ipstring31.130.251.70网络访问目标IP
data.https.methodstringPOSTHTTPS协议Method协议只要有:'GET', 'POST', 'HEAD', 'PUT', 'DELETE',
data.https.portstring9087网络访问目标端口
data.https.urlstringhttp://so.com/index.htmlHttp Url,完整URL
data.icmpArray(object)通讯协议的一种
data.icmp.ipstring43.43.5.6网络访问目标IP
data.icmp.portstring9809网络访问目标I端口
data.tcpArray(object)通讯协议的一种
data.tcp.ipstring32.56.4.2网络访问目标IP
data.tcp.portstring8865网络访问目标端口
data.udpArray(object)通讯协议的一种
data.udp.ipstring43.2.1.3网络访问目标IP
data.udp.portstring6579网络访问目标端口
msgstringok
statusinteger0

请求示例

支持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/network_behavior"
BODY='{"query":{"keywords":[{"field":"md5","value":"00eac5b6fb1f31292898e7c51640ee40"}]}}'

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": {
      "additional": {
        "dltool": {
           "1": 820,
            "1001": 8,
            "1002": 2,
            "1003": 3
        },
        "related_cat":[
          "powershell",
          "sp_all"
        ],
        "related_domain": [
          "198.198.198.254",
          "99.98.54.105",
          "rpraqmrigh.com",
          "api-sh33-1.hprtcloud.com"
        ],
        "self_cat": [
          "powershell",
          "spoolsv_cloud",
          "powershell,powershell",
          "ldsmaster",
          "stratumssl",
          "sp_all",
          "yuankong_gray"
        ]
      },
      "dns":[
          {
                "domain": "192.168.1.18",
                "ip": "0.0.0.0",
                "topdomain": ""
          },
          {
                "domain": "192.168.1.107",
                "ip": "0.0.0.0",
                "topdomain": ""
          },
          {
                "domain": "192.168.110.197",
                "ip": "0.0.0.0",
                "topdomain": ""
          }
      ],
      "ftp": [
         {
                "ip": "117.135.214.14",
                "port": "110",
                "source": "ycs"
          }
      ],
      "ghost":[
            {
                "hdata": "05000b1310000000a000000002000000d016d016",
                "ip": "120.77.242.231",
                "port": "1688"
            },
            {
                "hdata": "05000B1310000000A000000002000000D016D016",
                "ip": "162.223.90.90",
                "port": "1688"
            }
      ],
      "http":[
        {
                "ip": "198.198.198.98",
                "method": "post",
                "port": "3911",
                "refer": "",
                "url": "http://198.198.198.98:3911"
        }
      ],
      "https": [
         {
                "ip": "192.168.50.219",
                "method": "post",
                "port": "631",
                "url": "https://192.168.50.219:631/ipp/print"
          }
      ],
      "icmp": [
            {
                "ip": "8.243.116.215",
                "port": "0"
            },
            {
                "ip": "19.111.107.171",
                "port": "0"
            }
      ],
      "tcp":[
            {
                "ip": "20.190.177.82",
                "port": "443"
            },
            {
                "ip": "192.192.192.142",
                "port": "49668"
            }
      ],
      "udp": [
         {
                "hdata": "304d02010004067075626c6963a040020300f0440201000201003033300f060b2b060102011903020105010500300f060b2b060102011903050101010500300f",
                "ip": "192.158.158.247",
                "port": "161"
          }
      ]
    }
}

业务异常响应

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