Skip to main content

​
Kontribusi integrasi ini

Netskope dapat menyumbangkan aktivitas web, cloud, autentikasi, perlindungan data, dan ancaman yang telah dinormalisasi. Contoh yang telah ditinjau meliputi:
  • web.ai.visited — situs web AI dikunjungi
  • data.bulk.uploaded — unggahan data dalam jumlah besar
  • geo.impossible — perjalanan mustahil (impossible travel) antara dua proses masuk
Koneksi saat ini menggunakan REST API v2; varian REST lama (legacy) mungkin muncul bagi pelanggan yang sudah ada. Lihat bagaimana data integrasi menjadi sinyal.

​
Kebutuhan Living Security

Akses endpoint yang diperlukan: Peran yang diperlukan: Tenant Admin atau peran setara dengan akses ke Settings → Tools
Integrasi ini memerlukan token API v2, bukan token v1. Token v1 menggunakan autentikasi parameter kueri dan tidak akan berfungsi dengan endpoint API v2.

​
Prasyarat

  • Anda harus memiliki akses Tenant Admin di Netskope untuk mengelola token REST API.

​
Bagian A — Di Netskope

Langkah-langkah ini diselesaikan oleh administrator Netskope Anda.
1

Buka Manajemen Token REST API v2

  1. Masuk ke konsol admin Netskope Anda di https://<tenant>.goskope.com.
  2. Pada navigasi sebelah kiri, klik Settings.
  3. Di bawah Tools, pilih REST API v2.
2

Buat token baru

  1. Klik New Token.
  2. Masukkan nama yang deskriptif (mis., Living Security Platform).
  3. Pada akses endpoint, aktifkan akses ke:
Berikan akses ke kedua endpoint. Keduanya mengalirkan dua aliran terpisah — alerts dan events — dan token yang hanya mencakup salah satunya tetap berhasil terhubung. Aliran di balik endpoint yang tidak diberikan kemudian tidak mengembalikan data apa pun, tanpa pesan kesalahan yang menjelaskan alasannya.
Kedua endpoint ini adalah satu-satunya endpoint yang dibutuhkan Living Security. Tidak memberikan akses selain keduanya sesuai dengan prinsip hak akses minimum (least privilege).
  1. Klik Save (atau Generate Token).
3

Salin dan simpan token Anda

Segera salin token dan simpan dengan aman.
Netskope menampilkan nilai token hanya satu kali saat pembuatan. Jika Anda berpindah halaman tanpa menyalinnya, Anda harus menghapus token tersebut dan membuat yang baru.
4

Konfigurasikan daftar izin IP (jika berlaku)

Jika tenant Netskope Anda mengaktifkan daftar izin IP, Anda harus menambahkan rentang IP egress Living Security.
  1. Di konsol admin Netskope, buka Settings → Administration → IP Allowlist.
  2. Jika daftar izin IP diaktifkan, tambahkan setiap alamat IP egress Living Security ke daftar Custom IP.
Jika daftar izin IP diaktifkan, dialog koneksi akan berhasil, tetapi sinkronisasi data akan gagal dengan 401 Unauthorized hingga IP yang benar ditambahkan.
5

Identifikasi subdomain tenant Anda

Subdomain tenant Anda adalah awalan dari URL konsol admin Netskope Anda.Jika URL konsol Anda adalah https://acme.goskope.com, subdomain Anda adalah acme.Masukkan subdomain saja — tanpa https://, tanpa .goskope.com, dan tanpa garis miring di akhir.
Dialog koneksi menerima beberapa bentuk masukan (subdomain saja, nama host lengkap, atau URL lengkap) dan menormalisasinya secara otomatis. Namun, disarankan untuk memasukkan subdomain saja.

​
Bagian B — Di Living Security Platform

Pemilik program menyelesaikan langkah ini, atau admin sistem jika menggunakan penyiapan yang didelegasikan.
Anda sekarang telah terhubung ke Netskope (v2 API).

​
Pemecahan masalah

Penyebab umum:
  1. Token dicabut atau kedaluwarsa — buat token baru
  2. Menggunakan token v1 — token v1 melakukan autentikasi melalui parameter kueri dan tidak akan berfungsi dengan endpoint v2. Buat token v2 baru dari Settings → Tools → REST API v2
  3. Daftar izin IP memblokir permintaan — jika tenant Anda mengaktifkan daftar izin IP, pastikan keempat alamat IP egress Living Security berada dalam daftar izin
Token dibuat tanpa akses ke /api/v2/events/data/alert atau /api/v2/events/data/page. Izin endpoint token tidak dapat diubah setelah token dibuat — buat token baru dengan akses baca ke keduanya, lalu hubungkan kembali.
Token tidak memiliki salah satu dari dua endpoint yang diperlukan. Token yang hanya mencakup /api/v2/events/data/alert atau hanya /api/v2/events/data/page tetap dapat terhubung, dan aliran di balik endpoint yang tidak diberikan tetap kosong tanpa pemberitahuan.Izin endpoint tidak dapat diubah setelah token dibuat — buat token baru dengan akses baca ke keduanya, lalu hubungkan kembali.
Jika daftar izin IP diaktifkan, alamat IP egress Living Security mungkin telah berubah. Periksa Mengonfigurasi Alamat IP Egress Integrasi dan perbarui daftar Custom IP agar sesuai.
Token v1 dan v2 menggunakan mekanisme autentikasi yang berbeda:
  • v1: Parameter kueri (token=...)
  • v2: Header (Netskope-Api-Token: ...)
Living Security menggunakan autentikasi v2. Buat token baru dari Settings → Tools → REST API v2 (bukan halaman token v1 lama).