تسجيل الدخول إلى الحساب المرتبط

تتيح ميزة ربط حساب Google لمالكي حسابات Google إمكانية الربط بخدماتك ومشاركة البيانات مع Google بسرعة وسلاسة وأمان.

تتيح ميزة "تسجيل الدخول باستخدام الحساب المرتبط" ميزة تسجيل الدخول بنقرة واحدة باستخدام حساب Google للمستخدمين الذين سبق أن ربطوا حساباتهم على Google بخدمتك. ويؤدي ذلك إلى تحسين تجربة المستخدمين، إذ يمكنهم تسجيل الدخول بنقرة واحدة بدون إعادة إدخال اسم المستخدم وكلمة المرور. ويقلّل ذلك أيضًا من فرص إنشاء المستخدمين لحسابات مكرّرة على خدمتك.

المتطلبات

لاستخدام ميزة "تسجيل الدخول باستخدام حساب مرتبط"، يجب استيفاء المتطلبات التالية:

• لديك عملية تنفيذ ربط حساب Google باستخدام بروتوكول OAuth تتيح مسار رمز المصادقة في OAuth 2.0. يجب أن يتضمّن تنفيذ OAuth نقاط النهاية التالية:
  • نقطة نهاية التفويض لمعالجة طلبات التفويض
  • نقطة نهاية الرموز المميزة لمعالجة طلب رموز الوصول وإعادة التحميل
  • نقطة نهاية userinfo لاسترداد معلومات الحساب الأساسية عن المستخدم المرتبط التي يتم عرضها للمستخدم أثناء عملية تسجيل الدخول إلى الحساب المرتبط
• أن يكون لديك تطبيق 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.
• يمكنك الردّ إما باستجابة HTTP 200 (حسنًا) إذا كان الطلب صالحًا وتم تبادل رمز المصادقة بنجاح للحصول على رمز تعريف Google، أو رمز خطأ 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

التحقّق من صحة ردّ رمز التعريف