أفضل الممارسات لاستخدام ميزةsignInWithRedirect في المتصفّحات التي تحظر إمكانية الوصول إلى مساحة تخزين الجهات الخارجية

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

نظرة عامة

لجعل عملية signInWithRedirect() سلسة لك وللمستخدمين، تستخدم حزمة JavaScript SDK لمصادقة Firebase إطار iframe متعدّد المصادر يتصل بنطاق استضافة Firebase الخاص بتطبيقك. ومع ذلك، لا تعمل هذه الآلية مع المتصفّحات التي تحظر الوصول إلى مساحة التخزين التابعة لجهة خارجية.

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

  • إذا كنت تستضيف تطبيقك باستخدام Firebase Hosting على نطاق فرعي من firebaseapp.com، لن تتأثر بهذه المشكلة ولن تحتاج إلى اتّخاذ أي إجراء.
  • إذا كنت تستضيف تطبيقك باستخدام "استضافة Firebase" على نطاق خاص أو نطاق فرعي من web.app، استخدِم الخيار 1.
  • إذا كنت تستضيف تطبيقك من خلال خدمة أخرى غير Firebase، استخدِم الخيار 2 أو الخيار 3 أو الخيار 4 أو الخيار 5.

الخيار 1: تعديل إعدادات Firebase لاستخدام نطاقك الخاص كـ authDomain

إذا كنت تستضيف تطبيقك باستخدام ميزة "استضافة Firebase" من خلال نطاق خاص، يمكنك ضبط حزمة تطوير البرامج (SDK) لمنصّة Firebase لاستخدام نطاقك الخاص كـ authDomain. يضمن ذلك استخدام تطبيقك وإطار iframe المصادقة للنطاق نفسه، ما يمنع حدوث مشكلة تسجيل الدخول. (إذا كنت لا تستخدم ميزة "استضافة Firebase"، عليك استخدام خيار مختلف). تأكَّد من إعداد النطاق الخاص في المشروع نفسه الذي تستخدمه للمصادقة.

لتعديل إعدادات Firebase من أجل استخدام نطاقك الخاص كنطاق مصادقة، يُرجى اتّباع الخطوات التالية:

  1. اضبط حزمة تطوير البرامج (SDK) لبرنامج Firebase JS لاستخدام نطاقك الخاص كـ authDomain:

    const firebaseConfig = {
      apiKey: "<api-key>",
      authDomain: "<the-domain-that-serves-your-app>",
      databaseURL: "<database-url>",
      projectId: "<project-id>",
      appId: "<app-id>"
    };
    
  1. أضِف authDomain الجديد إلى قائمة معرّفات الموارد المنتظمة (URI) لإعادة التوجيه المصرّح بها لدى موفّر OAuth. تعتمد طريقة إجراء ذلك على مقدّم الخدمة، ولكن بشكل عام، يمكنك اتّباع قسم "قبل البدء" لدى أي مقدّم خدمة للحصول على تعليمات دقيقة (على سبيل المثال، مقدّم خدمة Facebook). يبدو عنوان URI المعدَّل للتفويض على النحو التالي: https://<the-domain-that-serves-your-app>/__/auth/handler، ويُعدّ الرمز /__/auth/handler في النهاية مهمًا.

    وبالمثل، إذا كنت تستخدم موفّر SAML، أضِف authDomain الجديد إلى عنوان URL لخدمة Assertion Consumer Service‏ (ACS) في SAML.

  2. تأكَّد من أنّ continue_uri مدرَج في قائمة النطاقات المعتمَدة.

  3. أعِد النشر باستخدام ميزة "استضافة Firebase" إذا لزم الأمر لجلب أحدث ملف إعدادات Firebase مستضاف على /__/firebase/init.json.

الخيار 2: التبديل إلى signInWithPopup()‎

استخدِم signInWithPopup() بدلاً من signInWithRedirect(). يظل باقي رمز تطبيقك كما هو، ولكن يتم استرداد عنصر UserCredential بشكل مختلف.

Web

  // Before
  // ==============
  signInWithRedirect(auth, new GoogleAuthProvider());
  // After the page redirects back
  const userCred = await getRedirectResult(auth);

  // After
  // ==============
  const userCred = await signInWithPopup(auth, new GoogleAuthProvider());

Web

  // Before
  // ==============
  firebase.auth().signInWithRedirect(new firebase.auth.GoogleAuthProvider());
  // After the page redirects back
  var userCred = await firebase.auth().getRedirectResult();

  // After
  // ==============
  var userCred = await firebase.auth().signInWithPopup(
      new firebase.auth.GoogleAuthProvider());
```

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

الخيار 3: طلبات مصادقة الخادم الوكيل إلى firebaseapp.com

تبدأ عملية signInWithRedirect بإعادة التوجيه من نطاق تطبيقك إلى النطاق المحدّد في مَعلمة authDomain في إعدادات Firebase (‏".firebaseapp.com" تلقائيًا). يستضيف النطاق authDomain رمز مساعد تسجيل الدخول الذي يعيد التوجيه إلى موفِّر الهوية، والذي يعيد التوجيه إلى نطاق التطبيق عند نجاح العملية.

عندما يعود مسار المصادقة إلى نطاق تطبيقك، يتم الوصول إلى مساحة التخزين في المتصفّح الخاصة بنطاق مساعد تسجيل الدخول. يؤدي هذا الخيار والخيار التالي (لاستضافة الرمز بنفسك) إلى إلغاء إمكانية الوصول إلى مساحة التخزين المتعدّدة المصادر، والتي يتم حظرها من خلال المتصفّحات.

  1. يجب إعداد خادم وكيل عكسي على خادم التطبيق لإعادة توجيه طلبات GET/POST إلى https://<app domain>/__/auth/ إلى https://<project>.firebaseapp.com/__/auth/. تأكَّد من أنّ عملية إعادة التوجيه هذه واضحة للمتصفّح، ولا يمكن إجراؤها من خلال إعادة التوجيه 302.

    إذا كنت تستخدم nginx لعرض نطاقك الخاص، سيبدو إعداد الخادم الوكيل العكسي على النحو التالي:

    # reverse proxy for signin-helpers for popup/redirect sign in.
    location /__/auth {
      proxy_pass https://<project>.firebaseapp.com;
    }
    
  2. اتّبِع الخطوات الواردة في الخيار 1 لتعديل redirect_uri المعتمَد وعنوان URL لخدمة ACS وauthDomain. بعد إعادة نشر تطبيقك، من المفترض ألا يحدث الوصول إلى مساحة التخزين المتعدّدة المصادر مرة أخرى.

الخيار 4: استضافة رمز مساعِد تسجيل الدخول ذاتيًا في نطاقك

هناك طريقة أخرى لإلغاء إمكانية الوصول إلى مساحة التخزين المتعدّدة المصادر، وهي الاستضافة الذاتية لرمز مساعد تسجيل الدخول إلى Firebase. ومع ذلك، لا تنجح هذه الطريقة مع تسجيل الدخول باستخدام Apple أو SAML. لا تستخدِم هذا الخيار إلا إذا كان إعداد الخادم الوكيل العكسي في الخيار 3 غير ممكن.

تتضمّن استضافة رمز المساعد الخطوات التالية:

  1. نزِّل الملفات لاستضافتها من الموقع الجغرافي <project>.firebaseapp.com من خلال تنفيذ الأوامر التالية:

    mkdir signin_helpers/ && cd signin_helpers
    wget https://<project>.firebaseapp.com/__/auth/handler
    wget https://<project>.firebaseapp.com/__/auth/handler.js
    wget https://<project>.firebaseapp.com/__/auth/experiments.js
    wget https://<project>.firebaseapp.com/__/auth/iframe
    wget https://<project>.firebaseapp.com/__/auth/iframe.js
    wget https://<project>.firebaseapp.com/__/auth/links
    wget https://<project>.firebaseapp.com/__/auth/links.js
    wget https://<project>.firebaseapp.com/__/firebase/init.json
    
  2. استضِف الملفات المذكورة أعلاه ضمن نطاق تطبيقك. تأكَّد من أنّ خادم الويب يمكنه الاستجابة لـ https://<app domain>/__/auth/<filename> وhttps://<app domain>/__/firebase/init.json.

    في ما يلي نموذج لتنفيذ الخادم الذي ينزّل الملفات ويستضيفها.

  3. اتّبِع الخطوات الواردة في الخيار 1 لتعديل redirect_uri المعتمَد وauthDomain. بعد إعادة نشر تطبيقك، من المفترض ألا يحدث الوصول إلى مساحة التخزين المتعدّدة المصادر مرة أخرى.

الخيار 5: التعامل مع تسجيل دخول مقدّم الخدمة بشكل مستقل

توفّر حزمة تطوير البرامج (SDK) لمصادقة Firebase الطريقتَين signInWithPopup() وsignInWithRedirect() كطريقتَين مناسبتَين لتضمين المنطق المعقّد وتجنُّب الحاجة إلى استخدام حزمة تطوير برامج (SDK) أخرى. يمكنك تجنُّب استخدام أيّ من الطريقتَين تمامًا من خلال تسجيل الدخول بشكل مستقل إلى مقدّم الخدمة، ثم استخدام signInWithCredential() لاستبدال بيانات اعتماد مقدّم الخدمة ببيانات اعتماد "مصادقة Firebase". على سبيل المثال، يمكنك استخدام حزمة تطوير البرامج (SDK) لتسجيل الدخول بحساب Google، رمز نموذجي للحصول على بيانات اعتماد حساب Google، ثم إنشاء مثيل لبيانات اعتماد Google جديدة، عن طريق تشغيل الرمز التالي:

Web

  // `googleUser` from the onsuccess Google Sign In callback.
  //  googUser = gapi.auth2.getAuthInstance().currentUser.get();
  const credential = GoogleAuthProvider.credential(googleUser.getAuthResponse().id_token);
  const result = await signInWithCredential(auth, credential);

Web

  // `googleUser` from the onsuccess Google Sign In callback.
  const credential = firebase.auth.GoogleAuthProvider.credential(
      googleUser.getAuthResponse().id_token);
  const result = await firebase.auth().signInWithCredential(credential);

بعد استدعاء signInWithCredential()، ستعمل بقية وظائف تطبيقك كما كانت تعمل من قبل.

يمكنك الاطّلاع على تعليمات الحصول على بيانات اعتماد Apple هنا.