Proxy ve sharedflow paketlerinde kimliği tanımlayabilecek bilgilerin (PII) maskelenmesini yönetme

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

Proxy ve sharedflow paketlerinde kimliği tanımlayabilecek bilgilerin maskelenmesini yönetme

Senkronizasyon sürecinin bir parçası olarak, API Hub bağlayıcı entegrasyonu API proxy paketlerinizi API Hub'a yükler. Bu paketler, politika yapılandırmaları içinde hassas veriler veya kimliği tanımlayabilecek bilgiler (PII) içerebilir. Bu özellik, paketler API merkezine yüklenmeden önce tanımlanan kimlik bilgisi alanlarını maskelemenize olanak tanır.

Maskeleme yaklaşımı

Kişisel olarak tanımlanabilir bilgilerin maskelenmesi, XML biçimli proxy ve sharedflow paketlerindeki politika yapılandırmalarında belirli öğeleri hedeflemek için XPath ifadeleri kullanılarak uygulanır ancak paket içindeki diğer genel XML öğelerine uygulanmaz. Bu özellik iki bölüme ayrılmıştır:

Varsayılan maskeler

Apigee Edge, yaygın kimliği tanımlayabilecek bilgiler alanlarını otomatik olarak hedefleyen, önceden tanımlanmış ve yerleşik bir XPath ifadeleri listesi içerir. Bu maskeler, yükleme işlemi sırasında otomatik olarak uygulanır.

Varsayılan maskelerin listesi:

Özel maskeleri yönetme

Özel bir API, kimliği tanımlayabilecek bilgi (PII) olarak tanımladığınız belirli alanları maskelemek için özelleştirilmiş bir XPath ifadeleri listesi göndermenize olanak tanır. Böylece, benzersiz veri gizliliği ihtiyaçlarınız karşılanır.

Kuruluşunuzun özel kimliği tanımlayabilecek bilgiler (PII) maskelerini /v1/organizations/<var>ORG_NAME/uapim/proxymasks Edge Management API uç noktasını kullanarak yönetebilirsiniz. Bu işlemleri gerçekleştirmek için orgadmin rolüne sahip olmanız gerekir.

API, belirli bir kuruluş için proxymasks adlı tek bir XPath listesi üzerinde çalışır.

XPath listesinden öğe oluşturma, değiştirme, alma, ekleme veya silme ile ilgili tüm istekler ve başarılı yanıtlar için aşağıdaki JSON şeması kullanılır:

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

1. Özel XPath listesini oluşturma veya değiştirme (PUT)

Yeni bir özel liste oluşturmak veya mevcut bir listenin içeriğini tamamen değiştirmek için PUT yöntemini kullanın. Mevcut XPath'lerin üzerine yazılır.

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

Güncelleme tamamlandığında aşağıdaki mesajla birlikte 201 Created veya 200K yanıtı gösterilir: Success response (201 Created or 200 OK)

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

2. Özel XPath listesini alma (GET)

Mevcut özel XPath ifadeleri listesini almak için GET yöntemini kullanın.

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

Alma işlemi tamamlandığında aşağıdaki mesajı içeren bir 200K yanıtı gösterilir:Success response (200 OK):

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

3. Listeye XPath'ler ekleme (POST append)

Mevcut içeriğin üzerine yazmadan mevcut listeye bir veya daha fazla XPath ifadesi eklemek için POST yöntemini kullanın.

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

Ekleme işlemi tamamlandığında aşağıdaki mesajla birlikte 200K yanıtı gösterilir: Success response (200 OK):

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

4. Listeden belirli XPath'leri silme (POST deleteItems)

Mevcut listeden belirli XPath ifadelerini kaldırmak için POST yöntemini kullanın. İstek, kaldırılacak tam XPath dizelerini içermelidir.

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

Silme işlemi tamamlandığında aşağıdaki mesajla birlikte 200K yanıtı gösterilir: Success response (200 OK):

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

5. Özel XPath listesinin tamamını silme (DELETE)

Özel XPath listesini tamamen kaldırmak için DELETE yöntemini kullanın. Bu işlem yalnızca özel maskeleri kaldırır. Varsayılan maskeler uygulanmaya devam eder.

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

Silme işlemi tamamlandığında aşağıdaki mesajla birlikte 204 No Content yanıtı gösterilir: Success response (204 No Content):

HTTP/1.1 204 No Content

Maskelenmiş paketleri güncelleme

Özel kimliği tanımlayabilecek bilgileri maskeleme yapılandırmanızı değiştirdiğinizde, daha önce eski bir maske yapılandırmasıyla yüklenen API proxy paketlerinin en son maskelerle yeniden işlenmesi gerekir. Paketleri en son maskeleme ayarlarıyla güncellemek için lütfen gerekli yeniden işleme sürecini başlatmak üzere bir destek kaydı oluşturun.