getMonitoredRuleData: PHASR дүрмийн дэлгэрэнгүй мэдээлэл авах API арга

Тодорхой PHASR дүрэм ба түүнд хамаарах зан төлөвийн профайлуудын дэлгэрэнгүй мэдээллийг авахын тулд энэ аргыг ашиглана.

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

Параметрүүд

• companyId — хүсэлтэд: заавал биш; төрөл: String. Заасан дүрэм харьяалагдах компанийн ID. Анхдагч утга: хүсэлтэд ашигласан API түлхүүртэй холбоотой компанийн ID. Жишээ: "companyId": "68306c15c9b5cb3e920ffe22"
• ruleId — хүсэлтэд: заавал; төрөл: Integer. Мэдээллийг нь авах дүрмийн ID. Нэмэлт шаардлага байхгүй. Жишээ: "ruleId": 61
• profileType — хүсэлтэд: заавал биш; төрөл: Integer. Хариунд оруулах зан төлөвийн профайлуудын төрлийг тодорхойлно. Боломжит утга:

- 1 — Profiles using tools (хэрэгсэл ашигладаг профайлууд)
- 2 — Profiles not using tools (хэрэгсэл ашигладаггүй профайлууд)
- 3 — Profiles restricted by autopilot (autopilot-оор хязгаарласан профайлууд)
- 4 — Profiles restricted by direct control (direct control-оор хязгаарласан профайлууд)

Анхдагч утга: параметрийг хүсэлтэд оруулаагүй бол нөөцийн бүх төрлийг буцаана. Жишээ: "profileType": 61

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

Эдгээр нь 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. Нэг хуудсанд харуулах үр дүнгийн тоо. Дээд хязгаар нь нэг хуудсанд 100 зүйл. Анхдагч утга: 30.

Буцаах утга

• page — төрөл: Integer. Одоо харуулж буй хуудасны дугаар.
• perPage — төрөл: Integer. Нэг хуудсанд харуулах үр дүнгийн тоо.
• pagesCount — төрөл: Integer. Хариунд багтсан нийт хуудасны тоо.
• total — төрөл: Integer. Хариунд багтсан зан төлөвийн профайлуудын нийт тоо.
• profilesUsingSuchTools — төрөл: Integer. Хариунд багтсан, дүрмийн чиглэсэн хэрэгсэл эсвэл аргыг ашигласан шинж тэмдэг илэрсэн зан төлөвийн профайлуудын тоо.
• profilesNotUsingSuchTools — төрөл: Integer. Хариунд багтсан, дүрмийн чиглэсэн хэрэгсэл эсвэл аргыг ашигласан шинж тэмдэг илрээгүй зан төлөвийн профайлуудын тоо.
• restrictedProfilesByAutopilot — төрөл: Integer. Хариунд багтсан, энэ дүрмээс үүссэн зөвлөмжүүдийг автоматаар хэрэгжүүлсэн зан төлөвийн профайлуудын тоо.
• restrictedProfilesByDirectControl — төрөл: Integer. Хариунд багтсан, энэ дүрмээс үүссэн зөвлөмжүүдийг гараар зөвшөөрсний дараа хэрэгжүүлсэн зан төлөвийн профайлуудын тоо.
• items — төрөл: Array of objects. Хүсэлтийн параметрт таарах зан төлөвийн профайл тус бүрийн мэдээллийг өгөх объектуудын жагсаалт.

Объектууд

items

• resourceName — төрөл: String. Зан төлөвийн профайлтай холбоотой төхөөрөмжийн нэр.
• resourceId — төрөл: String. Зан төлөвийн профайлтай холбоотой төхөөрөмжийн өвөрмөц тодорхойлогч.
• identityName — төрөл: String. Зан төлөвийн профайлтай холбогдсон хэрэглэгчийн акаунтын нэр.
• identityId — төрөл: String. Зан төлөвийн профайлтай холбогдсон хэрэглэгчийн системд өвөрмөц тодорхойлогч.
• departmentId — төрөл: String. Хэрэглэгч харьяалагдах хэлтсийн өвөрмөц ID.
• departmentName — төрөл: String. Хэрэглэгч харьяалагдах хэлтсийн нэр.
• userSid — төрөл: String. Хэрэглэгчийн системийн security identifier (SID).
• profileType — төрөл: Integer. Зан төлөвийн профайлын төрөл.

Жишээ

Хүсэлт:

{
    "params": {
      "companyId": "68306c15c9b5cb3e920ffe22",
      "ruleId": 61,
      "page": 1,
      "perPage": 2
    },
    "jsonrpc": "2.0",
    "method": "getMonitoredRuleData",
    "id": "d4d50719-3215-455a-a329-086fe77f6d72"
}

Хариу:

{
  "id": "d4d50719-3215-455a-a329-086fe77f6d72",
  "jsonrpc": "2.0",
  "result": {
    "page": 1,
    "perPage": 2,
    "pagesCount": 10,
    "total": 19,
    "profilesUsingSuchTools": 1,
    "profilesNotUsingSuchTools": 9,
    "restrictedProfilesByAutopilot": 1,
    "restrictedProfilesByDirectControl": 1,
    "items": [
      {
        "resourceName": "CMOCANU-SELENIU",
        "resourceId": "6a7f1642-bdbc-810b-a42b-e04f2611c538-005056965bef",
        "identityName": "CMOCANU-SELENIU\\bdvm",
        "identityId": "Local_S-1-5-21-2018264366-2484004464-1617746128-1001_68308694de453e6a039e1f6d",
        "departmentId": "683072526ed41db183242348",
        "departmentName": "Department 8",
        "userSid": "S-1-5-21-2018264366-2484004464-1617746128-1001",
        "profileType": 1
      },
      {
        "resourceName": "WIN-06",
        "resourceId": "62c11642-236f-e7bd-cf05-0f91f9346073-005056961e20",
        "identityName": "ROOT\\hr1",
        "identityId": "AD_S-1-5-21-4282359893-3999216301-2697700004-1108",
        "departmentId": "6834222e6ed41db1833ca84c",
        "departmentName": "Department 7",
        "userSid": "S-1-5-21-4282359893-3999216301-2697700004-1108",
        "profileType": 2
      }
    ]
  }
}