Unity uygulamalarında Uygulama Kontrolü'nü kullanmaya başlayın

Bu sayfada, varsayılan sağlayıcıları (Android'de Play Integrity, Apple platformlarında ise Device Check veya App Attest) kullanarak Unity uygulamasında App Check'in nasıl etkinleştirileceği gösterilmektedir. Uygulama Kontrolü'nü etkinleştirdiğinizde, yalnızca uygulamanızın projenizin Firebase kaynaklarına erişebilmesini sağlarsınız. Bu özelliğe genel bakış bölümünü inceleyin.

1. Firebase projenizi oluşturma

  1. Henüz yapmadıysanız Firebase'i Unity projenize ekleyin.

  2. Firebase konsolunda Güvenlik > Uygulama Kontrolü'ne gidin.

  3. Uygulamalar sekmesinde, uygulamalarınızı Play Integrity, DeviceCheck veya App Attest sağlayıcılarıyla App Check kullanacak şekilde kaydedin.

    Genellikle projenizin tüm uygulamalarını kaydetmeniz gerekir. Çünkü bir Firebase ürünü için zorunlu kılmayı etkinleştirdiğinizde yalnızca kayıtlı uygulamalar ürünün arka uç kaynaklarına erişebilir.

    Her sağlayıcıya nasıl kaydolacağınıza dair ayrıntılı talimatlar için Android ve iOS'a özel dokümanlara bakın.

  4. İsteğe bağlı: Uygulama kaydı ayarlarında, sağlayıcı tarafından verilen App Check jetonları için özel bir geçerlilik süresi (TTL) ayarlayın. TTL'yi 30 dakika ile 7 gün arasında herhangi bir değere ayarlayabilirsiniz. Bu değeri değiştirirken aşağıdaki dengelemeleri göz önünde bulundurun:

    • Güvenlik: Sızdırılmış veya müdahale edilmiş bir jetonun saldırgan tarafından kötüye kullanılabileceği süreyi kısalttığı için daha kısa TTL'ler daha güçlü güvenlik sağlar.
    • Performans: Daha kısa TTL'ler, uygulamanızın doğrulama işlemini daha sık gerçekleştireceği anlamına gelir. Uygulama doğrulama işlemi her gerçekleştirildiğinde ağ isteklerine gecikme eklediğinden kısa bir TTL, uygulamanızın performansını etkileyebilir.
    • Kota ve maliyet: Daha kısa TTL'ler ve sık yeniden onaylama, kotanızı daha hızlı tüketir ve ücretli hizmetlerde daha fazla maliyete neden olabilir. Kotalar ve sınırlar bölümüne bakın.

    Varsayılan TTL, çoğu uygulama için uygundur. Uygulama Kontrolü kitaplığının, TTL süresinin yaklaşık yarısında jetonları yenilediğini unutmayın.

2. Uygulama Kontrolü kitaplığını uygulamanıza ekleme

App Check için kurulum talimatlarını uygulayarak App Check kitaplığını bağımlılıklarınıza ekleyin.

3. Uygulama Kontrolü'nü başlatma

Firebase uygulamaları oluşturma da dahil olmak üzere herhangi bir Firebase hizmetini kullanmadan önce çalışması için aşağıdaki ilk kullanıma hazırlama kodunu uygulamanıza ekleyin.

Android

  1. Firebase.AppCheck için kullanım beyanı ekleyin:

    using Firebase.AppCheck

  2. App Check kitaplığını Play Integrity sağlayıcısıyla başlatın:

    FirebaseAppCheck.SetAppCheckProviderFactory(
    PlayIntegrityProviderFactory.Instance);

iOS+

  1. Firebase.AppCheck için kullanım beyanı ekleyin:

    using Firebase.AppCheck

  2. Uygulama Kontrolü kitaplığını Device Check veya App Attest sağlayıcısıyla başlatın:

    FirebaseAppCheck.SetAppCheckProviderFactory(
    DeviceCheckProviderFactory.Instance);

Sonraki adımlar

Uygulama Denetimi kitaplığı uygulamanıza yüklendikten sonra güncellenen uygulamayı kullanıcılarınıza dağıtmaya başlayın.

Güncellenen istemci uygulaması, Firebase'e yaptığı her istekle birlikte Uygulama Kontrolü jetonları göndermeye başlar. Ancak Firebase ürünleri, Firebase konsolunun Uygulama Kontrolü bölümünde zorunlu kılmayı etkinleştirmediğiniz sürece jetonların geçerli olmasını gerektirmez.

Metrikleri izleme ve yaptırım uygulama

Ancak zorunlu kılmayı etkinleştirmeden önce, bu işlemin mevcut meşru kullanıcılarınızın hizmetten yararlanmasını engellemeyeceğinden emin olmanız gerekir. Öte yandan, uygulama kaynaklarınızın şüpheli bir şekilde kullanıldığını görüyorsanız yaptırımı daha erken etkinleştirmek isteyebilirsiniz.

Bu kararı vermenize yardımcı olması için kullandığınız hizmetlerin Uygulama Denetimi metriklerine bakabilirsiniz:

Uygulama Kontrolü'nü zorunlu kılma

Uygulama Denetimi'nin kullanıcılarınızı nasıl etkileyeceğini anladığınızda ve devam etmeye hazır olduğunuzda Uygulama Denetimi'nin zorunlu kılınmasını etkinleştirebilirsiniz:

Hata ayıklama ortamlarında App Check'i kullanma

Uygulamanızı Uygulama Kontrolü'ne kaydettikten sonra, Uygulama Kontrolü'nün normalde geçerli olarak sınıflandırmayacağı bir ortamda (ör. masaüstünde, geliştirme sırasında bir emülatörde veya sürekli entegrasyon (CI) ortamından) çalıştırmak istiyorsanız uygulamanızın gerçek bir onay sağlayıcı yerine Uygulama Kontrolü hata ayıklama sağlayıcısını kullanan bir hata ayıklama sürümünü oluşturabilirsiniz.

Unity uygulamalarında hata ayıklama sağlayıcısıyla App Check'i kullanma başlıklı makaleyi inceleyin.