rici12 / ldap-laravel-provider
Lean and simple Ldap provider for Laravel 5.1
Requires
- php: >=5.4.0
- illuminate/contracts: 5.1.*
- illuminate/support: 5.1.*
This package is not auto-updated.
Last update: 2024-12-21 19:37:02 UTC
README
Lean and simple ldap provider for Laravel 5.1. Works only with Active Directory system.
When is this package useful?
When you need to authenticate your user against a ldap server (Active Directory system), while maintaining a users table in your database.
What is included?
A provider and its service provider.
How to install
In your composer.json, as a required dependency, insert:
"rici12/ldap-laravel-provider": "0.*"
Then run
composer update
After that, open config/app.php and add to your service providers list
RiCi12\LdapLaravelProvider\ServiceProvider\LdapServiceProvider::class
Then open config/auth.php and change your driver option
'driver' => 'ldap'
Open the .env file and add the required options
LDAPSERVER = auth.magrathea.com
LDAPDOMAINNAME = MAGRATHEA\
USERNAMECREDENTIALSATTRIBUTE = username
PASSWORDCREDENTIALSATTRIBUTE = password
Work flow
- Try to connect to the provided server
- Check if input credentials are correct
- If true, search for a user from users table (compairing 'username' attribute)
- Return the user, if found; otherwise, throws an Exception.
Use case
In my last project I needed to let the user authenticate with their domain credentials while not letting everybody get access to the homepage; plus, I was asked to implement a really simple roles system (read/write access). So i implemented this authentication service provider wich fits great with Laravel Auth system: you'll be able to access the user from Auth facade.