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

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

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

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

رویکرد پوشاندن

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

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

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

فهرست پوشش‌های پیش‌فرض:

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

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

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

این «میانای برنامه‌سازی کاربردی» روی یک فهرست واحد از XPaths به نام proxymasks برای یک سازمان معین عمل می‌کند.

همه درخواست‌ها و پاسخ‌های موفق برای ایجاد، جایگزینی، دریافت، پیوست کردن، یا حذف کردن عناصر از فهرست XPath از طرحواره JSON زیر استفاده می‌کنند:

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

۱. ایجاد یا جایگزین کردن فهرست سفارشی XPath (قرار دادن)

از روش 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 استفاده کنید.

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)

از روش 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"
    ]
  }'

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

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

۴. حذف کردن XPaths خاص از فهرست (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"
    ]
  }'

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

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

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

از روش 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

درحال به‌روزرسانی دسته‌های پوشانده‌شده

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