Memigrasikan login dengan link email dari Firebase Dynamic Links (iOS)

Autentikasi link email sebelumnya mengandalkan Firebase Dynamic Links, yang akan dinonaktifkan pada 25 Agustus 2025. Kami telah memublikasikan solusi alternatif di Firebase Authentication iOS SDK versi 11.8.0+. Jika aplikasi Anda menggunakan Firebase Dynamic Links, Anda harus memigrasikan aplikasi ke sistem berbasis Firebase Hosting yang baru.

Memigrasikan domain Firebase Dynamic Links terkait ke domain Firebase Hosting

Ke depannya, Firebase Authentication akan menggunakan domain default Firebase Hosting untuk project Anda, bukan menggunakan domain Firebase Dynamic Links, untuk membuat link untuk link email dan tindakan link out-of-band lainnya di aplikasi seluler. Artinya, aplikasi Anda juga perlu diupdate untuk menggunakan domain default ini sebagai domain terkait untuk link autentikasi email ke aplikasi seluler Anda.

Anda dapat mengikuti petunjuk di artikel Melakukan Autentikasi dengan Firebase Menggunakan Link Email di Platform Apple untuk mengupdate aplikasi agar menggunakan domain default Firebase Hosting baru yang disediakan secara otomatis.

Gunakan petunjuk berikut untuk menangani link dari domain baru dan untuk memberi tahu Firebase Authentication agar mulai menggunakan domain Firebase Hosting untuk membuat link aplikasi seluler ke depannya.

Jika Anda ingin terus menggunakan domain Firebase Hosting kustom atau bahkan domain Firebase Dynamic Links kustom sebagai domain terkait baru, sesuaikan langkah-langkahnya agar cocok dengan domain yang ingin Anda gunakan dengan mengikuti petunjuk di bagian Menyesuaikan Link Seluler.

  1. Tautkan domain Firebase Hosting ke domain terkait aplikasi Anda.

    Anda harus mengonfigurasi domain yang dipilih sebagai Domain Terkait (Associated Domain) untuk link aplikasi. Untuk menyiapkan hak di aplikasi Anda, buka tab Signing & Capabilities target di Xcode dan tambahkan domain Firebase Hosting dari langkah sebelumnya ke kemampuan Domain Terkait (Associated Domain). Jika menggunakan domain Firebase Hosting default, domain ini akan menjadi applinks:PROJECT_ID.firebaseapp.com.

    Lihat Mendukung domain terkait di situs dokumentasi Apple untuk mengetahui informasi selengkapnya.

    File domain terkait telah di-deploy di semua domain Firebase Hosting Anda. Untuk mengaksesnya, buka PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. File AASA ini dapat ditimpa; lihat Membuat dan menghosting file konfigurasi Universal Links untuk mengetahui informasi selengkapnya.

  2. Konfigurasi project Anda untuk menggunakan link baru.

    Jika sudah siap menangani link domain baru, Anda dapat menggunakan Firebase Admin SDK untuk memperbarui cara dalam pembuatan link email dan menginstruksikan backend kami untuk mulai membuat link menggunakan domain Firebase Hosting baru.

    const updateRequest = {
mobileLinksConfig: {
    domain: 'HOSTING_DOMAIN'
}
}
const updateProjectConfig = () => {
projectConfigManager.updateProjectConfig(updateRequest)
.then((response) => {
    // updated project config
}).catch((error) => {
    console.log('Error updating the project:', error);
});
}

  3. Kirim dan tukarkan link email.

    Kirim link login email seperti sebelumnya. Saat pengguna akhir mengklik link, mereka akan dialihkan ke aplikasi jika sudah diinstal untuk menyelesaikan login.

Anda dapat menggunakan domain Firebase Hosting kustom atau menggunakan kembali domain Firebase Dynamic Links kustom sebagai domain link seluler baru.

Menggunakan domain Firebase Hosting kustom

  1. Ikuti panduan Firebase Hosting untuk menyiapkan domain kustom.
  2. Tautkan domain kustom ke domain terkait aplikasi Anda.
  3. Kirim link autentikasi ke alamat email pengguna dengan objek ActionCodeSettings yang diperbarui dengan domain kustom sebagai linkDomain.
  1. Anda dapat menggunakan kembali domain Firebase Dynamic Links sebagai domain kustom. Namun, semua fungsi Firebase Dynamic Links tidak akan lagi didukung (misalnya, pengguna tidak dapat dialihkan ke app store jika aplikasi tidak diinstal di perangkat mereka).
  2. Kirim link autentikasi ke alamat email pengguna dengan objek ActionCodeSettings yang diperbarui dengan domain kustom sebagai linkDomain.