يمكن أن يبدأ إلغاء الربط من النظام الأساسي الذي تستخدمه أو Google، وأن عرض حالة رابط متسقة على كل منهما يقدم أفضل تجربة للمستخدم. ويُعدّ دعم دعم نقطة نهاية رمز مميز أو ميزة "الحماية العابرة للحساب" اختياريًا لربط حسابك على Google.
يمكن أن يتم إلغاء ربط الحسابات من خلال أي مما يلي:
- طلب المستخدم من
- تطبيق Google أو إعدادات حساب Google
- النظام الأساسي الخاص بك
- تعذّر تجديد رمز مميز منتهي الصلاحية لإعادة التحميل
- الأحداث الأخرى التي بدأتها أنت أو Google على سبيل المثال، تعليق الحساب عن طريق خدمات إساءة الاستخدام واكتشاف التهديدات.
طلبَ المستخدم إلغاء الربط بحساب Google
يؤدي إلغاء ربط الحساب الذي تم بدؤه من خلال حساب المستخدم على Google أو تطبيقه إلى حذف أي رموز مميّزة لإذن الوصول والتحديث سابقًا، وإزالة موافقة المستخدم، والاتصال اختياريًا بنقطة نهاية الرمز المميز إذا اخترت تنفيذ أحدها.
طلبَ المستخدم إلغاء الربط بالنظام الأساسي الذي تستخدمه
يجب توفير آلية للمستخدمين لإلغاء الربط بها، مثل عنوان URL في حسابهم. إذا كنت لا توفّر طريقة للمستخدمين لإلغاء الربط، يمكنك تضمين رابط إلى حساب Google حتى يتمكّن المستخدمون من إدارة الحساب المرتبط.
يمكنك اختيار تنفيذ المخاطر والتعاون ومشاركة الحوادث (RISC) وإبلاغ Google بالتغييرات التي تطرأ على حالة ربط حسابات المستخدمين. ويسمح هذا الإجراء بتحسين تجربة المستخدم حيث تعرض كل من المنصّة وGoogle حالة ربط حالية ومتسقة بدون الحاجة إلى الاعتماد على طلب إعادة تحميل أو رمز الدخول لتعديل حالة الربط.
انتهاء صلاحية الرمز المميز
لتقديم تجربة سلسة للمستخدم وتجنُّب انقطاع الخدمة، تحاول Google تجديد الرموز المميزة لإعادة التحميل عند اقتراب نهاية عمرها الافتراضي. في بعض السيناريوهات، قد يُطلب من المستخدم الحصول على موافقة لإعادة ربط الحسابات في حال عدم توفّر رمز مميّز صالح لإعادة التحميل.
إنّ تصميم المنصّة لإتاحة استخدام عدة رموز مميّزة غير منتهية الصلاحية وإعادة التحميل يمكن أن يساعد في الحدّ من حالات العرقلة في تبادلات خوادم العملاء بين البيئة المجمّعة وتجنُّب انقطاع الخدمة والحدّ من التوقيت المعقّد وسيناريوهات معالجة الأخطاء. وفي الوقت نفسه، قد يتم استخدام كل من الرموز المميزة السابقة والتي انتهت صلاحيتها حديثًا لفترة زمنية قصيرة أثناء عملية تبادل الرموز المميزة بين العميل والخادم وقبل مزامنة المجموعة. على سبيل المثال، طلب Google لخدمتك الذي يستخدم رمز الدخول السابق غير المنتهية الصلاحية يحدث مباشرةً بعد إصدار رمز دخول جديد مباشرةً، ولكن قبل إجراء المزامنة ومزامنة المجموعة في Google. يُنصح باتخاذ إجراءات أمان بديلة لإعادة تحميل تدوير الرمز المميّز.
الأحداث الأخرى
يمكن إلغاء ربط الحسابات لأسباب أخرى متعددة، مثل عدم النشاط والتعليق والسلوك الضار وما إلى ذلك. في مثل هذه السيناريوهات، يمكن لنظامك الأساسي وGoogle إدارة حسابات المستخدمين على أفضل نحو وإعادة الربط عن طريق إرسال إشعار بشأن التغييرات التي تطرأ على حالة الحساب والروابط الأخرى.
نفِّذ نقطة نهاية إبطال الرمز المميّز حتى تتمكّن Google من الاتصال بها، وأبلِغ Google بفعاليات إبطال الرمز المميّز باستخدام RISC لضمان الحفاظ على حالة الاتّساق في حساب المستخدم من النظام الأساسي وGoogle.
نقطة نهاية إبطال الرمز المميز
If you support an OAuth 2.0 token revocation endpoint, your platform can receive notifications from Google. This lets you inform users of link state changes, invalidate a token, and cleanup security credentials and authorization grants.
The request has the following form:
POST /revoke HTTP/1.1 Host: oauth2.example.com Content-Type: application/x-www-form-urlencoded client_id=GOOGLE_CLIENT_ID&client_secret=GOOGLE_CLIENT_SECRET&token=TOKEN&token_type_hint=refresh_token
Your token revocation endpoint must be able to handle the following parameters:
Revocation endpoint parameters | |
---|---|
client_id |
A string that identifies the request origin as Google. This string must be registered within your system as Google's unique identifier. |
client_secret |
A secret string that you registered with Google for your service. |
token |
The token to be revoked. |
token_type_hint |
(Optional) The type of token being revoked, either an
access_token or refresh_token . If unspecified,
defaults to access_token . |
Return a response when the token is deleted or invalid. See the following for an example:
HTTP/1.1 200 Success Content-Type: application/json;charset=UTF-8
If the token can't be deleted for any reason, return a 503 response code, as shown in the following example:
HTTP/1.1 503 Service Unavailable Content-Type: application/json;charset=UTF-8 Retry-After: HTTP-date / delay-seconds
Google retries the request later or as requested by Retry-After
.
الحماية من جميع الحسابات (RISC)
إذا كنت توفّر ميزة "الحماية العابرة للحساب"، يمكن لمنصتك إرسال إشعار إلى Google. رموز الدخول أو إعادة التحميل. يتيح هذا لـ Google إبلاغ المستخدمين تغيير حالة الربط وإبطال الرمز المميّز وتنظيف بيانات اعتماد الأمان منح الأذونات.
تستند ميزة "الحماية العابرة للحساب" إلى معيار RISC الذي تم تطويره في مؤسسة OpenID.
الرمز المميّز للحدث الأمني يُستخدم لإعلام Google بإبطال الرمز المميز.
عند فك الترميز، يظهر حدث إبطال الرمز المميّز على النحو التالي:
{
"iss":"http://risc.example.com",
"iat":1521068887,
"aud":"google_account_linking",
"jti":"101942095",
"toe": "1508184602",
"events": {
"https://schemas.openid.net/secevent/oauth/event-type/token-revoked":{
"subject_type": "oauth_token",
"token_type": "refresh_token",
"token_identifier_alg": "hash_SHA512_double",
"token": "double SHA-512 hash value of token"
}
}
}
الرموز المميّزة للأحداث الأمنية التي تستخدمها لإعلام Google بأحداث إبطال الرموز المميّزة مع المتطلبات الواردة في الجدول التالي:
أحداث إبطال الرمز المميّز | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
iss |
مطالبة جهة الإصدار: هذا عنوان URL تستضيفه وتتم مشاركته مع. Google أثناء التسجيل. | ||||||||||
aud |
مطالبة الجمهور: تحدد Google كمستلم JWT. أُنشأها جون هنتر، الذي كان متخصصًا
يجب ضبطها على google_account_linking . |
||||||||||
jti |
المطالبة بمعرّف JWT: هذا معرّف فريد تنشئه لكل الرمز المميز للحدث الأمني. | ||||||||||
iat |
تم الإصدار بناءً على المطالبة: هذه القيمة هي NumericDate .
الذي يمثّل الوقت الذي تم فيه إنشاء الرمز المميّز للحدث الأمني. |
||||||||||
toe |
وقت المطالبة بالحدث: هذا الإجراء اختياري.
قيمة NumericDate تمثل الوقت الذي
تم إبطال الرمز المميز. |
||||||||||
exp |
المطالبة بوقت انتهاء الصلاحية: لا تتضمّن هذا الحقل، لأنّ الحدث الذي نتج عن هذا الإشعار قد تم بالفعل. | ||||||||||
events |
|
لمزيد من المعلومات حول أنواع الحقول والتنسيقات، يمكنك الاطّلاع على رمز JSON المميّز للويب (JWT)