এআই নিরাপত্তা অপারেশনাল গাইড

Prev Next

সারসংক্ষেপ

Cato AI নিরাপত্তা লগ জেনএআই অ্যাপ্লিকেশনগুলির সাথে ব্যবহারকারী কার্যকলাপ এবং আপনার বাড়িতে তৈরি এজেন্টগুলি মডেলগুলিতে পাঠানো কলগুলিকে লগ করে। ইভেন্টগুলি Cato ব্যবস্থাপনা অ্যাপ্লিকেশন (CMA) এর হোম > ইভেন্ট পৃষ্ঠাতে দৃশ্যমান এবং ধারন, সম্পর্ক এবং সতর্কতার জন্য একটি SIEM, ডেটা লেক বা অন্যান্য বাহ্যিক প্ল্যাটফর্মে পাঠানো যেতে পারে।

ইভেন্টগুলি শুধুমাত্র মেটাডেটা বহন করে। মডেলের সাথে বিনিময় করা প্রম্পট এবং প্রতিক্রিয়াগুলি ইভেন্টে সংরক্ষণ করা হয় না। এই কন্টেন্ট একটি কলারের এপিআই কী দ্বারা পৃথকভাবে, প্রয়োজন অনুযায়ী, Cato এর GraphQL API থেকে পুনরুদ্ধার করা হয়।

এআই নিরাপত্তা অনুসন্ধান তদন্ত একটি দ্বি-ধাপ কর্মপ্রবাহ:

  1. আপনার SIEM এ ইভেন্টগুলি ফরওয়ার্ড করুন। এআই নিরাপত্তা ইভেন্ট টাইপের জন্য ফিল্টার করা একটি ইভেন্ট ইন্টিগ্রেশন কনফিগার করুন যাতে এআই নিরাপত্তার ঘটনা আপনার Cato টেলেমেট্রির সাথে আসে।

  2. ইভেন্টগুলির জন্য সংবেদনশীল বিষয়বস্তু টানতে এপিআইটি ব্যবহার করুন। যখন কোনও ইভেন্ট তদন্তের প্রয়োজন হয়, সেই ইভেন্ট দ্বারা ধৃত পরিচিতির সাথে এপিআই-তে প্রশ্ন করুন যাতে প্রম্পট এবং মডেল প্রতিক্রিয়া পুনরুদ্ধার করা যায়।

নোট: সংবেদনশীল প্রম্পট এবং প্রতিক্রিয়া সহ এআই নিরাপত্তা যোগাযোগগুলি সরাসরি CMA এ পর্যালোচনা করা যেতে পারে, API ব্যবহার না করে। অ্যাপগুলির জন্য এআই নিরাপত্তা > মিথস্ক্রিয়া এক্সপ্লোরার আপনার হোমগ্রাউন এজেন্টদের জন্য অভিযানগুলি তালিকাভুক্ত করে, এবং ব্যবহারকারীদের জন্য এআই নিরাপত্তা > সেশন এক্সপ্লোরার GenAI অ্যাপ্লিকেশনগুলির সাথে ব্যবহারকারীর সেশনগুলি তালিকাভুক্ত করে। উভয়ই আপনাকে একটি পৃথক রেকর্ডে গভীরতায় অনুসন্ধান করতে দেয়। এআই নিরাপত্তার ঘটনাগুলি আপনার SIEM এ শুরু হওয়া তদন্তগুলির জন্য এবং প্রোগ্রাম্যাটিক পুনরুদ্ধারের জন্য বোঝানো হয়।

Cato ইভেন্টগুলি

সকল এআই নিরাপত্তা ইভেন্টগুলি ইভেন্ট ধরনের AI নিরাপত্তা বহন করে। ইভেন্ট সাব-টাইপ এআই নিরাপত্তার যে অংশটি ইভেন্টটিকে তৈরি করেছে তা শনাক্ত করে এবং নির্ধারণ করে যে কোন ক্ষেত্রগুলি ইভেন্টটি বহন করে এবং কোন এপিআই প্রশ্ন তার বিষয়বস্তু ফিরিয়ে দেয়। একটি ইন্টারেক্টিভ ইভেন্ট স্কিমা এক্সপ্লোরার Cato Event Schema -এ উপলব্ধ।

CMA মডিউল

ইভেন্ট সাব-টাইপ

বর্ণনা

ব্যবহারকারীদের জন্য এআই সুরক্ষা

AI ব্যবহারকারী মিথস্ক্রিয়া

GenAI অ্যাপ্লিকেশনগুলির সাথে ব্যবহারকারীর কার্যকলাপ দ্বারা তৈরি।

অ্যাপ্লিকেশনের জন্য এআই সুরক্ষা

অ্যাপ্লিকেশন রানটাইম সুরক্ষা

যখন আপনার হোমগ্রাউন এজেন্টদের একটি নিরাপত্তা নীতি কার্যকলাপে ক্রিয়াকলাপ গ্রহণ করে তখন তৈরি করা হয়।

AI ব্যবহারকারী মিথস্ক্রিয়া ক্ষেত্রসমূহ

ক্ষেত্র

ধরন

বর্ণনা

একাউন্ট_আইডি / একাউন্ট_নাম

লং / কীওয়ার্ড

Cato অ্যাকাউন্ট পরিচিতি এবং প্রদর্শন নাম।

ad_name / user_id / user_name

কীওয়ার্ড / লং / কীওয়ার্ড

Cato ব্যবহারকারী, এবং তাদের এক্টিভ ডিরেক্টরি প্রদর্শন নাম।

vpn_user_email

কীওয়ার্ড

ব্যবহারকারীর ইমেইল ঠিকানা। যখন কোনও তদন্ত ইমেইল ঠিকানা থেকে শুরু হয় তখন কি ক্ষেত্রটি ফিল্টার করা হয়।

অ্যাপ্লিকেশন আইডি / অ্যাপ্লিকেশন নাম

কীওয়ার্ড

GenAI অ্যাপ্লিকেশন, উদাহরণস্বরূপ, microsoft_copilot / Microsoft Copilot.

অ্যাপ্লিকেশন প্রকার / শ্রেণীগুলি

কীওয়ার্ড

অ্যাপ্লিকেশন শ্রেণীবিন্যাস, উদাহরণস্বরূপ, প্রকার সিস্টেম এবং শ্রেণী Generative AI Tools.

ai_app_risk_level / অ্যাপ্লিকেশন_risk

কীওয়ার্ড / পূর্ণসংখ্যা

অ্যাপ্লিকেশন জন্য Cato এর ঝুঁকি মান, একটি লেবেল এবং একটি সংখ্যাসূচক স্কোর হিসাবে।

is_cloud_app / is_sanctioned_app

বুলিয়ান

যখন অ্যাপ্লিকেশন ক্লাউড-হোস্টেড হয়, এবং এটি অ্যাকাউন্টের জন্য অনুমোদিত হলে।

অ্যাপ কার্যকলাপ প্রকার

কীওয়ার্ড

ইভেন্ট কার্যকলাপ প্রতিনিধিত্ব করে। সম্ভাব্য মান: ওয়েব অনুরোধ, প্রম্পট, সনাক্তকরণ, LLM প্রতিক্রিয়া, ফাইল লেনদেন, সংলগ্ন প্রতিক্রিয়া।

নিয়ম_আইডি / নিয়ম_নাম

কীওয়ার্ড

নীতি নিয়ম যা মিলেছে, যেখানে একটিকে গুলি করা হয়েছে। app_activity_type-এর সাথে স্বাধীন এবং কোনও এক মূল্যবোধের উপর নির্ভরশীল নয়।

event_id

কীওয়ার্ড

অন্যন্য ইভেন্ট পরিচিতি।

সময় / সময়_স্ট্রিং

তারিখ (epoch ms) / তারিখ (ISO-8601)

যখন মিথস্ক্রিয়া উভয় রূপে ঘটেছিল।

সেশন_আইডি / বার্তা_আইডি

কীওয়ার্ড

sessionConversation প্রশ্নে application_id সহ, পাস হয়েছে। message_id তার মিলিত সনাক্তকরণ এবং LLM প্রতিক্রিয়া ইভেন্টগুলির সাথে একটি প্রম্পট ইভেন্টের জোড়া তৈরি করে।

জাদু_আইডি

কীওয়ার্ড

একই ঘটনা সেটের জোড়া message_id -এর মতো পৃথক পরিচিতি namespace এ, এবং কোনও বিষয়বস্তু প্রশ্ন দ্বারা ব্যবহৃত হয় না।

মিথস্ক্রিয়ার উদ্দেশ্য

কীওয়ার্ড

প্রম্পটের পেছনে শ্রেণীবিভাজিত অভিব্যক্তি, উদাহরণস্বরূপ, তথ্য অর্জন করে।

মিথস্ক্রিয়া বিষয় / মিথস্ক্রিয়া_উপ_বিষয়

কীওয়ার্ড

গোপনীয় বিষয়, উদাহরণস্বরূপ, আইনি / ডেটা গোপনীয়তা।

ইউআরএল / রেফারার_ইউআরএল

কীওয়ার্ড

পৃষ্ঠার ইউআরএল এবং রেফারিং পৃষ্ঠার ইউআরএল, যেখানে প্রযোজ্য

file_name

কীওয়ার্ড

স্থানান্তরিত ফাইলের নাম। শুধুমাত্র যখন অ্যাপ_অ্যাক্টিভিটি_টাইপ ফাইল লেনদেন হয় তখন উপস্থিত।

সম্প্রক্ততা_ফলাফল_ক্রিয়া

কীওয়ার্ড

একসন্থা নীতির প্রম্পটের প্রতিক্রিয়ার পরে ব্যবহারকারীটি যে ক্রিয়া গ্রহণ করে।

ব্যবহারকারী_তর্ক

কীওয়ার্ড

সম্প্রক্ততা নীতি প্রম্পটে ব্যবহারকারীর প্রতিক্রিয়া,

event_count

ইনটিজার

নথিটি কতবার উপস্থিত হয় তা প্রদর্শন করে।

কাটো_অ্যাপ

কীওয়ার্ড

কাটো অ্যাপ্লিকেশনের পরিচিতি জন আসল জেনএআই অ্যাপ্লিকেশন, উদাহরণস্বরূপ, চ্যাটজিপিটি।

অনুলিপি: প্রতিটি ঘটনার পুনরাবৃত্তির বিষয়বস্তু নেই। সেশন_আইডি এবং মেসেজ_আইডি শুধুমাত্র সেই ঘটনার সাথে উপস্থিত হয় যেখানে অ্যাপ_অ্যাক্টিভিটি_টাইপ প্রম্পট, ডিটেকশান বা এলএলএম প্রতিক্রিয়া হয়। ওয়েব অনুসন্ধান এবং ফাইল লেনদেনের ঘটনাগুলি তাদের বাহিত করে না।

অ্যাপ্লিকেশন রানটাইম প্রোটেকশন ক্ষেত্র

ক্ষেত্র

বর্ণনা

ইভেন্ট_প্রকার / ইভেন্ট_উপ_প্রকার

এই ঘটনাগুলির জন্য সর্বদা এআই নিরাপত্তা / অ্যাপ্লিকেশন রানটাইম সুরক্ষা। আপনার ইন্টিগ্রেশন বা ইভেন্ট পৃষ্ঠায় ফিল্টার করতে এই মানগুলি ব্যবহার করুন।

ইভেন্ট_আইডি / ইভেন্ট_গণনা

অনন্য ইভেন্ট পরিচিতি এবং নথিটি কতবার উপস্থিত হয় তা প্রদর্শন করে।

সময় / সময়_স্ট্রিং

ইন্টারঅ্যাকশন যখন নির্ভুল হয়, একটি এপোক টাইমস্ট্যাম্প হিসেবে মিলিসেকেন্ড এবং একটি আইএসও-৮৬০১ ইউটিসি স্ট্রিং।

অ্যাকাউন্ট_আইডি / অ্যাকাউন্ট_নাম

কাটো অ্যাকাউন্ট পরিচিতি এবং প্রদর্শন নাম। অ্যাকাউন্ট_আইডি ঐ মান যা অ্যাকাউন্টআইডি হিসাবে এপিআই অনুসন্ধানগুলিকে পাস করা হয়।

গার্ড_আইডি / গার্ড_নাম

অ্যাপ্লিকেশন সুরক্ষিত করেছে এবং সিদ্ধান্ত তৈরি করেছে এমন গার্ড।

নিয়ম_আইডি / নিয়ম_নাম

সমপ্রেক্ষা গার্ড নীতি নিয়ম যা মিলেছে।

action

প্রয়োগ ফলাফল, যেমন অ্যানোনিমাইজ, ব্লক বা মনিটর।

ডিটেক্টর

ডিটেক্টর যা এই ইন্টারঅ্যাকশনের জন্য চালু হয়েছিল, একটি অ্যারে হিসেবে — উদাহরণস্বরূপ, পিআইআই ডিটেক্টর।

অ্যাপ্লিকেশন_আইডি

গার্ড যে হোমগ্রাউন এজেন্টকে সুরক্ষিত করে।

উদ্ধাক_আইডি

তদন্তের কী। স্পষ্ট ইন্টারঅ্যাকশন সংজ্ঞায়িত করে এবং সূচক অনুসন্ধানের জন্য উর্ধ্বে প্রতিক্রিয়া এবং প্রম্পট পুনর্বিবৃতি।

সেশন_আইডি

আমন্ত্রণগুলি যা একই কথোপকথন সেশনের অন্তর্ভুক্ত।

কাটো_অ্যাপ / ইস_ক্লাউড_অ্যাপ / ইস_সানষনেড_অ্যাপ

সুরক্ষা নীতি জন্য অ্যাপস তদন্তের জন্য যোগাযোগ স্বাধীন, তবে ঘটনায় উপস্থিত।

পরিভাষা। যা সিএমএ হোমগ্রাউন এজেন্টকে অ্যাপ্লিকেশন হিসেবে উল্লেখ করে অবস্থানেই তা ঘটনার মধ্যে অ্যাপ্লিকেশন হিসেবে উল্লেখ করা হয়। অ্যাপ্লিকেশন_আইডি ক্ষেত্র সংক্রান্ত গার্ডের সুরক্ষিত হোমগ্রাউন এজেন্টকে পরিচিত করে।

ইভেন্টগুলি সিএইমেএম-এ একটি এসআইইএমে পাঠান

ইভেন্ট ইন্টিগ্রেশনের মাধ্যমে স্বতঃ উদ্ধারকারী বাইরে প্ল্যাটফর্ম এবং সঞ্চয়ের গন্তব্যস্থলে ঘটনার ক্ষতি হয়, সরবরাহ ছাড়াই। ইন্টিগ্রেশনগুলি কনফিগার করা হয়েছে সম্পদ > ইন্টিগ্রেশন > কনফিগার করা হয়েছে ইন্টিগ্রেশন অন্ততি। অবসারণের জন্য দেখুন ইভেন্ট ইন্টিগ্রেশনেস কথামাত্রা.

যদি অভিলম্বিত ইন্টিগ্রেশন অবিলম্বিত না হয়, কাস্টম HTTP পুশ ইন্টেগ্রেশন জড়ায় পুশ ভাঙিয়ে যেভাবে JSON ফর্ম্যাটে আপনার সুবনীর গন্তব্যস্থলে পাঠায়। কাস্টম হেডার্স কনফিগার করা যেতে পারে, যা একটি ব্যাপক আকারের বিক্রেতাদের সাথে সঙ্গতিপূর্ণ। আরও তথ্যের জন্য দেখুন কাস্টম HTTP ব্যবহার করে ডেটা প্রেরণ করুন ইন্টিগ্রেশন।

এআই নিরাপত্তার জন্য ইভেন্ট ফিল্টার

ইন্টিগ্রেশন নির্বাচন করুন এবং এর কতি পরিমণ্ড ডিসেম্বর নিয়ে যা অ্যাকাউন্টের সম্পূর্ণ ইভেন্ট ভলিউম সামনের প্রাপণের বদলে। এটি ইভেন্ট ফিল্টার এ করা হয়, যা একটিউ বা বেশি ফিল্টার গ্রুপগুলি নিয়ে নির্মিত হয়: একটিও গ্রুপের মধ্যে শর্তগুলি AND এর সঙ্গে সংযুক্ত থাকে এবং গ্রুপগুলি OR-এর মধ্যেমে সংযুক্ত হয়, তাই একটি ইভেন্ট তদানীন্ত ফরোয়াডেড হয় যখন এটি ছবেছে যেকোনো গ্রুপের সাথে মেলে। কোনো ইভেন্ট ক্ষেত্র শর্ত হিসেবে উপলব্ধ।

  1. ইভেন্ট ফিল্টারের মধ্যে একটি ফিল্টার গ্রুপ যোগ করুন। ইন্টিগ্রেশন কনফিগারেশন এ ইভেন্ট ফিল্টার খুলুন এবং একটি ফিল্টার গ্রুপ যোগ করুন।

  2. ইভেন্ট প্রকার শর্ত সেট করুন। ক্ষেত্র ইভেন্ট প্রকার, মান AI নিরাপত্তা. এই গ্রুপটি সব উপ-ধরনের AI নিরাপত্তার ইভেন্টে পরিমণ্ড অবস্থিত।
     

  3. (ঐচ্ছিক) উপ-ধরনের শর্ত সেট করুন। ক্ষেত্র সাব-প্রকার, AI ব্যবহারকারী ইন্টারঅ্যাকশন ও অ্যাপ্লিকেশন রানটাইম সুরক্ষা মান সহ, বা শুধুমাত্র এই ইন্টিগ্রেশনের জন্য প্রয়োজনীয়। কারণ দুটি শর্ত একই গ্রুপে, তারা AND সঙ্গে মিলিত হয়েছে, তাই শুধুমাত্র নির্বাচিত সাব-ধরনের AI নিরাপত্তার ইভেন্ট ফরোয়াড করা হয়।

  4. (ঐচ্ছিক) দুটি সাব-প্রকার আলাদাভাবে রুট করুন। একটি একক গ্রুপ দুটি মান বহন করে দুটি উপ-ধরন একই গন্তব্যে পাঠায়। তাদের একটি বৃহৎ পার্থক্য গন্তব্যস্থলে বিতরণ করতে, দুটি ইভেন্ট ইন্টগ্রেশন কনফিগার করুন এবং প্রতিটি ঝরা করাতে একটি গ্রুপ।

  5. আরেকটি সংকুচিত করুন, যদি প্রয়োজন হয়। অতিরিক্ত শর্তগুলি একই গ্রুপে যোগ করা যেতে পারে ভলিউম কমাতে। উদাহরণস্বরূপ, একটি গার্ড নাম ফিল্টার অ্যাপ্লিকেশন রানটাইম প্রোটেকশনের ইভেন্টগুলিকে শুধুমাত্র একটি পার্কিকুলার গার্ড এর সাথে প্রক্ষেপণ করে।
     

API এর সাথে সংবেদনশীল বিষয়বস্তু টানুন

AI নিরাপত্তা বিষয়বস্তু পরিচিতি থেকে সংকল্পণাধীন: তারা প্রম্পট, মডেল প্রতিক্রিয়া বা কোনও কাঁচা মেসেজডেটা এর প্রতিরোধের অন্তর্ভুক্ত করে না। এই বিষয়বস্তু কাটোর গ্রাফকিউএল API থেকে পেয়া হয়, অনুরোধের ভিত্তিতে, এবং শুধুমাত্র তাদের মাধ্যমে API কী যে প্রয়োজনীয় অনুমতি ধারণ করে। দুই অনুসন্ধান উপলব্ধ, একটিতে প্রান্তবর্তী ঘটনার উর্ধ্বে।

API কী এবং অনুমতিসমূহ

অনুসন্ধানগুলি কাটোর API কী দ্বারা অসম্প্রাপ্ত যা CMA তে তৈরি হয়। API কী কিভাবে তৈরি করবেন তার বিস্তারিত জানার জন্য দেখুন কাটো API এর জন্য API কী তৈরি করা.

ইন্টারঅ্যাকশন বিষয়বস্তু প্রবেশের নিয়ন্ত্রণ কীতে RBAC অনুমতি দ্বারা নিয়ন্ত্রিত করা হয়:

ক্লাউড অ্যাক্সেস

অনুমতি

AI ব্যবহারকারী ইন্টারঅ্যাকশনের সারগাভৃষ্ঠবিষয়বস্তু

AI নিরাপত্তা > AI ব্যবহারকারীর জন্য নিরাপত্তা > সংবেদনশীল বিষয়বস্তু পড়ুন

অ্যাপ্লিকেশন রানটাইম প্রটেকশন এর সংবেদনশীল বিষয়বস্তু

AI নিরাপত্তা > অ্যাপসের জন্য AI নিরাপত্তা > সংবেদনশীল বিষয়বস্তু পড়ুন

API এন্ডপয়েন্ট এবং স্কিমা

API এন্ডপয়েন্ট এবং স্কিমার URL বিশেষায়িত সেই অবস্থানের জন্য যেখানে আপনার CMA ইনস্ট্যান্স হোস্ট করা। একটি <প্রিফিক্স> মান URL আপনার CMA অ্যাকাউন্টের জন্য এবং অ্যাপ্লিকেশন API এন্ডপয়েন্ট এবং স্কিমার সাথে যুক্ত হতে পারে।

সম্পদ

ইউআরএল ফর্ম্যাট

API এন্ডপয়েন্ট

https://api.<প্রিফিক্স>.catonetworks.com/api/v1/graphql2

API স্কিমা

https://api.<প্রিফিক্স>.catonetworks.com/api/schema

বিবিধ CMA অঞ্চলের জন্য প্রিফিক্সগুলি

CMA অঞ্চল

CMA ইউআরএল

প্রিফিক্স

API এন্ডপয়েন্ট

আয়ারল্যান্ড

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

জাপান

cc.jp1.catonetworks.com

jp1

https://api.jp1.catonetworks.com/api/v1/graphql2

আপনার CMA অ্যাকাউন্টের URL থেকে প্রিফিক্স সনাক্ত করুন এবং সর্বদা একটি অনুরোধে সংশ্লিষ্ট এন্ডপয়েন্ট ব্যবহার করুন। আরও তথ্যের জন্য, দেখুন ক্যাটো API কী।

গ্রাফকিউএল প্লেগরাউন্ডে প্রশ্ন চালানো

গ্রাফকিউএল প্লেগরাউন্ড ব্রাউজার থেকে কাটো API এর বিরুদ্ধে প্রশ্ন চালায়, যা অ্যাড-হক তদন্তের জন্য উপযোগী এবং প্রশ্নের স্ক্রিপ্ট করার পূর্বে সংযোগ নিশ্চিত করার জন্য। নির্দেশনা এর জন্য দেখুন গ্রাফকিউএল প্লেগরাউন্ড থেকে কাটো API সংযোগ করা.

AI ব্যবহারকারী ইন্টারঅ্যাকশন

AI ব্যবহারকারী ইন্টারঅ্যাকশনের পিছনে ব্যবহারকারী প্রম্পট এবং মডেলের প্রতিক্রিয়া উদ্ধৃতি করুন। CMA তে AI ব্যবহারকারীর জন্য নিরাপত্তা > সেশন এক্সপ্লোরার অধীনে একই কথোপকথন উপলব্ধ।

অগ্রাহ লিখিত নিয়মগুলির সাথে মিলছে এমন AI ব্যবহারকারী ইন্টারঅ্যাকশন, অ্যাপ_অ্যাক্টিভিটি_প্রকার ক্ষেত্রে ডিটেকশন অন্তর্ভুক্ত করে। এই ইভেন্টগুলি নিরাপত্তা তদন্তের জন্য সবচেয়ে গুরুত্বপূর্ণ।

অনুরোধ ক্ষেত্রসমূহ

চলক

ধরন

উৎস

accountId

ID!

ইভেন্টের অ্যাকাউন্ট_আইডি।

sessionId

ID!

ইভেন্টের সেশন_আইডি।

messageId

ID!

ইভেন্টের মেসেজ_আইডি। সেশনের মধ্যে স্পষ্ট প্রম্পট সনাক্ত করে।

অ্যাপআইডি

ID!

ইভেন্টের অ্যাপ্লিকেশন_আইডি।

userId

ID

ইভেন্টের ব্যবহারকারী_আইডি। ঐচ্ছিক.

গ্রাফকিউএল

প্রশ্ন সেশনকনভারসেশন(
  $অ্যাকাউন্টআইডি: আইডি!
  $সেশনআইডি: আইডি!
  $মেসেজআইডি: আইডি!
  $অ্যাপআইডি: আইডি!
) {
  aiSecurity(accountId: $accountId) {
    endUsers {
      sessionConversation(
        input: { sessionId: $sessionId, messageId: $messageId, appId: $appId }
      ) {
        userPrompt
        llmResponse
      }
    }
  }
}

চলকমূল্যসমূহ:

{
  "accountId": "<ACCOUNT_ID>",
  "sessionId": "<event থেকে সেশন_আইডি>",
  "messageId": "<event থেকে মেসেজ_আইডি>",
  "appId": "<event থেকে অ্যাপ্লিকেশন_আইডি>"
}

কূর্ল

curl -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": "``",
      "sessionId": "`<সেশনের ঘটনাবলী="" থেকে="" সেশন="" আইডি="">`",
      "messageId": "`<ঘটনার মেসেজ="" আইডি="" থেকে="">`",
      "appId": "`<ঘটনার অ্যাপ্লিকেশন="" আইডি="" থেকে="">`"
    }
  } | jq .

পাইথন

import json, urllib.request 
 
API_KEY = "<API_KEY>" 
 
QUERY = """ 
query SessionConversation($accountId: আইডি!, $sessionId: আইডি!, $messageId: আইডি!, $appId: আইডি!) { 
  aiSecurity(accountId: $accountId) { 
    endUsers { 
      sessionConversation(input: {sessionId: $sessionId, messageId: $messageId, appId: $appId}) { 
        userPrompt 
        llmResponse 
      } 
    } 
  } 
} 
""" 
payload = json.dumps({"query": QUERY, "variables": { 
    "accountId": "<ACCOUNT_ID>", 
    "sessionId": "<session_id from event>", 
    "messageId": "<message_id from event>", 
    "appId": "<application_id from event>", 
}}).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": "application/json"}, 
    method="POST", 
) 
with urllib.request.urlopen(req, timeout=30) as resp: 
    print(json.dumps(json.load(resp), indent=2)) 

প্রতিক্রিয়ার ক্ষেত্রসমূহ

পথ

টাইপ

বর্ণনা

ব্যবহারকারী প্রম্পট

স্ট্রিং

ব্যবহারকারী জেনএআই অ্যাপ্লিকেশনে যে পাঠ পাঠিয়েছে।

এলএলএম প্রতিক্রিয়া

স্ট্রিং

অ্যাপ্লিকেশনের প্রতিক্রিয়া টেক্সট।

উদাহরণ প্রতিক্রিয়া

"{
  "ডেটা": {
    "aiSecurity": {
      "endUsers": {
        "sessionConversation": {
          "userPrompt": "`<ব্যবহারকারী প্রম্পট="">`",
          "llmResponse": "`<এলএলএম প্রতিক্রিয়া="" বা="" 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.`<উপসর্গ>`.catonetworks.com/api/v1/graphql2 \
  -H "x-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 .

পাইথন

import json, urllib.request 
 
API_KEY = "<CATO_API_KEY>" 
 
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 } } } 
      } 
    } 
  } 
} 
""" 
payload = json.dumps({"query": QUERY, "variables": { 
    "accountId": "<ACCOUNT_ID>", 
    "id": "<invocation_id from the event>", 
}}).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": "application/json"}, 
    method="POST", 
) 
with urllib.request.urlopen(req, timeout=30) as resp: 
    print(json.dumps(json.load(resp), indent=2)) 

প্রতিক্রিয়ার ক্ষেত্রসমূহ

পথ

টাইপ

বর্ণনা

আহ্বান.id

ID!

বিশ্বব্যাপি অনন্য আহ্বান আইডি।

.sessionId

আইডি

একই গাল্পাষণ সেশনের আহ্বান গোষ্ঠী। ট্র্যাক না করলে null.

.টাইমস্ট্যাম্প

DateTime!

ইউটিসি সময় আহ্বান কে আটকানো হয়েছে।

.tokenCount

Int!

আহ্বানের জন্য মোট টোকেন (প্রম্পট এবং সফলতা)।

.guard.id / .guard.name

ID! / String!

গার্ডটি আহ্বান গ্রহণ করেছে। গার্ড অবজেক্ট null হতে পারে যদি আহ্বানটি গার্ডের সাথে সম্পর্কিত না হয়।

.কার্য

Enum!

একটি বড় অক্ষরে API মান হিসাবে প্রয়োগের ফলাফল: ব্লক, নামান এবং মনিটর বা NONE. ঘটনাগুলি এই মানগুলি বিভিন্ন বড়ত্বে উপস্থাপিত করে, যেমন, নামান.

.data.message[]

[InvocationMessage!]!

কাঁচা চ্যাট বার্তাগুলি। প্রত্যেকটির একটি ভূমিকা রয়েছে (ব্যবহারকারী, সহকারী, সরঞ্জাম কল, সরঞ্জাম বার্তা, বা একটি কাস্টম ভূমিকা) এবং content[] (প্রত্যেকটির একটি টেক্সট ক্ষেত্রসহ)। এটি সংবেদনশীল ডেটা যা পড়া সংবেদনশীল কন্টেন্ট অনুমতিযুক্ত।

উদাহরণ প্রতিক্রিয়া

"{
  "ডেটা": {
    "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": "ব্লক",
          "data": {
            "message": [
              {
                "role": "ব্যবহারকারী",
                "content": [
                  {
                    "text": "`<ব্যবহারকারী প্রম্পট="">`"
                  }
                ]
              }
            ]
          }
        }
      }
    }
  }
}

পরিশিষ্ট: নমুনা ঘটনাবলী এবং এপি কল

নমুনা ইভেন্ট এবং এপি কল যা তাদের বিষয় সংগ্রহ করে, উভয় ঘটনাপ্রকারের জন্য।

ব্যবহারকারীদের জন্য এআই সুরক্ষা

নমুনা ঘটনাবলী

"[
  {
    "account_id": `<অ্যাকাউন্ট_আইডি>`,
    "account_name": "`<অ্যাকাউন্ট নাম="">`",
    "ad_name": "``",
    "ai_app_risk_level": "মাঝারি",
    "app_activity_type": "প্রম্পট",
    "application_id": "microsoft_copilot",
    "application_name": "মাইক্রোসফ্ট কো পাইলোক",
    "application_risk": 5,
    "application_type": "সিস্টেম",
    "categories": [
      "জেনারেটিভ AI সরঞ্জাম"
    ],
    "cato_app": "microsoft_copilot",
    "event_count": 1,
    "event_id": "7c41ae90b2d5f318",
    "event_sub_type": "AI ব্যবহারকারী ইন্টারঅ্যাকশন",
    "event_type": "AI নিরাপত্তা",
    "interaction_intent": "তথ্য সংগ্রহ",
    "interaction_sub_topic": "ডেটা গোপনীয়তা",
    "interaction_topic": "আইনী",
    "invocation_id": "01a01f70-9b12-74ac-8f31-2b6ce0d41aa7",
    "is_cloud_app": সত্য,
    "is_sanctioned_app": সত্য,
    "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": "Detection",
    "application_id": "microsoft_copilot",
    "application_name": "মাইক্রোসফ্ট কো পাইলট",
    "event_count": 1,
    "event_id": "b0d3572ea9146fc7",
    "event_sub_type": "AI ব্যবহারকারী ইন্টারঅ্যাকশন",
    "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": "`<ব্যবহারকারী ইমেইল="">`"
  }
]"

API কল

"curl -s -X POST https://api.catonetworks.com/api/v1/graphql2 \
  -H "x-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": "মাইক্রোসফ্ট কোপাইলট"
    }
  } | jq .

API প্রতিক্রিয়া

"{
  "ডেটা": {
    "aiSecurity": {
      "endUsers": {
        "session মান্না": {
          "userPrompt": "<ব্যবহারকারী প্রম্পট="">",
          "llmResponse": "<এলএলএম প্রতিক্রিয়া="">"
        }
      }
    }
  }
}

অ্যাপসের জন্য এআই নিরাপত্তা

নমুনা ঘটনাবলী

"[
  {
    "account_id": `<অ্যাকাউন্ট_আইডি>`,
    "account_name": "`<অ্যাকাউন্ট নাম="">`",
    "action": "ব্লক",
    "detectors": [
      "SIMPLE_DETECTOR_TYPE_SAFETY_CONTROLS_SAFETY"
    ],
    "event_count": 1,
    "event_id": "f98820262dfb8aa9",
    "event_sub_type": "Application Runtime Protection",
    "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": মিথ্যা,
    "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": [
      "SIMPLE_DETECTOR_TYPE_SECURITY_CONTROLS_JAILBREAK",
      "SIMPLE_DETECTOR_TYPE_SAFETY_CONTROLS_SAFETY"
    ],
    "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": মিথ্যা,
    "rule_id": "1296751412582697861",
    "rule_name": "`<রুল নাম="">`",
    "session_id": "d500d5a4-82cd-4f48-8d70-0ebfc590d605",
    "time": 1787233974486,
    "time_str": "2026-08-20T13:52:54Z"
  }
]"

API কল

"curl -s -X POST https://api.catonetworks.com/api/v1/graphql2 \
  -H "x-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 .

API প্রতিক্রিয়া

{
  "data": {
    "aiSecurity": {
      "apps": {
        "invocation": {
          "id": "01a01f72-38ce-782f-96c5-5ca071ac9792",
          "sessionId": "d500d5a4-82cd-4f48-8d70-0ebfc590d605",
          "timestamp": "2026-08-20T13:52:54.486Z",
          "tokenCount": 38,
          "guard": {
            "id": "d3918cad-ffab-408d-b079-bfecd4842ed1",
            "name": "<নাম>"
          },
          "action": "ব্লক করুন",
          "data": {
            "message": [
              {
                "role": "ব্যবহারকারী",
                "content": [
                  {
                    "text": "<user_prompt>"
                  }
                ]
              }
            ]
          }
        }
      }
    }
  }
}