Phần mở rộng ngăn chặn mất dữ liệu của Google Cloud

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. Thông tin

Phiên bản: 2.0.2

Sử dụng tiện ích này để che khuất dữ liệu nhạy cảm trong nội dung và hình ảnh. Ví dụ: bạn có thể che số thẻ tín dụng, tên và số an sinh xã hội.

Điều kiện tiên quyết

Nội dung này cung cấp thông tin tham khảo để định cấu hình và sử dụng tiện ích này. Trước khi sử dụng tiện ích từ một proxy API bằng chính sách ExtensionCallout, bạn phải:

1. Bật Google Cloud DLP API cho dự án của bạn.

2. Cấp quyền cho cấp độ truy cập mà bạn muốn cấp cho tiện ích.

3. Sử dụng Google Cloud Console để tạo khoá cho tài khoản dịch vụ.

4. Sử dụng nội dung của tệp JSON khoá thu được khi thêm và định cấu hình tiện ích bằng cách sử dụng tài liệu tham khảo về cấu hình.

Giới thiệu về Cloud Data Loss Prevention (DLP)

Cloud Data Loss Prevention (DLP) là một API để kiểm tra văn bản, hình ảnh và các dữ liệu khác nhằm xác định và quản lý dữ liệu nhạy cảm.

Để biết thêm thông tin, hãy xem bài viết Tổng quan về DLP. Để tham khảo API mà tiện ích này cung cấp, hãy xem API Ngăn chặn mất dữ liệu (DLP) trên đám mây.

Mẫu

Các ví dụ sau đây minh hoạ cách định cấu hình chế độ hỗ trợ cho các thao tác của tiện ích Cloud DLP bằng cách sử dụng chính sách ExtensionCallout.

Để giúp bạn dễ dàng dùng thử mã mẫu này, các ví dụ này sử dụng chính sách AssignMessage để đặt giá trị biến luồng và truy xuất giá trị phản hồi của tiện ích để hiển thị trong Công cụ theo dõi.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Set-Variable">
    <DisplayName>Set Variable</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <AssignVariable>
        <Name>request.content</Name>
        <Value>Visit my site at https://example.com. Or contact me at gladys@example.com.</Value>
    </AssignVariable>
</AssignMessage>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Data-Loss-Extension-Callout">
    <DisplayName>Data Loss Prevention Extension Callout</DisplayName>
    <Connector>example-dlp</Connector>
    <Action>deidentifyWithMask</Action>
    <Input><![CDATA[{
        "text" : "{request.content}",
        "mask" : "*"
    }]]></Input>
    <Output>masked.output</Output>
</ConnectorCallout>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-DLP-Output">
    <DisplayName>Get DLP Output</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <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" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Set-Variable">
    <DisplayName>Set Variable</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <AssignVariable>
        <Name>request.content</Name>
        <Value>Visit my site at https://example.com. Or contact me at gladys@example.com.</Value>
    </AssignVariable>
</AssignMessage>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Data-Loss-Extension-Callout">
    <DisplayName>Data Loss Prevention Extension Callout</DisplayName>
    <Connector>example-dlp</Connector>
    <Action>deidentifyWithType</Action>
    <Input><![CDATA[{
        "text" : "{request.content}"
    }]]></Input>
    <Output>masked.output</Output>
</ConnectorCallout>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-DLP-Output">
    <DisplayName>Get DLP Output</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{masked.output}</Payload>
    </Set>
</AssignMessage>

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

Thao tác

deidentifyWithMask

Xoá thông tin nhận dạng dữ liệu nhạy cảm khỏi text và che dữ liệu bằng ký tự mask. Thao tác này sẽ che những phần của text do thuộc tính infoTypes chỉ định trong cấu hình tiện ích.

Việc che dữ liệu nhạy cảm sẽ thay thế các ký tự bằng một biểu tượng, chẳng hạn như dấu hoa thị (*) hoặc dấu thăng (#). Bạn có thể định cấu hình các loại dữ liệu nhạy cảm trong cấu hình tiện ích.

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

<Action>deidentifyWithMask</Action>
<Input><![CDATA[{
    "text" : "{input.email.address}",
    "mask" : "*"
}]]></Input>
<Output>masked.output</Output>

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

Tham số yêu cầu

Phản hồi

Văn bản đầu vào có các giá trị của infoTypes được chỉ định thay thế bằng ký tự được chỉ định. Ví dụ:

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

deidentifyWithTemplate

Xoá thông tin nhận dạng dữ liệu nhạy cảm trong nội dung văn bản bằng cách sử dụng một mẫu định cấu hình văn bản cần xoá thông tin nhận dạng và cách xử lý văn bản đó.

Mẫu rất hữu ích cho việc tách cấu hình (chẳng hạn như những gì bạn kiểm tra và cách bạn xoá thông tin nhận dạng) khỏi quá trình triển khai các lệnh gọi API. Mẫu là một cách để sử dụng lại cấu hình và đảm bảo tính nhất quán giữa người dùng và tập dữ liệu.

Trong mẫu, bạn sẽ chỉ định infoTypes đại diện cho nội dung cần được gỡ bỏ thông tin nhận dạng. Để xem danh sách infoType, hãy xem Tài liệu tham khảo về trình phát hiện InfoType. Mặt nạ khử nhận dạng những phần văn bản do thuộc tính infoTypes chỉ định trong mẫu.

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

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

Tham số yêu cầu

Phản hồi

Văn bản đầu vào có các giá trị của infoTypes được chỉ định được thay thế bằng tên infoType.

deidentifyWithType

Xoá thông tin nhận dạng dữ liệu nhạy cảm trong nội dung văn bản, thay thế mỗi giá trị trùng khớp bằng tên của infoType. Để xem danh sách infoType, hãy xem Tài liệu tham khảo về trình phát hiện InfoType. Thao tác này sẽ che những phần của text do thuộc tính infoTypes chỉ định trong cấu hình tiện ích.

Trong ví dụ sau, số điện thoại được dịch vụ nhận dạng, sau đó được thay thế bằng tên của chính infoType.

• Văn bản đầu vào:

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

• Văn bản kết quả:

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

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

<Action>deidentifyWithType</Action>
<Input><![CDATA[{
    "text" : "{input.email.address}"
}]]></Input>

{"text":"EMAIL_ADDRESS"}

Tham số yêu cầu

Phản hồi

Văn bản đầu vào có các giá trị của infoTypes được chỉ định được thay thế bằng tên infoType. Ví dụ:

{"text":"EMAIL_ADDRESS"}

redactImage

Loại bỏ văn bản thuộc một trong các danh mục infoType. Nội dung bị che khuất sẽ được phát hiện và làm mờ bằng một hình chữ nhật mờ. Thao tác này sẽ che những phần của image_data do thuộc tính infoTypes chỉ định trong cấu hình tiện ích.

Để xem danh sách infoType, hãy xem Tài liệu tham khảo về trình phát hiện InfoType.

Tham số yêu cầu

<Action>redactImage</Action>
<Input><![CDATA[{
  "image_data" : "base64-encoded-image-to-analyze",
  "image_type" : "type-of-image"
}]]></Input>

Phản hồi

Hình ảnh có văn bản đã được che khuất.

Tài liệu tham khảo về cấu hình

Hãy sử dụng những thông tin sau khi bạn định cấu hình và triển khai tiện ích này để sử dụng trong các proxy API. Để biết các bước định cấu hình một tiện ích bằng bảng điều khiển Apigee, hãy xem phần Thêm và định cấu hình tiện ích.

Thuộc tính mở rộng chung

Các thuộc tính sau có sẵn cho mỗi tiện ích.

Các thuộc tính cho gói tiện ích này

Chỉ định các giá trị cho các thuộc tính cấu hình sau đây dành riêng cho tiện ích này.