Custom Domain

---

Secara default, workspace Anda diakses melalui subdomain AlurKerja. Dengan Custom Domain, Anda dapat menggunakan domain milik sendiri (misalnya perusahaan.co.id atau app.perusahaan.co.id) untuk mengakses workspace tersebut.

Proses registrasi terdiri dari empat tahap: mendaftarkan domain, menambahkan record CNAME di DNS provider, memverifikasi DNS, lalu menyiapkan sertifikat SSL.

Mendaftarkan Custom Domain

1. Buka Tab Custom Domain Dari Studio, buka menu Workspace Setting, lalu pilih tab Custom Domain.

2. Masukkan Domain Isi kolom Workspace Domain dengan domain yang Anda inginkan, lalu klik Save. Setelah tersimpan, status domain akan berubah menjadi Waiting for DNS.

   

Konfigurasi CNAME untuk Domain

1. Lihat Detail DNS Record Pada bagian DNS Record, AlurKerja menampilkan detail record CNAME yang perlu Anda tambahkan di DNS provider — meliputi Type, Name, Value, dan TTL. Gunakan tombol Copy agar nilainya sesuai persis.

   

2. Buka DNS Manager Masuk ke DNS manager domain Anda (contoh ini menggunakan Cloudflare), buka menu Records, lalu klik Add record.

   

3. Tambahkan Record CNAME Isi form sesuai data yang ditampilkan AlurKerja, lalu ubah Proxy status menjadi DNS only. Klik Save untuk menyimpan record.

   

Verifikasi Pengaturan DNS

Setelah record DNS ditambahkan, kembali ke halaman Custom Domain di AlurKerja, lalu klik tombol Verify Domain. Jika berhasil, status domain akan berubah menjadi Provisioning SSL.

Mengatur Sertifikat SSL

Setelah DNS terverifikasi, tentukan bagaimana domain Anda diamankan dengan TLS pada bagian SSL Certificate. Tersedia dua pilihan:

Automatic SSL

Pilih Automatic SSL jika Anda ingin AlurKerja menerbitkan dan memperpanjang sertifikat secara otomatis melalui Let's Encrypt. Tidak ada berkas yang perlu diunggah.

Sertifikat biasanya terbit beberapa saat setelah DNS terverifikasi dan halaman akan memperbarui statusnya sendiri. Jika ingin menerbitkan segera tanpa menunggu, klik tombol Generate SSL now.

Upload my certificate (Manual)

Pilih opsi ini jika Anda ingin memakai sertifikat milik sendiri.

1. Pilih Upload my certificate Kartu SSL Certificate akan menampilkan dua area unggahan.

2. Unggah Berkas Sertifikat Unggah kedua berkas berikut — bisa lewat drag-and-drop atau klik untuk memilih berkas:

   • Certificate — berkas sertifikat berformat .crt atau .pem
   • Private Key — berkas private key berformat .key

3. Klik Upload Certificate Tombol Upload Certificate aktif setelah kedua berkas terisi. Setelah berhasil, tanggal kedaluwarsa sertifikat (cert expires at) akan ditampilkan.

Mengakses Domain yang Sudah Dikonfigurasi

Setelah sertifikat aktif, status domain berubah menjadi Domain active dan workspace dapat diakses melalui domain Anda.

Jika domain belum bisa diakses, tunggu sekitar 5 menit agar proses DNS resolve selesai, lalu coba akses kembali.

Custom Domain pada Daftar Workspace

Sebuah custom domain terikat pada satu workspace tertentu. Perilakunya pada halaman My Workspaces adalah sebagai berikut:

• Ketika Anda membuka sebuah custom domain lalu login, Anda akan langsung diarahkan ke workspace yang terikat pada domain tersebut, tanpa perlu memilihnya lagi secara manual.
• Pada daftar workspace, workspace yang sudah memiliki custom domain ditampilkan lengkap dengan nama domain-nya. Dengan begitu, Anda dapat mengenali workspace mana yang terkait dengan domain yang sedang Anda akses.

Konfigurasi SSO Keycloak untuk Custom Domain

Agar login melalui custom domain berjalan, domain baru harus didaftarkan pada konfigurasi Keycloak. Tanpa langkah ini, akses ke domain baru akan gagal dengan error Invalid parameter: redirect_uri atau halaman gagal dimuat karena diblokir oleh kebijakan keamanan.

Menambahkan Valid Redirect URI dan Web Origin ke Client

Pada Keycloak Admin Console, buka menu Clients, lalu pilih client yang digunakan aplikasi Anda dan masuk ke tab Settings.

1. Tambahkan Valid Redirect URI Pada bagian Valid redirect URIs, klik Add lalu masukkan custom domain Anda diikuti pola /* (misalnya https://app.namadomain.com/*) agar seluruh path pada domain tersebut diizinkan sebagai tujuan redirect setelah login.

   

2. Tambahkan Web Origin Pada bagian Web origins, klik Add lalu masukkan custom domain Anda tanpa pola /* (misalnya https://app.namadomain.com) agar permintaan CORS dari domain tersebut diizinkan.

   

3. Simpan Klik Save di bagian bawah halaman agar perubahan diterapkan.

Menambahkan Custom Domain ke Content Security Policy

Selain di client, custom domain juga perlu ditambahkan pada Content-Security-Policy (CSP) agar aplikasi dapat ditampilkan (misalnya di dalam iframe) tanpa diblokir oleh browser.

1. Buka Realm Settings Pada sidebar Keycloak Admin Console, klik Realm settings.

   

2. Buka Tab Security Defenses Pilih tab Security defenses, lalu buka sub-tab Headers.

3. Tambahkan Domain pada Content-Security-Policy Pada kolom Content-Security-Policy, tambahkan custom domain Anda ke direktif frame-ancestors (dan direktif lain yang relevan sesuai kebutuhan). Anda dapat menuliskan domain spesifik (https://app.namadomain.com) maupun pola wildcard (https://*.namadomain.com). Klik Save untuk menyimpan.

   

FAQ

Status domain tidak berubah dari "Waiting for DNS" ke "Provisioning SSL", apa yang harus dilakukan?

Periksa kembali record CNAME pada DNS provider, pastikan Name dan Value sudah sesuai persis dengan yang ditampilkan AlurKerja serta Proxy status sudah DNS only. Tunggu beberapa menit agar DNS ter-propagasi, lalu klik Verify Domain kembali.

Muncul error "Invalid parameter: redirect_uri" saat mencoba login/akses domain baru, kenapa?

Error ini muncul karena redirect URI untuk domain baru belum terdaftar pada konfigurasi SSO Keycloak. Ikuti langkah pada bagian Konfigurasi SSO Keycloak untuk Custom Domain untuk menambahkan Valid redirect URI, Web origin, dan Content-Security-Policy domain tersebut. Jika Anda tidak memiliki akses ke Keycloak Admin Console, hubungi tim admin/infra dengan menyertakan custom domain yang telah didaftarkan.

Proxy status di Cloudflare tidak bisa diubah menjadi "DNS only", bagaimana solusinya?

Pastikan record yang ditambahkan bertipe CNAME, karena hanya record CNAME dan A yang mendukung fitur proxy. Pastikan juga akun Cloudflare Anda memiliki permission yang cukup untuk mengubah pengaturan record.

Domain sudah berstatus aktif tapi masih belum bisa diakses, apa penyebabnya?

Kemungkinan penyebabnya adalah cache DNS di perangkat atau browser Anda. Coba akses menggunakan mode incognito, ganti jaringan, atau flush DNS cache pada perangkat. Propagasi DNS secara umum selesai dalam beberapa menit, namun pada beberapa kasus bisa memakan waktu hingga 24 jam.

Apakah bisa menggunakan subdomain, bukan domain utama?

Bisa. Masukkan subdomain yang diinginkan (misalnya app.namadomain.com) pada kolom Workspace Domain, lalu tambahkan record CNAME dengan Name sesuai subdomain tersebut di DNS provider, mengikuti langkah yang sama seperti domain utama.

Upload sertifikat gagal, apa yang perlu diperiksa?

Pastikan sertifikat memenuhi syarat pada bagian Upload my certificate: format PEM valid, belum kedaluwarsa dan masih berlaku lebih dari 7 hari, cocok dengan domain yang didaftarkan, serta private key cocok dengan sertifikatnya. Pesan error yang muncul pada form menjelaskan syarat mana yang tidak terpenuhi.

Apa bedanya Automatic SSL dan Upload my certificate?

Pada Automatic SSL, AlurKerja menerbitkan sertifikat gratis via Let's Encrypt dan memperpanjangnya secara otomatis. Pada Upload my certificate, Anda memakai sertifikat sendiri (misalnya wildcard atau sertifikat dari CA berbayar) dan bertanggung jawab atas perpanjangannya. Gunakan opsi manual jika organisasi Anda mewajibkan sertifikat dari CA tertentu.