প্রক্সি এবং শেয়ার্ডফ্লো বান্ডেলে ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য (PII) মাস্কিং পরিচালনা করুন

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

প্রক্সি এবং শেয়ার্ডফ্লো বান্ডেলে ব্যক্তিগত শনাক্তকরণ তথ্য (PII) মাস্কিং পরিচালনা করুন

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

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

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

ডিফল্ট মাস্ক

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

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

কাস্টম মাস্ক পরিচালনা করুন

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

আপনি /v1/organizations/<var>ORG_NAME /uapim/proxymasks এজ ম্যানেজমেন্ট এপিআই এন্ডপয়েন্ট ব্যবহার করে আপনার প্রতিষ্ঠানের কাস্টম PII মাস্কগুলি পরিচালনা করতে পারেন। এই অপারেশনগুলি সম্পাদন করার জন্য আপনার অবশ্যই orgadmin রোল থাকতে হবে।

এপিআইটি একটি নির্দিষ্ট সংস্থার জন্য proxymasks নামক এক্সপাথ-এর একটিমাত্র তালিকার উপর কাজ করে।

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

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

১. কাস্টম এক্সপাথ তালিকা তৈরি বা প্রতিস্থাপন করুন (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"
  ]
}

৩. তালিকায় XPath যুক্ত করুন (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"
  ]
}

৪. তালিকা থেকে নির্দিষ্ট XPath-গুলো মুছে ফেলুন (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"
  ]
}

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

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

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

মুছে ফেলার প্রক্রিয়াটি সম্পন্ন হলে, নিম্নলিখিত বার্তা সহ একটি 204 No Content প্রতিক্রিয়া প্রদর্শিত হয়: Success response (204 No Content):

HTTP/1.1 204 No Content

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

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