אתם יכולים להשתמש בתבניות כדי ליצור ולשמור פרטי הגדרות לשימוש ב-Sensitive Data Protection. התבניות שימושיות להפרדת ההגדרות, כמו מה שאתם בודקים ואיך אתם מסירים את פרטי הזיהוי, מההטמעה של הבקשות שלכם. תבניות הן דרך יעילה לשימוש חוזר בהגדרות, והן מאפשרות עקביות בין משתמשים וקבוצות נתונים.
ב-Sensitive Data Protection יש שני סוגים של תבניות:
- תבניות להסרת פרטי זיהוי: תבניות לשמירת פרטי ההגדרות של משימות להסרת פרטי זיהוי, כולל טרנספורמציות של infoType ושל רשומות (מערך נתונים מובנה).
- תבניות בדיקה: תבניות לשמירת פרטי ההגדרות של משימות סריקה לבדיקה, כולל הגלאים המוגדרים מראש או המותאמים אישית שבהם צריך להשתמש. מידע נוסף על תבניות בדיקה זמין במאמר יצירת תבניות בדיקה של Sensitive Data Protection.
למידע על תבניות ב-Sensitive Data Protection, קראו את המאמר תבניות.
בהמשך הנושא נסביר איך ליצור תבניות להסרת פרטים מזהים לשימוש עם Sensitive Data Protection.
יצירת תבנית להסרת פרטים מזהים
המסוף
נכנסים לדף Create template במסוף Google Cloud .
בקטעים הבאים מוסבר איך למלא את הדף Create template (יצירת תבנית).
הגדרת תבנית
בקטע Define template, ממלאים את השדות באופן הבא:
- בשדה Template type, בוחרים באפשרות להסיר פרטי זיהוי (remove sensitive data).
בקטע Data transformation type, בוחרים את סוג הטרנספורמציה שרוצים להחיל:
InfoType. Sensitive Data Protection מחיל כל טרנספורמציה רק על הערך שזוהה כ-infoType הספציפי. סוג הטרנספורמציה הזה שימושי לטקסט לא מובנה.
הקלטה. Sensitive Data Protection מתייחס לפורמט המובנה של הנתונים כשהוא מחיל טרנספורמציה. סוג הטרנספורמציה הזה שימושי לנתונים בטבלה.
תמונה. Sensitive Data Protection מצנזר את כל הטקסט שזוהה בתמונה, או רק טקסט שתואם ל-infoType ספציפי.
בשדה מזהה תבנית, מזינים מזהה ייחודי לתבנית.
בקטע שם לתצוגה, נותנים שם לתבנית.
בשדה Description, מתארים את התבנית.
בשדה Resource location, בוחרים באפשרות Global או במיקום של הנתונים שרוצים להסיר מהם את פרטי הזיהוי.
לוחצים על Continue.
הגדרת הסרת פרטי הזיהוי
השדות שמופיעים בקטע Configure de-identification תלויים בסוג הטרנספורמציה של הנתונים שבחרתם.
InfoType
אם בחרתם באפשרות InfoType כסוג הטרנספורמציה של הנתונים, בצעו את הפעולות הבאות:
בשדה Transformation, בוחרים שיטת טרנספורמציה להחלה על הממצאים.
יופיעו שדות נוספים בהתאם לבחירה שלכם. ממלאים את השדות לפי הצורך. מידע נוסף זמין במאמר הפניות לטרנספורמציה.
בקטע InfoTypes to transform, מציינים אם רוצים להחיל את הטרנספורמציה על כל סוגי המידע שזוהו ומוגדרים בהגדרות הבדיקה.
אם בוחרים באפשרות Specify infoTypes, בוחרים את סוגי המידע שעליהם רוצים להחיל את שיטת הטרנספורמציה.
אם רוצים להוסיף כללי טרנספורמציה לסוגי מידע שלא נכללים בכלל הטרנספורמציה, לוחצים על Add transformation rule. אחר כך ממלאים את השדות לפי הצורך. חוזרים על השלב הזה עד שמגדירים כלל טרנספורמציה לכל סוגי המידע שרוצים לשנות.
לוחצים על יצירה.
הקלטה
אם בחרתם באפשרות רשומה בתור סוג הטרנספורמציה של הנתונים, בצעו את הפעולות הבאות:
- בשדה Field(s) or column(s) to transform, מקלידים את שם העמודה בטבלה שמכילה את הנתונים שרוצים לשנות. ואז לוחצים על
ENTER. חוזרים על השלב הזה לכל עמודה שמכילה נתונים שרוצים לשנות. מציינים את סוג הטרנספורמציה:
התאמה לפי infoType. ב-Sensitive Data Protection, כל תא מטופל כטקסט לא מובנה, והטרנספורמציה חלה רק על סוגי המידע שנמצאים בתא. Sensitive Data Protection לא משנה נתונים שקשורים ל-infoType.
אם בוחרים באפשרות הזו, צריך לבצע את הפעולות הבאות:
- לוחצים על הוספת טרנספורמציה. בשדה Transformation, בוחרים שיטת טרנספורמציה כדי להחיל על הממצאים.
מציינים אם רוצים להחיל את הטרנספורמציה על כל סוגי המידע שזוהו ושהוגדרו בהגדרות הבדיקה.
אם בוחרים באפשרות Specify infoTypes, בוחרים את סוגי המידע שרוצים להחיל עליהם את כלל הטרנספורמציה.
אם רוצים להקצות כללי טרנספורמציה מסוימים לטיפוסי מידע מסוימים, אפשר להוסיף עוד טרנספורמציות לפי הצורך.
טרנספורמציה של שדה פרימיטיבי. Sensitive Data Protection תמיד משנה את התא כולו בהתאם לשיטת הטרנספורמציה שבחרתם. האפשרות הזו שימושית אם רוצים לשנות עמודות שלמות של נתונים, גם אם בתאים שבעמודות האלה זוהו סוגי מידע.
אם בוחרים באפשרות הזו, בשדה Transformation בוחרים שיטת טרנספורמציה שתחול על העמודות שציינתם.
בשני המקרים, יופיעו שדות נוספים בהתאם לשיטת הטרנספורמציה שבחרתם. ממלאים את השדות לפי הצורך. מידע נוסף זמין במאמר הפניות לטרנספורמציה.
לוחצים על יצירה.
תמונה
אם בחרתם באפשרות תמונה כסוג טרנספורמציית הנתונים, בצעו את הפעולות הבאות:
אופציונלי: כדי לשנות את הצבע של התיבה שמכסה את הטקסט המצונזר, לוחצים על התיבה השחורה בשדה צבע הצנזור ובוחרים צבע אחר.
בקטע InfoTypes to transform, מציינים מה רוצים לצנזר: את כל הטקסט שזוהה, את כל סוגי המידע שהוגדרו בהגדרות הבדיקה או רק סוגי מידע ספציפיים.
אם בוחרים באפשרות Specify infoTypes, בוחרים את סוגי המידע שרוצים להחיל עליהם את כלל הטרנספורמציה.
אם רוצים להוסיף כללי טרנספורמציה לסוגי מידע שלא נכללים בכלל הטרנספורמציה, לוחצים על Add transformation rule. אחר כך ממלאים את השדות לפי הצורך. חוזרים על השלב הזה עד שמגדירים כלל טרנספורמציה לכל סוגי המידע שרוצים לשנות.
לוחצים על יצירה.
פרוטוקול
חשוב לציין שתבנית להסרת פרטי זיהוי היא פשוט הגדרה להסרת פרטי זיהוי שניתן לעשות בה שימוש חוזר, בתוספת כמה מטא-נתונים. במונחי API, האובייקט DeidentifyTemplate הוא למעשה אובייקט DeidentifyConfig שכולל עוד כמה שדות של מטא-נתונים, כמו שם לתצוגה ותיאור. כדי ליצור תבנית חדשה להסרת פרטים מזהים, אלה השלבים הבסיסיים:
- מתחילים עם אובייקט
DeidentifyConfig. - מפעילים את השיטה
createשל המשאבprojects.deidentifyTemplatesאו שולחים אותה בבקשת POST, וכוללים בבקשה אובייקטDeidentifyTemplateשמכיל שם לתצוגה, תיאור ואת האובייקטDeidentifyConfig.
אפשר יהיה להשתמש ב-DeidentifyTemplate שהוחזר באופן מיידי. אפשר להפנות אליו בקריאות או במשימות אחרות באמצעות ה-name שלו. כדי להציג את התבניות הקיימות, אפשר להפעיל את ה-method *.deidentifyTemplates.list. כדי לראות תבנית ספציפית, צריך להפעיל את ה-method *.deidentifyTemplates.get. שימו לב: אפשר ליצור עד 1,000 תבניות.
אם כבר יש לכם ניסיון בהסרת פרטים אישיים מנתונים רגישים בטקסט, בתמונות או בתוכן מובנה באמצעות Sensitive Data Protection, כבר יצרתם אובייקט DeidentifyConfig. שלב אחד נוסף הופך אותו לאובייקט DeidentifyTemplate.
דוגמה ל-REST
קובץ ה-JSON הבא הוא דוגמה למה שאפשר לשלוח ל-method projects.deidentifyTemplates.create. קובץ ה-JSON הזה יוצר תבנית חדשה עם השם המוצג והתיאור שצוינו, וסורק התאמות ל-infoTypes EMAIL_ADDRESS ו-GENERIC_ID. כשהיא תמצא תוכן שתואם לסוגי המידע האלה, היא תסתיר את שלושת התווים הראשונים באמצעות כוכבית (*).
ה-method של ה-HTTP וכתובת ה-URL
POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/deidentifyTemplates
מחליפים את PROJECT_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.
שימוש בתבניות להסרת פרטי זיהוי
אחרי שיוצרים תבנית חדשה, אפשר להשתמש במזהה name שלה בכל מקום שבו אפשר להשתמש ב-deidentifyTemplateName, למשל:
-
projects.content.deidentify: הסרת פרטי הזיהוי של מידע אישי רגיש בתוכן, באמצעות התבנית כהגדרה. חשוב לדעת שבשיטה הזו אפשר להשתמש בתבנית בדיקה או בתבנית להסרת פרטים מזהים.
הצגת תבניות להסרת פרטי הזיהוי
כדי להציג את כל התבניות להסרת פרטי זיהוי שנוצרו, משתמשים באחת מהשיטות של *.*.list:
בקטע הזה מוסבר איך להשתמש ב-Sensitive Data Protection כדי להציג רשימה של תבניות בדיקה. התהליך זהה לתהליך של הצגת רשימה של תבניות להסרת פרטי הזיהוי.
C#
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Go
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
PHP
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
מחיקת תבניות להסרת פרטי זיהוי
כדי למחוק תבנית ספציפית להסרת פרטי זיהוי, משתמשים באחת מהשיטות של *.*.delete:
בכל שיטת *.*.delete, אתם כוללים את שם המשאב של התבנית שאתם רוצים למחוק.
C#
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Go
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Java
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Node.js
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
PHP
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
Python
במאמר ספריות הלקוח של Sensitive Data Protection מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Sensitive Data Protection.
כדי לבצע אימות ב-Sensitive Data Protection, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.