directorytree / ldaprecord-browser
Browse your LDAP server in your Laravel application.
Installs: 149
Dependents: 0
Suggesters: 0
Security: 0
Stars: 10
Watchers: 7
Forks: 1
Open Issues: 0
Language:Blade
Requires
Requires (Dev)
- mockery/mockery: ^1.0
- phpunit/phpunit: ^8.0
- spatie/ray: ^1.25
This package is auto-updated.
Last update: 2024-10-22 18:05:22 UTC
README
An LDAP browser for your Laravel application or development workflow.
Requirements
- Laravel >= 8.0
- LdapRecord-Laravel >= 2.0
Installation
Before installing LdapRecord-Browser, configure your LDAP connections.
After configuring your connections, install LdapRecord-Browser via composer:
composer require directorytree/ldaprecord-browser
Then, inside of your routes/web.php
file, register Browser's routes via:
// routes/web.php Route::prefix('/ldap')->group(function () { \LdapRecord\Browser\Browser::routes(); });
Since Browser has an index route (/
), it's recommended to wrap it inside of a group
with a prefix so it does not collide with your applications root index page.
Usage
After you've registered Browser's routes, you're ready to start navigating your directory.
Visit your application at (if running php artisan serve
) http://127.0.0.1:8000/ldap.
You will see a list of connections you have configured:
Click one of the connections and you will be taken to a view of your entire directory, where you may search and view all objects visible by your configured user account:
Configuration
LdapRecord-Browser is configured out of the box for use with Active Directory LDAP servers.
If you're connecting to a different LDAP server, such as OpenLDAP, you may alter the LdapRecord model references Browser utilizes.
To update these references, call LdapRecord\Browser\Browser::models()
inside of your AppServiceProvider::boot()
method:
use LdapRecord\Browser\Browser; use LdapRecord\Browser\ModelType; public function boot() { Browser::models([ ModelType::USER => \LdapRecord\Models\OpenLDAP\User::class, ModelType::GROUP => \LdapRecord\Models\OpenLDAP\Group::class, ModelType::DEFAULT => \LdapRecord\Models\OpenLDAP\Entry::class, ModelType::UNKNOWN => \LdapRecord\Models\OpenLDAP\Entry::class, ModelType::COMPUTER => \LdapRecord\Models\OpenLDAP\Entry::class, ModelType::CONTAINER => \LdapRecord\Models\OpenLDAP\OrganizationalUnit::class, ]); }
Note: If you've created your own LdapRecord models, feel free to update these references to those instead.