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