panchodp/laravel-fingerprint
| Install | |
|---|---|
composer require panchodp/laravel-fingerprint |
|
| Latest Version: | v1.0.5 |
| PHP: | ^8.4 |
| Laravel: | 12 · 13 |
| License: | MIT |
| Last Updated: | Oct 29, 2026 |
| Links: | GitHub · Packagist |
Laravel Fingerprint
Protects against session hijacking by generating a fingerprint from the client's request headers. If the fingerprint changes mid-session, the session is invalidated and the user is redirected.
Requirements
- PHP ^8.4
- Laravel 12 or 13
Installation
composer require panchodp/laravel-fingerprint
Usage
Add the fingerprint middleware to the routes you want to protect:
Route::middleware(['auth', 'fingerprint'])->group(function () {
// protected routes
});
Or enable it globally for all web routes via the LARAVEL_FINGERPRINT_GLOBAL=true environment variable (see Configuration).
On the first request, the fingerprint is stored in the session. On subsequent requests, it is compared — if it doesn't match, the session is invalidated and the user is redirected.
Configuration
Publish the config file:
php artisan vendor:publish --tag=laravel-fingerprint-config
Available options in config/laravel_fingerprint.php:
| Key | Env variable | Default | Description |
|---|---|---|---|
enabled |
LARAVEL_FINGERPRINT_ENABLED |
true |
Enable or disable the package |
include_ip |
LARAVEL_FINGERPRINT_INCLUDE_IP |
false |
Include the client IP in the fingerprint (not recommended for mobile/dynamic IPs) |
redirect_route |
LARAVEL_FINGERPRINT_REDIRECT_ROUTE |
login |
Named route to redirect to when the fingerprint doesn't match |
global |
LARAVEL_FINGERPRINT_GLOBAL |
false |
Apply the middleware automatically to all routes in the web middleware group |
How it works
The fingerprint is a SHA-256 hash of:
UserAgent | Accept-Language | Accept-Encoding [ | IP ]
If a session cookie is stolen and used from a different device or browser, the fingerprint won't match and the session will be invalidated.
License
The MIT License (MIT). Please see License File for more information.
Related Packages
Version History
| Version | Released | PHP | Laravel | License |
|---|---|---|---|---|
| v1.0.5 | ^8.4 | ^12.0| | MIT | |
| v1.0.4 | ^8.4 | ^12.0| | MIT | |
| v1.0.3 | ^8.4 | ^12.0| | MIT | |
| v1.0.2 | ^8.4 | ^12.0| | MIT | |
| v1.0.1 | ^8.4 | ^12.0| | MIT | |
| v1.0.0 | ^8.4 | ^12.0| | MIT | |
| 0.1.5 | ^8.4 | ^12.0| | MIT | |
| 0.1.4 | ^8.4 | ^12.0| | MIT | |
| 0.1.3 | ^8.4 | ^12.0| | MIT | |
| 0.1.2 | ^8.4 | ^12.0| | MIT | |
| 0.1.1 | ^8.4 | ^12.0| | MIT | |
| 0.1.0 | ^8.4 | ^12.0| | MIT |
