Управление маскировкой персонально идентифицируемой информации (PII) в прокси-серверах и пакетах Sharedflow

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info

Управление маскированием персональных данных в прокси-серверах и пакетах Sharedflow.

В рамках процесса синхронизации интеграция коннектора API Hub загружает ваши пакеты API-прокси в API Hub. Эти пакеты могут содержать конфиденциальные данные или персональные данные (PII) в конфигурациях политик. Эта функция позволяет маскировать поля с идентифицированными персональными данными перед загрузкой пакетов в API Hub.

Маскирующий подход

Маскировка персональных данных применяется с использованием выражений XPath для выбора конкретных элементов в конфигурациях политик в XML-форматированных прокси-серверах и пакетах Sharedflow, но не для других общих XML-элементов внутри пакета. Эта функция разделена на две части:

Маски по умолчанию

Apigee Edge включает в себя предопределенный встроенный список выражений XPath, которые автоматически нацелены на распространенные поля, содержащие персональные данные. Эти маски применяются автоматически в процессе загрузки.

Список масок по умолчанию:

Управление пользовательскими масками

Специальный API позволяет отправлять настраиваемый список выражений XPath для маскировки определенных полей, которые вы определяете как персональные данные, обеспечивая тем самым соблюдение ваших уникальных требований к конфиденциальности данных.

Вы можете управлять пользовательскими масками персональных данных вашей организации, используя конечную точку API управления Edge по адресу /v1/organizations/<var>ORG_NAME /uapim/proxymasks . Для выполнения этих операций вам необходима роль 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 к существующему списку без перезаписи текущего содержимого.

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

После завершения добавления данных отобразится ответ размером 200 КБ со следующим сообщением: Success response (200 OK):

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

4. Удалите определенные XPath-ы из списка (POST deleteItems)

Для удаления определенных выражений XPath из существующего списка используйте метод POST . Запрос должен содержать точные строки 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"
    ]
  }'

После завершения удаления отображается ответ размером 200 КБ со следующим сообщением: 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 «Нет содержимого» со следующим сообщением: Success response (204 No Content):

HTTP/1.1 204 No Content

Обновление маскированных пакетов

При изменении конфигурации маскирования персональных данных пакеты API-прокси, ранее загруженные с более старой конфигурацией маскирования, необходимо повторно обработать с использованием последних настроек. Для обновления пакетов с учетом последних настроек маскирования, пожалуйста, создайте заявку в службу поддержки, чтобы инициировать необходимую повторную обработку.