Détecteurs d'infoTypes personnalisés

Sensitive Data Protection comporte de nombreux détecteurs d'infoTypes intégrés, mais vous pouvez également créer les vôtres. Vous pouvez personnaliser le comportement de détection en définissant vos propres détecteurs d'infoTypes personnalisés. De cette façon, Sensitive Data Protection inspecte ou anonymise les données sensibles correspondant aux modèles que vous spécifiez. Voici les types de détecteurs d'infoTypes personnalisés :

  • Les détecteurs de dictionnaires personnalisés standards sont de simples listes de mots et d'expressions avec lesquels Sensitive Data Protection recherche des correspondances. Utilisez-les lorsque vous disposez tout au plus de quelques centaines de milliers de mots.
  • Les détecteurs de dictionnaires personnalisés de grande taille sont générés par Sensitive Data Protection à l'aide de listes volumineuses de mots ou d'expressions stockées dans Cloud Storage ou BigQuery. Utilisez-les lorsque vous possédez une longue liste de mots ou d'expressions, pouvant atteindre plusieurs dizaines de millions d'entrées.
  • Les détecteurs d'expressions régulières (regex) permettent à Sensitive Data Protection de détecter les correspondances basées sur un motif d'expression régulière.
  • Les détecteurs d'étiquettes de métadonnées permettent à Sensitive Data Protection de détecter les correspondances en fonction de la présence de métadonnées spécifiques. Il existe deux types de détecteurs de libellés de métadonnées :
    • Les détecteurs d'expressions clé-valeur de métadonnées correspondent à des paires clé-valeur spécifiques dans les métadonnées de contenu.
    • Les détecteurs de libellés de fichier correspondent à des libellés de fichier spécifiques, qui peuvent représenter des libellés Google Drive ou des libellés de sensibilité Microsoft.
  • Les détecteurs d'InfoTypes de substitut détectent le résultat d'une transformation d'anonymisation de Sensitive Data ProtectionCryptoReplaceFfxFpeConfig. Ce détecteur d'infoType personnalisé ne s'utilise qu'avec la méthode content:reidentify pour inverser l'anonymisation à l'aide du chiffrement préservant le format (FPE, Format-Preserving Encryption) en mode FFX. Pour cette raison, les substituts ne sont pas décrits en détail dans ces articles. Pour savoir quand et comment utiliser les détecteurs d'infoTypes personnalisés de type substituts, consultez Pseudonymisation.

Pour affiner les résultats d'analyse, vous pouvez créer des règles d'inspection.

Pour en savoir plus sur les détecteurs d'infoTypes personnalisés, consultez la page de présentation des concepts liés aux InfoTypes et détecteurs d'InfoTypes. Pour obtenir des exemples que vous pouvez utiliser ou modifier à votre guise, consultez la page Exemples de détecteurs d'infoTypes personnalisés. La suite de cette page explique comment utiliser Sensitive Data Protection pour créer vos propres détecteurs d'infoTypes personnalisés.

Où utiliser les détecteurs d'infoTypes personnalisés

Les détecteurs d'infoTypes personnalisés sont définis dans l'objet CustomInfoType. Vous spécifiez un infoType CustomInfoType dans l'objet InspectConfig lors de la configuration des éléments suivants :

Présentation de l'API

L'objet CustomInfoType vous permet de créer un détecteur d'infoType personnalisé pour analyser un nouveau contenu ou affiner les résultats renvoyés par les détecteurs d'infoTypes prédéfinis.

L'objet CustomInfoType comprend les champs ci-dessous définis comme suit :

  • "infotype" : nom du détecteur d'infoType personnalisé, contenu dans un objet InfoType.
  • "likelihood" : valeur de probabilité par défaut (Likelihood) à renvoyer pour ce détecteur d'infoType personnalisé. Vous pouvez spécifier d'autres valeurs Likelihood dans les règles "detectionRules" qui remplaceront la valeur Likelihood de base si le résultat répond aux critères spécifiés par la règle. Si vous omettez le champ "likelihood", le détecteur d'infoType personnalisé est définie sur VERY_LIKELY par défaut. Pour en savoir plus sur la probabilité, consultez la page consacrée au concept de probabilité.
  • "detectionRules" : ensemble d'objets DetectionRule supplémentaires à appliquer à tous les résultats correspondant à ce détecteur d'infoType personnalisé. Il s'agit du champ dans lequel vous spécifiez des règles relatives aux mots clés, sous forme d'objets HotwordRule. Les règles sont appliquées dans l'ordre dans lequel elles sont spécifiées. Ce champ ne s'applique pas aux objets de type SurrogateType.

  • "sensitivityScore" : valeur SensitivityScore à renvoyer pour ce détecteur d'infoType personnalisé. Si vous n'incluez pas le champ "sensitivityScore", le détecteur d'infoType personnalisé prend par défaut la valeur VERY_LIKELY.

    Les scores de sensibilité sont utilisés dans les profils de données. Lorsque vous profilez vos données, Sensitive Data Protection utilise les scores de sensibilité des infoTypes pour calculer le niveau de sensibilité.

  • L'un des champs suivants, selon le type de détecteur d'infoTypes personnalisé que vous créez :

    • "dictionary" : objet Dictionary contenant une liste de mots ou d'expressions à rechercher.
    • "regex" : objet Regex contenant un seul modèle définissant l'expression régulière.
    • "surrogateType" : objet SurrogateType qui, si il est présent, indique que le détecteur d'infoType personnalisé est un substitut. Pour plus d'informations sur l'utilisation des détecteurs d'infoTypes personnalisés de type substituts, consultez la page Pseudonymisation.
    • "storedType" : référence à un objet StoredInfoType existant. Ce champ est obligatoire lorsque vous créez un détecteur de dictionnaire personnalisé de grande taille. Bien que vous puissiez créer des détecteurs de dictionnaire standards ou des détecteurs d'expressions régulières en définissant ce champ, il est plus simple de les créer en définissant respectivement les champs dictionary ou regex.
    • "metadataKeyValueExpression" : objet MetadataKeyValueExpression qui définit les expressions régulières pour la clé et la valeur à rechercher dans les métadonnées de contenu.
    • "fileLabelInfoType" : objet FileLabelInfoType qui définit un libellé de fichier Google Drive ou un libellé de confidentialité Microsoft à rechercher.

Étapes suivantes

Vous pouvez en apprendre davantage sur la création d'infoTypes personnalisés dans les articles suivants :