אבטחת Data API
אמ;לק
סיכום בעברית: מערכת VibeSec · מדיניות המקורות
נוסף ל-VibeSec:
>שילוב GRANT מפורש ו-RLS עבור אובייקטים החשופים דרך API.
התוכן המלא בעברית
תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.
מדריך זה מסביר כיצד לאבטח את ה-Data API באמצעות הרשאות (Grants) של Postgres, Row Level Security, סכימות ייעודיות ובדיקות בקשות.
• Understand Data API security מסביר כיצד בקרות אלו פועלות ומתי להשתמש בהן.
• Configure Data API security מרכז את הנהלים להחלת בקרות אלו.
קרא את הסעיף הראשון כאשר עליך לבחור גישת אבטחה. עברו ישירות לסעיף השני כאשר אתם יודעים אילו בקרות עליכם להגדיר.
הבנת האבטחה של Data API #
סעיף זה מספק את ההקשר להליכים בהמשך המדריך.
Grants ו-RLS #
ה-Data API פועל עם שתי שכבות של בקרת גישה ב-Postgres:
• Grants קובעים אילו תפקידי (roles) Postgres יכולים לגשת לטבלה, View או פונקציה דרך ה-Data API. תפקידים אלה כוללים anon, authenticated ו-service_role.
• מדיניות Row Level Security (RLS) קובעת אילו שורות תפקידים אלה יכולים לקרוא או לשנות.
Grants שולטים בשאלה האם תפקיד יכול לגשת לאובייקט. RLS שולט באילו שורות התפקיד יכול לגשת. השתמש בשתי הבקרות עבור כל אובייקט חשוף.
כדי להחיל בקרות אלו, עיינו ב-Grant access explicitly ו-Enable RLS policies.
הרשאות ברירת מחדל #
בפרויקטים קיימים, אובייקטים חדשים ב-public מקבלים את הרשאות ברירת המחדל הבאות:
הרשאות אלה מאפשרות גישה לאובייקטים חדשים דרך ה-Data API, גם כאשר אינכם מתכוונים לחשוף אותם. בהגדרות ה-Data API, השביתו את Automatically expose new tables כדי לבטל את ההרשאות שבהן משתמש ה-Data API. ההרשאות הבאות נשארות ללא שינוי:
• טבלאות ורצפים (sequences): טבלאות חדשות שומרות על truncate, references, trigger ו-maintain, ורצפים חדשים שומרים על update. ה-Data API אינו משתמש בהרשאות אלו, אך קוד SQL שרץ כ-anon או authenticated יכול, למשל בתוך פונקציית מסד נתונים.
• פונקציות: פונקציות חדשות ניתנות להפעלה על ידי כל תפקיד. Postgres מעניק הרשאת execute ל-PUBLIC כברירת מחדל גלובלית, ופעולת revoke המוגבלת לסכימה אחת לא יכולה להסיר זאת.
כדי לבטל גם הרשאות אלו, עיינו ב-Revoke default privileges.
Supabase משנה את ברירת המחדל של הפלטפורמה כדי לבטל הרשאות אוטומטיות אלו, כך שהחשיפה תהפוך לבחירה יזומה (opt-in). עיינו בדיון על ברירות המחדל של הפלטפורמה ב-GitHub Discussions של Supabase.
הרשאות ברירת המחדל הן חלק ממודל ההרשאות הסטנדרטי של Supabase ואינן עוקפות את ה-RLS. התפקיד הפנימי supabase_admin מעניק אותן ל-anon, authenticated ו-service_role, אך הוא אינו יכול לבצע אימות דרך ה-Data API. עיינו ב-pg_default_acl בתיעוד Postgres וב-supabase_admin בתיעוד Supabase.
כדי לראות אילו הרשאות הפרויקט שלכם מעניק על אובייקטים חדשים, עיינו ב-Check your default privileges. כדי למנוע הענקת הרשאות אוטומטית לאובייקטים חדשים, עיינו ב-Revoke default privileges.
סכימות API ייעודיות #
סכימה ייעודית מוסיפה גבול נוסף סביב ה-Data API שלכם. אובייקטים בסכימה כגון api מגדירים את שטח ה-API. טבלאות פנימיות ופונקציות עזר נשארות בסכימות שאינן חשופות.
ניתן לשלוט בגישה באמצעות Grants בכל סכימה. סכימה ייעודית הופכת את השטח החשוף לקל יותר לזיהוי ולביקורת. עיינו ב-Using Custom Schemas לשלבי ההגדרה.
בדיקות לפני בקשה (Pre-request checks) #
מדיניות RLS אינה מכסה כל דרישת אבטחה של API. הוסיפו בדיקות לפני ביצוע בקשה (pre-request checks) לדרישות כגון:
• אכיפת מגבלות קצב (rate limits) לפי IP או לפי משתמש.
• בדיקת מפתחות API מותאמים אישית או נוספים לפני מתן גישה נוספת.
• דחיית בקשות לאחר חריגה ממכסה או דרישת תשלום.
• אי מתן גישה ישירה לטבלאות, תצוגות או פונקציות מסוימות בסכמות חשופות.
פונקציית pre-request של Postgres קוראת את פרטי הבקשה ומבצעת בדיקות אלו לפני מתן תגובה. לדוגמה, הפונקציה יכולה לספור בקשות או לאמת מפתח API.
להוספת בדיקה, עיינו ב-Configure a pre-request function.
תצורת pgrst.db_pre_request עובדת רק עם ה-Data API (PostgREST). היא אינה פועלת עם Realtime, Storage או מוצרים אחרים של Supabase.
אם אתם משתמשים ב-db_pre_request כדי לקרוא לפונקציה (כמו set_information()) שמגדירה הקשר או מבצעת בדיקות בכל בקשה, ואתם זקוקים להתנהגות דומה עבור מוצרים אחרים של Supabase, עליכם לקרוא לפונקציה ישירות בתוך מדיניות ה-RLS שלכם במקום זאת.
אם יש לכם פונקציית db_pre_request שקוראת ל-set_information() המחזירה true כדי להגדיר הקשר או לבצע בדיקות, ויש לכם מדיניות RLS כמו:
1 create policy " Individuals can view their own todos. " 2 on todos for select 3 using ( ( select auth . uid () ) = user_id );
כדי להשיג את אותה התנהגות עם מוצרים אחרים של Supabase, עליכם לקרוא לפונקציה ישירות במדיניות ה-RLS שלכם:
1 create policy " Individuals can view their own todos. " 2 on todos for select 3 using ( set_information () AND ( select auth . uid () ) = user_id );
זה מבטיח שהפונקציה תיקרא בעת הערכת מדיניות RLS עבור כל המוצרים, ולא רק עבור בקשות Data API.
שימו לב שקריאה לפונקציות ישירות במדיניות RLS יכולה להשפיע על ביצועי מסד הנתונים, שכן הפונקציה מוערכת עבור כל שורה בעת בדיקת המדיניות. שקלו לבצע אופטימיזציה לפונקציה או להשתמש באסטרטגיות מטמון (caching) אם הביצועים הופכים לבעיה.
מידע על הבקשה #
השתמשו בפונקציה current_setting() של Postgres כדי לגשת למידע הבקשה:
1 -- Get all headers sent in the request 2 select current_setting( ' request.headers ' , true):: json ; 3 4 -- Get one header with a JSON arrow operator 5 select current_setting( ' request.headers ' , true):: json->> ' user-agent ' ; 6 7 -- Get cookies 8 select current_setting( ' request.cookies ' , true):: json ;
כדי לגשת לכתובת ה-IP של הלקוח, חפשו את הכותרת X-Forwarded-For בהגדרת request.headers:
1 select split_part( 2 current_setting( ' request.headers ' , true):: json->> ' x-forwarded-for ' , 3 ' , ' , 1 ); -- takes the client IP before the first comma
ראה Pre-request בתיעוד PostgREST ו-X-Forwarded-For בתיעוד MDN.
להטמעות מלאות המשתמשות במידע בקשה זה, עיינו ב-Pre-request examples.
תגובות שגיאה #
פונקציית pre-request יכולה להעלות חריגה (exception) כדי לעצור בקשה. דוגמה זו מחזירה תגובת HTTP 402 Payment Required עם רמז וכותרת X-Powered-By:
1 raise sqlstate ' PGRST ' using 2 message = json_build_object( 3 ' code ' , ' 123 ' , 4 ' message ' , ' Payment Required ' , 5 ' details ' , ' Quota exceeded ' , 6 ' hint ' , ' Upgrade your plan ' ):: text , 7 detail = json_build_object( 8 ' status ' , 402 , 9 ' headers ' , json_build_object( 10 ' X-Powered-By ' , ' Nerd Rage ' )):: text ;
החריגה מייצרת את תגובת ה-HTTP הבאה:
1 HTTP / 1.1 402 Payment Required 2 Content-Type : application/json; charset=utf-8 3 X-Powered-By : Nerd Rage 4 5 { 6 " message " : " Payment Required " , 7 " details " : " Quota exceeded " , 8 " hint " : " Upgrade your plan " , 9 " code " : " 123 " 10 }
השתמשו בפונקציות ובאופרטורים של JSON כדי לבנות תגובות דינמיות מתוך חריגות. כללו את המפתח status_text בסעיף הפירוט (detail) כאשר אתם משתמשים בקוד סטטוס HTTP מותאם אישית כגון 419. עיינו ב-JSON Functions and Operators בתיעוד של Postgres.
עבור PostgREST 11 ומטה, השתמשו בתחביר המיושן להעלאת שגיאות. בדקו את גרסת ה-PostgREST שלכם ב-Dashboard. עיינו ב-Raise errors with HTTP status codes בתיעוד PostgREST.
הגדרת אבטחת Data API #
סעיף זה מרכז את הנהלים להגדרת כל בקרת אבטחה. החילו את הנהלים המתאימים לארכיטקטורה שלכם.
הענקת גישה במפורש #
לא ניתן לגשת לטבלה דרך ה-Data API אלא אם הענקתם לה הרשאות לתפקיד מסוים. העניקו את הרשאות המינימום שכל תפקיד צריך. לדוגמה:
1 -- Read-only access for anonymous clients 2 grant select on table public . your_table to anon; 3 4 -- Full access for signed-in users; RLS still applies 5 grant select , insert , update , delete on table public . your_table to authenticated; 6 7 -- Full access for server-side code using the service role 8 grant select , insert , update , delete on table public . your_table to service_role; 9 10 -- For functions, grant EXECUTE to the roles that should call them 11 grant execute on function public . your_function () to anon, authenticated;
אם חסר מענק הרשאה נדרש, PostgREST מחזיר שגיאת 42501 עם רמז המציין את הצהרת ההענקה המדויקת שעליכם להריץ:
1 { 2 " code " : " 42501 " , 3 " message " : " permission denied for table your_table " , 4 " hint " : " Grant the required privileges to the current role with: GRANT SELECT ON public.your_table TO anon; " 5 }
עיינו ב-Database API 42501 errors עבור תהליך פתרון הבעיות המלא.
הגירה (Migration): צרפו את ה-Grants להגדרת ה-RLS שלכם באותה מיגרציה. פקודת ה-grant שולטת בגישת התפקיד. הפקודות להפעלת RLS ומדיניות האבטחה שולטות בגישה לשורות.
בדיקת הרשאות ברירת המחדל שלכם #
הרשאות ברירת המחדל שונות בין פרויקטים, בהתאם למועד יצירת הפרויקט ולהגדרות ה-Data API שלו. כדי לראות אילו הרשאות מקבלים אובייקטים חדשים, הריצו את השאילתה הבאה. השתמשו ב-SQL Editor ב-Supabase Dashboard או ב-psql דרך חיבור ישיר:
1 select 2 case d . defaclobjtype 3 when ' r ' then ' tables ' 4 when ' S ' then ' sequences ' 5 when ' f ' then ' functions ' 6 end as object_type, 7 a . grantee ::regrole as role , 8 string_agg ( a . privilege_type , ' , ' order by a . privilege_type ) as privileges 9 from pg_default_acl d 10 cross join lateral aclexplode( d . defaclacl ) a 11 where d . defaclrole = ' postgres ' ::regrole 12 and d . defaclnamespace = ' public ' ::regnamespace 13 and a . grantee in ( ' anon ' ::regrole, ' authenticated ' ::regrole, ' service_role ' ::regrole) 14 group by 1 , 2 15 order by 1 , 2 ;
כל שורה מפרטת תפקיד ואת ההרשאות שהוא מקבל על טבלאות, רצפים או פונקציות חדשות שנוצרות ב-public על ידי התפקיד postgres. כאשר השאילתה אינה מחזירה שורות, אובייקטים חדשים לא מעניקים דבר לתפקידי ה-Data API עד שתעניקו גישה במפורש.
השאילתה אינה מציגה את הרשאת ה-execute שכל פונקציה חדשה מקבלת דרך PUBLIC. כדי להסיר אותה, עיינו ב-Revoke default privileges.
ביטול הרשאות ברירת מחדל (Revoke) #
בטלו הרשאות אוטומטיות כאשר אתם רוצים שאובייקטים חדשים ב-public יישארו בלתי נגישים עד שתעניקו להם גישה:
• הריצו את ההצהרות הבאות: ALTER DEFAULT PRIVILEGES FOR ROLE postgres IN SCHEMA public REVOKE ALL ON TABLES FROM anon, authenticated, service_role; ALTER DEFAULT PRIVILEGES FOR ROLE postgres IN SCHEMA public REVOKE ALL ON SEQUENCES FROM anon, authenticated, service_role; ALTER DEFAULT PRIVILEGES FOR ROLE postgres IN SCHEMA public REVOKE ALL ON FUNCTIONS FROM anon, authenticated, service_role; ALTER DEFAULT PRIVILEGES FOR ROLE postgres REVOKE EXECUTE ON FUNCTIONS FROM PUBLIC;
לאחר מכן, טבלאות, רצפים ופונקציות חדשות ידרשו הענקת הרשאות מפורשת לפני שתפקידי ה-Data API יוכלו לגשת אליהם.
ההצהרה האחרונה מגבילה גם פונקציות ש-postgres יוצר בסכימות אחרות, כגון פונקציות עזר שנקראות על ידי מדיניות ה-RLS שלכם. העניקו הרשאת execute על כל אחת מהפונקציות הללו לתפקידים שקוראים להן, אחרת המדיניות המשתמשת בהן תיכשל. למידע נוסף, עיינו ב-Function privileges.
השבתת ה-Data API #
אם האפליקציה שלכם אינה משתמשת בספריות הלקוח של Supabase, ב-REST או בנקודות קצה של נתוני GraphQL, כבו את ה-Data API:
• פתחו את סקירת האינטגרציה של ה-Data API ב-Dashboard.
כאשר ה-Data API מושבת, אף אחת מנקודות הקצה של ה-REST שנוצרו אוטומטית לא תגיב, ללא קשר ל-Grants או ל-RLS.
הפעלת מדיניות RLS #
ניתן לגשת לטבלאות ו-Views שנחשפו דרך ה-Data API ללא RLS על ידי כל תפקיד עם הרשאות תואמות. הפעילו RLS או הוסיפו בקרות מקבילות כדי למנוע גישה לא מורשית. RLS אינו חל על פונקציות, לכן העניקו הרשאת execute רק לתפקידים שצריכים להפעיל אותן. סקרו היטב כל פונקציית security definer.
הפעילו RLS על כל טבלה ו-View שנחשפו דרך ה-Data API. לאחר מכן תוכלו לכתוב מדיניות המעניקה למשתמשים גישה לשורות ספציפיות על סמך אסימון האימות שלהם.
לטבלאות שנוצרו דרך ה-Supabase Dashboard מופעל ה-RLS כברירת מחדל. הפעילו RLS במפורש עבור טבלאות שנוצרו ב-SQL Editor או באמצעות כלי אחר:
קריאה וכלים קשורים
אבטחת Supabase / PostgreSQL- Lovable AI Security — סריקת אבטחה מובנית ב-Lovable
- pgAudit — תיעוד פעולות ושאילתות PostgreSQL לצורכי ביקורת; נדרשת תצורה והגנה על לוגים.
- sqlmap — בדיקת הזרקות SQL בסביבות מורשות בלבד; כלי כללי ל־SQL Server, MySQL ו־PostgreSQL.
- פיתוח כלי AI לניהול משימות עם Bolt ו-Supabase
- חשיפת מידע ב-Lovable: כך הגדרות שגויות ב-Supabase מסכנות את המידע שלכם
- חולשות בבסיסי נתונים פופולריים מאפשרות הרצת קוד מלאה