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

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

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

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

طريقة الإخفاء

يتم تطبيق إخفاء هوية معلومات التعريف الشخصية باستخدام تعبيرات 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 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"
    ]
  }'

عند اكتمال عملية الإلحاق، ستظهر استجابة 200K مع الرسالة التالية: Success response (200 OK):

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

4. حذف 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"
  ]
}

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

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

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