Gerenciar a mascaramento de informações de identificação pessoal (PII) em pacotes de proxy e sharedflow

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Gerenciar a mascaramento de PII em pacotes de proxy e sharedflow

Como parte do processo de sincronização, a integração do conector do hub de APIs faz upload dos pacotes de proxy de API para o hub de APIs. Esses pacotes podem conter dados sensíveis ou informações de identificação pessoal (PII) nas configurações de política. Com esse recurso, é possível mascarar os campos de PII identificados antes que os pacotes sejam enviados ao hub de API.

Abordagem de mascaramento

A mascaramento de PII é aplicado usando expressões XPath para segmentar elementos específicos nas configurações de política nos pacotes de proxy e sharedflow formatados em XML, mas não em outros elementos XML gerais no pacote. Esse recurso é dividido em duas partes:

Máscaras padrão

O Apigee Edge inclui uma lista predefinida e integrada de expressões XPath que segmentam automaticamente campos comuns de PII. Essas máscaras são aplicadas automaticamente durante o processo de upload.

Lista de máscaras padrão:

Gerenciar máscaras personalizadas

Uma API dedicada permite enviar uma lista personalizada de expressões XPath para mascarar campos específicos identificados como PII, garantindo que suas necessidades exclusivas de privacidade de dados sejam atendidas.

É possível gerenciar as máscaras de PII personalizadas da sua organização usando o endpoint da API de gerenciamento do /v1/organizations/<var>ORG_NAME/uapim/proxymasks Edge. Você precisa ter o papel orgadmin para realizar essas operações.

A API opera em uma única lista de XPaths chamada proxymasks para uma determinada organização.

Todas as solicitações e respostas bem-sucedidas para criar, substituir, receber, anexar ou excluir itens da lista XPath usam o seguinte esquema JSON:

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

1. Criar ou substituir a lista XPath personalizada (PUT)

Use o método PUT para criar uma lista personalizada ou substituir completamente o conteúdo de uma lista atual. Todos os XPaths atuais são substituídos.

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

Quando a atualização for concluída, uma resposta 201 Created ou 200K vai aparecer com a seguinte mensagem: Success response (201 Created or 200 OK)

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

2. Recuperar a lista XPath personalizada (GET)

Use o método GET para recuperar a lista atual de expressões XPath personalizadas.

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

Quando a recuperação for concluída, uma resposta 200K vai aparecer com a seguinte mensagem:Success response (200 OK):

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

3. Anexar XPaths à lista (anexação POST)

Use o método POST para anexar uma ou mais expressões XPath à lista atual sem substituir o conteúdo.

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

Quando a inclusão for concluída, uma resposta 200K vai aparecer com a seguinte mensagem: Success response (200 OK):

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

4. Excluir XPaths específicos da lista (POST deleteItems)

Use o método POST para remover expressões XPath específicas da lista atual. A solicitação precisa conter as strings XPath exatas a serem removidas.

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

Quando a exclusão for concluída, uma resposta 200K vai aparecer com a seguinte mensagem: Success response (200 OK):

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

5. Excluir toda a lista de XPath personalizados (DELETE)

Use o método DELETE para remover completamente a lista de XPath personalizada. Isso vai remover apenas as máscaras personalizadas. As máscaras padrão ainda serão aplicadas.

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

Quando a exclusão for concluída, uma resposta 204 No Content vai aparecer com a seguinte mensagem: Success response (204 No Content):

HTTP/1.1 204 No Content

Como atualizar pacotes mascarados

Quando você modifica sua configuração personalizada de mascaramento de PII, os pacotes de proxy de API enviados anteriormente com uma configuração de máscara mais antiga precisam ser reprocessados com as máscaras mais recentes. Para atualizar os pacotes com as configurações de mascaramento mais recentes, abra um tíquete de suporte e inicie o reprocessamento necessário.