getBlocklistItems: Blocklist-ийн зүйлсийг жагсаах арга

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

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

Энэ арга Blocklist дэх бүх зүйлийг жагсаана.

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

Параметрүүд

`page` — Одоо харагдаж буй үр дүнгийн хуудасны дугаар; заавал биш; төрөл: Integer; анхдагч утга: 1. Жишээ: "page": 1
`perPage` — Нэг хуудсанд харуулах зүйлийн тоо; заавал биш; төрөл: Integer; боломжит утга: 1 - 100; анхдагч утга: 30. Жишээ: "perPage": 50

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

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

Буцаах утга

Энэ арга одоо байгаа blocklist дүрмийн мэдээллийг агуулсан result Object буцаана. Буцсан объект дараахыг агуулна:

`total` — Integer; хүсэлтээр буцсан дүрмийн нийт тоо.
`page` — Integer; одоо харагдаж буй хуудасны дугаар.
`perPage` — Integer; нэг хуудсанд харагдаж буй үр дүнгийн тоо.
`pagesCount` — Integer; хүсэлтээр буцсан хуудасны нийт тоо.
`items` — Объектуудын массив; таны компанитай холбоотой одоо байгаа дүрмүүдийн жагсаалт. Массив доторх объект бүрийн дэлгэрэнгүй тайлбарыг доорх items хэсгээс үзнэ үү.

Объектууд

`items`

`id` — String; зүйлийн ID. Энэ ID-г ашиглан зүйлийг Blocklist-ээс устгаж болно. removeFromBlocklist-ийг үзнэ үү.
`type` — String; жагсаалтад орсон дүрмийн төрөл. Боломжит утга: hash, path, connection.
`source` — Object; зүйлийг жагсаалтад хэрхэн нэмсэн тухай мэдээлэл. Энэ объектын параметрүүдийн тухай доорх source хэсгийг үзнэ үү.
`company` — Object; зүйл аль компанид хамаарах тухай мэдээлэл. Доорх company хэсгийг үзнэ үү.
`owner` — Object; дүрмийг үүсгэсэн GravityZone хэрэглэгчийн мэдээлэл. Доорх owner хэсгийг үзнэ үү.
`created` — String, timestamp; зүйлийг blocklist-д нэмсэн огноо, цаг.
`details` — Object; дүрмийн тухай мэдээлэл. Энэ объектын тохиргоонуудын тухай доорх details хэсгийг үзнэ үү.

`source`

`type` — String; бичлэг ямар эх сурвалжаас ирснийг заана. Боломжит утга: incident, import, manual, MDR (дүрмийг MDR шинжээч Blocklist-д нэмсэн).
`description` — String; зүйлийг жагсаалтад нэмэхэд өгсөн тайлбар.

`company`

`id` — String; компанийн ID.
`name` — String; зүйл хамаарах компанийн нэр.

`owner`

`id` — String; GravityZone хэрэглэгчийн ID.
`userName` — String; хэрэглэгчийн и-мэйл хаяг.

`details`

details объект доторх атрибутууд дүрмийн type-аас хамаарч өөр өөр байна.

type нь hash үед:

`algorithm` — String; хэшийг гаргахад ашигласан алгоритм. Боломжит утга: sha256, md5.
`hash` — String; блоклох файлтай холбогдох хэш.
`file` — Object; хэшт тохирох файлын дэлгэрэнгүй. Доорх file хэсгийг үзнэ үү.

type нь path үед:

`path` — String; заасан замаас ажиллуулсан бүх программыг блоклоно.

type нь connection үед:

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

`file`

`name` — String; хэшт тохирох файлын нэр.

`localAddress`

`any` — Boolean; false бол зөвхөн ipMask тохиргоонд заасан хаягаас үүссэн холболтыг блоклоно. true бол IP хаягаас үл хамааран бүх холболтыг блоклоно.
`ipMask` — String; any нь false бол зөвхөн энэ тохиргоонд заасан хаягтай холбоотой холболтыг блоклоно. Утга IP эсвэл IP/Mask форматтай байж болно.
`portRange` — String; мужийг ашигласан бол зөвхөн энэ хоёр утгын хоорондох портоор хийсэн холболтыг блоклоно. Тодорхой портуудыг ашигласан бол зөвхөн тэдгээр портоор хийсэн холболтыг блоклоно.

`remoteAddress`

`any` — Boolean; false бол зөвхөн ipMask тохиргоонд заасан хаягаас үүссэн холболтыг блоклоно. true бол IP хаягаас үл хамааран бүх холболтыг блоклоно.
`ipMask` — String; any нь false бол зөвхөн энэ тохиргоонд заасан хаягтай холбоотой холболтыг блоклоно. Утга IP эсвэл IP/Mask форматтай байж болно.
`portRange` — String; мужийг ашигласан бол зөвхөн энэ хоёр утгын хоорондох портоор хийсэн холболтыг блоклоно. Тодорхой портуудыг ашигласан бол зөвхөн тэдгээр портоор хийсэн холболтыг блоклоно.

`directlyConnected`

`enable` — Boolean; энэ сонголт идэвхтэй эсэхийг заана.
`remoteMac` — String; зөвхөн заасан macOS хаягнуудаас ирсэн холболтыг зөвшөөрнө.

Жишээ

Request

{
   "params": {
        "page": 1,
        "perPage": 100
    },
    "jsonrpc": "2.0",
    "method": "getBlocklistItems",
    "id": "5087eab8-b74f-4a3e-85b3-4271e85890d5"
}

Response

{
  "id": "5087eab8-b74f-4a3e-85b3-4271e85890d5",
  "jsonrpc": "2.0",
  "result": {
    "total": 3,
    "page": 1,
    "perPage": 100,
    "pagesCount": 1,
    "items": [
      {
        "type": "hash",
        "source": {
          "type": "manual",
          "description": null
        },
        "company": {
          "id": "69e74165500917a5160750d4",
          "name": "Bitdefender"
        },
        "owner": {
          "id": "69e74168500917a5160750df",
          "userName": "user@bitdefender.com"
        },
        "created": "2026-08-04T16:09:52",
        "id": "6a71e4a08f260ee6ff019ca4",
        "details": {
          "algorithm": "sha256",
          "hash": "1e0905327f443c54aa617e2ff323067c985428e5566886f2aa8296cddfe6ddf9",
          "file": {
            "name": null
          }
        }
      },
      {
        "type": "path",
        "source": {
          "type": "manual",
          "description": "test"
        },
        "company": {
          "id": "69e74165500917a5160750d4",
          "name": "Bitdefender"
        },
        "owner": {
          "id": "69e74168500917a5160750df",
          "userName": "user@bitdefender.com"
        },
        "created": "2026-08-04T16:09:52",
        "id": "6a71e4a0049f483681066b72",
        "details": {
          "path": "C:\\aaa.exe"
        }
      },
      {
        "type": "connection",
        "source": {
          "type": "manual",
          "description": "test"
        },
        "company": {
          "id": "69e74165500917a5160750d4",
          "name": "Bitdefender"
        },
        "owner": {
          "id": "69e74168500917a5160750df",
          "userName": "user@bitdefender.com"
        },
        "created": "2026-08-04T16:09:52",
        "id": "6a71e4a0286266ec5b0a0df2",
        "details": {
          "remoteAddress": {
            "any": true,
            "ipMask": null,
            "portRange": "300-400"
          },
          "localAddress": {
            "any": false,
            "ipMask": "10.10.10.10/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"
          },
          "protocol": "any",
          "path": null,
          "hash": null,
          "commandLine": null,
          "ipVersion": "any",
          "direction": "both",
          "ruleName": "rule 1#",
          "ruleId": "fabd7c56-0f68-4042-aff8-5698baa5b286",
          "operatingSystems": [
            "windows"
          ]
        }
      }
    ]
  }
}

Version 1.0

Параметрүүд

`page` — Integer; хүсэлтэд заавал биш; үр дүнгийн хуудасны дугаар. Анхдагч утга 1.
`perPage` — Integer; хүсэлтэд заавал биш; нэг хуудсанд харуулах зүйлийн тоо. Дээд хязгаар нэг хуудсанд 100 зүйл. Анхдагч утга: нэг хуудсанд 30 зүйл.

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

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

Буцаах утга

Энэ арга одоо байгаа hash төрлийн blocklist дүрмийн мэдээллийг агуулсан result Object буцаана. Буцсан объект дараахыг агуулна:

`total` — Integer; хүсэлтээр буцсан дүрмийн нийт тоо.
`page` — Integer; одоо харагдаж буй хуудасны дугаар.
`perPage` — Integer; нэг хуудсанд харагдаж буй үр дүнгийн тоо.
`pagesCount` — Integer; хүсэлтээр буцсан хуудасны нийт тоо.
`items` — Объектуудын массив; таны компанитай холбоотой одоо байгаа hash төрлийн дүрмүүдийн жагсаалт. Массив доторх объект бүрийн дэлгэрэнгүй тайлбарыг доорх items хэсгээс үзнэ үү.

Объектууд

`items`

`companyId` — String; Blocklist-ийн зүйл хамаарах компанийн ID.
`hash` — String; блоклох файлтай холбогдох хэш.
`hashType` — Integer; хэшийг гаргахад ашигласан алгоритм. Боломжит утга: 1 - SHA256, 2 - MD5.
`filename` — String; хэшт тохирох файлын нэр. Энэ мэдээлэл байгаа тохиолдолд л харагдана.
`id` — String; Blocklist дэх hash зүйлийн ID. Энэ ID-г ашиглан зүйлийг Blocklist-ээс устгаж болно. removeFromBlocklist-ийг үзнэ үү.
`source` — Integer; hash бичлэг ямар эх сурвалжаас ирсэн. Боломжит утга: 1 - Incident, 2 - Import, 3 - Manual, 4 - MDR.
`sourceInfo` — String; хэрэглэгч зүйлийг Blocklist-д нэмэхдээ өгсөн тайлбар.

Жишээ

Request:

  {
      "params": {

      },
      "jsonrpc": "2.0",
      "method": "getBlocklistItems",
      "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810"
  }

Response:

   {
       "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810",
       "jsonrpc": "2.0",
       "result": {
           "items": [
               {
                   "companyId": "5b680f6fb1a43d860a7b23c8",
                   "hash": "098f6bcd4621d373cade4e832627b4f6",
                   "hashType": 2,
                   "id": "5b7ac19bb1a43dfb107b23c6",
                   "source": 3,
                   "sourceInfo": "Added from public API"
               },
               {
                   "companyId": "5b680f6fb1a43d860a7b23c8",
                   "filename": "file.txt",
                   "hash": "f696282aa4cd4f614aa995190cf442fe",
                   "hashType": 2,
                   "id": "5b7ac19bb1a43dfb107b23c7",
                   "source": 1,
                   "sourceInfo": "Added from incident 1"
               }
           ],
           "page": 1,
           "pagesCount": 1,
           "perPage": 30,
           "total": 2
       }
  }

Энэ хуудсанд гарсан нэр томъёо

Incidents: Илэрсэн халдлага, түүний алхмуудын бүртгэл (EDR/XDR)

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