Skip to main content

​
यह इंटीग्रेशन क्या योगदान देता है

Netskope सामान्यीकृत (normalized) वेब, क्लाउड, ऑथेंटिकेशन, डेटा-सुरक्षा और थ्रेट गतिविधि का योगदान दे सकता है। समीक्षा किए गए उदाहरणों में शामिल हैं:
  • web.ai.visited — AI वेबसाइट पर विज़िट किया गया
  • data.bulk.uploaded — बल्क डेटा अपलोड
  • geo.impossible — साइन-इन के बीच असंभव यात्रा (impossible travel)
वर्तमान कनेक्शन REST API v2 का उपयोग करता है; मौजूदा ग्राहकों के लिए एक लीगेसी REST वेरिएंट दिखाई दे सकता है। देखें इंटीग्रेशन डेटा Signals में कैसे बदलता है।

​
Living Security को क्या चाहिए

आवश्यक एंडपॉइंट एक्सेस: आवश्यक भूमिका: Tenant Admin या समकक्ष भूमिका, जिसके पास Settings → Tools की एक्सेस हो
इस इंटीग्रेशन के लिए v2 API token आवश्यक है, v1 टोकन नहीं। V1 टोकन क्वेरी पैरामीटर ऑथेंटिकेशन का उपयोग करते हैं और v2 API एंडपॉइंट के साथ काम नहीं करेंगे।

​
पूर्वापेक्षाएँ

  • REST API टोकन प्रबंधित करने के लिए Netskope में आपके पास Tenant Admin एक्सेस होना आवश्यक है।

​
भाग A — Netskope में

ये चरण आपके Netskope एडमिनिस्ट्रेटर द्वारा पूरे किए जाते हैं।
1

REST API v2 Token Management पर जाएँ

  1. https://<tenant>.goskope.com पर अपने Netskope एडमिन कंसोल में साइन इन करें।
  2. बाएँ नेविगेशन में Settings पर क्लिक करें।
  3. Tools के अंतर्गत REST API v2 चुनें।
2

नया टोकन बनाएँ

  1. New Token पर क्लिक करें।
  2. एक वर्णनात्मक नाम दर्ज करें (उदा., Living Security Platform)।
  3. एंडपॉइंट एक्सेस के अंतर्गत, निम्नलिखित के लिए एक्सेस सक्षम करें:
दोनों एंडपॉइंट को एक्सेस दें। ये दो अलग-अलग स्ट्रीम — alerts और events — को डेटा देते हैं, और केवल एक एंडपॉइंट तक सीमित टोकन भी सफलतापूर्वक कनेक्ट हो जाता है। तब छूटे हुए एंडपॉइंट वाली स्ट्रीम कुछ भी नहीं लौटाती, और कारण बताने वाली कोई त्रुटि नहीं दिखती।
Living Security को केवल यही दो एंडपॉइंट चाहिए। इनसे अधिक कुछ भी एक्सेस न देना न्यूनतम विशेषाधिकार (least privilege) के सिद्धांत का पालन करता है।
  1. Save (या Generate Token) पर क्लिक करें।
3

अपना टोकन कॉपी करें और सहेजें

टोकन को तुरंत कॉपी करें और उसे सुरक्षित रूप से संग्रहीत करें।
Netskope टोकन का मान बनाते समय केवल एक बार दिखाता है। यदि आप उसे कॉपी किए बिना पेज से हट जाते हैं, तो आपको टोकन हटाकर नया टोकन बनाना होगा।
4

IP allowlist कॉन्फ़िगर करें (यदि लागू हो)

यदि आपके Netskope टेनेंट में IP allowlisting सक्षम है, तो आपको Living Security की egress IP रेंज जोड़नी होंगी।
  1. Netskope एडमिन कंसोल में Settings → Administration → IP Allowlist पर जाएँ।
  2. यदि IP allowlisting सक्षम है, तो प्रत्येक Living Security egress IP address को Custom IP सूची में जोड़ें।
यदि IP allowlisting सक्षम है, तो कनेक्शन डायलॉग सफल होगा, लेकिन सही IP जोड़े जाने तक डेटा सिंक 401 Unauthorized के साथ विफल होंगे।
5

अपना टेनेंट सबडोमेन पहचानें

आपका टेनेंट सबडोमेन आपके Netskope एडमिन कंसोल URL का प्रीफ़िक्स होता है।यदि आपके कंसोल का URL https://acme.goskope.com है, तो आपका सबडोमेन acme है।केवल सादा सबडोमेन दर्ज करें — न https://, न .goskope.com, और न ही अंत में स्लैश।
कनेक्शन डायलॉग कई इनपुट रूप (सादा सबडोमेन, पूर्ण होस्टनेम या पूर्ण URL) स्वीकार करता है और उन्हें स्वतः सामान्यीकृत कर देता है। फिर भी, सादा सबडोमेन दर्ज करना अनुशंसित है।

​
भाग B — Living Security Platform में

यह चरण प्रोग्राम ओनर द्वारा पूरा किया जाता है, या प्रतिनिधित्व (delegated) सेटअप का उपयोग करने पर सिस्टम एडमिन द्वारा।
अब आप Netskope (v2 API) से कनेक्ट हो गए हैं।

​
समस्या निवारण

सामान्य कारण:
  1. टोकन रद्द या समाप्त हो गया है — नया टोकन जनरेट करें
  2. v1 टोकन का उपयोग — v1 टोकन क्वेरी पैरामीटर के माध्यम से ऑथेंटिकेट करते हैं और v2 एंडपॉइंट के साथ काम नहीं करेंगे। Settings → Tools → REST API v2 से नया v2 टोकन जनरेट करें
  3. IP allowlist अनुरोधों को ब्लॉक कर रही है — यदि आपके टेनेंट में IP allowlisting सक्षम है, तो सत्यापित करें कि सभी चारों Living Security egress IP addresses allowlist में हैं
टोकन /api/v2/events/data/alert या /api/v2/events/data/page की एक्सेस के बिना बनाया गया था। टोकन की एंडपॉइंट अनुमतियाँ बनाने के बाद बदली नहीं जा सकतीं — दोनों के लिए read एक्सेस वाला नया टोकन बनाएँ और फिर से कनेक्ट करें।
टोकन में दो आवश्यक एंडपॉइंट में से एक छूटा हुआ है। केवल /api/v2/events/data/alert या केवल /api/v2/events/data/page तक सीमित टोकन भी कनेक्ट हो जाता है, और छूटे हुए एंडपॉइंट वाली स्ट्रीम चुपचाप खाली रहती है।टोकन बनने के बाद एंडपॉइंट अनुमतियाँ बदली नहीं जा सकतीं — दोनों के लिए read एक्सेस वाला नया टोकन जनरेट करें, फिर दोबारा कनेक्ट करें।
यदि IP allowlisting सक्षम है, तो हो सकता है Living Security के egress IP addresses बदल गए हों। Configuring Integration Egress IP Addresses देखें और Custom IP सूची को उसके अनुसार अपडेट करें।
V1 और v2 टोकन अलग-अलग ऑथेंटिकेशन तंत्र का उपयोग करते हैं:
  • v1: क्वेरी पैरामीटर (token=...)
  • v2: हेडर (Netskope-Api-Token: ...)
Living Security v2 ऑथेंटिकेशन का उपयोग करता है। Settings → Tools → REST API v2 से नया टोकन जनरेट करें (लीगेसी v1 टोकन पेज से नहीं)।