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:
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(); // ... } } );