כניסה לחשבון מקושר

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

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

הדרישות

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

• יש לכם הטמעה של קישור OAuth לחשבון Google שתומכת בתהליך קוד האימות של OAuth 2.0. הטמעת OAuth חייבת לכלול את נקודות הקצה הבאות:
  • נקודת קצה להרשאה לטיפול בבקשות הרשאה.
  • נקודת קצה (endpoint) של אסימון לטיפול בבקשות לאסימוני גישה ולאסימוני רענון.
  • userinfo endpoint כדי לאחזר פרטי חשבון בסיסיים של המשתמש המקושר, שמוצגים למשתמש במהלך תהליך הכניסה לחשבון המקושר.
• יש לכם אפליקציה ל-Android.

איך זה עובד

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

1. אתם יכולים להביע הסכמה להצגת חשבונות מקושרים במהלך תהליך הכניסה בנגיעה אחת.
2. למשתמש תוצג בקשה לכניסה בנגיעה אחת עם אפשרות להיכנס לשירות באמצעות החשבון המקושר שלו.
3. אם המשתמש יבחר להמשיך עם החשבון המקושר, Google תשלח בקשה לנקודת הקצה של האסימון כדי לשמור קוד הרשאה. הבקשה מכילה את טוקן הגישה של המשתמש שהונפק על ידי השירות שלכם וקוד הרשאה של Google.
4. מחליפים את קוד ההרשאה של Google בטוקן מזהה של Google שמכיל מידע על חשבון Google של המשתמש.
5. האפליקציה מקבלת גם אסימון מזהה בסיום התהליך, ואתם מתאימים אותו למזהה המשתמש באסימון המזהה שהשרת קיבל כדי לאפשר למשתמש להיכנס לאפליקציה.

הטמעת כניסה באמצעות חשבון מקושר באפליקציה ל-Android

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

טיפול בבקשות לקבלת קוד הרשאה מ-Google

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

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

בקשת HTTP

בקשה לדוגמה

POST /token HTTP/1.1
Host: server.example.com
Content-Type: application/x-www-form-urlencoded

code=GOOGLE_AUTHORIZATION_CODE
&grant_type=urn:ietf:params:oauth:grant-type:reciprocal
&client_id=CLIENT_ID
&client_secret=CLIENT_SECRET
&access_token=ACCESS_TOKEN

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

נקודת הקצה להחלפת האסימון צריכה להגיב לבקשת ה-POST באופן הבא:

• מוודאים שה-access_token הוענק ל-Google שזוהתה באמצעות client_id.
• אם הבקשה תקינה וקוד האימות הוחלף בהצלחה באסימון מזהה של Google, צריך להשיב עם תגובה מסוג HTTP 200 (OK). אם הבקשה לא תקינה, צריך להשיב עם קוד שגיאה מסוג HTTP.

תגובת HTTP

הצלחה

החזרת קוד הסטטוס HTTP 200 OK

דוגמה לתשובה על הצלחה

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache
{}

שגיאות

במקרה של בקשת HTTP לא חוקית, יש להשיב עם אחד מקודי השגיאה הבאים של HTTP:

תגובת השגיאה צריכה להכיל את השדות הבאים :

דוגמה לתשובה עם שגיאה 400

HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
  "error": "invalid_request",
  "error_description": "Request was missing the 'access_token' parameter."
}

המרת קוד הרשאה לאסימון מזהה

תצטרכו להמיר את קוד ההרשאה שקיבלת לטוקן מזהה של Google שמכיל מידע על חשבון Google של המשתמש.

כדי להמיר קוד הרשאה לאסימון מזהה של Google, צריך לבצע קריאה לנקודת הקצה https://oauth2.googleapis.com/token ולהגדיר את הפרמטרים הבאים:

בקשה לדוגמה

POST /oauth2/v4/token HTTP/1.1
Host: www.googleapis.com
Content-Type: application/x-www-form-urlencoded

code=GOOGLE_AUTHORIZATION_CODE
&grant_type=authorization_code
&client_id=GOOGLE_CLIENT_ID
&client_secret=GOOGLE_CLIENT_SECRET

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

התגובה כוללת את השדות הבאים:

דוגמה לתשובה

HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8

{
  "access_token": "Google-access-token",
  "id_token": "Google-ID-token",
  "expires_in": 3599,
  "token_type": "Bearer",
  "scope": "openid",
  "refresh_token": "Google-refresh-token"
}


POST /oauth2/v4/token HTTP/1.1
Host: www.googleapis.com
Content-Type: application/x-www-form-urlencoded

code=Google authorization code
&grant_type=authorization_code
&client_id=Google client id
&client_secret=Google client secret

אימות התשובה של אסימון המזהה