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

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

จัดการการมาสก์ PII ในพร็อกซีและ Bundle ของ Sharedflow

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

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

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

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

Apigee Edge มีรายการ XPath Expression ที่กำหนดไว้ล่วงหน้าและในตัว ซึ่งกำหนดเป้าหมายช่อง PII ทั่วไปโดยอัตโนมัติ ระบบจะใช้การมาสก์เหล่านี้โดยอัตโนมัติในระหว่างกระบวนการอัปโหลด

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

จัดการการมาสก์ที่กำหนดเอง

API เฉพาะช่วยให้คุณส่งรายการ XPath Expression ที่กำหนดเองเพื่อมาสก์ช่องที่เฉพาะเจาะจงซึ่งคุณระบุว่าเป็น 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 Expression ที่กำหนดเองปัจจุบัน

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 Expression อย่างน้อย 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 Expression ที่เฉพาะเจาะจงออกจากรายการที่มีอยู่ คำขอต้องมีสตริง 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 ที่กำหนดเอง ระบบจะต้องประมวลผล Bundle ของพร็อกซี API ที่อัปโหลดไว้ก่อนหน้านี้ด้วยการกำหนดค่าการมาสก์ที่เก่ากว่าอีกครั้งด้วยการมาสก์ล่าสุด หากต้องการอัปเดต Bundle ด้วยการตั้งค่าการมาสก์ล่าสุด โปรดส่งตั๋วสนับสนุนเพื่อเริ่มการประมวลผลซ้ำที่จำเป็น