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 ilcontent:reidentifymetodo 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:
- Ispezione utilizzando
projects.content.inspect. - Job di ispezione all'interno di
InspectJobConfig. - Modelli di ispezione all'interno
InspectTemplate. - Anonimizzazione utilizzando
projects.content.deidentify. - Modelli di anonimizzazione all'interno
DeidentifyTemplate. - Reidentificazione dei contenuti anonimizzati con FPE in modalità FFX
utilizzando
projects.content.reidentify. Questo scenario è specifico per i rilevatori di infoType personalizzati surrogati.
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 unInfoTypeoggetto."likelihood": il valore predefinitoLikelihoodda restituire per questo rilevatore di infoType personalizzato. Puoi specificare valoriLikelihoodalternativi in"detectionRules"che sostituiranno questoLikelihooddi base se il risultato soddisfa i criteri specificati dalla regola. Se non includi il campo"likelihood", il rilevatore di infoType personalizzato utilizza per impostazione predefinitaVERY_LIKELY. Per ulteriori informazioni sulla probabilità, consulta la pagina concettuale Probabilità."detectionRules": un insieme diDetectionRuleoggetti da applicare in aggiunta a tutti i risultati di questo rilevatore di infoType personalizzato. È qui che specifichi le regole di parole chiave, comeHotwordRuleoggetti. Le regole vengono applicate nell'ordine in cui sono specificate. Questo campo non si applica agli oggettiSurrogateType."sensitivityScore": ilSensitivityScorevalore da restituire per questo rilevatore di infoType personalizzato. Se non includi il"sensitivityScore"campo, il rilevatore di infoType personalizzato utilizza per impostazione predefinitaVERY_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": unDictionaryoggetto, che contiene un elenco di parole o frasi da cercare."regex": unRegexoggetto, che contiene un singolo pattern che definisce l'espressione regolare."surrogateType": un oggettoSurrogateType, 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 esistenteStoredInfoType. 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 campodictionaryo il camporegex."metadataKeyValueExpression": un oggettoMetadataKeyValueExpressionche 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:
- Creare un rilevatore di dizionari personalizzato normale: scopri come creare un rilevatore di infoType personalizzato per trovare le corrispondenze in un elenco di parole e frasi.
- Creare un rilevatore di dizionari personalizzato di grandi dimensioni: scopri come trovare le corrispondenze in un elenco molto lungo di parole e frasi. I rilevatori di infoType personalizzati archiviati possono trovare corrispondenze fino a decine di milioni di parole.
- Creare un rilevatore regex personalizzato: Scopri come creare un rilevatore di infoType personalizzato per trovare le corrispondenze in un' espressione regolare.
- Creare un rilevatore di etichette dei metadati personalizzato: scopri come creare un rilevatore di infoType personalizzato per trovare le corrispondenze nei metadati dei contenuti.
- Modificare i rilevatori di infoType per perfezionare i risultati della scansione : scopri come creare modificatori per i rilevatori di infoType integrati e personalizzati che possono perfezionare i risultati della scansione.
- Personalizzare la probabilità di corrispondenza: scopri come utilizzare le regole di rilevamento e le parole chiave per personalizzare i valori di probabilità assegnati alle corrispondenze dei rilevatori personalizzati.
- Esempi di rilevatori di infoType personalizzati: diverse definizioni di rilevatori di infoType personalizzati in formato JSON di esempio che puoi utilizzare o modificare a tuo piacimento.