dsdevbe/ldap-connector

Easily authenticate with LDAP in Laravel

Sunday, December 4, 2016
by Dsdevbe
Repository
10 Watchers
105 Stars
6,925 Installations

PHP
0 Dependents
0 Suggesters
28 Forks
4 Open issues
13 Versions
1 % Grown

The README.md

Not maintained anymore

I've created this project during my internship for an easy authentication between various applications within my company. The scope of the ldap-connector was only to authenticate with Laravel to the LDAP server., _(*1)

In case you're looking for a replacement please checkout Adldap2-Laravel. They have also created the awesome library Adldap2 which ldap-connector was using., _(*2)

I'll stop maintaining this project but would like to thank all the people that contributed or used this project., _(*3)

Ldap-connector

, _(*4)

Provides an solution for authentication users with LDAP for Laravel 5.x. It uses ADLDAP library on Adldap2 to create a bridge between Laravel and LDAP, _(*5)

Laravel 5.1 - 5.0

Install this package through Composer by adding the following line to composer.json, _(*6)
```
    "dsdevbe/ldap-connector": "3.0.*"
```
or you could use command-line js composer require "dsdevbe/ldap-connector:3.0.*", _(*7)
Add the service provider in the app configuration by opening config/app.php, and add a new item to the providers array., _(*8)
```
Dsdevbe\LdapConnector\LdapConnectorServiceProvider::class
```
Change the authentication driver in the Laravel config to use the ldap driver. You can find this in the following file config/auth.php, _(*9)
```
'driver' => 'ldap',
```

Publish a new configuration file with php artisan vendor:publish in the configuration folder of Laravel you will find config/ldap.php and modify to your needs. For more detail of the configuration you can always check on ADLAP documentation, _(*10)

return array(
    'plugins' => array(
        'adldap' => array(
            'account_suffix'=>  '@domain.local',
            'domain_controllers'=>  array(
                '192.168.0.1',
                'dc02.domain.local'
            ), // Load balancing domain controllers
            'base_dn'   =>  'DC=domain,DC=local',
            'admin_username' => 'admin', // This is required for session persistance in the application
            'admin_password' => 'yourPassword',
        ),
    ),
);

Please note that the fields 'admin_username' and 'admin_password' are required for session persistance!, _(*11)

Usage

The LDAP plugin is an extension of the Auth class and will act the same as normal usage with Eloquent driver., _(*12)

if (Auth::attempt(array('username' => $username, 'password' => $password)))
{
    return Redirect::intended('dashboard');
}

You can find more examples on Laravel Auth Documentation on using the Auth:: function., _(*13)

Use AuthController

If you want to use the authentication controller that ships with Laravel you will need to change the following files. By default App\Http\Controllers\Auth\AuthController checks for the email field if nothing is provided. To overwrite this value add the following line in the AuthController., _(*14)

protected $username = 'username';

Laravel documentation: Authentication Quickstart, _(*15)

Ldap Groups

Auth::user()->getGroups() returns array with groups the current user belongs to.
Auth::user()->inGroup('GROUPNAME') returns boolean if user belongs to GROUPNAME

Ldap User Information

Auth::user()->getUsername() returns authenticated username.
Auth::user()->getFirstname() returns authenticated first name.
Auth::user()->getLastname() returns authenticated last name.
Auth::user()->getEmail() returns authenticated email address.

Laravel 5.2 - ...

Install this package through Composer by adding the following line to composer.json, _(*16)
```
"dsdevbe/ldap-connector": "4.0.*"
```
or you could use command-line, _(*17)
```
composer require "dsdevbe/ldap-connector:4.0.*"
```
Add the service provider in the app configuration by opening config/app.php, and add a new item to the providers array., _(*18)
```
Dsdevbe\LdapConnector\LdapConnectorServiceProvider::class
```

Change the authentication driver in the Laravel config to use the ldap driver. You can find this in the following file config/auth.php, _(*19)

'providers' => [
    'users' => [
        'driver' => 'ldap',
        'adldap' => [
            'account_suffix'=>  '@domain.local',
            'domain_controllers'=>  array(
                '192.168.0.1',
                'dc02.domain.local'
            ), // Load balancing domain controllers
            'base_dn'   =>  'DC=domain,DC=local',
            'admin_username' => 'admin', // This is required for session persistance in the application
            'admin_password' => 'yourPassword',
        ],
    ],
],

Please note that the fields 'admin_username' and 'admin_password' are required for session persistance!, _(*20)

Usage

The LDAP plugin is an extension of the Auth class and will act the same as normal usage with Eloquent driver., _(*21)

if (Auth::attempt(array('username' => $username, 'password' => $password)))
{
    return Redirect::intended('dashboard');
}

You can find more examples on Laravel Auth Documentation on using the Auth:: function., _(*22)

Use AuthController

protected $username = 'username';

Laravel documentation: Authentication Quickstart, _(*24)

Ldap User Information

Difference with ldap-connector V3 is that now the adLDAP model is directly exposed on the user model. This means that you can fetch all data directly from the user. To access the adldap model you can use now Auth::user()->getAdLDAP()., _(*25)

Examples: - Auth::user()->getAdLDAP()->getAccountName() - Auth::user()->getAdLDAP()->getFirstName(), _(*26)

To fetch more properties please check adLDAP2 documentation, _(*27)

Contributing

Feel free to contribute to this project for new features or bug fixes. We are open for improvements!, _(*28)

The Versions

04/12 2016

dev-master

9999999-dev https://github.com/SaschaDens/ldap-connector

Easily authenticate with LDAP in Laravel

Sources Download

MIT

The Requires

laravel/framework ~5.0
php >=5.5.9
ext-ldap *
adldap2/adldap2 5.2.*

The Development Requires

phpspec/phpspec ^2.2

by SaschaDens

laravel ldap

14/05 2016

dev-Laravel4.2

dev-Laravel4.2 https://github.com/dsdevbe/ldap-connector

Easily authenticate with LDAP in Laravel

Sources Download

MIT

The Requires

php >=5.3.0
adldap2/adldap2 v4.0.5

by Dsdevbe

laravel ldap

16/04 2016

4.0.1

4.0.1.0 https://github.com/SaschaDens/ldap-connector

Easily authenticate with LDAP in Laravel

Sources Download

MIT

The Requires

php >=5.5.9
ext-ldap *
laravel/framework ~5.0
adldap2/adldap2 5.2.*

The Development Requires

phpspec/phpspec ^2.2

by SaschaDens

laravel ldap

16/04 2016

dev-PasswordValidation

dev-PasswordValidation https://github.com/SaschaDens/ldap-connector

Easily authenticate with LDAP in Laravel

Sources Download

MIT

The Requires

php >=5.5.9
ext-ldap *
laravel/framework ~5.0
adldap2/adldap2 5.2.*

The Development Requires

phpspec/phpspec ^2.2

by SaschaDens

laravel ldap

28/03 2016

dev-Laravel5.1

dev-Laravel5.1 https://github.com/SaschaDens/ldap-connector

Easily authenticate with LDAP in Laravel

Sources Download

MIT

The Requires

The Development Requires

phpspec/phpspec ^2.2

by SaschaDens

laravel ldap

01/03 2016

4.0.0

4.0.0.0 https://github.com/SaschaDens/ldap-connector

Easily authenticate with LDAP in Laravel

Sources Download

MIT

The Requires

php >=5.5.9
ext-ldap *
laravel/framework ~5.0
adldap2/adldap2 5.2.*

The Development Requires

phpspec/phpspec ^2.2

by SaschaDens

laravel ldap

12/12 2015

3.1.1

3.1.1.0 https://github.com/SaschaDens/ldap-connector

Easily authenticate with LDAP in Laravel

Sources Download

MIT

The Requires

The Development Requires

phpspec/phpspec ^2.2

The Development Requires

mockery/mockery dev-master

by Dsdevbe

laravel ldap

library ldap-connector

Easily authenticate with LDAP in Laravel

dsdevbe/ldap-connector

The README.md

Not maintained anymore

Ldap-connector

Installation

Laravel 5.1 - 5.0

Usage

Use AuthController

Ldap Groups

Ldap User Information

Laravel 5.2 - ...

Usage

Use AuthController

Ldap User Information

Contributing

The Versions

dev-master

The Requires

The Development Requires

by SaschaDens

dev-Laravel4.2

The Requires

by Dsdevbe

4.0.1

The Requires

The Development Requires

by SaschaDens

dev-PasswordValidation

The Requires

The Development Requires

by SaschaDens

dev-Laravel5.1

The Requires

The Development Requires

by SaschaDens

4.0.0

The Requires

The Development Requires

by SaschaDens

3.1.1

The Requires

The Development Requires

by SaschaDens

3.1.0

The Requires

by SaschaDens

3.0.2

The Requires

by Dsdevbe

3.0.1

The Requires

by Dsdevbe

3.0.0

The Requires

by Dsdevbe

2.0.0

The Requires

by Dsdevbe

1.0.0

The Requires

The Development Requires

by Dsdevbe