समीक्षा
Cato AI सुरक्षा उपयोगकर्ता गतिविधि को GenAI अनुप्रयोगों के साथ लॉग करता है और आपके स्वनिर्मित एजेंटों द्वारा मॉडल को भेजे गए अनुरोध। घटनाएँ Cato प्रबंधन अनुप्रयोग (CMA) में होम > इवेंट्स पृष्ठ पर दिखाई देती हैं, और इन्हें प्रतिधारण, सहसंबंध और अलर्टिंग के लिए SIEM, डेटा लेक या अन्य बाहरी प्लेटफार्म पर अग्रेषित किया जा सकता है।
घटनाएँ केवल मेटाडेटा ले जाती हैं। मॉडल के साथ आदान-प्रदान किए गए प्रॉम्प्ट और प्रतिक्रियाएँ घटना में संग्रहीत नहीं होती हैं। उस सामग्री को अलग से, आवश्यकता के अनुसार, Cato के GraphQL API से प्राप्त किया जाता है, जिसमें एक कॉलर होता है जिसकी API कुंजी में आवश्यक अनुमति होती है।
AI सुरक्षा खोज का अन्वेषण करना इसलिए दो-चरणीय कार्यप्रवाह है:
घटनाओं को आपके SIEM को अग्रेषित करें। AI सुरक्षा घटना प्रकार के लिए फ़िल्टर किए गए एक घटना एकीकरण को विन्यस्त करें, ताकि AI सुरक्षा घटनाएँ आपकी Cato टेलीमेट्री के बाकी हिस्से के साथ पहुंचें।
API का उपयोग करके उन घटनाओं के लिए संवेदनशील सामग्री प्राप्त करें जो इसकी आवश्यकता करती हैं। जब किसी घटना की जाँच की आवश्यकता होती है, तो उस घटना पर लाए गए पहचानकर्ताओं के साथ API से पूछें ताकि प्रॉम्प्ट और मॉडल प्रतिक्रिया प्राप्त की जा सके।
नोट: AI सुरक्षा इंटरैक्शन, जिसमें संवेदनशील प्रॉम्प्ट और प्रतिक्रिया शामिल हैं, सीधे CMA में एपीआई का उपयोग किए बिना समीक्षा की जा सकती हैं। ऐप्स के लिए AI सुरक्षा > इंटरैक्शन एक्सप्लोरर आपके Homegrown Agents के लिए जूनेंस को सूचीबद्ध करता है, और उपयोगकर्ताओं के लिए AI सुरक्षा > सेशन एक्सप्लोरर उपयोगकर्ता सत्रों को GenAI एप्लिकेशनों के साथ सूचीबद्ध करता है। दोनों आपको एक व्यक्तिगत रिकॉर्ड में गहराई से जांचने की अनुमति देते हैं। एपीआई की योजना आपके SIEM से शुरू होने वाले अन्वेषणों और प्रोग्रामेटिक पुनर्प्राप्ति के लिए की गई है।
Cato घटनाएं
सभी AI सुरक्षा घटनाएँ घटना प्रकार AI सुरक्षा को ले जाती हैं। घटना उप-प्रकार यह पहचानता है कि AI सुरक्षा का कौन सा भाग घटना उत्पन्न की और यह निर्धारित करता है कि घटना कौन से क्षेत्र ले जाती है और कौन सा एपीआई क्वेरी इसकी सामग्री लौटाती है। एक इंटरएक्टिव घटना स्कीमा एक्सप्लोरर Cato Event Schema पर उपलब्ध है।
CMA मॉड्यूल | ईवेंट उप-प्रकार | विवरण |
|---|---|---|
उपयोगकर्ताओं के लिए AI सुरक्षा | AI उपयोगकर्ता इंटरैक्शन | GenAI एप्लिकेशनों के साथ उपयोगकर्ता गतिविधि द्वारा उत्पन्न |
एप्लिकेशन के लिए AI सुरक्षा | अनुप्रयोग रनटाइम सुरक्षा | जब एक गार्ड नीति आपके Homegrown Agents में से एक को सुरक्षित रखते हुए एक इंटरैक्शन पर क्रिया लेती है तब उत्पन्न होता है। |
AI उपयोगकर्ता इंटरैक्शन फ़ील्ड्स
फील्ड | प्रकार | विवरण |
|---|---|---|
अकाउंट_आईडी / अकाउंट_नाम | लंबा / कीवर्ड | Cato अकाउंट पहचानकर्ता और प्रदर्शित नाम। |
ad_नाम / उपयोगकर्ता_आईडी / उपयोगकर्ता_नाम | कीवर्ड / लंबा / कीवर्ड | Cato उपयोगकर्ता, और उनका Active Directory प्रदर्शित नाम। |
vpn_user_email | कुंजी शब्द | उपयोगकर्ता का ईमेल पता। यह वह फ़ील्ड है जिस पर जब जाँच की शुरुआत ईमेल पते से होती है तो उसे फ़िल्टर करना होता है। |
एप्लिकेशन_आईडी / एप्लिकेशन_नाम | कुंजी शब्द | GenAI एप्लिकेशन, उदाहरण के लिए माइक्रोसॉफ्ट_कोपिलॉट / माइक्रोसॉफ्ट कोपिलॉट। |
एप्लिकेशन_प्रकार / श्रेणियाँ | कुंजी शब्द | एप्लिकेशन वर्गीकरण, उदाहरण के लिए, प्रकार सिस्टम और श्रेणी जनरेटिव AI उपकरण। |
ai_app_जोखिम_स्तर / अनुप्रयोग_जोखिम | कीवर्ड / संख्या | एप्लिकेशन के लिए Cato की जोखिम रेटिंग, एक लेबल और एक संख्यात्मक स्कोर के रूप में। |
is_cloud_app / is_sanctioned_app | बूलियन | क्या एप्लिकेशन क्लाउड पर होस्ट किया गया है, और क्या इसे खाते के लिए स्वीकृत किया गया है। |
एप्लिकेशन_गतिविधि_प्रकार | कुंजी शब्द | घटना जो गतिविधि दर्शाती है। संभव मूल्य: वेब अनुरोध, प्रॉम्प्ट, डिटेक्शन, LLM प्रतिक्रिया, फ़ाइल लेनदेन, सहभागिता प्रतिक्रिया। |
नियम आईडी / नियम नाम | कुंजी शब्द | नीति नियम जो मान्य, जहां एक सक्रिय थी। app_activity_type से स्वतंत्र और किसी एक मूल्य के लिए विशिष्ट नहीं। |
इवेंट_आईडी | कुंजी शब्द | अद्वितीय घटना पहचानकर्ता। |
समय / समय_स्ट्रिंग | तिथि (एपोक ms) / तिथि (ISO-8601) | कब इंटरएक्शन हुआ, दोनों रूपों में। |
सत्र_आईडी / संदेश_आईडी | कुंजी शब्द | सत्रसंवाद क्वेरी को पास, आवेदन_आईडी के साथ। संदेश_आईडी एक प्रॉम्प्ट घटना को उसके संबंधित डिटेक्शन और LLM प्रतिक्रिया घटनाओं के साथ जोड़ती है। |
आह्वान_आईडी | कुंजी शब्द | संदेश_आईडी के समान सेट को एक अलग पहचानकर्ता namespace में जोड़ता है, और इसे किसी भी सामग्री क्वेरी द्वारा उपयोग नहीं किया जाता है। |
इंटरैक्शन_इरादा | कुंजी शब्द | प्रॉम्प्ट के पीछे वर्गीकृत इरादा, उदाहरण के लिए, जानकारी प्राप्त करना। |
इंटरैक्शन_विषय / इंटरैक्शन_उप_विषय | कुंजी शब्द | वर्गीकृत विषय, उदाहरण के लिए, कानूनी / डेटा गोपनीयता. |
यूआरएल / रेफरर_यूआरएल | कुंजी शब्द | 페이지 URL और संदर्भ पेज URL, जहां लागू हो |
file_name | कुंजी शब्द | स्थानांतरित फाइल का नाम. केवल तब उपस्थित जब ऐप_गतिविधि_प्रकार फाइल लेनदेन है. |
लगाव_परिणाम_क्रिया | कुंजी शब्द | उपयोगकर्ता के संलग्नता नीति प्रॉम्प्ट का उत्तर देने के बाद की गई कार्रवाई. |
उपयोगकर्ता_न्यायसंगतता | कुंजी शब्द | उपयोगकर्ता का संलग्नता नीति प्रॉम्प्ट पर उत्तर, |
event_count | पूर्णांक | रेकोर्ड जिस संख्या में दर्शाता है, वह घटनाएँ हैं. |
कैटो_एप्लिकेशन | कुंजी शब्द | जेनएआई एप्लिकेशन के लिए कैटो एप्लिकेशन पहचानकर्ता, उदाहरण के लिए, चैटजीपीटी. |
नोट: हर घटना में प्रिय सामग्री नहीं होती है. सेशन_आईडी और संदेश_आईडी केवल उन्हीं घटनाओं में दिखाई देते हैं जहां ऐप_गतिविधि_प्रकार प्रॉम्प्ट, डिटेक्शन, या LLM प्रतिक्रिया है. वेब अनुरोध और फाइल लेन-देन की घटनाएं उन्हें नहीं ले जाती हैं.
एप्लिकेशन रनटाइम सुरक्षा फ़ील्ड्स
फील्ड | विवरण |
|---|---|
घटना_प्रकार / घटना_उप_प्रकार | हमेशा एआई सुरक्षा / एप्लिकेशन रनटाइम सुरक्षा के लिए ये घटनाएं. अपनी एकीकरण या घटनाओं पृष्ठ पर फ़िल्टर के लिए इन मानों का उपयोग करें. |
घटना_आईडी / घटना_गिनती | अद्वितीय घटना पहचानकर्ता और रिकॉर्ड के संपर्क में दिखाए गए घटनाओं की संख्या. |
समय / समय_स्ट्र | जब अंतःक्रिया रोकी गई थी, मिलीसेकंड में एक युग समय और एक ISO-8601 UTC स्ट्रिंग के रूप में. |
खाता_आईडी / खाता_नाम | कैटो खाता पहचानकर्ता और प्रदर्शन नाम. खाता_आईडी वह मान है जिसे एपीआई क्वेरीज को खाता_आईडी के रूप में भेजा जाता है. |
गार्ड_आईडी / गार्ड_नाम | गार्ड जो एप्लिकेशन की रक्षा करता है और फैसला दे रहा है. |
नियम_आईडी / नियम_नाम | मेसेज करने वाले विशिष्ट गार्ड नीति नियम. |
क्रिया | प्रवर्तन परिणाम, जैसे गुमनाम करना, अवरुद्ध करना, या निगरानी करना. |
डिटेक्टर्स | इस अंतःक्रिया के लिए ट्रिगर किए गए डिटेक्टर, एक सरणी के रूप में — उदाहरण के लिए, एक PII डिटेक्टर. |
एप्लिकेशन_आईडी | घरेलू एजेंट जिसे गार्ड सुरक्षित कर रहा है. |
अनुकूलन_आईडी | जांच की कुंजी. विशिष्ट अंतःक्रिया को पहचानते हैं और अनुकूलन क्वेरी को प्रॉम्प्ट और प्रतिक्रिया को पुनःप्राप्त करने के लिए पास किए गए मान हैं. |
सेशन_आईडी | वही वार्तालाप सत्र में होने वाली चुटकियों को समूह करता है. |
कैटो_एप / क्या_क्लाउड_एप / क्या_मान्यता_एप | यह घटना पर उपस्थित है लेकिन ऐप्स के लिए एआई सुरक्षा जांच के लिए प्रासंगिक नहीं है. |
परिभाषा. CMA में घरेलू एजेंट किसे कहा जाता है, वह इस घटना में एक एप्लिकेशन के रूप में संदर्भित है. एप्लिकेशन_आईडी फील्ड घरेलू एजेंट की पहचान करता है जिसे गार्ड सुरक्षित कर रहा है.
इवेंट्स को एक सिएम में भेजना
इवेंट इंटीग्रेशन कैटो इवेंट डेटा को बाहरी प्लेटफॉर्म और स्टोरेज गंतव्यों पर स्वतः भेजते हैं, बिना मैनुअल एक्सपोर्ट या निरंतर पोलिंग के. एकीकरण CMA में संसाधन > एकीकरण > विन्यासित एकीकरण में कॉन्फ़िगर किए जाते हैं. अवलोकन के लिए देखें इवेंट इंटीग्रेशन के साथ प्रारंभ करना.
यदि एक देशी एकीकरण उपलब्ध नहीं है, तो कस्टम HTTP पुश इंटीग्रेशन का उपयोग JSON प्रारूप में अपनी पसंद के गंतव्य पर इवेंट्स को पुश करने के लिए किया जा सकता है. कस्टम हेडर को कॉन्फ़िगर किया जा सकता है, जो इसे विभिन्न विक्रेता के साथ संगत बनाता है. अधिक जानकारी के लिए देखें कस्टम HTTP पुश इंटीग्रेशन के साथ डेटा भेजना.
एआई सुरक्षा घटनाओं के लिए फ़िल्टरिंग
आप जिस भी एकीकरण को चुनते हैं, उसे एआई सुरक्षा घटनाओं के लिए प्रमाणीकरण दें न कि खाते की पूर्ण घटना मात्रा को अग्रेषित करें. यह घटनाएँ फ़िल्टर में किया जाता है, जो एक या अधिक फ़िल्टर समूहों से बना होता है: समूह में स्थितियाँ AND के साथ संयोजित होती हैं, और समूह OR के साथ संयोजित होते हैं, इसलिए यदि कोई घटना किसी भी समूह से मेल खाती है तो वह अग्रेषित होती है. कोई घटना फ़ील्ड एक शर्त के रूप में उपलब्ध है.
घटनाएँ फ़िल्टर के लिए एक फ़िल्टर समूह जोड़ें. एकीकरण विन्यास में, घटनाएँ फ़िल्टर खोलें और एक फिल्टर समूह जोड़ें.
घटना प्रकार शर्त सेट करें. फील्ड घटना प्रकार, मान एआई सुरक्षा. यह समूह को सभी उप-प्रकारों की एआई सुरक्षा घटनाओं से प्रमाणीकरण निर्धारित करता है.

(वैकल्पिक) उप-प्रकार शर्त सेट करें. फील्ड उप-प्रकार, एआई उपयोगकर्ता इंटरैक्शन और एप्लिकेशन रनटाइम सुरक्षा के मान के साथ, या इस इंटीग्रेशन द्वारा आवश्यक केवल एक. क्योंकि दोनों शर्तें एक ही समूह में हैं, उन्हें AND के साथ संयोजित किया जाता है, इसलिए केवल चयनित उप-प्रकारों की एआई सुरक्षा घटनाएं ही अग्रेषित होती हैं.

(वैकल्पिक) दो उप-प्रकारों को अलग-अलग रूट करें. एक एकल समूह जो दोनों मान लेकर चलता है, उन दोनों उप-प्रकारों को एक ही गंतव्य पर भेजता है. उन्हें अलग-अलग गंतव्यों पर भेजने के लिए, दो इवेंट इंटीग्रेशन कॉन्फ़िगर करें, प्रत्येक को एक समूह के साथ एक उप-प्रकार पर स्कोप करें.
यदि आवश्यक हो तो और संकीर्ण करें. एक ही समूह में अतिरिक्त शर्तें जोड़ कर वॉल्यूम को कम किया जा सकता है. उदाहरण के लिए, एक गार्ड नाम फिल्टर जोड़ा जा सकता है ताकि केवल एप्लिकेशन रनटाइम सुरक्षा की घटनाओं को अग्रेषित किया जा सके जो किसी विशिष्ट गार्ड से मेल खाती हैं.

एपीआई के साथ संवेदनशील सामग्री को पुलिंग करना
एआई सुरक्षा की घटनाएं अंतःक्रिया की सामग्री को जानबूझकर बाहर छोड़ती हैं: वे ऐसे प्रॉम्प्ट्स, मॉडल प्रतिक्रियाएं, या किसी भी कच्चे संदेश डेटा का आदान-प्रदान नहीं करतीं. उस सामग्री को कैटो के ग्राफक्वेरील एपीआई से अनुरोध के आधार पर पुनः प्राप्त किया जाता है, और केवल कॉलर्स द्वारा जिनकी एपीआई कुंजी में आवश्यक अनुमति होती है. दो क्वेरीज उपलब्ध हैं, एक प्रति घटना उप-प्रकार.
एपीआई कुंजी और अनुमतियाँ
कैटो एपीआई कुंजी के साथ प्रश्नों का प्रमाणीकरण CMA में उत्पन्न होता है. एपीआई कुंजी कैसे बनानी है इस पर विवरण के लिए कैटो एपीआई के लिए एपीआई कुंजियाँ उत्पन्न करना देंखें.
अंतःक्रिया सामग्री तक पहुंच को कुंजी पर आरबीएसी अनुमतियों द्वारा नियंत्रित किया जाता है:
पहुँच | अनुमति |
|---|---|
एआई उपयोगकर्ता अंतःक्रियाओं पर संवेदनशील सामग्री | एआई सुरक्षा > उपयोगकर्ताओं के लिए एआई सुरक्षा > संवेदनशील सामग्री पढ़ें |
एप्लिकेशन रनटाइम सुरक्षा पर संवेदनशील सामग्री | एआई सुरक्षा > ऐप्स के लिए एआई सुरक्षा > संवेदनशील सामग्री पढ़ें |
एपीआई एंडपॉइंट और स्कीमा
एपीआई एंडपॉइंट और स्कीमा के लिए यूआरएल आपके CMA उदाहरण के स्थान के अनुसार विशिष्ट होता है जहां यह होस्ट किया गया है. यूआरएल के लिए <प्रिफिक्स> मान आपके CMA खाते और एपीआई एंडपॉइंट और स्कीमा के लिए जोड़ दिया जा सकता है.
संसाधन | यूआरएल प्रारूप |
|---|---|
एपीआई एंडपॉइंट | https://api.<प्रिफिक्स>.catonetworks.com/api/v1/graphql2 |
एपीआई स्कीमा | https://api.<प्रिफिक्स>.catonetworks.com/api/schema |
विभिन्न CMA क्षेत्रों के लिए पूर्वोनाव
CMA क्षेत्र | CMA यूआरएल | प्रिफिक्स | एपीआई एंडपॉइंट |
Ireland | cc.catonetworks.com | कोई नहीं | https://api.catonetworks.com/api/v1/graphql2 |
यूएस - वर्जीनिया | cc.us1.catonetworks.com | us1 | https://api.us1.catonetworks.com/api/v1/graphql2 |
भारत | cc.in1.catonetworks.com | in1 | https://api.in1.catonetworks.com/api/v1/graphql2 |
Japan | cc.jp1.catonetworks.com | jp1 | https://api.jp1.catonetworks.com/api/v1/graphql2 |
अपने CMA खाते के यूआरएल से पूर्वोनाव की पहचान करें और हर अनुरोध में संबंधित एंडपॉइंट का उपयोग करें. अधिक जानकारी के लिए, Cato API क्या है देखें।
ग्राफक्यूएल प्लेग्राउंड में प्रश्न चलाना
ग्राफक्यूएल प्लेग्राउंड ब्राउज़र से सीधे कैटो एपीआई के विरुद्ध क्वेरीज चलाता है, जो तात्कालिक जांच और स्क्रिप्टिंग से पहले कनेक्टिविटी की पुष्टि करने के लिए उपयोगी है. निर्देशों के लिए देखें ग्राफक्यूल प्लेग्राउंड से कैटो एपीआई से कनेक्ट करना.
एआई उपयोगकर्ता अंतःक्रिया
एआई उपयोगकर्ता अंतःक्रिया घटना के पीछे का उपयोगकर्ता प्रॉम्प्ट और मॉडल प्रतिक्रिया पुनः प्राप्त करें. समस्या CMA में उपयोगकर्ताओं के लिए एआई सुरक्षा > सत्र अन्वेषक के तहत उपलब्ध हैं.
नीतियों में कॉन्फ़िगर किए गए डिटेक्टर्स से मेल खाने वाली एआई उपयोगकर्ता अंतःक्रियाएं डिटेक्शन में ऐप_गतिविधि_प्रकार फील्ड में शामिल होती हैं. ये घटनाएँ सुरक्षा जांच के लिए सबसे प्रासंगिक हैं.
अनुरोध फ़ील्ड्स
वेरिएबल | प्रकार | स्रोत |
|---|---|---|
accountId | ID! | इस घटना का खाता_आईडी |
सत्र आईडी | ID! | इस घटना का सेशन_आईडी |
संदेश आईडी | ID! | इस घटना का संदेश_आईडी. सत्र के भीतर व्यक्तिगत प्रॉम्प्ट की पहचान करता है. |
ऐपआईडी | ID! | इस घटना का एप्लिकेशन_आईडी. |
उपयोगकर्ता आईडी | ID | इस घटना का उपयोगकर्ता_आईडी. वैकल्पिक. |
ग्राफकूल
प्रश्न सत्रवार्तालाप(
$accountId: आईडी!
$sessionId: आईडी!
$messageId: आईडी!
$appId: आईडी!
) {
aiSecurity(accountId: $accountId) {
endUsers {
sessionConversation(
input: { sessionId: $sessionId, messageId: $messageId, appId: $appId }
) {
userPrompt
llmResponse
}
}
}
}चल वेरिएबल्स:
{
"accountId": "<ACCOUNT_ID>",
"sessionId": "<event से session_id>",
"messageId": "<event से message_id>",
"appId": "<event से application_id>"
}कर्ल
कर्ल -s -X POST https://api.<प्रिफिक्स>.catonetworks.com/api/v1/graphql2 \
-H "x-api-key: $CATO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "query SessionConversation($accountId: ID!, $sessionId: ID!, $messageId: ID!, $appId: ID!) { aiSecurity(accountId: $accountId) { endUsers { sessionConversation(input: {sessionId: $sessionId, messageId: $messageId, appId: $appId}) { userPrompt llmResponse } } } }",
"variables": {
"accountId": "<ACCOUNT_ID>",
"sessionId": "<session_id from the event>",
"messageId": "<message_id from the event>",
"appId": "<application_id from the event>"
}
}' | jq .पायथन
json, urllib.request आयात करें
API_KEY = "<API_KEY>"
QUERY = """
सत्रसंवाद($accountId: आईडी!, $sessionId: आईडी!, $messageId: आईडी!, $appId: आईडी!) {
aiSecurity(accountId: $accountId) {
अंतिम उपयोगकर्ता {
सत्रसंवाद(input: {sessionId: $sessionId, messageId: $messageId, appId: $appId}) {
उपयोगकर्ताप्रॉम्प्ट
llmप्रतिक्रिया
}
}
}
}
"""
payload = json.dumps({"query": QUERY, "variables": {
"accountId": "<ACCOUNT_ID>",
"sessionId": "<session_id से ईवेंट>",
"messageId": "<message_id से ईवेंट>",
"appId": "<application_id से ईवेंट>",
}}).encode("utf-8")
req = urllib.request.Request(
"https://api.<prefix>.catonetworks.com/api/v1/graphql2",
data=payload,
headers={"x-api-key": API_KEY, "Content-Type": "अनुप्रयोग/json"},
method="POST",
)
with urllib.request.urlopen(req, timeout=30) as resp:
print(json.dumps(json.load(resp), indent=2)) प्रतिक्रिया फ़ील्ड्स
पथ | प्रकार | Description |
|---|---|---|
उपयोगकर्ता प्रोम्प्ट | स्ट्रिंग | उपयोगकर्ता द्वारा GenAI अनुप्रयोग को भेजा गया टेक्स्ट। |
llmप्रतिक्रिया | स्ट्रिंग | अनुप्रयोग की प्रतिक्रिया बटन। |
उदाहरण प्रतिक्रिया
{
"डेटा": {
"aiSecurity": {
"endUsers": {
"sessionConversation": {
"userPrompt": "<उपयोगकर्ता प्रोम्प्ट>",
"llmResponse": “<llm प्रतिक्रिया या NULL>”
}
}
}
}
}अनुप्रयोग सामयिक सुरक्षा
अनुप्रयोग सामयिक सुरक्षा घटना के पीछे भोज्यता मेटाडेटा और कच्चे चैट संदेशों को पुनः प्राप्त करें। इसी तरह के अर्पण CMA में कृत्रिम बुद्धिमत्ता अनुप्रयोग सुरक्षा के लिए > इंटरेक्शन एक्सप्लोरर के तहत उपलब्ध हैं।
अनुरोध फ़ील्ड्स
परिवर्ती | प्रकार | स्रोत |
|---|---|---|
accountId | ID! | घटना का खाता_आईडी। |
आईडी | ID! | घटना का अर्पण_आईडी। विशिष्ट अंतःक्रिया को पहचानता है। |
ग्राफक्यूएल
query GetInvocation($accountId: आईडी!, $id: आईडी!) {
aiSecurity(accountId: $accountId) {
apps {
invocation(input: { id: $id }) {
id
sessionId
timestamp
tokenCount
guard {
id
name
}
action
data {
message {
role
content {
text
}
}
}
}
}
}
}परिवर्तनी:
{
"accountId": "<खाता_आईडी>",
"id": "<अर्पण_आईडी घटना से>"
}कर्ल
curl -s -X POST https://api.<prefix>.catonetworks.com/api/v1/graphql2 \
-H "x-api-key: <CATO_API_KEY>” \
-H "Content-Type: application/json" \
-d '{
"query": "query GetInvocation($accountId: आईडी!, $id: आईडी!) { aiSecurity(accountId: $accountId) { apps { invocation(input: {id: $id}) { id sessionId timestamp tokenCount guard { id name } action data { message { role content { text } } } } } } }",
"variables": {
"accountId": "<अकाउंट_आईडी>",
"id": "<अर्पण_आईडी घटना से>"
}
}' | jq .पायथन
json, urllib.request आयात करें
API_KEY = "<CATO_API_KEY>"
QUERY = """
सत्र प्राप्त करें ($accountId: आईडी!, $id: आईडी!) {
aiSecurity(accountId: $accountId) {
ऐप्स {
call(इंपूट: {id: $id}) {
id
sessionId
समयचिह्न
अर्कसंख्या
रक्षक { आईडी नाम }
कार्रवाई
डेटा { संदेश { भूमिका सामग्री { पाठ } } }
}
}
}
}
"""
payload = json.dumps({"query": QUERY, "variables": {
"accountId": "<ACCOUNT_ID>",
"id": "<call_id से घटना>",
}}).encode("utf-8")
req = urllib.request.Request(
"https://api.<prefix>.catonetworks.com/api/v1/graphql2",
डेटा=payload,
शीर्षक={"x-api-key": API_KEY, "सामग्री का प्रकार": "अनुप्रयोग/json"},
विधि="POST",
)
with urllib.request.urlopen(req, timeout=30) as resp:
print(json.dumps(json.load(resp), indent=2)) प्रतिक्रिया फ़ील्ड्स
पथ | प्रकार | Description |
|---|---|---|
अर्पण.आईडी | ID! | वैश्विक विशिष्ट अर्पण आईडी। |
.सत्र आईडी | आईडी | इसी बातचीत सत्र से अर्पणों को समूहबद्ध करता है। यदि ट्रैक नहीं हुआ तो NULL। |
.समय चिह्न | तिथिकाल! | UTC समय जब अर्पण अवरोधित किया गया था। |
.टोकनघर | Int! | पूरे अर्पण के टोकन्स की संख्या (प्रॉम्प्ट और पूर्ति)। |
.गार्ड.आईडी / .गार्ड.नाम | ID! / स्ट्रिंग! | वह गार्ड जिसने अर्पण प्राप्त किया। यदि अर्पण गार्ड से संबद्ध नहीं है तो गार्ड वस्तु NULL हो सकता है। |
.कार्रवाई | उपयोजनम। | प्रवर्तन परिणाम एक अपरकेस API मान: अवरोध, अनआनोंमाइज, निरीक्षण, या कोई नहीं। घटनाएं इन मानों को विभिन्न वर्णानुक्रमण में प्रस्तुत करती हैं, उदाहरण के लिए, अनाउमाइज करें। |
.डेटा.संदेशा[] | [अर्पणमेसाज!]! | कच्चे चैट संदेश। प्रत्येक में एक भूमिका होती है (USER, ASSISTANT, TOOL_CALL, TOOL_MESSAGE, या एक कस्टम भूमिका) और सामग्री[] (प्रत्येक के पास एक बटन प्रक्षेत्र होता है)। यह संवेदनशील डेटा है जो पढ़ने की अनुमति के पीछे गेटेड है। |
उदाहरण प्रतिक्रिया
{
"डेटा": {
"aiSecurity": {
"apps": {
"invocation": {
"id": "01a00ada-c424-700b-9898-ed1ea05a82fb",
"sessionId": "8cf9384d-9a45-4d01-aeff-c3eb31164599",
"timestamp": "2026-08-16T13:55:04.392Z",
"tokenCount": 30,
"guard": {
"id": "d3918cad-ffab-408d-b079-bfecd4842ed1",
"name": "<गार्ड_नाम>"
},
"action": "BLOCK",
"data": {
"message": [
{
"role": "user",
"content": [
{
"text": "<उपयोगकर्ता प्रोम्प्ट>”
}
]
}
]
}
}
}
}
}
}परिशिष्ट: उदाहरण घटनाएँ और एपीआई कॉल्स
उदाहरण घटनाएँ और एपीआई कॉल्स जो उनके कंटेंट को पुनः प्राप्त करते हैं, दोनों घटना उप-प्रकारों के लिए।
उपयोगकर्ताओं के लिए AI सुरक्षा
उदाहरण घटनाएँ
[
{
"account_id": <खाता_आईडी>,
"account_name": "<खाता_नाम>",
"ad_name": "<विज्ञापन_नाम>",
"ai_app_risk_level": "मध्यम",
"app_activity_type": "प्रॉम्प्ट",
"application_id": "microsoft_copilot",
"application_name": "Microsoft Copilot",
"application_risk": 5,
"application_type": "सिस्टम",
"categories": [
"जनरेटिव AI उपकरण"
],
"cato_app": "microsoft_copilot",
"event_count": 1,
"event_id": "7c41ae90b2d5f318",
"event_sub_type": "एआई उपयोगकर्ता इंटरेक्शन",
"event_type": "AI सुरक्षा",
"interaction_intent": "जानकारी प्राप्त करना",
"interaction_sub_topic": "डेटा गोपनीयता",
"interaction_topic": "कानूनी",
"invocation_id": "01a01f70-9b12-74ac-8f31-2b6ce0d41aa7",
"is_cloud_app": true,
"is_sanctioned_app": true,
"message_id": "6f2b1c48-55d7-4a9e-9c10-8ab3f7e2d114",
"session_id": "b71f9c02-3ad4-4e8b-90c6-1f5d8e7a4c33",
"time": 1787233820104,
"time_str": "2026-08-20T13:50:20Z",
"url": "https://copilot.microsoft.com/chats",
"user_id": <उपयोगकर्ता_आईडी>,
"user_name": "<उपयोगकर्ता_नाम>",
"vpn_user_email": "<उपयोगकर्ता ईमेल>"
},
{
"account_id": <खाता_आईडी>,
"account_name": "<खाता_नाम>",
"app_activity_type": "पता लगाना",
"application_id": "microsoft_copilot",
"application_name": "Microsoft Copilot",
"event_count": 1,
"event_id": "b0d3572ea9146fc7",
"event_sub_type": "एआई उपयोगकर्ता इंटरेक्शन",
"event_type": "AI सुरक्षा",
"invocation_id": "01a01f70-9b12-74ac-8f31-2b6ce0d41aa7",
"message_id": "6f2b1c48-55d7-4a9e-9c10-8ab3f7e2d114",
"rule_id": "1296751412582697861",
"rule_name": "<नियम_नाम>",
"session_id": "b71f9c02-3ad4-4e8b-90c6-1f5d8e7a4c33",
"time": 1787233820331,
"time_str": "2026-08-20T13:50:20Z",
"user_id": <उपयोगकर्ता_आईडी>,
"user_name": "<उपयोगकर्ता_नाम>",
"vpn_user_email": "<उपयोगकर्ता ईमेल>"
}
]एपीआई कॉल
curl -s -X POST https://api.catonetworks.com/api/v1/graphql2 \
-H "x-api-key: <api_key>" \
-H "Content-Type: application/json" \
-d '{
"query": "query SessionConversation($accountId: आईडी!, $sessionId: आईडी!, $messageId: आईडी!, $appId: आईडी!) { aiSecurity(accountId: $accountId) { endUsers { sessionConversation(input: {sessionId: $sessionId, messageId: $messageId, appId: $appId}) { userPrompt llmResponse } } } }",
"variables": {
"accountId": "<खाता_आईडी>",
"sessionId": "b71f9c02-3ad4-4e8b-90c6-1f5d8e7a4c33",
"messageId": "6f2b1c48-55d7-4a9e-9c10-8ab3f7e2d114",
"appId": "microsoft_copilot"
}
}' | jq .एपीआई प्रतिक्रिया
{
"डेटा": {
"aiSecurity": {
"endUsers": {
"sessionConversation": {
"userPrompt": "<उपयोगकर्ता प्रोम्प्ट>",
"llmResponse": "<llm प्रतिक्रिया>"
}
}
}
}
}ऐप्स के लिए AI सुरक्षा
उदाहरण घटनाएँ
[
{
"account_id": <खाता_आईडी>,
"account_name": "<खाता_नाम>",
"action": "अवरुद्ध करें",
"detectors": [
"साधारण_डिटेक्टर_प्रकार_सुरक्षा_नियंत्रण_सुरक्षा"
],
"event_count": 1,
"event_id": "f98820262dfb8aa9",
"event_sub_type": "अनुप्रयोग समय सुरक्षा",
"event_type": "AI सुरक्षा",
"guard_id": "d3918cad-ffab-408d-b079-bfecd4842ed1",
"guard_name": "<गार्ड_नाम>",
"interaction_id": "01a01f71-c3e5-75be-a3cc-d77ec3b9277f",
"internalId": "f98820262dfb8aa9",
"internal_id": "f98820262dfb8aa9",
"invocation_id": "01a01f71-c3e5-75be-a3cc-d77ec3b9277f",
"is_sanctioned_app": false,
"rule_id": "1296751412582697861",
"rule_name": "<नियम_नाम>",
"session_id": "d500d5a4-82cd-4f48-8d70-0ebfc590d605",
"time": 1787233944579,
"time_str": "2026-08-20T13:52:24Z"
},
{
"account_id": <खाता_आईडी>,
"account_name": "<खाता_नाम>",
"action": "अवरुद्ध करें",
"detectors": [
"साधारण_डिटेक्टर_प्रकार_सुरक्षा_नियंत्रण_जेलब्रेक",
"साधारण_डिटेक्टर_प्रकार_सुरक्षा_नियंत्रण_सुरक्षा"
],
"event_count": 1,
"event_id": "31156257bcf2d54c",
"event_sub_type": "अनुप्रयोग समय सुरक्षा",
"event_type": "AI सुरक्षा",
"guard_id": "d3918cad-ffab-408d-b079-bfecd4842ed1",
"guard_name": "<गार्ड_नाम>",
"interaction_id": "01a01f72-38ce-782f-96c5-5ca071ac9792",
"internalId": "31156257bcf2d54c",
"internal_id": "31156257bcf2d54c",
"invocation_id": "01a01f72-38ce-782f-96c5-5ca071ac9792",
"is_sanctioned_app": false,
"rule_id": "1296751412582697861",
"rule_name": "<नियम_नाम>",
"session_id": "d500d5a4-82cd-4f48-8d70-0ebfc590d605",
"time": 1787233974486,
"time_str": "2026-08-20T13:52:54Z"
}
]एपीआई कॉल
curl -s -X POST https://api.catonetworks.com/api/v1/graphql2 \
-H "x-api-key: <api_key>" \
-H "Content-Type: application/json" \
-d '{
"query": "query GetInvocation($accountId: आईडी!, $id: आईडी!) { aiSecurity(accountId: $accountId) { apps { invocation(input: {id: $id}) { id sessionId timestamp tokenCount guard { id name } action data { message { role content { text } } } } } } }",
"variables": {
"accountId": "<खाता_आईडी>",
"id": "01a01f72-38ce-782f-96c5-5ca071ac9792"
}
}' | jq .एपीआई प्रतिक्रिया
{
"डेटा": {
"aiSecurity": {
"ऐप्स": {
"आह्वान": {
"आईडी": "01a01f72-38ce-782f-96c5-5ca071ac9792",
"सत्र आईडी": "d500d5a4-82cd-4f48-8d70-0ebfc590d605",
"समय टिकट": "2026-08-20T13:52:54.486Z",
"टोकन गिनती": 38,
"रक्षक": {
"आईडी": "d3918cad-ffab-408d-b079-bfecd4842ed1",
"नाम": "\u003Cguard_name\u003E"
},
"कार्रवाई": "अवरोध",
"डेटा": {
"संदेश": [
{
"भूमिका": "उपयोगकर्ता",
"सामग्री": [
{
"पाठ": "\u003Cuser_prompt\u003E"
}
]
}
]
}
}
}
}
}
}