Cloud Data Loss Prevention (Cloud DLP) ist jetzt Teil des Schutzes sensibler Daten. Der Name der API bleibt unverändert: Cloud Data Loss Prevention API (DLP API). Informationen zu den Diensten, die zum Schutz sensibler Daten gehören, finden Sie unter Schutz sensibler Daten.

Diese Seite wurde von der Cloud Translation API übersetzt.

Daten aus externen Quellen mit Hybridjobs prüfen

In diesem Thema wird beschrieben, wie Sie mit Hybridjobs und Hybridjob-Triggern externe Daten auf sensible Informationen prüfen. Weitere Informationen zu Hybridjobs und Hybridjob-Triggern, einschließlich Beispielen für Hybridumgebungen, finden Sie unter Hybridjobs und Hybridjob-Trigger.

Einführung in Hybridjobs und Hybridjob-Trigger

Mit Hybridjobs und Hybridjob-Triggern können Sie den Umfang der Schutzmaßnahmen, die Sensitive Data Protection bietet, über einfache Anfragen zur Inhaltsprüfung und Google Cloud -Speicher-Repository-Scans hinaus erweitern. Mit Hybridjobs und Hybridjob-Triggern können Sie Daten aus praktisch jeder Quelle, einschließlich Quellen außerhalb von Google Cloud, direkt in Sensitive Data Protection streamen, um dann Sensitive Data Protection die Daten auf vertrauliche Informationen prüfen zu lassen. Sensitive Data Protection speichert und aggregiert die Scanergebnisse automatisch zur weiteren Analyse.

Vergleich von Hybridjobs und Hybridjob-Triggern

Wenn Sie Hybridjobs erstellen, werden sie ausgeführt, bis Sie sie beenden. Sie akzeptieren alle eingehenden Daten, solange sie ordnungsgemäß weitergeleitet und formatiert sind.

Hybridjob-Trigger funktionieren ähnlich wie Hybridjobs, aber Sie müssen einen Job innerhalb eines Hybridjob-Triggers nicht explizit beenden. Jobs in Hybrid-Job-Triggern werden von Sensitive Data Protection automatisch am Ende jedes Tages beendet.

Außerdem können Sie mit einem Hybridjob-Trigger neue Jobs innerhalb des Triggers anhalten und starten, ohne Ihre hybridInspect-Anfragen neu konfigurieren zu müssen. Sie können beispielsweise Daten an einen Hybridjob-Trigger senden, dann den aktiven Job anhalten, seine Konfiguration ändern, einen neuen Job innerhalb dieses Triggers starten und dann Daten an denselben Trigger senden.

Weitere Informationen dazu, welche Option für Ihren Anwendungsfall am besten geeignet ist, finden Sie auf dieser Seite unter Typische Hybrid-Prüfszenarien.

Begriffsdefinition

In diesem Thema werden die folgenden Begriffe verwendet:

Externe Daten: Daten, die außerhalb von Google Cloud gespeichert sind, oder Daten, die nicht nativ von Sensitive Data Protection unterstützt werden.
Hybridjob: Ein Prüfjob, der so konfiguriert ist, dass Daten aus praktisch jeder Quelle gescannt werden.
Hybridjob-Trigger: Ein Job-Trigger, der so konfiguriert ist, dass Daten aus praktisch jeder Quelle gescannt werden.
hybridInspect-Anfrage: Eine Anfrage, die die externen Daten enthält, die Sie prüfen möchten. Wenn Sie diese Anfrage senden, geben Sie den Hybridjob oder Hybridjob-Trigger an, an den die Anfrage gesendet werden soll.

Allgemeine Informationen zu Jobs und Job-Triggern finden Sie unter Jobs und Job-Trigger.

Hybrider Prüfprozess

Der Hybrid-Prüfprozess besteht aus drei Schritten.

Wählen Sie die Daten aus, die an den Schutz sensibler Daten gesendet werden sollen.

Die Daten können von innerhalb Google Cloud oder außerhalb stammen. Sie können beispielsweise ein benutzerdefiniertes Skript oder eine benutzerdefinierte Anwendung so konfigurieren, dass Daten an Sensitive Data Protection gesendet werden, um Daten während der Übertragung, über einen anderen Clouddienst, ein lokales Daten-Repository oder praktisch jede andere Datenquelle zu prüfen.
Richten Sie einen Hybridjob oder Hybridjob-Trigger im Schutz sensibler Daten von Grund auf neu ein oder verwenden Sie eine Inspektionsvorlage.

Sobald Sie einen Hybridjob oder Hybridjob-Trigger eingerichtet haben, überwacht Sensitive Data Protection sie aktiv auf Daten, die an sie gesendet werden. Wenn Ihr benutzerdefiniertes Skript oder Ihre benutzerdefinierte Anwendung Daten an diesen Hybridjob oder Hybridjob-Trigger sendet, werden die Daten geprüft und ihre Ergebnisse gemäß der Konfiguration gespeichert.

Wenn Sie den Hybridjob oder den Hybridjob-Trigger einrichten, können Sie angeben, wo Sie die Ergebnisse speichern oder veröffentlichen möchten. Zu den Optionen gehören das Speichern in BigQuery und die Veröffentlichung von Benachrichtigungen in Pub/Sub, Cloud Monitoring oder E-Mails.
Senden Sie eine hybridInspect-Anfrage an den Hybridjob oder Hybridjob-Trigger.

Eine hybridInspect-Anfrage enthält die zu scannenden Daten. Fügen Sie in die Anfrage Metadaten ein (auch als Labels und Tabellenkennzeichnungen bezeichnet), die den Inhalt beschreiben und Sensitive Data Protection die Identifizierung der zu verfolgenden Informationen ermöglichen. Wenn Sie beispielsweise verwandte Daten über mehrere Anfragen hinweg scannen (z. B. Zeilen in derselben Datenbanktabelle), können Sie in diesen verwandten Anfragen dieselben Metadaten verwenden. Anschließend können Sie die Ergebnisse für diese Datenbanktabelle erfassen, zusammenfassen und analysieren.

Während der Hybridjob ausgeführt und geprüft wird, stehen Inspektionsergebnisse zur Verfügung, sobald Sensitive Data Protection sie generiert hat. Aktionen wie Pub/Sub-Benachrichtigungen erfolgen erst, wenn Ihre Anwendung den Hybridjob beendet.

Diagramm zur Darstellung des Hybridjob-Prüfprozesses

Hinweise

Beachten Sie bei der Arbeit mit Hybridjobs und Job-Triggern die folgenden Punkte:

Bei Hybridjobs und Hybridjob-Triggern werden keine Filterung und kein Sampling unterstützt.
Für Jobs und Job-Trigger gelten keine Service Level Objectives (SLOs). Sie können jedoch Maßnahmen ergreifen, um die Latenz zu verringern. Weitere Informationen finden Sie unter Job-Latenz.

Hinweise

Führen Sie vor dem Einrichten und Verwenden von Hybridjobs oder Hybridjob-Triggern folgende Schritte aus:

Neues Projekt erstellen, Abrechnung aktivieren und Schutz sensibler Daten aktivieren

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Sensitive Data Protection API.
Enable the API

Datenquelle konfigurieren

Bevor Sensitive Data Protection Ihre Daten prüfen kann, müssen Sie die Daten an Sensitive Data Protection senden. Unabhängig davon, welche Methode Sie zum Konfigurieren des Hybridjobs oder Hybridjob-Triggers verwenden, müssen Sie Ihre externe Quelle so einrichten, dass sie Daten an die DLP API sendet.

Informationen zum erforderlichen Format für Hybrid-Prüfungsanfragen finden Sie unter Formatierung von Hybrid-Inhaltselementen. Informationen zu den Arten von Metadaten, die Sie in die Daten einer Anfrage aufnehmen können, finden Sie unter Arten von Metadaten, die Sie bereitstellen können.

Hybridjob oder Hybridjob-Trigger erstellen

Damit Sensitive Data Protection die Daten prüfen kann, die Sie senden, müssen Sie zuerst einen Hybridjob oder einen Hybridjob-Trigger einrichten. Informationen dazu, welche Art von Ansicht Sie erstellen sollten, finden Sie auf dieser Seite unter Typische Szenarien für Hybridprüfungen.

Console

Rufen Sie in der Google Cloud Console die Seite Job oder Job-Trigger erstellen auf:

Zur Seite „Job oder Job-Trigger erstellen“

In den folgenden Abschnitten wird beschrieben, wie Sie die Abschnitte der Seite Job oder Job-Trigger erstellen ausfüllen, die für hybride Inspektionsvorgänge relevant sind.

Eingabedaten auswählen

In diesem Abschnitt geben Sie die Eingabedaten an, die Sensitive Data Protection prüfen soll.

Optional: Geben Sie für Name einen Namen für den Job im Feld Job-ID ein. Wenn Sie dieses Feld leer lassen, generiert Sensitive Data Protection automatisch eine Kennzeichnung.
Optional: Wählen Sie im Menü Ressourcenstandort die Region aus, in der Sie den Hybridjob oder den Hybridjob-Trigger speichern möchten. Weitere Informationen finden Sie unter Verarbeitungsstandorte angeben.
Wählen Sie als Speichertyp die Option Hybrid aus.
Optional: Geben Sie unter Beschreibung eine Beschreibung für den Hybridjob oder den Hybridjob-Trigger ein, den Sie erstellen. Sie können beispielsweise Informationen zur Quelle der zu prüfenden Daten angeben.
Optional: Klicken Sie unter Erforderliche Labels auf Label hinzufügen und geben Sie ein Label ein, das für hybridInspect-Anfragen erforderlich sein soll. Eine hybridInspect-Anfrage, in der dieses Label nicht angegeben ist, wird von diesem Hybridjob oder Hybridjob-Trigger nicht verarbeitet. Sie können bis zu 10 erforderliche Labels hinzufügen. Weitere Informationen finden Sie auf dieser Seite unter Labels für hybridInspect-Anfragen erforderlich.
Optional: Geben Sie unter Optionale Labels alle Schlüssel/Wert-Paare ein, die Sie den Ergebnissen aller hybridInspect-Anfragen zuordnen möchten, die an diesen Job oder Job-Trigger gesendet werden. Sie können bis zu 10 optionale Labels hinzufügen. Weitere Informationen finden Sie unter Optionale Labels.
Optional: Geben Sie unter Optionen für tabellarische Daten den Feldnamen der Primärschlüsselspalte ein, wenn Sie planen, tabellarische Daten in Ihren hybridInspect-Anfragen zu senden. Weitere Informationen finden Sie unter Optionen für tabellarische Daten.
Klicken Sie auf Weiter.

Erkennung konfigurieren

In diesem Abschnitt geben Sie die Typen sensibler Daten an, für die Sensitive Data Protection die Eingabedaten prüfen soll. Sie haben folgende Optionen:

Vorlage: Wenn Sie im aktuellen Projekt bereits eine Vorlage erstellt haben, die Sie zum Definieren der Sensitive Data Protection-Erkennungsparameter verwenden möchten, klicken Sie auf das Feld Vorlagenname und wählen Sie dann die Vorlage aus der angezeigten Liste aus.
InfoTypes: Der Schutz sensibler Daten wählt die am häufigsten integrierten infoTypes aus, die erkannt werden sollen. Klicken Sie auf infoTypes verwalten, um die infoTypes zu ändern oder einen benutzerdefinierten infoType auszuwählen, der verwendet werden soll. Sie können die Erkennungskriterien auch in den Abschnitten Inspektionsregelsätze und Konfidenzschwellenwert optimieren. Weitere Informationen finden Sie unter Erkennung konfigurieren.

Klicken Sie nach dem Konfigurieren der Erkennungsparameter auf Weiter.

Aktionen hinzufügen

In diesem Abschnitt geben Sie an, wo die Ergebnisse aus jedem Prüfungsscan gespeichert werden sollen und ob Sie per E-Mail oder Pub/Sub-Benachrichtigung benachrichtigt werden möchten, wenn ein Scan abgeschlossen ist. Wenn Sie die Ergebnisse nicht in BigQuery speichern, enthalten die Scanergebnisse nur Statistiken zur Anzahl und zu den infoTypes der Ergebnisse.

In BigQuery speichern: Bei jeder Ausführung eines Scans speichert Sensitive Data Protection Scanergebnisse in der hier angegebenen BigQuery-Tabelle. Wenn Sie keine Tabellen-ID angeben, weist BigQuery einer neuen Tabelle einen Standardnamen zu, wenn der Scan zum ersten Mal ausgeführt wird. Wenn Sie eine vorhandene Tabelle angeben, hängt Sensitive Data Protection Scanergebnisse an diese an.
In Pub/Sub veröffentlichen: Wenn ein Job abgeschlossen ist, wird eine Pub/Sub-Nachricht ausgegeben.

Hinweis :Wenn es Konfigurations- oder Berechtigungsprobleme mit dem Pub/Sub-Thema gibt, versucht Sensitive Data Protection bis zu zwei Wochen lang, die Pub/Sub-Benachrichtigung zu senden. Nach zwei Wochen wird die Benachrichtigung verworfen.
Per E-Mail benachrichtigen: Wenn ein Job abgeschlossen ist, wird eine E-Mail-Nachricht gesendet.
In Cloud Monitoring veröffentlichen: Wenn ein Job abgeschlossen ist, werden die Ergebnisse in Monitoring veröffentlicht.

Klicken Sie nach der Auswahl der Aktionen auf Weiter.

Planen

In diesem Abschnitt geben Sie an, ob ein einzelner Job, der sofort ausgeführt wird, oder ein Job-Trigger erstellt wird, der jedes Mal ausgeführt wird, wenn ordnungsgemäß weitergeleitete und formatierte Daten von Sensitive Data Protection empfangen werden.

Führen Sie einen der folgenden Schritte aus:

Wählen Sie Keiner (einmaligen Job sofort bei der Erstellung ausführen) aus, um den Hybridjob sofort auszuführen.
Wählen Sie Trigger zum Ausführen des Jobs nach einem regelmäßigen Zeitplan erstellen aus, um den Job so zu konfigurieren, dass von der Quelle empfangene Daten den Trigger auslösen.

Hybridjob-Trigger aggregieren API-Aufrufe, sodass Sie Ergebnisse und Trends im Laufe der Zeit erkennen können.

Weitere Informationen finden Sie unter Vergleich von Hybridjobs und Hybridjob-Triggern.

Überprüfen

Eine JSON-Zusammenfassung des Scans finden Sie hier. Notieren Sie sich den Namen des Hybridjobs oder Hybridjob-Triggers. Sie benötigen diese Informationen, wenn Sie Daten zur Prüfung an den Schutz sensibler Daten senden.

Klicken Sie nach der Überprüfung der JSON-Zusammenfassung auf Erstellen.

Sensitive Data Protection startet den Hybridjob oder Hybridjob-Trigger sofort. Ein Prüfscan wird gestartet, wenn Sie eine hybridInspect-Anfrage an diesen Hybridjob oder Hybridjob-Trigger senden.

API

Ein Job wird in der DLP API durch die Ressource DlpJobs dargestellt. Zum Erstellen eines hybriden Jobs rufen Sie die Methode projects.locations.dlpJobs.create auf.

Ein Job-Trigger wird in der DLP API durch die Ressource JobTrigger dargestellt. Zum Erstellen eines Hybridjob-Triggers rufen Sie die Methode projects.locations.jobTriggers.create auf.

Das von Ihnen erstellte DlpJobs- oder JobTrigger-Objekt muss die folgenden Einstellungen haben:

Legen Sie im Feld inspectJob ein InspectJobConfig-Objekt fest.
Legen Sie im InspectJobConfig-Objekt im Feld storageConfig ein StorageConfig-Objekt fest.
Legen Sie im StorageConfig-Objekt im Feld hybridOptions ein HybridOptions-Objekt fest. Dieses Objekt enthält Metadaten zu den Daten, die Sie untersuchen möchten.
Fügen Sie im InspectJobConfig-Objekt im Feld actions alle Aktionen (Action) hinzu, die von Sensitive Data Protection am Ende jedes Jobs ausgeführt werden sollen.

Die Aktionen publishSummaryToCscc und publishFindingsToCloudDataCatalog werden für diesen Vorgang nicht unterstützt. Weitere Informationen zu Aktionen finden Sie unter Aktionen.
Geben Sie an, wonach gesucht werden soll und wie die Suche erfolgen soll, indem Sie eine oder beide der folgenden Aktionen ausführen:
- Legen Sie das Feld inspectTemplateName auf den vollständigen Ressourcennamen einer Inspektionsvorlage fest, die Sie verwenden möchten, sofern verfügbar.
- Legen Sie das Feld inspectConfig fest.
Wenn Sie sowohl das Feld inspectTemplateName als auch das Feld inspectConfig festlegen, werden die Einstellungen kombiniert.

Über die JSON-Beispiele

Die folgenden Tabs enthalten JSON-Beispiele, die Sie an Sensitive Data Protection senden können, um einen Hybridjob oder einen Hybridjob-Trigger zu erstellen. Diese Beispiele für Hybridjobs und Hybridjob-Trigger sind für Folgendes konfiguriert:

Verarbeite alle hybridInspect-Anfragen, wenn die Anfrage das Label appointment-bookings-comments hat.
Scannen Sie den Inhalt der hybridInspect-Anfrage nach E‑Mail-Adressen.
"env": "prod"-Label an Ergebnisse anhängen
Bei tabellarischen Daten rufen Sie den Wert der Zelle in der Spalte booking_id (Primärschlüssel) ab, die sich in derselben Zeile wie die Zelle befindet, in der die vertraulichen Daten gefunden wurden. Sensitive Data Protection fügt diese Kennung dem Ergebnis hinzu, damit Sie das Ergebnis der entsprechenden Zeile zuordnen können.
E‑Mail senden, wenn der Job beendet wird. Die E-Mail wird an IAM-Projektinhaber und technische wichtige Kontakte gesendet.
Die Ergebnisse werden an Cloud Monitoring gesendet, wenn der Job beendet wird.

Die JSON-Beispiele finden Sie auf den folgenden Tabs.

Hybride Stelle

Dieser Tab enthält ein JSON-Beispiel, das Sie zum Erstellen eines Hybridjobs verwenden können.

Senden Sie zum Erstellen eines Hybridjobs eine POST-Anfrage an den folgenden Endpunkt.

HTTP-Methode und URL

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

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Projekts, in dem Sie den Hybridjob speichern möchten.
REGION: die geografische Region, in der Sie den Hybridjob speichern möchten.

JSON-Eingabe

{
  "jobId": "postgresql-table-comments",
  "inspectJob": {
    "actions": [
      {
        "jobNotificationEmails": {}
      },
      {
        "publishToStackdriver": {}
      }
    ],
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "EMAIL_ADDRESS"
        }
      ],
      "minLikelihood": "POSSIBLE",
      "includeQuote": true
    },
    "storageConfig": {
      "hybridOptions": {
        "description": "Hybrid job for data from the comments field of a table that contains customer appointment bookings",
        "requiredFindingLabelKeys": [
          "appointment-bookings-comments"
        ],
        "labels": {
          "env": "prod"
        },
        "tableOptions": {
          "identifyingFields": [
            {
              "name": "booking_id"
            }
          ]
        }
      }
    }
  }
}

JSON-Ausgabe

{
"name": "projects/PROJECT_ID/locations/REGION/dlpJobs/i-postgresql-table-comments",
"type": "INSPECT_JOB",
"state": "ACTIVE",
"inspectDetails": {
  "requestedOptions": {
    "snapshotInspectTemplate": {},
    "jobConfig": {
      "storageConfig": {
        "hybridOptions": {
          "description": "Hybrid job for data from the comments field of a table that contains customer appointment bookings",
          "requiredFindingLabelKeys": [
            "appointment-bookings-comments"
          ],
          "labels": {
            "env": "prod"
          },
          "tableOptions": {
            "identifyingFields": [
              {
                "name": "booking_id"
              }
            ]
          }
        }
      },
      "inspectConfig": {
        "infoTypes": [
          {
            "name": "EMAIL_ADDRESS"
          }
        ],
        "minLikelihood": "POSSIBLE",
        "limits": {},
        "includeQuote": true
      },
      "actions": [
        {
          "jobNotificationEmails": {}
        },
        {
          "publishToStackdriver": {}
        }
      ]
    }
  },
  "result": {
    "hybridStats": {}
  }
},
"createTime": "JOB_CREATION_DATETIME",
"startTime": "JOB_START_DATETIME"
}

Der Schutz sensibler Daten erstellt den Hybridjob und generiert eine Job-ID. In diesem Beispiel lautet die Job-ID i-postgresql-table-comments. Notieren Sie sich die Job-ID. Sie benötigen ihn für Ihre hybridInspect-Anfrage.

Wenn Sie einen Hybrid-Job beenden möchten, müssen Sie die Methode projects.locations.dlpJobs.finish explizit aufrufen. Die DLP API beendet Hybrid-Jobs nicht automatisch. Im Gegensatz dazu werden Jobs in hybriden Job-Triggern mit der DLP API automatisch am Ende jedes Tages beendet.

Hybrid-Job-Trigger

Dieser Tab enthält ein JSON-Beispiel, mit dem Sie einen Trigger für einen Hybridjob erstellen können.

Senden Sie zum Erstellen eines hybriden Job-Triggers eine POST-Anfrage an den folgenden Endpunkt.

HTTP-Methode und URL

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

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Projekts, in dem Sie den Hybrid-Job-Trigger speichern möchten.
REGION: die geografische Region, in der Sie den Hybridjob-Trigger speichern möchten.

JSON-Eingabe

{
    "triggerId": "postgresql-table-comments",
    "jobTrigger": {
      "triggers": [
        {
          "manual": {}
        }
      ],
      "inspectJob": {
        "actions": [
          {
            "jobNotificationEmails": {}
          },
          {
            "publishToStackdriver": {}
          }
        ],
        "inspectConfig": {
          "infoTypes": [
              {
                "name": "EMAIL_ADDRESS"
              }
          ],
          "minLikelihood": "POSSIBLE",
          "limits": {},
          "includeQuote": true
        },
        "storageConfig": {
          "hybridOptions": {
            "description": "Hybrid job trigger for data from the comments field of a table that contains customer appointment bookings",
            "requiredFindingLabelKeys": [
                "appointment-bookings-comments"
              ],
            "labels": {
              "env": "prod"
            },
            "tableOptions": {
              "identifyingFields": [
                {
                  "name": "booking_id"
                }
              ]
            }
          }
        }
      }
    }
  }

JSON-Ausgabe

{
"name": "projects/PROJECT_ID/locations/REGION/jobTriggers/postgresql-table-comments",
"inspectJob": {
  "storageConfig": {
    "hybridOptions": {
      "description": "Hybrid job trigger for data from the comments field of a table that contains customer appointment bookings",
      "requiredFindingLabelKeys": [
        "appointment-bookings-comments"
      ],
      "labels": {
        "env": "prod"
      },
      "tableOptions": {
        "identifyingFields": [
          {
            "name": "booking_id"
          }
        ]
      }
    }
  },
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "EMAIL_ADDRESS"
      }
    ],
    "minLikelihood": "POSSIBLE",
    "limits": {},
    "includeQuote": true
  },
  "actions": [
    {
      "jobNotificationEmails": {}
    },
    {
      "publishToStackdriver": {}
    }
  ]
},
"triggers": [
  {
    "manual": {}
  }
],
"createTime": ""JOB_CREATION_DATETIME",
"updateTime": "TRIGGER_UPDATE_DATETIME",
"status": "HEALTHY"
}

Der Trigger für den Hybrid-Job wird durch Sensitive Data Protection erstellt. Die Ausgabe enthält den Namen des Hybridjob-Triggers. In diesem Beispiel ist das postgresql-table-comments. Notieren Sie sich den Namen. Sie benötigen ihn für Ihre hybridInspect-Anfrage.

Anders als bei Hybrid-Jobs werden Jobs in Hybrid-Job-Triggern von der DLP API automatisch am Ende jedes Tages beendet. Daher müssen Sie die Methode projects.locations.dlpJobs.finish nicht explizit aufrufen.

Wenn Sie einen Hybridjob oder einen Hybridjob-Trigger erstellen, können Sie den APIs Explorer auf den folgenden API-Referenzseiten verwenden:

Geben Sie im Feld Anfrageparameter den Wert projects/PROJECT_ID/locations/REGION ein. Fügen Sie dann im Feld Anfragetext den JSON-Beispielcode für das Objekt ein, das Sie erstellen möchten.

Eine erfolgreiche Anfrage, auch wenn sie im APIs Explorer erstellt wurde, erzeugt einen Hybridjob oder einen Hybridjob-Trigger.

Allgemeine Informationen zum Einsatz von JSON für das Senden von Anfragen an die DLP API finden Sie im JSON-Schnellstart.

Daten an den Hybridjob oder Hybridjob-Trigger senden

Wenn Sie Daten prüfen möchten, müssen Sie eine hybridInspect-Anfrage im richtigen Format an einen Hybridjob oder Hybridjob-Trigger senden.

Formatierung von Hybrid-Inhaltselementen

Im Folgenden finden Sie ein einfaches Beispiel für eine hybridInspect-Anfrage, die zur Verarbeitung durch einen Hybridjob oder Hybridjob-Trigger an Sensitive Data Protection gesendet wird. Beachten Sie die Struktur des JSON-Objekts, einschließlich des Felds hybridItem, das die folgenden Felder enthält:

item: Enthält den eigentlich zu prüfenden Inhalt.
findingDetails: Enthält Metadaten, die mit dem Inhalt verknüpft werden sollen.

{
  "hybridItem": {
    "item": {
      "value": "My email is test@example.org"
    },
    "findingDetails": {
      "containerDetails": {
        "fullPath": "10.0.0.2:logs1:app1",
        "relativePath": "app1",
        "rootPath": "10.0.0.2:logs1",
        "type": "logging_sys",
        "version": "1.2"
      },
      "labels": {
        "env": "prod",
        "appointment-bookings-comments": ""
      }
    }
  }
}

Ausführliche Informationen zum Inhalt von Hybrid-Prüfungselementen finden Sie im API-Referenzinhalt für das Objekt HybridContentItem.

Endpunkte für Hybridprüfungen

Damit Daten mit einem Hybridjob oder Hybridjob-Trigger geprüft werden können, müssen Sie eine hybridInspect-Anfrage an den richtigen Endpunkt senden.

HTTP-Methode und URL für hybride Jobs

POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/dlpJobs/JOB_ID:hybridInspect

Weitere Informationen zu diesem Endpunkt finden Sie auf der API-Referenzseite für die Methode projects.locations.dlpJobs.hybridInspect.

HTTP-Methode und URL für hybride Job-Trigger

https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobTriggers/TRIGGER_NAME:hybridInspect

Weitere Informationen zu diesem Endpunkt finden Sie auf der API-Referenzseite für die Methode projects.locations.jobTriggers.hybridInspect.

Ersetzen Sie Folgendes:

PROJECT_ID: Ihre Projekt-ID.
REGION: die geografische Region, in der Sie die hybridInspect-Anfrage speichern möchten. Diese Region muss mit der Region des Hybrid-Jobs übereinstimmen.
JOB_ID: Die ID, die Sie dem Hybrid-Job gegeben haben, mit dem Präfix i-.

Die Job-ID finden Sie unter Schutz sensibler Daten > Prüfung > Prüfjobs.
TRIGGER_NAME: der Name, den Sie dem Hybrid-Job-Trigger gegeben haben.

Wenn Sie den Namen des Job-Triggers nachschlagen möchten, klicken Sie unter Schutz sensibler Daten auf Überprüfung > Job-Trigger.

Labels für `hybridInspect`-Anfragen erforderlich

Wenn Sie steuern möchten, welche hybridInspect-Anfragen von einem Hybridjob oder Hybridjob-Trigger verarbeitet werden können, können Sie erforderliche Labels festlegen. Alle hybridInspect-Anfragen für diesen Hybridjob oder Hybridjob-Trigger, die nicht diese erforderlichen Labels enthalten, werden abgelehnt.

So legen Sie ein erforderliches Label fest:

Wenn Sie den Hybridjob oder den Hybridjob-Trigger erstellen, legen Sie das Feld requiredFindingLabelKeys auf eine Liste der erforderlichen Labels fest.

Im folgenden Beispiel wird appointment-bookings-comments als erforderliches Label in einem Hybridjob oder Hybridjob-Trigger festgelegt.
```
"hybridOptions": {
  ...
  "requiredFindingLabelKeys": [
    "appointment-bookings-comments"
  ],
  "labels": {
    "env": "prod"
  },
  ...
}
```
Fügen Sie in der hybridInspect-Anfrage im Feld labels jedes erforderliche Label als Schlüssel in einem Schlüssel/Wert-Paar hinzu. Der entsprechende Wert kann ein leerer String sein.

Im folgenden Beispiel wird das erforderliche Label appointment-bookings-comments in einer hybridInspect-Anfrage festgelegt.
```
{
  "hybridItem": {
    "item": {
      "value": "My email is test@example.org"
    },
    "findingDetails": {
      "containerDetails": {...},
      "labels": {
        "appointment-bookings-comments": ""
      }
    }
  }
}
```

Wenn Sie das erforderliche Label nicht in Ihre hybridInspect-Anfrage einfügen, erhalten Sie eine Fehlermeldung wie die folgende:

{
  "error": {
    "code": 400,
    "message": "Trigger required labels that were not included: [appointment-bookings-comments]",
    "status": "INVALID_ARGUMENT"
  }
}