Richtlinie für Inhalte erstellen

Eine Inhaltsrichtlinie ist eine wiederverwendbare Ressource, die eine Prüfungskonfiguration und eine Reihe von Regeln enthält. Jede Regel gibt Bedingungen auf Basis von Prüfungsergebnissen an. Wenn die Bedingungen erfüllt sind, gibt die Richtlinie das Ergebnis ALLOW oder BLOCK zurück.

Im Gegensatz zu anderen Sensitive Data Protection-Prüfvorgängen, z. B. einem content.inspect-Aufruf oder einem Prüfjob, wird bei einer Inhaltsrichtlinie keine Liste mit Ergebnissen zurückgegeben.

Vorteile und Anwendungsfälle

Mit Inhaltsrichtlinien können Sie sofort auf Prüfergebnisse reagieren, indem Sie ein Ergebnis anstelle einer Liste von Ergebnissen erstellen. Beispiele für Anwendungsfälle:

  • Chatbot-Antworten oder Uploads, die vertrauliche Informationen wie Kreditkartennummern oder personenidentifizierbare Informationen (PII) enthalten, werden automatisch blockiert.
  • Integrieren Sie Sensitive Data Protection-Inhaltsrichtlinien in Gemini Enterprise, um zu verhindern, dass Inhalte mit sensiblen Daten verwendet werden.
  • Sie erhalten sofortige, synchrone Ergebnisse zu Inhalten, um Organisationsrichtlinien für Daten durchzusetzen.
  • Eine Entscheidung darüber erhalten, ob bestimmte Datentypen in einem Trainings-Dataset für ein KI-Modell zulässig sind.

Hinweis

  1. Installieren Sie die Google Cloud CLI.

  2. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

    Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  4. Aktivieren Sie die Data Loss Prevention API:

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen 

    gcloud services enable dlp.googleapis.com

  5. Weisen Sie Ihrem Nutzerkonto Rollen zu. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/dlp.user 

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

    Ersetzen Sie Folgendes:

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.
      • Anpassungsregeln, 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 in den folgenden Situationen 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.

    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

Wenn Sie eine Inhaltsrichtlinie erstellen möchten, senden Sie eine POST-Anfrage an die Methode projects.locations.contentPolicies.create. In der Anfrage wird ein content_policy-Objekt definiert, das die Prüfungskonfiguration und die Regeln enthält, die das Ergebnis auf Grundlage der Ergebnisse bestimmen.

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"
    }
  },
  "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 aus Gründen der Übersichtlichkeit 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 Urteil, das zugewiesen werden soll, wenn keine der Regeln mit den gescannten Inhalten übereinstimmt: ALLOW oder BLOCK.
  • CONTENT_POLICY_ID: Eine eindeutige ID für die Inhaltsrichtlinie.

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 projects.locations.contentPolicies.get-Methode.

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

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

Wenn Sie eine Inhaltsrichtlinie aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode projects.locations.contentPolicies.update. Die Anfrage definiert das aktualisierte content_policy-Objekt.

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

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