欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

开始在 Apple 平台上通过 App Attest 使用 App Check

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

此页面向您展示如何使用内置的 App Attest 提供程序在 Apple 应用中启用 App Check。当您启用 App Check 时,您有助于确保只有您的应用可以访问您项目的 Firebase 资源。请参阅此功能的概述

App Check 使用App Attest来验证对 Firebase 服务的请求是否来自您的真实应用。 App Check 目前不使用 App Attest 来分析欺诈风险

如果您想将 App Check 与您自己的自定义提供程序一起使用,请参阅实现自定义应用程序检查提供程序

1. 设置您的 Firebase 项目

  1. 您需要 Xcode 12.5+ 才能使用 App Attest。

  2. 如果您还没有这样做,请将 Firebase 添加到您的 Apple 项目中。

  3. 在 Firebase 控制台的App Check部分注册您的应用以使用 App Attest 提供程序使用 App Check。

    您通常需要注册项目的所有应用,因为一旦您为 Firebase 产品启用强制执行,只有已注册的应用才能访问该产品的后端资源。

  4. 可选:在应用注册设置中,为提供商发布的应用检查令牌设置自定义生存时间 (TTL)。您可以将 TTL 设置为 30 分钟到 7 天之间的任何值。更改此值时,请注意以下权衡:

    • 安全性:较短的 TTL 可提供更强的安全性,因为它减少了泄露或拦截的令牌可能被攻击者滥用的窗口。
    • 性能:较短的 TTL 意味着您的应用将更频繁地执行证明。由于应用程序证明过程每次执行都会增加网络请求的延迟,因此较短的 TTL 可能会影响应用程序的性能。
    • 配额和成本:较短的 TTL 和频繁的重新证明会更快地耗尽您的配额,而对于付费服务,可能会花费更多。请参阅配额和限制

    对于大多数应用程序来说, 1 小时的默认 TTL 是合理的。请注意,App Check 库以大约一半的 TTL 持续时间刷新令牌。

2. 将 App Check 库添加到您的应用程序

  1. 将 App Check 的依赖项添加到项目的Podfile

    pod 'FirebaseAppCheck'

    或者,您也可以改用Swift 包管理器

    确保您还使用了您所依赖的任何其他 Firebase SDK 的最新版本。

  2. 运行pod install并打开创建的.xcworkspace文件。

  3. 在 Xcode 中,将App Attest功能添加到您的应用程序。

  4. 在项目的.entitlements文件中,将 App Attest 环境设置为production

3.初始化应用检查

在使用任何其他 Firebase SDK 之前,您需要初始化 App Check。

首先,编写AppCheckProviderFactory的实现。您的实施细节将取决于您的用例。

例如,如果您只有 iOS 14 及更高版本的用户,您可以简单地始终创建AppAttestProvider对象:

迅速

注意:此 Firebase 产品不适用于 watchOS 目标。

class YourSimpleAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    return AppAttestProvider(app: app)
  }
}

Objective-C

注意:此 Firebase 产品不适用于 watchOS 目标。

@interface YourSimpleAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourSimpleAppCheckProviderFactory

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

@end

或者,您可以在 iOS 14 及更高版本上创建AppAttestProvider对象,并在早期版本上回DeviceCheckProvider

迅速

注意:此 Firebase 产品不适用于 watchOS 目标。

class YourAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    if #available(iOS 14.0, *) {
      return AppAttestProvider(app: app)
    } else {
      return DeviceCheckProvider(app: app)
    }
  }
}

Objective-C

注意:此 Firebase 产品不适用于 watchOS 目标。

@interface YourAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourAppCheckProviderFactory

- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(nonnull FIRApp *)app {
  if (@available(iOS 14.0, *)) {
    return [[FIRAppAttestProvider alloc] initWithApp:app];
  } else {
    return [[FIRDeviceCheckProvider alloc] initWithApp:app];
  }
}

@end

实现AppCheckProviderFactory类后,配置 App Check 以使用它:

迅速

注意:此 Firebase 产品不适用于 watchOS 目标。

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

FirebaseApp.configure()

Objective-C

注意:此 Firebase 产品不适用于 watchOS 目标。

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

[FIRApp configure];

下一步

在您的应用中安装 App Check 库后,开始将更新的应用分发给您的用户。

更新后的客户端应用将开始向 Firebase 发出的每个请求发送 App Check 令牌,但 Firebase 产品不需要令牌有效,直到您在 Firebase 控制台的 App Check 部分启用强制执行。

监控指标并启用强制执行

但是,在启用强制执行之前,您应该确保这样做不会破坏您现有的合法用户。另一方面,如果您发现对应用资源的使用可疑,您可能希望尽快启用强制执行。

为了帮助做出此决定,您可以查看您使用的服务的 App Check 指标:

启用应用检查强制

当您了解 App Check 将如何影响您的用户并准备好继续时,您可以启用 App Check 强制执行:

在调试环境中使用 App Check

如果在您为 App Check 注册您的应用程序后,您希望在 App Check 通常不会归类为有效的环境中运行您的应用程序,例如开发期间的模拟器,或者从持续集成 (CI) 环境中,您可以创建使用 App Check 调试提供程序而不是真正的证明提供程序的应用程序的调试版本。

请参阅在 Apple 平台上通过调试提供程序使用 App Check