Rilevatori di infoType personalizzati

Sensitive Data Protection contiene molti rilevatori di infoType integrati, ma puoi anche crearne di tuoi. Puoi personalizzare il comportamento di rilevamento definendo i tuoi rilevatori infoType personalizzati, in modo che Sensitive Data Protection ispezioni o anonimizzi i dati sensibili che corrispondono ai pattern specificati. Di seguito sono riportati i tipi di rilevatori infoType personalizzati:

  • I rilevatori di dizionari personalizzati regolari sono semplici elenchi di parole e frasi con cui Sensitive Data Protection esegue la corrispondenza. Utilizza i rilevatori di dizionari personalizzati standard quando hai al massimo diverse centinaia di migliaia di parole.
  • I rilevatori di dizionari personalizzati di grandi dimensioni vengono generati da Sensitive Data Protection utilizzando elenchi di parole o frasi di grandi dimensioni archiviati in Cloud Storage o BigQuery. Utilizza i rilevatori di dizionari personalizzati di grandi dimensioni quando hai un elenco di parole o frasi di grandi dimensioni, fino a decine di milioni.
  • I rilevatori di espressioni regolari (regex) consentono a Sensitive Data Protection di rilevare le corrispondenze in base a un pattern di espressione regolare.
  • I rilevatori di etichette dei metadati consentono a Sensitive Data Protection di rilevare le corrispondenze in base alla presenza di metadati specifici. Esistono due tipi di rilevatori di etichette di metadati:
    • I rilevatori di espressioni chiave-valore dei metadati corrispondono a coppie chiave-valore specifiche nei metadati dei contenuti.
    • I rilevatori di etichette dei file corrispondono a etichette dei file specifiche, che possono rappresentare etichette di Google Drive o etichette di sensibilità Microsoft.
  • I rilevatori di infoType surrogati rilevano l'output della trasformazione di anonimizzazione di Sensitive Data Protection CryptoReplaceFfxFpeConfig. Questo rilevatore infoType personalizzato viene utilizzato solo con il metodo content:reidentify per invertire l'anonimizzazione utilizzando la crittografia con protezione del formato (FPE) in modalità FFX. Per questo motivo, i surrogati non sono descritti in dettaglio in questi argomenti. Per ulteriori informazioni su come e quando utilizzare i rilevatori infoType personalizzati surrogati, consulta Assegnazione di pseudonimi.

Per perfezionare i risultati della scansione, puoi creare regole di ispezione.

Per scoprire di più sui rilevatori infoType personalizzati, consulta la pagina dei concetti InfoType e rilevatori infoType. Per diversi esempi che puoi utilizzare o modificare come preferisci, consulta Esempi di rilevatori infoType personalizzati. Il resto di questo argomento descrive come utilizzare Sensitive Data Protection per creare i tuoi rilevatori infoType personalizzati.

Dove utilizzare i rilevatori infoType personalizzati

I rilevatori infoType personalizzati sono definiti nell'oggetto CustomInfoType. Puoi specificare un CustomInfoType nell'oggetto InspectConfig quando configuri quanto segue:

Panoramica dell'API

L'oggetto CustomInfoType consente di creare un rilevatore infoType personalizzato per nuovi contenuti o di perfezionare i risultati restituiti dai rilevatori infoType predefiniti.

L'oggetto CustomInfoType è composto dai seguenti campi, impostati come descritto:

  • "infotype": il nome del rilevatore infoType personalizzato, contenuto in un oggetto InfoType.
  • "likelihood": il valore Likelihood predefinito da restituire per questo rilevatore infoType personalizzato. Puoi specificare valori Likelihood alternativi in "detectionRules" che sostituiranno questo Likelihood di base se il risultato soddisfa i criteri specificati dalla regola. Se non includi il campo "likelihood", il rilevatore infoType personalizzato viene impostato su VERY_LIKELY per impostazione predefinita. Per saperne di più sulla probabilità, consulta la pagina dei concetti relativi alla probabilità.
  • "detectionRules": un insieme di oggetti DetectionRule da applicare anche a tutti i risultati di questo rilevatore infoType personalizzato. Qui puoi specificare le regole hotword come oggetti HotwordRule. Le regole vengono applicate nell'ordine in cui sono specificate. Questo campo non si applica agli oggetti SurrogateType.

  • "sensitivityScore": il valore SensitivityScore da restituire per questo rilevatore infoType personalizzato. Se non includi il campo "sensitivityScore", il rilevatore infoType personalizzato viene impostato su VERY_LIKELY per impostazione predefinita.

    I punteggi di sensibilità vengono utilizzati nei profili dati. Quando esegue la profilazione dei dati, Sensitive Data Protection utilizza i punteggi di sensibilità degli infoType per calcolare il livello di sensibilità.

  • Uno dei seguenti campi, a seconda del tipo di rilevatore infoType personalizzato che stai creando:

    • "dictionary": un oggetto Dictionary, che contiene un elenco di parole o frasi da cercare.
    • "regex": un oggetto Regex, che contiene un singolo pattern che definisce l'espressione regolare.
    • "surrogateType": un oggetto SurrogateType, se presente, indica che il rilevatore infoType personalizzato è un surrogato. Per saperne di più su come utilizzare i rilevatori di infoType personalizzati surrogati, consulta Pseudonimizzazione.
    • "storedType": un riferimento a un oggetto StoredInfoType esistente. Questo campo è obbligatorio quando crei un rilevatore di dizionari personalizzati di grandi dimensioni. Sebbene sia possibile creare rilevatori di dizionari regolari o rilevatori di espressioni regolari definendo questo campo, è più semplice crearli definendo rispettivamente il campo dictionary o il campo regex.
    • "metadataKeyValueExpression": un oggetto MetadataKeyValueExpression che definisce le espressioni regolari per la chiave e il valore da cercare nei metadati dei contenuti.
    • "fileLabelInfoType": un oggetto FileLabelInfoType che definisce un'etichetta file di Google Drive o un'etichetta di sensibilità Microsoft da cercare.

Passaggi successivi

Scopri di più sulla creazione di infoType personalizzati nei seguenti argomenti: