getMonitoredRules: хяналтад буй PHASR дүрмүүдийг авах API арга

Энэ арга нь тодорхой компанийн зан төлөвийн бүх ангилал дахь хяналтад буй PHASR дүрмүүдийг харуулна.

Хүсэлт илгээж буй хэрэглэгч ID нь харьяалагдах компани дээрээ Network administrator эрхтэй байх ёстой.

Параметрүүд

• categories — хүсэлтэд: заавал биш; төрөл: Array of integers. Арга ямар төрлийн дүрмийг буцаахыг тодорхойлно. Боломжит утга:

- 1 — Tampering tool
- 2 — Hack tool
- 3 — Remote tool
- 4 — Miner
- 5 — Lolbin

Жишээ: "categories": [1, 3, 5]

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

Эдгээр нь public API-ийн бүх аргад нийтлэг параметрүүд юм.

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

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

Буцаах утга

• page — төрөл: Integer. Одоо харуулж буй хуудасны дугаар.
• perPage — төрөл: Integer. Нэг хуудсанд харуулах үр дүнгийн тоо.
• pagesCount — төрөл: Integer. Хариунд багтсан нийт хуудасны тоо.
• total — төрөл: Integer. Хариунд багтсан зан төлөвийн профайлуудын нийт тоо.

Объектууд

items

• ruleId — төрөл: Integer. Дүрмийн ID.
• category — төрөл: String. Дүрмийн төрөл.
• name — төрөл: String. Дүрмийн нэр.
• description — төрөл: String. Дүрмийн богино тайлбар ба идэвхжих нөхцөл.
• lastTriggered — төрөл: Integer. Дүрэм хамгийн сүүлд идэвхжсэн цаг хугацаа, Unix epoch хэлбэртэй.
• latestUpdate — төрөл: Integer. Дүрэм хамгийн сүүлд шинэчлэгдсэн цаг хугацаа, Unix epoch хэлбэртэй.
• recommendations — төрөл: Integer. Дүрэм идэвхжсэний үр дүнд үүссэн зөвлөмжүүдийн тоо.
• ruleTriggers — төрөл: Integer. Дүрэм идэвхжсэн удаагийн тоо.
• profilesUsingSuchTools — төрөл: Integer. Дүрмийн чиглэсэн хэрэгсэл эсвэл аргыг ашигласан шинж тэмдэг илэрсэн профайлуудын тоо.
• profilesNotUsingSuchTools — төрөл: Integer. Дүрмийн чиглэсэн хэрэгсэл эсвэл аргыг ашигласан ямар ч шинж тэмдэг илрээгүй профайлуудын тоо.
• restrictedProfilesByAutopilot — төрөл: Integer. Энэ дүрмийг идэвхжсэний үр дүнд үүссэн зөвлөмжүүдийг автоматаар хэрэгжүүлсэн профайлуудын тоо. PHASR-ийн энэ тохиргоог Autopilot гэж нэрлэдэг.
• restrictedProfilesByDirectControl — төрөл: Integer. Энэ дүрмийг идэвхжсэний үр дүнд үүссэн зөвлөмжүүдийг гараар зөвшөөрсний дараа хэрэгжүүлсэн профайлуудын тоо. PHASR-ийн энэ тохиргоог Direct control гэж нэрлэдэг.

Жишээ

Хүсэлт:

{
    "params": {
      "companyId": "68306c15c9b5cb3e920ffe22",
      "categories": [1, 3, 5],
      "page": 29,
      "perPage": 3
    },
    "jsonrpc": "2.0",
    "method": "getMonitoredRules",
    "id": "d4d50719-3215-455a-a329-086fe77f6d72"
}

Хариу:

{
  "id": "d4d50719-3215-455a-a329-086fe77f6d72",
  "jsonrpc": "2.0",
  "result": [
    "page": 29,
    "perPage": 3,
    "pagesCount": 32,
    "total": 95,
    "items": [
      {
        "ruleId": 787,
        "category": "TamperingTool",
        "name": "AuotitGenericUsage",
        "description": "AutoIt is a scripting language for automating the Windows GUI and general scripting. The \"autoit.exe\" is typically the executable used to run scripts written in AutoIt language.\nMalware can use AutoIt to create scripts that automate malicious activities, such as downloading and executing other malware, keylogging, or altering system settings without user consent.",
        "lastTriggered": 1748247681,
        "latestUpdate": 1748250401,
        "recommendations": 1,
        "ruleTriggers": 0,
        "profilesUsingSuchTools": 10,
        "profilesNotUsingSuchTools": 7,
        "restrictedProfilesByAutopilot": 10,
        "restrictedProfilesByDirectControl": 6
      },
      {
        "ruleId": 695,
        "category": "HackTool",
        "name": "KmspicoGenericUsage",
        "description": "KMSPico is a tool designed to activate Microsoft products such as Windows and Office without a legitimate license by emulating a Key Management Service (KMS) server.\nMalware can use KMSPico to bypass software activation measures, allowing unauthorized access to software features, and potentially including malicious payloads to compromise the system.",
        "lastTriggered": null,
        "latestUpdate": null,
        "recommendations": 1,
        "ruleTriggers": 0,
        "profilesUsingSuchTools": 8,
        "profilesNotUsingSuchTools": 8,
        "restrictedProfilesByAutopilot": 9,
        "restrictedProfilesByDirectControl": 6
      },
      {
        "ruleId": 696,
        "category": "HackTool",
        "name": "WindowsActivatorGenericUsage",
        "description": "The term \"activator\" in a Windows binary name typically refers to a tool used to bypass software activation mechanisms, often for pirated software. An activator can modify system files or registry entries to trick software into recognizing the installation as legally activated.\nMalware can use activators to disable legitimate software protections, enabling the spread of pirated software. Additionally, malicious actors may disguise malware as activators or bundle malware with them, resulting in unauthorized system access, data theft, or installation of additional malicious software.",
        "lastTriggered": null,
        "latestUpdate": null,
        "recommendations": 1,
        "ruleTriggers": 0,
        "profilesUsingSuchTools": 8,
        "profilesNotUsingSuchTools": 6,
        "restrictedProfilesByAutopilot": 8,
        "restrictedProfilesByDirectControl": 10
      }
    ]
  ]
}