Skip to main content

​
Bu entegrasyonun sağladığı katkılar

Netskope, normalleştirilmiş web, bulut, kimlik doğrulama, veri koruma ve tehdit etkinliklerine katkı sağlayabilir. İncelenen örnekler şunlardır:
  • web.ai.visited — Yapay zekâ web sitesi ziyaret edildi
  • data.bulk.uploaded — toplu veri yüklemesi
  • geo.impossible — oturum açma işlemleri arasında imkânsız seyahat
Mevcut bağlantı REST API v2 kullanır; mevcut müşteriler için eski bir REST varyantı görünebilir. Bkz. entegrasyon verilerinin Sinyaller’e dönüşme şekli.

​
Living Security’nin gereksinimleri

Gerekli uç nokta erişimi: Gerekli rol: Tenant Admin veya Settings → Tools bölümüne erişimi olan eşdeğer bir rol
Bu entegrasyon, v1 token’ı değil, v2 API token’ı gerektirir. V1 token’ları sorgu parametresiyle kimlik doğrulaması kullanır ve v2 API uç noktasıyla çalışmaz.

​
Ön koşullar

  • REST API token’larını yönetmek için Netskope’ta Tenant Admin erişiminiz olmalıdır.

​
Bölüm A — Netskope’ta

Bu adımlar Netskope yöneticiniz tarafından tamamlanır.
1

REST API v2 Token Management sayfasına gidin

  1. https://<tenant>.goskope.com adresindeki Netskope yönetici konsolunda oturum açın.
  2. Sol gezinme bölümünde Settings öğesine tıklayın.
  3. Tools altında REST API v2 öğesini seçin.
2

Yeni bir token oluşturun

  1. New Token öğesine tıklayın.
  2. Açıklayıcı bir ad girin (ör. Living Security Platform).
  3. Uç nokta erişimi altında aşağıdakilere erişimi etkinleştirin:
Her iki uç noktaya da erişim verin. Bunlar alerts ve events adlı iki ayrı akışı besler ve yalnızca birini kapsayan bir token yine de başarıyla bağlanır. Eksik uç noktanın arkasındaki akış ise nedenini belirten bir hata olmaksızın hiçbir şey döndürmez.
Living Security için gerekli olan tek uç noktalar bu ikisidir. Bunların ötesinde hiçbir şey vermemek, en az ayrıcalık ilkesine uygundur.
  1. Save (veya Generate Token) öğesine tıklayın.
3

Token'ınızı kopyalayın ve kaydedin

Token’ı hemen kopyalayın ve güvenli bir yerde saklayın.
Netskope, token değerini oluşturulma sırasında yalnızca bir kez gösterir. Kopyalamadan başka bir sayfaya geçerseniz token’ı silmeniz ve yenisini oluşturmanız gerekir.
4

IP izin listesini yapılandırın (varsa)

Netskope kiracınızda IP izin listesi etkinse Living Security’nin çıkış IP aralıklarını eklemeniz gerekir.
  1. Netskope yönetici konsolunda Settings → Administration → IP Allowlist yolunu izleyin.
  2. IP izin listesi etkinse her bir Living Security çıkış IP adresini Custom IP listesine ekleyin.
IP izin listesi etkinse bağlantı iletişim kutusu başarılı olur ancak doğru IP’ler eklenene kadar veri senkronizasyonları 401 Unauthorized hatasıyla başarısız olur.
5

Kiracı alt alan adınızı belirleyin

Kiracı alt alan adınız, Netskope yönetici konsolu URL’nizin ön ekidir.Konsol URL’niz https://acme.goskope.com ise alt alan adınız acme olur.Yalnızca alt alan adını girin — https:// yok, .goskope.com yok, sonda eğik çizgi yok.
Bağlantı iletişim kutusu birkaç giriş biçimini (yalnızca alt alan adı, tam ana bilgisayar adı veya tam URL) kabul eder ve otomatik olarak normalleştirir. Ancak yalnızca alt alan adının girilmesi önerilir.

​
Bölüm B — Living Security Platform’da

Bu adımı program sahibi veya devredilmiş kurulum kullanılıyorsa sistem yöneticisi tamamlar.
Artık Netskope’a (v2 API) bağlandınız.

​
Sorun giderme

Yaygın nedenler:
  1. Token iptal edilmiş veya süresi dolmuş — yeni bir token oluşturun
  2. v1 token kullanılıyor — v1 token’ları sorgu parametresiyle kimlik doğrular ve v2 uç noktalarıyla çalışmaz. Settings → Tools → REST API v2 bölümünden yeni bir v2 token’ı oluşturun
  3. IP izin listesi istekleri engelliyor — kiracınızda IP izin listesi etkinse dört Living Security çıkış IP adresinin tümünün izin listesinde olduğunu doğrulayın
Token, /api/v2/events/data/alert veya /api/v2/events/data/page erişimi olmadan oluşturulmuş. Token uç nokta izinleri oluşturulduktan sonra değiştirilemez — her ikisine de okuma erişimi olan yeni bir token oluşturun ve yeniden bağlanın.
Token, gerekli iki uç noktadan birine sahip değil. Yalnızca /api/v2/events/data/alert veya yalnızca /api/v2/events/data/page kapsamına sahip bir token yine de bağlanır ve eksik uç noktanın arkasındaki akış sessizce boş kalır.Uç nokta izinleri token oluşturulduktan sonra değiştirilemez — her ikisine de okuma erişimi olan yeni bir token oluşturun, ardından yeniden bağlanın.
IP izin listesi etkinse Living Security’nin çıkış IP adresleri değişmiş olabilir. Entegrasyon Çıkış IP Adreslerini Yapılandırma sayfasını kontrol edin ve Custom IP listesini buna uygun olarak güncelleyin.
V1 ve v2 token’ları farklı kimlik doğrulama mekanizmaları kullanır:
  • v1: Sorgu parametresi (token=...)
  • v2: Üst bilgi (Netskope-Api-Token: ...)
Living Security, v2 kimlik doğrulamasını kullanır. Settings → Tools → REST API v2 bölümünden (eski v1 token sayfasından değil) yeni bir token oluşturun.