Apa itu JWT
JSON Web Token (JWT, dibaca “jot”) adalah string ringkas yang membawa claim, yaitu pernyataan tentang pengguna atau sesi, dalam bentuk yang dapat diperiksa dari perubahan. JWT banyak dipakai untuk autentikasi API dan untuk meneruskan identitas antar layanan.
Tiga bagiannya
JWT adalah tiga string Base64URL yang digabung dengan titik: header.payload.signature.
eyJhbGciOiJIUzI1NiJ9 . eyJzdWIiOiIxMjMifQ . 5mhBHqs5_DTLdINd9p5m7ZJ6XD0Xc55kIaRRyhPjhhE
- Header: JSON yang menyebut algoritma tanda tangan (
alg) dan tipe token. - Payload: JSON berisi claim.
- Signature: nilai yang dihitung dari dua bagian pertama dan sebuah secret atau kunci privat, sehingga perubahan apa pun pada header atau payload merusaknya.
Claim standar
| Claim | Arti |
|---|---|
| iss | Penerbit token |
| sub | Subject: biasanya ID pengguna |
| aud | Audience: untuk siapa token ditujukan |
| exp | Waktu kedaluwarsa dalam detik Unix |
| nbf | Tidak berlaku sebelum waktu ini |
| iat | Waktu token diterbitkan |
| jti | ID unik token |
Aplikasi menambahkan claim sendiri, seperti peran. Claim waktu adalah Unix timestamp.
Decode bukan verifikasi
Siapa pun dapat men-decode JWT, karena Base64URL adalah encoding, bukan enkripsi. JWT Decoder membaca header dan payload serta menunjukkan apakah token sudah kedaluwarsa menurut jam perangkat Anda. Tool itu tidak memverifikasi signature, dan data hasil decode tidak boleh dipercaya atas dasar itu.
Verifikasi terjadi di server yang menerima token:
- HS256: secret bersama yang sama menandatangani dan memverifikasi.
- RS256 atau ES256: kunci privat menandatangani, dan kunci publik memverifikasi, sehingga banyak layanan bisa memverifikasi tanpa dapat menerbitkan token.
Kesalahan umum
- Menerima
alg: none. Token tanpa tanda tangan bukan bukti apa pun. Tetapkan algoritma yang diizinkan di server, jangan percaya header. - Melewatkan pemeriksaan claim. Verifikasi
exp, dan pastikanissdanaudsesuai harapan. - Menaruh rahasia di payload. Payload dapat dibaca siapa pun yang memegang token.
- Masa berlaku terlalu panjang. Token yang dicuri berfungsi sampai kedaluwarsa. Pakai umur pendek dan refresh token.
- Secret bersama yang lemah. Secret HS256 harus panjang dan acak.
- Menganggap JWT sebagai sesi yang bisa dicabut. Tanpa state tambahan, Anda tidak dapat membatalkan token sebelum kedaluwarsa.
Di mana menyimpan token di browser
Kedua pilihan punya konsekuensi. Local storage dapat dibaca skrip mana pun di halaman (risiko XSS), sedangkan cookie dengan HttpOnly, Secure, dan nilai SameSite yang sesuai tersembunyi dari skrip tetapi perlu perlindungan terhadap cross-site request forgery.
FAQ
Apakah JWT terenkripsi?
JWT bertanda tangan standar tidak. Token terenkripsi (JWE) ada tetapi memiliki lima bagian dan struktur berbeda.
Mengapa token saya dinyatakan kedaluwarsa?
exp sudah lewat menurut jam perangkat Anda. Periksa jamnya, atau minta token baru.
Bolehkah membaca token yang tidak saya percaya?
Boleh, decode tidak berbahaya. Hanya jangan bertindak berdasarkan isinya sebelum signature diverifikasi.