প্রক্সি ও শেয়ারফ্লো বান্ডেলে ব্যক্তিগতভাবে শনাক্তকরণযোগ্য তথ্য (PII) মাস্ক করা ম্যানেজ করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

প্রক্সি ও শেয়ারফ্লো বান্ডেলে PII মাস্কিং ম্যানেজ করা

সিঙ্ক্রোনাইজেশন প্রসেসের অংশ হিসেবে, API হাব কানেক্টর ইন্টিগ্রেশন আপনার API প্রক্সি বান্ডেল API হাবে আপলোড করে। এইসব বান্ডেলে নীতি কনফিগারেশনের মধ্যে সংবেদনশীল ডেটা বা ব্যক্তিগতভাবে শনাক্তকরণযোগ্য তথ্য (PII) থাকতে পারে। এই ফিচারের সাহায্যে, API হাবে বান্ডেল আপলোড করার আগে শনাক্ত করা PII ফিল্ড মাস্ক করতে পারবেন।

মাস্কিং পদ্ধতি

XML-ফর্ম্যাট করা প্রক্সি এবং শেয়ারফ্লো বান্ডেলের মধ্যে নীতি কনফিগারেশনের মধ্যে নির্দিষ্ট এলিমেন্টকে টার্গেট করার জন্য XPath এক্সপ্রেশন ব্যবহার করে PII মাস্কিং প্রয়োগ করা হয়, তবে বান্ডেলের মধ্যে অন্যান্য সাধারণ XML এলিমেন্টের ক্ষেত্রে নয়। এই ফিচারকে দুটি ভাগে ভাগ করা হয়েছে:

ডিফল্ট মাস্ক

Apigee Edge-এ XPath এক্সপ্রেশনের একটি পূর্ব-নির্ধারিত, বিল্ট-ইন তালিকা অন্তর্ভুক্ত থাকে যা অটোমেটিক সাধারণ PII ফিল্ডকে টার্গেট করে। আপলোড করার প্রসেস চলাকালীন এইসব মাস্ক অটোমেটিক প্রয়োগ করা হয়।

ডিফল্ট মাস্কের তালিকা:

কাস্টম মাস্ক ম্যানেজ করা

PII হিসেবে শনাক্ত করা নির্দিষ্ট ফিল্ড মাস্ক করার জন্য একটি ডেডিকেটেড API আপনাকে XPath এক্সপ্রেশনের কাস্টমাইজ করা তালিকা জমা দিতে দেয়, এর ফলে আপনার অনন্য ডেটা গোপনীয়তা সংক্রান্ত প্রয়োজন পূরণ হয়।

আপনি /v1/organizations/<var>ORG_NAME/uapim/proxymasks Edge ম্যানেজমেন্ট API এন্ডপয়েন্ট ব্যবহার করে আপনার সংস্থার কাস্টম PII মাস্ক ম্যানেজ করতে পারবেন। এইসব অপারেশন পারফর্ম করতে আপনার কাছে অবশ্যই orgadmin ভূমিকা থাকতে হবে।

API, কোনও নির্দিষ্ট সংস্থার জন্য proxymasks নামের XPaths-এর একটি তালিকায় কাজ করে।

XPath তালিকা থেকে আইটেম তৈরি, পরিবর্তন, পাওয়া, যোগ করা বা মুছে ফেলার জন্য করা সব অনুরোধ এবং সফল রেসপন্স নিম্নলিখিত JSON স্কিমা ব্যবহার করে:

{
  "xpaths": [
    "//Path/To/Element"
  ]
}

১. কাস্টম XPath তালিকা তৈরি বা পরিবর্তন করা (PUT)

নতুন কাস্টম তালিকা তৈরি করতে অথবা আগে থেকে থাকা তালিকার কন্টেন্ট সম্পূর্ণভাবে পরিবর্তন করতে PUT পদ্ধতি ব্যবহার করুন। আগে থেকে থাকা যেকোনও XPath ওভাররাইট করা হয়।

curl -X PUT https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//StatisticsCollector/Statistics/Statistic[@name='caller']",
      "//AssignMessage/AssignVariable[Name='password']/Value"
    ]
  }'

আপডেট সম্পূর্ণ হলে, নিম্নলিখিত মেসেজ সহ একটি 201 Created বা 200K উত্তর দেখানো হয়: Success response (201 Created or 200 OK)

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

২. কাস্টম XPath তালিকা রিট্রিভ করা (GET)

কাস্টম XPath এক্সপ্রেশনের বর্তমান তালিকা পেতে GET পদ্ধতি ব্যবহার করুন।

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

রিট্রিভ করা সম্পূর্ণ হলে, নিম্নলিখিত মেসেজ সহ একটি 200K উত্তর দেখানো হয়:Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

৩. তালিকায় XPaths যোগ করুন (POST append)

বর্তমান কন্টেন্ট ওভাররাইট না করেই আগে থেকে থাকা তালিকায় এক বা একাধিক XPath এক্সপ্রেশন যোগ করতে POST পদ্ধতি ব্যবহার করুন।

curl -X POST https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks/append \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//New/Appended/XPath"
    ]
  }'

অ্যাপেণ্ড করা সম্পূর্ণ হলে, নিম্নলিখিত মেসেজ সহ একটি 200K উত্তর দেখানো হয়: Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value",
    "//New/Appended/XPath"
  ]
}

৪. তালিকা থেকে নির্দিষ্ট XPaths মুছে দিন (POST deleteItems)

আগে থেকে থাকা তালিকা থেকে নির্দিষ্ট XPath এক্সপ্রেশন সরাতে, POST পদ্ধতি ব্যবহার করুন। সরিয়ে দিতে হবে এমন সঠিক XPath স্ট্রিং অনুরোধে থাকতে হবে।

curl -X POST https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks/deleteItems \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//New/Appended/XPath"
    ]
  }'

মুছে দেওয়ার প্রসেস সম্পূর্ণ হলে, নিম্নলিখিত মেসেজ সহ একটি 200K উত্তর দেখানো হয়: Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

৫. সম্পূর্ণ কাস্টম XPath তালিকা মুছে দিন (DELETE)

কাস্টম XPath তালিকা সম্পূর্ণভাবে সরিয়ে দিতে DELETE পদ্ধতি ব্যবহার করুন। এর ফলে শুধুমাত্র কাস্টম মাস্ক সরিয়ে দেওয়া হবে; ডিফল্ট মাস্ক এখনও প্রয়োগ করা থাকবে।

curl -X DELETE https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

মোছা সম্পূর্ণ হলে, নিম্নলিখিত মেসেজ সহ একটি ২০৪ নো কন্টেন্ট রেসপন্স দেখানো হয়: Success response (204 No Content):

HTTP/1.1 204 No Content

মাস্ক করা বান্ডেল আপডেট করা

আপনি কাস্টম PII মাস্কিং কনফিগারেশন পরিবর্তন করলে, পুরনো মাস্ক কনফিগারেশন সহ আগে আপলোড করা API প্রক্সি বান্ডেলগুলিকে লেটেস্ট মাস্ক ব্যবহার করে আবার প্রসেস করতে হবে। লেটেস্ট মাস্কিং সেটিংস সহ বান্ডেল আপডেট করতে, প্রয়োজনীয় রিপ্রসেসিং শুরু করার জন্য একটি সহায়তা টিকিট জমা দিন।