Administra el enmascaramiento de la información de identificación personal (PII) en paquetes de proxy y sharedflow

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Administra el enmascaramiento de PII en paquetes de proxy y flujo compartido

Como parte del proceso de sincronización, la integración del conector de API hub sube tus paquetes de proxy de API a API hub. Estos paquetes pueden contener datos sensibles o información de identificación personal (PII) dentro de las configuraciones de políticas. Esta función te permite enmascarar los campos de PII identificados antes de que los paquetes se suban a API hub.

Enfoque de enmascaramiento

El enmascaramiento de PII se aplica con expresiones XPath para segmentar elementos específicos dentro de las configuraciones de políticas en los paquetes de proxy y flujo compartido con formato XML, pero no a otros elementos XML generales dentro del paquete. Esta función se divide en dos partes:

Máscaras predeterminadas

Apigee Edge incluye una lista integrada y predefinida de expresiones XPath que segmentan automáticamente los campos de PII comunes. Estas máscaras se aplican automáticamente durante el proceso de carga.

Lista de máscaras predeterminadas:

Administra máscaras personalizadas

Una API dedicada te permite enviar una lista personalizada de expresiones XPath para enmascarar campos específicos que identificas como información de identificación personal, lo que garantiza que se satisfagan tus necesidades únicas de privacidad de los datos.

Puedes administrar las máscaras de PII personalizadas de tu organización con el endpoint de API de administración de Edge /v1/organizations/<var>ORG_NAME/uapim/proxymasks. Debes tener la función orgadmin para realizar estas operaciones.

La API opera en una sola lista de XPaths llamada proxymasks para una organización determinada.

Todas las solicitudes y respuestas correctas para crear, reemplazar, obtener, agregar o borrar elementos de la lista de XPath usan el siguiente esquema JSON:

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

1. Crea o reemplaza la lista de XPath personalizada (PUT)

Usa el método PUT para crear una lista personalizada nueva o reemplazar por completo el contenido de una lista existente. Se sobrescriben todos los XPaths existentes.

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

Cuando se complete la actualización, se mostrará una respuesta 201 Created o 200K con el siguiente mensaje: Success response (201 Created or 200 OK).

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

2. Recupera la lista de XPath personalizada (GET)

Usa el método GET para recuperar la lista actual de expresiones XPath personalizadas.

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

Cuando se complete la recuperación, se mostrará una respuesta 200K con el siguiente mensaje:Success response (200 OK):.

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

3. Agrega XPaths a la lista (POST append)

Usa el método POST para agregar una o más expresiones XPath a la lista existente sin sobrescribir el contenido actual.

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

Cuando se complete la adición, se mostrará una respuesta 200K con el siguiente mensaje: Success response (200 OK):.

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

4. Borra XPaths específicos de la lista (POST deleteItems)

Usa el método POST para quitar expresiones XPath específicas de la lista existente. La solicitud debe contener las cadenas XPath exactas que se quitarán.

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

Cuando se complete la eliminación, se mostrará una respuesta 200K con el siguiente mensaje: Success response (200 OK):.

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

5. Borra toda la lista de XPath personalizada (DELETE)

Usa el método DELETE para quitar por completo la lista de XPath personalizada. Esto quitará solo las máscaras personalizadas ; las máscaras predeterminadas se seguirán aplicando.

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

Cuando se complete la eliminación, se mostrará una respuesta 204 No Content con el siguiente mensaje: Success response (204 No Content):.

HTTP/1.1 204 No Content

Actualiza paquetes enmascarados

Cuando modificas la configuración de enmascaramiento de PII personalizada, los paquetes de proxy de API que se subieron anteriormente con una configuración de máscara anterior deben volver a procesarse con las máscaras más recientes. Para actualizar los paquetes con la configuración de enmascaramiento más reciente, envía un ticket de asistencia para iniciar el reprocesamiento necesario.