Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

المصادقة مع Firebase على iOS باستخدام رقم هاتف

يمكنك استخدام مصادقة Firebase لتسجيل الدخول إلى مستخدم من خلال إرسال رسالة SMS إلى هاتف المستخدم. يقوم المستخدم بتسجيل الدخول باستخدام رمز لمرة واحدة وارد في رسالة SMS.

أسهل طريقة لإضافة رقم تسجيل الدخول إلى تطبيقك هي استخدام FirebaseUI ، والذي يتضمن أداة تسجيل الدخول التي تنفذ تدفقات تسجيل الدخول لتسجيل الدخول برقم الهاتف ، بالإضافة إلى تسجيل الدخول المستند إلى كلمة المرور والموحد -في. يصف هذا المستند كيفية تنفيذ تدفق تسجيل الدخول لرقم الهاتف باستخدام Firebase SDK.

قبل ان تبدأ

  1. أضف Firebase إلى مشروع iOS .
  2. قم بتضمين القرون التالية في Podfile :
    pod 'Firebase/Auth'
    
  3. إذا لم تكن قد ربطت تطبيقك بمشروع Firebase بعد ، فقم بذلك من وحدة تحكم Firebase .

مخاوف أمنية

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

إذا كنت تستخدم تسجيل الدخول استنادًا إلى رقم الهاتف في تطبيقك ، فيجب عليك تقديمه إلى جانب طرق تسجيل دخول أكثر أمانًا ، وإبلاغ المستخدمين بالمبادلات الأمنية باستخدام تسجيل الدخول برقم الهاتف.

مكِّن تسجيل الدخول برقم الهاتف لمشروع Firebase

لتسجيل دخول المستخدمين عن طريق الرسائل القصيرة ، يجب أولاً تمكين طريقة تسجيل الدخول لرقم الهاتف لمشروع Firebase:

  1. في وحدة تحكم Firebase ، افتح قسم المصادقة .
  2. في صفحة طريقة تسجيل الدخول ، قم بتمكين طريقة تسجيل الدخول برقم الهاتف .

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

تمكين التحقق من التطبيق

لاستخدام مصادقة رقم الهاتف ، يجب أن يكون Firebase قادرًا على التحقق من أن طلبات تسجيل الدخول لرقم الهاتف واردة من تطبيقك. هناك طريقتان لتحقيق مصادقة Firebase هذا:

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

    بالنسبة لنظام التشغيل iOS 8.0 والإصدارات الأحدث ، لا تتطلب الإشعارات الصامتة موافقة صريحة من المستخدم ، وبالتالي فهي لا تتأثر برفض المستخدم لتلقي إشعارات APN في التطبيق. وبالتالي ، لا يحتاج التطبيق إلى طلب إذن المستخدم لتلقي إشعارات الدفع عند تنفيذ مصادقة رقم هاتف Firebase.

  • التحقق من reCAPTCHA : في حالة عدم إمكانية إرسال أو استلام إشعار دفع صامت ، مثل عندما يقوم المستخدم بتعطيل تحديث الخلفية لتطبيقك ، أو عند اختبار تطبيقك على محاكي iOS ، تستخدم مصادقة Firebase التحقق من reCAPTCHA لإكمال الهاتف تدفق تسجيل الدخول. غالبًا ما يمكن إكمال اختبار reCAPTCHA دون أن يضطر المستخدم إلى حل أي شيء.

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

ابدأ في تلقي إشعارات صامتة

لتمكين إشعارات APN للاستخدام مع مصادقة Firebase:

  1. في Xcode ، قم بتمكين الإشعارات الفورية لمشروعك.
  2. تحميل مفتاح مصادقة APNs إلى Firebase. إذا لم يكن لديك بالفعل مفتاح مصادقة APNs ، فراجع تكوين APNs باستخدام FCM .

    1. داخل مشروعك في وحدة تحكم Firebase ، حدد رمز الترس ، وحدد إعدادات المشروع ، ثم حدد علامة تبويب المراسلة السحابية .

    2. في مفتاح مصادقة APN ضمن تكوين تطبيق iOS ، انقر فوق الزر تحميل .

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

    إذا كان لديك بالفعل شهادة APNs ، فيمكنك تحميل الشهادة بدلاً من ذلك.

قم بإعداد التحقق reCAPTCHA

لتمكين Firebase SDK من استخدام التحقق من reCAPTCHA:

  1. أضف مخططات عناوين URL مخصصة إلى مشروع Xcode الخاص بك:
    1. افتح تكوين المشروع الخاص بك: انقر نقرًا مزدوجًا فوق اسم المشروع في طريقة عرض الشجرة اليسرى. حدد تطبيقك من قسم الأهداف ، ثم حدد علامة التبويب معلومات ، وقم بتوسيع قسم أنواع عناوين URL .
    2. انقر فوق الزر + ، وأضف مخطط URL لمعرف العميل المعكوس. للعثور على هذه القيمة ، افتح ملف تهيئة GoogleService-Info.plist وابحث عن مفتاح REVERSED_CLIENT_ID . انسخ قيمة هذا المفتاح ، والصقه في مربع أنظمة URL في صفحة التكوين. اترك الحقول الأخرى فارغة.

      عند الانتهاء ، يجب أن يبدو التكوين مشابهًا لما يلي (ولكن مع القيم الخاصة بالتطبيق):

  2. اختياري : إذا كنت ترغب في تخصيص الطريقة التي يقدم بها تطبيقك SFSafariViewController أو UIWebView عند عرض reCAPTCHA للمستخدم ، فأنشئ فئة مخصصة تتوافق مع بروتوكول FIRAuthUIDelegate ، ثم قم verifyPhoneNumber:UIDelegate:completion:

أرسل رمز التحقق إلى هاتف المستخدم

لبدء تسجيل الدخول إلى رقم الهاتف ، قدِّم للمستخدم واجهة verifyPhoneNumber:UIDelegate:completion: بتقديم رقم هاتفه ، ثم اتصل برقم verifyPhoneNumber:UIDelegate:completion: الهاتف verifyPhoneNumber:UIDelegate:completion: لطلب أن يرسل Firebase رمز مصادقة إلى هاتف المستخدم عبر رسالة قصيرة:

  1. احصل على رقم هاتف المستخدم.

    تختلف المتطلبات القانونية ، ولكن كأفضل ممارسة ولتعيين التوقعات للمستخدمين ، يجب عليك إبلاغهم أنه إذا كانوا يستخدمون تسجيل الدخول عبر الهاتف ، فقد يتلقون رسالة SMS للتحقق ويتم تطبيق الأسعار القياسية.

  2. اتصل verifyPhoneNumber:UIDelegate:completion: من رقم الهاتف verifyPhoneNumber:UIDelegate:completion: ، مروراً به رقم هاتف المستخدم.

    سويفت

    PhoneAuthProvider.provider().verifyPhoneNumber(phoneNumber, uiDelegate: nil) { (verificationID, error) in
      if let error = error {
        self.showMessagePrompt(error.localizedDescription)
        return
      }
      // Sign in using the verificationID and the code sent to the user
      // ...
    }

    ج موضوعية

    [[FIRPhoneAuthProvider provider] verifyPhoneNumber:userInput
                                            UIDelegate:nil
                                            completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
      if (error) {
        [self showMessagePrompt:error.localizedDescription];
        return;
      }
      // Sign in using the verificationID and the code sent to the user
      // ...
    }];

    عند الاتصال بـ verifyPhoneNumber:UIDelegate:completion: ، يرسل verifyPhoneNumber:UIDelegate:completion: إشعار دفع صامتًا إلى تطبيقك ، أو يصدر تحدي reCAPTCHA للمستخدم. بعد أن يتلقى تطبيقك الإشعار أو يكمل المستخدم اختبار reCAPTCHA ، يرسل Firebase رسالة SMS تحتوي على رمز مصادقة إلى رقم الهاتف المحدد ويمرر معرف التحقق إلى وظيفة الإكمال. ستحتاج إلى كل من رمز التحقق ومعرف التحقق لتسجيل الدخول إلى المستخدم.

    يمكن أيضًا ترجمة رسالة SMS التي أرسلها Firebase عن طريق تحديد لغة المصادقة عبر خاصية languageCode على مثيل المصادقة.

    سويفت

     // Change language code to french.
     Auth.auth().languageCode = "fr";
    

    ج موضوعية

     // Change language code to french.
     [FIRAuth auth].languageCode = @"fr";
    
  3. احفظ معرف التحقق واستعادته عند تحميل تطبيقك. من خلال القيام بذلك ، يمكنك التأكد من أنه لا يزال لديك معرف تحقق صالح إذا تم إنهاء تطبيقك قبل أن يكمل المستخدم تدفق تسجيل الدخول (على سبيل المثال ، أثناء التبديل إلى تطبيق SMS).

    يمكنك الاستمرار في معرف التحقق بالطريقة التي تريدها. طريقة بسيطة هي حفظ معرف التحقق باستخدام كائن NSUserDefaults :

    سويفت

    UserDefaults.standard.set(verificationID, forKey: "authVerificationID")
    

    ج موضوعية

    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    [defaults setObject:verificationID forKey:@"authVerificationID"];
    

    بعد ذلك ، يمكنك استعادة القيمة المحفوظة:

    سويفت

    let verificationID = UserDefaults.standard.string(forKey: "authVerificationID")
    

    ج موضوعية

    NSString *verificationID = [defaults stringForKey:@"authVerificationID"];
    

إذا كانت المكالمة verifyPhoneNumber:UIDelegate:completion: نجحت ، يمكنك مطالبة المستخدم بكتابة رمز التحقق عند استلامه في رسالة SMS.

تسجيل الدخول للمستخدم برمز التحقق

بعد أن يزود المستخدم تطبيقك برمز التحقق من رسالة SMS ، سجّل دخول المستخدم عن طريق إنشاء كائن FIRPhoneAuthCredential من رمز التحقق ومعرف التحقق وتمرير هذا الكائن إلى signInWithCredential:completion:

  1. احصل على رمز التحقق من المستخدم.
  2. قم FIRPhoneAuthCredential كائن FIRPhoneAuthCredential من رمز التحقق ومعرف التحقق.

    سويفت

    let credential = PhoneAuthProvider.provider().credential(
        withVerificationID: verificationID,
        verificationCode: verificationCode)

    ج موضوعية

    FIRAuthCredential *credential = [[FIRPhoneAuthProvider provider]
        credentialWithVerificationID:verificationID
                    verificationCode:userInput];
  3. تسجيل الدخول للمستخدم باستخدام كائن FIRPhoneAuthCredential :

    سويفت

    Auth.auth().signIn(with: credential) { (authResult, error) in
      if let error = error {
        let authError = error as NSError
        if (isMFAEnabled && authError.code == AuthErrorCode.secondFactorRequired.rawValue) {
          // The user is a multi-factor user. Second factor challenge is required.
          let resolver = authError.userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver
          var displayNameString = ""
          for tmpFactorInfo in (resolver.hints) {
            displayNameString += tmpFactorInfo.displayName ?? ""
            displayNameString += " "
          }
          self.showTextInputPrompt(withMessage: "Select factor to sign in\n\(displayNameString)", completionBlock: { userPressedOK, displayName in
            var selectedHint: PhoneMultiFactorInfo?
            for tmpFactorInfo in resolver.hints {
              if (displayName == tmpFactorInfo.displayName) {
                selectedHint = tmpFactorInfo as? PhoneMultiFactorInfo
              }
            }
            PhoneAuthProvider.provider().verifyPhoneNumber(with: selectedHint!, uiDelegate: nil, multiFactorSession: resolver.session) { verificationID, error in
              if error != nil {
                print("Multi factor start sign in failed. Error: \(error.debugDescription)")
              } else {
                self.showTextInputPrompt(withMessage: "Verification code for \(selectedHint?.displayName ?? "")", completionBlock: { userPressedOK, verificationCode in
                  let credential: PhoneAuthCredential? = PhoneAuthProvider.provider().credential(withVerificationID: verificationID!, verificationCode: verificationCode!)
                  let assertion: MultiFactorAssertion? = PhoneMultiFactorGenerator.assertion(with: credential!)
                  resolver.resolveSignIn(with: assertion!) { authResult, error in
                    if error != nil {
                      print("Multi factor finanlize sign in failed. Error: \(error.debugDescription)")
                    } else {
                      self.navigationController?.popViewController(animated: true)
                    }
                  }
                })
              }
            }
          })
        } else {
          self.showMessagePrompt(error.localizedDescription)
          return
        }
        // ...
        return
      }
      // User is signed in
      // ...
    }

    ج موضوعية

    [[FIRAuth auth] signInWithCredential:credential
                              completion:^(FIRAuthDataResult * _Nullable authResult,
                                           NSError * _Nullable error) {
        if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) {
          FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey];
          NSMutableString *displayNameString = [NSMutableString string];
          for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
            [displayNameString appendString:tmpFactorInfo.displayName];
            [displayNameString appendString:@" "];
          }
          [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString]
                               completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) {
           FIRPhoneMultiFactorInfo* selectedHint;
           for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
             if ([displayName isEqualToString:tmpFactorInfo.displayName]) {
               selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo;
             }
           }
           [FIRPhoneAuthProvider.provider
            verifyPhoneNumberWithMultiFactorInfo:selectedHint
            UIDelegate:nil
            multiFactorSession:resolver.session
            completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
              if (error) {
                [self showMessagePrompt:error.localizedDescription];
              } else {
                [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName]
                                     completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) {
                 FIRPhoneAuthCredential *credential =
                     [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID
                                                                  verificationCode:verificationCode];
                 FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
                 [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
                   if (error) {
                     [self showMessagePrompt:error.localizedDescription];
                   } else {
                     NSLog(@"Multi factor finanlize sign in succeeded.");
                   }
                 }];
               }];
              }
            }];
         }];
        }
      else if (error) {
        // ...
        return;
      }
      // User successfully signed in. Get user data from the FIRUser object
      if (authResult == nil) { return; }
      FIRUser *user = authResult.user;
      // ...
    }];

اختبار بأرقام الهاتف المدرجة في القائمة البيضاء

يمكنك إضافة أرقام هواتف إلى القائمة البيضاء للتطوير عبر وحدة تحكم Firebase. توفر أرقام هواتف القائمة البيضاء الفوائد التالية:

  • اختبار مصادقة رقم الهاتف دون استهلاك حصة الاستخدام الخاصة بك.
  • اختبار مصادقة رقم الهاتف دون إرسال رسالة SMS فعلية.
  • قم بإجراء اختبارات متتالية بنفس رقم الهاتف دون أن يتم خنقك. هذا يقلل من خطر الرفض أثناء عملية مراجعة متجر التطبيقات إذا حدث أن استخدم المراجع نفس رقم الهاتف للاختبار.
  • اختبر بسهولة في بيئات التطوير دون أي جهد إضافي ، مثل القدرة على التطوير في محاكي iOS أو محاكي Android بدون خدمات Google Play.
  • اكتب اختبارات التكامل دون حظرها بفحوصات الأمان المطبقة عادةً على أرقام الهواتف الحقيقية في بيئة الإنتاج.

يجب أن تستوفي أرقام هواتف القائمة البيضاء المتطلبات التالية:

  1. تأكد من استخدام أرقام خيالية غير موجودة بالفعل. لا تسمح لك مصادقة Firebase بإضافة أرقام الهواتف الحالية التي يستخدمها المستخدمون الحقيقيون إلى القائمة البيضاء. أحد الخيارات هو استخدام 555 رقمًا سابقًا كأرقام هواتف تجريبية أمريكية ، على سبيل المثال: +1 650-555-3434
  2. يجب تنسيق أرقام الهاتف بشكل صحيح للطول والقيود الأخرى. وسيستمرون في التحقق من صحة رقم هاتف المستخدم الحقيقي.
  3. يمكنك إضافة ما يصل إلى 10 أرقام هاتف للتطوير.
  4. استخدم أرقام الهواتف / الرموز التجريبية التي يصعب تخمينها وتغييرها بشكل متكرر.

أرقام هواتف القائمة البيضاء ورموز التحقق

  1. في وحدة تحكم Firebase ، افتح قسم المصادقة .
  2. في علامة التبويب أسلوب تسجيل الدخول ، قم بتمكين مزود الهاتف إذا لم تكن قد قمت بذلك بالفعل.
  3. افتح أرقام الهاتف لاختبار قائمة الأكورديون.
  4. أدخل رقم الهاتف الذي تريد اختباره ، على سبيل المثال: +1 650-555-3434 .
  5. أدخل رمز التحقق المكون من 6 أرقام لهذا الرقم المحدد ، على سبيل المثال: 654321 .
  6. أضف الرقم. إذا كانت هناك حاجة ، يمكنك حذف رقم الهاتف ورمزه من خلال التمرير فوق الصف المقابل والنقر على أيقونة سلة المهملات.

الاختبار اليدوي

يمكنك البدء مباشرةً باستخدام رقم هاتف مدرج في القائمة البيضاء في تطبيقك. يسمح لك هذا بإجراء الاختبار اليدوي أثناء مراحل التطوير دون التعرض لمشكلات الحصص أو الاختناق. يمكنك أيضًا الاختبار مباشرة من محاكي iOS أو محاكي Android بدون تثبيت خدمات Google Play.

عند تقديم رقم الهاتف المدرج في القائمة البيضاء وإرسال رمز التحقق ، لا يتم إرسال أي رسالة SMS فعلية. بدلاً من ذلك ، تحتاج إلى تقديم رمز التحقق الذي تمت تهيئته مسبقًا لإكمال تسجيل الدخول.

عند اكتمال تسجيل الدخول ، يتم إنشاء مستخدم Firebase برقم الهاتف هذا. لدى المستخدم نفس السلوك والخصائص مثل مستخدم رقم الهاتف الحقيقي ، ويمكنه الوصول إلى قاعدة بيانات Realtime / Cloud Firestore والخدمات الأخرى بنفس الطريقة. الرمز المميز للمعرف الذي تم سكه خلال هذه العملية له نفس التوقيع مثل مستخدم رقم الهاتف الحقيقي.

خيار آخر هو تعيين دور اختباري عبر المطالبات المخصصة على هؤلاء المستخدمين لتمييزهم كمستخدمين مزيفين إذا كنت ترغب في تقييد الوصول بشكل أكبر.

اختبار التكامل

بالإضافة إلى الاختبار اليدوي ، توفر مصادقة Firebase واجهات برمجة تطبيقات للمساعدة في كتابة اختبارات التكامل لاختبار مصادقة الهاتف. تعمل واجهات برمجة التطبيقات هذه على تعطيل التحقق من التطبيقات عن طريق تعطيل متطلبات reCAPTCHA في الويب وإشعارات الدفع الصامتة في iOS. وهذا يجعل اختبار الأتمتة ممكنًا في هذه التدفقات ويسهل تنفيذه. بالإضافة إلى ذلك ، فهي تساعد في توفير القدرة على اختبار تدفقات التحقق الفوري على Android.

على نظام التشغيل iOS ، appVerificationDisabledForTesting ضبط إعداد appVerificationDisabledForTesting على TRUE قبل الاتصال verifyPhoneNumber . تتم معالجة هذا دون الحاجة إلى أي رمز مميز لـ APNs أو إرسال إخطارات دفع صامتة في الخلفية ، مما يسهل الاختبار في جهاز محاكاة. يؤدي هذا أيضًا إلى تعطيل التدفق الاحتياطي لـ reCAPTCHA.

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

سويفت

let phoneNumber = "+16505554567"

// This test verification code is specified for the given test phone number in the developer console.
let testVerificationCode = "123456"

Auth.auth().settings.isAppVerificationDisabledForTesting = TRUE
PhoneAuthProvider.provider().verifyPhoneNumber(phoneNumber, uiDelegate:nil) {
                                                            verificationID, error in
    if (error) {
      // Handles error
      self.handleError(error)
      return
    }
    let credential = PhoneAuthProvider.provider().credential(withVerificationID: verificationID ?? "",
                                                               verificationCode: testVerificationCode)
    Auth.auth().signInAndRetrieveData(with: credential) { authData, error in
      if (error) {
        // Handles error
        self.handleError(error)
        return
      }
      _user = authData.user
    }];
}];

ج موضوعية

NSString *phoneNumber = @"+16505554567";

// This test verification code is specified for the given test phone number in the developer console.
NSString *testVerificationCode = @"123456";

[FIRAuth auth].settings.appVerificationDisabledForTesting = YES;
[[FIRPhoneAuthProvider provider] verifyPhoneNumber:phoneNumber
                                        completion:^(NSString *_Nullable verificationID,
                                                     NSError *_Nullable error) {
    if (error) {
      // Handles error
      [self handleError:error];
      return;
    }
    FIRAuthCredential *credential =
        [FIRPhoneAuthProvider credentialWithVerificationID:verificationID
                                          verificationCode:testVerificationCode];
    [FIRAuth auth] signInWithAndRetrieveDataWithCredential:credential
                                                completion:^(FIRUser *_Nullable user,
                                                             NSError *_Nullable error) {
      if (error) {
        // Handles error
        [self handleError:error];
        return;
      }
      _user = user;
    }];
}];

ملحق: استخدام تسجيل الدخول عبر الهاتف بدون اختناق

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

إذا كنت تفضل عدم استخدام swizzling، يمكنك تعطيله عن طريق إضافة علامة FirebaseAppDelegateProxyEnabled إلى ملف Info.plist التطبيق وتعيين إلى NO . لاحظ أن تعيين هذه العلامة على NO يؤدي أيضًا إلى تعطيل التمرير السريع لمنتجات Firebase الأخرى ، بما في ذلك Firebase Cloud Messaging.

إذا عطلت التمرير السريع ، فيجب عليك تمرير الرمز المميز لجهاز APNs والإخطارات الفورية وعنوان URL المخصص لإعادة توجيه المخطط إلى مصادقة Firebase.

للحصول على الرمز المميز لجهاز application:didRegisterForRemoteNotificationsWithDeviceToken: ، قم بتطبيق application:didRegisterForRemoteNotificationsWithDeviceToken: method application:didRegisterForRemoteNotificationsWithDeviceToken: ، قم بتمرير رمز الجهاز إلى FIRAuth setAPNSToken:type: method.

سويفت

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
  // Pass device token to auth
  Auth.auth().setAPNSToken(deviceToken, type: .prod)

  // Further handling of the device token if needed by the app
  // ...
}

ج موضوعية

- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
  // Pass device token to auth.
  [[FIRAuth auth] setAPNSToken:deviceToken type:FIRAuthAPNSTokenTypeProd];
  // Further handling of the device token if needed by the app.
}

للتعامل مع إشعارات الدفع ، في application:didReceiveRemoteNotification:fetchCompletionHandler: method ، تحقق من الإشعارات المتعلقة FIRAuth عن طريق استدعاء FIRAuth 's canHandleNotification: method.

سويفت

func application(_ application: UIApplication,
    didReceiveRemoteNotification notification: [AnyHashable : Any],
    fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  if Auth.auth().canHandleNotification(notification) {
    completionHandler(.noData)
    return
  }
  // This notification is not auth related, developer should handle it.
}

ج موضوعية

- (void)application:(UIApplication *)application
    didReceiveRemoteNotification:(NSDictionary *)notification
          fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
  // Pass notification to auth and check if they can handle it.
  if ([[FIRAuth auth] canHandleNotification:notification]) {
    completionHandler(UIBackgroundFetchResultNoData);
    return;
  }
  // This notification is not auth related, developer should handle it.
}

للتعامل مع عنوان URL المخصص لإعادة توجيه المخطط المخصص ، نفِّذ application:openURL:sourceApplication:annotation: طريقة للأجهزة التي تعمل بنظام iOS 8 والإصدارات الأقدم ، application:openURL:options: طريقة للأجهزة التي تعمل بنظام iOS 9 والإصدارات الأحدث ، application:openURL:options: ، قم بتمرير عنوان URL FIRAuth الخاصة بـ canHandleURL .

سويفت

// For iOS 9+
func application(_ application: UIApplication, open url: URL,
    options: [UIApplicationOpenURLOptionsKey : Any]) -> Bool {
  if Auth.auth().canHandle(url) {
    return true
  }
  // URL not auth related, developer should handle it.
}

// For iOS 8-
func application(_ application: UIApplication,
                 open url: URL,
                 sourceApplication: String?,
                 annotation: Any) -> Bool {
  if Auth.auth().canHandle(url) {
    Return true
  }
  // URL not auth related, developer should handle it.
}

ج موضوعية

// For iOS 9+
- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
  if ([[FIRAuth auth] canHandleURL:url]) {
    return YES;
  }
  // URL not auth related, developer should handle it.
}

// For iOS 8-
- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation {
  if ([[FIRAuth auth] canHandleURL:url]) {
    return YES;
  }
  // URL not auth related, developer should handle it.
}

إذا كنت تستخدم SwiftUI أو UISceneDelegate ، للتعامل مع URL إعادة توجيه، تنفيذ scene:openURLContexts: طريقة، وفي نفوسهم، وتمرير URL إلى FIRAuth الصورة canHandleURL الأسلوب.

سويفت

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
  for urlContext in URLContexts {
      let url = urlContext.url
      Auth.auth().canHandle(url)
  }
  // URL not auth related, developer should handle it.
}

ج موضوعية

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
  for (UIOpenURLContext *urlContext in URLContexts) {
    [FIRAuth.auth canHandleURL:urlContext.url];
    // URL not auth related, developer should handle it.
  }
}

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

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

  • في تطبيقاتك ، يمكنك الحصول على معلومات ملف تعريف المستخدم الأساسية من كائن FIRUser . راجع إدارة المستخدمين .

  • في قاعدة بيانات Firebase Realtime وقواعد أمان التخزين السحابي ، يمكنك الحصول على معرف المستخدم الفريد للمستخدم الذي سجّل الدخول من متغير auth ، واستخدامه للتحكم في البيانات التي يمكن للمستخدم الوصول إليها.

يمكنك السماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام العديد من موفري المصادقة من خلال ربط بيانات اعتماد موفر المصادقة بحساب مستخدم حالي.

لتسجيل خروج مستخدم ، اتصل على تسجيل الخروج signOut:

سويفت

    let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print ("Error signing out: %@", signOutError)
}
  

ج موضوعية

    NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

قد ترغب أيضًا في إضافة رمز معالجة الخطأ لمجموعة كاملة من أخطاء المصادقة. انظر معالجة الأخطاء .