ניהול מיסוך של פרטים אישיים מזהים (PII) בחבילות של שרתי proxy ושל sharedflow

אתם צופים במסמכי התיעוד של Apigee Edge.
אפשר לעבור אל מסמכי התיעוד של Apigee X. מידע

ניהול מיסוך של מידע אישי בחבילות של שרת proxy ו-sharedflow

כחלק מתהליך הסנכרון, שילוב המחבר של API Hub מעלה את חבילות שרתי ה-proxy של ה-API אל API Hub. יכול להיות שהחבילות האלה יכילו נתונים רגישים או פרטים אישיים מזהים (PII), במסגרת הגדרות המדיניות. התכונה הזו מאפשרת להסתיר שדות של מידע אישי מזהה לפני שהחבילות מועלות למרכז ה-API.

שיטת המסקינג

ההסתרה של מידע אישי מתבצעת באמצעות ביטויי XPath שמטרתם היא לזהות רכיבים ספציפיים בהגדרות המדיניות בחבילות של שרת ה-Proxy ושל SharedFlow בפורמט XML, אבל לא רכיבי XML כלליים אחרים בחבילה. התכונה הזו מחולקת לשני חלקים:

מסכות ברירת מחדל

‫Apigee Edge כולל רשימה מוגדרת מראש של ביטויי XPath שמטרגטים באופן אוטומטי שדות נפוצים של מידע אישי (PII). המסכות האלה מופעלות אוטומטית במהלך תהליך ההעלאה.

רשימה של מסכות ברירת מחדל:

ניהול מסכות בהתאמה אישית

ממשק API ייעודי מאפשר לכם לשלוח רשימה מותאמת אישית של ביטויי XPath כדי להסתיר שדות ספציפיים שזיהיתם כ-PII, וכך לוודא שהצרכים הייחודיים שלכם בנוגע לפרטיות הנתונים יסופקו.

אתם יכולים לנהל את מסכות ה-PII המותאמות אישית של הארגון באמצעות /v1/organizations/<var>ORG_NAME/uapim/proxymasks נקודת הקצה של Edge Management API. כדי לבצע את הפעולות האלה, צריכה להיות לכם הרשאה מסוג orgadmin.

ה-API פועל על רשימה אחת של נתיבי XPath בשם proxymasks עבור ארגון נתון.

כל הבקשות והתשובות שמתקבלות בהצלחה ליצירה, להחלפה, לקבלת, להוספה או למחיקה של פריטים מרשימת ה-XPath משתמשות בסכימת ה-JSON הבאה:

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

1. יצירה או החלפה של רשימת XPath מותאמת אישית (PUT)

אפשר להשתמש בשיטה PUT כדי ליצור רשימה חדשה בהתאמה אישית או להחליף לחלוטין את התוכן של רשימה קיימת. כל נתיבי ה-XML הקיימים יוחלפו.

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. מחיקת XPath ספציפיים מהרשימה (POST 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"
  ]
}

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

עדכון חבילות מוסוות

כשמשנים את ההגדרה של מיסוך נתונים אישיים בהתאמה אישית, צריך לעבד מחדש את חבילות ה-API proxy שהועלו בעבר עם הגדרת מיסוך ישנה יותר, באמצעות המיסוכים העדכניים. כדי לעדכן את חבילות הנתונים עם הגדרות המיסוך העדכניות, צריך לשלוח כרטיס תמיכה כדי להתחיל את העיבוד מחדש הנדרש.