Creare una norma relativa ai contenuti

Una policy relativa ai contenuti è una risorsa riutilizzabile che contiene una configurazione di ispezione e un insieme di regole. Ogni regola specifica le condizioni sulla base dei risultati dell'ispezione. Se le condizioni sono soddisfatte, la policy restituisce un esito ALLOW o BLOCK.

A differenza di altre operazioni di ispezione di Sensitive Data Protection, come una chiamata content.inspect o un job di ispezione, un criterio dei contenuti non restituisce un elenco di risultati.

Vantaggi e casi d'uso

Le policy relative ai contenuti ti consentono di agire immediatamente sui risultati dell'ispezione producendo un verdetto anziché un elenco di risultati. Esempi di casi d'uso includono:

  • Blocca automaticamente le risposte o i caricamenti del chatbot che contengono informazioni sensibili, come numeri di carte di credito o informazioni che consentono l'identificazione personale (PII).
  • Integra le policy relative ai contenuti di Sensitive Data Protection con Gemini Enterprise per impedire l'utilizzo di contenuti che contengono dati sensibili.
  • Ricevi verdetti sincroni e immediati sui contenuti per applicare le norme sui dati dell'organizzazione.
  • Ottieni un verdetto sull'opportunità di consentire determinati tipi di dati in un set di dati di addestramento del modello di AI.

Prima di iniziare

  1. Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. Installa Google Cloud CLI.

  3. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  4. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  5. Abilita l'API Data Loss Prevention:

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli. 

    gcloud services enable dlp.googleapis.com

  6. Concedi ruoli al tuo account utente. Esegui il seguente comando una volta per ciascuno dei seguenti ruoli IAM: roles/dlp.user 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo ID progetto.
    • USER_IDENTIFIER: l'identificatore del tuo account utente . Ad esempio: myemail@example.com.
    • ROLE: il ruolo IAM che concedi al tuo account utente.

  7. Installa Google Cloud CLI.

  8. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  9. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  10. Abilita l'API Data Loss Prevention:

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli. 

    gcloud services enable dlp.googleapis.com

  11. Concedi ruoli al tuo account utente. Esegui il seguente comando una volta per ciascuno dei seguenti ruoli IAM: roles/dlp.user 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo ID progetto.
    • USER_IDENTIFIER: l'identificatore del tuo account utente . Ad esempio: myemail@example.com.
    • ROLE: il ruolo IAM che concedi al tuo account utente.
    12.

Creare una norma relativa ai contenuti

Console

  1. Nella console Google Cloud , vai alla pagina Policy sui contenuti di Sensitive Data Protection.

    Vai alle norme relative ai contenuti

  2. Seleziona il progetto.

  3. Fai clic su Crea.

  4. In Informazioni di base:

    1. Inserisci un nome per la policy relativa ai contenuti.
    2. Facoltativo. Inserisci un ID policy relativa ai contenuti univoco. Se non inserisci un ID norma sui contenuti, Sensitive Data Protection ne imposta uno automaticamente.
    3. Seleziona la regione o la multi-regione in cui vuoi archiviare le norme sui contenuti.
    4. Fai clic su Continua.

  5. In Configurazione di ispezione:

    1. Seleziona gli infoType integrati o personalizzati da rilevare. Per saperne di più, consulta Gestire gli infoType tramite la consoleGoogle Cloud .

      Per configurare il rilevamento utilizzando un modello di ispezione esistente, fai clic su Importa da un modello e inserisci il nome risorsa completo del modello.

    2. Facoltativo. Aggiungi un set di regole di ispezione.

      Fai clic per mostrare le istruzioni

      I set di regole di ispezione ti consentono di personalizzare i rilevatori infoType integrati e personalizzati utilizzando regole di contesto. I tipi di regole di ispezione sono:

      Per aggiungere un nuovo insieme di regole, specifica prima uno o più rilevatori di infoType integrati o personalizzati nella sezione InfoTypes. Seleziona tutti i rilevatori di infoType modificati dai tuoi set di regole (gli infoType di destinazione) o utilizzati per la valutazione (gli infoType di contesto). Poi, procedi nel seguente modo:

      1. Fai clic su Aggiungi un insieme di regole.
      2. Nel campo Scegli gli infoType di destinazione, seleziona gli infoType che il ruleset modifica se le regole vengono soddisfatte.
      3. Fai clic su Aggiungi una regola per aprire un menu con opzioni, tra cui Regola hotword, Regola di esclusione e Regola di aggiustamento.

      Per creare una regola hotword, seleziona Regola hotword. Quindi:

      1. Nel campo Hotword, inserisci un'espressione regolare che Sensitive Data Protection cerca.
      2. Nel menu Prossimità hotword, seleziona se l'hotword inserita si trova prima o dopo l'infoType scelto.
      3. In Distanza tra hotword e infoType, inserisci il numero approssimativo di caratteri tra l'hotword e l'infoType scelto.
      4. In Aggiustamento del livello di confidenza, seleziona se assegnare alle corrispondenze un livello di probabilità fisso o se aumentare o diminuire il livello di probabilità predefinito di un determinato importo.

      Per creare una regola di esclusione, seleziona Regola di esclusione e il tipo di regola di esclusione da creare, ad esempio Espressione regolare. Quindi:

      1. A seconda del tipo di regola di esclusione selezionato, inserisci l'espressione regolare, la frase, la hotword o l'infoType contestuale che deve essere trovato per l'applicazione della regola.
      2. A seconda del tipo di regola di esclusione selezionato, imposta il tipo di corrispondenza o il tipo di contenimento dell'immagine:
        • Se hai selezionato una regola di esclusione basata sul testo, scegli uno dei seguenti tipi di corrispondenza:
          • Corrispondenza completa: il risultato deve corrispondere completamente al testo o all'infoType di contesto che hai fornito.
          • Corrispondenza parziale: una sottostringa del risultato deve corrispondere al testo o all'infoType di contesto che hai fornito.
          • Corrispondenza inversa: il risultato non deve corrispondere al testo o all'infoType di contesto che hai fornito.
        • Se hai selezionato una regola di esclusione basata sulle immagini, seleziona la relazione spaziale richiesta tra gli infoType di destinazione e di contesto. Ad esempio, se selezioni Contiene, il risultato del contesto deve contenere il risultato di destinazione affinché la regola venga applicata.

      Per creare una regola di aggiustamento, seleziona Regola di aggiustamento e il tipo di regola di aggiustamento, ad esempio Aggiusta in base ai risultati delle immagini. Quindi:

      1. Nel campo InfoType di contesto, seleziona i rilevatori di infoType che forniscono il contesto per il risultato di destinazione. Sensitive Data Protection utilizza gli infoType contestuali per valutare se deve modificare l'infoType di destinazione.
      2. Nel campo Probabilità minima, seleziona il livello di probabilità più basso che gli infoType contestuali possono avere e che comunque attivano la regola di aggiustamento. Se il valore di probabilità di qualsiasi risultato del contesto rilevato è inferiore a questo valore, Sensitive Data Protection non modifica la probabilità del risultato di destinazione.
      3. Per i risultati delle immagini, nel campo Tipo di contenimento dell'immagine, seleziona la relazione spaziale richiesta tra i tipi di informazioni di destinazione e di contesto. Ad esempio, se selezioni Contiene, il risultato del contesto deve contenere il risultato di destinazione affinché la regola venga applicata.
      4. Nel campo Probabilità, seleziona il nuovo livello di probabilità da assegnare al risultato del target.

      Puoi aggiungere altri set di regole per perfezionare ulteriormente i risultati della scansione.

    3. Facoltativo. Imposta la soglia di affidabilità per i risultati da rilevare. Per saperne di più, vedi Probabilità di corrispondenza.

    4. Fai clic su Continua.

  6. In Regole dei criteri, aggiungi regole dei criteri per specificare il verdetto (Consenti o Blocca) restituito da Sensitive Data Protection quando rileva un infoType specificato nella configurazione dell'ispezione. Puoi aggiungere una singola regola dei criteri per restituire lo stesso verdetto per qualsiasi infoType oppure aggiungere più regole dei criteri per restituire verdetti diversi per infoType diversi. Devi impostare una condizione per ogni regola dei criteri che aggiungi.

    Per aggiungere una regola dei criteri:

    1. Fai clic su Aggiungi regola di policy.
    2. Seleziona un verdetto da assegnare a un risultato di infoType: Consenti o Blocca.
    3. Fai clic su Aggiungi condizione. A seconda che tu voglia impostare verdetti diversi per infoType diversi, imposta Tipo di condizione su Qualsiasi infoType o InfoType specifici.
    4. Se hai selezionato InfoType specifici, inserisci gli infoType che devono essere rilevati affinché Sensitive Data Protection restituisca il verdetto che hai selezionato.
    5. Se necessario, aggiungi altre regole dei criteri e le relative condizioni.
    6. Fai clic su Continua.

  7. Facoltativo. In Azioni predefinite, specifica i verdetti da applicare nelle seguenti situazioni:

    • Un verdetto da assegnare ai file non supportati. Per ulteriori informazioni, vedi Tipi di file supportati e modalità di scansione.
    • Un verdetto da assegnare ai file supportati troppo grandi per essere analizzati.
    • Un verdetto da assegnare ai file che non possono essere analizzati, ad esempio file danneggiati o criptati.
    • Un verdetto da assegnare se nessuna delle regole corrisponde ai contenuti scansionati.

    Fai clic su Continua.

  8. Facoltativo. In Configurazione logging, attiva il logging per registrare i verdetti emessi dalle norme relative ai contenuti per i dati che analizzi. Segui questi passaggi:

    1. Seleziona Registra l'esecuzione della policy in BigQuery.
    2. Inserisci i dettagli di una tabella BigQuery esistente in cui Sensitive Data Protection deve registrare i risultati.

  9. Fai clic su Crea.

REST

Per creare una policy sui contenuti, invia una richiesta POST al metodo projects.locations.contentPolicies.create. La richiesta definisce un oggetto content_policy che contiene la configurazione di ispezione e le regole che determinano il verdetto in base ai risultati.

L'oggetto content_policy ha le seguenti proprietà:

{
  "contentPolicy": {
    "displayName": "DISPLAY_NAME",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "INFOTYPE_DETECTOR"
        }
      ],
      "ruleSet": "LIST_OF_RULES"
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "INFOTYPE_CONDITION_VERDICT"
        }
      }
    ],
    "unsupportedFileType": {
      "returnVerdict": "UNSUPPORTED_FILE_TYPE_VERDICT"
    },
    "inputTooLarge": {
      "returnVerdict": "INPUT_TOO_LARGE_VERDICT"
    },
    "failedToScanSupportedFileType": {
      "returnVerdict": "FAILED_TO_SCAN_VERDICT"
    },
    "defaultAction": {
      "returnVerdict": "DEFAULT_ACTION_VERDICT"
    }
  },
  "contentPolicyId": "CONTENT_POLICY_ID"
}

Sostituisci quanto segue:

  • DISPLAY_NAME: (Facoltativo) Un nome leggibile per le norme relative ai contenuti.
  • INFOTYPE_DETECTOR: un infoType integrato o personalizzato.
  • LIST_OF_RULES: (Facoltativo) Un elenco di regole di ispezione come definito in Modifica dei rilevatori infoType per perfezionare i risultati della scansione. Questo codice è troncato per brevità. Per un esempio di definizione di un insieme di regole all'interno di una norma relativa ai contenuti, vedi Esempio esteso.
  • INFOTYPE_CONDITION_VERDICT: un verdetto da assegnare a un risultato di un infoType: ALLOW o BLOCK.
  • UNSUPPORTED_FILE_TYPE_VERDICT: (Facoltativo) Un verdetto da assegnare ai file non supportati: ALLOW o BLOCK. Per ulteriori informazioni, vedi Tipi di file supportati e modalità di scansione.
  • INPUT_TOO_LARGE_VERDICT: (Facoltativo) Un verdetto da assegnare ai file supportati troppo grandi per essere scansionati: ALLOW o BLOCK.
  • FAILED_TO_SCAN_VERDICT: (Facoltativo) Un verdetto da assegnare ai file che non possono essere analizzati, ad esempio file danneggiati o criptati: ALLOW o BLOCK.
  • DEFAULT_ACTION_VERDICT: (Facoltativo) Un esito da assegnare se nessuna delle regole corrisponde ai contenuti scansionati: ALLOW o BLOCK.
  • CONTENT_POLICY_ID: un ID univoco per la policy relativa ai contenuti.

Visualizzare i dettagli di una policy relativa ai contenuti

Console

  1. Nella console Google Cloud , vai alla pagina Policy sui contenuti di Sensitive Data Protection.

    Vai alle norme relative ai contenuti

  2. Seleziona il progetto.

  3. Fai clic sul nome della risorsa di una norma relativa ai contenuti da visualizzare.

  4. Nella scheda Dettagli, visualizza i dettagli sulle norme relative ai contenuti.

REST

Per ottenere una policy dei contenuti, invia una richiesta GET al metodo projects.locations.contentPolicies.get.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGION: una regione in cui è disponibile un endpoint regionale per Sensitive Data Protection, ad esempio us-west2. Per un elenco completo delle regioni, consulta Località di Sensitive Data Protection.
  • PROJECT_ID: il tuo ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come example-project.
  • CONTENT_POLICY_ID: l'ID della policy dei contenuti per cui recuperare i dettagli.

Metodo HTTP e URL: 

GET https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies/CONTENT_POLICY_ID

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "LIKELY",
    "limits": {}
  }
}

Aggiornare una policy sui contenuti

Console

  1. Nella console Google Cloud , vai alla pagina Policy sui contenuti di Sensitive Data Protection.

    Vai alle norme relative ai contenuti

  2. Seleziona il progetto.

  3. Fai clic sul nome della risorsa di una norma relativa ai contenuti da modificare.

  4. Fai clic su Modifica.

  5. Modifica i dettagli della policy relativa ai contenuti.

REST

Per aggiornare una policy dei contenuti, invia una richiesta PATCH al metodo projects.locations.contentPolicies.update. La richiesta definisce l'oggetto content_policy aggiornato.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGION: una regione in cui è disponibile un endpoint regionale per Sensitive Data Protection, ad esempio us-west2. Per un elenco completo delle regioni, consulta Località di Sensitive Data Protection.
  • PROJECT_ID: il tuo ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come example-project.
  • CONTENT_POLICY_ID: l'ID della policy dei contenuti da aggiornare.

Metodo HTTP e URL: 

PATCH https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies/CONTENT_POLICY_ID

Corpo JSON della richiesta: 

{
  "contentPolicy": {
    "displayName": "displayName",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "CREDIT_CARD_NUMBER"
        }
      ],
      "minLikelihood": "LIKELY"
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "BLOCK"
        }
      }
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "LIKELY",
    "limits": {}
  }
}

Esempi REST

Gli esempi REST riportati di seguito mostrano come creare una policy dei contenuti utilizzando l'API REST.

Esempio semplice

L'esempio seguente crea una policy che identifica i risultati CREDIT_CARD_NUMBER con una probabilità di POSSIBLE o superiore. Se viene trovato un numero di carta di credito, Sensitive Data Protection restituisce un verdetto BLOCK.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGION: una regione in cui è disponibile un endpoint regionale per Sensitive Data Protection, ad esempio us-west2. Per un elenco completo delle regioni, consulta Località di Sensitive Data Protection.
  • PROJECT_ID: il tuo ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come example-project.

Metodo HTTP e URL: 

POST https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies

Corpo JSON della richiesta: 

{
  "contentPolicy": {
    "displayName": "displayName",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "CREDIT_CARD_NUMBER"
        }
      ],
      "minLikelihood": "POSSIBLE"
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "BLOCK"
        }
      }
    ]
  },
  "contentPolicyId": "block-credit-cards-policy"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "POSSIBLE",
    "limits": {}
  }
}

Expanded example

L'esempio seguente crea una policy che identifica i risultati CREDIT_CARD_NUMBER con una probabilità di POSSIBLE o superiore. Include una regola hotword che aumenta il valore di probabilità del risultato a VERY_LIKELY se la parola credit card viene rilevata in prossimità del risultato.

  • Se Sensitive Data Protection rileva un possibile numero carta di credito, restituisce un verdetto BLOCK.
  • Se il file da scansionare non è supportato, è troppo grande, danneggiato, criptato o altrimenti non scansionabile, Sensitive Data Protection restituisce un verdetto BLOCK.
  • Se nessuna delle regole corrisponde ai contenuti scansionati, Sensitive Data Protection restituisce un verdetto ALLOW.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGION: una regione in cui è disponibile un endpoint regionale per Sensitive Data Protection, ad esempio us-west2. Per un elenco completo delle regioni, consulta Località di Sensitive Data Protection.
  • PROJECT_ID: il tuo ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come example-project.

Metodo HTTP e URL: 

POST https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies

Corpo JSON della richiesta: 

{
  "contentPolicy": {
    "displayName": "displayName",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "CREDIT_CARD_NUMBER"
        }
      ],
      "ruleSet": [
        {
          "infoTypes": [
            {
              "name": "CREDIT_CARD_NUMBER"
            }
          ],
          "rules": [
            {
              "hotwordRule": {
                "hotwordRegex": {
                  "pattern": "credit\\scard"
                },
                "proximity": {
                  "windowBefore": 10,
                  "windowAfter": 10
                },
                "likelihoodAdjustment": {
                  "fixedLikelihood": "VERY_LIKELY"
                }
              }
            }
          ]
        }
      ]
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "BLOCK"
        }
      }
    ],
    "unsupportedFileType": {
      "returnVerdict": "BLOCK"
    },
    "inputTooLarge": {
      "returnVerdict": "BLOCK"
    },
    "failedToScanSupportedFileType": {
      "returnVerdict": "BLOCK"
    },
    "defaultAction": {
      "returnVerdict": "ALLOW"
    }
  },
  "contentPolicyId": "block-credit-cards-policy"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/example-project/locations/us-west2/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "limits": {},
    "ruleSet": [
      {
        "infoTypes": [
          {
            "name": "CREDIT_CARD_NUMBER"
          }
        ],
        "rules": [
          {
            "hotwordRule": {
              "hotwordRegex": {
                "pattern": "credit\\scard"
              },
              "proximity": {
                "windowBefore": 10,
                "windowAfter": 10
              },
              "likelihoodAdjustment": {
                "fixedLikelihood": "VERY_LIKELY"
              }
            }
          }
        ]
      }
    ]
  },
  "unsupportedFileType": {
    "returnVerdict": "BLOCK"
  },
  "inputTooLarge": {
    "returnVerdict": "BLOCK"
  },
  "failedToScanSupportedFileType": {
    "returnVerdict": "BLOCK"
  },
  "defaultAction": {
    "returnVerdict": "ALLOW"
  }
}

Esempio con scansione delle etichette dei metadati

L'esempio seguente indica a Sensitive Data Protection di eseguire la scansione dei numeri di carta di credito e delle etichette dei metadati con la chiave MSIP_Label_12345-12345-1234-12345_Enabled. Sensitive Data Protection restituisce un verdetto BLOCK, se ne viene trovato uno.

Per saperne di più sulla scansione delle etichette dei metadati, vedi Creare un rilevatore di etichette dei metadati personalizzato.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGION: una regione in cui è disponibile un endpoint regionale per Sensitive Data Protection, ad esempio us-west2. Per un elenco completo delle regioni, consulta Località di Sensitive Data Protection.
  • PROJECT_ID: il tuo ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come example-project.

Metodo HTTP e URL: 

POST https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies

Corpo JSON della richiesta: 

{
  "contentPolicy": {
    "displayName": "displayName",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "CREDIT_CARD_NUMBER"
        }
      ],
      "customInfoTypes": [
        {
          "infoType": {
            "name": "CUSTOM_MSIP1"
          },
          "likelihood": "VERY_LIKELY",
          "fileLabelInfoType": {
            "sensitivityLabel": {
              "guid": "12345678-1234-1234-1234-123456789012"
            }
          }
        }
      ],
      "minLikelihood": "POSSIBLE"
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "BLOCK"
        }
      }
    ]
  },
  "contentPolicyId": "block-credit-cards-policy-metadata-scanning"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy-metadata-scanning",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "POSSIBLE",
    "limits": {},
    "customInfoTypes": [
      {
        "infoType": {
          "name": "CUSTOM_MSIP1"
        },
        "likelihood": "VERY_LIKELY",
        "fileLabelInfoType": {
          "sensitivityLabel": {
            "guid": "12345678-1234-1234-1234-123456789012"
          }
        }
      }
    ]
  }
}