Rilevatori di infoType personalizzati

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

  • I rilevatori di dizionari personalizzati normali sono semplici elenchi di parole e frasi che Sensitive Data Protection fa corrispondere. Utilizza i rilevatori di dizionari personalizzati normali 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 dei 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 di 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 di infoType personalizzato viene utilizzato solo con il content:reidentify metodo per invertire l'anonimizzazione utilizzando la crittografia con protezione del formato (FPE) in modalità FFX. Per questo motivo, i surrogati non sono descritti in modo approfondito in questi argomenti. Per ulteriori informazioni su come e quando utilizzare i rilevatori di infoType personalizzati surrogati, consulta Pseudonimizzazione.

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

Per scoprire di più sui rilevatori di infoType personalizzati, consulta la pagina concettuale InfoTypes e rilevatori di infoType detectors. Per diversi esempi che puoi utilizzare o modificare a tuo piacimento, consulta Esempi di rilevatori di infoType personalizzati. Il resto di questo argomento descrive come utilizzare Sensitive Data Protection per creare i tuoi rilevatori di infoType personalizzati.

Dove utilizzare i rilevatori di infoType personalizzati

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

Panoramica dell'API

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

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

  • "infotype": il nome del rilevatore di infoType personalizzato, contenuto in un InfoType oggetto.
  • "likelihood": il valore predefinito Likelihood da restituire per questo rilevatore di 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 di infoType personalizzato utilizza per impostazione predefinita VERY_LIKELY. Per ulteriori informazioni sulla probabilità, consulta la pagina concettuale Probabilità.
  • "detectionRules": un insieme di DetectionRule oggetti da applicare in aggiunta a tutti i risultati di questo rilevatore di infoType personalizzato. È qui che specifichi le regole di parole chiave, come HotwordRule oggetti. Le regole vengono applicate nell'ordine in cui sono specificate. Questo campo non si applica agli oggetti SurrogateType.
  • "sensitivityScore": il SensitivityScore valore da restituire per questo rilevatore di infoType personalizzato. Se non includi il "sensitivityScore" campo, il rilevatore di infoType personalizzato utilizza per impostazione predefinita VERY_LIKELY.

    I punteggi di sensibilità vengono utilizzati nei profili dati. Quando profila i tuoi 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 di infoType personalizzato che stai creando:

    • "dictionary": un Dictionary oggetto, che contiene un elenco di parole o frasi da cercare.
    • "regex": un Regex oggetto, che contiene un singolo pattern che definisce l'espressione regolare.
    • "surrogateType": un oggetto SurrogateType, se presente, indica che il rilevatore di infoType personalizzato è un surrogato. Per ulteriori informazioni su come utilizzare i rilevatori di infoType personalizzati surrogati, consulta Pseudonimizzazione.
    • "storedType": un riferimento a un oggetto esistente StoredInfoType. Questo campo è obbligatorio quando crei un rilevatore di dizionari personalizzato di grandi dimensioni. Sebbene tu possa creare rilevatori di dizionari normali 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 che definisce un'etichetta di file di Google Drive o un'etichetta di sensibilità Microsoft da cercare.FileLabelInfoType

Passaggi successivi

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