New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

panchodp/laravel-fingerprint

Laravel Session theft protection via client fingerprinting — auto-invalidates sessions used from unrecognized devices.
1,023 1
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
Maintainer: Francisco de Pablo

Logo for Laravel Fingerprint Package

Laravel Fingerprint

PHP Total Downloads Latest Stable Version License Tests

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

asbiin/laravel-webauthn

Laravel Webauthn support

762,219 311
muyaedward/laravel-webauthn

Laravel Webauthn support

4,353 0
cartalyst/sentinel

PHP 8.2+ Fully-featured Authentication & Authorization System

2,853,038 1,529
cline/cloak

Prevent sensitive exception details from leaking in Laravel applications

12,546 0

Version History

Version Released PHP Laravel License
v1.0.5 ^8.4 ^12.0|^13.0 MIT
v1.0.4 ^8.4 ^12.0|^13.0 MIT
v1.0.3 ^8.4 ^12.0|^13.0 MIT
v1.0.2 ^8.4 ^12.0|^13.0 MIT
v1.0.1 ^8.4 ^12.0|^13.0 MIT