בדף הזה מוסבר איך המידע מאורגן ב-Consent Management API, ואיך אפשר להשתמש בשדות שונים של משאבים.
סקירה כללית
Consent Management API (ממשק API לניהול הסכמה) מנהל נתונים שקשורים להסכמה ולפרטיות בתחומים הבאים:
- פרטי ההגדרה. הגדרות של מאגר ההסכמות ונתונים שקשורים להגדרות של מאגר ההסכמות, כולל זמן התפוגה ורכיבי המדיניות, כמו הגדרות של מאפייני הסכמה.
- רשומות של הסכמה. נתונים שקשורים להרשאות שניתנו על ידי המשתמשים שלכם, כולל הסכמות וכל ארטיפקט הסכמה מקושר.
- משאבים מנוהלים. מיפויים של נתוני משתמשים ונתונים שקשורים למשאבים שמנוהלים על ידי Consent Management API. מיפוי נתוני המשתמש מאוחסן ב-Consent Management API, ואילו המשאבים המנוהלים מאוחסנים מחוץ ל-Consent Management API.
מודל נתונים
ה-API לניהול הסכמה משתמש במודל הנתונים הבא:
פרטי ההגדרות האישיות
נתוני ההסכמה מאוחסנים במאגר הסכמה. אתם יכולים ליצור מאגר הסכמה אחד או יותר שמוגדרים ומופעלים באופן עצמאי. ההגדרות שתבחרו במאגר ההסכמה יקבעו אילו משאבים אחרים של Consent Management API תוכלו ליצור ואיך המשאבים האלה יתנהגו.
בהתאם לתרחיש השימוש, יכול להיות שתצטרכו יותר ממאגר הסכמה אחד. לאחר מכן תוכלו לארגן את מאגרי ההסכמה על ידי הגדרת תוויות של זוגות מפתח/ערך.
אתם יכולים להגדיר תקופת תפוגה כברירת מחדל שתחול על הסכמות שנוצרו בחנות. לדוגמה, אפשר להגדיר את תקופת התפוגה של החנות לשנה אחת, כך שהסכמות חדשות שנוצרו בחנות יפוגו שנה אחת אחרי שהן נוצרו. אם נוצרת הסכמה עם תקופת תפוגה משלה, תקופת התפוגה הזו תשמש במקום תקופת התפוגה שמוגדרת כברירת מחדל בחנות. מידע נוסף על חנויות הסכמה ועל ההגדרה שלהן זמין במאמר יצירה ועדכון של הסכמות משתמשים.
דרך נוספת להגדיר את ההתנהגות של מאגר ההסכמה היא ליצור הגדרות של מאפיינים. משאבי הגדרת מאפיינים מציינים אילו מאפיינים וערכי מאפיינים מותרים במאגר ההסכמות. האיסוף של הגדרות מאפיינים בחנות ההסכמה מגדיר את מושגי ההסכמה והפרטיות שחנות ההסכמה יכולה לעבד.
כל מאפיין מסווג כמאפיין משאב או כמאפיין בקשה. מאפייני משאבים הם מאפיינים שמתארים את הנתונים שמנוהלים במאגר המידע של הסכמות. מאפייני משאבים משמשים ליצירת מיפוי של נתוני משתמשים, ליצירת מדיניות הסכמה ולהגבלת ההיקף של בקשות לקביעת גישה לסוגים ספציפיים של נתונים.
מאפייני בקשה הם מאפיינים שמתארים איך אפשר להשתמש בנתונים במאגר ההסכמות. מאפייני הבקשה נחוצים כדי ליצור את כללי ההרשאה של מדיניות ההסכמה, ונדרשים כדי לתאר את השימוש המוצע במהלך בקשות לקביעת גישה. מידע נוסף על הגדרות מאפיינים מופיע במאמר בנושא הגדרת מדיניות הסכמה באמצעות מאפיינים.
רשומות הסכמה
אתם יכולים ליצור משאבי הסכמה ומשאבי ארטיפקט של הסכמה כשאתם מתעדים את ההסכמה של משתמש ב-Consent Management API. במשאבי ההסכמה מתועדים התנאים הספציפיים שבהם ההסכמה תקפה, והם מאפשרים ל-API לניהול הסכמה למלא בקשות לקביעת גישה. במשאבי ארטיפקט ההסכמה מתועדים התנאים שבהם המשתמש העניק את ההסכמה, ומוצג תיעוד של הענקת ההסכמה.
מקורות מידע בנושא הסכמה
משאבי הסכמה מכילים מדיניות אחת או יותר שמתארת את ההסכמה שניתנה במונחים של המאפיינים וערכי המאפיינים שהוגדרו במאגר ההסכמה.
משאבי ההסכמה ספציפיים למשתמש, ומצוין userID לכל משאב הסכמה. userID הוא מזהה שמציין למי ההסכמה שייכת. אותו מזהה משמש כשיוצרים מיפויים של נתוני משתמשים.
מדיניות הסכמה משתמשת במאפייני משאבים כדי לתאר לאילו נתונים ההסכמה מתייחסת, ובכללי הרשאה כדי להגדיר אילו שימושים מותרים בנתונים האלה. כללי ההרשאה מבוטאים באמצעות מאפייני בקשה וCommon Expression Language (CEL). אפשר ליצור מדיניות מכל אחד מערכי המאפיינים שמוגדרים בהגדרות המאפיינים של מאגר ההסכמה.
מידע נוסף על מדיניות זמין במאמר בנושא אכיפת מדיניות.
למשאבי הסכמה יכול להיות אחד מהסטטוסים הבאים:
- פעיל: המשתמש העניק את ההסכמה והיא תיבדק במהלך רוב השיטות לקביעת הגישה. אם משתמש רוצה לבטל את ההסכמה, אתם יכולים לשנות את ההסכמה הפעילה ל'בוטלה'.
- בוטלה: המשתמש ביטל את ההסכמה, והמערכת תתעלם מהמשאב הזה במהלך כל קביעות הגישה.
- טיוטה: המשתמש עדיין לא העניק את ההסכמה, אבל אפשר להעריך אותה בקביעת הרשאות גישה, בתנאים מסוימים. אתם יכולים לשנות את סטטוס ההסכמה מטיוטה לפעיל אם המשתמש מביע הסכמה. אפשר לשנות את סטטוס טיוטת המשאב ל'נדחה' אם המשתמש דוחה את בקשת ההסכמה.
- נדחתה: ההסכמה לא ניתנה והיא תתעלם במהלך כל קביעות הגישה.
אפשר גם להגדיר תאריך תפוגה להסכמות כתאריך מוחלט או כמשך זמן. הסכמות שלא מוגדר להן תאריך תפוגה מקבלות בירושה את משך התפוגה שמוגדר כברירת מחדל בחנות. אם לא הגדרתם את תאריך התפוגה שמוגדר כברירת מחדל במאגר ההסכמות, ולא הגדרתם תאריך תפוגה להסכמה מסוימת, ההסכמה הזו לא תפוג.
ארטיפקטים של הסכמה
במשאבי ארטיפקט של הסכמה מתועדים המסמכים לתמיכה במדיניות שמתוארת במשאבי הסכמה. המסמכים האלה יכולים לכלול:
- חותמות זמן
- חתימות של המשתמש, האפוטרופוס או העד
- תמונות או צילומי מסך שמתעדים את חוויית ההסכמה של המשתמש
- מסמכים שמוכיחים הסכמה אלקטרונית, כמו קובץ PDF חתום או הוכחה אחרת להסכמה
- מטא-נתונים נוספים, כמו שמות, תאריכים או פרטים ליצירת קשר
משאבי ההסכמה מקושרים למשאבי פריטי המידע שנוצרו מהסכמה כשהמשאב נוצר. אפשר לכלול מידע שאפשר להשתמש בו כדי לזהות משתמש במשאב של ארטיפקט הסכמה. כדי להגביל את הגישה למידע הזה, אפשר להגדיר הרשאות רק לארטיפקטים של הסכמה. מידע נוסף על הרשאות הסכמה זמין במאמר בנושא בקרת גישה.
משאבים מנוהלים
ה-API לניהול הסכמה מנהל את הגישה למשאבים שמאוחסנים במיקומים שונים, ב- Google Cloud, באופן מקומי או אצל ספק ענן אחר. המידע על המשאבים שמנוהלים נמצא במיפוי של נתוני המשתמשים, מה שמאפשר ל-Consent Management API לקבוע את הגישה בלי לדרוש גישה למשאבים המנוהלים עצמם.
מיפויי נתוני משתמשים משתמשים בשדה dataID כדי לזהות באופן ייחודי את המשאבים שמנוהלים. המשאבים המנוהלים יכולים להיות בכל מקום שאפשר לתאר באמצעות מחרוזת.
השדה userID הוא מזהה שמייצג את המשתמש שאליו משויך המשאב המנוהל. זה אותו מזהה שמשמש ליצירת משאבי הסכמה וארטיפקט הסכמה.
קבוצת הערכים של מאפייני המשאב שכלולה במיפוי נתוני משתמש מתארת את המשאב שמיוצג על ידי מיפוי נתוני המשתמש הזה. הערכים המותרים של מאפייני המשאבים מוגדרים בהגדרות המאפיינים של מאגר ההסכמה.
מידע נוסף על יצירה וניהול של מיפוי נתוני משתמשים זמין במאמר בנושא רישום נתוני משתמשים.