إدارة إخفاء معلومات تحديد الهوية الشخصية في حِزم الخادم الوكيل وSharedflow

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

إدارة إخفاء معلومات تحديد الهوية الشخصية في حِزم الخادم الوكيل وSharedflow

كجزء من عملية المزامنة، يحمّل دمج موصّل API hub حِزم خادم وكيل واجهة برمجة التطبيقات إلى API hub. قد تحتوي هذه الحِزم على بيانات حسّاسة أو معلومات تكشف الهوية الشخصية (PII) ضمن إعدادات السياسة. تتيح لك هذه الميزة إخفاء حقول معلومات تحديد الهوية الشخصية التي تم رصدها قبل تحميل الحِزم إلى "مركز واجهات برمجة التطبيقات".

طريقة إخفاء المحتوى

يتم تطبيق إخفاء معلومات تكشف الهوية الشخصية باستخدام تعبيرات XPath لاستهداف عناصر معيّنة ضمن إعدادات السياسات في حِزم الخادم الوكيل وSharedflow بتنسيق XML، ولكن ليس على عناصر XML العامة الأخرى داخل الحزمة. تنقسم هذه الميزة إلى جزأين:

النماذج التلقائية

تتضمّن Apigee Edge قائمة محدّدة مسبقًا ومضمّنة من تعبيرات XPath التي تستهدف تلقائيًا حقول معلومات التعريف الشخصية الشائعة. يتم تطبيق هذه الأقنعة تلقائيًا أثناء عملية التحميل.

قائمة الأقنعة التلقائية:

إدارة الأقنعة المخصّصة

تتيح لك واجهة برمجة تطبيقات مخصّصة إرسال قائمة مخصّصة بتعبيرات XPath لإخفاء حقول معيّنة تحدّدها على أنّها معلومات تكشف الهوية الشخصية، ما يضمن تلبية احتياجاتك الفريدة المتعلّقة بخصوصية البيانات.

يمكنك إدارة أقنعة معلومات تحديد الهوية الشخصية المخصّصة لمؤسستك باستخدام نقطة نهاية /v1/organizations/<var>ORG_NAME/uapim/proxymasks Edge Management API. يجب أن يكون لديك دور orgadmin لتنفيذ هذه العمليات.

تعمل واجهة برمجة التطبيقات على قائمة واحدة من XPaths باسم proxymasks لمؤسسة معيّنة.

تستخدم جميع الطلبات والاستجابات الناجحة لإنشاء عناصر أو استبدالها أو الحصول عليها أو إلحاقها أو حذفها من قائمة XPath مخطط JSON التالي:

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

1. إنشاء قائمة 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"
  ]
}

2. استرداد قائمة XPath المخصّصة (GET)

استخدِم طريقة 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"
  ]
}

3- إلحاق 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"
  ]
}

4. حذف مسارات 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"
    ]
  }'

عند اكتمال عملية الحذف، سيظهر الردّ 200K مع الرسالة التالية: Success response (200 OK):

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

5- حذف قائمة XPath المخصّصة بأكملها (DELETE)

استخدِم طريقة DELETE لإزالة قائمة XPath المخصّصة بالكامل. سيؤدي ذلك إلى إزالة الأقنعة المخصّصة فقط، وستظل الأقنعة التلقائية مطبَّقة.

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

تعديل الحِزم المخفية

عند تعديل إعدادات إخفاء هوية المعلومات الشخصية المخصّصة، يجب إعادة معالجة حِزم خادم وكيل واجهة برمجة التطبيقات التي تم تحميلها سابقًا باستخدام إعدادات إخفاء هوية أقدم باستخدام أحدث عمليات الإخفاء. لتعديل الحِزم باستخدام أحدث إعدادات الإخفاء، يُرجى إرسال طلب دعم لبدء عملية إعادة المعالجة اللازمة.