לפני שמשיקים למשתמשים חיצוניים אפליקציה שמבקשת פרטי כניסה של משתמשים ל-Data Manager API, הפרויקט ב-Google Cloud צריך לעבור אימות של אפליקציית Google OAuth.
במדריך הזה מוסבר איך להגדיר את הקהל במהלך הפיתוח ואיך להשלים את אימות האפליקציה ב-Google OAuth.
שלבים של קהל באפליקציה
בהתאם לשלב הפיתוח, מגדירים את הדף Audience במסוף Google Cloud עם הגדרות שונות של User type ו-Publishing status. כדי שהמעבר מהבדיקה הראשונית להשקה בסביבת הייצור יהיה חלק, כדאי לפעול לפי השלבים הבאים.
שלב 1: פיתוח ראשוני (בדיקה)
כשמתחילים לפתח ולבדוק בקשות API בסיסיות:
- סטטוס הפרסום: מוגדר לבדיקה.
סוג המשתמש:
אם פרויקט בענן ב-Google Cloud שייך לארגון ב-Google Workspace ורק משתמשים בארגון משתמשים באפליקציה, בוחרים באפשרות Internal.
אחרת, בוחרים באפשרות חיצוני.
משתמשי בדיקה: אם הגדרתם את סוג המשתמש ל-חיצוני, לחצו על הוספת משתמשים כדי להוסיף באופן ידני את חשבונות Google שבהם אתם משתמשים כדי ליצור פרטי כניסה. רק חשבונות Google שמופיעים ברשימה יכולים לאשר את האפליקציה, וחלים מגבלות בדיקה וכללים לתפוגת תוקף של טוקנים.
אימות: לא נדרש במהלך הבדיקה. אם משתמשים באפשרות חיצוני, למשתמשי הבדיקה מוצג מסך אזהרה שמאשר שיש להם גישת בדיקה לאפליקציה לא מאומתת לפני שהם ממשיכים למסך ההסכמה.
שלב 2: לקראת ההשקה (שליחת בקשת אימות)
כשהשילוב הושלם, ממשק המשתמש נבנה ואתם מתכננים להשיק את האפליקציה בחודש הקרוב:
- סטטוס הפרסום: עובר לסטטוס בייצור.
- סוג המשתמש: אם האפליקציה משרתת לקוחות מחוץ לארגון, כמו לקוחות של מפרסמים, מגדירים את סוג המשתמש כחיצוני.
- פעולה: שולחים את האפליקציה לאימות. תהליך האימות של אפליקציית Google OAuth יכול להימשך כמה שבועות, לכן כדאי לשלוח את הבקשה מוקדם ככל האפשר אחרי שממשק המשתמש מוכן.
- טיפול בבודקים מוקדמים: במהלך בדיקת האימות, האפליקציה נשארת לא מאומתת למשתמשים חיצוניים. אם אתם צריכים להוסיף בודקים מוקדמים של גרסת הבטא:
- צריך להודיע להם שהם יראו את מסך האפליקציה הלא מאומתת.
- מנחים אותם להמשיך על ידי לחיצה על מתקדם ואז על מעבר אל APP_NAME (לא בטוח).
הדרישות לאימות האפליקציה
כדי לשלוח את האפליקציה לאימות במרכז האימות, צריך לקבוע את ההגדרות של פלטפורמת האימות של Google ולהכין את החומרים הנדרשים לאימות.
היקפי הרשאות לאימות
בדף Data Access, מבקשים רק את היקפי ההרשאות שהאפליקציה צריכה. Data Manager API משתמש בהיקפי הרשאות רגישים:
https://www.googleapis.com/auth/datamanager(היקף ראשי)-
https://www.googleapis.com/auth/datamanager.partnerlink(לקישורים של שותפים)
פרטים ליצירת קשר
צוות האימות של Google OAuth שולח את כל ההודעות לבעלי הפרויקט ולעורכי הפרויקט שמוגדרים בפרויקט ב-Google Cloud. חשוב לעדכן את הפרטים ליצירת קשר במסוף Google Cloud כדי לא לפספס בקשות למידע.
סרטון הדגמה
צריך לספק קישור לסרטון הדגמה שגלוי לכולם (למשל, סרטון לא רשום ב-YouTube או קישור ציבורי ל-Google Drive) שמראה איך האפליקציה משתמשת בהיקפי ההרשאות המבוקשים.
חשוב לוודא שהסרטון עומד בדרישות לגבי סרטון הדגמה של פונקציונליות האפליקציה.
שלב 3: מוכן להפעלה (מאומת)
אחרי שצוות האימות של Google OAuth יודיע לכם שבקשת אימות האפליקציה אושרה, לא תצטרכו לעשות שום דבר. האפליקציה מאומתת עכשיו, ומשתמשים חיצוניים יכולים לאשר אותה בלי שיוצג להם מסך האזהרה לגבי אפליקציה לא מאומתת.