PostgreSQL — הרשאות ברמת שורה
אמ;לק
הפעלת RLS ומדיניות מצומצמת; הרשאות טבלה ותנאי שורה הן שכבות נפרדות.
סיכום בעברית: מערכת VibeSec · מדיניות המקורות
נוסף ל-VibeSec:
>הפעלת RLS ומדיניות מצומצמת; הרשאות טבלה ותנאי שורה הן שכבות נפרדות.
התוכן המלא בעברית
תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.
Postgres Row Level Security (RLS) מעניק לך כללי הרשאה מפורטים הפועלים בתוך מסד הנתונים.
טבלה בסכימה חשופה ללא RLS ניתנת לקריאה ולכתיבה על ידי כל תפקיד (role) שיש לו הרשאות גישה (grant) עליה. הפעל RLS בכל טבלה בסכימה חשופה. בפרויקטים שעדיין מעניקים הרשאות ל-anon ול-authenticated כברירת מחדל, בטל הרשאות אלו. הוספת מדיניות אינה מסירה אותן.
• Understand Row Level Security מסביר כיצד הרשאות (grants) ומדיניות (policies) משתלבים זה עם זה כדי לשלוט בגישה.
• Secure a table with RLS הוא ההליך שיש לבצע עבור כל טבלה בסכימה חשופה: הגדרת הרשאות, מדיניות ושימוש ב-supabase test db.
• RLS מתעד את פונקציות העזר והתבניות שבהן אתה משתמש בתוך ביטוי מדיניות.
קרא את החלק הראשון כשאתה מחליט כיצד לתכנן את מודל הגישה. עבור ישירות לחלק השני כשאתה מוכן לאבטח טבלה.
Understand Row Level Security #
מה עושה מדיניות (Policy) #
מדיניות היא מנוע הכללים של Postgres. כל מדיניות מצורפת לטבלה, והמדיניות מופעלת בכל פעם שניגשים לטבלה.
תחשוב על מדיניות כהוספת תנאי WHERE לכל שאילתה. מדיניות כזו:
1 create policy " Individuals can view their own todos. " 2 on todos for select 3 to authenticated 4 using ( ( select auth . uid () ) = user_id );
מדיניות זו מתורגמת לכך בכל פעם שמשתמש מבצע פעולת SELECT מטבלת ה-todos:
1 select * 2 from todos 3 where auth . uid () = todos . user_id ; 4 -- Policy is implicitly added.
אתה כותב כללי RLS ב-SQL, כך שכלל יכול לבטא כל היגיון גישה שהאפליקציה שלך צריכה. מכיוון ש-RLS הוא פרימיטיב של Postgres, הוא מגן על הנתונים שלך גם כאשר ניגשים אליהם באמצעות כלי צד-שלישי, וזה מה שהופך זאת ל-defense in depth (הגנה לעומק). שלב את RLS עם Supabase Auth לאבטחת משתמש מקצה לקצה מהדפדפן ועד למסד הנתונים.
Grants ומדיניות #
Postgres מבצע שתי בדיקות לפני שלקוח ניגש לטבלה. הרשאות (Grants) קובעות האם לתפקיד מסוים מותר בכלל לבצע פעולה על הטבלה. מדיניות (Policies) קובעת על אילו שורות הפעולה חלה. הגדר את שניהם עבור כל טבלה שאתה חושף.
בפרויקטים קיימים, טבלה חדשה בסכימת public מתחילה כאשר כל ההרשאות ניתנו כבר לכל שלושת התפקידים. הרשאות ברירת המחדל כוללות select, insert, update, delete, truncate, references, trigger, וב-Postgres 17 גם maintain:
הוספת מדיניות אינה מבטלת את ההרשאות הללו. טבלה שמוגנת רק על ידי מדיניות עדיין תאפשר ל-anon נתיב ביצוע של insert אם לא תבטל את ההרשאה.
לא כל פרויקט מעניק הרשאות אלו באופן אוטומטי. ראה Default privileges. הענק לכל תפקיד רק את הפעולות הדרושות לו.
הרשאה חסרה מעלה שגיאה 42501 לפני שכל מדיניות שהיא תרוץ. כאשר בקשה נכשלת למרות שהמדיניות שלך אמורה לאפשר אותה, בדוק את ההרשאות לפני שתשנה את המדיניות. כדי להגדיר אותן, ראה Enable RLS and set the grants.
תפקידים מאומתים (Authenticated) ולא מאומתים (Unauthenticated) #
Supabase ממפה כל בקשה לאחד מהתפקידים:
• anon : בקשה לא מאומתת (המשתמש אינו מחובר)
• authenticated: בקשה מאומתת (המשתמש מחובר)
אלו הם Postgres Roles. אתה יכול להשתמש בתפקידים אלו בתוך ה-Policies שלך באמצעות סעיף ה-TO:
1 create policy " Profiles are viewable by everyone " 2 on profiles for select 3 to authenticated, anon 4 using ( true ); 5 6 -- OR 7 8 create policy " Public profiles are viewable only by authenticated users " 9 on profiles for select 10 to authenticated 11 using ( true );
השימוש בתפקיד anon ב-Postgres שונה ממשתמש אנונימי ב-Supabase Auth. משתמש אנונימי נוטל על עצמו את התפקיד authenticated כדי לגשת למסד הנתונים, וניתן להבדיל בינו לבין משתמש קבוע על ידי בדיקת ה-claim is_anonymous ב-JWT.
מדיניות שקוראת ל-anon באמצעות (true) מעניקה לכל מבקר לא מאומת גישת קריאה לכל שורה שהתפקיד כבר יכול להגיע אליה באמצעות הרשאות. השתמש בזה רק עבור נתונים שנועדו להיות ציבוריים.
Views ו-RLS #
תצוגות (Views) עוקפות את RLS כברירת מחדל מכיוון שהן נוצרות בדרך כלל עם המשתמש postgres. זוהי תכונה של Postgres, שיוצרת אוטומטית תצוגות עם security definer. תצוגה מעל טבלה מוגנת חושפת את כל השורות שהמדיניות של הטבלה נועדה להסתיר, לכן תצוגה דורשת את אותה תשומת לב כמו טבלה. כדי ליצור תצוגה בצורה בטוחה, ראה Expose a view safely.
אבטח טבלה עם RLS #
בצע את השלבים הבאים עבור כל טבלה בסכימה חשופה:
• הפעל את RLS והגדר את המענקים כך שיתאימו לאפליקציה.
• צור קובץ .sql תחת supabase/tests/ המגדיר ומאמת גישת allow ו-deny עבור select, insert, update ו-delete, עבור anon ו-authenticated.
• הפעל את supabase test db ותקן את מה שהוא מדווח.
עד שהסוויטה תעבור, אתה לא יודע אם הפוליסות עושות את מה שהתכוונת.
הפעל את RLS והגדר את ההרשאות #
הפעל את ה-SQL הבא באמצעות SQL Editor ב-Supabase Dashboard או עם psql בחיבור ישיר. כדי להתחבר עם psql, ראה Direct connection. כדי שהשינוי יהיה ניתן לשחזור בסביבות שונות, הכנס את ההצהרות לתוך migration במקום זאת. הרשאות ו-RLS שייכים לאותה הגירה.
הפעל את RLS, ולאחר מכן הגדר את המענקים כך שיתאימו למה שכל תפקיד עושה באפליקציה שלך:
• הפעל את RLS בטבלה: 1 alter table public.reports enable row level security; ברגע ש-RLS מופעל, שום נתון לא נגיש דרך ה-API בעת שימוש במפתח ציבורי (publishable key), עד שתיצור מדיניות.
• בטל הרשאות קיימות משני תפקידי הלקוח: 1 revoke all on table public.reports from anon, authenticated;
• הענק בחזרה רק את הפריבילגיות שהתפקיד צריך: 1 -- משתמשים מחוברים מנהלים דוחות. מבקרים לא מחוברים לא מקבלים כלום. 2 grant select, insert, update, delete on table public.reports to authenticated;
• כתוב את קובץ הבדיקה עבור הטבלה, והפעל את סוויטת הבדיקות: 1 supabase test new reports_rls 2 supabase test db הגדר לכל טבלה שאתה מאבטח קובץ כזה. הדוגמאות להלן מראות מה יש להכניס לקובץ.
נתונים שלקוחות קוראים אך לעולם אינם כותבים, כגון עדכון שעבודה עורפית מאכלסת, מקבלים בחירה בלבד. המדיניות וקובץ הבדיקה הם חלק מאותו שינוי:
1 alter table public . announcements enable row level security ; 2 revoke all on table public . announcements from anon, authenticated; 3 grant select on table public . announcements to anon, authenticated; 4 5 create policy " Anyone can read announcements " 6 on public . announcements for select 7 to anon, authenticated 8 using ( true );
1 -- File: supabase/tests/announcements_rls_test.sql 2 -- Create: supabase test new announcements_rls 3 -- Run: supabase test db 4 -- Repeat for every public-read table you secured. 5 begin ; 6 select plan( 10 ); 7 8 insert into announcements (id, body) 9 values ( ' 33333333-3333-3333-3333-333333333333 ' , ' published ' ); 10 11 -- A read has to return the row. lives_ok passes on an empty result. 12 select ok( 13 not has_table_privilege( ' anon ' , ' public.announcements ' , ' insert,update,delete ' ), 14 ' anon holds no write grant on the feed ' 15 ); 16 select ok( 17 not has_table_privilege( ' authenticated ' , ' public.announcements ' , ' insert,update,delete ' ), 18 ' authenticated holds no write grant on the feed ' 19 ); 20 21 set local role anon; 22 select results_eq( 23 $$ select body from announcements where id = ' 33333333-3333-3333-3333-333333333333 ' $$, 24 array [ 'published' ] , 25 ' anon reads the feed ' 26 ); 27 select throws_ok( 28 $$ insert into announcements select * from announcements$$, 29 ' 42501 ' , 30 null , 31 ' anon cannot insert into the feed ' 32 ); 33 select throws_ok( 34 $$ update announcements set id = id$$, 35 ' 42501 ' , 36 null , 37 ' anon cannot update the feed ' 38 ); 39 select throws_ok( 40 $$ delete from announcements$$, 41 ' 42501 ' , 42 null , 43 ' anon cannot delete from the feed ' 44 ); 45 46 set local role authenticated; 47 select results_eq( 48 $$ select body from announcements where id = ' 33333333-3333-3333-3333-333333333333 ' $$, 49 array [ 'published' ] , 50 ' authenticated reads the feed ' 51 ); 52 select throws_ok( 53 $$ insert into announcements select * from announcements$$, 54 ' 42501 ' , 55 null , 56 ' authenticated cannot insert into the feed ' 57 ); 58 select throws_ok( 59 $$ update announcements set id = id$$, 60 ' 42501 ' , 61 null , 62 ' authenticated cannot update the feed ' 63 ); 64 select throws_ok( 65 $$ delete from announcements$$, 66 ' 42501 ' , 67 null , 68 ' authenticated cannot delete from the feed ' 69 ); 70 71 select * from finish () ; 72 rollback ;
אם טבלאות חדשות עדיין מקבלות הרשאות אוטומטיות, ראה Revoke default privileges. כדי להפעיל את RLS באופן אוטומטי בכל טבלה חדשה, ראה Event triggers.
כתוב מדיניות לכל פעולה #
כתוב מדיניות נפרדת עבור select, insert, update ו-delete. Postgres אינו מקבל מספר פעולות בסעיף for אחד, ומדיניות עבור הכל (for all) מסתירה את הפעולה שכל כלל נועד לכסות.
דוגמאות אלה משתמשות בטבלת פרופילים שבה כל משתמש מנהל רק את השורה שלו:
1 create table profiles ( 2 id uuid primary key , 3 user_id uuid references auth . users , 4 avatar_url text 5 ); 6 7 alter table profiles enable row level security ; 8 9 revoke all on table profiles from anon, authenticated; 10 grant select , insert , update , delete on table profiles to authenticated;
Supabase מספק פונקציות עזר שמפשטות את ה-RLS אם אתה משתמש ב-Supabase Auth. הפונקציה auth.uid() מחזירה את ה-ID של המשתמש שמבצע את הבקשה.
SELECT מדיניות #
אתה יכול לציין מדיניות SELECT באמצעות סעיף ה-using.
1 create policy " Users can view their own profile. " 2 on profiles for select 3 to authenticated 4 using ( ( select auth . uid () ) = user_id );
INSERT מדיניות #
אתה יכול לציין מדיניות INSERT באמצעות סעיף with check. הביטוי with check מבטיח שכל שורה חדשה תואמת לאילוצי המדיניות, כך שמשתמש לא יכול ליצור שורה ששייכת למישהו אחר.
1 create policy " Users can create their own profile. " 2 on profiles for insert 3 to authenticated 4 with check ( ( select auth . uid () ) = user_id );
UPDATE מדיניות #
אתה יכול לציין מדיניות UPDATE על ידי שילוב של ביטויי ה-using וה-with check. סעיף ה-using מחליט אילו שורות קיימות ניתן לעדכן. סעיף ה-with check מחליט כיצד מותר לשורה המתקבלת להיראות, מה שמונע ממשתמש להקצות מחדש את ה-user_id למישהו אחר.
1 create policy " Users can update their own profile. " 2 on profiles for update 3 to authenticated 4 using ( ( select auth . uid () ) = user_id ) -- checks the existing row 5 with check ( ( select auth . uid () ) = user_id ); -- checks the resulting row
אם לא מוגדר ביטוי with check, ביטוי ה-using מחליט גם אילו שורות גלויות וגם אילו שורות חדשות מותרות.
כדי לבצע פעולת UPDATE, נדרשת מדיניות SELECT מתאימה. ללא מדיניות SELECT, פעולת ה-UPDATE לא תעבוד כמצופה.
DELETE מדיניות #
אתה יכול לציין מדיניות DELETE באמצעות סעיף ה-using.
1 create policy " Users can delete their own profile. " 2 on profiles for delete 3 to authenticated 4 using ( ( select auth . uid () ) = user_id );
בדיקות מדיניות #
כאשר אתה מתאים את ארבע המדיניות הללו לטבלה, הוסף את הקובץ הזה עבור אותה טבלה. הנתיב הוא supabase/tests/<table>_rls_test.sql. עבור טבלה שמשתמשים חולקים, ודא גם שחבר שאינו הבעלים יכול לבצע את הפעולות שהמדיניות מאפשרת לו, ושמי שאינו חבר לא יכול.
קריאה וכלים קשורים
אבטחת Supabase / PostgreSQL- Lovable AI Security — סריקת אבטחה מובנית ב-Lovable
- pgAudit — תיעוד פעולות ושאילתות PostgreSQL לצורכי ביקורת; נדרשת תצורה והגנה על לוגים.
- sqlmap — בדיקת הזרקות SQL בסביבות מורשות בלבד; כלי כללי ל־SQL Server, MySQL ו־PostgreSQL.
- פיתוח כלי AI לניהול משימות עם Bolt ו-Supabase
- חשיפת מידע ב-Lovable: כך הגדרות שגויות ב-Supabase מסכנות את המידע שלכם
- חולשות בבסיסי נתונים פופולריים מאפשרות הרצת קוד מלאה