O Cloud Data Loss Prevention (DLP) pode editar texto confidencial em uma imagem. Usando detectores de infoType e oCloud Vision, o Cloud DLP inspeciona uma imagem codificada em base64 para texto, detecta dados confidenciais no texto e retorna uma imagem codificada em base64 com quaisquer dados confidenciais correspondentes obscurecidos por um retângulo opaco.
Por exemplo, considere estas imagens "antes" e "depois". A imagem original é um exemplo de um arquivo de imagem típico gerado a partir de uma digitalização de um documento em papel. Neste exemplo, o Cloud DLP foi configurado para editar números de CPF, endereços de e-mail e números de telefone usando retângulos de cores diferentes, dependendo do conteúdo.

- Imagem digitalizada antes da edição da imagem
- Imagem digitalizada após a edição da imagem
Como editar todos os infoTypes padrão de uma imagem
Para editar dados confidenciais de uma imagem, envie uma imagem codificada em base64 para o método image.redact
da API DLP.
A menos que você especifique tipos específicos de informação (infoTypes) para fazer pesquisas, o Cloud DLP pesquisa os infoTypes mais comuns.
Para editar os infoTypes padrão de uma imagem:
- Codifique a imagem como base64.
- Envie uma solicitação ao método
image.redact
da API DLP. A solicitação precisa conter apenas a imagem codificada em base64, se você quiser editar os infoTypes padrão.
Por exemplo, veja a seguinte imagem: Esta imagem é um exemplo de um arquivo de imagem típico gerado a partir de uma digitalização de um documento em papel.

Para editar os infoTypes padrão desta imagem, envie a seguinte solicitação para o método image.redact
da API DLP:
Protocolo
{ "byteItem": { "data": "[BASE64-ENCODED-IMAGE]", "type": "IMAGE_JPEG" } }
O Cloud DLP retorna o seguinte:
{ "redactedImage": "[BASE64-ENCODED-IMAGE]" }
Java
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
Depois de decodificar a imagem codificada em base64, ela aparece da seguinte maneira:

Além de mascarar o número de CPF escrito à mão, o endereço de e-mail e o número de telefone, o Cloud DLP também editou o ano. Supondo que esse não seja o comportamento ideal, o próximo exemplo mostra como editar apenas determinados infoTypes.
Como editar os infoTypes específicos de uma imagem
Se você quiser editar apenas alguns dados confidenciais de uma imagem, especifique os infoTypes integrados correspondentes.
Para editar os infoTypes específicos de uma imagem:
- Codifique a imagem como base64.
- Envie uma solicitação ao método
image.redact
da API DLP. A solicitação precisa incluir:- A imagem codificada em base64.
- Um ou mais detectores de infoType.
Considere a imagem original da seção anterior. Para editar apenas números de CPF, endereços de e-mail e números de telefone, envie o seguinte JSON para a método image.redact
da API DLP:
Protocolo
{ "byteItem": { "data": "[BASE64-ENCODED-IMAGE]", "type": "IMAGE_JPEG" }, "imageRedactionConfigs": [ { "infoType": { "name": "US_SOCIAL_SECURITY_NUMBER" } }, { "infoType": { "name": "EMAIL_ADDRESS" } }, { "infoType": { "name": "PHONE_NUMBER" } } ] }
O Cloud DLP retorna o seguinte:
{ "redactedImage": "[BASE64-ENCODED-IMAGE]" }
Java
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
Depois de decodificar a imagem codificada em base64, ela aparece da seguinte maneira:

É possível codificar por cores as informações editadas por infoType quando quiser saber rapidamente o que foi editado. Consulte a seção a seguir para mais informações.
Como editar infoTypes de uma imagem usando a codificação por cores
Para codificar por cores as informações editadas por infoType, pareie os detectores de infoType com valores de espaço de cor RGB.
Para codificar por cores os infoTypes editados em uma imagem:
- Codifique a imagem como base64.
- Envie uma solicitação ao método
image.redact
da API DLP. A solicitação precisa incluir:- A imagem codificada em base64.
- Um ou mais detectores de infoType, cada um com uma cor atribuída usando valores de espaço de cor RGB.
Considere a imagem original da primeira seção. Para editar números de CPF com uma caixa roxa, endereços de e-mail com uma caixa verde e números de telefone com uma caixa laranja, envie o seguinte JSON para o método image.redact
da API DLP:
Protocolo
{ "byteItem": { "data": "[BASE64-ENCODED-IMAGE]", "type": "IMAGE_JPEG" }, "imageRedactionConfigs": [ { "infoType": { "name": "US_SOCIAL_SECURITY_NUMBER" }, "redactionColor": { "red": 0.3, "green": 0.1, "blue": 0.6 } }, { "infoType": { "name": "EMAIL_ADDRESS" }, "redactionColor": { "red": 0.5, "blue": 0.5, "green": 1 } }, { "infoType": { "name": "PHONE_NUMBER" }, "redactionColor": { "red": 1, "blue": 0, "green": 0.6 } } ] }
O Cloud DLP retorna o seguinte:
{ "redactedImage": "[BASE64-ENCODED-IMAGE]" }
Java
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
Depois de decodificar a imagem codificada em base64, ela aparece da seguinte maneira:

Como editar todo o texto de uma imagem
O Cloud DLP também contém uma opção para editar todo o texto detectado em uma imagem.
Para editar todo o texto de uma imagem:
- Codifique a imagem como base64.
- Envie uma solicitação ao método
image.redact
da API DLP. A solicitação precisa conter:- A imagem codificada em base64.
- A opção
redactAllText
definida comotrue
.
Considere a imagem original da primeira seção. Para editar todo o texto, envie o seguinte JSON para o método image.redact
da API DLP:
Protocolo
{ "byteItem": { "data": "[BASE64-ENCODED-IMAGE]", "type": "IMAGE_JPEG" }, "imageRedactionConfigs": [ { "redactAllText": true } ] }
O Cloud DLP retorna o seguinte:
{ "redactedImage": "[BASE64-ENCODED-IMAGE]" }
Python
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
Java
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
A API retorna as mesmas imagens que você forneceu a ela, exceto os textos identificados como contendo informações confidenciais, de acordo com os critérios que foram editados.
Depois de decodificar a imagem codificada em base64, ela aparece da seguinte maneira:

Exemplos de código
A amostra de código a seguir demonstra em várias linguagens como usar o Cloud DLP para editar texto confidencial em uma imagem.
Node.js
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
Python
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
Go
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
PHP
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud DLP, consulte Bibliotecas de cliente do Cloud DLP.
Teste
Você pode testar cada um dos exemplos nesta página ou fazer experiências com suas próprias imagens nas APIs Explorer na página de referência para image.redact
:
A seguir
- Saiba mais sobre inspeção e edição de imagens.
- Saiba como inspecionar imagens em busca de dados confidenciais.