Autentikasi adalah gerbang pertama setiap aplikasi yang menyimpan data pengguna. Saat mencari tutorial implementasi JWT, biasanya Anda ingin jawaban yang langsung bisa dipraktikkan: bagaimana token dibuat setelah login, bagaimana token dikirim klien, dan bagaimana server memverifikasinya pada setiap permintaan. Artikel ini memandu alur tersebut langkah demi langkah memakai Node.js dan Express, lengkap dengan contoh kode, penanganan refresh token, serta praktik keamanan yang sering terlewat.
JWT (JSON Web Token) adalah standar terbuka RFC 7519 yang mendefinisikan cara mengirimkan informasi identitas dalam format JSON yang ditandatangani secara digital. Karena token bersifat self-contained, server tidak perlu menyimpan sesi login di memori atau database. Cukup verifikasi tanda tangan dan klaim di dalamnya, lalu permintaan diproses. Jika Anda baru pertama kali mengenal konsep ini, penjelasan mendasar tentang struktur dan cara kerjanya tersedia di artikel panduan memahami JWT dan JWT token.
Apa Itu JWT dan Mengapa Cocok untuk Autentikasi Aplikasi
JWT terdiri dari tiga bagian yang dipisahkan tanda titik: header, payload, dan signature. Header menyimpan informasi algoritma, payload berisi klaim seperti ID pengguna dan masa berlaku, sedangkan signature memastikan isi token tidak diubah. Kombinasi ini membuat JWT ringkas, mudah dikirim lewat header HTTP, dan cocok untuk arsitektur API maupun microservices yang tidak berbagi penyimpanan sesi.
Meski begitu, JWT bukan solusi untuk semua kasus. Karena token berlaku sampai kedaluwarsa, pencabutan akses secara instan memerlukan strategi tambahan seperti token blacklist atau masa berlaku yang pendek. Pahami dulu kebutuhan aplikasi Anda sebelum memilih JWT sebagai mekanisme autentikasi utama.
Struktur JWT: Header, Payload, dan Signature
Sebelum menulis kode, pahami tiga komponen token agar tidak salah menempatkan data:
- Header berisi tipe token dan algoritma penandatanganan, misalnya
HS256. Bagian ini hanya dienkode Base64Url, bukan dienkripsi. - Payload berisi klaim seperti
sub(ID pengguna),role,iat(waktu terbit), danexp(waktu kedaluwarsa). Jangan pernah menaruh kata sandi atau data sensitif di sini karena siapa pun yang memegang token bisa membacanya. - Signature dihasilkan dari header, payload, dan secret key. Inilah yang membuat token tidak bisa dimodifikasi tanpa terdeteksi.
Alur Implementasi JWT dari Login sampai Verifikasi
Berikut alur yang akan kita bangun: pengguna mengirim email dan kata sandi, server memverifikasi kredensial, menerbitkan access token berumur pendek, lalu klien melampirkan token tersebut pada setiap permintaan. Server memverifikasi token di middleware sebelum mengizinkan akses ke endpoint yang dilindungi.
1. Menyiapkan Proyek dan Dependensi
Buat proyek Node.js baru, lalu pasang Express, jsonwebtoken, bcryptjs, dan dotenv. Simpan secret key di variabel lingkungan, bukan di dalam kode sumber.
npm init -y
npm install express jsonwebtoken bcryptjs dotenv
2. Membuat Endpoint Login dan Menerbitkan Token
Pada endpoint login, bandingkan kata sandi dengan hash yang tersimpan, lalu terbitkan token. Gunakan masa berlaku pendek, misalnya 15 menit, agar risiko penyalahgunaan token berkurang.
app.post('/login', async (req, res) => {
const { email, password } = req.body;
const user = await findUserByEmail(email);
if (!user || !(await bcrypt.compare(password, user.passwordHash))) {
return res.status(401).json({ message: 'Kredensial tidak valid' });
}
const token = jwt.sign(
{ sub: user.id, role: user.role },
process.env.JWT_SECRET,
{ expiresIn: '15m', algorithm: 'HS256' }
);
res.json({ accessToken: token });
});
3. Memverifikasi Token di Middleware
Setelah token diterbitkan, server perlu memeriksa setiap permintaan yang masuk ke endpoint terlindungi. Di sinilah peran middleware menjadi penting: satu fungsi dapat menangani verifikasi token sebelum request diteruskan ke handler utama. Konsep ini dijelaskan lebih lanjut dalam artikel apa itu middleware dan perannya dalam aplikasi backend.
function authenticate(req, res, next) {
const header = req.headers.authorization || '';
const token = header.startsWith('Bearer ') ? header.slice(7) : null;
if (!token) return res.status(401).json({ message: 'Token tidak ada' });
try {
const payload = jwt.verify(token, process.env.JWT_SECRET, {
algorithms: ['HS256']
});
req.user = payload;
next();
} catch (err) {
const expired = err.name === 'TokenExpiredError';
return res.status(401).json({
message: expired ? 'Token kedaluwarsa' : 'Token tidak valid'
});
}
}
4. Menyimpan Token di Sisi Klien
Di sisi klien, simpan access token di memori aplikasi dan kirim melalui header Authorization: Bearer <token>. Untuk refresh token, gunakan cookie HttpOnly, Secure, dan SameSite agar tidak dapat dibaca JavaScript. Hindari menyimpan token berumur panjang di localStorage karena rentan terhadap serangan XSS.
Refresh Token dan Logout
Access token yang pendek membuat pengguna sering login ulang. Solusinya adalah refresh token: token berumur panjang yang disimpan aman di server dan digunakan hanya untuk menerbitkan access token baru. Terapkan rotasi refresh token setiap kali dipakai, simpan hash-nya di database, dan cabut token tersebut saat pengguna logout. Dengan begitu, sesi yang bocor dapat dibatasi masa berlakunya.
Praktik Keamanan yang Wajib Diterapkan
Implementasi yang berjalan belum tentu aman. Terapkan daftar periksa berikut sebelum aplikasi dipakai di produksi:
- Gunakan secret key yang panjang dan acak, simpan di secret manager, serta rotasi secara berkala.
- Batasi algoritma yang diterima saat verifikasi untuk mencegah serangan algoritma
noneatau manipulasi header. - Selalu periksa klaim
exp,iss, danaudagar token dari aplikasi lain tidak diterima. - Wajibkan HTTPS, batasi percobaan login, dan jangan pernah menaruh data sensitif di payload.
- Uji implementasi Anda mengikuti panduan pengujian keamanan aplikasi web OWASP WSTG, termasuk pengujian penyimpanan token dan manajemen sesi.
Kesimpulan
Implementasi JWT untuk autentikasi aplikasi pada dasarnya mengikuti tiga langkah: terbitkan token setelah login, verifikasi token di middleware, dan kelola masa berlaku dengan refresh token. Kunci keberhasilannya bukan hanya kode yang berjalan, tetapi juga disiplin dalam menjaga secret, memvalidasi klaim, dan menguji keamanan secara berkala. Dengan alur di atas, Anda sudah memiliki fondasi autentikasi yang stateless, rapi, dan siap dikembangkan untuk API maupun microservices.
