Choosing a preset | laravel-suspicious-login | Spatie       

 SPATIE  

laravel-suspicious-login
========================

spatie.be/open-source

  [Docs](https://spatie.be/docs)  [Laravel-suspicious-login](https://spatie.be/docs/laravel-suspicious-login/v1)  Basic-usage  Choosing a preset

 Version   v1      

 Other versions for crawler [v1](https://spatie.be/docs/laravel-suspicious-login/v1) 

  Choosing a preset    
- [ Introduction ](https://spatie.be/docs/laravel-suspicious-login/v1/introduction)
- [ Support us ](https://spatie.be/docs/laravel-suspicious-login/v1/support-us)
- [ Requirements ](https://spatie.be/docs/laravel-suspicious-login/v1/requirements)
- [ Installation &amp; setup ](https://spatie.be/docs/laravel-suspicious-login/v1/installation-setup)
- [ Questions and issues ](https://spatie.be/docs/laravel-suspicious-login/v1/questions-issues)
- [ Changelog ](https://spatie.be/docs/laravel-suspicious-login/v1/changelog)
- [ About us ](https://spatie.be/docs/laravel-suspicious-login/v1/about-us)

Basic usage
-----------

- [ Getting started ](https://spatie.be/docs/laravel-suspicious-login/v1/basic-usage/getting-started)
- [ How a login is scored ](https://spatie.be/docs/laravel-suspicious-login/v1/basic-usage/how-a-login-is-scored)
- [ Choosing a preset ](https://spatie.be/docs/laravel-suspicious-login/v1/basic-usage/choosing-a-preset)
- [ Customizing presets ](https://spatie.be/docs/laravel-suspicious-login/v1/basic-usage/customizing-presets)
- [ Working with login attempts ](https://spatie.be/docs/laravel-suspicious-login/v1/basic-usage/working-with-login-attempts)
- [ Adding custom properties ](https://spatie.be/docs/laravel-suspicious-login/v1/basic-usage/adding-custom-properties)
- [ Recording logins manually ](https://spatie.be/docs/laravel-suspicious-login/v1/basic-usage/recording-logins-manually)

Available checks
----------------

- [ Overview ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/overview)
- [ New device ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/new-device)
- [ New IP address ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/new-ip)
- [ New country ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/new-country)
- [ Impossible travel ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/impossible-travel)
- [ Allowed and blocked countries ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/country)
- [ Failed attempts ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/failed-attempts)
- [ Credential stuffing ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/credential-stuffing)
- [ Unusual time ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/unusual-time)
- [ Suspicious user agent ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/suspicious-user-agent)
- [ IP reputation ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/ip-reputation)
- [ Multiple countries ](https://spatie.be/docs/laravel-suspicious-login/v1/available-checks/multiple-countries)

Responding to suspicious logins
-------------------------------

- [ Notifying users ](https://spatie.be/docs/laravel-suspicious-login/v1/responding-to-suspicious-logins/notifying-users)
- [ Blocking logins ](https://spatie.be/docs/laravel-suspicious-login/v1/responding-to-suspicious-logins/blocking-logins)
- [ Writing your own actions ](https://spatie.be/docs/laravel-suspicious-login/v1/responding-to-suspicious-logins/writing-your-own-actions)
- [ Using events ](https://spatie.be/docs/laravel-suspicious-login/v1/responding-to-suspicious-logins/using-events)

Advanced usage
--------------

- [ Creating custom checks ](https://spatie.be/docs/laravel-suspicious-login/v1/advanced-usage/creating-custom-checks)
- [ Geolocation drivers ](https://spatie.be/docs/laravel-suspicious-login/v1/advanced-usage/geolocation-drivers)
- [ IP reputation drivers ](https://spatie.be/docs/laravel-suspicious-login/v1/advanced-usage/ip-reputation-drivers)
- [ Device fingerprints ](https://spatie.be/docs/laravel-suspicious-login/v1/advanced-usage/device-fingerprints)
- [ Using your own model ](https://spatie.be/docs/laravel-suspicious-login/v1/advanced-usage/using-your-own-model)

 Choosing a preset
=================

###  On this page 

1. [ The same login, four presets ](#content-the-same-login-four-presets)
2. [ Start with MonitorOnly ](#content-start-with-monitoronly)
3. [ What each preset contains ](#content-what-each-preset-contains)

A preset decides which checks run, how much each one weighs, where the risk levels start, and what happens at each level. The package ships with four:

PresetUse it when`Lenient`You only want to bother users when several checks agree. It only notifies about high risk logins.`Balanced`The default. Notifies users about medium and high risk logins, and never blocks anyone.`Strict`You want to block high risk session logins. Adds unusual-time and IP-reputation checks to the `Balanced` checks, uses lower thresholds, and notifies at both suspicious levels.`MonitorOnly`You're trying the package out. Runs the `Balanced` checks and stores the results, but takes no action.You set the preset in `config/suspicious-login.php`:

```
'preset' => Spatie\SuspiciousLogin\Presets\Strict::class,
```

The same login, four presets
------------------------------------------------------------------------------------------------------------------------------------------

Here's how Anna's login from New York, ten hours after her usual morning login in Antwerp, plays out with each preset. She has logged in every morning for a few weeks, and a geolocation driver is configured.

PresetFlagged byScoreRisk levelWhat happens`Lenient`new device (20), new country (30)50mediumnothing`Balanced`new device (25), new IP (10), new country (30)65mediumAnna gets an email`Strict`new device (30), new IP (10), new country (30), unusual time (15)85highAnna gets an email and the login is blocked`MonitorOnly`same as `Balanced`65mediumthe attempt is stored, nothing elseStart with MonitorOnly
--------------------------------------------------------------------------------------------------------------------------

For an app with existing users, set `MonitorOnly` in `config/suspicious-login.php` to collect scores without notifying or blocking anyone:

```
'preset' => Spatie\SuspiciousLogin\Presets\MonitorOnly::class,
```

It still fires events, so any listeners you registered continue to run. Let it run for a week or two, then look at the scores your real users get:

```
use Spatie\SuspiciousLogin\Models\LoginAttempt;

LoginAttempt::query()
    ->whereNot('risk_level', 'low')
    ->latest()
    ->get(['authenticatable_type', 'authenticatable_id', 'ip_address', 'country_code', 'risk_score', 'reasons']);
```

If people who travel a lot or use a VPN show up as high risk, [lower the weight of those checks](/docs/laravel-suspicious-login/v1/basic-usage/customizing-presets) before switching to a preset that notifies or blocks.

What each preset contains
-----------------------------------------------------------------------------------------------------------------------------------

`Lenient``Balanced``Strict`[`NewDeviceCheck`](/docs/laravel-suspicious-login/v1/available-checks/new-device)202530[`NewIpCheck`](/docs/laravel-suspicious-login/v1/available-checks/new-ip)1010[`NewCountryCheck`](/docs/laravel-suspicious-login/v1/available-checks/new-country)303030[`ImpossibleTravelCheck`](/docs/laravel-suspicious-login/v1/available-checks/impossible-travel)606060[`FailedAttemptsCheck`](/docs/laravel-suspicious-login/v1/available-checks/failed-attempts)30, from 10 failures in 60 minutes30, from 5 failures in 15 minutes30, from 3 failures in 15 minutes[`CredentialStuffingCheck`](/docs/laravel-suspicious-login/v1/available-checks/credential-stuffing)40, from 10 accounts40, from 5 accounts50, from 3 accounts[`SuspiciousUserAgentCheck`](/docs/laravel-suspicious-login/v1/available-checks/suspicious-user-agent)2030[`UnusualTimeCheck`](/docs/laravel-suspicious-login/v1/available-checks/unusual-time)15[`IpReputationCheck`](/docs/laravel-suspicious-login/v1/available-checks/ip-reputation)50Medium risk from504030High risk from807060On medium risknothingnotifynotifyOn high risknotifynotifynotify and blockThe table uses the default config. `Balanced` and `MonitorOnly` read their risk thresholds from `risk_thresholds` in `config/suspicious-login.php`. `Lenient` and `Strict` define their own thresholds, which take precedence over the config.

 A good
match?
-------------

### What we do best

- All things Laravel
- Custom frontend components
- Building APIs
- AI-powered features
- Simplifying things
- Clean solutions
- Integrating services

### Not our cup of tea

- WordPress themes
- Cutting corners
- Free mockups to win a job
- "Just execute the briefing"

 In short: we'd like to be a **substantial part** of your project.

 [ Get in touch via email ](mailto:info@spatie.be?subject=A%20good%20match%21&body=Tell%20us%20as%20much%20as%20you%20can%20about%0A-%20your%20online%20project%0A-%20your%20planning%0A-%20your%20budget%0A-%20%E2%80%A6%0A%0AAnything%20that%20helps%20us%20to%20start%20straightforward%21)
