Gunakan App Check dengan penyedia debug di platform Apple

Jika, setelah Anda mendaftarkan aplikasi untuk App Check, Anda ingin menjalankan aplikasi di lingkungan yang biasanya tidak diklasifikasikan sebagai valid oleh App Check, seperti simulator selama pengembangan, atau dari lingkungan continuous integration (CI), Anda dapat buat build debug aplikasi Anda yang menggunakan penyedia debug App Check alih-alih penyedia pengesahan nyata.

Peringatan: Penyedia debug mengizinkan akses ke sumber daya Firebase Anda dari perangkat yang belum diverifikasi. Jangan gunakan penyedia debug dalam build produksi aplikasi Anda, dan berhati-hatilah agar tidak membocorkan token debug Anda.

Gunakan penyedia debug di simulator

Untuk menggunakan penyedia debug saat menjalankan aplikasi Anda dalam simulator secara interaktif (selama pengembangan, misalnya), lakukan hal berikut:

1. Di build debug Anda, sebelum menggunakan layanan backend Firebase, buat dan setel pabrik penyedia debug App Check:

   Cepat

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

2. Aktifkan logging debug di proyek Xcode Anda (v11.0 atau lebih baru):

   1. Buka Produk > Skema > Edit skema .
   2. Pilih Jalankan dari menu sebelah kiri, lalu pilih tab Argumen .
   3. Di bagian Argumen yang Diteruskan saat Peluncuran , tambahkan -FIRDebugEnabled .

3. Luncurkan aplikasi. Token debug lokal akan dicatat ketika SDK mencoba mengirim permintaan ke backend. Sebagai contoh:

   [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
   123a4567-b89c-12d3-e456-789012345678

4. Di bagian Pemeriksaan Aplikasi di Firebase console, pilih Kelola token debug dari menu luapan aplikasi Anda. Kemudian, daftarkan token debug yang Anda login di langkah sebelumnya.

   

Setelah Anda mendaftarkan token, layanan backend Firebase akan menerimanya sebagai token yang valid.

Karena token ini memungkinkan akses ke sumber daya Firebase Anda tanpa perangkat yang valid, Anda harus merahasiakannya. Jangan komit ke repositori publik, dan jika token terdaftar pernah disusupi, segera cabut di Firebase console.

Gunakan penyedia debug di lingkungan CI

Untuk menggunakan penyedia debug di lingkungan continuous integration (CI), lakukan hal berikut:

1. Di bagian Pemeriksaan Aplikasi di Firebase console, pilih Kelola token debug dari menu luapan aplikasi Anda. Kemudian, buat token debug baru. Anda akan membutuhkan token di langkah berikutnya.

   Karena token ini memungkinkan akses ke sumber daya Firebase Anda tanpa perangkat yang valid, Anda harus merahasiakannya. Jangan komit ke repositori publik, dan jika token terdaftar pernah disusupi, segera cabut di Firebase console.

   

2. Tambahkan token debug yang baru saja Anda buat ke penyimpanan kunci aman sistem CI Anda (misalnya, rahasia terenkripsi GitHub Actions atau variabel terenkripsi Travis CI).

3. Jika perlu, konfigurasikan sistem CI Anda untuk membuat token debug Anda tersedia dalam lingkungan CI sebagai variabel lingkungan. Beri nama variabel seperti APP_CHECK_DEBUG_TOKEN_FROM_CI .

4. Di Xcode, tambahkan variabel lingkungan ke skema pengujian Anda dengan nama FIRAAppCheckDebugToken dan sesuatu seperti $(APP_CHECK_DEBUG_TOKEN) sebagai nilainya.

5. Konfigurasikan skrip pengujian CI Anda untuk meneruskan token debug sebagai variabel lingkungan. Sebagai contoh:

   xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
   APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)

6. Di build debug Anda, sebelum menggunakan layanan backend Firebase, buat dan setel pabrik penyedia debug App Check:

   Cepat

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

Saat aplikasi Anda berjalan di lingkungan CI, layanan backend Firebase akan menerima token yang dikirim sebagai valid.