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 o mascaramento de PII em pacotes de proxy e sharedflow

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

Abordagem de mascaramento

O 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 para 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 de API de gerenciamento do Edge /v1/organizations/<var>ORG_NAME/uapim/proxymasks. 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 nova 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 será exibida 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 será exibida com a seguinte mensagem:Success response (200 OK):

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

3. Anexar XPaths à lista (POST append)

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

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 anexação for concluída, uma resposta 200K será exibida 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 será exibida com a seguinte mensagem: Success response (200 OK):

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

5. Excluir toda a lista XPath personalizada (DELETE)

Use o método DELETE para remover completamente a lista XPath personalizada. Isso 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 será exibida com a seguinte mensagem: Success response (204 No Content):

HTTP/1.1 204 No Content

Atualizar pacotes mascarados

Ao modificar a configuração de mascaramento de PII personalizada, os pacotes de proxy de API que foram 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, registre um tíquete de suporte para iniciar o reprocessamento necessário.