จัดการการมาสก์ข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) ในแพ็กเกจพร็อกซีและ Sharedflow

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

จัดการการมาสก์ PII ในพร็อกซีและแพ็กเกจ SharedFlow

การผสานรวมตัวเชื่อมต่อ API Hub จะอัปโหลดชุดพร็อกซี API ไปยัง API Hub ซึ่งเป็นส่วนหนึ่งของกระบวนการซิงค์ ซึ่งอาจมีข้อมูลที่ละเอียดอ่อนหรือข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) ภายในการกำหนดค่านโยบาย ฟีเจอร์นี้ช่วยให้คุณมาสก์ช่อง PII ที่ระบุได้ก่อนที่จะอัปโหลด Bundle ไปยัง API Hub

วิธีการมาสก์

การมาสก์ PII จะใช้โดยใช้นิพจน์ XPath เพื่อกำหนดเป้าหมายองค์ประกอบที่เฉพาะเจาะจงในการกำหนดค่านโยบายภายในพร็อกซีและบันเดิล Sharedflow ที่จัดรูปแบบ XML แต่จะไม่กำหนดเป้าหมายองค์ประกอบ XML ทั่วไปอื่นๆ ภายในบันเดิล ฟีเจอร์นี้แบ่งออกเป็น 2 ส่วนดังนี้

มาสก์เริ่มต้น

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 เพื่อสร้างรายการที่กำหนดเองใหม่หรือแทนที่เนื้อหาของรายการที่มีอยู่ทั้งหมด ระบบจะเขียนทับ 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. ผนวก XPath ไปยังรายการ (POST append)

ใช้วิธี POST เพื่อผนวกนิพจน์ XPath อย่างน้อย 1 รายการไปยังรายการที่มีอยู่โดยไม่ต้องเขียนทับเนื้อหาปัจจุบัน

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

การอัปเดต Bundle ที่มาสก์

เมื่อแก้ไขการกำหนดค่าการมาสก์ PII ที่กำหนดเอง คุณจะต้องประมวลผล App Bundle ของพร็อกซี API ที่อัปโหลดก่อนหน้านี้ด้วยการกำหนดค่าการมาสก์แบบเก่าอีกครั้งโดยใช้การมาสก์ล่าสุด หากต้องการอัปเดตแพ็กเกจด้วยการตั้งค่าการมาสก์ล่าสุด โปรดส่งคำขอรับตั๋วสนับสนุนเพื่อเริ่มการประมวลผลซ้ำที่จำเป็น