الالتزام بسياسات OAuth 2.0

يوضّح هذا الدليل كيفية الالتزام بالسياسات وحلّ المشاكل الأكثر شيوعًا التي يواجهها المطوّر��ن ��ن�� ��عداد ت��بيقات��م للإصدار العلني.

نظرة عامة

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

استخدام مشاريع منفصلة للاختبار والإنتاج

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

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

  1. انتقِل إلى وحدة التحكم في واجهة Google API. انقر على إنشاء مشروع، وأدخِل اسمًا، ثم انقر على إنشاء.
  2. يُرجى مراجعة عملاء OAuth في هذا المشروع الذين قد يكونون مرتبطين بفئة الاختبار. إذا كان ذلك ممكنًا، أنشئ عملاء OAuth مشابهين لعملاء الإنتاج داخل مشروع الإنتاج.
  3. فعِّل أي واجهات برمجة تطبيقات يستخدمها عملاؤك.
  4. راجِع إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth للمشروع الجديد في صفحة "الهوية البصرية للعلامة التجارية" في Cloud Console.

يجب ألا تحتوي عملاء Google OAuth المستخدَمون في مرحلة الإنتاج على بيئات اختبار أو معرّفات موارد منتظمة (URI) لإعادة التوجيه أو مصادر JavaScript متاحة لك أو لفريق التطوير فقط. في ما يلي بعض الأمثلة:

  • خوادم الاختبار الخاصة بالمطوّرين المستقلين
  • الإصدارات التجريبية أو نسخ الإصدار من تطبيقك

الاحتفاظ بقائمة جهات الاتصال ذات الصلة بالمشروع

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

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

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

التعريف بهويتك بدقة

أدخِل اسم تطبيق صالحًا وشعارًا لعرضه للمستخدمين، إذا أردت. يجب أن تمثّل معلومات العلامة التجارية هذه هوية تطبيقك بدقة. يتم ضبط معلومات هوية التطبيق من صفحة الهوية في OAuth.

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

يمكن لـ Google إبطال أو تعليق إمكانية الوصول إلى خدمات Google API ومنتجات Google الأخرى وخدماتها للتطبيقات التي تسيء تمثيل هويتها أو تحاول خداع المستخدمين.

طلب النطاقات التي تحتاج إليها فقط

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

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

لمزيد من المعلومات حول هذا الشرط، يُرجى قراءة قسم طلب النطاقات التي تحتاج إليها فقط في سياسات OAuth 2.0، بالإضافة إلى قسم طلب الأذونات ذات الصلة في سياسة بيانات المستخدم في خدمات Google API.

إرسال تطبيقات الإصدار العلني التي تستخدم نطاقات غير حساسة أو غير محدودة لإجراء عملية التحقّق

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

ننصحك بشدة بأن يلتزم تطبيقك بإرشادات بناء هوية العلامة التجارية الرسمية لوضع زر "تسجيل الدخول".

استخدام النطاقات التي تملكها فقط

تتطلّب عملية التحقّق من شاشة طلب الموافقة عبر OAuth في Google التحقّق من جميع النطاقات المرتبطة بالصفحة الرئيسية لمشروعك أو سياسة الخصوصية أو بنود الخدمة أو عناوين URI المصرَّح بإعادة التوجيه إليها أو مصادر JavaScript المصرَّح بها. راجِع قائمة النطاقات التي يستخدمها تطبيقك، والملخّصة في قسم النطاقات المصرَّح بها في أداة تعديل شاشة طلب الموافقة على OAuth، وحدِّد أي نطاقات لا تملكها وبالتالي لن تتمكّن من إثبات ملكيتها. لإثبات ملكية النطاقات المصرَّح بها لمشروعك، استخدِم Google Search Console. استخدِم حساب Google مرتبطًا بمشروعك على API Console بصفتك مالكًا أو محرّرًا.

إذا كان مشروعك يستخدم مقدّم خدمة بنطاق مشترك، ننصحك بتفعيل الإعدادات التي تسمح باستخدام نطاقك الخاص. يوفّر بعض مقدّمي الخدمات إمكانية ربط خدماتهم بنطاق فرعي لنطاق تملكه حاليًا.

استضافة صفحة رئيسية لتطبيقات الإنتاجية

يجب أن يتضمّن كل تطبيق إنتاج يستخدم OAuth 2.0 صفحة رئيسية يمكن للجميع الوصول إليها. قد يزور المستخدمون المحتملون لتطبيقك الصفحة الرئيسية لمعرفة المزيد حول الميزات والوظائف التي يقدمها التطبيق. قد يراجع المستخدمون الحاليون قائمة الأذونات الحالية ويزورون الصفحة الرئيسية لتطبيقك لتذكيرهم باستخدامهم المستمر لعرضك.

يجب أن تتضمّن الصفحة الرئيسية لتطبيقك وصفًا لوظائف التطبيق، بالإضافة إلى روابط تؤدي إلى سياسة الخصوصية وبنود الخدمة الاختيارية. يجب أن تكون الصفحة الرئيسية موجودة على نطاق تم إثبات ملكيته لك.

استخدام معرّفات الموارد المنتظمة (URI) الآمنة لإعادة التوجيه ومصادر JavaScript

يجب أن تؤمّن عملاء OAuth 2.0 لتطبيقات الويب بياناتها باستخدام معرّفات الموارد المنتظمة (URI) لإعادة التوجيه عبر HTTPS ومصادر JavaScript، وليس عبر HTTP العادي. يمكن لـ Google رفض طلبات OAuth التي لا تنشأ من سياق آمن أو لا يتم حلّها في سياق آمن.

ضع في اعتبارك تطبيقات ونصوص الطرف الثالث التي قد يكون لها حق الوصول إلى الرموز المميزة وبيانات اعتماد المستخدم الأخرى التي تعود إلى صفحتك. يمكنك حظر الوصول إلى البيانات الحسّاسة باستخدام مواقع عناوين URI لإعادة التوجيه التي تقتصر على التحقّق من بيانات الر��وز المميّزة وتخزينها.

الخطوات التالية

بعد التأكّد من امتثال تطبيقك لسياسات OAuth 2.0 الواردة في هذه الصفحة، يُرجى الاطّلاع على إرسال طلب للتحقّق من العلامة التجارية لمعرفة تفاصيل حول عملية التحقّق.