Rozszerzenie Google Cloud Data Loss Prevention

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Wersja: 1.5.1

Użyj tego rozszerzenia, aby ukryć dane wrażliwe w treściach i obrazach. Możesz na przykład zamazywać numery kart kredytowych, imiona i nazwiska oraz numery PESEL.

Wymagania wstępne

Te treści zawierają informacje na temat konfigurowania i używania tego rozszerzenia. Zanim użyjesz rozszerzenia z serwera proxy interfejsu API przy użyciu zasad dotyczących rozszerzeń, musisz:

1. Włącz interfejs Google Cloud DLP API w projekcie.

2. Przyznaj uprawnienia dla odpowiedniego poziomu dostępu, jaki chcesz przyznać rozszerzeniu.

3. Wygeneruj klucz konta usługi w konsoli GCP.

4. Użyj zawartości utworzonego pliku klucza JSON podczas dodawania i konfigurowania rozszerzenia za pomocą dokumentacji konfiguracji.

Zapobieganie utracie danych w usłudze Cloud Data Loss Prevention (DLP)

Cloud Data Loss Prevention (DLP) to interfejs API do sprawdzania tekstu, obrazów i innych danych w celu identyfikowania danych wrażliwych i zarządzania nimi.

Więcej informacji znajdziesz w artykule Omówienie funkcji zapobiegania utracie danych (DLP). Informacje o interfejsie API udostępnianym przez to rozszerzenie znajdziesz w sekcji Cloud Data Loss Prevention (DLP) API.

Przykłady

Poniższe przykłady pokazują, jak skonfigurować obsługę działań rozszerzenia Cloud DLP za pomocą zapisu ExtensionCalloutPolicy.

Aby ułatwić testowanie tego przykładowego kodu, w tych przykładach użyto zapisu wiadomości przypisanej do ustawiania wartości zmiennych przepływu i pobierania wartości odpowiedzi rozszerzenia do wyświetlania w narzędziu do śledzenia.

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
AssignMessage async="false" continueOnError=&q>uot;f<alse" >enabled=&quo<t;true"> name<="Set-Variable"
    DisplayNameSe>t Var<iable/DisplayN>ame
    A<ssig>nTo type="<respo>nse"< crea>teNew="false"/
    AssignVariable
        Namerequest.content/Na<me
   >     <ValueVisit my s>i<te at https://>example.com. Or contact me at gladys@example.com./Value
    /AssignVariable
/AssignMessage

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ConnectorCallout async="false" continueOnError="true"> enab<led="t>rue" name="Data-Loss-Extensi<on-Callout&q>uot;
<    Displ>ayNameData <Loss Preve>ntion< Exten>sion Callout/Displ<ayName
>    C<onnec><torexample-dlp/Connector
    ActiondeidentifyWithMask/Action
    Input![CDAT><A[{
  >     < "text" :< ">{<request.content}&>quot;,
        "mask" : "*"
    }]]/Input
    Outputmasked.output/Output
/ConnectorCallout

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
AssignMessage async="false" continueOnError=&quo>t;fal<se" en>abled="tr<ue" nam>e=&qu<ot;Get-DLP-Output"
    DisplayNameGet >DLP O<utp>ut/Displa<yName
    AssignTo type="response>" createNe<w=">false<&quo>t<;/
    Set
   >     Payload contentType="application/json"{masked.output}/Payload
    /Set
/AssignMessage

{"text":"Visit my site at ******************* Or contact me at *****************."}

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
AssignMessage async="false" continueOnError=&q>uot;f<alse" >enabled=&quo<t;true"> name<="Set-Variable"
    DisplayNameSe>t Var<iable/DisplayN>ame
    A<ssig>nTo type="<respo>nse"< crea>teNew="false"/
    AssignVariable
        Namerequest.content/Na<me
   >     <ValueVisit my s>i<te at https://>example.com. Or contact me at gladys@example.com./Value
    /AssignVariable
/AssignMessage

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ConnectorCallout async="false" continueOnError="true"> enab<led="t>rue" name="Data-Loss-Extensi<on-Callout&q>uot;
<    Displ>ayNameData <Loss Preve>ntion< Exten>sion Callout/Displ<ayName
>    C<onnec><torexample-dlp/Connector
    ActiondeidentifyWithType/><Action>
    <Input!>[CDATA[{
    <    &quo<t;text" : &q>uot;{request.content}"
    }]]/Input
    Outputmasked.output/Output
/ConnectorCallout

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
AssignMessage async="false" continueOnError=&quo>t;fal<se" en>abled="tr<ue" nam>e=&qu<ot;Get-DLP-Output"
    DisplayNameGet >DLP O<utp>ut/Displa<yName
    AssignTo type="response>" createNe<w=">false<&quo>t<;/
    Set
   >     Payload contentType="application/json"{masked.output}/Payload
    /Set
/AssignMessage

{"text":"Visit my site at [URL] Or contact me at [EMAIL_ADDRESS]."}

Działania

deidentifyWithMask

Deidentyfikuj dane wrażliwe z poziomu text i zamaskuj je za pomocą znaku mask. To działanie maskuje te części text, które są określone przez właściwość infoTypes w konfiguracji rozszerzenia.

Zamaskowanie danych wrażliwych polega na zastąpieniu znaków symbolem, np. gwiazdką (*) lub znakiem #. Typy danych wrażliwych można skonfigurować w konfiguracji rozszerzenia.

<Action>deidentifyWithMask</Action>
<Input><![CDATA[{
  "text" : "text-to-deidentify",
  "mask&q><uot; :> "masking-character"
}]]/Input

<Action>deidentifyWithMask</Action>
<Input><![CDATA[{
    "text" : "{input.email.address}",
><    &q>u<ot;mas>k" : &qu<ot;*&qu>ot;
}]]/Input
Outputmasked.output/Output

{"text":"*****************"}

Parametry żądania

Odpowiedź

Tekst wejściowy z wartościami obiektów infoType zastąpionymi określonym znakiem. Na przykład

{"text":"*********"}

deidentifyWithTemplate

Deidentyfikuj dane wrażliwe w treści tekstowej, korzystając z szablonu, który konfiguruje, jaki tekst ma zostać zdeidentyfikowany i jak go przetworzyć.

Szablony są przydatne do rozdzielenia konfiguracji, np. tego, co sprawdzasz i jak deidentyfikujesz, od implementacji wywołań interfejsu API. Szablony umożliwiają ponowne używanie konfiguracji i zapewniają spójność wśród użytkowników i zbiorów danych.

W szablonie musisz określić infoTypes reprezentujące treści, które mają zostać zdeidentyfikowane. Listę obiektów infoType znajdziesz w sekcji Informacje o wzorcach do wykrywania typu InfoType. Funkcja deidentyfikowania maskuje te części tekstu, które są określone przez właściwość infoTypes w szablonie.

<Action>deidentifyWithTemplate</Action>
<Input><![CDATA[{
  "text" : "text-to-deidentify"
  "templateName&><quot; >: "path-to-template"
}]]/Input

<Action>deidentifyWithTemplate</Action>
<Input><![CDATA[{
    "text" : "{request.content}"
    "templateName" : "projects/[PROJECT_ID]/dei><dentif>yTemplates/1231258663242"
}]]/Input

Parametry żądania

Odpowiedź

Tekst wejściowy z wartościami określonych obiektów infoType zastąpionych nazwami tych obiektów.

deidentifyWithType

Deidentyfikuj dane wrażliwe w treści tekstowej, zastępując każdą dopasowaną wartość nazwą obiektu infoType. Listę obiektów infoType znajdziesz w sekcji Informacje o wzorcach do wykrywania typu InfoType. To działanie maskuje te części text, które są określone przez właściwość infoTypes w konfiguracji rozszerzenia.

W tym przykładzie usługa rozpoznaje numer telefonu, a następnie zastępuje go nazwą obiektu infoType.

• Wprowadzany tekst:

  John Smith, 123 Main St, Seattle, WA 98122, 206-555-0123.

• Tekst wyniku:

  John Smith, 123 Main St, Seattle, WA 98122, PHONE_NUMBER.

<Action>deidentifyWithType</Action>
<Input><![CDATA[{
  "text" : "text-to-><deiden>tify"
}]]/Input

<Action>deidentifyWithType</Action>
<Input><![CDATA[{
    "text" : "{input.emai><l.addr>ess}"
}]]/Input

{"text":"EMAIL_ADDRESS"}

Parametry żądania

Odpowiedź

Tekst wejściowy z wartościami określonych obiektów infoType zastąpionych nazwami tych obiektów. Na przykład

{"text":"EMAIL_ADDRESS"}

redactImage

Zasłoń tekst, który należy do jednej z kategorii infoType. Treści usunięte są wykrywane i zaciemniane za pomocą nieprzezroczystego prostokąta. To działanie maskuje te części image_data, które są określone przez właściwość infoTypes w konfiguracji rozszerzenia.

Listę obiektów infoType znajdziesz w sekcji Informacje o wzorcach do wykrywania typu InfoType.

Parametry żądania

<Action>redactImage</Action>
<Input><![CDATA[{
  "image_data" : "base64-encoded-image-to-analyze",
  "image_ty><pe&quo>t; : "type-of-image"
}]]/Input

Odpowiedź

Obraz z usuniętym tekstem.

Informacje o konfiguracji

Podczas konfigurowania i wdrażania tego rozszerzenia do użycia w serwerach proxy API postępuj zgodnie z tymi instrukcjami. Instrukcje konfigurowania rozszerzenia za pomocą konsoli Apigee znajdziesz w artykule Dodawanie i konfigurowanie rozszerzenia.

Właściwości wspólne rozszerzeń

Dla każdego rozszerzenia dostępne są poniższe właściwości.

Właściwości tego pakietu rozszerzeń

Podaj wartości tych właściwości konfiguracji, które są specyficzne dla tego rozszerzenia.