Mengelola penyamaran informasi identitas pribadi (PII) dalam paket proxy dan sharedflow

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Mengelola penyamaran PII dalam proxy dan paket sharedflow

Sebagai bagian dari proses sinkronisasi, integrasi konektor hub API mengupload paket proxy API Anda ke hub API. Paket ini dapat berisi data sensitif, atau Informasi Identitas Pribadi (PII), dalam konfigurasi kebijakan. Fitur ini memungkinkan Anda menyamarkan kolom PII yang teridentifikasi sebelum bundle diupload ke hub API.

Pendekatan penyamaran

Penyamaran PII diterapkan menggunakan ekspresi XPath untuk menargetkan elemen tertentu dalam konfigurasi kebijakan di paket proxy dan sharedflow berformat XML, tetapi tidak untuk elemen XML umum lainnya dalam paket. Fitur ini dibagi menjadi dua bagian:

Masker default

Apigee Edge menyertakan daftar ekspresi XPath bawaan yang telah ditentukan sebelumnya yang secara otomatis menargetkan kolom PII umum. Masker ini diterapkan secara otomatis selama proses upload.

Daftar masker default:

Mengelola masker kustom

API khusus memungkinkan Anda mengirimkan daftar ekspresi XPath yang disesuaikan untuk menyamarkan kolom tertentu yang Anda identifikasi sebagai PII, sehingga memastikan kebutuhan privasi data unik Anda terpenuhi.

Anda dapat mengelola mask PII kustom organisasi menggunakan endpoint API pengelolaan Edge /v1/organizations/<var>ORG_NAME/uapim/proxymasks. Anda harus memiliki peran orgadmin untuk melakukan operasi ini.

API ini beroperasi pada satu daftar XPath bernama proxymasks untuk organisasi tertentu.

Semua permintaan dan respons yang berhasil untuk membuat, mengganti, mendapatkan, menambahkan, atau menghapus item dari daftar XPath menggunakan skema JSON berikut:

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

1. Membuat atau mengganti daftar XPath kustom (PUT)

Gunakan metode PUT untuk membuat daftar kustom baru atau mengganti sepenuhnya konten daftar yang ada. XPath yang ada akan ditimpa.

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

Setelah update selesai, respons 201 Created atau 200K akan ditampilkan dengan pesan berikut: Success response (201 Created or 200 OK)

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

2. Mengambil daftar XPath kustom (GET)

Gunakan metode GET untuk mengambil daftar ekspresi XPath kustom saat ini.

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

Setelah pengambilan selesai, respons 200K akan ditampilkan dengan pesan berikut:Success response (200 OK):

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

3. Menambahkan XPath ke daftar (POST append)

Gunakan metode POST untuk menambahkan satu atau beberapa ekspresi XPath ke daftar yang ada tanpa menimpa konten saat ini.

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

Setelah penambahan selesai, respons 200K akan ditampilkan dengan pesan berikut: Success response (200 OK):

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

4. Menghapus XPath tertentu dari daftar (POST deleteItems)

Gunakan metode POST untuk menghapus ekspresi XPath tertentu dari daftar yang ada. Permintaan harus berisi string XPath persis yang akan dihapus.

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

Setelah penghapusan selesai, respons 200K akan ditampilkan dengan pesan berikut: Success response (200 OK):

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

5. Menghapus seluruh daftar XPath kustom (DELETE)

Gunakan metode DELETE untuk menghapus daftar XPath kustom sepenuhnya. Tindakan ini hanya akan menghapus mask kustom; mask default akan tetap diterapkan.

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

Setelah penghapusan selesai, respons 204 No Content akan ditampilkan dengan pesan berikut: Success response (204 No Content):

HTTP/1.1 204 No Content

Memperbarui bundle yang disamarkan

Saat Anda mengubah konfigurasi masking PII kustom, paket proxy API yang sebelumnya diupload dengan konfigurasi masking yang lebih lama harus diproses ulang dengan masking terbaru. Untuk memperbarui paket dengan setelan penyamaran terbaru, ajukan tiket dukungan untuk memulai pemrosesan ulang yang diperlukan.