חזרה לפיד
articlesמקור: Lovable Blog20.8.2026

אימות אפליקציית Lovable לגישה לנתוני צד ג'

אמ;לק

מדריך למפתחי Lovable על תהליך האימות מול Google לצורך קבלת גישה לנתוני משתמשים. הסבר על חשיבות אבטחת ה-OAuth וכיצד לעבור את תהליך הסקירה של Google בהצלחה.

סיכום בעברית: מערכת VibeSec · מדיניות המקורות

נוסף ל-VibeSec:

כותרת מקורית: How to get your app verified for third-party data access

$cat article.txt

>מדריך למפתחי Lovable על תהליך האימות מול Google לצורך קבלת גישה לנתוני משתמשים. הסבר על חשיבות אבטחת ה-OAuth וכיצד לעבור את תהליך הסקירה של…

התוכן המלא בעברית

תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.

Matthew Canaday בנה את SkyRingAI, פקידת קבלה מבוססת AI עבור עסקים המעניקים שירותי בית. המערכת עונה לשיחות, מבצעת סינון של המתקשרים וקובעת תורים ישירות ב-Google Calendar של בעל העסק. כדי לקבוע את הזמן המתאים, המערכת מסתנכרנת עם הזמינות האמיתית של כל משתמש ב-Google Calendar.

בניית מוצר שמתחבר לנתוני Google של כל משתמש הייתה בעבר משימה מסורבלת מאוד עבור מפתח עצמאי כמו Matthew. היא כללה בניית מנגנון אימות (authentication), אחסון מאובטח של אישורי גישה, ניתוב כל בקשה דרך הרשאות המשתמש המתאימות ותחזוקת מודל האבטחה הנדרש.

בעזרת מחברי המשתמשים לאפליקציה (app user connectors), Lovable מטפלת כיום בתשתית הטכנית. כל משתמש מחבר את החשבון האישי שלו. אישורי הגישה נשארים בתוך שער המחברים (connector gateway) של Lovable, והאפליקציה פועלת באמצעות ההרשאות הקיימות של אותו אדם.

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

ספקים - כגון ⁦Google⁩, ⁦HubSpot⁩, ⁦Slack⁩ - דורשים לעתים קרובות אפליקציות להיבדק לפני שהם יכולים להתחבר לנתוני משתמש. דיברנו עם ⁦Matthew⁩ כדי לעזור לפרק את התהליך של ⁦Google⁩ עבור אחרים. במאמר זה, נסביר כיצד לנווט בבנייה עם נתוני משתמש של צד שלישי, תוך שימוש בניסיון של ⁦Matthew⁩ עם ⁦Google⁩ כדוגמה.

האחריות המשותפת מאחורי נתוני משתמש של צד שלישי

כאשר אפליקציה ⁦Lovable⁩ עובדת עם נתוני ⁦Google Calendar⁩ של משתמש (או כל נתון של צד שלישי), האחריות לנתונים הללו מתחלקת בין שלושה צדדים.

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

הבסיס הטכני הזה חייב להישמר גם כאשר המשתמשים אינם פעילים באפליקציה. לדוגמה, פקידת הקבלה של SkyRingAI קובעת פגישה ביומן של בעל העסק בשעה 21:00, גם כשהמשתמש אינו משתמש באפליקציה באותו רגע. ניהול מאובטח של גישה זו, ללא צורך בהתערבות המשתמש בכל בקשה, נקרא גישה לא מקוונת (offline access). מתחת למכסה המנוע, Lovable שומרת על החיבור חי ומאובטח גם כשהמשתמש אינו מחובר, מה שמאפשר לאפליקציות להמשיך לפעול בשמו גם לאחר סיום הסשן.

לפרטי אבטחה מעמיקים יותר, ראה כיצד ⁦Lovable⁩ מאבטח נתונים מחוברים באפליקציות ייצור.

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

ספק הצד השלישי (למשל Google, ⁦Slack⁩, ⁦HubSpot⁩) מחליט אילו אפליקציות יכולות לגשת לנתוני המשתמשים שלו. ⁦Google⁩ וספקים אחרים מגדירים את ההרשאות שאפליקציה יכולה לבקש. הם משתמשים בתהליכי סקירה כדי להעריך כיצד אפליקציה מטפלת בנתוני משתמשים לפני מתן גישה לציבור.

קביעה אם האפליקציה שלך זקוקה לבדיקה

לא כל אפליקציה שמתחברת ל-⁦Google⁩ זקוקה לבדיקה. אתה יכול לבנות ולבדוק אפליקציה חיצונית עם קבוצה מוגבלת של משתמשי בדיקה לפני הגשה לבדיקה. ניתן להגדיר אפליקציות המשמשות בתוך ארגון אחד ⁦Google Workspace⁩ כפנימיים ואין צורך בבדיקה.

תהליך הבדיקה תלוי בהרשאות שהאפליקציה דורשת. גוגל מכנה הרשאות אלו "scopes" (היקפים). היקף מגדיר מה אפליקציה יכולה לעשות עם נתוני ה-Google של המשתמש, כגון צפייה בזמינות ביומן, קריאת פרטי אירועים, יצירת קבצים או שליחת דואר אלקטרוני.

כאשר אתה מוסיף היקפים בדף ⁦Data Access⁩ ב-⁦Google Cloud Console⁩, ⁦Google⁩ מתייג כל אחד כבלתי רגיש, רגיש או מוגבל.

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

• היקפים רגישים (Sensitive scopes) חושפים נתוני משתמש פרטיים או מאפשרים לאפליקציה לפעול על פיהם. קריאת אירועי Google Calendar היא דוגמה אחת לכך. גוגל בוחנת מדוע המוצר זקוק לגישה זו והיכן הפונקציונליות הזו מופיעה באפליקציה.

• היקפים מוגבלים (Restricted scopes) מספקים גישה רחבה לנתוני משתמש ב-Google. למשל, gmail.readonly מאפשר לצפות בהודעות דוא"ל ובהגדרות המשתמש. drive.readonly מאפשר לצפות ולהוריד את כל הקבצים ב-Google Drive של המשתמש. שלא כמו היקפים רגישים, היקפים מוגבלים מוסיפים הערכת אבטחה נפרדת דרך מסגרת CASA, שעליכם לחזור עליה מדי שנה. הבדל זה משפיע הן על לוח הזמנים של ההשקה והן על האחריות השוטפת שלכם.

לכן, הוספת גישת Drive ו-Gmail מראש "למקרה שתזדקק להם מאוחר יותר" היא לא רק סימון בתיבת בחירה נוספת; זה עלול להעביר את האפליקציה שלך לשכבה הדורשת ביקורת תקופתית בתשלום. היקפים מוגבלים מוסיפים דרישה להערכת אבטחה שנתית ועשויים לגרור עלויות של הערכת צד שלישי. במקרה של SkyRingAI, Matthew ביקש הרשאות ניהול ליומן (קריאה, כתיבה, ביטול, תזמון) ותו לא.

רמת ההרשאות שהאפליקציה שלך צריכה קובעת עד כמה הבדיקה תהיה יסודית. התווית ⁦Google⁩ מופיעה כאשר אתה מוסיף את ההיקף קובע אילו דרישות חלות. מרכז העזרה לאימות ⁦OAuth⁩ של Google מסביר את נתיבי הבדיקה והחריגים.

תהליך האימות ⁦Google⁩ ⁦OAuth⁩

העצה של מתיו הייתה פשוטה: החליטו בדיוק מה האפליקציה צריכה לפני שתבקשו מ-⁦Google⁩ גישה.

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

1. תחילה הגדר את התכונה הפונה למשתמש

לפני שאתה פותח את ⁦Google Cloud Console⁩, קבל ספציפי לגבי מה המשתמש צריך להיות מסוגל לעשות ואילו נתונים של ⁦Google⁩ מאפשרים זאת.

עבור ⁦SkyRingAI⁩, המשרה הרלוונטית הייתה תזמון. האפליקציה נדרשת לבדיקת זמינות והזמנת תור.

• האם האפליקציה קוראת, יוצרת, מעדכנת או מוחקת משהו

• מדוע הרשאה צרה יותר תמנע מהתכונה לפעול

תשתמש ברשימה זו כדי לבחור היקפים, לכתוב את גילויי הפרטיות, להקליט את ההליכה ולענות על שאלות הביקורת של ⁦Google⁩.

2. מפה כל תכונה להיקפים המינימליים הדרושים לה

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

ברגע שיש לך את רשימת התכונות, מפה כל אחת מהן לטווח הצר ביותר ⁦Google⁩ שתומך בה. עבור ⁦Google Calendar⁩, אם האפליקציה שלך רק צריכה לראות אם מישהו פנוי, ייתכן ש-calendar.freebusy מספיק. עם זאת, אם אתה צריך ליצור או לערוך אירועים, calendar.events עשוי להיות טווח מתאים יותר.

מדריך ההרשאות ⁦Calendar⁩ של Google מפרט את הסט המלא של היקפים ומה כל אחד מאפשר.

עבור כל תחום רגיש או מוגבל, היה מוכן להסביר:

• מדוע התכונה לא יכולה לעבוד עם היקף צר יותר

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

3. בנה את האפליקציה ובדוק את החיבור ⁦Google⁩

בשלב זה, בנה את הפיצ'ר הגלוי והגדר את ה-Google OAuth בסביבת בדיקה. ברמה גבוהה, תרצה לוודא שלאפליקציה יש את ה-APIs, ה-scopes ומסך ההסכמה (OAuth consent screen) הנכונים. לאחר מכן, צור OAuth client מסוג Web application עם ה-redirect URI של Lovable והזן את ה-client ID וה-secret בהגדרות החיבור של Lovable. בסיום, משתמש בדיקה צריך להיות מסוגל להיכנס, להעניק גישה ולהשתמש בפיצ'ר מתחילתו ועד סופו.

לקבלת השלבים המדויקים, עקוב אחר מדריך האימות וההרשאות השלב אחר שלב של ⁦Google⁩ .

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

4. הכן את הנכסים מול הלקוחות שלך

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

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

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

5. הקלט הדרכה של האפליקציה שפועלת

Google דורשת סרטון הדגמה כאשר אתה שולח אפליקציה שמשתמשת בהיקפים רגישים או מוגבלים. למדריך המלא על מה שהדגמת ההליכה צריכה להראות, ⁦Step⁩ 2 בסעיף ⁦Sensitive and Restricted Scope Requirements⁩ של דרישות האימות עובר על זה בפירוט.

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

6. שלח מ-⁦Google Cloud Console⁩ והישאר נגיש

ברגע שאפליקציית הייצור, המיתוג, ה-scopes וחומרי העזר מוכנים, בצע את תהליך ההגשה של גוגל. פתח את Audience ב-Google Auth Platform. שנה את סטטוס הפרסום מ-Testing ל-In production על ידי בחירה ב-Publish app. לאחר מכן בחר ב-Prepare for verification והשלם את תהליך ה-Submit for verification.

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

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

7. היה מוכן לתת ⁦Google⁩ נתיב עבודה לתוך האפליקציה

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

אם התכונה נמצאת מאחורי ההתחברות של האפליקציה שלך, ⁦Google⁩ עשוי לבקש מאוחר יותר דרך לבדוק אותה. אם זה קורה, השב לדוא"ל האימות ⁦OAuth⁩ עם:

• ⁦Instructions⁩ כדי להגיע לחיבור ⁦Google⁩

• דוא"ל לבודק הרשום או חשבון ניסיון, במידת הצורך

• כל נתון או קלט לדוגמה הנדרשים להפעלת התכונה

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

8. שמור על הגישה עדכנית לאחר שתאושר

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

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

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

• החלפת מפתחות (Secret rotation). החלף את ה-OAuth client secret שלך מעת לעת, הן ב-Google Cloud Console והן בהגדרות החיבור של Lovable. אל תשאיר אותו ללא שינוי במשך שנים.

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

• הערכה מחדש שנתית. אם האפליקציה שלך משתמשת בהיקפים מוגבלים, הערכת האבטחה ⁦CASA⁩ חוזרת על עצמה מדי שנה. גוגל שולחת דוא"ל לבעלי הפרויקט ולעורכים, אז שמרו על אנשי הקשר האלה מעודכנים.

תתחיל לבנות

#lovable#oauth#vibe-coding
קרא במקור