Menghubungkan domain kustom

Anda tidak perlu mengorbankan nama domain unik yang berkaitan erat dengan merek Anda untuk aplikasi yang di-deploy di Firebase App Hosting. Anda dapat menggunakan domain kustom (seperti example.com atau app.example.com) untuk situs yang dihosting Firebase, tidak harus domain yang dihasilkan oleh Firebase. Firebase App Hosting menyediakan sertifikat SSL untuk setiap domain Anda.

Bagian selanjutnya dari dokumen ini akan memandu Anda menyelesaikan langkah-langkah untuk menghubungkan domain kustom dengan salah satu cara berikut:

• Memigrasikan domain
• Menghubungkan domain baru

Agar layanan tidak terganggu, data DNS Anda harus diupdate dalam urutan tertentu. Ikuti petunjuk untuk memigrasikan domain guna mencegah waktu nonaktif untuk aplikasi Anda.

Jika waktu nonaktif tidak menjadi masalah, seperti saat Anda menghubungkan domain yang baru ke aplikasi web, ikuti petunjuk untuk menghubungkan domain baru.

Sebelum memulai: Jenis data DNS

Wizard Siapkan domain dapat meminta Anda menambahkan atau menghapus 1 hingga 5 data DNS, bergantung pada konfigurasi domain Anda saat ini.App Hosting Jenis data menentukan fungsinya. Berikut jenis catatan yang mungkin diminta App Hosting:

Jenis	Deskripsi	Eksklusif
A	Data ini berisi nilai IPv4 (misalnya, 8.8.8.8), yang memberi tahu browser alamat yang akan digunakan saat mencoba menghubungi domain Anda.	Ya
AAAA	Catatan ini berisi nilai IPv6 (misalnya, 2001:4860:4860::8888), jenis catatan alamat yang berbeda dengan fungsi yang hampir sama dengan catatan A. App Hosting saat ini tidak menggunakan data AAAA, tetapi akan meminta Anda menghapus data AAAA yang ada dari domain kami, jika ada.	Ya
CNAME	Data ini berisi nama domain terpisah yang harus digunakan, bukan domain Anda saat ini, untuk menyelesaikan kueri DNS. Data CNAME hanya diizinkan di subdomain (misalnya, www.example.com). App Hosting menggunakan data CNAME karena dua alasan: Proses aktivasi yang mudah: Jika memungkinkan, App Hosting meminta Anda untuk membuat CNAME ke domain yang telah dikonfigurasi sebelumnya yang dimulai dengan _custom-domain.... Verifikasi sertifikat SSL: App Hosting menggunakan Cloud Certificate Manager untuk menyediakan sertifikat SSL bagi Domain Kustom Anda. Data CNAME di subdomain _acme-challenge... memungkinkan Certificate Manager membuat dan memperpanjang sertifikat untuk Anda. Setelah aktivasi, catatan ini tidak boleh dihapus atau cakupan sertifikat Anda akan berakhir.	Ya
TXT	Dengan data ini, Anda dapat melampirkan metadata arbitrer ke domain Anda. App Hosting memungkinkan Anda menggunakan format data TXT tertentu, fah-claim=[UUID], untuk menunjukkan Domain Kustom mana yang harus ditayangkan di domain Anda.	Tidak
CAA	Data ini berfungsi sebagai daftar yang diizinkan untuk menentukan Certificate Authority yang berwenang membuat sertifikat SSL untuk domain Anda. App Hosting hanya meminta data CAA jika tidak dapat membuat sertifikat untuk domain Anda.	Tidak

Sebelum memulai: nama domain kustom Anda

Saat menambahkan atau mengedit data DNS, input yang Anda masukkan pada kolom Host (atau nama host) di situs pengelolaan DNS dapat berbeda-beda di setiap penyedia domain. Wizard domain kustom App Hosting mengharuskan Anda memasukkan nilai yang sama ini di kolom Nama.

Kami telah mengumpulkan input umum dari penyedia populer di bawah ini. Lihat dokumentasi penyedia domain Anda untuk mendapatkan petunjuk terperinci.

Jenis domain	Nama domain kustom
Domain apex	Input umum meliputi: @ Nama domain apex (misalnya, example.com) Membiarkan kolom Host kosong.
Subdomain	Input umum meliputi: Nama subdomain lengkap (misalnya, app.example.com) Hanya bagian subdomain (misalnya, app saja, tanpa menyertakan .example.com)

Penyedia domain umum

Berikut adalah beberapa penyedia domain umum dan jenis input yang mungkin diperlukan setiap penyedia domain. Informasi ini sebisa mungkin selalu diperbarui, tetapi lihat dokumentasi penyedia domain Anda untuk petunjuk terperinci.

Cloudflare

Host	Input
example.com.	@
www.example.com.	www

Google Cloud DNS

Host	Input
example.com.	.example.com.
www.example.com.	www.example.com.

NameCheap

Host	Input
example.com.	@
www.example.com.	www

Squarespace

Host	Input
example.com.	@
www.example.com.	www

Memigrasikan domain

Jika ingin mentransfer domain dari penyedia lain ke App Hosting tanpa periode nonaktif, Anda dapat menggunakan alur Migrasikan domain di Firebase Console. Alur tersebut memandu Anda melalui proses dua langkah yang menyiapkan App Hosting untuk menayangkan konten di domain Anda sebelum mengarahkan traffic ke server App Hosting.

Langkah 1: Tambahkan domain kustom

1. Buka halaman App Hosting project Anda.
2. Pilih backend App Hosting menggunakan opsi Lihat Dasbor.
3. Pilih tab Setelan, lalu klik Tambahkan domain kustom.
4. Masukkan nama domain kustom yang ingin Anda hubungkan ke situs App Hosting.
5. (Opsional) Centang kotak untuk mengalihkan semua permintaan di domain kustom ke domain kedua yang ditentukan (sedemikian rupa sehingga example.com dan www.example.com mengalihkan ke konten yang sama).
6. Klik Lanjutkan penyiapan untuk mengonfigurasi data DNS dan menyelesaikan penyiapan domain kustom Anda.

Langkah 2: Siapkan domain

1. Pilih tab Migrasikan domain di panduan Siapkan domain.
2. Ikuti petunjuk di langkah pertama, Siapkan domain, yang mencakup serangkaian perubahan yang diperlukan agar App Hosting dapat menayangkan backend pilihan Anda dan membuat koneksi TLS yang aman untuk domain Anda. Tambahkan, hapus, dan simpan data dari domain Anda di penyedia DNS dengan input berikut untuk data yang diperlukan:
   • Nama: Masukkan nama domain kustom Anda untuk data. Host yang Anda tunjuk adalah domain tempat Anda ingin menayangkan konten; domain ini dapat berupa domain apex atau subdomain. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain".
   • Jenis data: Tambahkan data DNS yang disediakan.
   • Value: Tetapkan nilai yang diberikan ke data Anda. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Data", "Points To", "Content", "Address", atau "IP Address". Konten kolom nilai bervariasi menurut jenis data; misalnya, data TXT adalah string.
3. Pilih Verifikasi data. App Hosting akan mencoba mendeteksi perubahan yang telah Anda lakukan di penyedia domain Anda. Diperlukan waktu hingga 24 jam agar perubahan diterapkan. Anda dapat memeriksa status di tampilan Setelan > Domain di dasbor backend.

Langkah 3: Langsung ke App Hosting

1. Setelah App Hosting memverifikasi pembaruan data dari langkah sebelumnya, wizard akan melanjutkan ke langkah Arahkan ke App Hosting terakhir. Langkah ini menampilkan pembaruan data yang harus Anda lakukan untuk mengarahkan traffic domain Anda ke server App Hosting. Seperti sebelumnya, tambahkan, hapus, dan simpan data dari domain Anda di penyedia DNS dengan input berikut untuk data yang diperlukan:
   • Nama: Masukkan nama domain kustom Anda untuk data. Host yang Anda tunjuk adalah domain tempat Anda ingin menayangkan konten; domain ini dapat berupa domain apex atau subdomain. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain".
   • Jenis data: Tambahkan data DNS yang disediakan.
   • Value: Tetapkan nilai yang diberikan ke data Anda. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Data", "Points To", "Content", "Address", atau "IP Address". Konten kolom nilai bervariasi menurut jenis data; misalnya, data TXT adalah string.
2. Pilih Verifikasi data. App Hosting akan mencoba mendeteksi perubahan yang telah Anda lakukan di penyedia domain Anda. Diperlukan waktu hingga 24 jam agar perubahan diterapkan. Anda dapat memeriksa status di tampilan Setelan > Domain di dasbor backend.

Menghubungkan Domain baru

Jika waktu nonaktif tidak menjadi masalah, seperti saat Anda menghubungkan domain baru ke aplikasi web, ikuti petunjuk di bagian ini.

Langkah 1: Tambahkan domain kustom

1. Buka halaman App Hosting project Anda.
2. Pilih backend App Hosting menggunakan opsi Lihat Dasbor.
3. Pilih tab Setelan, lalu klik Tambahkan domain kustom.
4. Masukkan nama domain kustom yang ingin Anda hubungkan ke situs App Hosting.
5. (Opsional) Centang kotak untuk mengalihkan semua permintaan di domain kustom ke domain kedua yang ditentukan (sedemikian rupa sehingga example.com dan www.example.com mengalihkan ke konten yang sama).
6. Klik Lanjutkan penyiapan untuk mengonfigurasi data DNS dan menyelesaikan penyiapan domain kustom Anda.

Langkah 2: Verifikasi data DNS

1. Wizard Siapkan domain di Firebase console akan menampilkan data yang diperlukan yang perlu diperbarui untuk mengarahkan halaman Anda ke Firebase App Hosting. Tambahkan, hapus, dan simpan data dari domain Anda di penyedia DNS dengan input berikut:
   • Nama: Masukkan nama domain kustom Anda untuk data. Host yang Anda tunjuk adalah domain tempat Anda ingin menayangkan konten; domain ini dapat berupa domain apex atau subdomain. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain".
   • Jenis data: Tambahkan data DNS yang disediakan.
   • Value: Tetapkan nilai yang diberikan ke data Anda. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Data", "Points To", "Content", "Address", atau "IP Address". Konten kolom nilai bervariasi menurut jenis data; misalnya, data TXT adalah string.
2. Pilih Verifikasi data. App Hosting akan mencoba mendeteksi perubahan yang telah Anda lakukan di penyedia domain Anda. Diperlukan waktu hingga 24 jam agar perubahan diterapkan. Anda dapat memeriksa status di tampilan Setelan > Domain di dasbor backend.

Menunggu penyediaan sertifikat SSL

App Hosting memerlukan waktu hingga beberapa jam untuk menyediakan sertifikat SSL bagi domain Anda setelah Anda memperbarui data DNS. Dalam beberapa kasus, diperlukan waktu hingga 24 jam setelah Anda mengarahkan DNS ke Firebase App Hosting.

Anda dapat melihat sertifikat ini menggunakan alat keamanan browser. Saat domain disediakan, Anda mungkin melihat sertifikat tidak valid atau mengalami masalah saat menghubungkan ke domain Anda. Ini adalah bagian proses yang normal dan akan teratasi setelah sertifikat domain Anda tersedia.

Catatan: Firebase App Hosting otomatis menyediakan kembali sertifikat SSL untuk domain kustom, sesuai keperluan.

Deskripsi status untuk domain kustom

Status	Deskripsi
Perlu penyiapan	Anda mungkin perlu mengubah konfigurasi dengan data DNS Anda. Pada kebanyakan kasus, data A DNS Anda belum diterapkan dari penyedia nama domain ke server Firebase App Hosting. Tips pemecahan masalah: Jika sudah lebih dari 24 jam, pastikan bahwa Anda telah mengarahkan data ke Firebase App Hosting. Dalam kasus yang lebih jarang terjadi, tantangan SSL mungkin gagal karena data DNS Anda memiliki data A atau data CNAME yang mengarah ke penyedia hosting lain. Tips pemecahan masalah: Pastikan data A Anda hanya mengarah ke Firebase App Hosting, dan hapus semua data CNAME.
Tertunda	Anda menyiapkan domain kustom dengan benar, tetapi Firebase App Hosting belum menyediakan sertifikat SSL. Terkadang, data CAA yang terlalu ketat dapat menghentikan pembuatan sertifikat SSL untuk domain kustom. Pastikan certificate authority `letsencrypt.org` dan `pki.goog` diizinkan untuk membuat sertifikat SSL untuk domain Anda.
Minting Certificate	Sertifikat SSL sedang dibuat untuk domain Anda.
Terhubung	Domain kustom Anda memiliki data DNS yang sesuai dan memiliki sertifikat SSL. Anda dapat menayangkan konten situs.