ממשק API לאימות באינטרנט

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

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

השרת חייב ליישם פרוטוקול HTTPS באמצעות GET. מבצע השילוב יכול להגדיר את הנתיב והמארח. מבצע השילוב חייב לתמוך באורכים של כתובות URL של 2,048 תווים. זה כולל את הסכמה, המארח, היציאה, הנתיב והפרמטרים.

כל הפרמטרים יהיו בקידוד UTF-8 לפני קידוד כתובות URL.

בקשה

אם תתקבל בקשה לכך, Google מספקת את הפרטים הבאים כפרמטרים של כתובות URL:

שדות
gspMajorVersion int

מספר הגרסה הראשית לבקשה הזו.

gspAuthenticationRequest AuthenticationRequest

בקשת אימות.

gspAssociationId string

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

gspCallbackUrl string

כתובת ה-URL שאליה המשתמש יופנה כדי לסיים את תהליך האימות ב-Google. הערך הזה מקודד בכתובת ה-URL.

תשובה

אחרי שהאימות יושלם, המשתמש יופנה אוטומטית ל-gspCallbackUrl באמצעות HTTPS GET. כתובת ה-URL הזו חייבת לכלול את הפרמטרים הבאים של השאילתה:

שדות
gspResult int

100
האימות הצליח.
201 המשתמש ביטל את התהליך באופן ידני ויש לבטל את הזרימה.
202 האימות נכשל מסיבה חמורה, ויש לבטל את הזרימה.

gspAuthenticationResponse AuthenticationResponse

תגובת אימות.