您可以使用範本建立及保留設定資訊,以便與 Sensitive Data Protection 搭配使用。範本很適合用於將檢查內容和去識別化方式等設定與要求的實作分離,範本不僅可以讓您重複使用設定,也能保持使用者和資料集之間的一致性。
Sensitive Data Protection 支援兩種範本:
- 去識別化範本:用於儲存去識別化工作設定資訊的範本,包括 infoType 和記錄 (結構化資料集) 轉換。
- 檢查範本:用於保留檢查掃描工作設定資訊的範本,包括要使用的預先定義或自訂偵測工具。如要進一步瞭解檢查範本,請參閱「建立 Sensitive Data Protection 檢查範本」。
如要瞭解 Sensitive Data Protection 範本的概念,請參閱「範本」。
本主題的其餘部分將說明如何建立去識別化範本,以便與 Sensitive Data Protection 搭配使用。
建立去識別化範本
控制台
前往 Google Cloud 控制台的「Create template」(建立範本) 頁面。
以下各節說明如何填寫「Create template」(建立範本) 頁面。
定義範本
在「定義範本」部分,按照下列指示填寫欄位:
- 在「範本類型」部分,選取「去識別化 (移除機密資料)」。
在「Data transformation type」(資料轉換類型) 部分,選取要套用的轉換類型:
InfoType 的內容。Sensitive Data Protection 只會對識別為特定 infoType 的值套用各項轉換。這項轉換類型適用於非結構化文字。
錄製。Sensitive Data Protection 套用轉換時,會考量資料的結構化格式。這種轉換類型適用於表格型資料。
圖片。Sensitive Data Protection 會遮蓋圖片中所有偵測到的文字,或僅遮蓋符合特定 infoType 的文字。
在「範本 ID」部分,輸入範本的專屬 ID。
在「顯示名稱」部分,輸入範本名稱。
在「說明」部分,輸入範本說明。
在「Resource location」(資源位置) 部分,選取「Global」(全域) 或要進行去識別化處理的資料位置。
按一下「繼續」。
設定去識別化作業
「Configure de-identification」(設定去識別化) 中顯示的欄位選項,取決於您選擇的資料轉換類型。
InfoType
如果選取「InfoType」InfoType做為資料轉換類型,請執行下列操作:
在「Transformation」(轉換) 欄位中,選取要套用至發現項目的轉換方法。
系統會根據您的選擇顯示更多欄位。視需要填寫欄位。詳情請參閱「轉換參考資料」。
在「InfoTypes to transform」(要轉換的 infoType) 部分,指定是否要將轉換套用至檢查設定中定義的所有偵測到的 infoType。
如果選取「Specify infoTypes」(指定 infoType),請選取要套用轉換方法的 infoType。
如要為轉換規則未涵蓋的 infoType 新增轉換規則,請按一下「Add transformation rule」(新增轉換規則)。然後視需要填寫欄位。重複執行這個步驟,直到為所有要轉換的 infoType 設定轉換規則。
點選「建立」。
錄製
如果選取「Record」(記錄) 做為資料轉換類型,請執行下列操作:
- 在「Field(s) or column(s) to transform」(要轉換的欄位或資料欄),輸入要轉換資料的資料表資料欄名稱。然後按下
ENTER。針對每個含有要轉換資料的資料欄,重複執行這個步驟。 指定轉換類型:
比對 infoType。Sensitive Data Protection 會將每個儲存格視為非結構化文字,並僅對在儲存格中找到的 infoType 套用轉換。Sensitive Data Protection 不會轉換 infoType 周圍的任何資料。
如果選取這個選項,請執行下列操作:
- 按一下「新增轉換」。在「Transformation」(轉換) 欄位中,選取要套用至發現項目的轉換方法。
指定是否要將轉換套用至檢查設定中定義的所有偵測到的 infoType。
如果選取「Specify infoTypes」(指定 infoType),請選取要套用轉換規則的 infoType。
如要將特定轉換規則指派給特定 infoType,可以視需要新增更多轉換。
原始欄位轉換。Sensitive Data Protection 一律會根據您選擇的轉換方法轉換整個儲存格。如要轉換整個資料欄,無論這些資料欄中的儲存格是否偵測到 infoType,這個選項都非常實用。
如果選取這個選項,請在「Transformation」(轉換) 欄位中,選取要套用至指定資料欄的轉換方法。
無論是哪一種情況,系統都會根據您選取的轉換方法顯示更多欄位。視需要填寫欄位。詳情請參閱「轉換參考資料」。
點選「建立」。
圖片
如果選取「Image」(圖片) 做為資料轉換類型,請執行下列操作:
選用:如要變更遮蓋編輯文字的方塊顏色,請按一下「Redaction color」(編輯顏色) 欄位中的黑色方塊,然後選擇其他顏色。
在「InfoTypes to transform」(要轉換的 infoType) 部分,指定要遮蓋的內容:所有偵測到的文字、檢查設定中定義的所有 infoType,或僅限特定 infoType。
如果選取「Specify infoTypes」(指定 infoType),請選取要套用轉換規則的 infoType。
如要為轉換規則未涵蓋的 infoType 新增轉換規則,請按一下「Add transformation rule」(新增轉換規則)。然後視需要填寫欄位。重複執行這個步驟,直到為所有要轉換的 infoType 設定轉換規則。
點選「建立」。
通訊協定
請注意,去識別化範本只是可重複使用的去識別化設定,加上一些中繼資料。以 API 術語來說,DeidentifyTemplate 物件實際上是 DeidentifyConfig 物件,其中包含更多中繼資料欄位,例如顯示名稱和說明。所以,建立新的去識別化範本的基本步驟包括:
- 首先,請建立
DeidentifyConfig物件。 - 呼叫或 POST
projects.deidentifyTemplates資源的create方法,並在要求中加入DeidentifyTemplate物件,其中包含顯示名稱、說明和DeidentifyConfig物件。
退回的DeidentifyTemplate可立即使用。您可以在其他呼叫或工作中,透過 name 參照該模型。您可以呼叫 *.deidentifyTemplates.list 方法,列出現有範本。如要查看特定範本,請呼叫 *.deidentifyTemplates.get 方法。請注意,您最多可以建立 1000 個範本。
如果您已使用 Sensitive Data Protection,從文字、圖片或結構化內容中去識別化機密資料,則您已建立 DeidentifyConfig 物件。再執行一個步驟,即可將其轉換為 DeidentifyTemplate 物件。
REST 範例
下列 JSON 是可傳送至 projects.deidentifyTemplates.create 方法的範例。這個 JSON 會建立新的範本,並指定顯示名稱和說明,然後掃描 infoType EMAIL_ADDRESS 和 GENERIC_ID 的相符項目。找到符合這些 infoType 的內容時,系統會以星號 (*) 遮蓋前三個字元。
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 方法:
本節說明如何使用 Sensitive Data Protection 列出檢查範本。這個程序與列出去識別化範本的程序相同。
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 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
刪除去識別化範本
如要刪除特定去識別化範本,請使用下列其中一種 *.*.delete 方法:
使用每個 *.*.delete 方法時,請加入要刪除的範本資源名稱。
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 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。