ptdot/ldapauth

Laravel LDAP authentication wrapper

Laravel LDAP Authentication

Laravel LDAP Authentication is a package for authenticating user to Active Directory using Lightweight Directory Access Protocol and integrated with Laravel authenticatable model out of the box., _(*1)

Requirements

• Laravel 5.1 - 5.6
• Enable PHP LDAP Extension

Installation

Install package through composer., _(*2)

composer require ptdot/ldapauth

Next, if using Laravel under 5.5, include the service provider and Facade within your config/app.php file., _(*3)

'providers' => [
    Ptdot\LdapAuth\LdapAuthServiceProvider::class,
],

'aliases' => [
    'LdapAuth' => Ptdot\LdapAuth\LdapAuthFacade::class,
]

Since Laravel 5.5+ is using Package Discovery, there is no need manually insert service provider and facade inside your app.php., _(*4)

Configuration

Publish config using command:, _(*5)

php artisan vendor:publish --tag=config

Set keys and values for your LDAP configuration in .env file., _(*6)

LDAP_HOST=ldap.example.com
LDAP_PORT=389

Setup your User model or custom authentication model In config/ldap.php file and don't forget to adjust your usernameField value from your authentication model., _(*7)

Make sure you are already has user data in database and create user model for authentication., _(*8)

/*
    |--------------------------------------------------------------------------
    | Authentication user model
    |--------------------------------------------------------------------------
    |
    | Authentication is used User model for default.
    | Define this option if authentication model using different model / namespace.
    |
    */
    'user' => App\User::class,
    'usernameField' => 'username'

Usage

For attempting authentication using LDAP:, _(*9)

$result = LdapAuth::attempt($username, $password);

Attempt method will return an array that indicate that authentication is success or not., _(*10)

Example, _(*11)

/**
* Logging in using LDAP
*/
public funtion login(Request $request)
{
    $username = $request->get('username');
    $password = $request->get('password');

    $login = LdapAuth::attempt($username, $password);
    if($login['status']) {
        return "Login success";
    }
    return "Login failed. Error: ".$login['message'];
}

Contributing

Feel free to report an issue or merge request if you want to help this package become better and useful., _(*12)