Menghubungkan domain kustom

Anda tidak perlu melepaskan nama domain unik dan berfokus pada merek 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 Anda.

Menyiapkan domain Anda untuk App Hosting

Pastikan Anda telah menyelesaikan tugas penyiapan App Hosting dasar sehingga Anda memiliki situs Firebase App Hosting di project Firebase.

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 untuk mengonfigurasi data DNS dan menyelesaikan penyiapan domain kustom Anda.

Langkah 2: Siapkan domain kustom

  1. Wizard Tambahkan Domain Kustom 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:

    • Jenis: Tambahkan data DNS yang disediakan.

    • Host: Masukkan kunci 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".

    • 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, dengan data A dan AAAA memiliki alamat IP sebagai nilai, sedangkan data TXT adalah string.

Tunggu proses penyediaan sertifikat SSL Anda selesai. Proses ini biasanya memerlukan waktu beberapa jam, tetapi terkadang dapat memerlukan waktu hingga 24 jam setelah Anda mengarahkan DNS ke Firebase App Hosting. Pada umumnya, penerapan data Anda dan penyediaan sertifikat SSL akan terjadi dalam waktu satu jam, bergantung pada penyedia domain Anda.

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 yang tidak valid atau mengalami masalah saat terhubung ke domain Anda. Hal ini adalah bagian proses yang normal dan akan teratasi setelah sertifikat domain Anda tersedia.

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

Jenis data DNS

Wizard App Hosting Custom Domain dapat meminta Anda untuk menambahkan 1 hingga 5 data DNS, bergantung pada konfigurasi domain Anda saat ini. Jenis data menentukan fungsinya. Berikut adalah jenis data yang mungkin diperlukan 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 (mis. 2001:4860:4860::8888), jenis catatan alamat yang berbeda dengan fungsi yang kurang lebih sama dengan catatan 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 diawali dengan _custom-domain....
  • Verifikasi sertifikat SSL: App Hosting menggunakan Cloud Ceritificate 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 orientasi, 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

Kunci domain kustom Anda

Saat menambahkan atau mengedit data DNS, penyedia domain yang berbeda mengharapkan Anda memasukkan input yang berbeda untuk kolom Host dalam situs pengelolaan DNS mereka. Kami telah mengumpulkan input umum dari penyedia populer di bawah ini. Lihat dokumentasi penyedia domain Anda untuk mendapatkan petunjuk terperinci.

Jenis domain Kunci 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.

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.

  • Pada 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 menghambat 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.