مدیریت پوشش اطلاعات شخصی قابل شناسایی (PII) در بسته‌های پروکسی و جریان مشترک

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

مدیریت پوشش PII در بسته‌های پروکسی و جریان مشترک

به عنوان بخشی از فرآیند همگام‌سازی، ادغام رابط API hub، بسته‌های پروکسی API شما را در API hub آپلود می‌کند. این بسته‌ها ممکن است حاوی داده‌های حساس یا اطلاعات شخصی قابل شناسایی (PII) در پیکربندی‌های خط‌مشی باشند. این ویژگی به شما امکان می‌دهد قبل از آپلود بسته‌ها در API hub، فیلدهای PII شناسایی شده را پنهان کنید.

رویکرد ماسکینگ

پوشش PII با استفاده از عبارات XPath برای هدف قرار دادن عناصر خاص در پیکربندی‌های سیاست در بسته‌های پروکسی و جریان مشترک با فرمت XML اعمال می‌شود، اما برای سایر عناصر XML عمومی موجود در بسته اعمال نمی‌شود. این ویژگی به دو بخش تقسیم می‌شود:

ماسک‌های پیش‌فرض

Apigee Edge شامل یک لیست از پیش تعریف شده و داخلی از عبارات XPath است که به طور خودکار فیلدهای رایج PII را هدف قرار می‌دهند. این ماسک‌ها به طور خودکار در طول فرآیند آپلود اعمال می‌شوند.

لیست ماسک‌های پیش‌فرض:

مدیریت ماسک‌های سفارشی

یک API اختصاصی به شما امکان می‌دهد لیستی سفارشی از عبارات XPath را برای پوشاندن فیلدهای خاصی که به عنوان PII شناسایی می‌کنید، ارسال کنید و از برآورده شدن نیازهای منحصر به فرد حریم خصوصی داده‌های خود اطمینان حاصل کنید.

شما می‌توانید ماسک‌های PII سفارشی سازمان خود را با استفاده از نقطه پایانی API مدیریت Edge در مسیر /v1/organizations/<var>ORG_NAME /uapim/proxymasks مدیریت کنید. برای انجام این عملیات باید نقش orgadmin را داشته باشید.

این API روی یک لیست واحد از XPathها به نام proxymasks برای یک سازمان خاص عمل می‌کند.

تمام درخواست‌ها و پاسخ‌های موفق برای ایجاد، جایگزینی، دریافت، افزودن یا حذف موارد از لیست 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)

از متد GET برای بازیابی لیست فعلی عبارات XPath سفارشی استفاده کنید.

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

وقتی بازیابی کامل شد، یک پاسخ ۲۰۰ هزارتایی با پیام زیر نمایش داده می‌شود: Success response (200 OK):

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

۳. اضافه کردن XPathها به لیست (با استفاده از POST append)

از متد POST برای اضافه کردن یک یا چند عبارت XPath به لیست موجود بدون بازنویسی محتوای فعلی استفاده کنید.

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"
    ]
  }'

وقتی پیوست تکمیل شد، یک پاسخ ۲۰۰ هزارتایی با پیام زیر نمایش داده می‌شود: Success response (200 OK):

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

۴. حذف XPath های خاص از لیست (با استفاده از دستور POST deleteItems)

از متد POST برای حذف عبارات XPath خاص از لیست موجود استفاده کنید. درخواست باید دقیقاً شامل رشته‌های 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"
    ]
  }'

وقتی حذف کامل شد، یک پاسخ ۲۰۰ هزارتایی با پیام زیر نمایش داده می‌شود: Success response (200 OK):

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

۵. کل لیست XPath سفارشی را حذف کنید (DELETE)

از متد DELETE برای حذف کامل لیست XPath سفارشی استفاده کنید. این کار فقط ماسک‌های سفارشی را حذف می‌کند؛ ماسک‌های پیش‌فرض همچنان اعمال خواهند شد.

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

وقتی حذف کامل شد، پاسخ 204 بدون محتوا با پیام زیر نمایش داده می‌شود: Success response (204 No Content):

HTTP/1.1 204 No Content

به‌روزرسانی بسته‌های نقاب‌دار

وقتی پیکربندی ماسک PII سفارشی خود را تغییر می‌دهید، بسته‌های پروکسی API که قبلاً با پیکربندی ماسک قدیمی‌تر آپلود شده‌اند، باید با جدیدترین ماسک‌ها دوباره پردازش شوند. برای به‌روزرسانی بسته‌ها با جدیدترین تنظیمات ماسک، لطفاً یک تیکت پشتیبانی ثبت کنید تا پردازش مجدد لازم آغاز شود.