Cara Membuat Autentikasi API Laravel dengan Sanctum untuk Aplikasi Mobile (Panduan Lengkap 2026)
Cara Membuat Autentikasi API Laravel dengan Sanctum untuk Aplikasi Mobile (Panduan Lengkap 2026)
Autentikasi API Laravel dengan Sanctum dibuat dengan menginstal Sanctum lewat php artisan install:api, menambahkan trait HasApiTokens ke model User, lalu menerbitkan token lewat createToken() saat login dan melindunginya dengan middleware auth:sanctum. Token ini yang dikirim aplikasi mobile sebagai header Authorization: Bearer <token> di setiap request.
Kalau Anda menjual atau memakai source code Laravel yang punya aplikasi mobile — misalnya aplikasi kasir, toko online, atau absensi — cepat atau lambat Anda butuh login dari aplikasi tersebut ke backend. Sanctum adalah jawaban bawaan Laravel untuk kebutuhan ini: ringan, tanpa server OAuth terpisah, dan cukup untuk mayoritas aplikasi mobile maupun SPA. Panduan ini membahas implementasi lengkapnya, termasuk bagian yang paling sering dilewatkan tutorial lain: token per perangkat, pembatasan kemampuan token (abilities), dan kedaluwarsa token.
Apa itu Laravel Sanctum?
Laravel Sanctum adalah package autentikasi ringan bawaan ekosistem Laravel untuk tiga kebutuhan: SPA (Single Page Application), aplikasi mobile, dan API berbasis token yang sederhana. Berbeda dengan Passport yang mengimplementasikan OAuth2 secara penuh, Sanctum sengaja dibuat minimal: setiap user bisa memiliki banyak token, dan setiap token bisa diberi kemampuan (abilities) yang membatasi aksi apa saja yang boleh dilakukan token tersebut.
Dokumentasi resmi Laravel di laravel.com/docs/sanctum menegaskan satu hal penting: jangan memakai token API untuk mengautentikasi SPA pihak pertama Anda sendiri — untuk itu Sanctum punya mode autentikasi SPA berbasis cookie. Untuk aplikasi mobile, justru token API adalah cara yang benar, karena aplikasi mobile tidak bisa mengandalkan cookie session seperti browser.
Kapan Memakai Sanctum dan Kapan Tidak?
| Kebutuhan Pilihan tepat | |
| Login aplikasi mobile (Flutter, React Native, native) | Sanctum |
| SPA pihak pertama (Vue/React di domain yang sama) | Sanctum mode cookie |
| API internal antar layanan sendiri | Sanctum |
| API publik untuk pihak ketiga dengan OAuth2 penuh (client id/secret, scope, consent screen) | Passport |
| Single sign-on antar banyak aplikasi | Passport / OAuth2 |
Singkatnya: kalau yang mengonsumsi API adalah aplikasi Anda sendiri, Sanctum sudah cukup dan jauh lebih mudah dirawat. Cara ini tidak cocok jika Anda membuka API untuk developer pihak ketiga yang butuh alur OAuth2 lengkap dengan halaman persetujuan — di titik itu, Passport adalah alat yang benar.
Langkah 1: Instalasi Sanctum
Di Laravel 11 ke atas, Sanctum tidak lagi terinstal bawaan, tapi instalasinya satu perintah. Perintah ini sekaligus memasang file routes/api.php dan menjalankan migrasi yang dibutuhkan:
Perintah tersebut memasang package laravel/sanctum, mempublikasikan migrasinya, dan membuat tabel personal_access_tokens. Jalankan migrasinya:
Langkah 2: Siapkan Model User
Tambahkan trait HasApiTokens ke model User. Trait inilah yang memberi model kemampuan menerbitkan dan mengelola token:
Langkah 3: Buat AuthController (Register, Login, Logout, Profil)
Inilah inti implementasinya. Satu controller menangani empat endpoint: register, login, profil user yang sedang login, dan logout. Perhatikan tiga detail yang membedakan implementasi produksi dari sekadar tutorial: validasi yang ketat, Hash::check untuk verifikasi password (jangan pernah membandingkan password mentah), dan nama token yang berasal dari nama perangkat.
Perhatikan bahwa plainTextToken hanya bisa dibaca satu kali, tepat saat token dibuat. Sanctum hanya menyimpan hash token di database, bukan token aslinya. Artinya, kalau aplikasi mobile kehilangan tokennya, tidak ada cara mengambilnya kembali dari server — user harus login ulang dan token baru diterbitkan. Ini sengaja, dan ini perilaku keamanan yang benar.
Langkah 4: Daftarkan Route API
Pisahkan route publik dan route terproteksi. Route login dan register tidak butuh token, sedangkan profil dan logout wajib melewati middleware auth:sanctum:
Mengapa Token Harus Per Perangkat?
Di sinilah banyak tutorial berhenti, padahal ini bagian paling berguna untuk aplikasi nyata. Karena device_name dikirim dari aplikasi — misalnya "HP Kasir 1" atau "iPhone Budi" — setiap perangkat mendapat token sendiri. Manfaatnya langsung terasa:
- Logout satu perangkat tidak mengganggu perangkat lain. Tombol logout di atas hanya menghapus
currentAccessToken(), jadi user yang login di dua HP tetap login di HP satunya. - Keamanan insiden lebih mudah. HP hilang? Hapus token perangkat itu saja dari daftar token user, tanpa memaksa semua perangkat login ulang.
- Audit lebih jelas. Tabel
personal_access_tokensmencatat nama token dan waktu terakhir dipakai (last_used_at), sehingga Anda bisa menampilkan daftar "perangkat yang login" di halaman profil — fitur yang biasa ada di aplikasi besar.
Untuk logout dari semua perangkat sekaligus (misalnya setelah ganti password), tambahkan endpoint ini:
Membatasi Kemampuan Token dengan Abilities
Secara default, token Sanctum bisa mengakses semua route yang dilindungi auth:sanctum. Kalau ada token yang hanya boleh membaca data — misalnya token untuk aplikasi laporan — batasi dengan abilities:
Lalu lindungi route-nya dengan middleware kemampuan:
Pola ini penting saat source code Anda dipakai banyak pihak: token yang bocor dari aplikasi laporan tidak bisa dipakai untuk mengubah data, karena kemampuannya memang hanya baca.
Mengatur Kedaluwarsa Token
Token Sanctum secara default tidak kedaluwarsa. Untuk aplikasi mobile, itu sering kali bisa diterima — user tidak mau login ulang tiap jam. Tapi untuk keamanan, Anda bisa mengatur kedaluwarsa global di config/sanctum.php:
Setelah kedaluwarsa, token lama ditolak dan user harus login ulang. Praktik yang seimbang untuk aplikasi kasir atau toko: kedaluwarsa 30–90 hari, dikombinasikan dengan logout semua perangkat saat password diubah. Jangan mengatur kedaluwarsa terlalu pendek (misalnya 1 jam) untuk aplikasi mobile tanpa mekanisme refresh token, karena pengalaman user akan buruk.
Menguji dengan curl
Sebelum menghubungkan aplikasi mobile, uji dulu endpoint-nya dari terminal:
Kalau responsnya 401 Unauthorized, cek tiga hal secara berurutan: header Authorization benar-benar terkirim dengan format Bearer <token>, token belum dihapus atau kedaluwarsa, dan route tersebut memang berada di dalam grup auth:sanctum.
Checklist Keamanan Sebelum Naik Produksi
- Wajib HTTPS. Token bearer yang dikirim lewat HTTP bisa disadap siapa pun di jaringan yang sama. Tanpa HTTPS, seluruh skema ini tidak aman.
- Batasi percobaan login. Tambahkan throttle pada route login (
throttle:5,1berarti 5 percobaan per menit per IP) untuk menghambat brute force. Panduan tentang login dengan Google di Laravel membahas pola perlindungan akun yang sejalan. - Jangan simpan token di tempat yang salah. Di aplikasi mobile, simpan token di secure storage (Flutter Secure Storage, Keychain iOS, EncryptedSharedPreferences Android) — bukan di SharedPreferences biasa atau localStorage yang mudah dibaca.
- Cabut semua token saat password diubah. Ini mencegah penyerang yang sudah memegang token lama tetap masuk setelah korban mengganti password.
- Pantau
last_used_at. Token yang tidak pernah dipakai berbulan-bulan sebaiknya dibersihkan dengan perintah terjadwal. - Pisahkan token antar peran. Kalau source code Anda punya peran admin dan member, kombinasikan token abilities dengan sistem role — panduan multi role & permission di Laravel menjelaskan fondasinya.
Penutup
Sanctum memberi Anda autentikasi API yang cukup untuk hampir semua aplikasi mobile tanpa kerumitan OAuth2: instal satu perintah, tambah satu trait, terbitkan token per perangkat, dan lindungi route dengan auth:sanctum. Nilai tambahnya bukan di login itu sendiri, melainkan di pengelolaan token setelahnya — token per perangkat, abilities, kedaluwarsa, dan pencabutan saat insiden. Itulah yang membedakan API yang sekadar jalan dari API yang siap dipakai pelanggan source code Anda.
Kalau Anda sedang membangun REST API-nya dari nol, baca juga panduan membuat REST API Laravel untuk aplikasi mobile sebagai fondasi struktur endpoint dan format respons yang konsisten.
FAQ
Apa itu Laravel Sanctum?
Laravel Sanctum adalah sistem autentikasi ringan bawaan Laravel untuk SPA, aplikasi mobile, dan API berbasis token sederhana. Setiap user bisa memiliki banyak token, dan setiap token bisa dibatasi kemampuannya dengan abilities.
Apakah Sanctum cocok untuk aplikasi Flutter?
Ya. Sanctum adalah pilihan paling umum untuk aplikasi Flutter yang memakai backend Laravel: aplikasi mengirim email, password, dan nama perangkat ke endpoint login, menerima token, lalu menyimpannya di secure storage dan mengirimnya sebagai header Bearer di setiap request.
Apa bedanya Sanctum dan Passport?
Sanctum adalah autentikasi token sederhana untuk aplikasi Anda sendiri, sedangkan Passport mengimplementasikan OAuth2 penuh untuk API yang dibuka ke developer pihak ketiga. Untuk aplikasi mobile milik sendiri, Sanctum lebih ringan dan lebih mudah dirawat.
Apakah token Sanctum bisa kedaluwarsa?
Bisa. Atur expiration di config/sanctum.php dalam menit — misalnya 30 hari. Secara default token tidak kedaluwarsa, jadi atur ini secara sadar sesuai kebutuhan aplikasi Anda.
Bagaimana cara logout dari satu perangkat saja?
Panggil $request->user()->currentAccessToken()->delete() di endpoint logout. Ini hanya menghapus token perangkat yang sedang dipakai, sehingga perangkat lain tetap login.
Apakah token yang hilang bisa dilihat lagi di database?
Tidak. Sanctum hanya menyimpan hash token, bukan token aslinya. Token asli (plainTextToken) hanya tampil sekali saat dibuat. Kalau hilang, user harus login ulang untuk mendapat token baru.
Apakah Sanctum aman dipakai di shared hosting?
Ya, selama situs memakai HTTPS dan route login diberi throttle. Sanctum tidak butuh proses latar belakang khusus, sehingga berjalan baik di shared hosting — berbeda dengan beberapa solusi autentikasi yang butuh server tambahan.
Artikel Terkait
PHP 8.6.0 RC5 Rilis 5 November 2026: Kandidat Terakhir Sebelum Final 19 November
14 Nov 2026
Cara Membuat Sistem Membership & Langganan Berbayar di Laravel: Paket, Pembayaran & Middleware (Panduan 2026)
14 Nov 2026
Laravel 13.40.0 Rilis 3 November 2026: Alert Job Lambat, Commit ID Replika & Perbaikan Keamanan Concurrency
14 Nov 2026
Cara Membuat Middleware Kustom di Laravel: Role, Langganan & Header Keamanan (Panduan 2026)
14 Nov 2026