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 waktu non-aktif untuk aplikasi Anda.

Jika waktu non-aktif tidak menjadi masalah, seperti saat Anda menghubungkan domain baru ke aplikasi web, ikuti petunjuk untuk menghubungkan domain baru.

Sebelum memulai: Jenis data DNS

Wizard App Hosting Set up domain 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 App Hosting mungkin diminta:

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	Data ini berisi nilai IPv6 (misalnya, 2001:4860:4860::8888), jenis data alamat yang berbeda dengan fungsi yang hampir sama dengan 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, bukan 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: Onboarding yang mudah: Jika memungkinkan, App Hosting akan meminta Anda untuk 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 Certificate Manager membuat dan memperbarui sertifikat untuk Anda. Setelah onboarding, data ini tidak boleh dihapus atau cakupan sertifikat Anda akan berakhir masa berlakunya.	Ya
TXT	Data ini memungkinkan Anda 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 diizinkan untuk membuat sertifikat SSL untuk domain Anda. App Hosting hanya meminta data CAA jika diblokir untuk membuat sertifikat untuk domain Anda.	Tidak

Sebelum memulai: nama domain kustom Anda

Saat data DNS ditambahkan atau diedit, 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 di kolom Name.

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, dan 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 waktu non-aktif, Anda dapat menggunakan alur Migrate a 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 App Hosting server.

Langkah 1: Tambahkan domain kustom

1. Di Firebase console, buka Hosting & Serverless > App Hosting.
2. Pilih backend App Hosting menggunakan opsi View Dashboard.
3. Pilih tab Settings, lalu klik Add custom domain.
4. Masukkan nama domain kustom yang ingin Anda hubungkan ke situs App Hosting Anda.
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 mengarah ke konten yang sama).
6. Klik Continue to setup untuk mengonfigurasi data DNS dan menyelesaikan penyiapan domain kustom Anda.

Langkah 2: Siapkan domain

1. Pilih tab Migrate a domain dari wizard Set up domain.
2. Ikuti petunjuk di langkah pertama, Prepare 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 nyatakan adalah domain tempat Anda ingin menayangkan konten, yang mungkin merupakan domain apex atau subdomain. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain"
   • Record type: Tambahkan data DNS yang disediakan.
   • Nilai: 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 Verify records. App Hosting akan mencoba mendeteksi perubahan yang telah Anda buat di penyedia domain Anda. Perubahan dapat memerlukan waktu hingga 24 jam untuk diterapkan. Anda dapat memeriksa status di tampilan Settings > Domains di dasbor backend.

Langkah 3: Arahkan ke App Hosting

1. Setelah App Hosting memverifikasi pembaruan data dari langkah sebelumnya, wizard akan melanjutkan ke langkah terakhir Direct to App Hosting step. Langkah ini menampilkan pembaruan data yang harus Anda lakukan untuk mengarahkan traffic domain Anda ke App Hosting server. 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 nyatakan adalah domain tempat Anda ingin menayangkan konten, yang mungkin merupakan domain apex atau subdomain. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain"
   • Record type: Tambahkan data DNS yang disediakan.
   • Nilai: 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 Verify records. App Hosting akan mencoba mendeteksi perubahan yang telah Anda buat di penyedia domain Anda. Perubahan dapat memerlukan waktu hingga 24 jam untuk diterapkan. Anda dapat memeriksa status di tampilan Settings > Domains di dasbor backend.

Menghubungkan Domain baru

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

Langkah 1: Tambahkan domain kustom

1. Di Firebase console, buka Hosting & Serverless > App Hosting.
2. Pilih backend App Hosting menggunakan opsi View Dashboard.
3. Pilih tab Settings, lalu klik Add custom domain.
4. Masukkan nama domain kustom yang ingin Anda hubungkan ke situs App Hosting Anda.
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 mengarah ke konten yang sama).
6. Klik Continue to setup untuk mengonfigurasi data DNS dan menyelesaikan penyiapan domain kustom Anda.

Langkah 2: Verifikasi data DNS

1. Wizard Set up domain 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 nyatakan adalah domain tempat Anda ingin menayangkan konten, yang mungkin merupakan domain apex atau subdomain. Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain"
   • Record type: Tambahkan data DNS yang disediakan.
   • Nilai: 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 Verify records. App Hosting akan mencoba mendeteksi perubahan yang telah Anda buat di penyedia domain Anda. Perubahan dapat memerlukan waktu hingga 24 jam untuk diterapkan. Anda dapat memeriksa status di tampilan Settings > Domains 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, proses ini mungkin memerlukan 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 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.