Расширение для предотвращения потери данных в облаке Google

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

Версия: 1.5.1

Используйте это расширение, чтобы скрыть конфиденциальные данные из контента и изображений. Например, вы можете изменить номера кредитных карт, имена и номера социального страхования.

Предварительные условия

Этот контент содержит информацию по настройке и использованию этого расширения. Прежде чем использовать расширение из API-прокси с помощью политики ExtensionCallout , необходимо:

1. Включите API Google Cloud DLP для своего проекта.

2. Предоставьте разрешение на тот уровень доступа, который вам нужен для расширения.

3. Используйте консоль GCP для создания ключа для учетной записи службы .

4. Используйте содержимое полученного ключевого файла JSON при добавлении и настройке расширения с помощью справочника по конфигурации .

О предотвращении потери данных в облаке (DLP)

Cloud Data Loss Prevention (DLP) — это API для проверки текста, изображений и других данных с целью выявления конфиденциальных данных и управления ими.

Дополнительную информацию см. в обзоре DLP . Сведения об API, предоставляемом этим расширением, см. в разделе Cloud Data Loss Prevention (DLP) API .

Образцы

В следующих примерах показано, как настроить поддержку действий расширения Cloud DLP с помощью политики ExtensionCallout .

Чтобы упростить работу с этим примером кода, в этих примерах используется политика AssignMessage для установки значений переменных потока и получения значений ответа расширения для отображения в инструменте трассировки .

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

Действия

деидентификация с маской

Деидентифицируйте конфиденциальные данные из text и замаскируйте данные символом mask . Это действие маскирует те части text , которые указаны свойством infoTypes в конфигурации расширения .

При маскировке конфиденциальных данных символы заменяются символами, например звездочкой (*) или решёткой (#). Типы конфиденциальных данных можно настроить в конфигурации расширения.

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

Параметры запроса

Ответ

Входной текст со значениями указанных инфо-типов заменен указанным символом. Например,

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

деидентифицироватьстемплате

Деидентифицируйте конфиденциальные данные в текстовом содержимом с помощью шаблона, который определяет, какой текст деидентифицировать и как с ним обращаться.

Шаблоны полезны для отделения конфигурации, например того, что вы проверяете и как вы деидентифицируете это, от реализации вызовов API. Шаблоны позволяют повторно использовать конфигурацию и обеспечивают согласованность между пользователями и наборами данных.

В вашем шаблоне вы укажете infoTypes, представляющие контент, который нужно деидентифицировать. Список инфо-типов см. в справочнике по детекторам InfoType . Деидентификация маскирует те части текста, которые указаны свойством infoTypes в шаблоне.

<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

Параметры запроса

Ответ

Входной текст со значениями указанных инфо-типов заменен именами инфо-типов.

деидентифицироватьстипе

Деидентифицируйте конфиденциальные данные в текстовом содержимом, заменяя каждое совпадающее значение именем infoType. Список инфо-типов см. в справочнике по детекторам InfoType . Это действие маскирует те части text , которые указаны свойством infoTypes в конфигурации расширения .

В следующем примере номер телефона распознается службой, а затем заменяется именем самого infoType.

• Введите текст:

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

• Текст результата:

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

Параметры запроса

Ответ

Входной текст со значениями указанных инфо-типов заменен именами инфо-типов. Например,

{"text":"EMAIL_ADDRESS"}

РедактироватьИзображение

Редактируйте текст, который попадает в одну из категорий infoType. Отредактированное содержимое обнаруживается и закрывается непрозрачным прямоугольником. Это действие маскирует те части image_data , которые указаны свойством infoTypes в конфигурации расширения .

Список инфо-типов см. в справочнике по детекторам InfoType .

Параметры запроса

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

Ответ

Изображение с отредактированным текстом.

Справочник по конфигурации

Используйте следующее при настройке и развертывании этого расширения для использования в прокси-серверах API. Инструкции по настройке расширения с помощью консоли Apigee см. в разделе Добавление и настройка расширения .

Общие свойства расширения

Следующие свойства присутствуют для каждого расширения.

Свойства этого пакета расширений

Укажите значения для следующих свойств конфигурации, специфичных для этого расширения.