Skip to main content

​
Ushbu integratsiya nimalarni taqdim etadi

Netskope normallashtirilgan veb, bulut, autentifikatsiya, ma’lumotlarni himoya qilish va tahdidlar faoliyati ma’lumotlarini taqdim etishi mumkin. Ko‘rib chiqilgan misollar:
  • web.ai.visited — AI veb-saytiga kirilgan
  • data.bulk.uploaded — ma’lumotlarni ommaviy yuklash
  • geo.impossible — tizimga kirishlar orasida imkonsiz joy almashish (impossible travel)
Joriy ulanish REST API v2 dan foydalanadi; mavjud mijozlar uchun eski REST varianti ko‘rinishi mumkin. Integratsiya ma’lumotlari qanday qilib Signals’ga aylanishi bilan tanishing.

​
Living Security uchun nimalar talab qilinadi

Zarur endpoint ruxsatlari: Talab etiladigan rol: Tenant Admin yoki Settings → Tools bo‘limiga kirish huquqiga ega unga teng rol
Ushbu integratsiya v2 API tokenini talab qiladi, v1 tokenini emas. V1 tokenlari so‘rov parametri orqali autentifikatsiyadan foydalanadi va v2 API endpointi bilan ishlamaydi.

​
Dastlabki shartlar

  • REST API tokenlarini boshqarish uchun Netskope’da Tenant Admin huquqiga ega bo‘lishingiz kerak.

​
A qism — Netskope’da

Ushbu qadamlarni Netskope administratoringiz bajaradi.
1

REST API v2 token boshqaruviga o‘ting

  1. Netskope administrator konsoliga https://<tenant>.goskope.com manzili orqali kiring.
  2. Chap navigatsiya panelida Settings tugmasini bosing.
  3. Tools ostida REST API v2 ni tanlang.
2

Yangi token yarating

  1. New Token tugmasini bosing.
  2. Tavsiflovchi nom kiriting (masalan, Living Security Platform).
  3. Endpointga ruxsat bo‘limida quyidagilarga ruxsatni yoqing:
Ikkala endpointga ham ruxsat bering. Ular ikkita alohida oqimni — alerts va events ni — ta’minlaydi, va faqat bittasiga ruxsat berilgan token baribir muvaffaqiyatli ulanadi. Yetishmayotgan endpoint ortidagi oqim esa hech narsa qaytarmaydi, sababini ko‘rsatuvchi xato ham chiqmaydi.
Living Security uchun faqat shu ikkita endpoint talab qilinadi. Ulardan ortiq ruxsat bermaslik minimal huquqlar tamoyiliga mos keladi.
  1. Save (yoki Generate Token) tugmasini bosing.
3

Tokenni nusxalab saqlang

Tokenni darhol nusxalang va xavfsiz joyda saqlang.
Netskope token qiymatini yaratilganda faqat bir marta ko‘rsatadi. Agar uni nusxalamasdan sahifadan chiqib ketsangiz, tokenni o‘chirib, yangisini yaratishingiz kerak bo‘ladi.
4

IP allowlist’ni sozlang (agar qo‘llanilsa)

Agar Netskope tenantingizda IP allowlisting yoqilgan bo‘lsa, Living Security’ning chiquvchi (egress) IP diapazonlarini qo‘shishingiz kerak.
  1. Netskope administrator konsolida Settings → Administration → IP Allowlist bo‘limiga o‘ting.
  2. Agar IP allowlisting yoqilgan bo‘lsa, har bir Living Security egress IP manzilini Custom IP ro‘yxatiga qo‘shing.
Agar IP allowlisting yoqilgan bo‘lsa, ulanish oynasi muvaffaqiyatli ishlaydi, lekin to‘g‘ri IP manzillar qo‘shilmaguncha ma’lumotlar sinxronizatsiyasi 401 Unauthorized xatosi bilan tugaydi.
5

Tenant subdomeningizni aniqlang

Tenant subdomeningiz — Netskope administrator konsoli URL manzilining prefiksidir.Agar konsol URL manzilingiz https://acme.goskope.com bo‘lsa, subdomeningiz acme bo‘ladi.Faqat oddiy subdomenni kiriting — https:// ham, .goskope.com ham, oxirida qiyshiq chiziq ham bo‘lmasin.
Ulanish oynasi bir nechta kiritish shaklini (oddiy subdomen, to‘liq hostname yoki to‘liq URL) qabul qiladi va avtomatik normallashtiradi. Biroq oddiy subdomenni kiritish tavsiya etiladi.

​
B qism — Living Security Platform’da

Bu qadamni dastur egasi yoki, agar delegatsiya qilingan sozlash qo‘llanilsa, tizim administratori bajaradi.
Endi Netskope (v2 API) ulandi.

​
Nosozliklarni bartaraf etish

Odatiy sabablar:
  1. Token bekor qilingan yoki muddati tugagan — yangi token yarating
  2. v1 tokenidan foydalanilmoqda — v1 tokenlari so‘rov parametri orqali autentifikatsiya qiladi va v2 endpointlari bilan ishlamaydi. Settings → Tools → REST API v2 bo‘limidan yangi v2 tokenini yarating
  3. IP allowlist so‘rovlarni bloklamoqda — agar tenantingizda IP allowlisting yoqilgan bo‘lsa, Living Security egress IP manzillarining to‘rttalasi ham allowlist’da ekanini tekshiring
Token /api/v2/events/data/alert yoki /api/v2/events/data/page ga ruxsatsiz yaratilgan. Tokenning endpoint ruxsatlarini yaratilgandan keyin o‘zgartirib bo‘lmaydi — ikkalasiga ham read ruxsati bilan yangi token yarating va qayta ulaning.
Tokenda ikki zarur endpointdan biri yetishmaydi. Faqat /api/v2/events/data/alert yoki faqat /api/v2/events/data/page ga ruxsat berilgan token baribir ulanadi, va yetishmayotgan endpoint ortidagi oqim indamay bo‘sh qoladi.Endpoint ruxsatlarini token yaratilgandan keyin o‘zgartirib bo‘lmaydi — ikkalasiga ham read ruxsati bilan yangi token yarating, so‘ng qayta ulaning.
Agar IP allowlisting yoqilgan bo‘lsa, Living Security’ning egress IP manzillari o‘zgargan bo‘lishi mumkin. Configuring Integration Egress IP Addresses sahifasini tekshiring va Custom IP ro‘yxatini shunga mos ravishda yangilang.
V1 va v2 tokenlari turli autentifikatsiya mexanizmlaridan foydalanadi:
  • v1: So‘rov parametri (token=...)
  • v2: Sarlavha (Netskope-Api-Token: ...)
Living Security v2 autentifikatsiyasidan foydalanadi. Yangi tokenni Settings → Tools → REST API v2 bo‘limidan yarating (eski v1 token sahifasidan emas).