יצירה וניהול של מדיניות תוכן

במאמר הזה מוסבר איך ליצור, לקבל, להציג, לעדכן ולמחוק כללי מדיניות תוכן. למידע נוסף על מדיניות התוכן, קראו את סקירה כללית של מדיניות התוכן.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות ליצירה ולניהול של כללי מדיניות תוכן, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין DLP (roles/dlp.admin) ב-IAM בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

זהו תפקיד מוגדר מראש שכולל את ההרשאות שנדרשות כדי ליצור ולנהל כללי מדיניות תוכן. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי ליצור ולנהל כללי מדיניות תוכן, נדרשות ההרשאות הבאות:

  • dlp.contentPolicies.create
  • dlp.contentPolicies.update
  • dlp.contentPolicies.list
  • dlp.contentPolicies.get
  • dlp.contentPolicies.delete

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

אם אתם מתכננים להחיל כללי מדיניות תוכן על המחברים והאפליקציות של Gemini Enterprise או על Gemini Notebook for business, אתם צריכים גם להקצות את התפקיד "משתמש DLP" (roles/dlp.user) לחשבון השירות של Gemini Enterprise. מידע נוסף זמין במאמר הגנה על מידע אישי רגיש במקורות.

לפני שמתחילים

  1. נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloudליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Cloud Data Loss Prevention API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Cloud Data Loss Prevention API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  10. אופציונלי: כדי לתעד את הפעולות של מדיניות התוכן בטבלה ב-BigQuery, יוצרים את הטבלה. למידע על הסכימה של היומנים שיוצאו, קראו את המאמר ContentPolicyActionLog.

יצירת מדיניות תוכן

המסוף

  1. במסוף Google Cloud , נכנסים לדף Content Policies של Sensitive Data Protection.

    למדיניות התוכן

  2. בוחרים את הפרויקט הרצוי.

  3. לוחצים על יצירה.

  4. בקטע מידע בסיסי, מבצעים את הפעולות הבאות:

    1. מזינים שם למדיניות התוכן.
    2. זה שינוי אופציונלי. מזינים מזהה ייחודי של מדיניות התוכן. אם לא תזינו מזהה למדיניות התוכן, Sensitive Data Protection יגדיר אחד באופן אוטומטי.
    3. בוחרים את האזור או את מספר האזורים שבהם רוצים לאחסן את מדיניות התוכן.
    4. לוחצים על Continue.
  5. בקטע Inspection Configuration:

    1. בוחרים את סוגי המידע הרגיש המובנים או המותאמים אישית שרוצים לזהות. מידע נוסף זמין במאמר ניהול של טיפוסי מידע באמצעות מסוףGoogle Cloud .

      כדי להגדיר זיהוי באמצעות תבנית בדיקה קיימת, לוחצים על Import from a template ומזינים את שם המשאב המלא של התבנית.

    2. זה שינוי אופציונלי. מוסיפים קבוצת כללי בדיקה.

      אפשר ללחוץ כדי להציג את ההוראות

      קבוצות כללי הבדיקה מאפשרות לכם להתאים אישית את הגלאים המובנים והמותאמים אישית של נתוני infoType באמצעות כללי הקשר. אלה סוגי כללי הבדיקה:

      כדי להוסיף קבוצת כללים חדשה, קודם צריך לציין לפחות גלאי אחד מובנה או מותאם אישית של infoType בקטע InfoTypes. בוחרים את כל הגלאים של סוגי המידע שקבוצות הכללים משנות (סוגי המידע למיקוד) או משתמשות בהם להערכה (סוגי המידע להקשר). לאחר מכן, מבצעים את הפעולות הבאות:

      1. לוחצים על הוספת קבוצת כללים.
      2. בשדה Choose target infoTypes, בוחרים את סוגי המידע שקבוצת הכללים משנה אם הכללים מתקיימים.
      3. לוחצים על Add a rule כדי לפתוח תפריט עם אפשרויות, כולל Hotword rule,‏ כלל להחרגה ו-Adjustment rule.

      כדי ליצור כלל הרחבה (Hotword), בוחרים באפשרות כלל הרחבה (Hotword). לאחר מכן, מבצעים את הפעולות הבאות:

      1. בשדה Hotword, מזינים ביטוי רגולרי ש-Sensitive Data Protection יחפש.
      2. בתפריט Hotword proximity, בוחרים אם מילת ההפעלה שהזנתם נמצאת לפני או אחרי ה-infoType שנבחר.
      3. בשדה Hotword distance from infoType, מזינים את מספר התווים המשוער בין מילת המפתח לבין ה-infoType שנבחר.
      4. בקטע Confidence level adjustment, בוחרים אם להקצות להתאמות רמת סבירות קבועה, או להגדיל או להקטין את רמת הסבירות שמוגדרת כברירת מחדל בסכום מסוים.

      כדי ליצור כלל החרגה, בוחרים באפשרות Exclusion rule ובסוג כלל ההחרגה שרוצים ליצור, למשל ביטוי רגולרי. לאחר מכן, מבצעים את הפעולות הבאות:

      1. בהתאם לסוג הכלל להחרגה שבחרתם, מזינים את הביטוי הרגולרי, הביטוי, מילת ההפעלה או ה-infoType של ההקשר שצריך למצוא כדי שהכלל יחול.
      2. בהתאם לסוג הכלל להחרגה שבחרתם, מגדירים את סוג ההתאמה או את סוג ההכלה של התמונה:
        • אם בחרתם כלל החרגה שמבוסס על טקסט, בחרו אחד מסוגי ההתאמה הבאים:
          • התאמה מלאה: הממצא חייב להתאים באופן מלא לטקסט או ל-infoType של ההקשר שסיפקתם.
          • התאמה חלקית: תת-מחרוזת של הממצא צריכה להתאים לטקסט או ל-infoType של ההקשר שסיפקתם.
          • התאמה הפוכה: הממצא לא יכול להתאים לטקסט או ל-infoType של ההקשר שסיפקתם.
        • אם בחרתם כלל החרגה שמבוסס על תמונה, בחרו את היחס המרחבי הנדרש בין סוגי המידע הרגיש של היעד וההקשר. לדוגמה, אם בוחרים באפשרות Encloses, הממצא בהקשר חייב להכיל את ממצא היעד כדי שהכלל יחול.

      כדי ליצור כלל התאמה, בוחרים באפשרות כלל התאמה ובסוג כלל ההתאמה, לדוגמה התאמה לפי ממצאים בתמונה. לאחר מכן, מבצעים את הפעולות הבאות:

      1. בשדה Context infoTypes, בוחרים את הגלאים של סוגי המידע שמספקים הקשר לממצא היעד. ‫Sensitive Data Protection משתמש ב-infoTypes של הקשר כדי להעריך אם צריך לשנות את ה-infoType של היעד.
      2. בשדה Minimum likelihood, בוחרים את רמת הסבירות הנמוכה ביותר שיכולה להיות לסוגי המידע (infoTypes) של ההקשר, ועדיין להפעיל את כלל ההתאמה. אם ערך הסבירות של ממצא הקשר שזוהה נמוך מהערך הזה, Sensitive Data Protection לא משנה את הסבירות של ממצא היעד.
      3. בממצאים של תמונות, בשדה Image containment type בוחרים את הקשר המרחבי הנדרש בין סוגי המידע הרגיש של היעד וההקשר. לדוגמה, אם בוחרים באפשרות Encloses, הממצא של ההקשר חייב להכיל את ממצא היעד כדי שהכלל יחול.
      4. בשדה Likelihood, בוחרים את רמת הסבירות החדשה שרוצים להקצות לממצא היעד.

      אתם יכולים להוסיף עוד קבוצות כללים כדי לשפר את תוצאות הסריקה.

    3. זה שינוי אופציונלי. מגדירים את סף רמת הסבירות של הממצאים שרוצים לזהות. מידע נוסף מופיע במאמר סבירות להתאמה.

    4. לוחצים על Continue.

  6. בקטע Policy Rules, מוסיפים כללי מדיניות כדי לציין את ההחלטה (Allow או Block) ש-Sensitive Data Protection מחזיר כשהוא מזהה infoType שציינתם בהגדרת הבדיקה. אתם יכולים להוסיף כלל מדיניות אחד כדי להחזיר את אותה החלטה לכל infoType, או להוסיף כמה כללי מדיניות כדי להחזיר החלטות שונות ל-infoTypes שונים. צריך להגדיר תנאי לכל כלל מדיניות שמוסיפים.

    כדי להוסיף כלל מדיניות, מבצעים את הפעולות הבאות:

    1. לוחצים על הוספת כלל מדיניות.
    2. בוחרים את ההחלטה שרוצים להקצות לממצא של infoType: אישור או חסימה.
    3. לוחצים על הוספת תנאי. אם רוצים להגדיר החלטות שונות לסוגי מידע שונים, מגדירים את Condition type ל-Any infoType או ל-Specific infoTypes.
    4. אם בחרתם באפשרות Specific infoTypes, הזינו את סוגי המידע שצריך לזהות כדי ש-Sensitive Data Protection יחזיר את התוצאה שבחרתם.
    5. אם צריך, מוסיפים עוד כללי מדיניות ואת התנאים שלהם.
    6. לוחצים על Continue.
  7. זה שינוי אופציונלי. בקטע פעולות ברירת מחדל, מציינים את ההחלטות שצריך להחיל בתנאים הבאים:

    • החלטה שצריך להקצות לקבצים לא נתמכים. מידע נוסף זמין במאמר סוגי קבצים נתמכים ומצבי סריקה.
    • החלטה שמוקצית לקבצים נתמכים שגדולים מדי לסריקה.
    • החלטה שמוקצית לקבצים שאי אפשר לסרוק, למשל קבצים פגומים או מוצפנים.
    • החלטה שתוצג אם אף אחד מהכללים לא תואם לתוכן שנסרק.

    לכל אחד מהתנאים האלה, פסק הדין שמוגדר כברירת מחדל הוא ALLOW.

    לוחצים על Continue.

  8. זה שינוי אופציונלי. בקטע Logging Configuration, מפעילים את הרישום ביומן כדי לתעד את ההחלטות שהתקבלו על ידי מדיניות התוכן לגבי הנתונים שאתם סורקים. מבצעים את הפעולות הבאות:

    1. בוחרים באפשרות רישום ביומן של הפעלת המדיניות ב-BigQuery.
    2. מזינים את הפרטים של טבלה קיימת ב-BigQuery שבה Sensitive Data Protection צריך לתעד את התוצאות.
  9. לוחצים על יצירה.

REST

כדי ליצור מדיניות תוכן, שולחים בקשת POST ל-method‏ projects.locations.contentPolicies.create. גוף הבקשה מגדיר אובייקט content_policy שמכיל את הגדרות הבדיקה ואת הכללים שקובעים את התוצאה על סמך הממצאים.

לאובייקט content_policy יש את המאפיינים הבאים:

{
  "contentPolicy": {
    "displayName": "DISPLAY_NAME",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "INFOTYPE_DETECTOR"
        }
      ],
      "ruleSet": [
        INSPECTION_RULE_SET
      ]
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "INFOTYPE_CONDITION_VERDICT"
        }
      }
    ],
    "unsupportedFileType": {
      "returnVerdict": "UNSUPPORTED_FILE_TYPE_VERDICT"
    },
    "inputTooLarge": {
      "returnVerdict": "INPUT_TOO_LARGE_VERDICT"
    },
    "failedToScanSupportedFileType": {
      "returnVerdict": "FAILED_TO_SCAN_VERDICT"
    },
    "defaultAction": {
      "returnVerdict": "DEFAULT_ACTION_VERDICT"
    },
    "loggingConfigs": [
      {
        "logToBigQuery": {
          "projectId": "LOG_PROJECT_ID",
          "datasetId": "LOG_DATASET_ID",
          "tableId": "LOG_TABLE_ID"
        }
      }
    ]
  },
  "contentPolicyId": "CONTENT_POLICY_ID"
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫DISPLAY_NAME: אופציונלי. שם של מדיניות התוכן שקריא לאנשים.
  • ‫INFOTYPE_DETECTOR: infoType מובנה או בהתאמה אישית.
  • ‫INSPECTION_RULE_SET: אופציונלי. אובייקט אחד או יותר מסוג InspectionRuleSet, כפי שמוגדר במאמר שינוי של גלאי infoType כדי לשפר את תוצאות הסריקה. הקוד הזה מקוצר. בקטע דוגמה מורחבת מופיעה דוגמה להגדרה של קבוצת כללים במדיניות תוכן.
  • ‫INFOTYPE_CONDITION_VERDICT: פסיקה שצריך להקצות לממצא של infoType: ‏ALLOW או BLOCK.
  • ‫UNSUPPORTED_FILE_TYPE_VERDICT: אופציונלי. החלטה שצריך להקצות לקבצים לא נתמכים: ALLOW או BLOCK. מידע נוסף זמין במאמר סוגי קבצים נתמכים ומצבי סריקה.
  • ‫INPUT_TOO_LARGE_VERDICT: אופציונלי. החלטה שצריך להקצות לקבצים נתמכים שגדולים מדי לסריקה: ALLOW או BLOCK.
  • ‫FAILED_TO_SCAN_VERDICT: אופציונלי. החלטה שמוקצית לקבצים שאי אפשר לסרוק, למשל קבצים פגומים או מוצפנים: ALLOW או BLOCK.
  • ‫DEFAULT_ACTION_VERDICT: אופציונלי. החלטה שצריך להקצות אם אף אחד מהכללים לא תואם לתוכן שנסרק: ALLOW או BLOCK.
  • ‫LOG_PROJECT_ID: מזהה הפרויקט שמכיל את הטבלה ב-BigQuery שרוצים לכתוב אליה.
  • ‫LOG_DATASET_ID: המזהה של קבוצת הנתונים שמכילה את הטבלה ב-BigQuery שרוצים לכתוב אליה.
  • ‫LOG_TABLE_ID: המזהה של הטבלה ב-BigQuery שרוצים לכתוב אליה.
  • ‫CONTENT_POLICY_ID: מזהה ייחודי של מדיניות התוכן.

דוגמה מורחבת לתשובה

פרטים על מדיניות התוכן

המסוף

  1. במסוף Google Cloud , נכנסים לדף Content Policies של Sensitive Data Protection.

    למדיניות התוכן

  2. בוחרים את הפרויקט הרצוי.

  3. לוחצים על שם המשאב של מדיניות התוכן שרוצים לראות.

  4. בכרטיסייה פרטים, אפשר לראות פרטים על מדיניות התוכן.

REST

כדי לקבל מדיניות תוכן, שולחים בקשת GET ל-method‏ projects.locations.contentPolicies.get.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫REGION: האזור שבו מאוחסנת מדיניות התוכן, לדוגמה us-west2. לרשימה המלאה של האזורים, ראו מיקומי Sensitive Data Protection.
  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את מדיניות התוכן.
  • ‫CONTENT_POLICY_ID: המזהה של מדיניות התוכן שרוצים לקבל את הפרטים שלה.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies/CONTENT_POLICY_ID

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "LIKELY",
    "limits": {}
  }
}

הצגת רשימה של כל כללי מדיניות התוכן בפרויקט

המסוף

  1. במסוף Google Cloud , נכנסים לדף Content Policies של Sensitive Data Protection.

    למדיניות התוכן

  2. בוחרים את הפרויקט הרצוי. רשימת כללי מדיניות התוכן בפרויקט מופיעה.

REST

כדי להציג את כללי מדיניות התוכן בפרויקט, שולחים בקשת LIST ל-method‏ projects.locations.contentPolicies.list.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫REGION: האזור שבו מאוחסנות כללי מדיניות התוכן שרוצים להציג, לדוגמה us-west2. לרשימה המלאה של האזורים, ראו מיקומי Sensitive Data Protection.
  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את כללי מדיניות התוכן שרוצים להציג.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "contentPolicies": [
      {
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "LIKELY",
    "limits": {}
  }
},
    {
      "name": "projects/example-project/locations/us-west1/contentPolicies/block-pii",
      ...
    }
  ]
}

עדכון מדיניות תוכן

המסוף

  1. במסוף Google Cloud , נכנסים לדף Content Policies של Sensitive Data Protection.

    למדיניות התוכן

  2. בוחרים את הפרויקט הרצוי.

  3. לוחצים על שם המשאב של מדיניות התוכן שרוצים לערוך.

  4. לוחצים על Edit.

  5. עורכים את פרטי מדיניות התוכן.

REST

כדי לעדכן מדיניות תוכן, שולחים בקשת PATCH למתודה projects.locations.contentPolicies.patch. גוף הבקשה מגדיר את האובייקט המעודכן content_policy.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫REGION: אזור שבו יש נקודת קצה אזורית של Sensitive Data Protection, לדוגמה us-west2. לרשימה המלאה של האזורים, ראו מיקומי Sensitive Data Protection.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud . מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו example-project.
  • ‫CONTENT_POLICY_ID: המזהה של מדיניות התוכן שרוצים לעדכן.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies/CONTENT_POLICY_ID

תוכן בקשת JSON:

{
  "contentPolicy": {
    "displayName": "displayName",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "CREDIT_CARD_NUMBER"
        }
      ],
      "minLikelihood": "LIKELY"
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "BLOCK"
        }
      }
    ]
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "LIKELY",
    "limits": {}
  }
}

מחיקה של מדיניות תוכן

המסוף

  1. במסוף Google Cloud , נכנסים לדף Content Policies של Sensitive Data Protection.

    למדיניות התוכן

  2. בוחרים את הפרויקט הרצוי.

  3. בוחרים את מדיניות התוכן שרוצים למחוק.

  4. לוחצים על Delete.

REST

כדי למחוק מדיניות תוכן, שולחים בקשת DELETE למתודה projects.locations.contentPolicies.delete.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫REGION: האזור שבו מאוחסנת מדיניות התוכן, לדוגמה us-west2. לרשימה המלאה של האזורים, ראו מיקומי Sensitive Data Protection.
  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את מדיניות התוכן.
  • ‫CONTENT_POLICY_ID: המזהה של מדיניות התוכן שרוצים למחוק.

ה-method של ה-HTTP וכתובת ה-URL:

DELETE https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies/CONTENT_POLICY_ID

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

דוגמאות ל-REST

בדוגמאות הבאות מוסבר איך ליצור מדיניות תוכן באמצעות ה-API בארכיטקטורת REST.

דוגמה פשוטה

בדוגמה הבאה נוצרת מדיניות שמזהה ממצאים של CREDIT_CARD_NUMBER עם סבירות של POSSIBLE או יותר. אם נמצא מספר כרטיס אשראי, Sensitive Data Protection מחזיר את התוצאה BLOCK.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫REGION: אזור שבו יש נקודת קצה אזורית של Sensitive Data Protection, לדוגמה us-west2. לרשימה המלאה של האזורים, ראו מיקומי Sensitive Data Protection.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud . מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו example-project.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies

תוכן בקשת JSON:

{
  "contentPolicy": {
    "displayName": "displayName",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "CREDIT_CARD_NUMBER"
        }
      ],
      "minLikelihood": "POSSIBLE"
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "BLOCK"
        }
      }
    ]
  },
  "contentPolicyId": "block-credit-cards-policy"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "POSSIBLE",
    "limits": {}
  }
}

דוגמה מורחבת

בדוגמה הבאה נוצרת מדיניות שמזהה ממצאים של CREDIT_CARD_NUMBER עם סבירות של POSSIBLE או יותר. הוא כולל כלל הרחבה (Hotword) שמגדיל את ערך הסבירות של הממצא ל-VERY_LIKELY אם המילה credit card מזוהה ליד הממצא.

  • אם Sensitive Data Protection מזהה מספר אפשרי של כרטיס אשראי, הוא מחזיר את התוצאה BLOCK.
  • אם הקובץ לסריקה לא נתמך, גדול מדי, פגום, מוצפן או לא ניתן לסריקה מסיבה אחרת, Sensitive Data Protection מחזיר את התוצאה BLOCK.
  • אם אף אחד מהכללים לא תואם לתוכן שנסרק, Sensitive Data Protection מחזיר את התוצאה ALLOW.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫REGION: אזור שבו יש נקודת קצה אזורית של Sensitive Data Protection, לדוגמה us-west2. לרשימה המלאה של האזורים, ראו מיקומי Sensitive Data Protection.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud . מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו example-project.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies

תוכן בקשת JSON:

{
  "contentPolicy": {
    "displayName": "displayName",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "CREDIT_CARD_NUMBER"
        }
      ],
      "ruleSet": [
        {
          "infoTypes": [
            {
              "name": "CREDIT_CARD_NUMBER"
            }
          ],
          "rules": [
            {
              "hotwordRule": {
                "hotwordRegex": {
                  "pattern": "credit\\scard"
                },
                "proximity": {
                  "windowBefore": 10,
                  "windowAfter": 10
                },
                "likelihoodAdjustment": {
                  "fixedLikelihood": "VERY_LIKELY"
                }
              }
            }
          ]
        }
      ]
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "BLOCK"
        }
      }
    ],
    "unsupportedFileType": {
      "returnVerdict": "BLOCK"
    },
    "inputTooLarge": {
      "returnVerdict": "BLOCK"
    },
    "failedToScanSupportedFileType": {
      "returnVerdict": "BLOCK"
    },
    "defaultAction": {
      "returnVerdict": "ALLOW"
    }
  },
  "contentPolicyId": "block-credit-cards-policy"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/example-project/locations/us-west2/contentPolicies/block-credit-cards-policy",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "limits": {},
    "ruleSet": [
      {
        "infoTypes": [
          {
            "name": "CREDIT_CARD_NUMBER"
          }
        ],
        "rules": [
          {
            "hotwordRule": {
              "hotwordRegex": {
                "pattern": "credit\\scard"
              },
              "proximity": {
                "windowBefore": 10,
                "windowAfter": 10
              },
              "likelihoodAdjustment": {
                "fixedLikelihood": "VERY_LIKELY"
              }
            }
          }
        ]
      }
    ]
  },
  "unsupportedFileType": {
    "returnVerdict": "BLOCK"
  },
  "inputTooLarge": {
    "returnVerdict": "BLOCK"
  },
  "failedToScanSupportedFileType": {
    "returnVerdict": "BLOCK"
  },
  "defaultAction": {
    "returnVerdict": "ALLOW"
  }
}

דוגמה עם סריקת תוויות של מטא-נתונים

בדוגמה הבאה, Sensitive Data Protection מונחה לסרוק מספרי כרטיסי אשראי ותוויות מטא-נתונים עם המפתח MSIP_Label_12345-12345-1234-12345_Enabled. אם נמצא מידע כזה, Sensitive Data Protection מחזיר את התוצאה BLOCK.

מידע נוסף על סריקת תוויות של מטא-נתונים זמין במאמר יצירת גלאי תוויות של מטא-נתונים בהתאמה אישית.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫REGION: אזור שבו יש נקודת קצה אזורית של Sensitive Data Protection, לדוגמה us-west2. לרשימה המלאה של האזורים, ראו מיקומי Sensitive Data Protection.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud . מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו example-project.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dlp.REGION.rep.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/contentPolicies

תוכן בקשת JSON:

{
  "contentPolicy": {
    "displayName": "displayName",
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "CREDIT_CARD_NUMBER"
        }
      ],
      "customInfoTypes": [
        {
          "infoType": {
            "name": "CUSTOM_MSIP1"
          },
          "likelihood": "VERY_LIKELY",
          "fileLabelInfoType": {
            "sensitivityLabel": {
              "guid": "12345678-1234-1234-1234-123456789012"
            }
          }
        }
      ],
      "minLikelihood": "POSSIBLE"
    },
    "rules": [
      {
        "conditions": [
          {
            "infoTypeCondition": {
              "anyInfoType": {}
            }
          }
        ],
        "action": {
          "returnVerdict": "BLOCK"
        }
      }
    ]
  },
  "contentPolicyId": "block-credit-cards-policy-metadata-scanning"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/example-project/locations/us-west1/contentPolicies/block-credit-cards-policy-metadata-scanning",
  "rules": [
    {
      "conditions": [
        {
          "infoTypeCondition": {
            "anyInfoType": {}
          }
        }
      ],
      "action": {
        "returnVerdict": "BLOCK"
      }
    }
  ],
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "CREDIT_CARD_NUMBER"
      }
    ],
    "minLikelihood": "POSSIBLE",
    "limits": {},
    "customInfoTypes": [
      {
        "infoType": {
          "name": "CUSTOM_MSIP1"
        },
        "likelihood": "VERY_LIKELY",
        "fileLabelInfoType": {
          "sensitivityLabel": {
            "guid": "12345678-1234-1234-1234-123456789012"
          }
        }
      }
    ]
  }
}

המאמרים הבאים