למרות שפעולות בצינור עיבוד הנתונים מציעות מגוון רחב של תכונות, מנוע הכללים מוגבל לזיהוי מסנני השוואה (למשל >) ומסננים לוגיים (למשל or) כדי להבטיח את האבטחה ואת היכולת לעמוד באילוצים.
ביטויי סינון נתמכים
כדי להגביל את פעולות הצינורות בהתאם לכללים שהגדרתם, צריך להשתמש באופרטורים לוגיים ואופרטורים להשוואה מול קבועים. מנוע הכללים מזהה את סוגי המסננים הבאים:
- השוואות:
eq,neq,gt,gte,lt,lte,in,arrayContains. - לוגי:
and,or.
הנה כמה דוגמאות:
where(eq("foo", 2))where(lt("foo", 2))documents("/user/1", "/user/2").where(...)
מאפייני הבקשה
אתם יכולים להמשיך להשתמש באובייקט request כדי לאמת את ההקשר של האימות והשאילתה, אבל חלק מהמאפיינים שזמינים בשאילתות רגילות לא נתמכים בפעולות של Pipeline.
מאפיינים נתמכים
המנוע החדש ממשיך לתמוך במאפיינים הבאים:
request.auth: גישה לנתוני המזהה הייחודי (UID) והאסימון של המשתמש.-
request.method: מזהה את הפעולה (לדוגמה,get,list). -
request.path: הנתיב של המשאב שאליו ניגשים. -
request.time: חותמת הזמן של הבקשה בצד השרת.
מאפיינים לא נתמכים
המאפיינים של request.query, כמו limit, offset ו-orderBy, לא נתמכים בבדיקות של כללי פעולות ב-Pipeline, כי קשה לקבוע את הערכים האלה בשאילתות עם כמה שלבים.
טיפול בשלבים של צינור עיבוד הנתונים והרשאות
יש שלבים שונים בצינור עיבוד הנתונים שממופים לפעולות פרטניות ספציפיות בכללי האבטחה:
- הרשאות
allow list: מופעלות על ידי השלביםcollection(),collectionGroup()ו-database(). - הרשאות
allow get: מופעלות על ידי השלבdocuments(), שדומה לפעולתgetבאצווה. - הרשאות
allow create: מופעלות בשלביםinsert()ו-upsert()כשיוצרים מסמכים חדשים. - הרשאות
allow update: מופעלות על ידי שלביupdate(), ושלביupsert()כשמעדכנים מסמכים קיימים. - הרשאות
allow delete: מופעלות על ידי שלביdelete(). - הרשאות
allow write: חלות על כל פעולות ה-DML (insert(),update(),upsert()ו-delete()). - שלב הליטרלים: השלב
literals()לא קורא ממסד הנתונים, אבל יכול לצבור עלויות. כדי למנוע ניצול לרעה, צריך לשלב אותו עם שלב אחר (כמוcollection()) שאפשר לאמת באמצעות כללים.
שלבי השינוי של השדה
הכללים פועלים רק על נתונים מאוחסנים ולא על ערכים נגזרים. אם צינור עיבוד נתונים כולל שלבים שמשנים שדות (לדוגמה, add_fields(...), replace_with(...), select(...), remove_fields(...)), מנוע הכללים מפסיק להחיל אילוצי סינון אחרי השלב הזה. כדי לוודא שהכללים פועלים כמו שצריך, צריך למקם את שלבי הסינון (למשל where) לפני כל שלב שיכול לשנות את המסמכים המקוריים שמאוחסנים.
לדוגמה, נניח שזהו כלל האבטחה:
match /databases/{database}/documents {
match /cities/{city} {
// Allow the user to read data if the document has the 'visibility'
// field set to 'public'
allow read: if resource.data.visibility == 'public';
}
}
נדחה: הכלל הזה דוחה את צינור עיבוד הנתונים הבא כי השלב addFields מתרחש לפני הסינון למסמכים שבהם visibility הוא public:
const results = await db.pipeline()
.collection("/cities")
// Filters after a modification stage are ignored by Rules.
.addFields(constant(1000).as("population"))
.where(eq(field("visibility"), constant("public")))
.execute();
מותר: הכלל הזה מאפשר את צינור עיבוד הנתונים הבא כי השלב where(eq(field("visibility"), constant("public"))) מתרחש לפני שלבי השינוי:
const results = await db.pipeline()
.collection("/cities")
.where(eq(field("visibility"), constant("public")))
.addFields(constant(1000).as("population"))
.execute();
שלבים של שפת טיפול בנתונים (DML) וכללי אבטחה
כשמבצעים שלבים של שפת טיפול בנתונים (DML) (insert(), update(), upsert() ו-delete()), כללי האבטחה מעריכים את ההרשאות באופן שונה מאשר בשאילתות קריאה:
- הערכת כללים לכל מסמך: בניגוד לצינורות עיבוד נתונים לקריאה, שדורשים ביטויי סינון מראש כדי להגביל את השאילתה בזמן התכנון, פעולות DML מעריכות את כללי האבטחה לכל מוטציה של מסמך בנפרד.
- משתני כללים:
-
request.resource: מכיל את נתוני המסמך המוצעים לפעולותinsert(),update()ו-upsert(). -
resource: מכיל את נתוני המסמך הנוכחיים שמאוחסנים במסד הנתונים לפני השינוי (זמין ל-update(), ל-delete()ול-upsert()של מסמכים קיימים).
-
מגבלות המערכת והתנהגות ההרצה עם DML
כשמריצים פעולות DML עם כללי אבטחה, חשוב לזכור את מגבלות המערכת והתנהגויות ההרצה הבאות:
המגבלה של 20 חיפושים ב-get() וב-exists()
כללי האבטחה של Firebase מאפשרים עד 20 חיפושי מסמכים (get() או exists()) בכל הבקשה.
כשצינור עיבוד נתונים של DML פועל מחוץ לטרנזקציה מפורשת, Cloud Firestore מעבד כתיבות של מסמכים באצוות. מכיוון שכל קבוצה מבוצעת בטרנזקציה משלה, וייתכן שמסמכים ישתנו בו-זמנית בין קבוצות, כללי האבטחה וחיפושי המסמכים מוערכים מחדש לכל קבוצת כתיבה.
גם אם כללי האבטחה שלכם בודקים מסמך סטטי אחד (לדוגמה, בודקים אם המשתמש הוא אדמין):
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /posts/{postId} {
allow write: if get(/databases/$(database)/documents/users/$(request.auth.uid)).data.isAdmin == true;
}
}
}
כל אצוות כתיבה של 10 מסמכים מבצעת חיפוש. כתוצאה מכך, אחרי כתיבת כל המסמכים האפשריים, מגיעים למגבלה של 20 חיפושים לבקשה, והצינור נכשל עם השגיאה PERMISSION_DENIED. בנוסף, כל חיפוש שמתבצע בכל אצווה של כתיבה מחויב בחיוב קריאה משלו.
הצלחה חלקית ו-PERMISSION_DENIED
כשמבצעים פעולות DML מחוץ לעסקה, הן מבצעות commit לכתיבות בקבוצות רציפות. אם אצווה נכשלת – כי מסמך נכשל בתנאי של כלל או כי חרגתם ממגבלת 20 החיפושים – צינור עיבוד הנתונים נעצר ומוחזרת שגיאת PERMISSION_DENIED.
עם זאת, אצוות שכבר בוצעו לא יוחזרו למצב הקודם. מסד הנתונים נשאר במצב מעודכן חלקית. הלקוח מקבל שגיאה בלי רשימה של המסמכים ששונו, ולכן צריך לשלוח שאילתה לנתונים כדי לבדוק אילו פעולות כתיבה הצליחו.
אבחון כשלים בכללים באמצעות יומני הביקורת של Cloud
מטעמי אבטחה, בשגיאות PERMISSION_DENIED שמוצגות ללקוח לא מצוין איזה תנאי של כלל אבטחה נכשל, או אם הגעתם למגבלה של 20 חיפושים.
כדי לאבחן כשלים בהערכת כללים, מנהלי פרויקטים יכולים לבדוק את יומני הביקורת של Cloud במסוף Google Cloud (בקטע Firestore > Monitoring או ב-Logs Explorer) כדי להציג רשומות מפורטות של EvaluationError.