Menghubungkan domain kustom

Anda tidak perlu menyerahkan 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, alih-alih domain yang dihasilkan Firebase. Firebase App Hosting akan menyediakan sertifikat SSL untuk setiap domain Anda.

Bagian selanjutnya dari dokumen ini akan menuntun Anda menyelesaikan langkah-langkah untuk menghubungkan domain kustom.

Menyiapkan domain 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 Settings, lalu klik Add custom domain.
  4. Masukkan nama domain kustom yang ingin dihubungkan 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 dialihkan ke konten yang sama).
  6. Klik Continue untuk mengonfigurasi data DNS dan menyelesaikan penyiapan domain kustom.

Langkah 2: Siapkan domain kustom

  1. Wizard Add Custom Domain di Firebase console akan menampilkan data yang diperlukan dan 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 tunjukkan adalah domain tempat Anda ingin menayangkan konten; domain ini dapat berupa domain atau subdomain apex. 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 yang memiliki alamat IP sebagai nilai, sedangkan data TXT adalah string.

Tunggu proses penyediaan sertifikat SSL Anda selesai. Proses ini mungkin memerlukan waktu beberapa jam setelah Anda mengarahkan DNS ke Firebase App Hosting. Pada kebanyakan kasus, penerapan data dan penyediaan sertifikat SSL Anda akan berlangsung dalam waktu satu jam, bergantung pada penyedia domain Anda.

Menunggu penyediaan sertifikat SSL

Hosting Aplikasi memerlukan waktu hingga beberapa jam untuk menyediakan sertifikat SSL untuk domain Anda setelah Anda memperbarui data DNS.

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

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, dan mengecualikan .example.com)
  • Hanya www untuk subdomain www.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 umumnya, 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 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 untuk membuat sertifikat SSL untuk domain Anda.
Membuat Sertifikat

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.