editMonitoredRulesAccess: PHASR дүрмийн хандалтыг засах API арга

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

Энэ сонголт нь зөвлөмжийн санал болгосон үйлдлүүдийг автоматаар хэрэгжүүлж, сонгосон зорилтуудын хувьд зөвлөмжид заасан нөөцүүдэд хандах эрхийг хязгаарлах эсвэл зөвшөөрнө.

PHASR зөвлөмж бүр суралцах үе шат нь дууссан зан төлөвийн профайлуудыг агуулдаг. Зан төлөвийн профайл гэдэг нь хэрэглэгч ба түүний төхөөрөмжийн хос юм. Нэг хэрэглэгч олон төхөөрөмжтэй байж болно. Тиймээс өөр өөр зөвлөмжид ижил хэрэглэгч, өөр төхөөрөмжүүд байж болно.

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

Параметрүүд

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

- 0 — Allow access — заасан дүрмээс үүссэн зөвлөмжид тодорхойлсон нөөцүүдэд заасан зан төлөвийн профайлуудын хандах эрхийг олгоно.
- 1 — Restrict access — заасан дүрмээс үүссэн зөвлөмжид тодорхойлсон нөөцүүдэд заасан зан төлөвийн профайлуудын хандах эрхийг хязгаарлана.

Жишээ: "action": 0

• targets — хүсэлтэд: заавал; төрөл: Array of strings. Заасан дүрмээс үүссэн зөвлөмжийг хэрэгжүүлэх зан төлөвийн профайлуудын ID-уудын жагсаалт. Зан төлөвийн профайлын ID нь хэрэглэгчийн identityId-г түүнтэй хослосон төхөөрөмжийн resourceId-тай залгаж үүсгэгдэнэ. Жишээ: "targets": [ "Local_S-1-5-21-2018264366-2484004464-1617746128-1001_68308694de453e6a039e1f6d6a7f1642-bdbc-810b-a42b-e04f2611c538-005056965bef", "AD_S-1-5-21-4282359893-3999216301-2697700004-110862c11642-236f-e7bd-cf05-0f91f9346073-005056961e20", "test123" ]
• targetType — хүсэлтэд: заавал биш; төрөл: Integer. Заасан зан төлөвийн профайлуудын төрөл. Боломжит утга:

- 0 — Profile

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

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

Буцаах утга

• updated_profiles — төрөл: Array of strings. Хүсэлтийн үр дүнд амжилттай өөрчлөгдсөн зан төлөвийн профайлуудын ID-уудын жагсаалт.
• already_restricted — төрөл: Array of strings. Аль хэдийн хязгаарлагдсан тул хязгаарлаж чадаагүй зан төлөвийн профайлуудын ID-уудын жагсаалт.
• already_allowed — төрөл: Array of strings. Аль хэдийн зөвшөөрөгдсөн тул зөвшөөрч чадаагүй зан төлөвийн профайлуудын ID-уудын жагсаалт.
• errors — төрөл: Array of objects. Аль хэдийн хязгаарлагдсан эсвэл зөвшөөрөгдсөнөөс бусад шалтгаанаар шинэчилж чадаагүй зан төлөвийн профайлуудад буцаах алдааны объектуудын жагсаалт. Зан төлөвийн профайлуудыг амжилтгүй болсон шалтгаараар нь бүлэглэнэ. Объект бүр амжилтгүй болсон шалтгааныг тайлбарласан мессеж болон тэр шалтгаанаар амжилтгүй болсон бүх объектыг агуулна.

Объектууд

errors

• targets — төрөл: Array of strings. Тодорхой нэг шалтгаанаар үйлдэл амжилтгүй болсон профайл ID-уудын жагсаалт.
• message — төрөл: String. Шинэчлэлт амжилтгүй болсон шалтгааны тайлбар.

Жишээ

Хүсэлт:

{
    "params": {
      "companyId": "68306c15c9b5cb3e920ffe22",
      "ruleId": 1,
      "action": 0,
      "targets": ["Local_S-1-5-21-2018264366-2484004464-1617746128-1001_68308694de453e6a039e1f6d6a7f1642-bdbc-810b-a42b-e04f2611c538-005056965bef",
                    "AD_S-1-5-21-4282359893-3999216301-2697700004-110862c11642-236f-e7bd-cf05-0f91f9346073-005056961e20",
                    "test123"],
      "targetType":0
    },
    "jsonrpc": "2.0",
    "method": "editMonitoredRulesAccess",
    "id": "d4d50719-3215-455a-a329-086fe77f6d72"
}

Хариу:

{
  "id": "d4d50719-3215-455a-a329-086fe77f6d72",
  "jsonrpc": "2.0",
  "result": {
    "updated_profiles": [
      "AD_S-1-5-21-4282359893-3999216301-2697700004-110862c11642-236f-e7bd-cf05-0f91f9346073-005056961e20"
    ],
    "already_restricted": [
      "Local_S-1-5-21-2018264366-2484004464-1617746128-1001_68308694de453e6a039e1f6d6a7f1642-bdbc-810b-a42b-e04f2611c538-005056965bef"
    ],
    "errors": [
      {
        "targets": [
          "test123"
        ],
        "message": "Profile ID(s) not found. A valid profile ID should be constructed by concatenating the identityId and resourceId of the behavioral profile."
      }
    ]
  }
}