Detectores de infoType personalizados

A Proteção de Dados Sensíveis contém muitos detectores de infoType integrados, mas você também pode criar os seus. É possível personalizar o comportamento de detecção definindo seus próprios detectores de infoType personalizados, para que a Proteção de Dados Sensíveis inspecione ou desidentifique dados sensíveis que correspondem aos padrões especificados. Estes são os tipos de detectores de infoType personalizados:

  • Os detectores de dicionário personalizado regular são listas simples de palavras e frases que a Proteção de Dados Sensíveis usa para fazer correspondências. Use-os quando tiver até centenas de milhares de palavras.
  • Os detectores de dicionário personalizado grande são gerados pela Proteção de Dados Sensíveis usando listas grandes de palavras ou frases armazenadas no Cloud Storage ou no BigQuery. Use detectores de dicionário personalizado grande quando tiver uma lista grande de palavras ou frases, até dezenas de milhões.
  • Os detectores de expressão regular (regex) permitem que a Proteção de Dados Sensíveis detecte correspondências com base em um padrão de expressão regular.
  • Os detectores de rótulos de metadados permitem que a Proteção de Dados Sensíveis detecte correspondências com base na presença de metadados específicos. Há dois tipos de detectores de rótulos de metadados:
    • Os detectores de expressão de chave-valor de metadados correspondem a pares de chave-valor específicos nos metadados de conteúdo.
    • Os detectores de rótulos de arquivos correspondem a rótulos de arquivos específicos, que podem representar rótulos do Google Drive ou de confidencialidade da Microsoft.
  • Os detectores de infoType substitutos detectam a saída da transformação de desidentificação da Proteção de Dados Sensíveis CryptoReplaceFfxFpeConfig. Esse detector de infoType personalizado é usado apenas com o método content:reidentify para reverter a desidentificação usando a criptografia com preservação de formato (FPE, na sigla em inglês) no modo FFX. Por esse motivo, os substitutos não são descritos em detalhes nestes tópicos. Para mais informações sobre como e quando usar detectores de infoType personalizados substitutos, consulte Pseudonimização.

Para refinar os resultados da verificação, crie regras de inspeção.

Para saber mais sobre detectores de infoType personalizados, consulte a página conceitual InfoTypes e detectores de infoType. Para acessar exemplos que podem ser usados ou alterados de acordo com sua necessidade, consulte Exemplos de detectores de infoType personalizados. O restante deste tópico descreve como usar a Proteção de Dados Sensíveis para criar seus próprios detectores de infoType personalizados.

Onde usar detectores de infoType personalizados

Os detectores de infoType personalizados são definidos no objeto CustomInfoType. Especifique um CustomInfoType no objeto InspectConfig ao configurar o seguinte:

Visão geral da API

O objeto CustomInfoType permite criar um detector de infoType personalizado para novos conteúdos ou ajustar os resultados retornados por detectores de infoType predefinidos.

O objeto CustomInfoType é composto pelos seguintes campos, que são definidos conforme descrito:

  • "infotype": o nome do detector de infoType personalizado, contido em um objeto InfoType.
  • "likelihood": o valor Likelihood padrão para retornar a este detector de infoType personalizado. Especifique valores Likelihood alternativos em "detectionRules" que substituirão esse Likelihood básico se a descoberta atender aos critérios especificados pela regra. Se você não incluir o campo "likelihood", o detector de infoType personalizado assumirá o padrão VERY_LIKELY. Para mais informações sobre probabilidades, consulte a página de conceito Probabilidade.
  • "detectionRules": um conjunto de objetos DetectionRule a ser aplicado adicionalmente a todas as descobertas desse detector de infoType personalizado. É aqui que você especifica as regras de hotword, como objetos HotwordRule. As regras são aplicadas na ordem em que são especificadas. Esse campo não se aplica a objetos SurrogateType.

  • "sensitivityScore": o valor SensitivityScore a ser retornado para esse detector de infoType personalizado. Se você não incluir o campo "sensitivityScore", o detector de infoType personalizado será definido como VERY_LIKELY por padrão.

    As pontuações de sensibilidade são usadas em perfis de dados. Ao criar o perfil dos dados, a Proteção de Dados Sensíveis usa as pontuações de confidencialidade dos infoTypes para calcular o nível de confidencialidade.

  • Um dos seguintes campos, dependendo do tipo de detector de infoType personalizado que você está criando:

    • "dictionary": um objeto Dictionary, que contém uma lista de palavras ou frases para pesquisar.
    • "regex": um objeto Regex, que contém um único padrão que define a expressão regular.
    • "surrogateType": um objeto SurrogateType, se presente, indica que o detector de infoType personalizado é alternativo. Para mais informações sobre como usar detectores de infoType personalizados alternativos, consulte Pseudonimização.
    • "storedType": uma referência a um objeto StoredInfoType atual. Este campo é obrigatório ao criar um detector de dicionário personalizado grande. Embora seja possível criar detectores de dicionário ou de expressão regular definindo esse campo, é mais simples criá-los definindo o campo dictionary ou regex, respectivamente.
    • "metadataKeyValueExpression": um objeto MetadataKeyValueExpression que define expressões regulares para a chave e o valor a serem pesquisados nos metadados de conteúdo.
    • "fileLabelInfoType": um objeto FileLabelInfoType que define um marcador de arquivo do Google Drive ou um marcador de confidencialidade da Microsoft para pesquisa.

Próximas etapas

Saiba mais sobre a criação de infoTypes personalizados nos seguintes tópicos: