Inhaltsrichtlinien erstellen und verwalten

In diesem Dokument wird beschrieben, wie Sie Inhaltsrichtlinien erstellen, abrufen, auflisten, aktualisieren und löschen. Weitere Informationen zu Inhaltsrichtlinien

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle DLP Administrator (roles/dlp.admin) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Inhaltsrichtlinien benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen und Verwalten von Inhaltsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Inhaltsrichtlinien zu erstellen und zu verwalten:

  • dlp.contentPolicies.create
  • dlp.contentPolicies.update
  • dlp.contentPolicies.list
  • dlp.contentPolicies.get
  • dlp.contentPolicies.delete

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Wenn Sie Inhaltsrichtlinien auf Ihre Gemini Enterprise-Connectors und -Apps oder Gemini Notebook Enterprise-Notebooks anwenden möchten, müssen Sie Ihrem Gemini Enterprise-Dienstkonto auch die Rolle „DLP-Nutzer“ (roles/dlp.user) zuweisen. Weitere Informationen finden Sie unter Vertrauliche Daten in Quellen schützen.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Cloud Data Loss Prevention API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Cloud Data Loss Prevention API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    10.
  10. Optional: Wenn Sie die Aktionen der Inhaltsrichtlinie in einer BigQuery-Tabelle protokollieren möchten, erstellen Sie die Tabelle. Informationen zum Schema der exportierten Logs finden Sie unter ContentPolicyActionLog.

Richtlinie für Inhalte erstellen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Inhaltsrichtlinien für Sensitive Data Protection auf.

    Zu den Inhaltsrichtlinien

  2. Wählen Sie Ihr Projekt aus.

  3. Klicken Sie auf Erstellen.

  4. Führen Sie unter Basic Information (Grundlegende Informationen) die folgenden Schritte aus:

    1. Geben Sie einen Namen für die Inhaltsrichtlinie ein.
    2. Optional. Geben Sie eine eindeutige Inhaltsrichtlinien-ID ein. Wenn Sie keine ID für die Inhaltsrichtlinie eingeben, wird automatisch eine von Sensitive Data Protection festgelegt.
    3. Wählen Sie die Region oder Multiregion aus, in der Sie die Inhaltsrichtlinie speichern möchten.
    4. Klicken Sie auf Weiter.

  5. Führen Sie unter Konfiguration für die Prüfung die folgenden Schritte aus:

    1. Wählen Sie die integrierten oder benutzerdefinierten infoTypes aus, die erkannt werden sollen. Weitere Informationen finden Sie unter infoTypes über dieGoogle Cloud Console verwalten.

      Wenn Sie die Erkennung mit einer vorhandenen Inspektionsvorlage konfigurieren möchten, klicken Sie auf Aus Vorlage importieren und geben Sie den vollständigen Ressourcennamen der Vorlage ein.

    2. Optional. Fügen Sie einen Prüfregelsatz hinzu.

      Klicken, um die Anleitung aufzurufen

      Mit Inspektionsregelsätzen können Sie sowohl integrierte als auch benutzerdefinierte infoType-Detektoren mithilfe von Kontextregeln anpassen. Es gibt folgende Arten von Prüfregeln:

      • Ausschlussregeln, die helfen, falsche oder unerwünschte Ergebnisse auszuschließen.
      • Hotword-Regeln, die helfen, zusätzliche Ergebnisse zu erkennen.
      • Regeln für Anpassungen, mit denen die Wahrscheinlichkeit von Ergebnissen basierend auf dem Kontext, in dem sie angezeigt werden, angepasst wird.

      Wenn Sie einen neuen Regelsatz hinzufügen möchten, müssen Sie zuerst im Bereich InfoTypes einen oder mehrere integrierte oder benutzerdefinierte infoType-Detektoren angeben. Wählen Sie alle infoType-Detektoren aus, die von Ihren Regelsätzen geändert werden (die Ziel-infoTypes) oder für die Bewertung verwendet werden (die Kontext-infoTypes). Gehen Sie dann so vor:

      1. Klicken Sie auf Regelsatz hinzufügen.
      2. Wählen Sie im Feld Ziel-infoTypes auswählen die infoTypes aus, die durch das Regelset geändert werden, wenn die Regeln erfüllt sind.
      3. Klicken Sie auf Regel hinzufügen, um ein Menü mit Optionen wie Hotword-Regel, Ausschlussregel und Anpassungsregel zu öffnen.

      Wenn Sie eine Hotword-Regel erstellen möchten, wählen Sie Hotword-Regel aus. Gehen Sie anschließend so vor:

      1. Geben Sie im Feld Hotword einen regulären Ausdruck ein, nach dem Sensitive Data Protection sucht.
      2. Wählen Sie im Menü Hotword-Nähe aus, ob das eingegebene Hotword vor oder nach dem ausgewählten infoType gefunden wird.
      3. Geben Sie unter Hotword-Abstand von infoType die ungefähre Anzahl von Zeichen zwischen dem Hotword und dem ausgewählten infoType ein.
      4. Wählen Sie unter Konfidenzniveau anpassen aus, ob Übereinstimmungen ein festes Wahrscheinlichkeitsniveau zugewiesen werden soll oder ob das Standardwahrscheinlichkeitsniveau um einen bestimmten Betrag erhöht oder verringert werden soll.

      Wählen Sie Ausschlussregel und den Typ der Ausschlussregel aus, die Sie erstellen möchten, z. B. Regulärer Ausdruck. Gehen Sie anschließend so vor:

      1. Geben Sie je nach ausgewähltem Ausschlussregeltyp den regulären Ausdruck, die Wortgruppe, das Hotword oder den Kontext-InfoType ein, der gefunden werden muss, damit die Regel angewendet wird.
      2. Legen Sie je nach ausgewähltem Typ der Ausschlussregel den entsprechenden Abgleichstyp oder Containment-Typ für Bilder fest:
        • Wenn Sie eine textbasierte Ausschlussregel ausgewählt haben, wählen Sie einen der folgenden Abgleichstypen aus:
          • Vollständige Übereinstimmung: Das Ergebnis muss vollständig mit dem von Ihnen angegebenen Text oder Kontext-infoType übereinstimmen.
          • Teilweise Übereinstimmung: Ein Teilstring des Ergebnisses muss mit dem von Ihnen angegebenen Text oder Kontext-infoType übereinstimmen.
          • Inverser Abgleich: Das Ergebnis darf nicht mit dem von Ihnen angegebenen Text- oder Kontext-infoType übereinstimmen.
        • Wenn Sie eine bildbasierte Ausschlussregel ausgewählt haben, wählen Sie die erforderliche räumliche Beziehung zwischen den InfoTypes „Ziel“ und „Kontext“ aus. Wenn Sie beispielsweise Encloses auswählen, muss die Kontext-Erkenntnis die Ziel-Erkenntnis einschließen, damit die Regel angewendet wird.

      Wenn Sie eine Anpassungsregel erstellen möchten, wählen Sie Anpassungsregel und den Typ der Anpassungsregel aus, z. B. Anpassen nach Bildbefunden. Gehen Sie anschließend so vor:

      1. Wählen Sie im Feld Kontext-infoTypes die infoType-Detektoren aus, die Kontext für das Zielergebnis liefern. Sensitive Data Protection verwendet Kontext-infoTypes, um zu beurteilen, ob der Ziel-infoType angepasst werden muss.
      2. Wählen Sie im Feld Mindestwahrscheinlichkeit die niedrigste Wahrscheinlichkeitsstufe aus, die die Kontext-infoTypes haben können und trotzdem die Anpassungsregel auslösen. Wenn der Wahrscheinlichkeitswert eines erkannten Kontextbefunds niedriger als dieser Wert ist, wird die Wahrscheinlichkeit des Zielbefunds durch Sensitive Data Protection nicht angepasst.
      3. Wählen Sie für Bild-Ergebnisse im Feld Bild-Containment-Typ die erforderliche räumliche Beziehung zwischen den Ziel- und Kontext-InfoTypes aus. Wenn Sie beispielsweise Umschließt auswählen, muss die Kontext-Ergebnisliste die Ziel-Ergebnisliste umschließen, damit die Regel angewendet wird.
      4. Wählen Sie im Feld Wahrscheinlichkeit die neue Wahrscheinlichkeitsstufe aus, die dem Zielfund zugewiesen werden soll.

      Sie können weitere Regelsätze hinzufügen, um die Scanergebnisse weiter zu verfeinern.

    3. Optional. Legen Sie den Konfidenzwert für zu erkennende Ergebnisse fest. Weitere Informationen finden Sie unter Wahrscheinlichkeit von Übereinstimmungen.

    4. Klicken Sie auf Weiter.

  6. Fügen Sie in Policy Rules (Richtlinienregeln) Richtlinienregeln hinzu, um das Ergebnis (Allow oder Block) anzugeben, das Sensitive Data Protection zurückgibt, wenn ein infoType erkannt wird, den Sie in Ihrer Prüfkonfiguration angegeben haben. Sie können eine einzelne Richtlinienregel hinzufügen, um für jeden infoType dasselbe Ergebnis zurückzugeben, oder mehrere Richtlinienregeln, um für verschiedene infoTypes unterschiedliche Ergebnisse zurückzugeben. Sie müssen für jede Richtlinienregel, die Sie hinzufügen, eine Bedingung festlegen.

    So fügen Sie eine Richtlinienregel hinzu:

    1. Klicken Sie auf Richtlinienregel hinzufügen.
    2. Wählen Sie ein Ergebnis aus, das dem infoType-Ergebnis zugewiesen werden soll: Zulassen oder Blockieren.
    3. Klicken Sie auf Bedingung hinzufügen. Legen Sie Bedingungstyp auf Beliebiger infoType oder Bestimmte infoTypes fest, je nachdem, ob Sie unterschiedliche Ergebnisse für verschiedene infoTypes festlegen möchten.
    4. Wenn Sie Bestimmte infoTypes ausgewählt haben, geben Sie die infoTypes ein, die erkannt werden müssen, damit Sensitive Data Protection das von Ihnen ausgewählte Ergebnis zurückgibt.
    5. Fügen Sie bei Bedarf weitere Richtlinienregeln und die entsprechenden Bedingungen hinzu.
    6. Klicken Sie auf Weiter.

  7. Optional. Geben Sie unter Standardaktionen die Ergebnisse an, die unter den folgenden Bedingungen angewendet werden sollen:

    • Ein Ergebnis, das nicht unterstützten Dateien zugewiesen werden soll. Weitere Informationen finden Sie unter Unterstützte Dateitypen und Scanmodi.
    • Ein Ergebnis, das unterstützten Dateien zugewiesen wird, die zu groß für einen Scan sind.
    • Ein Ergebnis, das Dateien zugewiesen wird, die nicht gescannt werden können, z. B. beschädigte oder verschlüsselte Dateien.
    • Ein Ergebnis, das zugewiesen werden soll, wenn keine der Regeln mit den gescannten Inhalten übereinstimmt.

    Für jede dieser Bedingungen ist das Standardurteil ALLOW.

    Klicken Sie auf Weiter.

  8. Optional. Aktivieren Sie unter Logging Configuration (Logging-Konfiguration) das Logging, um die Ergebnisse der Inhaltsrichtlinie für die gescannten Daten aufzuzeichnen. Gehen Sie dazu so vor:

    1. Wählen Sie Richtlinienausführung in BigQuery protokollieren aus.
    2. Geben Sie die Details einer vorhandenen BigQuery-Tabelle ein, in der Sensitive Data Protection die Ergebnisse protokollieren muss.

  9. Klicken Sie auf Erstellen.

REST

Senden Sie zum Erstellen einer Inhaltsrichtlinie eine POST-Anfrage an die Methode projects.locations.contentPolicies.create. Im Anfragetext wird ein content_policy-Objekt definiert, das die Konfiguration und die Regeln für die Überprüfung enthält, anhand derer das Ergebnis basierend auf den Ergebnissen bestimmt wird.

Das content_policy-Objekt hat die folgenden Eigenschaften:

{
  "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"
    },
    "loggingConfigs": [
      {
        "logToBigQuery": {
          "projectId": "LOG_PROJECT_ID",
          "datasetId": "LOG_DATASET_ID",
          "tableId": "LOG_TABLE_ID"
        }
      }
    ]
  },
  "contentPolicyId": "CONTENT_POLICY_ID"
}

Ersetzen Sie Folgendes:

  • DISPLAY_NAME: Optional. Ein für Menschen lesbarer Name für die Inhaltsrichtlinie.
  • INFOTYPE_DETECTOR: Ein integrierter oder benutzerdefinierter infoType.
  • LIST_OF_RULES: Optional. Eine Liste der Prüfregeln, wie in infoType-Detektoren zum Verfeinern von Scanergebnissen anpassen beschrieben. Dieser Code wurde der Kürze halber gekürzt. Ein Beispiel für eine Regelnsatzdefinition in einer Inhaltsrichtlinie finden Sie unter Erweitertes Beispiel.
  • INFOTYPE_CONDITION_VERDICT: Ein Urteil, das einem Ergebnis eines infoType zugewiesen werden soll: ALLOW oder BLOCK.
  • UNSUPPORTED_FILE_TYPE_VERDICT: Optional. Ein Urteil, das nicht unterstützten Dateien zugewiesen werden soll: ALLOW oder BLOCK. Weitere Informationen finden Sie unter Unterstützte Dateitypen und Scanmodi.
  • INPUT_TOO_LARGE_VERDICT: Optional. Ein Ergebnis, das unterstützten Dateien zugewiesen werden soll, die zu groß für einen Scan sind: ALLOW oder BLOCK.
  • FAILED_TO_SCAN_VERDICT: Optional. Ein Ergebnis, das Dateien zugewiesen werden soll, die nicht gescannt werden können, z. B. beschädigte oder verschlüsselte Dateien: ALLOW oder BLOCK.
  • DEFAULT_ACTION_VERDICT: Optional. Ein Ergebnis, das zugewiesen werden soll, wenn keine der Regeln mit den gescannten Inhalten übereinstimmt: ALLOW oder BLOCK.
  • LOG_PROJECT_ID: Die ID des Projekts, das die BigQuery-Tabelle enthält, in die geschrieben werden soll.
  • LOG_DATASET_ID: Die ID des Datasets, das die BigQuery-Tabelle enthält, in die geschrieben werden soll.
  • LOG_TABLE_ID: Die ID der BigQuery-Tabelle, in die geschrieben werden soll.
  • CONTENT_POLICY_ID: Eine eindeutige ID für die Inhaltsrichtlinie.

Eine Beispielantwort finden Sie unter Expanded example.

Details zu einer Inhaltsrichtlinie abrufen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Inhaltsrichtlinien für Sensitive Data Protection auf.

    Zu den Inhaltsrichtlinien

  2. Wählen Sie Ihr Projekt aus.

  3. Klicken Sie auf den Ressourcennamen einer Inhaltsrichtlinie, um sie aufzurufen.

  4. Auf dem Tab Details finden Sie Informationen zur Inhaltsrichtlinie.

REST

Senden Sie zum Abrufen einer Inhaltsrichtlinie eine GET-Anfrage an die Methode projects.locations.contentPolicies.get.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGION: die Region, in der die Inhaltsrichtlinie gespeichert ist, z. B. us-west2. Eine vollständige Liste der Regionen finden Sie unter Standorte für Sensitive Data Protection.
  • PROJECT_ID: Die ID des Projekts, das die Inhaltsrichtlinie enthält.
  • CONTENT_POLICY_ID: Die ID der Inhaltsrichtlinie, für die Details abgerufen werden sollen.

HTTP-Methode und URL: 

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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": {}
  }
}

Alle Inhaltsrichtlinien in einem Projekt auflisten

Console

  1. Rufen Sie in der Google Cloud Console die Seite Inhaltsrichtlinien für Sensitive Data Protection auf.

    Zu den Inhaltsrichtlinien

  2. Wählen Sie Ihr Projekt aus. Die Liste der Inhaltsrichtlinien im Projekt wird angezeigt.

REST

Wenn Sie die Inhaltsrichtlinien in einem Projekt auflisten möchten, senden Sie eine LIST-Anfrage an die Methode projects.locations.contentPolicies.list.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGION: Die Region, in der die aufzulistenden Inhaltsrichtlinien gespeichert sind, z. B. us-west2. Eine vollständige Liste der Regionen finden Sie unter Standorte für Sensitive Data Protection.
  • PROJECT_ID: Die ID des Projekts, das die aufzulistenden Inhaltsrichtlinien enthält.

HTTP-Methode und URL: 

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "contentPolicies": [
      {
  "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": {}
  }
},
    {
      "name": "projects/example-project/locations/us-west1/contentPolicies/block-pii",
      ...
    }
  ]
}

Inhaltsrichtlinie aktualisieren

Console

  1. Rufen Sie in der Google Cloud Console die Seite Inhaltsrichtlinien für Sensitive Data Protection auf.

    Zu den Inhaltsrichtlinien

  2. Wählen Sie Ihr Projekt aus.

  3. Klicken Sie auf den Ressourcennamen einer Inhaltsrichtlinie, um sie zu bearbeiten.

  4. Klicken Sie auf Bearbeiten.

  5. Bearbeiten Sie die Details der Inhaltsrichtlinie.

REST

Senden Sie eine PATCH-Anfrage an die Methode projects.locations.contentPolicies.patch, um eine Inhaltsrichtlinie zu aktualisieren. Im Anfragetext wird das aktualisierte content_policy-Objekt definiert.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGION: Eine Region, in der ein regionaler Endpunkt für Sensitive Data Protection verfügbar ist, z. B. us-west2. Eine vollständige Liste der Regionen finden Sie unter Standorte für Sensitive Data Protection.
  • PROJECT_ID: Projekt-ID in Google Cloud . Projekt-IDs sind alphanumerische Strings, wie example-project.
  • CONTENT_POLICY_ID: Die ID der zu aktualisierenden Inhaltsrichtlinie.

HTTP-Methode und URL: 

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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": {}
  }
}

Inhaltsrichtlinie löschen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Inhaltsrichtlinien für Sensitive Data Protection auf.

    Zu den Inhaltsrichtlinien

  2. Wählen Sie Ihr Projekt aus.

  3. Wählen Sie die Inhaltsrichtlinie aus, die Sie löschen möchten.

  4. Klicken Sie auf Löschen.

REST

Senden Sie eine DELETE-Anfrage an die Methode projects.locations.contentPolicies.delete, um eine Inhaltsrichtlinie zu löschen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGION: die Region, in der die Inhaltsrichtlinie gespeichert ist, z. B. us-west2. Eine vollständige Liste der Regionen finden Sie unter Standorte für Sensitive Data Protection.
  • PROJECT_ID: Die ID des Projekts, das die Inhaltsrichtlinie enthält.
  • CONTENT_POLICY_ID: Die ID der zu löschenden Inhaltsrichtlinie.

HTTP-Methode und URL: 

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

REST-Beispiele

Die folgenden REST-Beispiele zeigen, wie Sie mit der REST API eine Inhaltsrichtlinie erstellen.

Einfaches Beispiel

Im folgenden Beispiel wird eine Richtlinie erstellt, mit der CREDIT_CARD_NUMBER-Ergebnisse mit einer Wahrscheinlichkeit von POSSIBLE oder höher identifiziert werden. Wenn eine Kartennummer gefunden wird, gibt Sensitive Data Protection das Ergebnis BLOCK zurück.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGION: Eine Region, in der ein regionaler Endpunkt für Sensitive Data Protection verfügbar ist, z. B. us-west2. Eine vollständige Liste der Regionen finden Sie unter Standorte für Sensitive Data Protection.
  • PROJECT_ID: Projekt-ID in Google Cloud . Projekt-IDs sind alphanumerische Strings, wie example-project.

HTTP-Methode und URL: 

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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": {}
  }
}

Erweitertes Beispiel

Im folgenden Beispiel wird eine Richtlinie erstellt, mit der CREDIT_CARD_NUMBER-Ergebnisse mit einer Wahrscheinlichkeit von POSSIBLE oder höher identifiziert werden. Sie enthält eine Hotword-Regel, die den Wahrscheinlichkeitswert des Ergebnisses auf VERY_LIKELY erhöht, wenn das Wort credit card in der Nähe des Ergebnisses erkannt wird.

  • Wenn Sensitive Data Protection eine mögliche Kartennummer erkennt, wird das Ergebnis BLOCK zurückgegeben.
  • Wenn die zu scannende Datei nicht unterstützt wird, zu groß, beschädigt, verschlüsselt oder anderweitig nicht gescannt werden kann, gibt Sensitive Data Protection das Ergebnis BLOCK zurück.
  • Wenn keine der Regeln mit den gescannten Inhalten übereinstimmt, gibt Sensitive Data Protection das Ergebnis ALLOW zurück.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGION: Eine Region, in der ein regionaler Endpunkt für Sensitive Data Protection verfügbar ist, z. B. us-west2. Eine vollständige Liste der Regionen finden Sie unter Standorte für Sensitive Data Protection.
  • PROJECT_ID: Projekt-ID in Google Cloud . Projekt-IDs sind alphanumerische Strings, wie example-project.

HTTP-Methode und URL: 

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

JSON-Text anfordern:

{
  "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"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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"
  }
}

Beispiel für das Scannen von Metadatenlabels

Im folgenden Beispiel wird Sensitive Data Protection angewiesen, nach Kreditkartennummern und Metadatenlabels mit dem Schlüssel MSIP_Label_12345-12345-1234-12345_Enabled zu suchen. Sensitive Data Protection gibt ein BLOCK-Ergebnis zurück, wenn eines gefunden wird.

Weitere Informationen zum Scannen von Metadatenlabels finden Sie unter Benutzerdefinierten Detektor für Metadatenlabels erstellen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGION: Eine Region, in der ein regionaler Endpunkt für Sensitive Data Protection verfügbar ist, z. B. us-west2. Eine vollständige Liste der Regionen finden Sie unter Standorte für Sensitive Data Protection.
  • PROJECT_ID: Projekt-ID in Google Cloud . Projekt-IDs sind alphanumerische Strings, wie example-project.

HTTP-Methode und URL: 

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

JSON-Text anfordern:

{
  "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"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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"
          }
        }
      }
    ]
  }
}

Nächste Schritte