Apple platformlarında özel arka uç kaynaklarını Uygulama Kontrolü ile koruma

Uygulamanız için Google dışı özel arka uç kaynaklarını (ör. kendi barındırdığınız arka uç) korumak üzere App Check kullanabilirsiniz. Bunun için aşağıdakilerin ikisini de yapmanız gerekir:

  • Uygulama istemcinizi, bu sayfada açıklandığı şekilde arka ucunuza gönderilen her istekle birlikte bir App Check jetonu gönderecek şekilde değiştirin.
  • Özel bir arka uçtan App Check jetonlarını doğrulama başlıklı makalede açıklandığı gibi, arka ucunuzu her istekte geçerli bir App Check jetonu gerektirecek şekilde değiştirin.

Başlamadan önce

App Attest, DeviceCheck veya özel sağlayıcı kullanarak uygulamanıza App Check ekleyin.

Arka uç istekleriyle App Check jetonları gönderme

Arka uç isteklerinizin geçerli ve süresi dolmamış bir App Check jetonu içerdiğinden emin olmak için her isteği bir AppCheck.token() çağrısına sarmalayın. App Check kitaplığı, gerekirse jetonu yeniler ve yöntemin tamamlama bloğunda jetona erişebilirsiniz.

Geçerli bir jeton aldıktan sonra bu jetonu istekle birlikte arka ucunuza gönderin. Bunu nasıl yapacağınız size bağlıdır ancak App Check jetonlarını URL'lerin bir parçası olarak göndermeyin. Sorgu parametreleri de buna dahildir. Aksi takdirde jetonlar yanlışlıkla sızdırılabilir ve ele geçirilebilir. Aşağıdaki örnekte, jeton özel bir HTTP üstbilgisinde gönderilir. Bu, önerilen yaklaşımdır.

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];
}];

Tekrar oynatma koruması (beta)

Tekrar oynatma korumasını etkinleştirdiğiniz bir uç noktaya istek gönderirken isteği token() yerine limitedUseToken() çağrısına sarmalayın:

Swift

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

Objective-C

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