بدء استخدام ميزة "التحقّق من التطبيقات" مع مقدّم خدمة مخصّص على أنظمة Apple الأساسية

توضّح لك هذه الصفحة كيفية تفعيل App Check في تطبيق Apple باستخدام مقدّم خدمة App Check المخصّص. عند تفعيل "App Check"، يساعد ذلك في ضمان أنّه بإمكان تطبيقك فقط الوصول إلى موارد Firebase الخاصة بمشروعك.

إذا أردت استخدام App Check مع مقدّمي الخدمات المدمجين، يمكنك الاطّلاع على مستندات App Check مع App Attest و App Check مع DeviceCheck.

قبل البدء

1. إضافة مكتبة App Check إلى تطبيقك

  1. استخدِم Swift Package Manager لتثبيت ملحقات Firebase وإدارتها.

    في Xcode، افتح مشروع تطبيقك وانتقِل إلى ملف > إضافة حزم، ثم أضِف مستودع حزمة تطوير البرامج (SDK) لمنصات Apple من Firebase (https://github.com/firebase/firebase-ios-sdk)، واختَر مكتبة FirebaseAppCheck.

2. تنفيذ بروتوكولات App Check

أولاً، عليك إنشاء فئات تنفّذ بروتوكولَي AppCheckProvider وAppCheckProviderFactory.

يجب أن تتضمّن فئة AppCheckProvider طريقة getToken(completion:)، والتي تجمع أي معلومات يتطلبها مقدّم خدمة App Check المخصّص كدليل على الأصالة، وترسلها إلى خدمة الحصول على الرمز المميّز مقابل رمز App Check المميّز. تتعامل حزمة تطوير البرامج (SDK) لـ App Check مع التخزين المؤقت للرموز المميّزة، لذا احصل دائمًا على رمز مميّز جديد في عملية تنفيذ getToken(completion:).

Swift

class YourCustomAppCheckProvider: NSObject, AppCheckProvider {
  var app: FirebaseApp

  init(withFirebaseApp app: FirebaseApp) {
    self.app = app
    super.init()
  }

  func getToken() async throws -> AppCheckToken {
    let getTokenTask = Task { () -> AppCheckToken in
      // ...

      // Create AppCheckToken object.
      let exp = Date(timeIntervalSince1970: expirationFromServer)
      let token = AppCheckToken(
        token: tokenFromServer,
        expirationDate: exp
      )

      if Date() > exp {
        throw NSError(domain: "ExampleError", code: 1, userInfo: nil)
      }

      return token
    }

    return try await getTokenTask.value
  }

}

Objective-C

@interface YourCustomAppCheckProvider : NSObject <FIRAppCheckProvider>

@property FIRApp *app;

- (id)initWithApp:(FIRApp *)app;

@end

@implementation YourCustomAppCheckProvider

- (id)initWithApp:app {
    self = [super init];
    if (self) {
        self.app = app;
    }
    return self;
}

- (void)getTokenWithCompletion:(nonnull void (^)(FIRAppCheckToken * _Nullable,
                                                 NSError * _Nullable))handler {
    dispatch_async(dispatch_get_main_queue(), ^{
        // Logic to exchange proof of authenticity for an App Check token.
        // ...

        // Create FIRAppCheckToken object.
        NSTimeInterval exp = expirationFromServer;
        FIRAppCheckToken *token
            = [[FIRAppCheckToken alloc] initWithToken:tokenFromServer
                                       expirationDate:[NSDate dateWithTimeIntervalSince1970:exp]];

        // Pass the token or error to the completion handler.
        handler(token, nil);
    });
}

@end

عليك أيضًا تنفيذ فئة AppCheckProviderFactory تنشئ مثيلات لتنفيذ AppCheckProvider:

Swift

class YourCustomAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    return YourCustomAppCheckProvider(withFirebaseApp: app)
  }
}

Objective-C

@interface YourCustomAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourCustomAppCheckProviderFactory

- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(FIRApp *)app {
    return [[YourCustomAppCheckProvider alloc] initWithApp:app];
}

@end

3- إعداد App Check

أضِف رمز الإعداد التالي إلى مفوّض التطبيق أو أداة إعداد التطبيق:

Swift

let providerFactory = YourAppCheckProviderFactory()
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

Objective-C

YourAppCheckProviderFactory *providerFactory =
        [[YourAppCheckProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

[FIRApp configure];

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

بعد تثبيت مكتبة App Check في تطبيقك، ابدأ بتوزيع التطبيق المحدَّث على المستخدمين.

سيبدأ تطبيق العميل المحدَّث في إرسال رموز App Check المميّزة مع كل طلب يرسله إلى Firebase، ولكن لن تتطلّب منتجات Firebase أن تكون الرموز المميّزة صالحة إلى أن يتم تفعيل إجراء التنفيذ في قسم App Check من وحدة تحكُّم Firebase.

مراقبة المقاييس وتفعيل إجراءات التنفيذ

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

للمساعدة في اتخاذ هذا القرار، يمكنك الاطّلاع على مقاييس App Check للخدمات التي تستخدمها:

تفعيل إجراءات التنفيذ في App Check

عندما تفهم كيف سيؤثر App Check في المستخدمين وتكون مستعدًا للمتابعة، يمكنك تفعيل إجراءات تنفيذ App Check:

استخدام App Check في بيئات تصحيح الأخطاء

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

يُرجى الاطّلاع على مقالة استخدام App Check مع مقدّم خدمة تصحيح الأخطاء على أنظمة Apple الأساسية.