getPhasrRecommendations: PHASR зөвлөмж авах

Энэ аргаар компанийн PHASR зөвлөмжүүдийг авна.

Параметрүүд

• `objectId` — Авах тодорхой зөвлөмжийн ID; Заавал биш; String; Хүчинтэй зөвлөмжийн ID байх ёстой. Жишээ: "objectId": "68480f4e11e8dc005bb0f9e7",
• `ruleIds` — Зөвлөмжийг нь авах дүрмүүдийн ID; Заавал биш; Array of strings; ID нь {ruleId}-{type} форматтай байх ёстой. Жишээ: "ruleIds": ["696-0", "596-1"]
• `categoryIds` — Оруулсан бол хариунд зөвхөн заасан төрлийн зөвлөмжийг буцаана; Заавал биш; Array of integers; Боломжит утгууд: 1 - tampering tool; 2 - hack tool; 3 - remote tool; 4 - miner; 5 - lol bin. Жишээ: "categoryIds": [4, 3, 2]
• `actionTaken` — Оруулсан бол хариунд зөвлөмжийн дагуу тодорхой үйлдэл хийгдсэн зөвлөмжийг л буцаана; Заавал биш; Array of integers; Боломжит утгууд: 0 - Action needed (Үйлдэл шаардлагатай). Хэрэглэгч зөвлөмжийг хянаж, арга хэмжээ авах ёстой; 1 - Applied (Хэрэглэсэн). Зөвлөмжийг үүсгэсэн бүх behavioral profile-д хэрэглэсний дараа энэ төлөв оноогдоно; 2 - Partially applied (Хэсэгчлэн хэрэглэсэн). Хэрэглэгчийн сонгосон зарим behavioral profile-д л хэрэглэсний дараа энэ төлөв оноогдоно. Жишээ: "actionTaken": [0, 1]
• `type` — Авах зөвлөмжийн төрөл; Заавал биш; Array of integers; Боломжит утгууд: 0 - Allow access (Хандалт зөвшөөрөх). Зөвшөөрөх зөвлөмжүүдийг авна; 1 - Restrict access (Хандалт хязгаарлах). Хязгаарлах зөвлөмжүүдийг авна; 2 - Allow access request (Хандалт зөвшөөрөх хүсэлт). Хандалт зөвшөөрөх хүсэлтүүдийг авна. Жишээ: "type": [0, 1, 2]
• `createdOnMin` — Зөвхөн энэ огноо, цагаас хойш үүссэн зөвлөмжийг оруулна; Заавал биш; String; Утга нь ISO 8601 огнооны форматтай байх ёстой. Жишээ: "createdOnMin": "2025-05-07T13:21:00.704Z"
• `createdOnMax` — Зөвхөн энэ огноо, цагаас өмнө үүссэн зөвлөмжийг оруулна; Заавал биш; String; Утга нь ISO 8601 огнооны форматтай байх ёстой. Жишээ: "createdOnMax": "2025-06-06T13:21:00.704Z"
• `behavioralProfileIdentities` — Зөвхөн заасан танигчтай identity-үүдэд холбогдох зөвлөмжийг оруулна; Заавал биш; Array of strings; Утгууд нь behavioral profile identity-ийн хүчинтэй форматтай байх ёстой. Жишээ: "behavioralProfileIdentities": [ "Local_S-1-5-21-4003642952-1244496884-1545565483-1003_67ff9a5be8e045f5713ee6f6", "Local_S-2-5-21-4003642952-1244496884-1545565483-1003_67ff9a5be8e045f5713ee6f7", "Local_S-3-5-21-4003642952-1244496884-1545565483-1003_67ff9a5be8e045f5713ee6f8" ]
• `behavioralProfileResources` — Зөвхөн заасан танигчтай resource-уудад холбогдох зөвлөмжийг оруулна; Заавал биш; Array of strings; Утгууд нь behavioral profile resource-ийн хүчинтэй форматтай байх ёстой. Жишээ: "behavioralProfileResources": [ "376f7eff-b0d7-49b2-825b-2af1c0f1aede-b545e199a29e", "376f7eff-b0d7-49b2-825b-2af1c0f1aede-b545e199a29a", "376f7eff-b0d7-49b2-825b-2af1c0f1aede-b545e199a29b" ]
• `sort` — Хариунд зөвлөмжийг ямар үндэслэлээр эрэмбэлэхийг тодорхойлно; Заавал биш; String; Боломжит утгууд: attackSurfaceReduction; createdOn. Жишээ: "sort": "attackSurfaceReduction"
• `dir` — Үр дүнг өсөх эсвэл буурах чиглэлд эрэмбэлэхийг тодорхойлно; Заавал биш; String; Боломжит утгууд: ASC; DESC. Жишээ: "dir": "ASC"

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

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

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

params объект дотор:

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

Буцаах утга

• `items` — Object; Тодорхой нэг зөвлөмжийн мэдээллийг агуулна.

Объектууд

items

• `objectId` — String; Зөвлөмжийн ID.
• `ruleId` — Integer; Зөвлөмжийг үүсгэсэн дүрмийн ID.
• `actionTaken` — Integer; Зөвлөмжийн дагуу хийгдсэн үйлдэл. Боломжит утгууд: 0 - allow (зөвшөөрсөн); 1 - restrict (хязгаарласан); 2 - partially applied (хэсэгчлэн хэрэглэсэн)
• `behavioralProfiles` — Integer; Дүрэм хамаарах behavioral profile-ууд.
• `attackSurfaceReduction` — Integer; Зөвлөмжийг хэрэглэснээр өөрчлөгдөх халдлагын гадаргуугийн бууралт (attack surface reduction).
• `type` — Integer; Зөвлөмжийн төрөл.
• `createdOn` — String; Зөвлөмж үүссэн огноо, цаг.

Жишээ

Хүсэлт:

{
  "params": {
    "page": 1,
    "perPage": 20,
    "companyId": "1234567890abcdef",
    "sort": "attackSurfaceReduction",
    "dir": "ASC",
    "objectId": "68480f4e11e8dc005bb0f9e7",
    "ruleIds": ["696-0", "596-1"],
    "categoryIds": [4, 3, 2],
    "actionTaken": [0, 1],
    "type": [0, 1, 2],
    "createdOnMin": "2025-05-07T13:21:00.704Z",
    "createdOnMax": "2025-06-06T13:21:00.704Z",
    "behavioralProfileIdentities": [
      "Local_S-1-5-21-4003642952-1244496884-1545565483-1003_67ff9a5be8e045f5713ee6f6",
      "Local_S-2-5-21-4003642952-1244496884-1545565483-1003_67ff9a5be8e045f5713ee6f7",
      "Local_S-3-5-21-4003642952-1244496884-1545565483-1003_67ff9a5be8e045f5713ee6f8"
    ],
    "behavioralProfileResources": [
      "376f7eff-b0d7-49b2-825b-2af1c0f1aede-b545e199a29e",
      "376f7eff-b0d7-49b2-825b-2af1c0f1aede-b545e199a29a",
      "376f7eff-b0d7-49b2-825b-2af1c0f1aede-b545e199a29b"
    ]
  },
  "jsonrpc": "2.0",
  "method": "getPhasrRecommendations",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Хариу:

{
  "page": 1,
  "pagesCount": 1,
  "perPage": 4,
  "total": 4,
  "items": [
    {
      "objectId": "6864e34452037a9169c459f3",
      "ruleId": 619,
      "actionTaken": 1,
      "behavioralProfiles": 2,
      "attackSurfaceReduction": 0.05,
      "type": 1,
      "createdOn": "2025-07-02T07:44:04.000Z"
    },
    {
      "objectId": "6864e34452037a9169c459f4",
      "ruleId": 18,
      "actionTaken": 1,
      "behavioralProfiles": 2,
      "attackSurfaceReduction": 0.05,
      "type": 1,
      "createdOn": "2025-07-02T07:44:04.000Z"
    },
    {
      "objectId": "68652b4b83b317095936ffb6",
      "ruleId": 697,
      "actionTaken": 1,
      "behavioralProfiles": 1,
      "attackSurfaceReduction": 0.01,
      "type": 0,
      "createdOn": "2025-07-02T12:51:23.000Z"
    },
    {
      "objectId": "68652b4b83b317095936ffb9",
      "ruleId": 2,
      "actionTaken": 1,
      "behavioralProfiles": 1,
      "attackSurfaceReduction": 0.01,
      "type": 0,
      "createdOn": "2025-07-02T12:51:23.000Z"
    }
  ]
}