المصادقة باستخدام Firebase بدون الكشف عن الهوية على أنظمة Apple الأساسية

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

قبل البدء

1. يمكنك استخدام "مدير حزم Swift" لتثبيت اعتماديات Firebase وإدارتها.

   1. في Xcode، انتقِل إلى File (ملف) > بعد فتح مشروع التطبيق الخاص بك. إضافة حِزم
   2. أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple عندما يُطلب منك ذلك:

     https://github.com/firebase/firebase-ios-sdk.git

   3. اختر مكتبة مصادقة Firebase.
   4. أضِف العلامة -ObjC إلى القسم علامات الروابط الأخرى في إعدادات إصدار هدفك.
   5. عند الانتهاء، سيبدأ Xcode تلقائيًا في حل وتنزيل ملف والتبعيات في الخلفية.
2. إذا لم تكن قد ربطت تطبيقك بمشروعك على Firebase، يمكنك إجراء ذلك من وحدة تحكُّم Firebase.
3. تفعيل المصادقة المجهولة:
   1. في وحدة تحكُّم Firebase، افتح قسم المصادقة.
   2. في صفحة طرق تسجيل الدخول، فعِّل الخيار مجهول الهوية. تسجيل الدخول.
   3. اختياري: إذا قمت بترقية مشروعك إلى مصادقة Firebase باستخدام النظام الأساسي للهوية، يمكنك تفعيل إزالة البرامج غير المرغوب فيها تلقائيًا. فعندما بعد تفعيل هذا الإعداد، سيتم تلقائيًا تحديد الحسابات المجهولة الهوية التي مرّ عليها أكثر من 30 يومًا حذف. في المشاريع التي تم فيها تفعيل ميزة "التنظيف التلقائي"، لن يتم تفعيل المصادقة المجهولة بعد ذلك يتم احتسابها ضمن حدود الاستخدام أو حصص الفوترة. عرض إزالة البرامج غير المرغوب فيها تلقائيًا:

المصادقة باستخدام Firebase بهوية مجهولة

عندما يستخدم مستخدم لم يسجّل الدخول ميزة تطبيق تتطلب المصادقة مع Firebase، سجِّل الدخول إلى المستخدم بدون الكشف عن هويتك من خلال إكمال الخطوات التالية:

1. استيراد وحدة FirebaseCore في UIApplicationDelegate بالإضافة إلى أي تطبيق آخر وحدات Firebase التي يستخدمها تطبيقك المفوَّض على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. ضبط FirebaseApp المثيل المشترك في حساب مفوَّض تطبيقك طريقة application(_:didFinishLaunchingWithOptions:):

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. إذا كنت تستخدم SwiftUI، عليك إنشاء تفويض تطبيق وإرفاقه. إلى بنية App عبر UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor ويجب أيضًا إيقاف إيماءة تفويض التطبيق. بالنسبة لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات SwiftUI.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. عليك استدعاء طريقة signInAnonymouslyWithCompletion::

   Swift

   Auth.auth().signInAnonymously { authResult, error in
     // ...
   }
   

   Objective-C

   [[FIRAuth auth] signInAnonymouslyWithCompletion:^(FIRAuthDataResult * _Nullable authResult,
                                                     NSError * _Nullable error) {
      // ...
    }];
   

5. في حال اكتمال طريقة signInAnonymouslyWithCompletion: دون حدوث أخطاء، يمكنك الحصول على بيانات حساب المستخدم المجهول من كائن FIRAuthDataResult:

   Swift

   guard let user = authResult?.user else { return }
   let isAnonymous = user.isAnonymous  // true
   let uid = user.uid
   

   Objective-C

   FIRUser *user = authResult.user;
   BOOL isAnonymous = user.anonymous;  // YES
   NSString *uid = user.uid;
   

تحويل حساب مجهول إلى حساب دائم

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

1. عندما يشترك المستخدم، أكمِل إجراءات تسجيل الدخول إلى حساب المستخدم بمزود مصادقة يصل إلى، ولكن لا يشمل، الاتصال بأحد FIRAuth.signInWith. على سبيل المثال، احصل على الرمز المميز لمعرّف Google للمستخدم، رمز الدخول إلى Facebook، أو عنوان البريد الإلكتروني وكلمة المرور.

2. احصل على FIRAuthCredential لموفِّر المصادقة الجديد:

   تسجيل الدخول بحساب Google

   Swift

   guard
     let authentication = user?.authentication,
     let idToken = authentication.idToken
   else {
     return
   }
   
   let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                  accessToken: authentication.accessToken)
   

   Objective-C

   FIRAuthCredential *credential =
   [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString
                                    accessToken:result.user.accessToken.tokenString];
   

   تسجيل الدخول إلى Facebook

   Swift

   let credential = FacebookAuthProvider
     .credential(withAccessToken: AccessToken.current!.tokenString)
   

   Objective-C

   FIRAuthCredential *credential = [FIRFacebookAuthProvider
       credentialWithAccessToken:[FBSDKAccessToken currentAccessToken].tokenString];
   

   تسجيل الدخول باستخدام كلمة مرور البريد الإلكتروني

   Swift

   let credential = EmailAuthProvider.credential(withEmail: email, password: password)
   

   Objective-C

   FIRAuthCredential *credential =
       [FIREmailAuthProvider credentialWithEmail:email
                                                password:password];
   

3. تمرير الكائن FIRAuthCredential إلى حساب المستخدم الذي سجّل الدخول طريقة linkWithCredential:completion::

   Swift

       user.link(with: credential) { authResult, error in
     // ...
   }
   }
   

   Objective-C

       [[FIRAuth auth].currentUser linkWithCredential:credential
       completion:^(FIRAuthDataResult *result, NSError *_Nullable error) {
     // ...
   }];
   

إذا نجح الاتصال إلى linkWithCredential:completion:، يمكن إنشاء حساب المستخدم الجديد الوصول إلى بيانات Firebase للحساب المجهول.

التنظيف التلقائي

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

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

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

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

الآن بعد أن أصبح بإمكان المستخدمين المصادقة باستخدام Firebase، يمكنك التحكم في وصولهم إلى في قاعدة بيانات Firebase باستخدام قواعد Firebase.