addToBlocklist: Blocklist-д дүрэм нэмэх арга

Bitdefender-ийн албан ёсны баримтаас орчуулавАнгли эх (EN) · Орчуулсан: 2026.11.10

Энэ хуудсыг AI-аар орчуулж, автоматаар шалгасан. Нарийн тохиргоо хийхээсээ өмнө англи эхтэй тулгаж болно.

Энэ аргыг ашиглан blocklist-д зүйл нэмэх нэг буюу хэд хэдэн дүрмийг тохируулна.

Чухал: Энэ арга 1.2 хувилбар болж шинэчлэгдсэн. 1.0 хувилбарт хамаарах мэдээллийг доорх «Version 1.0» хэсгээс үзнэ үү.

1.0 хувилбар нь зөвхөн hash төрлийн blocklist дүрэмтэй нийцнэ.

Параметрүүд

`type` — Үүсгэх дүрмийн төрлийг заана; хүсэлтэд заавал орно; төрөл: String; боломжит утга: hash, path, connection. Жишээ: "type": "hash"
`rules` — Үүсгэх дүрмүүд болон тэдгээрийн тохиргооны жагсаалт; хүсэлтэд заавал орно; төрөл: объектуудын массив; type параметрт заасан төрөлд таарах дүрмийг л нэмэх боломжтой. Доорх rules хэсгийг үзнэ үү. hash төрлийн дүрмийн жишээ: "rules": [ { "note": "test", "details": { "algorithm": "sha256", "hash": "1e0905327f443c54aa617e2ff323067c985428e5566886f2aa8296cddfe6ddf9" } }, { "details": { "algorithm": "md5", "hash": "13f6331c638b68d4e7eab6ea60da5473" } } ]

Ерөнхий параметрүүд

Эдгээр нь бүх 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": {...}

Объектууд

`rules`

`note` — Тухайн дүрмийг тайлбарлана; заавал биш; төрөл: String; нэмэлт шаардлага байхгүй.
`details` — Тодорхой дүрэм болон түүний тохиргоог тодорхойлно; заавал; төрөл: Object; доорх details хэсгийг үзнэ үү.

`details`

type нь hash үед боломжтой параметрүүд:

`algorithm` — Хэшийг гаргахад ашигласан алгоритм; заавал; төрөл: String; боломжит утга: sha256, md5.
`hash` — Блоклох файлтай холбогдох хэш; заавал; төрөл: String; хэшийн утга algorithm параметрт заасан форматтай таарах ёстой.

type нь connection үед боломжтой параметрүүд:

`ruleName` — Дүрмийн хүснэгтэд харагдах нэр (жишээ нь дүрэм хамаарах программын нэр); заавал; төрөл: String; нэмэлт шаардлага байхгүй.
`commandLine` — Оруулсан бол программыг командын мөрөөс заасан командаар нээсэн үед л дүрэм хэрэгжинэ; path өгсөн үед заавал биш, өөр үед ашиглах боломжгүй; төрөл: String; нэмэлт шаардлага байхгүй.
`protocol` — Оруулсан бол холболтод заасан IP протокол ашиглагдсан үед л дүрэм хэрэгжинэ; заавал; төрөл: String; боломжит утга: any, TCP, UDP, эсвэл энд байгаа жагсаалтын протокол (Keyword багана).
`direction` — Дүрэм зөвхөн тодорхой чиглэлтэй холболтод хэрэгжинэ; заавал; төрөл: String; боломжит утга: inbound, outbound, both.
`ipVersion` — Дүрэм зөвхөн тодорхой IP төрлийн холболтод хэрэгжинэ; заавал; төрөл: String; боломжит утга: any, IPV4, IPV6.
`localAddress` — Оруулсан бол дүрэм зөвхөн заасан локал сүлжээний хаягтай холбоотой холболтод хэрэгжинэ; заавал биш; төрөл: Object; доорх localAddress хэсгийг үзнэ үү.
`remoteAddress` — Оруулсан бол дүрэм зөвхөн заасан алсын хаягтай холбоотой холболтод хэрэгжинэ; заавал биш; төрөл: Object; доорх remoteAddress хэсгийг үзнэ үү.
`directlyConnected` — Идэвхжүүлсэн бол дүрэм зөвхөн заасан Mac хаягтай холбоотой холболтод хэрэгжинэ; заавал биш; төрөл: Object; доорх directlyConnected хэсгийг үзнэ үү.
`operatingSystems` — Оруулсан бол дүрэм зөвхөн заасан үйлдлийн системтэй төгсгөлийн төхөөрөмжтэй холбоотой холболтод хэрэгжинэ; заавал биш; төрөл: стрингийн массив; массивын элемент бүрийн боломжит утга: windows, mac. Анхдагч утга: ["windows"].
`path` — Дүрэм аль программд хамаарахыг тодорхойлно; заавал биш; төрөл: String; нэмэлт шаардлага байхгүй.
`hash` — Программын MD5; path өгсөн үед заавал биш, өөр үед ашиглах боломжгүй; төрөл: String; нэмэлт шаардлага байхгүй.

type нь path үед боломжтой параметрүүд:

`path` — Заасан замаас ажиллуулсан бүх программыг блоклоно; заавал; төрөл: String; замын формат нь зорилтот төгсгөлийн төхөөрөмжийн үйлдлийн системд таарах ёстой бөгөөд файлын абсолют зам байх ёстой.

`localAddress`

Энэ объект зөвхөн type нь connection үед боломжтой.

`any` — false бол зөвхөн ipMask тохиргоонд заасан хаягаас үүссэн холболтыг блоклоно. true бол IP хаягаас үл хамааран бүх холболтыг блоклоно; заавал; төрөл: Boolean; нэмэлт шаардлага байхгүй.
`ipMask` — any нь false бол зөвхөн энэ тохиргоонд заасан хаягтай холбоотой холболтыг блоклоно; any нь false үед заавал биш, өөр үед ашиглах боломжгүй; төрөл: String; утга IP эсвэл IP/Mask форматтай байж болно.
`portRange` — Мужийг ашигласан бол зөвхөн энэ хоёр утгын хоорондох портоор хийсэн холболтыг блоклоно. Тодорхой портуудыг ашигласан бол зөвхөн тэдгээр портоор хийсэн холболтыг блоклоно; заавал биш; төрөл: String; нэмэлт шаардлага байхгүй. Жишээ: "portRange": "6660-6669", "portRange": "135;137-139;445"

`remoteAddress`

Энэ объект зөвхөн type нь connection үед боломжтой.

`any` — false бол зөвхөн ipMask тохиргоонд заасан хаягаас үүссэн холболтыг блоклоно. true бол IP хаягаас үл хамааран бүх холболтыг блоклоно; заавал; төрөл: Boolean; нэмэлт шаардлага байхгүй.
`ipMask` — any нь false бол зөвхөн энэ тохиргоонд заасан хаягтай холбоотой холболтыг блоклоно; any нь false үед заавал биш, өөр үед ашиглах боломжгүй; төрөл: String; утга IP эсвэл IP/mask форматтай байж болно.
`portRange` — Мужийг ашигласан бол зөвхөн энэ хоёр утгын хоорондох портоор хийсэн холболтыг блоклоно. Тодорхой портуудыг ашигласан бол зөвхөн тэдгээр портоор хийсэн холболтыг блоклоно; заавал биш; төрөл: String; нэмэлт шаардлага байхгүй. Жишээ: "portRange": "6660-6669", "portRange": "135;137-139;445"

`directlyConnected`

Энэ объект зөвхөн type нь connection үед боломжтой.

`enable` — Энэ сонголт идэвхтэй эсэхийг заана; Windows-д заавал, macOS-д заавал биш; төрөл: Boolean; нэмэлт шаардлага байхгүй.
`remoteMac` — Зөвхөн заасан Mac хаягнуудаас ирсэн холболтыг зөвшөөрнө; enable нь true үед заавал, өөр үед ашиглах боломжгүй; төрөл: String; зөв Mac хаягийн форматтай байх ёстой. Жишээ: "remoteMac": "00:1b:63:84:45:e6;00-1B-63-84-45-E6"

Буцаах утга

`result` — Boolean; үйлдэл амжилттай болсон эсэхийг заана.

Жишээнүүд

Request

{
  "params": {
    "type": "hash",
    "rules": [
      {
        "note": "test",
        "details": {
          "algorithm": "sha256",
          "hash": "1e0905327f443c54aa617e2ff323067c985428e5566886f2aa8296cddfe6ddf9"
        }
      },
      {
        "details": {
          "algorithm": "md5",
          "hash": "13f6331c638b68d4e7eab6ea60da5473"
        }
      }
    ]
  },
  "jsonrpc": "2.0",
  "method": "addToBlocklist",
  "id": "5087eab8-b74f-4a3e-85b3-4271e85890d5"
}

{
  "params": {
    "type": "connection",
    "rules": [
      {
        "note": "test",
        "details": {
          "ruleName": "rule  1#",
          "path": "C:\\test.exe",
          "commandLine": "format  C:\\",
          "hash": "13f6331c638b68d4e7eab6ea60da5473",
          "protocol": "ICMP",
          "direction": "inbound",
          "ipVersion": "IPV4",
          "localAddress": {
            "any": false,
            "ipMask": "10.10.10.12/32",
            "portRange": "300-400"
          },
          "remoteAddress": {
            "any": false,
            "ipMask": "10.10.10.12/32",
            "portRange": "300-400"
          },
          "directlyConnected": {
            "enable": true,
            "remoteMac": "AA:AA:AA:AA:AA:AA;CC:CC:CC:CC:CC:CC;BB:BB:BB:BB:BB:BB"
          },
          "operatingSystems": [
            "windows"
          ]
        }
      }
    ]
  },
  "jsonrpc": "2.0",
  "method": "addToBlocklist",
  "id": "5087eab8-b74f-4a3e-85b3-4271e85890d5"
}

{
  "params": {
    "type": "path",
    "rules": [
      {
        "note": "test",
        "details": {
          "path": "C:\\aaa.exe"
        }
      },
      {
        "note": "test",
        "details": {
          "path": "C:\\test.exe"
        }
      }
    ]
  },
  "jsonrpc": "2.0",
  "method": "addToBlocklist",
  "id": "5087eab8-b74f-4a3e-85b3-4271e85890d5"
}

Response

{
  "id": "5087eab8-b74f-4a3e-85b3-4271e85890d5",
  "jsonrpc": "2.0",
  "result": true
}

Version 1.0

Энэ аргыг ашиглан Blocklist-д нэг буюу хэд хэдэн файлын хэш нэмнэ.

Параметрүүд

`hashType` — Integer; заавал; хэшийг гаргахад ашигласан алгоритм. Боломжит утга: 1 - SHA256, 2 - MD5.
`hashList` — Стрингийн массив; заавал; хэд хэдэн хэш агуулсан массив. Бүх хэш hashType параметрт заасан төрлийнх байх ёстой.
`sourceInfo` — String; заавал; хэшүүдийн тайлбар.

Ерөнхий параметрүүд

Эдгээр нь бүх 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": {...}

Буцаах утга

Үйлдэл амжилттай болсон бол энэ арга true гэсэн Boolean буцаана.

Жишээ

Request:

{
    "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810",
    "jsonrpc": "2.0",
    "method": "addToBlocklist",
    "params": {
        "hashType": 2,
        "hashList": [
            "5b7ac19bb1a43dfb107b23c6",
            "f696282aa4cd4f614aa995190cf442fe"
        ],
       "sourceInfo": "Added from public API"
    }
}

Response:

{
    "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810",
    "jsonrpc": "2.0",
    "result": true
}

Асуулт байна уу?AI туслах GravityZone-ийн монгол баримтаас хайна. Нарийн асуудлыг таны гэрээт борлуулагч, Bitdefender Mongolia-ийн инженер шийднэ.