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

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

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

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

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

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

ডিফল্ট মাস্ক

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

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

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

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

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

API একটি নির্দিষ্ট প্রতিষ্ঠানের জন্য proxymasks নামে XPath-এর একটি একক তালিকার উপর কাজ করে।

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 তৈরি বা 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 গুলি মুছে ফেলুন (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"

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

HTTP/1.1 204 No Content

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

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