strebl/l5-ldap-auth

Friday, April 22, 2016
by strebl
Repository
7 Watchers
35 Stars
6,120 Installations

PHP
0 Dependents
0 Suggesters
52 Forks
9 Open issues
22 Versions
3 % Grown

The README.md

, _(*1)

Active Directory LDAP Authentication

Laravel 5 Active Directory LDAP Authentication driver., _(*2)

Fork

This is a fork of Cody Covey's ldap-auth package. Unfortunately he doesn't developed the package recently and didn't update the package to Laravel 4.1+ or even Laravel 5. Therefore I decided to fork the package to provide a minimal Laravel 5 support., _(*3)

The first release, 2.0, isn't well tested. Just be careful!, _(*4)

Contribution

Just post an issue or create a pull request on this repository. I'll really appreciate it., _(*5)

Installation

Versions

This will follow releases similar to how Laravel itself manages releases. When Laravel moves to 5.2 this package will move to 2.2, with minor versions signifying bug fixes, etc., _(*6)

Laravel Version	Package Version	Package Status
5.1.x	2.1.*	maintained
5.0.x	2.1.*	maintained
5.0.x	2.0.*	abandoned
4.x	1.0.*	abandoned

Version 2.1 requires PHP 5.5+. If you are using Laravel 5.0 which supports PHP 5.4 you can still use 2.0.*. However, this version won't get updates., _(*7)

Laravel 5.1 / 5.0

To install this package pull it in through Composer., _(*8)

composer require strebl/l5-ldap-auth:2.1.*

After Composer is done, you need to tell your application to use the LDAP service provider., _(*9)

Open config/app.php and add the service provider, _(*10)

Ccovey\LdapAuth\LdapAuthServiceProvider::class, _(*11)

after, _(*12)

Illuminate\Auth\AuthServiceProvider::class, _(*13)

This tells Laravel to use the service provider from the vendor folder., _(*14)

You also need to direct Auth to use the ldap driver instead of Eloquent or Database, edit config/auth.php and change driver to ldap:, _(*15)

    'driver' => 'ldap',

Laravel 4

The Laravel 4 version of this package is no longer maintained., _(*16)

To install this package pull it in through Composer., _(*17)

composer require strebl/l5-ldap-auth:1.0.*

After Composer is done, you need to tell your application to use the LDAP service provider., _(*18)

Open config/app.php and find, _(*19)

Illuminate\Auth\AuthServiceProvider, _(*20)

and replace it with, _(*21)

Ccovey\LdapAuth\LdapAuthServiceProvider, _(*22)

This tells Laravel to use the service provider from the vendor folder., _(*23)

You also need to direct Auth to use the ldap driver instead of Eloquent or Database, edit app/config/auth.php and change driver to ldap, _(*24)

Configuration

To specify the username field to be used in config/auth.php (Laravel 4: app/config/auth.php) set a key / value pair 'username_field' => 'fieldname' This will default to username if you don't provide one., _(*25)

To set up your adLDAP for connections to your domain controller, create a file config/adldap.php (Laravel 4: app/config/adldap.php) This will provide all the configuration values for your connection. For all configuration options an array like the one below should be provided., _(*26)

It is important to note that the only required options are account_suffix, base_dn, and domain_controllers. The others provide either security or more information. If you don't want to use the others simply delete them., _(*27)

// Example adldap.php file.
return [
    'account_suffix' => "@domain.local",

    'domain_controllers' => array("dc1.domain.local", "dc2.domain.local"), // An array of domains may be provided for load balancing.

    'base_dn' => 'DC=domain,DC=local',

    'admin_username' => 'user',

    'admin_password' => 'password',

    'real_primary_group' => true, // Returns the primary group (an educated guess).

    'use_ssl' => true, // If TLS is true this MUST be false.

    'use_tls' => false, // If SSL is true this MUST be false.

    'recursive_groups' => true,
];

Usage

$guarded is now defaulted to all so to use a model you must change to $guarded = []. If you store Roles or similar sensitive information make sure that you add that to the guarded array., _(*28)

Use of Auth is the same as with the default service provider., _(*29)

By Default this will have the username (samaccountname), displayname, primary group, as well as all groups user is a part of, _(*30)

To edit what is returned you can specify in config/auth.php (Laravel 4: app/config/auth.php) under the fields key., _(*31)

For more information on what fields from AD are available to you visit http://goo.gl/6jL4V, _(*32)

You may also get a complete user list for a specific OU by defining the userList key and setting it to true. You must also set the group key that defined which OU to look at. Do not that on a large AD this may slow down the application., _(*33)

Model Usage

You can still use a model with this implementation as well if you want. ldap-auth will take your fields from ldap and attach them to the model allowing you to access things such as roles / permissions from the model if the account is valid in Active Directory. It is also important to note that no authentication takes place off of the model. All authentication is done from Active Directory and if they are removed from AD but still in a users table they WILL NOT be able to log in., _(*34)

The Versions

22/04 2016

library l5-ldap-auth

strebl/l5-ldap-auth

The README.md

Active Directory LDAP Authentication

Fork

Contribution

Installation

Versions

Laravel 5.1 / 5.0

Laravel 4

Configuration

Usage

Model Usage

The Versions

dev-patch-1

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

dev-master

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

v2.1.3

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

dev-fix-15

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

v2.1.2

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

v2.1.1

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

v2.1.0

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

dev-laravel-5.1

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

v2.0.1

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

dev-develop

The Requires

The Development Requires

by Cody Covey

v2.0

The Requires

The Development Requires

by Cody Covey

by Manuel Strebel

v1.1.5

The Requires

The Development Requires

by Cody Covey

v1.1.4

The Requires

The Development Requires

by Cody Covey

v1.1.3

The Requires

The Development Requires

by Cody Covey