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

Untuk memastikan layanan tidak terganggu, data DNS Anda harus diperbarui dalam urutan tertentu. Ikuti petunjuk untuk memigrasikan domain guna mencegah downtime untuk aplikasi Anda.

Jika downtime 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 App Hosting dapat meminta Anda untuk menambahkan atau menghapus 1 hingga 5 data DNS, bergantung pada konfigurasi domain Anda saat ini. Jenis data menentukan fungsinya. Berikut adalah jenis data yang mungkin diminta oleh 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	Kumpulan data ini berisi nilai IPv6 (misalnya, 2001:4860:4860::8888), jenis kumpulan data alamat yang berbeda dengan fungsi yang kurang lebih sama seperti kumpulan data A. App Hosting saat ini tidak menggunakan data AAAA, tetapi akan meminta Anda untuk menghapus data yang ada dari domain kami, jika ada.	Ya
CNAME	Data ini berisi nama domain terpisah yang harus digunakan sebagai pengganti domain Anda saat ini untuk me-resolve kueri DNS. Data CNAME hanya diizinkan di subdomain (misalnya, www.example.com). App Hosting menggunakan data CNAME karena dua alasan: Orientasi yang mudah: Jika memungkinkan, App Hosting akan 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 untuk Domain Kustom Anda. Data CNAME di subdomain _acme-challenge... memungkinkan Pengelola Sertifikat membuat dan memperpanjang sertifikat untuk Anda. Setelah aktivasi, data ini tidak boleh dihapus atau cakupan sertifikat Anda akan berakhir.	Ya
TXT	Data ini memungkinkan Anda melampirkan metadata arbitrer ke domain. 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 diberi otorisasi untuk membuat sertifikat SSL untuk domain Anda. App Hosting hanya meminta data CAA jika diblokir agar tidak 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 downtime, Anda dapat menggunakan alur Migrasi 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 wizard Siapkan domain.
2. Ikuti petunjuk di langkah pertama, Menyiapkan domain, yang menyertakan serangkaian perubahan yang diperlukan agar App Hosting dapat menyalurkan 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, dengan data A dan AAAA memiliki alamat IP sebagai nilai, sedangkan data TXT adalah string.
3. Pilih Verifikasi data. App Hosting akan mencoba mendeteksi perubahan yang telah Anda buat di penyedia domain. 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 Langsung ke App Hosting terakhir. Langkah ini menampilkan pembaruan data yang harus Anda lakukan untuk mengarahkan traffic domain 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, dengan data A dan AAAA memiliki alamat IP sebagai nilai, sedangkan data TXT adalah string.
2. Pilih Verifikasi data. App Hosting akan mencoba mendeteksi perubahan yang telah Anda buat di penyedia domain. Diperlukan waktu hingga 24 jam agar perubahan diterapkan. Anda dapat memeriksa status di tampilan Setelan > Domain di dasbor backend.

Menghubungkan Domain baru

Jika periode 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, dengan data A dan AAAA memiliki alamat IP sebagai nilai, sedangkan data TXT adalah string.
2. Pilih Verifikasi data. App Hosting akan mencoba mendeteksi perubahan yang telah Anda buat di penyedia domain. 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 dapat memerlukan waktu hingga beberapa jam untuk menyediakan sertifikat SSL untuk domain Anda setelah Anda memperbarui data DNS. Dalam beberapa kasus, mungkin perlu 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 terhubung ke domain. Hal ini adalah bagian proses yang normal dan akan teratasi setelah sertifikat domain Anda tersedia.

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

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, 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 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.