您可以使用 Cloud Data Loss Prevention API 偵測圖片中的機密文字和物件,然後取得遮蓋後的圖片版本。在傳回的圖片中,偵測到的機密資料元素會以不透明矩形遮蓋。您可以使用 infoType 偵測工具,指定要偵測及遮蓋的資訊類型。
根據預設,Sensitive Data Protection 會使用黑色矩形遮蓋已遮蓋的內容,但您可以在圖片遮蓋設定中為每個 infoType 指定顏色。
遮蓋文字
Sensitive Data Protection 會使用物件字元辨識 (OCR) 偵測圖片中的文字。您可以遮蓋圖片中的下列內容:
舉例來說,請看以下圖片。原始圖片是包含聯絡資訊的文件。在這個範例中,Sensitive Data Protection 設定為遮蓋符合 PERSON_NAME、EMAIL_ADDRESS 和 PHONE_NUMBER infoType 的任何文字。產生的圖片會以黑色矩形遮蓋偵測到的機密文字。
物件遮蓋
您可以設定 Sensitive Data Protection,遮蓋通常含有機密資訊的物件。
舉例來說,請看以下圖片。原始圖片是 AI 生成的圖片,包含條碼、車牌和白板。在這個範例中,Sensitive Data Protection 設定為遮蓋符合 OBJECT_TYPE/BARCODE、OBJECT_TYPE/LICENSE_PLATE 和 OBJECT_TYPE/WHITEBOARD infoType 的物件。產生的圖片會以彩色矩形遮蓋偵測到的機密物件。每個 infoType 都會指派一種顏色。
如需可用的物件 infoType 偵測工具完整清單,請參閱「圖片中的物件」。
限制和注意事項
遮蓋圖片內容時,請注意下列事項。
支援的檔案類型
Sensitive Data Protection 可遮蓋多種圖片類型中的機密資料,包括 JPEG、BMP 和 PNG。如要瞭解哪些檔案類型支援遮蓋功能,哪些不支援,請參閱「支援的檔案類型」。
檢查設定限制
遮蓋圖片中的資料時,檢查設定中不得包含 limits。限制可能會導致非預期或不一致的結果,只有部分資料會遭到遮蓋。如果您在要求中設定 limits 欄位,Sensitive Data Protection 會產生錯誤。
事前準備
開始執行本頁的工作前,請先設定驗證機制,並取得必要的 IAM 權限。您可以使用 Google Cloud使用者帳戶或服務帳戶。無論採用哪種方式,請務必確認您使用的帳戶具備 serviceusage.services.use 權限的角色,例如 DLP 管理員 (roles/dlp.admin)、DLP 使用者 (roles/dlp.user) 或自訂角色。
-
請根據您打算如何使用本頁範例,選取對應的分頁標籤:
C#
如要在本機開發環境中使用本頁面的 .NET 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
-
安裝 Google Cloud CLI。
-
設定 gcloud CLI,使用您的聯合身分。
詳情請參閱「 使用聯合身分登入 gcloud CLI」。
-
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果傳回驗證錯誤,請確認您已 使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「 為本機開發環境設定 ADC」。
Go
如要在本機開發環境中使用本頁的 Go 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
-
安裝 Google Cloud CLI。
-
設定 gcloud CLI,使用您的聯合身分。
詳情請參閱「 使用聯合身分登入 gcloud CLI」。
-
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果傳回驗證錯誤,請確認您已 使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「 為本機開發環境設定 ADC」。
Java
如要在本機開發環境中使用本頁的 Java 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
-
安裝 Google Cloud CLI。
-
設定 gcloud CLI,使用您的聯合身分。
詳情請參閱「 使用聯合身分登入 gcloud CLI」。
-
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果傳回驗證錯誤,請確認您已 使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「 為本機開發環境設定 ADC」。
Node.js
如要在本機開發環境中使用本頁的 Node.js 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
-
安裝 Google Cloud CLI。
-
設定 gcloud CLI,使用您的聯合身分。
詳情請參閱「 使用聯合身分登入 gcloud CLI」。
-
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果傳回驗證錯誤,請確認您已 使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「 為本機開發環境設定 ADC」。
PHP
如要在本機開發環境中使用本頁的 PHP 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
-
安裝 Google Cloud CLI。
-
設定 gcloud CLI,使用您的聯合身分。
詳情請參閱「 使用聯合身分登入 gcloud CLI」。
-
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果傳回驗證錯誤,請確認您已 使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「 為本機開發環境設定 ADC」。
Python
如要在本機開發環境中使用本頁的 Python 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
-
安裝 Google Cloud CLI。
-
設定 gcloud CLI,使用您的聯合身分。
詳情請參閱「 使用聯合身分登入 gcloud CLI」。
-
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果傳回驗證錯誤,請確認您已 使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「 為本機開發環境設定 ADC」。
REST
如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。
安裝 Google Cloud CLI,然後 使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」一節。
image.redact方法也支援 API 金鑰。 如要使用 API 金鑰進行驗證,則無須設定本機應用程式預設憑證檔案。詳情請參閱 Google Cloud 驗證說明文件中的「建立 API 金鑰」。如要瞭解如何設定正式環境的驗證機制,請參閱 Google Cloud 驗證說明文件中的「 為在 Google Cloud上執行的程式碼設定應用程式預設憑證 」。
-
-
如要取得檢查、遮蓋及去識別化內容所需的權限,請要求管理員授予您專案的資料遺失防護使用者 (
roles/dlp.user) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
遮蓋圖片中的所有預設 infoType
如要遮蓋圖片中的機密資料,請將圖片提交至 DLP API 的 image.redact 方法。除非您指定要搜尋的特定資訊類型 (infoTypes),否則 Sensitive Data Protection 會搜尋最常見的 infoType。
預設 infoType 不包含圖片中的物件。
如要遮蓋圖片中的預設 infoType,請按照下列步驟操作:
將圖片編碼為 Base64 字串。
如果您打算使用其中一個 Sensitive Data Protection 用戶端程式庫執行這項工作,請略過這個步驟。
向
image.redact方法提交要求。如要遮蓋預設 infoType,要求只需包含以 Base64 編碼的圖片。
舉例來說,請看以下文件圖片。
如要遮蓋這張圖片中的預設 infoType,請將下列要求傳送至 DLP API 的 image.redact 方法:
C#
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
PHP
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
REST
{ "byteItem": { "data": "[BASE64-ENCODED-IMAGE]", "type": "IMAGE_PNG" } }
Sensitive Data Protection 會傳回下列內容:
{ "redactedImage": "[BASE64-ENCODED-IMAGE]" }
解碼 Base64 編碼圖片。
產生的圖片如下所示:
請注意,除了遮蓋手寫的身分證字號、電子郵件地址和電話號碼,Sensitive Data Protection 也遮蓋了年份。下一節將說明如何只遮蓋特定 infoType。
遮蓋圖片中的特定 infoType
如果只想遮蓋圖片中的特定機密資料,請指定對應的內建 infoType。
如要遮蓋圖片中的特定 infoType,請向 DLP API 的 image.redact 方法提交要求。要求必須包含下列內容:
- 圖片。
- 一或多個 infoType 偵測工具。
請參考上一節的原始圖片。如要僅遮蓋美國身分證字號、電子郵件地址和電話號碼,請將下列 JSON 傳送至 DLP API 的 image.redact 方法:
C#
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
PHP
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
REST
{ "byteItem": { "data": "[BASE64-ENCODED-IMAGE]", "type": "IMAGE_PNG" }, "imageRedactionConfigs": [ { "infoType": { "name": "PERSON_NAME" } }, { "infoType": { "name": "EMAIL_ADDRESS" } }, { "infoType": { "name": "PHONE_NUMBER" } } ] }
Sensitive Data Protection 會傳回下列內容:
{ "redactedImage": "[BASE64-ENCODED-IMAGE]" }
解碼 Base64 編碼圖片。
產生的圖片如下所示:
您可以依 infoType 為遮蓋資訊加上顏色代碼,以便一眼看出遮蓋內容。詳情請參閱下一節。
使用顏色編碼遮蓋圖片中的 infoType
如要依 infoType 為遮蓋資訊加上顏色代碼,請將 infoType 偵測工具與 RGB 色域值配對。
如要為從圖片中遮蓋的 infoType 加上顏色代碼,請向 DLP API 的 image.redact 方法提交要求。要求必須包含下列內容:
- 圖片。
- 一或多個 infoType 偵測工具,每個偵測工具都會使用 RGB 色域值指派顏色。
請參考第一節的原始圖片。如要使用紫色方塊遮蓋美國身分證字號、綠色方塊遮蓋電子郵件地址,以及橘色方塊遮蓋電話號碼,請將下列 JSON 傳送至 DLP API 的 image.redact 方法:
C#
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
PHP
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
REST
{ "byteItem": { "data": "[BASE64-ENCODED-IMAGE]", "type": "IMAGE_PNG" }, "imageRedactionConfigs": [ { "infoType": { "name": "PERSON_NAME" }, "redactionColor": { "red": 0.3, "green": 0.1, "blue": 0.6 } }, { "infoType": { "name": "EMAIL_ADDRESS" }, "redactionColor": { "red": 0.5, "blue": 0.5, "green": 1 } }, { "infoType": { "name": "PHONE_NUMBER" }, "redactionColor": { "red": 1, "blue": 0, "green": 0.6 } } ] }
Sensitive Data Protection 會傳回下列內容:
{ "redactedImage": "[BASE64-ENCODED-IMAGE]" }
解碼 Base64 編碼圖片。
產生的圖片如下所示:
遮蓋圖片中的所有文字
Sensitive Data Protection 也提供選項,可遮蓋圖片中偵測到的所有文字。
如要遮蓋圖片中的所有文字,請向 DLP API 的 image.redact 方法提交要求。要求必須包含下列資訊:
- 圖片。
redactAllText選項設為true。
請參考第一節的原始圖片。如要遮蓋所有文字,請將下列 JSON 傳送至 DLP API 的 image.redact 方法:
C#
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
PHP
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
REST
{ "byteItem": { "data": "[BASE64-ENCODED-IMAGE]", "type": "IMAGE_PNG" }, "imageRedactionConfigs": [ { "redactAllText": true } ] }
Sensitive Data Protection 會傳回下列內容:
{ "redactedImage": "[BASE64-ENCODED-IMAGE]" }
解碼 Base64 編碼圖片。
API 會傳回您提供的圖片,但根據您的條件,任何含有機密資訊的文字都會遭到遮蓋。
產生的圖片如下所示:
含有可能性設定的程式碼範例
這個範例與「遮蓋圖片中的特定 infoType」類似。此外,也示範如何指定最低可能性。
C#
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
PHP
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
如要瞭解如何安裝及使用 Sensitive Data Protection 的用戶端程式庫,請參閱「Sensitive Data Protection 用戶端程式庫」。
如要向 Sensitive Data Protection 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
立即體驗
您可以在 image.redact 參考頁面的 APIs Explorer 中,自行試用本頁的各個範例,或使用自己的圖片進行實驗:
後續步驟
- 進一步瞭解圖片檢查和遮蓋。
- 完成「使用 Sensitive Data Protection 遮蓋機密資料」程式碼實驗室。
- 瞭解如何檢查圖片是否含有機密資料。
- 進一步瞭解如何建立去識別化的儲存資料副本。