Quản lý việc che thông tin nhận dạng cá nhân (PII) trong các gói proxy và sharedflow

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. Thông tin

Quản lý việc che giấu thông tin nhận dạng cá nhân trong các gói proxy và sharedflow

Trong quy trình đồng bộ hoá, chế độ tích hợp trình kết nối trung tâm API sẽ tải các gói proxy API lên trung tâm API. Các gói này có thể chứa dữ liệu nhạy cảm hoặc Thông tin nhận dạng cá nhân (PII) trong cấu hình chính sách. Tính năng này cho phép bạn che các trường thông tin nhận dạng cá nhân đã xác định trước khi các gói được tải lên trung tâm API.

Phương pháp che

Tính năng che giấu thông tin nhận dạng cá nhân được áp dụng bằng cách sử dụng các biểu thức XPath để nhắm đến các phần tử cụ thể trong cấu hình chính sách trong các gói proxy và sharedflow có định dạng XML, nhưng không áp dụng cho các phần tử XML chung khác trong gói. Tính năng này được chia thành hai phần:

Mặt nạ mặc định

Apigee Edge có một danh sách được xác định trước và tích hợp sẵn các biểu thức XPath tự động nhắm đến các trường thông tin nhận dạng cá nhân phổ biến. Các mặt nạ này sẽ tự động được áp dụng trong quá trình tải lên.

Danh sách các mặt nạ mặc định:

Quản lý mặt nạ tuỳ chỉnh

Một API chuyên dụng cho phép bạn gửi danh sách tuỳ chỉnh các biểu thức XPath để che các trường cụ thể mà bạn xác định là PII, đảm bảo đáp ứng các nhu cầu riêng biệt của bạn về quyền riêng tư đối với dữ liệu.

Bạn có thể quản lý các mặt nạ thông tin nhận dạng cá nhân (PII) tuỳ chỉnh của tổ chức bằng điểm cuối /v1/organizations/<var>ORG_NAME/uapim/proxymasks Edge Management API. Bạn phải có vai trò orgadmin để thực hiện các thao tác này.

API này hoạt động trên một danh sách XPath duy nhất có tên là proxymasks cho một tổ chức nhất định.

Tất cả các yêu cầu và phản hồi thành công để tạo, thay thế, nhận, thêm hoặc xoá các mục khỏi danh sách XPath đều sử dụng lược đồ JSON sau:

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

1. Tạo hoặc thay thế danh sách XPath tuỳ chỉnh (PUT)

Sử dụng phương thức PUT để tạo một danh sách tuỳ chỉnh mới hoặc thay thế hoàn toàn nội dung của một danh sách hiện có. Mọi XPath hiện có sẽ bị ghi đè.

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"
    ]
  }'

Khi quá trình cập nhật hoàn tất, phản hồi 201 Created hoặc 200K sẽ hiển thị thông báo sau: Success response (201 Created or 200 OK)

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

2. Truy xuất danh sách XPath tuỳ chỉnh (GET)

Sử dụng phương thức GET để truy xuất danh sách hiện tại gồm các biểu thức XPath tuỳ chỉnh.

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

Khi quá trình truy xuất hoàn tất, một phản hồi 200K sẽ hiển thị thông báo sau:Success response (200 OK):

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

3. Thêm XPath vào danh sách (thêm POST)

Sử dụng phương thức POST để thêm một hoặc nhiều biểu thức XPath vào danh sách hiện có mà không ghi đè nội dung hiện tại.

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"
    ]
  }'

Khi quá trình thêm hoàn tất, một phản hồi 200K sẽ xuất hiện kèm theo thông báo sau: Success response (200 OK):

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

4. Xoá các XPath cụ thể khỏi danh sách (POST deleteItems)

Sử dụng phương thức POST để xoá các biểu thức XPath cụ thể khỏi danh sách hiện có. Yêu cầu phải chứa chuỗi XPath chính xác cần xoá.

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"
    ]
  }'

Khi quá trình xoá hoàn tất, một phản hồi 200K sẽ xuất hiện kèm theo thông báo sau: Success response (200 OK):

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

5. Xoá toàn bộ danh sách XPath tuỳ chỉnh (XOÁ)

Sử dụng phương thức DELETE để xoá hoàn toàn danh sách XPath tuỳ chỉnh. Thao tác này sẽ chỉ xoá các mặt nạ tuỳ chỉnh; các mặt nạ mặc định vẫn sẽ được áp dụng.

curl -X DELETE https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

Khi quá trình xoá hoàn tất, phản hồi 204 No Content (Không có nội dung) sẽ xuất hiện cùng với thông báo sau: Success response (204 No Content):

HTTP/1.1 204 No Content

Cập nhật các gói bị che

Khi bạn sửa đổi cấu hình che giấu thông tin nhận dạng cá nhân tuỳ chỉnh, các gói proxy API đã được tải lên trước đó bằng cấu hình mặt nạ cũ cần được xử lý lại bằng các mặt nạ mới nhất. Để cập nhật các gói bằng chế độ cài đặt che mặt mới nhất, vui lòng gửi phiếu yêu cầu hỗ trợ để bắt đầu quy trình xử lý lại cần thiết.