您可以使用模板创建和保留配置信息以用于 Cloud Data Loss Prevention。模板可用于将配置(如检查的内容和对内容进行去标识化的方式)与请求的实现分离。模板提供了一种可靠的方法,让您能够重复使用配置并在用户和数据集之间实现一致性。
Cloud DLP 支持两种类型的模板:
- 去标识化模板:用于保存去标识化作业配置信息的模板,包括 infoType 和记录(结构化数据集)转换。
- 检查模板:用于保留检查扫描作业配置信息的模板,包括要使用的预定义或自定义检测器。如需详细了解检查模板,请参阅创建 Cloud DLP 检查模板。
如需了解 Cloud DLP 中模板的相关概念,请参阅模板。
本主题的其余部分将向您介绍如何创建用于 Cloud DLP 的去标识化模板。
创建去标识化模板
值得注意的是,去标识化模板只是一种可重复使用的去标识化配置,外加一些元数据。在 API 术语中,DeidentifyTemplate
对象其实相当于包含更多元数据字段(如显示名和说明)的 DeidentifyConfig
对象。因此,要创建新的去标识化模板,基本步骤如下:
- 从
DeidentifyConfig
对象开始。 - 调用或通过 POST 发布
projects.deidentifyTemplates
资源的create
方法,在请求中包含一个带显示名、说明和该DeidentifyConfig
对象的DeidentifyTemplate
对象。
返回的 DeidentifyTemplate
立即可供使用。您可以通过其 name
在其他调用或作业中引用它。您可以通过调用 *.deidentifyTemplates.list
方法列出现有模板。如需查看特定模板,请调用 *.deidentifyTemplates.get
方法。请注意,可创建的模板数量上限为 1000。
如果您曾使用 Cloud DLP 对文本、图片或结构化内容中的敏感数据进行去标识化,则说明您已创建 DeidentifyConfig
对象。再执行一步,即可将其转换为 DeidentifyTemplate
对象。
REST 示例
下面的 JSON 示例展示了您可以向 projects.deidentifyTemplates.create
方法发送哪些内容。此 JSON 会创建一个具有给定显示名和说明的新模板,并依据 infoType EMAIL_ADDRESS
和 GENERIC_ID
扫描匹配项。如果找到与这些 infoType 匹配的内容,该 JSON 将使用星号 (*
) 字符遮盖前三个字符。
HTTP 方法和网址:
POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/deidentifyTemplates
将 PROJECT_ID
替换为项目 ID。
JSON 输入:
{
"deidentifyTemplate":{
"displayName":"Email and id masker",
"description":"De-identifies emails and ids with a series of asterisks.",
"deidentifyConfig":{
"infoTypeTransformations":{
"transformations":[
{
"infoTypes":[
{
"name":"GENERIC_ID"
}
],
"primitiveTransformation":{
"replaceWithInfoTypeConfig":{
}
}
},
{
"infoTypes":[
{
"name":"EMAIL_ADDRESS"
}
],
"primitiveTransformation":{
"characterMaskConfig":{
"charactersToIgnore":[
{
"charactersToSkip":"@"
}
],
"maskingCharacter":"*"
}
}
}
]
}
}
}
}
JSON 输出:
{ "name":"projects/PROJECT_ID/deidentifyTemplates/JOB-ID", "displayName":"Email and id masker", "description":"De-identifies emails and ids with a series of asterisks.", "createTime":"2018-11-30T07:17:59.536022Z", "updateTime":"2018-11-30T07:17:59.536022Z", "deidentifyConfig":{ "infoTypeTransformations":{ "transformations":[ { "infoTypes":[ { "name":"GENERIC_ID" } ], "primitiveTransformation":{ "replaceWithInfoTypeConfig":{ } } }, { "infoTypes":[ { "name":"EMAIL_ADDRESS" } ], "primitiveTransformation":{ "characterMaskConfig":{ "maskingCharacter":"*", "charactersToIgnore":[ { "charactersToSkip":"@" } ] } } } ] } } }
如需快速尝试此操作,您可以使用下面嵌入的 APIs Explorer。 如需了解有关如何使用 JSON 将请求发送到 DLP API 的一般信息,请参阅 JSON 快速入门。
使用去标识化模板
创建新模板后,您可以在任何可接受 deidentifyTemplateName
的位置使用其 name
标识符,例如:
projects.content.deidentify
:使用模板作为其配置,对内容中的潜在敏感数据进行去标识化。请注意,此方法可以使用检查模板或去标识化模板。
列出去标识化模板
如需列出已创建的所有去标识化模板,请使用任一 *.*.list
方法:
代码示例
下面是多种语言的示例代码,其中演示了如何使用 Cloud DLP 列出检查模板。此过程与列出去标识化模板的过程相同。
Java
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
Node.js
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
Python
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
Go
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
PHP
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
C#
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
删除去标识化模板
如需删除特定的去标识化模板,请使用任一 *.*.delete
方法:
无论使用哪种 *.*.delete
方法,均需添加要删除的模板的资源名称。
代码示例
下面是多种语言的示例代码,演示了如何使用 Cloud DLP 删除检查模板。此过程与列出去标识化模板的过程相同。
Java
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
Node.js
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
Python
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
Go
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
PHP
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。
C#
如需了解如何安装和使用 Cloud DLP 客户端库,请参阅 Cloud DLP 客户端库。