使用 DLP API 检查敏感文本
了解如何使用 Cloud Data Loss Prevention API（Sensitive Data Protection 的一部分）和 JSON 扫描示例字符串，检查是否存在敏感信息。
如需在 Google Cloud 控制台中直接遵循有关此任务的分步指导，请点击操作演示:
准备工作
- 登录您的 Google Cloud 账号。如果您是新手 Google Cloud， 请创建一个账号来评估我们的产品在 实际场景中的表现。新客户还可获享 $300 赠金，用于 运行、测试和部署工作负载。
-
安装 Google Cloud CLI。
-
如果您使用的是外部身份提供方 (IdP)，则必须先 使用联合身份登录 gcloud CLI。
-
如需初始化 gcloud CLI，请运行以下命令：
gcloud init -
选择或创建项目所需角色
- 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
-
创建项目：如需创建项目，您需要 Project Creator 角色
(
roles/resourcemanager.projectCreator)，该角色包含resourcemanager.projects.create权限。了解如何授予 角色。
-
创建 Google Cloud 项目：
gcloud projects create PROJECT_ID
将
PROJECT_ID替换为您要创建的 Google Cloud 项目的名称。 -
选择您创建的 Google Cloud 项目：
gcloud config set project PROJECT_ID
将
PROJECT_ID替换为您的 Google Cloud 项目名称。
-
验证是否已为您的 Google Cloud 项目启用结算功能。
启用 DLP API（如果尚未启用）：
启用 API 所需的角色
如需启用 API，您需要拥有
serviceusage.services.enable权限。如果您已创建项目，则可能已通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。gcloud services enable dlp.googleapis.com
-
将角色授予您的用户账号。对以下每个 IAM 角色运行以下命令一次：
roles/dlp.usergcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
替换以下内容：
PROJECT_ID：您的项目 ID。USER_IDENTIFIER：您的用户账号的标识符。 例如，myemail@example.com。ROLE：您授予用户账号的 IAM 角色。
-
安装 Google Cloud CLI。
-
如果您使用的是外部身份提供方 (IdP)，则必须先 使用联合身份登录 gcloud CLI。
-
如需初始化 gcloud CLI，请运行以下命令：
gcloud init -
选择或创建项目所需角色
- 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
-
创建项目：如需创建项目，您需要 Project Creator 角色
(
roles/resourcemanager.projectCreator)，该角色包含resourcemanager.projects.create权限。了解如何授予 角色。
-
创建 Google Cloud 项目：
gcloud projects create PROJECT_ID
将
PROJECT_ID替换为您要创建的 Google Cloud 项目的名称。 -
选择您创建的 Google Cloud 项目：
gcloud config set project PROJECT_ID
将
PROJECT_ID替换为您的 Google Cloud 项目名称。
-
验证是否已为您的 Google Cloud 项目启用结算功能。
启用 DLP API（如果尚未启用）：
启用 API 所需的角色
如需启用 API，您需要拥有
serviceusage.services.enable权限。如果您已创建项目，则可能已通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。gcloud services enable dlp.googleapis.com
-
将角色授予您的用户账号。对以下每个 IAM 角色运行以下命令一次：
roles/dlp.usergcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
替换以下内容：
PROJECT_ID：您的项目 ID。USER_IDENTIFIER：您的用户账号的标识符。 例如，myemail@example.com。ROLE：您授予用户账号的 IAM 角色。
检查字符串是否存在敏感信息
本部分介绍如何配置 DLP API 以使用
示例文本扫描 projects.content.inspect
REST 方法。
本部分要求您将示例请求保存到 JSON 文件中。如果您使用的是 Cloud Shell，则可以使用 Cloud Shell Editor 创建该文件。如需启动编辑器，请点击 打开编辑器 Cloud Shell 窗口工具栏上。
在使用任何请求数据之前， 请先进行以下替换：
-
PROJECT_ID：您的 Google Cloud 项目 ID。项目 ID 是 字母数字字符串，例如my-project。
HTTP 方法和网址：
POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/content:inspect
请求 JSON 正文：
{
"item": {
"value": "My phone number is (800) 555-0123."
},
"inspectConfig": {
"infoTypes": [
{
"name": "PHONE_NUMBER"
},
{
"name": "US_TOLLFREE_PHONE_NUMBER"
}
],
"minLikelihood": "POSSIBLE",
"limits": {
"maxFindingsPerItem": 0
},
"includeQuote": true
}
}
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"result": {
"findings": [
{
"quote": "(800) 555-0123",
"infoType": {
"name": "US_TOLLFREE_PHONE_NUMBER"
},
"likelihood": "LIKELY",
"location": {
"byteRange": {
"start": "19",
"end": "33"
},
"codepointRange": {
"start": "19",
"end": "33"
}
},
"createTime": "2022-09-23T01:53:05.303Z",
"findingId": "2022-09-23T01:53:05.306348Z5328915744504121862"
}
]
}
}清理
为避免因本页面中使用的资源导致您的 Google Cloud 账号产生费用，请删除包含这些资源的 Google Cloud 项目。
删除项目
如果您为本快速入门创建了一个新项目，则避免产生额外费用的最简单方法是删除该项目。
删除 Google Cloud 项目：
gcloud projects delete PROJECT_ID
撤销认证
可选：从 gcloud CLI 撤消凭据。
gcloud auth revoke