getNetworkInventoryItems method: сүлжээний инвентарийн элементүүдийг хэрхэн авах вэ?

Энэ method нь сүлжээний инвентарийн (network inventory) элементүүдийг буцаана.

Version 1.1 (1.1 хувилбар)

Parameters (Параметрүүд)

• parentId — төрөл: String; заавал биш: Тийм; зорилтот компани эсвэл бүлгийн ID. Заагаагүй бол анхдагч утга хэрэглэгдэнэ. Анхдагч утга: хүсэлт илгээхэд ашигласан API түлхүүр харьяалагдаж буй компанийн ID.
• filters — төрөл: Object; заавал биш: Тийм; төгсгөлийн төхөөрөмжүүдийн жагсаалтаас хайхад ашиглах шүүлтүүрүүд. Боломжит бүх шүүлтүүр, тэдгээрийг хэрхэн ашиглах зааврыг Available filters хэсгээс үзнэ үү.
• page — төрөл: Number; заавал биш: Тийм; үр дүнгийн хуудасны дугаар. Анхдагч хуудасны дугаар нь 1.
• perPage — төрөл: Number; заавал биш: Тийм; нэг хуудсанд буцаах элементийн тоо. Боломжит утга: 1 - 1000. Анхдагч утга: нэг хуудсанд 30 элемент.
• options — төрөл: Object; заавал биш: Тийм; хариуд ямар мэдээлэл оруулахыг удирдах тохиргооны багц. Дэлгэрэнгүйг Available options хэсгээс үзнэ үү.

Available options (Боломжит тохиргоонууд)

Хариунд ямар өгөгдөл буцахыг options параметрээр удирдана.

• `companies` — заавал биш: Тийм; тохиргоонууд:

- returnAllProducts — true бол тухайн компанийн бүх бүтээгдэхүүний мэдээллийг хариунд оруулна. Анхдагч утга: false.
- includeRiskScore — true бол компани тус бүртэй холбоотой эрсдэлийн оноо (risk score)-ны мэдээллийг хариунд оруулна. Анхдагч утга: false.

• `endpoints` — заавал биш: Тийм; тохиргоонууд:

- returnProductOutdated — true бол тухайн компанийн бүх төгсгөлийн төхөөрөмжийн шинэчлэлтийн төлвийн мэдээлэл хариунд орно. Энэ параметр заавал биш. Анхдагч утга: false.
- includeScanLogs — true бол API хариунд lastSuccessfulScan атрибут орно. Анхдагч утга: false.
- includeRiskScore — true бол төгсгөлийн төхөөрөмж тус бүртэй холбоотой эрсдэлийн оноо (risk score)-ны мэдээллийг хариунд оруулна. Анхдагч утга: false.

Available filters (Боломжит шүүлтүүрүүд)

• `type` — шүүлтүүрийн сонголтууд:

- groups — төгсгөлийн төхөөрөмжүүдийн бүх өөрийн бүлгийг шүүх Boolean. Анхдагч утга: false.
- ec2Instances — Amazon EC2 Instance бүгдийг шүүх Boolean. Анхдагч утга: false.
- computers — бүх компьютерийг шүүх Boolean. Анхдагч утга: false.
- virtualMachines — бүх виртуал машиныг шүүх Boolean. Анхдагч утга: false.

• `security` → management — шүүлтүүрийн сонголтууд:

- managedWithBest — security agent суулгасан бүх төгсгөлийн төхөөрөмжийг шүүх Boolean. Анхдагч утга: false.
- isContainerHost — container host хамгаалалт суулгасан бүх төгсгөлийн төхөөрөмжийг шүүх Boolean. Анхдагч утга: false. Энэ шүүлтүүр computers болон virtualmachines үйлчилгээнд боломжтой.
- managedExchangeServers — хамгаалагдсан бүх Exchange серверийг шүүх Boolean. Анхдагч утга: false. Энэ шүүлтүүр нь security үйлчилгээг хамарсан хүчинтэй лицензийн түлхүүр шаардана.
- managedRelays — Relay үүрэгтэй бүх төгсгөлийн төхөөрөмжийг шүүх Boolean. Анхдагч утга: false.
- securityServers — бүх Security Server-ийг шүүх Boolean. Анхдагч утга: false.

• `depth` — шүүлтүүрийн сонголт:

- allItemsRecursively — компанийн Network Inventory доторх бүх төгсгөлийн төхөөрөмжийг рекурсив (доод түвшин хүртэл) шүүх Boolean. Анхдагч утга: false.

• `details` — шүүлтүүрийн сонголтууд:

- ssid — string; төгсгөлийн төхөөрөмжийн хамгаалалтын төлвөөс үл хамааран тэдгээрийг шүүхэд ашиглах SSID (төгсгөлийн төхөөрөмжийн Active Directory SID).
- macs — array; төгсгөлийн төхөөрөмжийн хамгаалалтын төлвөөс үл хамааран тэдгээрийг шүүхэд ашиглах MAC хаягийн жагсаалт.
- name — элементүүдийг нэрээр нь шүүх String. Хамгийн багадаа гурван тэмдэгт байх ёстой.

Return value (Буцаах утга)

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

• page — одоо харагдаж буй хуудас.
• pagesCount — нийт хуудасны тоо. Энэ мэдээлэл зөвхөн үр дүнгийн эхний хуудсанд харагдана.
• perPage — нэг хуудсанд буцсан элементийн тоо.
• total — нийт элементийн тоо. Энэ мэдээлэл зөвхөн үр дүнгийн эхний хуудсанд харагдана.
• hasMoreRecords — үр дүнгийн дараагийн хуудас байгаа эсэхийг заасан boolean.
• items — элементүүдийн жагсаалт агуулсан array. Жагсаалтын элемент бүр дараах талбартай:

- id — сүлжээний элементийн ID.
- name — сүлжээний элементийн нэр.
- parentId — эцэг контейнерын ID.
- companyId — эцэг компанийн ID.
- type — сүлжээний элементийн төрөл:
- 1 - Company (Компани)
- 2 - Root Container (Companies болон Network контейнерууд)
- 3 - Company Folder (Компанийн хавтас)
- 4 - Group (Бүлэг)
- 5 - Computer (Компьютер)
- 6 - Virtual Machine (Виртуал машин)
- 7 - EC2 Instance
- 14 - Containers Group (Контейнерын бүлэг)
- 15 - Container Host Folder (Container host-ын хавтас)
- 16 - Container (Контейнер)
- details — элементийн тухай нэмэлт мэдээлэл. Энэ талбар нь 1 - Company, 5 - Computer, 6 - Virtual Machine, 7 - EC2 Instance, 16 - Container төрлийн элементэд байдаг. details гишүүний агуулгын талаар The details member хэсгээс үзнэ үү.

The details member (details гишүүн)

Сүлжээний инвентарийн зарим элемент details гишүүнтэй байдаг. Энэ гишүүн нь элементийн талаар нэмэлт мэдээлэл өгнө. Мэдээлэл нь элементийн төрлөөс хамаарна.

• `5(computer), 6(virtual machine) and 7(EC2 Instance)` — дараах талбарууд:

- label — төгсгөлийн төхөөрөмжид оноосон шошго
- fqdn — төгсгөлийн төхөөрөмжийн FQDN
- groupId — төгсгөлийн төхөөрөмжийн бүлгийн ID
- isManaged — boolean true бол энэ төгсгөлийн төхөөрөмж удирдлагад байна
- machineType — машины төрөл: (1 - компьютер, 2 - виртуал машин, 3 - EC2 Instance, 0 - Бусад)
- operatingSystemVersion — төгсгөлийн төхөөрөмжийн үйлдлийн системийн хувилбар
- firstSeen — төгсгөлийн төхөөрөмж GravityZone-д анх бүртгэгдсэн эсвэл илрүүлэгдсэн цаг (timestamp)
- isIsolated — boolean true бол төгсгөлийн төхөөрөмж одоогоор тусгаарлах (isolation) үйлдлээр сүлжээнээс тусгаарлагдсан байна
- ip — төгсгөлийн төхөөрөмжийн дотоод IP хаяг
- publicIp — төгсгөлийн төхөөрөмжийн олон нийтийн (public) IP хаяг
- macs — төгсгөлийн төхөөрөмжийн MAC хаягийн жагсаалт
- ssid — төгсгөлийн төхөөрөмжийн Active Directory SID
- managedWithBest — boolean true бол энэ төгсгөлийн төхөөрөмжид BEST суулгасан
- isContainerHost — boolean true бол энэ төгсгөлийн төхөөрөмж Container Host мөн
- managedExchangeServer — boolean true бол энэ төгсгөлийн төхөөрөмж Exchange Server мөн
- managedRelay — boolean true бол энэ төгсгөлийн төхөөрөмж Relay үүрэгтэй
- securityServer — boolean true бол энэ төгсгөлийн төхөөрөмж Security Server мөн
- policy — төгсгөлийн төхөөрөмж дээр идэвхтэй бодлогын тухай мэдээлэл өгөх Object. Объект дараах талбартай:
- id — идэвхтэй бодлогыг өвөрмөц тодорхойлох String
- name — бодлогын нэр
- applied — бодлого одоогоор төгсгөлийн төхөөрөмж дээр хэрэгжиж байвал true болох Boolean
- movingInfo — төгсгөлийн төхөөрөмжийг нэг компаниас нөгөө рүү шилжүүлэх үеийн мэдээлэл өгөх Object. Объект дараахыг агуулна:
- state — төгсгөлийн төхөөрөмжийг шилжүүлэх төлөв (0 - явагдаж байна, 1 - шилжсэн)
- destinationCompanyName — төгсгөлийн төхөөрөмж шилжсэн компанийн нэр
- modules — суулгасан модуль болон тэдгээрийн төлвийн мэдээлэл өгөх Object. Талбарууд Boolean утгатай: true бол модуль идэвхтэй, false бол идэвхгүй. Боломжит талбарууд:
- advancedThreatControl
- antimalware
- contentControl
- deviceControl
- firewall
- powerUser
- encryption
- edrSensor
- hyperDetect
- patchManagement
- relay
- sandboxAnalyzer
- exchange
- advancedAntiExploit
- containerProtection
- networkAttackDefense
- integrityMonitoring
- productOutdated — төгсгөлийн төхөөрөмж дээрх security agent шинэчлэгдсэн эсэхийг заасан Boolean. Боломжит утга:
- true — төгсгөлийн төхөөрөмж дээрх agent шинэчлэгдсэн байна.
- false — agent-ийн хамгийн сүүлийн хувилбар суулгагдаагүй байна.
- lastSuccessfulScan — object. Дараах мэдээллийг агуулна:
- name — шалгалтын (scan) нэр.
- date — шалгалт хийгдсэн огноо.
- riskScore — төгсгөлийн төхөөрөмжийн аюулгүй байдлын эрсдэлийн тухай дараах мэдээллийг агуулсан Object:
- value — төгсгөлийн төхөөрөмжийн аюулгүй байдлын эрсдэлийн оноо, хувиар. Энэ нь буруу тохиргоо (misconfigurations) болон аппын эмзэг байдал (app vulnerabilities)-д задарна
- impact — төгсгөлийн төхөөрөмжийн аюулгүй байдлын эрсдэлийн нөлөө (Low, Medium, High)
- misconfigurations — төгсгөлийн төхөөрөмжийн эрсдэлийн оноонд буруу тохиргооны эзлэх хувь
- appVulnerabilities — төгсгөлийн төхөөрөмжийн эрсдэлийн оноонд аппын эмзэг байдлын эзлэх хувь
- humanRisks — төгсгөлийн төхөөрөмжийн эрсдэлийн оноонд хүний хүчин зүйлийн эрсдэлийн эзлэх хувь

Бусад хэсэг

• Examples
• Return value