startYaraScan: YARA дүрмээр On-demand шалгалт эхлүүлэх API арга

Энэ аргыг заасан зорилтууд дээр On-demand шалгалт (scan) эхлүүлэхэд ашиглана. Шалгалт нь YARA дүрмийн нөхцөлд таарах файлуудыг илрүүлнэ.

Параметрүүд

• ruleId — шалгалтын илрүүлэх нөхцөлийг тодорхойлдог YARA дүрмийн ID; хүсэлтэд заавал орно; төрөл: String. Энэ параметр яг 24 арван зургаатын (hexadecimal) тэмдэгтээс бүрдэх ёстой.
• paths — шалгах локал директориуд; заавал биш; төрөл: Array of Strings. Массив дахь мөр бүр YARA дүрмийн чиглэсэн endpoint-уудын ядаж нэг дээрх зөв абсолют зам байх ёстой. Замууд wildcard тэмдэгт дэмждэггүй, харин системийн хувьсагч дэмжинэ.

> Анхааруулга: Энэ параметрийг оруулаагүй эсвэл хоосон массив өгвөл бүх диск шалгалтад орно. Энэ үйлдэл нөөцийг ихээр зарцуулдаг тул гүйцэтгэлийн асуудал үүсгэж болзошгүй.

> Чухал: Сүлжээний хавтас (network share)-ийг YARA дүрмээр On-demand шалгахыг дэмждэггүй.

Бүх public API аргад нийтлэг параметрүүд

• id — хүсэлтийг хариутай нь холбох таниулагч. Хүлээн авагч хариунд ижил утгыг буцаадаг тул дуудлагыг амархан мөрдөнө; хүсэлтэд заавал орно; төрөл: String; нэмэлт шаардлага байхгүй. Жишээ: "id": "ad12cb61-52b3-4209-a87a-93a8530d91cb"
• method — хүсэлт илгээж буй аргын нэр; хүсэлтэд заавал орно; төрөл: String; зөв аргын нэр байх ёстой. Жишээ: "method": "methodName"
• jsonrpc — хүсэлт ба хариуд хэрэглэх JSON-RPC-ийн хувилбар; хүсэлтэд заавал орно; төрөл: String; цорын ганц боломжит утга нь 2.0. Жишээ: "jsonrpc": "2.0"
• params — хүсэлтийн тохиргоог агуулсан объект; хүсэлтэд заавал орно; төрөл: Object; нэмэлт шаардлага байхгүй. Жишээ: "params": {...}

Буцаах утга

• result — Boolean; шалгалтын даалгавар амжилттай эхэлбэл true, үгүй бол false болно.

Жишээ

Хүсэлт:

{
  "jsonrpc": "2.0",
  "method": "startYaraScan",
  "params": {
    "ruleId": "66b3f7a8291b2d4c5e8f9012",
    "paths": [
      "C:\\",
      "D:\\Users\\Public\\Downloads",
      "/home",
      "/var/tmp"
    ]
  },
  "id": "c3c996ca-68d6-4f13-9a87-7e0a8ad9b9e1"
}

Хариу:

{
  "jsonrpc": "2.0",
  "id": "c3c996ca-68d6-4f13-9a87-7e0a8ad9b9e1",
  "result": true
}