Menghubungkan domain kustom

Dengan Firebase Hosting, Anda tidak perlu mengorbankan nama domain unik yang berkaitan erat dengan merek Anda. 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 Hosting menyediakan sertifikat SSL untuk setiap domain Anda dan menayangkan konten Anda melalui CDN global.

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

Menyiapkan domain Anda untuk Hosting

Pastikan Anda telah menyelesaikan wizard "Memulai" dari halaman Firebase Hosting project sehingga Anda memiliki situs Firebase Hosting di project Firebase.

Langkah 1: Tambahkan domain kustom

  1. Dari halaman Hosting project Anda, buka wizard untuk menghubungkan domain kustom:

    • Jika Anda hanya memiliki satu situs Hosting, klik Add custom domain.
    • Jika Anda memiliki lebih dari satu situs Hosting, klik View untuk situs yang diinginkan, lalu klik Add custom domain.

  2. Masukkan nama domain kustom yang ingin Anda hubungkan ke situs Hosting.

  3. (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).

  4. Klik Lanjutkan untuk mengonfigurasi data DNS dan menyelesaikan penyiapan domain kustom Anda.

Langkah 2: Siapkan domain kustom

Jika diminta dalam wizard penyiapan Hubungkan Domain, verifikasi domain apex Anda.

Langkah-langkah ini memastikan bahwa domain Anda belum ditautkan dengan project Firebase dan bahwa Anda memiliki domain yang ditentukan.

  1. Di situs penyedia domain Anda, cari halaman pengelolaan DNS.

  2. Tambahkan dan simpan data baru yang menyertakan input berikut:

    • Type: Tambahkan data TXT.

      Firebase Hosting mengharuskan Anda menyimpan data TXT ini secara terus-menerus di setelan DNS untuk membuktikan kepemilikan domain tersebut dan untuk mengizinkan Firebase menetapkan dan memperbarui sertifikat SSL untuk situs Anda.

      Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Record Type".

    • Host: Masukkan kunci domain apex Anda.

      Dengan membuktikan kepemilikan domain apex atau domain root, Anda membuktikan kepemilikan atas semua subdomainnya.

      Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain".

    • Value: Salin nilai verifikasi unik ke dalam kolom.

      Firebase Hosting memeriksa keberadaan nilai ini untuk membuktikan kepemilikan domain Anda.

      Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Data".

  3. Tunggu penerapan data TXT terbaru Anda hingga 24 jam, lalu klik Verifikasi.

    Perhatikan bahwa Anda dapat mengklik Batal untuk menutup jendela Hubungkan Domain dengan aman dan membukanya kembali di lain waktu. Hal ini tidak memengaruhi waktu penerapan, tetapi Anda akan diminta untuk memasukkan kembali nama domain saat membuka jendela ini lagi.

    Setelah cukup waktu penerapan, Anda dapat memulai proses penyediaan sertifikat SSL dengan mengklik Verify di jendela Connect Domain di Firebase Console.

    Dalam kebanyakan kasus, penerapan data dan verifikasi domain Anda akan berlangsung selama beberapa jam, tergantung penyedia domain Anda. Lihat dokumentasi penyedia domain Anda untuk mendapatkan petunjuk terperinci mengenai cara menambahkan data TXT dan waktu penerapan.

    Jika pesan error muncul setelah Verifikasi diklik, artinya data Anda belum diterapkan atau nilai Anda mungkin salah.

Di wizard Add Custom Domain di Firebase console, pilih Quick Setup atau Advanced Setup.

Quick Setup dapat digunakan untuk domain baru yang saat ini tidak menerima traffic atau domain yang Anda coba transfer dari situs Hosting lain. Advanced Setup dapat digunakan jika Anda sudah memiliki domain yang menerima permintaan di penyedia hosting lain dan perlu migrasi tanpa periode nonaktif.

Wizard Advanced Setup akan membantu Anda membuat sertifikat SSL dan klaim kepemilikan agar Hosting dapat menyalurkan traffic di domain sebelum menerima traffic.

Menunggu penyediaan sertifikat SSL

Setelah memverifikasi kepemilikan domain, kami menyediakan sertifikat SSL untuk domain Anda dan men-deploy di seluruh CDN global kami dalam waktu 24 jam setelah Anda mengarahkan data A DNS ke Firebase Hosting.

Domain Anda akan terdaftar sebagai Nama Alternatif Subjek (SAN) dalam sertifikat SSL FirebaseApp. Anda dapat melihat sertifikat ini menggunakan alat keamanan browser. Saat domain disediakan, Anda mungkin melihat sertifikat tidak valid yang tidak menyertakan nama domain Anda. Ini adalah bagian proses yang normal dan akan teratasi setelah sertifikat domain Anda tersedia.

Situs milik pengguna dengan Advanced Setup akan dihosting oleh penyedia hosting sebelumnya hingga status penyiapan di halaman Firebase Hosting project berubah menjadi Connected.

Kunci domain kustom Anda

Saat data DNS ditambahkan atau diedit, input yang Anda masukkan pada kolom Host di situs pengelolaan DNS dapat berbeda-beda di setiap penyedia domain. 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)
  • 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 penyiapan 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 Hosting.
    Tips pemecahan masalah: Jika sudah lebih dari 24 jam, pastikan bahwa Anda telah mengarahkan data ke Firebase Hosting.

  • Pada kasus yang lebih jarang terjadi, terutama jika Anda menggunakan alur Penyiapan Lanjutan, tantangan SSL mungkin akan gagal karena:

    • Tantangan sertifikat SSL gagal, dan token (data TXT DNS atau file yang diupload dan diberikan ke situs Anda) sudah tidak valid.
      Tips pemecahan masalah: Klik View untuk domain tersebut, lalu berikan token baru ke domain Anda yang ada.
Tertunda

Anda menyiapkan domain kustom dengan benar, tetapi Firebase Hosting belum menyediakan sertifikat SSL.

Terkadang, masalah berikut dapat menghentikan pembuatan sertifikat SSL untuk suatu domain kustom:

  • Pembatasan data CAA Anda terlalu ketat.
    Tips pemecahan masalah: Pastikan certificate authority `letsencrypt.org` dan `pki.goog` diizinkan membuat sertifikat SSL untuk domain Anda.
  • Kode tantangan tidak valid.
    Jika Anda menggunakan alur Penyiapan Lanjutan dan migrasi gagal, token Anda (serta kode tantangannya) akan menjadi tidak valid.
    Tips pemecahan masalah: Klik Lihat untuk domain tersebut, lalu berikan token baru ke domain Anda yang ada.
  • Anda meminta sertifikat untuk terlalu banyak subdomain.
    Tips pemecahan masalah: Secara umum, Firebase Hosting merekomendasikan tidak lebih dari 20 subdomain di satu domain kustom apex, karena adanya batas pembuatan sertifikat SSL.
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.