O mascaramento de dados é uma técnica em que os dados confidenciais são ocultados de alguma forma para torná-los seguros e proteger os dados reais, ao mesmo tempo em que há um substituto funcional para ocasiões em que os dados reais não são necessários.
Essa política é usada para mascarar dados confidenciais no nível do aplicativo. No nível do aplicativo, você deve ter uma política de identificação e acesso configurada para identificar o aplicativo ao qual o mascaramento é aplicado. Se nenhum aplicativo for especificado, ele será aplicado a todas as outras solicitações. Os campos podem ser mascarados ou filtrados nas mensagens de solicitação recebidas. Você pode configurar os critérios de mascaramento conforme necessário para as expressões XPath, JSONPath e Regex com base no tipo de conteúdo. Essa política também pode ser aplicada no nível do escopo da API.
Observação: O mascaramento de dados não pode ser realizado para:
- Cargas úteis que são enviadas como fluxos.
- Cabeçalhos de entrada do cliente.
A tabela lista o mapeamento do tipo de conteúdo e dos critérios de mascaramento.
| Tipo de Conteúdo |
Critérios de mascaramento |
| aplicativo/xml texto/xml texto/htm |
XPath |
| aplicação/json aplicação/json/badgerfish |
JSONPath |
| texto/plano |
Expressão regular |
A tabela lista as propriedades dos critérios de mascaramento que você pode configurar para mascarar os dados nas mensagens de solicitação recebidas:
| Parâmetro |
Descrição |
| Aplicativos de consumidor |
Opcional. Especifica os aplicativos para os quais o critério de mascaramento deve ser aplicado. Comece a digitar o nome do aplicativo, selecione o aplicativo nos resultados da pesquisa de digitação exibidos e clique em Add (Adicionar) para adicionar um ou mais aplicativos.
Por exemplo: Se houver um critério DataMasking(DM1 ) criado para application1, um segundo DataMasking(DM2 ) para application2 e um terceiro DataMasking(DM3 ) sem qualquer aplicação, então, para uma solicitação proveniente de consumer1, o critério de mascaramento DM1 será aplicado, e para uma solicitação proveniente de consumer2 DM2 será aplicado. Se uma solicitação vier sem nenhum aplicativo ou de qualquer outro aplicativo, exceto application1 e application2, DM3 será aplicado.
Você pode usar o ícone de exclusão para excluir os aplicativos adicionados da lista.
|
| XPath. Especifica os critérios de mascaramento para expressões XPath nas mensagens de solicitação. |
|
| Critérios de mascaramento |
Clique em Adicionar critérios de mascaramento, forneça as seguintes informações e clique em Adicionar.
- Expressão de consulta. Especifique a expressão de consulta que deve ser mascarada ou filtrada.
Por exemplo: /pet/details/status, /user/details/card/ccnumber.
- Tipo de máscara. Especifica o tipo de mascaramento necessário. Você seleciona Mask (Máscara ) ou Filter (Filtro ). A seleção de Mask substitui o valor pelo valor fornecido (o valor padrão é ********). A seleção de Filtro remove o campo completamente.
- Valor da máscara. Aparece se o tipo de mascaramento selecionado for Máscara. Forneça um valor de máscara. Você pode adicionar vários critérios de mascaramento.
Como as propriedades Query expression e Mask Value suportam a estrutura de variáveis, você pode usar as variáveis disponíveis.
No caso da expressão de consulta, se você fornecer a sintaxe da variável, o XPath será aplicado à carga útil usando o valor resolvido a partir da variável fornecida.
Por exemplo, se você fornecer uma expressão de consulta como ${request.headers.myxpath} e o valor da máscara correspondente como ${request.headers.var1} , e se o cabeçalho myxpath da solicitação de entrada estiver configurado com o valor //ns:cardNumber, o número do cartão derivado da carga útil será mascarado com o valor do cabeçalho em var1. Para obter detalhes sobre as variáveis disponíveis em webMethods API Gateway consulte Estrutura de variáveis.
- Espaço de nome. Especifica as seguintes informações de Namespace:
- Prefixo do espaço de nome. O prefixo do namespace da expressão de carga útil a ser validada.
- URI do espaço de nome. O namespace URI da expressão de carga útil a ser validada
Observação: você pode adicionar vários prefixos de namespace e URI clicando no botão Add (Adicionar).
|
| JSONPath. Isso é aplicável somente à API REST. Especifica os critérios de mascaramento para expressões JSONPath nas mensagens de solicitação. |
|
| Critérios de mascaramento |
Clique em Adicionar critérios de mascaramento, forneça as seguintes informações e clique em Adicionar.
- Expressão de consulta. Especifique a expressão de consulta que deve ser mascarada ou filtrada. Por exemplo: $. pet.details.status.
- Tipo de máscara. Especifica o tipo de mascaramento necessário. Você seleciona Mask (Máscara ) ou Filter (Filtro ). A seleção de Mask substitui o valor pelo valor fornecido (o valor padrão é ********). A seleção de Filtro remove o campo completamente.
- Valor da máscara. Aparece se o tipo de mascaramento selecionado for Máscara. Forneça um valor de máscara. Você pode adicionar vários critérios de mascaramento.
Como as propriedades Query expression e Mask Value suportam a estrutura de variáveis, você pode usar as variáveis disponíveis.
No caso da expressão de consulta, se você fornecer a sintaxe da variável, o JSONPath será aplicado à carga útil usando o valor resolvido da variável fornecida.
Por exemplo, se você fornecer uma expressão de consulta como ${request.headers.myjsonpath} e o valor da máscara correspondente como ${request.headers.var1} , e se o cabeçalho da solicitação de entrada myjsonpath estiver configurado com o valor $.cardNumber, o número do cartão derivado da carga útil será mascarado com o valor do cabeçalho em var1.
Para obter detalhes sobre as variáveis disponíveis em webMethods API Gateway consulte Estrutura de variáveis.
|
| Expressão regular. Especifica os critérios de mascaramento para expressões regulares nas mensagens de solicitação. |
|
| Critérios de mascaramento |
Clique em Adicionar critérios de mascaramento, forneça as seguintes informações e clique em Adicionar.
- Expressão de consulta. Especifique a expressão de consulta que deve ser mascarada ou filtrada. Por exemplo: [0-9]+.
- Tipo de máscara. Especifica o tipo de mascaramento necessário. Você seleciona Mask (Máscara ) ou Filter (Filtro ). A seleção de Mask substitui o valor pelo valor fornecido (o valor padrão é ********). A seleção de Filtro remove o campo completamente.
- Valor da máscara. Aparece se o tipo de mascaramento selecionado for Máscara. Forneça um valor de máscara. Você pode adicionar vários critérios de mascaramento.
Como as propriedades Query expression e Mask Value suportam a estrutura de variáveis, você pode usar as variáveis disponíveis.
No caso de expressão de consulta, se você fornecer a sintaxe da variável, a regex será aplicada à carga útil usando o valor resolvido a partir da variável fornecida.
Por exemplo, se você fornecer uma expressão de consulta como ${request.headers.myregex} e o valor da máscara correspondente como ${request.headers.var1}, a regex será aplicada usando o valor configurado no cabeçalho da solicitação myregex e o valor derivado será mascarado com o valor do cabeçalho em var1.
Para obter detalhes sobre as variáveis disponíveis em webMethods API Gateway consulte Estrutura de variáveis
|
| Aplicar à criação de log de transações |
Selecione essa opção para aplicar critérios de mascaramento para logs transacionais.
Observação: Para serviços SOAP habilitados para REST
- Use JSONPath. Para mascarar a solicitação de entrada do tipo de conteúdo application/json.
- Use o XPath da solicitação SOAP transformada. Para mascarar a solicitação de serviço nativo.
|
| Aplicar à carga útil |
Selecione essa opção para aplicar critérios de mascaramento para a carga útil da solicitação nos seguintes cenários:
- Solicitação de entrada do cliente.
- Solicitação de saída para o serviço nativo.
|