חוויית הכניסה היא האינטראקציה הראשונה של משתמש עם התוסף, לכן חשוב שהוא יוכל להשלים את התהליך בצורה חלקה ככל האפשר. בקטעים הבאים נסביר על ממשקי ה-API השונים לכניסה, על פרמטרים של שאילתות שקשורות לכניסה, איך לטפל בחוסמי חלונות קופצים ותוכנית לבדיקה שבה תוכלו להשתמש במהלך הפיתוח כדי לוודא שאתם פועלים לפי השיטות המומלצות.
פרטי ההטמעה של SSO
OAuth 2.0 של Google תואם להרבה מקבצים של OAuth 2.0. אנחנו מאוד ממליצים ליישם הרשאה בצד השרת, כי זו אפשרות האבטחה הגבוהה ביותר, והיא תומכת בשימוש בפרמטרים של שאילתות iframe.
כשמטמיעים את הכניסה באמצעות חשבון Google, אפשר לעיין בהנחיות הטכניות שמפורטות באתר של Google Identity. הקפידו לפעול לפי ההנחיות של Google למיתוג לצורך כניסה. קובצי Sketch , SVG ו-EPS ניתנים להורדה.
בדיקות כניסה
לפני ששולחים את התוסף לבדיקה, כדאי להשתמש בתוכנית הבדיקה של התוספים כדי לוודא שהוא עומד בתקנים הנדרשים ויכול לטפל במקרי קצה ידועים. הבדיקות האלה דומות מאוד לרשימת המשימות לדרישות של התוסף ל-Classroom, ונותנות הוראות מפורטות כדי לבדוק אם התוסף עומד בדרישות האלה. אלו אותן הבדיקות שעבורן האפליקציה נבדקת בזמן הפרסום.
פרמטרים של שאילתת כניסה
ב-Google Classroom אפשר לקבל את פרמטר השאילתה login_hint כדי לעזור בכניסות חוזרות. למידע נוסף, קראו את הקטע פרמטרים הקשורים לכניסה בדף הפרמטרים של שאילתת iframe. קוד לדוגמה מופיע בהדרכה המפורטת לגבי ביקורים חוזרים בהדרכות מפורטות למפתחים.
ניהול של חוסמי חלונות קופצים
אפשר להיכנס לתוסף דרך חלון תיבת הדו-שיח לכניסה. בחלון הזה מוצג מסך של בורר החשבונות, ומאפשר למשתמש להעניק הרשאות OAuth. חוסם החלונות הקופצים של משתמשי הקצה עלול למנוע מהם להשלים את תהליך הכניסה.
איור 1. דוגמה למסך בורר חשבונות.
כדי לפתור את הבעיה, צריך לספק למשתמש הקצה לחצן שניתן ללחוץ עליו כדי לעקוף את חוסם החלונות הקופצים. אינטראקציה זו מאפשרת להציג את תיבת הדו-שיח לכניסה, כך שמשתמש הקצה יוכל להמשיך בתהליך הכניסה. חשוב לוודא שהלחצן שאתם מספקים תואם להנחיות המיתוג לכניסה.
כדי להטמיע לחצן כניסה ממותג של Google, אפשר ללחוץ עליו כדי להפעיל את תיבת הדו-שיח לכניסה בהדרכה המפורטת לכניסה.
התחברות מרובה
דפדפן עם מספר חשבונות שמחוברים בו-זמנית עלול לשבש את זרימת המשתמש של התוסף. משתמשי הקצה יכולים לצאת מכל חשבונות Google בדפדפן הנוכחי שלהם או לפתוח את Classroom בחלון Chrome פרטי לפני שהם נכנסים לחשבון הנכון ומנסים לבצע את הפעולה שוב.
אם משתמש שגוי נכנס לתוסף בגלל הבעיה בריבוי התחברויות, יכול להיות שהקריאות ל-API של התוספים ב-Classroom ייכשלו ותוצג הודעת השגיאה InvalidAddOnToken. אם קיבלתם הודעת שגיאה כזו, בקשו מהמשתמשים לצאת מכל החשבונות האחרים בדפדפן, או לפתוח את Classroom בחלון פרטי של Chrome.