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:

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

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ü jetonlarını 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 gerçekleştireceğinizin ayrıntıları size bağlıdır, ancak Uygulama Kontrolü jetonlarını sorgu parametreleri de dahil olmak üzere URL'lerin bir parçası olarak göndermeyin ; aksi takdirde bu jetonlar kazara sızıntıya ve müdahaleye karşı savunmasız kalır. Önerilen yaklaşım, belirteci özel bir HTTP başlığında göndermektir.

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

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)
            // ...
        }
    }
}
ApiWithAppCheckExample.kt

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);
                        // ...
                    }
                });
    }
}
ApiWithAppCheckExample.java

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:

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

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