Apple platformlarında Uygulama Kontrolü ile Firebase dışı kaynakları koruyun

Uygulama Kontrolü ile uygulamanızın Firebase dışındaki kaynaklarını (ör. kendi bünyesinde barındırılan arka uçlar) koruyabilirsiniz. Bunun için aşağıdakilerin ikisini de yapmanız gerekir:

  • Bu sayfada açıklandığı gibi uygulama istemcinizi her istekle birlikte arka ucunuza bir Uygulama Kontrolü jetonu gönderecek şekilde değiştirin.
  • Özel arka uçtan Uygulama Kontrolü jetonlarını doğrulama bölümünde açıklandığı gibi, arka ucunuzu her istekle birlikte geçerli bir Uygulama Kontrolü jetonu gerektirecek şekilde değiştirin.

Başlamadan önce

App Attest, DeviceCheck veya özel sağlayıcı kullanarak uygulamanıza Uygulama Kontrolü'nü ekleyin.

Arka uç istekleriyle birlikte Uygulama Kontrolü jetonları gönderme

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

Geçerli bir jeton edindikten sonra bu jetonu istekle birlikte arka ucunuza gönderin. Bunu nasıl yapacağınız size kalmıştır ancak sorgu parametreleri de dahil olmak üzere Uygulama Kontrolü jetonlarını URL'lerin bir parçası olarak göndermeyin. Aksi takdirde bu jetonlar yanlışlıkla sızıntılara ve müdahaleye karşı savunmasız hale gelir. Aşağıdaki örnek, jetonu önerilen yaklaşım olan özel bir HTTP üst bilgisinde gönderir.

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 istekte bulunurken, isteği token() yerine limitedUseToken() çağrısına yerleştirin:

Swift

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

Objective-C

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