https://github.com/directorytree/ldaprecord-browser
Browse your LDAP server in your Laravel application.
https://github.com/directorytree/ldaprecord-browser
Last synced: 12 months ago
JSON representation
Browse your LDAP server in your Laravel application.
- Host: GitHub
- URL: https://github.com/directorytree/ldaprecord-browser
- Owner: DirectoryTree
- License: mit
- Created: 2021-06-06T19:31:44.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-11-28T16:58:06.000Z (over 2 years ago)
- Last Synced: 2024-03-29T15:23:13.486Z (about 2 years ago)
- Language: Blade
- Size: 389 KB
- Stars: 9
- Watchers: 6
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license.md
Awesome Lists containing this project
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](https://ldaprecord.com/docs/laravel/v2/configuration).
After configuring your connections, install LdapRecord-Browser via composer:
```bash
composer require directorytree/ldaprecord-browser
```
Then, inside of your `routes/web.php` file, register Browser's routes via:
```php
// 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](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:
```php
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.