在 Apple 平台上使用 App Check 保护非 Firebase 资源

您可以使用 App Check 来保护应用的非 Firebase 资源，例如自托管的后端。为此，您需要执行以下两项操作：

  • 修改您的应用客户端，以将 App Check 令牌随每个请求一起发送到后端，如本页所述。
  • 按照从自定义后端验证 App Check 令牌中所述，修改后端以要求将有效的 App Check 令牌随每个请求一起发送。

准备工作

使用 App Attest、DeviceCheck 或自定义提供方将 App Check 添加到您的应用。

通过后端请求发送 App Check 令牌

为了确保您的后端请求包含有效且未过期的 App Check 令牌，请将每个请求封装在对 AppCheck.token() 的调用中。App Check 库会在必要时刷新令牌，您可以在该方法的完成块中访问令牌。

获取有效的令牌后，请将其随请求一起发送到后端。具体如何实现取决于您自己，但不要将 App Check 令牌作为网址的一部分（包含在查询参数中）发送，因为这样会使其容易发生意外泄露以及被意外拦截。以下示例在自定义 HTTP 标头中发送令牌，这是推荐的方法。

Swift

do {
  let token = try await AppCheck.appCheck().token(forcingRefresh: false)

  // Get the raw App Check token string.
  let tokenString = token.token

  // Include the App Check token with requests to your server.
  let url = URL(string: "https://yourbackend.example.com/yourApiEndpoint")!
  var request = URLRequest(url: url)
  request.httpMethod = "GET"
  request.setValue(tokenString, forHTTPHeaderField: "X-Firebase-AppCheck")

  let task = URLSession.shared.dataTask(with: request) { data, response, error in
      // Handle response from your backend.
  }
  task.resume()
} catch(let error) {
  print("Unable to retrieve App Check token: \(error)")
  return
}

Objective-C

[[FIRAppCheck appCheck] tokenForcingRefresh:NO
                                 completion:^(FIRAppCheckToken * _Nullable token,
                                              NSError * _Nullable error) {
    if (error != nil) {
        // Handle any errors if the token was not retrieved.
        NSLog(@"Unable to retrieve App Check token: %@", error);
        return;
    }
    if (token == nil) {
        NSLog(@"Unable to retrieve App Check token.");
        return;
    }

    // Get the raw App Check token string.
    NSString *tokenString = token.token;

    // Include the App Check token with requests to your server.
    NSURL *url = [[NSURL alloc] initWithString:@"https://yourbackend.example.com/yourApiEndpoint"];
    NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:url];
    [request setHTTPMethod:@"GET"];
    [request setValue:tokenString forHTTPHeaderField:@"X-Firebase-AppCheck"];

    NSURLSessionDataTask *task =
        [[NSURLSession sharedSession] dataTaskWithRequest:request
                                        completionHandler:^(NSData * _Nullable data,
                                                            NSURLResponse * _Nullable response,
                                                            NSError * _Nullable error) {
        // Handle response from your backend.
    }];
    [task resume];
}];

重放攻击防范（Beta 版）

若是对启用了重放攻击防范的端点发出请求，请将请求封装在对 limitedUseToken()（而非 token()）的调用中：

Swift

AppCheck.appCheck().limitedUseToken() { token, error in
  // ...
}

Objective-C

[[FIRAppCheck appCheck] limitedUseTokenWithCompletion:^(FIRAppCheckToken * _Nullable token,
                                                        NSError * _Nullable error) {
    // ...
}];