iOS'te Google ile Oturum Açma için Uygulama Kontrolü'nü kullanmaya başlama

Bu sayfada, iOS uygulamalarında Uygulama Kontrolü'nün nasıl etkinleştirileceği gösterilmektedir. Uygulamayı etkinleştirdiğinizde Google OAuth 2.0'a yalnızca uygulamanızın erişebilmesini sağlamaya yardımcı olduğunuzu kontrol edin uç noktaları da oluşturabilirsiniz. Bu özelliğe genel bakış bölümüne göz atın.

Uygulama Kontrolü, OAuth 2.0'ın doğrulanmasına yardımcı olmak için App Attest'i (Uygulama Atısı) kullanır gelen istekler orijinal uygulamanızdan geliyor. Uygulama Kontrolü, sahtekarlık riskini analiz etmek için App Attest'i kullanmaz.

Başlamadan önce

  1. Xcode 12.5 veya daha yeni bir sürüme sahip olduğunuzdan emin olun.

  2. Google ile Oturum Açma kitaplığı.

1. Projenizi oluşturun

  1. Uygulama Kontrolü'nü kullanmak için bir Firebase projeniz olması gerekir Google ile Oturum Açma'ya gidin.

    • Uygulamanızda zaten Firebase kullanılıyorsa aynı projeyi kullanın.

    • Uygulamanızda Google ile Oturum Açma kullanılıyorsa ancak Firebase kullanılmıyorsa Google Cloud projesi. Firebase'i Google Cloud projenize eklemek için yeni bir proje oluştururken bunu seçtiğinizde Firebase konsolu

    Ayrıca bkz.: Firebase projeleri ile Google Cloud arasındaki ilişki

  2. Henüz yapmadıysanız iOS uygulamalarınızı Firebase projenize ekleyin Firebase konsolunun Proje ayarları sayfasını kullanarak.

  3. App Attest sağlayıcısıyla Uygulama Kontrolü'nü kullanmak için uygulamalarınızı Uygulama Kontrolü bölümüne gidin.

  4. Projenizin tüm OAuth istemcilerinin bir uygulamaya bağlı olduğundan emin olun.

    Bağlantısı kaldırılan müşterileriniz varsa Google Kimliği iOS için Uygulama Kontrolü sayfasının Ek kurulum gerektiren n OAuth istemcisinin bağlantısı kaldırıldı.

    Ayrıca, bazı OAuth istemcilerini kurduktan sonra sildiyseniz Uygulama Kontrolü'nde şunu belirten bir mesaj görürsünüz: n Eşleşen OAuth istemcisi olmayan geçersiz kılma işlemleri. Şu tarihe kadar güvenli bir şekilde yer açabilirsiniz: bu geçersiz kılmaları silebilirsiniz.

    Bağlantısı kaldırılan istemcileri mevcut veya yeni bir uygulamaya bağlayabilirsiniz. Firebase konsolunun OAuth istemcileri sayfası.

2. Beta Google ile Oturum Açma kitaplığını uygulamanıza ekleme

  1. Xcode projenizde Google ile Oturum Açma bağımlılığını sürüm olarak ayarlayın 7.1.0-fac-beta-1.1.0:

    SPM : Stratejik İş Ortağı Yöneticisi

    googlesignin-ios bağımlılığı kuralını tam sürüme ayarlayın: 7.1.0-fac-beta-1.1.0.

    CocoaPods

    Podfile güncelleyin:

    source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/firebase/SpecsDev.git'

target 'YourAppName' do
  use_frameworks!

  pod 'GoogleSignIn',
      :git => 'https://github.com/google/GoogleSignIn-iOS.git',
      :tag => '7.1.0-fac-beta-1.1.0'
  pod 'GoogleSignInSwiftSupport'  # If you use SwiftUI.
end

    Ardından pod install komutunu çalıştırın ve oluşturulan .xcworkspace dosyasını açın.

  2. Xcode'da, App Attest (Uygulama Onayı) özelliğini uygulamanıza ekleyin.

  3. Projenizin .entitlements dosyasında App Attest ortamını production.

3. Uygulama Kontrolü'nü Başlat

Uygulamanızda yetki verilen kullanıcının didFinishLaunchingWithOptions yönteminde şu çağrıyı yapın: GIDSignIn.sharedInstance.configure(completion:). Bu yöntemi çağırmalısınız mümkün olduğunca erken kullanmanızı öneririz.

import SwiftUI
import GoogleSignIn

class AppDelegate: NSObject, UIApplicationDelegate {
  func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
  ) -> Bool {
    #if targetEnvironment(simulator)
    // Configure for debugging.
    // See: https://developers.google.com/identity/sign-in/ios/appcheck/debug-provider
    #else
    GIDSignIn.sharedInstance.configure { error in
      if let error {
        print("Error configuring `GIDSignIn` for Firebase App Check: \(error)")
      }
    }
    #endif

    return true
  }
}

@main
struct YourAppNameApp: App {
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  // ...
}

Sonraki adımlar

Uygulama Kontrolü kitaplığı uygulamanıza yüklendikten sonra, uygulamayı kullanıcılarınıza güncelleyin.

Güncellenen istemci uygulaması, Google'ın kimlik doğrulama uç noktalarına gönderir, ancak uç noktalar otomatik olarak Uygulama Kontrolü'nde zorunlu kılmayı etkinleştirene kadar jetonların geçerli olmasını gerektirir bölümündeki talimatları uygulayın.

Metrikleri izleyin

Ancak, zorunlu kılmayı etkinleştirmeden önce, bu işlemin Mevcut güvenli kullanıcılarınızı kesintiye uğratabilir. Öte yandan, benzer bir Uygulama kaynaklarınızın şüpheli kullanımı durumunda, zorunlu kılma ayarını etkinleştirerek gerekir.

Bu kararı vermenize yardımcı olması için Google ile Oturum Açma için Uygulama Kontrolü metrikleri.

Uygulama Kontrolü'nün zorunlu kılınmasını etkinleştir

Uygulama Kontrolü'nün kullanıcılarınızı nasıl etkileyeceğini anladığınızda Devam ederseniz Uygulama Kontrolü'nün zorunlu kılınmasını etkinleştirebilirsiniz.

Hata ayıklama ortamlarında Uygulama Kontrolü'nü kullanma

Uygulamanızı Uygulama Kontrolü'ne kaydettikten sonra Uygulama Kontrolü'nün normalde geçerli olarak sınıflandıramadığı bir ortamda (örneğin, geliştirme sırasında veya sürekli entegrasyon (CI) ortamından Uygulama Kontrolü hata ayıklama sağlayıcısını kullanarak uygulamanızın hata ayıklama derlemesini oluşturabilirsiniz kullanabilirsiniz.

Hata ayıklama sağlayıcısıyla Uygulama Kontrolü'nü kullanma bölümüne göz atın.