iOS için Navigation SDK'nın güvenliğini sağlamak üzere Uygulama Kontrolü'nü kullanma

Firebase Uygulama Kontrolü, yasal uygulamalarınız dışındaki kaynaklardan gelen trafiği engelleyerek uygulamanızdan Google Haritalar Platformu'na yapılan çağrılar için koruma sağlar. Bunu yapmak için App Attest gibi bir onay sağlayıcıdan uygulamanın veya cihazın orijinalliğinin değerlendirilmesini ister. Uygulamanızı Uygulama Kontrolü ile entegre ettiğinizde kötü amaçlı ve yetkisiz isteklere karşı koruma eklemiş olursunuz. Bu da faturalandırmanızı yetkisiz ödemelere karşı korur. Uygulama Kontrolü, filo uygulaması ekosisteminizdeki gerçek zamanlı aksaklık raporlamasını da önemli ölçüde iyileştirir. Böylece uygulamanızı kullanan tüm sürücüler bu özellikten yararlanabilir. Daha fazla bilgi için Aksaklık raporlama başlıklı makaleyi inceleyin.

Uygulama Kontrolü'nü neden kullanmalısınız?

Uygulama Kontrolü, iOS için Navigation SDK'nın iki farklı alanını korur: ana navigasyon işlevi ve kesinti raporlama.

Uygulama Kontrolü, iOS için ana Navigasyon SDK'sı isteklerinin kötü amaçlı veya yetkisiz kaynaklardan gelmesini engellemeye yardımcı olur. Bu sayede projeniz faturalandırma sahtekarlığına ve kota aşımına karşı korunur.

Kesinti raporlama

Uygulamanızda gerçek zamanlı kesinti bildirme ve oylama özellikleri destekleniyorsa Uygulama Kontrolü'nü kullanmanız önemle tavsiye edilir. Uygulama Kontrolü'nü etkinleştirdiğinizde sürücülerinize tüm anlık geri bildirimleri dikkate alan en doğru rotalar sunulur.

Raporlama açısından Uygulama Kontrolü neden önemlidir?

  • Kapalı yollar için yüksek güven eşiği: Kapalı yol gibi rotayı etkileyen olaylar, tüm sürücülerin rota davranışını önemli ölçüde değiştirebilir. Google'ın kapalı yol aksaklıkları için moderasyon altyapısı, haritayı olası vandalizm, spam veya yanlış bildirimlerden korumak için güçlü cihaz ve uygulama bütünlüğü sinyallerini kullanır.
  • Uygulama Kontrolü, raporları nasıl doğrular? iOS için Navigation SDK'dan gönderilen kullanıcı raporları ve oyları, geri bildirimin geçerliliğini doğrulamak için Google'ın arka ucu tarafından kullanılan Uygulama Kontrolü jetonunu içerir. Bu jeton, geri bildirimin güven düzeyini yükseltir ve canlı harita üzerindeki etkisinin değerlendirilmesine olanak tanır.
  • Uygulama Kontrolü'nü kullanmamanın etkisi: Geçerli bir Uygulama Kontrolü jetonu olmadan gönderilen raporlar, daha düşük güvene sahip bir model kapsamında değerlendirilir ve yalnızca sessiz sinyaller olarak işlenebilir. Bu, kullanıcılarınızın bildirimde bulunmaya ve oy vermeye devam edebileceği ancak bildirimlerinin haritada görünme veya diğer sürücülerin rotalarını etkileme olasılığının daha düşük olduğu ve ek doğrulama gerektireceği anlamına gelir.

Uygulama Kontrolü benim için uygun mu?

Uygulama Kontrolü çoğu durumda önerilir ancak aşağıdaki senaryolarda Uygulama Kontrolü gerekli değildir veya desteklenmez:

  • Özel veya deneysel uygulamalar: Uygulamanız herkese açık değilse Uygulama Kontrolü gerekli değildir.
  • Güvenliği ihlal edilmiş cihazlar: Önerilen onay sağlayıcılar, iOS için Navigasyon SDK'sının rootlanmış veya jailbreak'li telefonlar gibi güvenilmeyen cihazlarda çalışmasını engeller. Bu cihazları desteklemek için özel bir onay sağlayıcı dağıtın.

Uygulama adımlarına genel bakış

Uygulamanızı Uygulama Kontrolü ile entegre etmek için genel olarak şu adımları uygulayacaksınız:

  1. Uygulamanıza Firebase'i ekleyin.
  2. Uygulama Kontrolü kitaplığını ekleyin ve Uygulama Kontrolü'nü başlatın.
  3. Jeton sağlayıcı ekleyin. Bu adım, cihazın veya uygulamanın bütünlüğünü doğrulamak için seçtiğiniz onay sağlayıcıyı çağırır.
  4. Navigation ve App Check API'lerini başlatın.
  5. Hata ayıklamayı etkinleştirin. Bu, geliştirme sırasında veya sürekli entegrasyon (CI) ortamlarında kullanışlıdır.
  6. Yaptırımı etkinleştirmeden önce uygulama isteklerinizi izleyin. Bu sayede, kullanıcılarınızı rahatsız etmeden Uygulama Kontrolü'nü sorunsuz bir şekilde uygulayabilirsiniz.

Uygulama Kontrolü entegrasyonu planlarken dikkat edilmesi gerekenler

  • Onay Sağlayıcı Kotaları: Önerdiğimiz onay sağlayıcılar (DeviceCheck veya App Attest), Apple tarafından belirlenen kotalara ve sınırlamalara tabidir.
  • Başlatma Gecikmesi: Çoğu durumda, Uygulama Kontrolü jetonları cihazda önbelleğe alındığı için kullanıcılarınız normal kullanım sırasında gecikme yaşamaz. Sistem, sorunsuz performans sağlamak için Uygulama Kontrolü jetonlarını süresi dolmadan önce arka planda otomatik olarak yeniler. Ancak geçerli bir Uygulama Kontrolü jetonu yoksa uygulama kullanıcılarınız başlatma sırasında biraz gecikme yaşar. Örneğin, önbelleğe alınmış bir jetonun süresi dolduğunda veya jeton eksik olduğunda soğuk başlatma sırasında bu gecikme yaşanır.
  • Jetonun geçerlilik süresi (TTL): Geçerlilik süresi (TTL), Uygulama Kontrolü jetonunun yenilenmesi gerekmeden önce geçerli kalacağı süreyi belirler. Bu süreyi Firebase konsolunda 30 dakika ile 7 gün arasında yapılandırabilirsiniz. Güvenli bir temel olarak 1 saatlik süre önerilir ancak SDK, arka planda yenileme işlemlerini TTL süresinin yaklaşık yarısında otomatik olarak dener. Adım adım konsol talimatları için Firebase Uygulama Kontrolü belgelerine bakın.

Uygulamanızı Uygulama Kontrolü ile entegre etme

Ön koşullar ve şartlar

  • iOS için Navigasyon SDK'sının 11.0 veya sonraki bir sürümünün yüklü olduğu bir uygulama.
  • Uygulamanın paket kimliği.
  • Apple Developer Console'daki Üyelik sekmesinde yer alan Ekip Kimliğiniz.
  • DeviceCheck kullanmayı planlıyorsanız özel anahtar dosyanız ve anahtar kimliğiniz.
  • Google Cloud Console'da uygulamanın sahibi olmanız gerekir.
  • Google Cloud Console'daki uygulamanızın proje kimliği.

1. adım: Uygulamanıza Firebase'i ekleyin

Firebase'i uygulamanıza eklemek için Firebase geliştirici belgelerindeki talimatları uygulayın. GoogleService-Info.plist dosyanızı değiştirilmemiş olarak projenizin kök düzeyine ekleyin.

AppDelegate dosyanızda aşağıdaki modülleri içe aktarın:

Swift

import FirebaseCore
import FirebaseAppCheck
import GoogleNavigation

Objective-C

@import FirebaseCore;
@import FirebaseAppCheck;
@import GoogleNavigation;

2. adım: App Check kitaplığını ekleyin ve App Check'i başlatın

Firebase, her varsayılan onay sağlayıcı için talimatlar sağlar. Bu talimatlarda, Firebase projesi oluşturma ve App Check kitaplığını uygulamanıza ekleme adımları açıklanmaktadır. App Check'i başlatmak için sağlanan kod örneklerini uygulayın.

  1. Uygulama Kontrolü kitaplığını eklemek için Firebase talimatlarını uygulayın:
  2. AppDelegate içinde App Check'i başlatın:
    • App Attest kullanıyorsanız AppCheckProviderFactory uygulamasını oluşturun ve FirebaseApp.configure() yöntemini çağırmadan önce kaydedin:

      Swift

      class YourAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
    func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
        return AppAttestProvider(app: app)
    }
}
// In application(_:didFinishLaunchingWithOptions:)
let providerFactory = YourAppCheckProviderFactory()
AppCheck.setAppCheckProviderFactory(providerFactory)
FirebaseApp.configure()

      Objective-C

      #import <FirebaseCore/FirebaseCore.h>
#import <FirebaseAppCheck/FirebaseAppCheck.h>

@interface YourAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

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

// In application:didFinishLaunchingWithOptions:
YourAppCheckProviderFactory *providerFactory = [[YourAppCheckProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];
[FIRApp configure];
    • Bunun yerine DeviceCheck kullanıyorsanız aşağıdaki yöntemlerle fabrikayı ayarlayın:

      Swift

      AppCheck.setAppCheckProviderFactory(DeviceCheckProviderFactory())

      Objective-C

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

3. adım: Jeton sağlayıcıyı ekleyin

Uygulamanızın kök düzeyinde AppCheckTokenProvider adlı bir dosya (veya Objective-C kullanıyorsanız AppCheckTokenProvider.h ve AppCheckTokenProvider.m adlı iki dosya) oluşturun.

Bu sınıf, GMSAppCheckTokenProvider protokolüne uygun olmalı ve fetchAppCheckTokenWithCompletion yöntemini uygulamalıdır.

Swift

import Foundation
import FirebaseAppCheck
import GoogleNavigation

class AppCheckTokenProvider: NSObject, GMSAppCheckTokenProvider {
    func fetchAppCheckToken(completion: @escaping (String?, Error?) -> Void) {
        AppCheck.appCheck().token(forcingRefresh: false) { token, error in
            if let error = error {
                print("App Check Error: \(error)")
                completion(nil, error)
                return
            }
            guard let token = token else {
                completion(nil, NSError(domain: "AppCheck", code: -1, userInfo: [NSLocalizedDescriptionKey: "Token is nil"]))
                return
            }
            print("App Check Token: \(token.token)")
            completion(token.token, nil)
        }
    }
}

Objective-C

// AppCheckTokenProvider.h
#import <Foundation/Foundation.h>
#import <GoogleNavigation/GoogleNavigation.h>

NS_ASSUME_NONNULL_BEGIN

@interface AppCheckTokenProvider : NSObject <GMSAppCheckTokenProvider>
@end

NS_ASSUME_NONNULL_END
 
// AppCheckTokenProvider.m
#import "AppCheckTokenProvider.h"
#import <FirebaseAppCheck/FirebaseAppCheck.h>

@implementation AppCheckTokenProvider
- (void)fetchAppCheckTokenWithCompletion:(void (^)(NSString * _Nullable token, NSError * _Nullable error))completion {
    [[FIRAppCheck appCheck] tokenForcingRefresh:NO
                                     completion:^(FIRAppCheckToken * _Nullable token, NSError * _Nullable error) {
        if (token) {
            completion(token.token, nil);
        } else {
            completion(nil, error);
        }
    }];
}
@end

4. adım: Navigation ve App Check API'lerini başlatın

iOS için Gezinme SDK'sını ilk kullanıma hazırlayın ve jeton sağlayıcı örneğinizi GMSServices üzerinde kaydedin:

Swift

// In application(_:didFinishLaunchingWithOptions:)
GMSServices.provideAPIKey("YOUR_API_KEY")

// Register your App Check token provider before initializing Navigation SDK for iOS
GMSServices.appCheckTokenProvider = AppCheckTokenProvider()

Objective-C

// In application:didFinishLaunchingWithOptions:
[GMSServices provideAPIKey:@"YOUR_API_KEY"];

// Register your App Check token provider before initializing Navigation SDK for iOS
GMSServices.appCheckTokenProvider = [[AppCheckTokenProvider alloc] init];

5. adım: Hata ayıklamayı etkinleştirme (isteğe bağlı)

iOS için Navigasyon SDK'sında Uygulama Kontrolü zorunlu kılındıktan sonra, uygulamanızın iOS için Navigasyon SDK'sına bağlı özellikleri simülatörde veya sürekli entegrasyon (CI) ortamında çalışmaz. Bunun nedeni, bu ortamların geçerli cihazlar olarak kabul edilmemesidir. Uygulamanızı geliştirme ve test aşamasında bu ortamlarda çalıştırmak için uygulamanızın, canlı sürüm onaylama sağlayıcısı yerine Uygulama Kontrolü hata ayıklama sağlayıcısını kullanan bir hata ayıklama derlemesini oluşturmanız gerekir.

  1. AppDelegate uygulamanızda hata ayıklama sağlayıcı fabrikasını yapılandırın:

    Swift

    #if targetEnvironment(simulator)
let providerFactory = AppCheckDebugProviderFactory()
#else
let providerFactory = YourAppCheckProviderFactory()
#endif
AppCheck.setAppCheckProviderFactory(providerFactory)

    Objective-C

    #if TARGET_OS_SIMULATOR
id<FIRAppCheckProviderFactory> providerFactory = [[FIRAppCheckDebugProviderFactory alloc] init];
#else
id<FIRAppCheckProviderFactory> providerFactory = [[YourAppCheckProviderFactory alloc] init];
#endif
[FIRAppCheck setAppCheckProviderFactory:providerFactory];
  2. Xcode projenizde günlük kaydını etkinleştirin, uygulamayı başlatın ve konsol günlüğünde yerel hata ayıklama jetonunu bulun.
  3. Bu hata ayıklama jetonunu kopyalayıp Firebase konsoluna ekleyin. Daha fazla bilgi için Firebase Uygulama Kontrolü hata ayıklama sağlayıcısı belgelerini inceleyin.

6. adım: Uygulama isteklerinizi izleyin ve yaptırım konusunda karar verin

Yaptırımı etkinleştirmeden önce, meşru kullanıcıların hizmetten yararlanmasını engellemeyeceğinizden emin olmak için uygulama isteklerinizi izleyin.

  1. Doğrulanmış ve doğrulanmamış trafiğin yüzdesini görmek için Firebase konsolunda Uygulama Kontrolü metrikleri ekranını ziyaret edin.
  2. Trafiğinizin çoğunluğunun doğrulandığından ve meşru kullanıcıların uygulamanızın Uygulama Kontrolü uygulamanızı içeren bir sürümüne güncellediğinden emin olduktan sonra yaptırımı etkinleştirin.
  3. Yaptırım etkinleştirildikten sonra Uygulama Kontrolü, geçerli bir Uygulama Kontrolü jetonu olmayan tüm trafiği reddeder.