Firebase dışı kaynakları Android'deki Uygulama Kontrolü ile koruyun

Uygulamanızın, şirket içinde barındırılan arka uçlar gibi Firebase dışı kaynaklarını Uygulama Kontrolü ile koruyabilirsiniz. Bunu yapmak için aşağıdakilerden ikisini de yapmanız gerekir:

Sen başlamadan önce

Varsayılan Play Integrity sağlayıcısını veya özel bir sağlayıcıyı kullanarak uygulamanıza Uygulama Kontrolü ekleyin.

Arka uç istekleriyle Uygulama Kontrolü belirteçlerini gönderin

Arka uç isteklerinizin geçerli, süresi dolmamış bir Uygulama Denetimi jetonu içerdiğinden emin olmak için her isteği getAppCheckToken() çağrısına sarın. Uygulama Denetimi kitaplığı gerekirse belirteci yeniler ve belirtece yöntemin başarı dinleyicisinden erişebilirsiniz.

Geçerli bir tokena sahip olduğunuzda bunu istekle birlikte arka ucunuza gönderin. Bunu nasıl başaracağınıza ilişkin ayrıntılar size bağlıdır, ancak Uygulama Kontrolü belirteçlerini, sorgu parametreleri de dahil olmak üzere URL'lerin bir parçası olarak göndermeyin ; aksi takdirde bu, yanlışlıkla sızmaya ve ele geçirilmeye karşı savunmasız hale gelir. Önerilen yaklaşım, belirteci özel bir HTTP başlığında göndermektir.

Örneğin, Retrofit'i kullanıyorsanız:

Kotlin+KTX

class ApiWithAppCheckExample {
    interface YourExampleBackendService {
        @GET("yourExampleEndpoint")
        fun exampleData(
            @Header("X-Firebase-AppCheck") appCheckToken: String,
        ): Call<List<String>>
    }

    var yourExampleBackendService: YourExampleBackendService = Retrofit.Builder()
        .baseUrl("https://yourbackend.example.com/")
        .build()
        .create(YourExampleBackendService::class.java)

    fun callApiExample() {
        Firebase.appCheck.getAppCheckToken(false).addOnSuccessListener { appCheckToken ->
            val token = appCheckToken.token
            val apiCall = yourExampleBackendService.exampleData(token)
            // ...
        }
    }
}

Java

public class ApiWithAppCheckExample {
    private interface YourExampleBackendService {
        @GET("yourExampleEndpoint")
        Call<List<String>> exampleData(
                @Header("X-Firebase-AppCheck") String appCheckToken);
    }

    YourExampleBackendService yourExampleBackendService = new Retrofit.Builder()
            .baseUrl("https://yourbackend.example.com/")
            .build()
            .create(YourExampleBackendService.class);

    public void callApiExample() {
        FirebaseAppCheck.getInstance()
                .getAppCheckToken(false)
                .addOnSuccessListener(new OnSuccessListener<AppCheckToken>() {
                    @Override
                    public void onSuccess(@NonNull AppCheckToken appCheckToken) {
                        String token = appCheckToken.getToken();
                        Call<List<String>> apiCall =
                                yourExampleBackendService.exampleData(token);
                        // ...
                    }
                });
    }
}

Tekrar oynatma koruması (beta)

Tekrar oynatma korumasını etkinleştirdiğiniz bir uç noktaya istekte bulunurken, isteği getLimitedUseAppCheckToken() yerine getAppCheckToken() çağrısına sarın:

Kotlin+KTX

Firebase.appCheck.limitedUseAppCheckToken.addOnSuccessListener {
    // ...
}

Java

FirebaseAppCheck.getInstance()
        .getLimitedUseAppCheckToken().addOnSuccessListener(
                new OnSuccessListener<AppCheckToken>() {
                    @Override
                    public void onSuccess(AppCheckToken appCheckToken) {
                        String token = appCheckToken.getToken();
                        // ...
                    }
                }
        );