Lompat ke konten
ENID
Developer

Apa Itu JWT? Struktur, Claim, dan Kesalahan Umum

Penjelasan jelas tentang JSON Web Token: tiga bagiannya, claim standar, cara verifikasinya, dan kesalahan yang perlu dihindari.

Diterbitkan 3 menit baca

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
  1. Header: JSON yang menyebut algoritma tanda tangan (alg) dan tipe token.
  2. Payload: JSON berisi claim.
  3. 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

ClaimArti
issPenerbit token
subSubject: biasanya ID pengguna
audAudience: untuk siapa token ditujukan
expWaktu kedaluwarsa dalam detik Unix
nbfTidak berlaku sebelum waktu ini
iatWaktu token diterbitkan
jtiID 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 pastikan iss dan aud sesuai 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.

Panduan terkait

Enter untuk membuka, Esc untuk menutup

Scroll to Top