{"id":114,"date":"2023-12-22T23:44:12","date_gmt":"2023-12-22T15:44:12","guid":{"rendered":"https:\/\/blog.hishutdown.cn\/?p=114"},"modified":"2024-04-04T23:09:33","modified_gmt":"2024-04-04T15:09:33","slug":"yaraengineapi%e5%bc%80%e5%8f%91%e6%8c%87%e5%8d%97","status":"publish","type":"post","link":"https:\/\/blog.hishutdown.cn\/?p=114","title":{"rendered":"YaraEngineAPI\u5f00\u53d1\u6307\u5357"},"content":{"rendered":"\n
<\/i>\u00a0GitHub<\/span><\/a><\/div>
shutdown-awa\/YaraEngineAPI<\/span><\/a><\/div>
<\/div><\/div>
<\/i>\u00a0<\/span><\/span><\/i>\u00a0<\/span><\/span><\/div><\/div>\n\n\n\n
<\/div>\n\n\n\n

\ud83d\udca1\u9879\u76ee\u7b80\u4ecb<\/h2>\n\n\n\n

\u4e00\u4e2aYara\u5728\u7ebf\u626b\u63cf\u5f15\u64ce\uff0c\u670d\u52a1\u7aef\u5168\u90e8\u7531Python\u5f00\u53d1\u3002\u7531@Shutdown<\/a>\u4e0e@kolomina<\/a>\u5171\u540c\u5f00\u53d1\uff5e<\/p>\n\n\n\n

\u60a8\u53ef\u4ee5\u4f7f\u7528\u6211\u4eec\u7684\u670d\u52a1\u4e5f\u53ef\u4ee5\u81ea\u884c\u6258\u7ba1\u3002\u4f7f\u7528\u8fd9\u4e2a\u9879\u76ee\uff0c\u60a8\u53ef\u4ee5\u65b9\u4fbf\u5730\u5c06Yara\u626b\u63cf\u529f\u80fd\u88c5\u8f7d\u5230\u60a8\u7684\u8f6f\u4ef6\u4e0a\u3002<\/p>\n\n\n\n

\u5b98\u65b9\u5730\u5740\uff1ahttps:\/\/api.hishutdown.cn\/yara\/v1<\/a>
\u5b98\u65b9\u8c03\u8bd5\u5730\u5740\uff1ahttps:\/\/api.hishutdown.cn\/yara\/v1\/docs<\/a><\/p>\n\n\n\n

\ud83d\udcac\u67b6\u6784\u7b80\u8ff0<\/h2>\n\n\n\n

Level 1<\/strong> \u670d\u52a1\u5c42<\/sub>
\u524d\u6bb5\u90e8\u5206\uff0c\u4e3b\u8981\u8d1f\u8d23\u7528\u6237\u4e0e\u6570\u636e\u5e93\u4e4b\u95f4\u7684\u67e5\u8be2\u8bf7\u6c42\u3002\u6b64\u5c42\u53ef\u72ec\u7acb\u4e8e\u4efb\u4f55\u90e8\u5206\uff0c\u4ec5\u9700\u80fd\u4e0e\u6570\u636e\u5e93\u4ea4\u4e92\u5373\u53ef\u3002<\/p>\n\n\n\n

Level 2<\/strong> \u63a7\u5236\u5c42<\/sub>
\u8d1f\u8d23\u76d1\u542c\u6570\u636e\u5e93\uff1b\u542f\u52a8\u626b\u63cf\u7ebf\u7a0b\u3002<\/p>\n\n\n\n

Level 3<\/strong> \u626b\u63cf\u5c42<\/sub>
\u8d1f\u8d23\u626b\u63cf\u6587\u4ef6\uff0c\u5e76\u5199\u5165\u626b\u63cf\u7ed3\u679c\u5230\u6570\u636e\u5e93\u3002<\/p>\n\n\n\n

<\/div>\n\n\n\n

\ud83d\udd00\u6267\u884c\u6d41\u7a0b\uff08\u5927\u81f4\uff09<\/sub><\/h2>\n\n\n\n

\u65b0\u5efa\u626b\u63cf\u4efb\u52a1<\/h3>\n\n\n\n

\u5ba2\u6237\u7aef\u53d1\u9001\u68c0\u6d4b\u8bf7\u6c42\u27a1\ufe0f\u670d\u52a1\u5668\u670d\u52a1\u5c42\u5206\u914d\u4efb\u52a1ID\u27a1\ufe0f\u5ba2\u6237\u7aef\u83b7\u53d6\u72b6\u6001\u4fe1\u606f\u27a1\ufe0f\u5ba2\u6237\u7aef\u4e0a\u4f20\u6587\u4ef6\uff08\u5f53\u9700\u8981\u65f6\uff09\u27a1\ufe0f\u670d\u52a1\u5668\u670d\u52a1\u5c42\u63a5\u6536\u6587\u4ef6\u5e76\u6807\u8bb0\u4efb\u52a1\u72b6\u6001\u27a1\ufe0f\u63a7\u5236\u5c42\u4e3a\u4efb\u52a1\u5206\u914d\u7ebf\u7a0b\uff0c\u542f\u52a8\u626b\u63cf\u5c42\u27a1\ufe0f\u626b\u63cf\u5c42\u8f93\u51fa\u62a5\u544a\u81f3\u6570\u636e\u5e93\u27a1\ufe0f\u5b8c\u6210<\/p>\n\n\n\n

\u83b7\u53d6\u626b\u63cf\u7ed3\u679c<\/h3>\n\n\n\n

\u5ba2\u6237\u7aef\u8bf7\u6c42\u7ed3\u679c\u5730\u5740\u27a1\ufe0f\u670d\u52a1\u7aef\u8bfb\u53d6\u6570\u636e\u5e93\u27a1\ufe0f\u8fd4\u56de\u7ed3\u679c\u5230\u5ba2\u6237\u7aef\u27a1\ufe0f\u5b8c\u6210<\/p>\n\n\n\n

\ud83d\udce3\u8bf7\u6c42\u63a5\u53e3<\/h2>\n\n\n\n

.\/task\/add\uff1a\u7533\u8bf7\u65b0\u7684\u626b\u63cf\u4efb\u52a1<\/h3>\n\n\n\n

\u65b9\u5f0f<\/strong>\uff1aGET<\/p>\n\n\n\n

\u53c2\u6570<\/strong>\uff1ahash
\u9700\u8981\u63d0\u4ea4\u6587\u4ef6\u7684MD5\u503c\uff08 MD5\u503c\u4f1a\u5728\u670d\u52a1\u7aef\u88ab\u81ea\u52a8\u8f6c\u4e3a\u5c0f\u5199\uff09<\/mark>\u3002<\/p>\n\n\n\n

https://api.hishutdown.cn\/yara\/v1\/task\/add?hash=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx<\/code><\/pre>\n\n\n\n
\u8fd4\u56de\uff1a<\/strong><\/p>\n\n\n\n
{\n     \"packageVersion\": 1,\n     \"time\": int(time.time()),\n     \"taskApply\": {\n         \"code\": 0,\n         \"message\": \"...\",\n         \"id\": xxxxxxxx,\n         \"timestamp\": xxxxxxxx,\n         \"hash\": xxxxxxx\n     }\n}<\/code><\/pre>\n\n\n\n
\u9879<\/strong><\/td>\u7c7b\u578b<\/strong><\/td>\u89e3\u91ca<\/strong><\/td><\/tr>
packageVersion<\/td>INT<\/td>\u6570\u636e\u5305\u7248\u672c<\/td><\/tr>
time<\/td>INT<\/td>\u6570\u636e\u5305\u5236\u4f5c\u65f6\u7684\u65f6\u95f4\u6233<\/td><\/tr>
code<\/td>INT<\/td>\u72b6\u6001\u7801\u3002\u901a\u5e38\u4e3a0\uff1b\u51fa\u73b0\u5f02\u5e38\u4e3a\u8d1f\u503c<\/td><\/tr>
message<\/td>STRING<\/td>\u63d0\u793a\u4fe1\u606f<\/td><\/tr>
id<\/td>INT<\/td>\u4efb\u52a1\u6807\u8bc6\u7801<\/td><\/tr>
timestamp<\/td>INT<\/td>\u6b64\u4efb\u52a1\u521b\u5efa\u65f6\u7684\u65f6\u95f4\u6233<\/td><\/tr>
hash<\/td>STRING<\/td>\u6587\u4ef6\u54c8\u5e0c<\/td><\/tr><\/tbody><\/table>
JSON\u8fd4\u56de\u8bf4\u660e<\/figcaption><\/figure>\n\n\n\n
.\/task\/status\uff1a\u67e5\u8be2\u4efb\u52a1\u5f53\u524d\u72b6\u6001<\/h3>\n\n\n\n
\u65b9\u5f0f<\/strong>\uff1aGET<\/p>\n\n\n\n
\u53c2\u6570<\/strong>\uff1aid
\u9700\u8981\u63d0\u4ea4\u7533\u8bf7\u4efb\u52a1\u65f6\u8fd4\u56de\u7684\u4efb\u52a1\u6807\u8bc6\u7801\u3002<\/p>\n\n\n\n
https://api.hishutdown.cn\/yara\/v1\/task\/status?id=xxxxxxxxxxxxxxxxxxx<\/code><\/pre>\n\n\n\n
\u8fd4\u56de<\/strong><\/p>\n\n\n\n
{\n        \"packageVersion\": 1,\n        \"time\": xxxxxx,\n        \"taskStatus\": {\n            \"code\": 0,\n            \"message\": \"...\",\n            \"status\": xxx,\n            \"id\": xxxxx,\n            \"hash\": xxxxx,\n            \"addTime\": xxxxxx,\n            \"endTime\": xxxxx,\n            \"matchs\": [xxx,xxx,xxx],\n            \"rule_version\": xxx\n        }\n    }<\/code><\/pre>\n\n\n\n
\u9879<\/strong><\/td>\u7c7b\u578b<\/strong><\/td>\u89e3\u91ca<\/strong><\/td><\/tr>
packageVersion<\/td>INT<\/td>\u6570\u636e\u5305\u7248\u672c<\/td><\/tr>
time<\/td>INT<\/td>\u6570\u636e\u5305\u5236\u4f5c\u65f6\u7684\u65f6\u95f4\u6233<\/td><\/tr>
code<\/td>INT<\/td>\u72b6\u6001\u7801\u3002\u901a\u5e38\u4e3a0\uff1b\u51fa\u73b0\u5f02\u5e38\u4e3a\u8d1f\u503c<\/td><\/tr>
message<\/td>STRING<\/td>\u63d0\u793a\u4fe1\u606f<\/td><\/tr>
status<\/td>STRING<\/td>\u4efb\u52a1\u72b6\u6001\uff1a
Created=\u4efb\u52a1\u5df2\u521b\u5efa
NoFile=\u7b49\u5f85\u4e0a\u4f20\u88ab\u6d4b\u6587\u4ef6\uff0c
InList=\u6587\u4ef6\u5df2\u63a5\u6536\uff0c\u6392\u961f\u626b\u63cf\u4e2d\uff0c
Scanning=\u6b63\u5728\u626b\u63cf\uff0c
Done=\u5df2\u5b8c\u6210<\/td><\/tr>
id<\/td>INT<\/td>\u4efb\u52a1\u6807\u8bc6\u7801<\/td><\/tr>
hash<\/td>STRING<\/td>\u6587\u4ef6MD5<\/td><\/tr>
addTime<\/td>INT<\/td>\u4efb\u52a1\u6dfb\u52a0\u65f6\u95f4<\/td><\/tr>
endTime<\/td>INT<\/td>\u5b8c\u6210\u626b\u63cf\u4e8b\u4ef6<\/td><\/tr>
matchs<\/td>ARRAY<\/td>\u547d\u4e2d\u7684\u89c4\u5219<\/td><\/tr>
rule_version<\/td>INT<\/td>\u89c4\u5219\u7248\u672c\u53f7<\/td><\/tr><\/tbody><\/table>
JSON\u8fd4\u56de\u8bf4\u660e<\/figcaption><\/figure>\n\n\n\n
.\/file\uff1a\u4e0a\u4f20\u88ab\u626b\u63cf\u6587\u4ef6<\/h3>\n\n\n\n
\u65b9\u5f0f<\/strong>\uff1aPOST<\/p>\n\n\n\n
\u53c2\u6570<\/strong>\uff1aid
\u9700\u8981\u63d0\u4ea4\u7533\u8bf7\u4efb\u52a1\u65f6\u8fd4\u56de\u7684\u4efb\u52a1\u6807\u8bc6\u7801\u3002<\/p>\n\n\n\n
https://api.hishutdown.cn\/yara\/v1\/file\/?id=xxxxxxxxxxxxxxxxxxx<\/code><\/pre>\n\n\n\n
\u8fd4\u56de\uff1a<\/strong><\/p>\n\n\n\n
\u6b63\u5e38\u60c5\u51b5\u53ea\u8fd4\u56deHTTP\u72b6\u6001\u7801<\/code><\/pre>\n\n\n\n
HTTP\u72b6\u6001\u7801<\/strong><\/td>\u89e3\u91ca<\/strong><\/td><\/tr>
201<\/td>\u6210\u529f<\/td><\/tr>
400<\/td>\u975e\u6cd5\u7684\u63d0\u4ea4\u4fe1\u606f<\/td><\/tr>
500<\/td>\u670d\u52a1\u7aef\u53d1\u751f\u4e86\u610f\u6599\u4e4b\u5916\u7684\u9519\u8bef<\/td><\/tr><\/tbody><\/table>
\u8fd4\u56de\u7684HTTP\u72b6\u6001\u7801\u5206\u6790<\/figcaption><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\ud83d\udd28\u81ea\u6258\u7ba1<\/h2>\n\n\n\n
\u5fc5\u8981\u51c6\u5907<\/h3>\n\n\n\n
\u672c\u7a0b\u5e8f\u4f9d\u8d56MySQL\uff0c\u8bf7\u81ea\u884c\u5b89\u88c5\u5e76\u914d\u7f6e\u76f8\u5173\u73af\u5883\uff0c\u53e6\u5916\u60a8\u9700\u8981\u81ea\u884c\u521d\u59cb\u5316\u6570\u636e\u5e93\u3002<\/p>\n\n\n\n
\u88681\uff1afile<\/h4>\n\n\n\n
\u6b64\u8868\u7528\u4e8e\u5b58\u50a8\u6587\u4ef6\u4fe1\u606f\uff0c\u6240\u6709\u6587\u4ef6\u7684\u4fe1\u606f\u90fd\u4f1a\u5b58\u50a8\u5728\u6b64\u3002<\/p>\n\n\n\n
\u5217<\/th>\u7c7b\u578b<\/td><\/tr><\/thead>
hash<\/th>char(32)<\/td><\/tr>
status<\/th>tinytext<\/td><\/tr>
matchs<\/th>text<\/td><\/tr>
rule_version<\/th>bigint<\/td><\/tr>
timestamp<\/th>int<\/td><\/tr><\/tbody><\/table>
\u63a8\u8350\u8bbe\u7f6e<\/figcaption><\/figure>\n\n\n\n
\u88682\uff1atask<\/h4>\n\n\n\n
\u6b64\u8868\u7528\u4e8e\u5b58\u50a8\u7528\u6237\u7533\u8bf7\u7684\u4efb\u52a1\uff0c\u8bb0\u5f55\u4efb\u52a1\u5bf9\u5e94\u7684HASH\u503c\u3002<\/p>\n\n\n\n
\u5217<\/th>\u7c7b\u578b<\/td><\/tr><\/thead>
id<\/th>bigint<\/td><\/tr>
timestamp<\/th>int<\/td><\/tr>
hash<\/th>text<\/td><\/tr><\/tbody><\/table>
\u63a8\u8350\u8bbe\u7f6e<\/figcaption><\/figure>\n\n\n\n
\u4e00\u822c\u65b9\u5f0f\u90e8\u7f72<\/h3>\n\n\n\n
\u672c\u8f6f\u4ef6\u524d\u7aef\u540e\u7aef\u5206\u5f00\uff0c\u524d\u540e\u7aef\u6ca1\u6709\u4efb\u4f55\u5173\u8054\uff0c\u672c\u8d28\u4e0a\u5b83\u4eec\u53ea\u4f9d\u8d56\u6570\u636e\u5e93\u4f20\u9012\u4fe1\u606f\u5e76\u5b8c\u6210\u5404\u81ea\u7684\u5de5\u4f5c\u3002\u60a8\u53ef\u4ee5\u81ea\u5df1\u8bbe\u8ba1\u524d\u7aef\u6216\u8005\u540e\u7aef\u4ee5\u9002\u5e94\u60a8\u7684\u4e1a\u52a1\u9700\u8981\u3002<\/p>\n\n\n\n
Environments<\/h4>\n\n\n\n
\u826f\u597d\u7684\u8fd0\u884c\u6761\u4ef6\u662f\u7a33\u5b9a\u8fd0\u884c\u7684\u57fa\u7840\u3002<\/p>\n\n\n\n