Lewati ke konten utamaSkip to content
TG
Taqiyya Ghazi
Kembali ke semua tulisanBack to all articles
3 menit baca

Berhenti Mengirim Token di URL: Cara Tepat Berbagi Sesi Login Lintas Subdomain

#web-development#web-security#javascript#authentication#software-engineering

Bagaimana saya belajar meninggalkan “estafet token di URL” dan memanfaatkan kekuatan HTTP Cookies.

Ketika pertama kali bekerja sebagai Junior Developer, saya mewarisi proyek legacy yang terdiri dari beberapa platform di bawah satu domain utama perusahaan. Kami punya landing page utama (example.com), dashboard (app.example.com), dan toko (shop.example.com).

Dari sudut pandang pengguna, semuanya adalah satu ekosistem. Mereka berharap setelah login di halaman utama, status login tetap aktif saat mengklik “Buka Dashboard”.

Namun secara teknis, semua itu adalah aplikasi terpisah. Menjaga pengguna tetap login di lintas subdomain pun terasa seperti mimpi buruk.

Solusi “Junior”: Estafet Token di URL

Saat itu, saya belum banyak memahami praktik terbaik autentikasi. Saya melihat kode legacy yang ada untuk mengetahui cara mereka menanganinya.

Logikanya tampak sederhana—tetapi rapuh:

  • Pengguna login di example.com. Kami menyimpan token JWT di LocalStorage.
  • Pengguna mengklik tautan menuju app.example.com.
  • Sebelum redirect, kami mengambil token dari LocalStorage lalu menempelkannya ke query parameter URL: window.location.href = 'https://app.example.com?token=' + userToken;.
  • Aplikasi tujuan membaca URL, mengambil token tersebut, lalu menyimpannya ke LocalStorage miliknya sendiri.

Sekilas, metode “Estafet URL” ini terasa masuk akal bagi saya yang masih junior. Cara itu berjalan… setidaknya sebagian besar waktu.

Masalahnya: “Kenapa Saya Ter-logout?”

Celahnya mulai terlihat saat saya diminta membangun fitur yang mengharuskan pengguna sering berpindah antar platform.

Suatu hari, masuk laporan bug: “Saya sudah login, tapi pas klik link ke toko, malah diminta login lagi.”

Saya menelusurinya dan menemukan penyebabnya: Human Error. Saya membuat tautan HTML biasa (<a href="...">) tetapi lupa memasang click handler khusus yang menempelkan token ke URL. Karena token tidak ikut terkirim, aplikasi kedua tidak tahu siapa penggunanya.

Selain rapuh, saya mulai menyadari masalah lainnya:

  • Mimpi Buruk Keamanan: Token autentikasi terpampang jelas di address bar browser. Jika pengguna membagikan tautan tersebut atau ada orang lain melihat riwayat browser-nya, sesi mereka bisa dibajak.
  • Kode Berantakan: Setiap tautan antar aplikasi membutuhkan logika tambahan.

Saya berpikir, “Pasti ada cara standarnya. Facebook dan Google tidak menaruh token di URL mereka.”

Saya meluangkan waktu untuk meriset “Cross-subdomain authentication”. Dari situlah saya mengenal Atribut Domain pada HTTP Cookies.

Secara default, cookie bersifat “host-only”. Jika Anda menyetel cookie di www.example.com, cookie itu hanya terlihat oleh subdomain tersebut. app.example.com tidak dapat melihatnya.

Namun, jika Anda secara eksplisit menyetel atribut domain ke domain induknya (dengan awalan titik atau root domain di browser modern), cookie tersebut menjadi tersedia untuk domain utama sekaligus seluruh subdomain-nya.

Perbaikannya sangat sederhana. Alih-alih LocalStorage, kami menyetel cookie sesi seperti ini:

// Kuncinya ada pada atribut 'domain'
document.cookie = "session_token=xyz123; path=/; domain=.example.com; Secure; SameSite=Lax";

(Catatan: Pada aplikasi produksi nyata, sebaiknya cookie ini dikirim lewat header Set-Cookie dari server dengan flag HttpOnly agar jauh lebih aman, namun konsep atribut domain-nya tetap sama).

Hasilnya: Mulus Tanpa Ribet

Saya me-refactor logika autentikasi kami di sela-sela sprint.

Alur kerja “Sesudah”:

  • Pengguna login di example.com.
  • Kami menyetel cookie dengan domain=.example.com.
  • Pengguna mengklik tautan normal menuju app.example.com.
  • Browser secara otomatis mengirimkan cookie tersebut ke subdomain.
  • Aplikasi membaca cookie, memvalidasinya, dan pengguna langsung login seketika.

Tidak ada lagi token di URL. Tidak ada lagi click handler khusus. Tidak ada lagi keluhan “Kenapa saya ter-logout?”.

Pelajaran Utama

Sebagai junior developer, sangat mudah tergoda membuat workaround kreatif (seperti mengoper token lewat URL) karena “yang penting jalan”. Padahal biasanya, cara standar yang “membosankan”—yaitu memahami cara kerja state management HTTP—justru merupakan solusi terbaik.

Jika Anda membangun arsitektur multi-subdomain, berhentilah memakai LocalStorage dan parameter URL. Manfaatkan shared cookies. Lebih bersih, lebih aman, dan membuat pengguna tetap nyaman.