git subrepo commit (merge) mailcow/src/mailcow-dockerized
subrepo: subdir: "mailcow/src/mailcow-dockerized"
merged: "02ae5285"
upstream: origin: "https://github.com/mailcow/mailcow-dockerized.git"
branch: "master"
commit: "649a5c01"
git-subrepo: version: "0.4.3"
origin: "???"
commit: "???"
Change-Id: I870ad468fba026cc5abf3c5699ed1e12ff28b32b
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.gitattributes b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.gitattributes
new file mode 100644
index 0000000..84b904d
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.gitattributes
@@ -0,0 +1,2 @@
+examples/ export-ignore
+tests/ export-ignore
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.github/issue_template.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.github/issue_template.md
new file mode 100644
index 0000000..f9aba6b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.github/issue_template.md
@@ -0,0 +1,10 @@
+- Adldap2 Version: #.#
+- LDAP Type: <!-- Active Directory / OpenLDAP / FreeIPA / Sun Directory Server? -->
+- PHP Version: #.#
+
+<!-- **ISSUES WITHOUT THE ABOVE INFORMATION WILL BE CLOSED!** -->
+
+### Description:
+
+
+### Steps To Reproduce:
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.gitignore b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.gitignore
new file mode 100644
index 0000000..2130d09
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.gitignore
@@ -0,0 +1,3 @@
+/.idea
+/vendor
+composer.lock
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.scrutinizer.yml b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.scrutinizer.yml
new file mode 100644
index 0000000..9dbf8c1
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.scrutinizer.yml
@@ -0,0 +1,10 @@
+filter:
+ excluded_paths:
+ - tests/*
+ - src/Schemas/*
+build:
+ nodes:
+ analysis:
+ tests:
+ override:
+ - command: php-scrutinizer-run
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.styleci.yml b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.styleci.yml
new file mode 100644
index 0000000..8be488d
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.styleci.yml
@@ -0,0 +1,7 @@
+preset: recommended
+
+enabled:
+ - length_ordered_imports
+
+disabled:
+ - alpha_ordered_imports
\ No newline at end of file
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.travis.yml b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.travis.yml
new file mode 100644
index 0000000..2723d68
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/.travis.yml
@@ -0,0 +1,19 @@
+language: php
+
+php:
+ - 7.1
+ - 7.2
+ - 7.3
+ - 7.4
+
+before_script:
+ - travis_retry composer self-update
+ - travis_retry composer install --prefer-source --no-interaction
+
+script: ./vendor/bin/phpunit
+
+branches:
+ only:
+ - master
+ - v9.0
+ - v8.0
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/composer.json b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/composer.json
new file mode 100644
index 0000000..26c1534
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/composer.json
@@ -0,0 +1,57 @@
+{
+ "name": "adldap2/adldap2",
+ "type": "library",
+ "description": "A PHP LDAP Package for humans.",
+ "keywords": [
+ "active directory",
+ "directory",
+ "ad",
+ "ldap",
+ "windows",
+ "adldap",
+ "adldap2"
+ ],
+ "license": "MIT",
+ "support": {
+ "docs": "https://github.com/Adldap2/Adldap2/blob/master/readme.md",
+ "issues": "https://github.com/Adldap2/Adldap2/issues",
+ "source": "https://github.com/Adldap2/Adldap2",
+ "email": "steven_bauman@outlook.com"
+ },
+ "authors": [
+ {
+ "name": "Steve Bauman",
+ "email": "steven_bauman@outlook.com",
+ "role": "Developer"
+ }
+ ],
+ "require": {
+ "php": ">=7.0",
+ "ext-ldap": "*",
+ "ext-json": "*",
+ "psr/log": "~1.0",
+ "psr/simple-cache": "~1.0",
+ "tightenco/collect": "~5.0|~6.0|~7.0|~8.0",
+ "illuminate/contracts": "~5.0|~6.0|~7.0|~8.0"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "~6.0|~7.0|~8.0",
+ "mockery/mockery": "~1.0"
+ },
+ "suggest": {
+ "ext-fileinfo": "fileinfo is required when retrieving user encoded thumbnails"
+ },
+ "archive": {
+ "exclude": ["/examples", "/tests"]
+ },
+ "autoload": {
+ "psr-4": {
+ "Adldap\\": "src/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "Adldap\\Tests\\": "tests/"
+ }
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/.nojekyll b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/.nojekyll
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/.nojekyll
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/_coverpage.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/_coverpage.md
new file mode 100644
index 0000000..fc8ec0b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/_coverpage.md
@@ -0,0 +1,16 @@
+<!-- _coverpage.md -->
+
+# Adldap2
+
+<p align="center">
+ <a href="https://travis-ci.org/Adldap2/Adldap2"><img src="https://img.shields.io/travis/Adldap2/Adldap2.svg?style=flat-square"/></a>
+ <a href="https://scrutinizer-ci.com/g/Adldap2/Adldap2/?branch=master"><img src="https://img.shields.io/scrutinizer/g/adLDAP2/adLDAP2/master.svg?style=flat-square"/></a>
+ <a href="https://packagist.org/packages/adldap2/adldap2"><img src="https://img.shields.io/packagist/dt/adldap2/adldap2.svg?style=flat-square"/></a>
+ <a href="https://packagist.org/packages/adldap2/adldap2"><img src="https://img.shields.io/packagist/v/adldap2/adldap2.svg?style=flat-square"/></a>
+ <a href="https://packagist.org/packages/adldap2/adldap2"><img src="https://img.shields.io/packagist/l/adldap2/adldap2.svg?style=flat-square"/></a>
+</p>
+
+> Working with LDAP doesn't need to be hard.
+
+<!-- background image -->
+
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/_sidebar.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/_sidebar.md
new file mode 100644
index 0000000..0284653
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/_sidebar.md
@@ -0,0 +1,27 @@
+<!-- _sidebar.md -->
+
+* Getting Started
+
+ * [Introduction](/)
+ * [Installation](installation.md)
+ * [Setup](setup.md)
+
+* Usage
+
+ * [Searching](searching.md)
+ * [Creating & Updating](models/model.md)
+ * [Events](events.md)
+ * [Logging](logging.md)
+ * [Working With Distiguished Names](distinguished-names.md)
+ * [Troubleshooting](troubleshooting.md)
+
+* Models
+ * [Model (Base)](models/model.md)
+ * [Computer](models/computer.md)
+ * [Contact](models/contact.md)
+ * [Container](models/container.md)
+ * [Group](models/group.md)
+ * [Organizational Unit](models/ou.md)
+ * [Printer](models/printer.md)
+ * [RootDse](models/root-dse.md)
+ * [User](models/user.md)
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/distinguished-names.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/distinguished-names.md
new file mode 100644
index 0000000..490b99b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/distinguished-names.md
@@ -0,0 +1,167 @@
+## Working With Distinguished Names
+
+Working with DN strings are a pain, but they're about to get easier. Adldap includes a DN builder for easily modifying and
+creating DN strings.
+
+> **Note**: All values inserted into DN methods are escaped. You do not need to escape **any** values before hand.
+
+#### Creating a New DN
+
+To create a new DN, construct a new `Adldap\Models\Attributes\DistinguishedName` instance:
+
+```php
+$dn = new Adldap\Models\Attributes\DistinguishedName();
+```
+
+You can also pass in a current DN string and start modifying it:
+
+```php
+$currentDn = 'cn=John Doe,ou=Accounting,dc=corp,dc=acme,dc=org';
+
+$dn = new Adldap\Models\Attributes\DistinguishedName($currentDn);
+```
+
+#### Adding / Removing a Domain Component
+
+```php
+// Add Domain Component
+$dn->addDc('corp');
+
+// Remove Domain Component
+$dn->removeDc('corp');
+```
+
+#### Adding / Removing an Organizational Unit
+
+```php
+// Add Organizational Unit
+$dn->addOu('Accounting');
+
+// Remove Organizational Unit
+$dn->removeOu('Accounting');
+```
+
+#### Adding / Removing Common Names
+
+```php
+// Add Common Name
+$dn->addCn('John Doe');
+
+// Remove Common Name
+$dn->removeCn('John Doe');
+```
+
+#### Setting a base
+
+If you'd like to set the base DN, such as a domain component RDN, use the `setBase()` method:
+
+```php
+$base = 'dc=corp,dc=acme,dc=org';
+
+$dn->setBase($base);
+```
+
+#### Creating a DN From A Model
+
+When you're creating a new LDAP record, you'll need to create a distinguished name as well. Let's go through an example of
+creating a new user.
+
+```php
+$user = $provider->make()->user();
+
+$user->setCommonName('John Doe');
+$user->setFirstName('John');
+$user->setLastName('Doe');
+```
+
+So we've set the basic information on the user, but we run into trouble when we want to put the user into a certain container
+(such as 'Accounting') which is done through the DN. Let's go through this example:
+
+```php
+$dn = $user->getDnBuilder();
+
+$dn->addCn($user->getCommonName());
+$dn->addOu('Accounting');
+$dn->addDc('corp');
+$dn->addDc('acme');
+$dn->addDc('org');
+
+// Returns 'cn=John Doe,ou=Accounting,dc=corp,dc=acme,dc=org'
+echo $dn->get();
+
+// The DistinguishedName object also contains the __toString() magic method
+// so you can also just echo the object itself
+echo $dn;
+```
+
+Now we've built a DN, and all we have to do is set it on the new user:
+
+```php
+$user->setDn($dn);
+
+$user->save();
+```
+
+#### Modifying a DN From A Model
+
+When you've received a model from a search result, you can build and modify the models DN like so:
+
+```php
+$user = $ad->users()->find('jdoe');
+
+$dn = $user->getDnBuilder();
+
+$dn->addOu('Users');
+
+$user->setDn($dn)->save();
+```
+
+#### Retrieving the RDN components
+
+To retrieve all of the RDN components of a Distinguished Name, call `getComponents()`:
+
+```php
+$dn = new Adldap\Models\Attributes\DistinguishedName(
+ 'cn=John Doe,ou=Accounting,dc=corp,dc=acme,dc=org'
+);
+
+$components = $dn->getComponents();
+
+var_dump($components);
+
+// Output:
+// array:5 [▼
+// "cn" => array:1 [▼
+// 0 => "John Doe"
+// ]
+// "uid" => []
+// "ou" => array:1 [▼
+// 0 => "Accounting"
+// ]
+// "dc" => array:3 [▼
+// 0 => "corp"
+// 1 => "acme"
+// 2 => "org"
+// ]
+// "o" => []
+// ]
+```
+
+You can also specify a component you would like returned by supplying it as an argument:
+
+```php
+$dn = new Adldap\Models\Attributes\DistinguishedName(
+ 'cn=John Doe,ou=Accounting,dc=corp,dc=acme,dc=org'
+);
+
+$dcs = $dn->getComponents('dc');
+
+var_dump($dcs);
+
+// Output:
+// array:3 [▼
+// 0 => "corp"
+// 1 => "acme"
+// 2 => "org"
+// ]
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/events.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/events.md
new file mode 100644
index 0000000..8175695
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/events.md
@@ -0,0 +1,175 @@
+# Events
+
+Adldap2 events provide a method of listening for certain LDAP actions
+that are called and execute tasks for that specific event.
+
+> **Note**: The Adldap2 event dispatcher was actually derived from the
+> [Laravel Framework](https://github.com/laravel/framework) with
+> Broadcasting & Queuing omitted to remove extra dependencies
+> that would be required with implementing those features.
+>
+> If you've utilized Laravel's events before, this will feel very familiar.
+
+## Registering Listeners
+
+> **Note**: Before we get to registering listeners, it's crucial to know that events throughout
+> Adldap2 are fired irrespective of the current connection or provider in use.
+>
+> This means that when using multiple LDAP connections, the same events will be fired.
+>
+> This allows you to set listeners on events that occur for all LDAP connections you utilize.
+>
+> If you are required to determine which events are fired from alternate connections, see [below](#determining-the-connection).
+
+To register a listener on an event, retrieve the event dispatcher and call the `listen()` method:
+
+```php
+use Adldap\Auth\Events\Binding;
+
+$dispatcher = \Adldap\Adldap::getEventDispatcher();
+
+$dispatcher->listen(Binding::class, function (Binding $event) {
+ // Do something with the Binding event information:
+
+ $event->connection; // Adldap\Connections\Ldap instance
+ $event->username; // 'jdoe@acme.org'
+ $event->password; // 'super-secret'
+});
+```
+
+The first argument is the event name you would like to listen for, and the
+second is either a closure or class name that should handle the event:
+
+Using a class:
+
+> **Note**: When using just a class name, the class must contain a public `handle()` method that will handle the event.
+
+```php
+use Adldap\Adldap;
+use Adldap\Auth\Events\Binding;
+
+$dispatcher = Adldap::getEventDispatcher();
+
+$dispatcher->listen(Binding::class, MyApp\BindingEventHandler::class);
+```
+
+```php
+namespace MyApp;
+
+use Adldap\Auth\Events\Binding;
+
+class BindingEventHandler
+{
+ public function handle(Binding $event)
+ {
+ // Handle the event...
+ }
+}
+```
+
+## Model Events
+
+Model events are handled the same way as authentication events.
+
+Simply call the event dispatcher `listen()` method with the model event you are wanting to listen for:
+
+```php
+use Adldap\Models\Events\Saving;
+
+$dispatcher = \Adldap\Adldap::getEventDispatcher();
+
+$dispatcher->listen(Saving::class, function (Saving $event) {
+ // Do something with the Saving event information:
+
+ // Returns the model instance being saved eg. `Adldap\Models\Entry`
+ $event->getModel();
+});
+```
+
+## Wildcard Event Listeners
+
+You can register listeners using the `*` as a wildcard parameter to catch multiple events with the same listener.
+
+Wildcard listeners will receive the event name as their first argument, and the entire event data array as their second argument:
+
+```php
+$dispatcher = Adldap::getEventDispatcher();
+
+// Listen for all model events.
+$dispatcher->listen('Adldap\Models\Events\*', function ($eventName, array $data) {
+ echo $eventName; // Returns 'Adldap\Models\Events\Updating'
+ var_dump($data); // Returns [0] => (object) Adldap\Models\Events\Updating;
+});
+
+$user = $provider->search()->users()->find('jdoe');
+
+$user->setTelephoneNumber('555 555-5555');
+
+$user->save();
+```
+
+## Determining the Connection
+
+If you're using multiple LDAP connections and you require the ability to determine which events belong
+to a certain connection, you can do so by verifying the host of the LDAP connection.
+
+Here's an example:
+
+```php
+$dispatcher = Adldap::getEventDispatcher();
+
+$dispatcher->listen(\Adldap\Models\Events\Creating::class, function ($event) {
+ $connection = $event->model->getConnection();
+
+ $host = $connection->getHost();
+
+ echo $host; // Displays 'ldap://192.168.1.1:386'
+});
+```
+
+Another example with auth events:
+
+```php
+$dispatcher = Adldap::getEventDispatcher();
+
+$dispatcher->listen(\Adldap\Auth\Events\Binding::class, function ($event) {
+ $connection = $event->connection;
+
+ $host = $connection->getHost();
+
+ echo $host; // Displays 'ldap://192.168.1.1:386'
+});
+```
+
+## List of Events
+
+### Authentication Events
+
+There are several events that are fired during initial and subsequent binds to your configured LDAP server.
+
+Here is a list of all events that are fired:
+
+| Event| Description |
+|---|---|
+| Adldap\Auth\Events\Attempting | When any authentication attempt is called via: `$provider->auth()->attempt()` |
+| Adldap\Auth\Events\Passed | When any authentication attempts pass via: `$provider->auth()->attempt()` |
+| Adldap\Auth\Events\Failed | When any authentication attempts fail via: `$provider->auth()->attempt()` *Or* `$provider->auth()->bind()` |
+| Adldap\Auth\Events\Binding | When any LDAP bind attempts occur via: `$provider->auth()->attempt()` *Or* `$provider->auth()->bind()` |
+| Adldap\Auth\Events\Bound | When any LDAP bind attempts are successful via: `$provider->auth()->attempt()` *Or* `$provider->auth()->bind()` |
+
+### Model Events
+
+There are several events that are fired during the creation, updating and deleting of all models.
+
+Here is a list of all events that are fired:
+
+| Event | Description |
+|---|---|
+| Adldap\Models\Events\Saving | When a model is in the process of being saved via: `$model->save()` |
+| Adldap\Models\Events\Saved | When a model has been successfully saved via: `$model->save()` |
+| Adldap\Models\Events\Creating | When a model is being created via: `$model->save()` *Or* `$model->create()` |
+| Adldap\Models\Events\Created | When a model has been successfully created via: `$model->save()` *Or* `$model->create()` |
+| Adldap\Models\Events\Updating | When a model is being updated via: `$model->save()` *Or* `$model->update()` |
+| Adldap\Models\Events\Updated | When a model has been successfully updated via: `$model->save()` *Or* `$model->update()` |
+| Adldap\Models\Events\Deleting | When a model is being deleted via: `$model->delete()` |
+| Adldap\Models\Events\Deleted | When a model has been successfully deleted via: `$model->delete()` |
\ No newline at end of file
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/index.html b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/index.html
new file mode 100644
index 0000000..adf939b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/index.html
@@ -0,0 +1,35 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="UTF-8">
+ <title>Adldap2 Documentation</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+ <meta name="description" content="Adldap2 Documentation">
+ <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
+ <link rel="stylesheet" href="https://unpkg.com/docsify/lib/themes/vue.css">
+ </head>
+
+ <body>
+ <div id="app"></div>
+
+ <script>
+ window.$docsify = {
+ name: 'Adldap2',
+ repo: 'https://github.com/Adldap2/Adldap2',
+ autoHeader: true,
+ auto2top: true,
+ homepage: 'readme.md',
+ coverpage: true,
+ search: 'auto',
+ loadSidebar: true,
+ subMaxLevel: 3
+ }
+ </script>
+
+
+ <script src="https://unpkg.com/docsify/lib/docsify.min.js"></script>
+ <script src="https://unpkg.com/prismjs/components/prism-php.min.js"></script>
+ <script src="https://unpkg.com/docsify/lib/plugins/search.min.js"></script>
+ </body>
+</html>
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/installation.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/installation.md
new file mode 100644
index 0000000..de21239
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/installation.md
@@ -0,0 +1,29 @@
+# Requirements
+
+Adldap2 requires the following:
+
+- PHP 7.0 or greater
+- LDAP extension enabled in PHP
+- An LDAP server (ActiveDirectory, OpenLDAP, FreeIPA etc.)
+
+# Composer
+
+Adldap2 uses [Composer](https://getcomposer.org) for installation.
+
+Once you have composer installed, run the following command in the root directory of your project:
+
+```bash
+composer require adldap2/adldap2
+```
+
+Then, if your application doesn't already require Composer's autoload, you will need to do it manually.
+
+Insert this line at the top of your projects PHP script (usually `index.php`):
+
+```php
+require __DIR__ . '/vendor/autoload.php';
+```
+
+You're all set!
+
+Now, head over to the [setup guide](setup.md) to get up and running.
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/logging.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/logging.md
new file mode 100644
index 0000000..b49bcd3
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/logging.md
@@ -0,0 +1,74 @@
+# Logging
+
+Adldap2 includes an implementation of PSR's widely supported [Logger](https://github.com/php-fig/log) interface.
+
+By default, all of Adldap2's [events](events.md) will call the logger you have set to utilize.
+
+> **Note**: Adldap2 does not include a file / text logger. You must implement your own.
+
+## Registering & Enabling a Logger
+
+To register a logger call `Adldap::setLogger()`. The logger must implement the `Psr\Log\LoggerInterface`.
+
+>**Note**: Be sure to set the logger prior to creating a new `Adldap` instance. This
+> ensures all events throughout the lifecycle of the request use your logger.
+
+```php
+use Adldap\Adldap;
+
+Adldap::setLogger($myLogger);
+
+$config = ['...'];
+
+$ad = new Adldap();
+
+$ad->addProvider($config);
+```
+
+## Disabling Logging
+
+If you need to disable the event logger after a certain set of operations, simply pass in `null` and logging will be disabled:
+
+```php
+use Adldap\Adldap;
+
+Adldap::setLogger($myLogger);
+
+$config = ['...'];
+
+$ad = new Adldap();
+
+$ad->addProvider($config);
+
+try {
+ $ad->connect();
+
+ // Disable logging anything else.
+ Adldap::setLogger(null);
+} catch (\Adldap\Connections\BindException $e) {
+ //
+}
+```
+
+## Logged Information
+
+Here is a list of events that are logged along with the information included:
+
+| Authentication Events | Logged |
+|---|---|
+| `Adldap\Auth\Events\Attempting` | `LDAP (ldap://192.168.1.1:389) - Operation: Adldap\Auth\Events\Attempting - Username: CN=Steve Bauman,OU=Users,DC=corp,DC=acme,DC=org` |
+| `Adldap\Auth\Events\Binding` |` LDAP (ldap://192.168.1.1:389) - Operation: Adldap\Auth\Events\Binding - Username: CN=Steve Bauman,OU=Users,DC=corp,DC=acme,DC=org` |
+| `Adldap\Auth\Events\Bound` | `LDAP (ldap://192.168.1.1:389) - Operation: Adldap\Auth\Events\Bound - Username: CN=Steve Bauman,OU=Users,DC=corp,DC=acme,DC=org` |
+| `Adldap\Auth\Events\Passed` | `LDAP (ldap://192.168.1.1:389) - Operation: Adldap\Auth\Events\Passed - Username: CN=Steve Bauman,OU=Users,DC=corp,DC=acme,DC=org` |
+| `Adldap\Auth\Events\Failed` | `LDAP (ldap://192.168.1.1:389) - Operation: Adldap\Auth\Events\Failed - Username: CN=Steve Bauman,OU=Users,DC=corp,DC=acme,DC=org - Result: Invalid Credentials` |
+
+| Model Events | Logged |
+|---|---|
+| `Adldap\Models\Events\Saving` | `LDAP (ldap://192.168.1.1:389) - Operation: Saving - On: Adldap\Models\User - Distinguished Name: cn=John Doe,dc=acme,dc=org` |
+| `Adldap\Models\Events\Saved` | `LDAP (ldap://192.168.1.1:389) - Operation: Saved - On: Adldap\Models\User - Distinguished Name: cn=John Doe,dc=acme,dc=org` |
+| `Adldap\Models\Events\Creating` | `LDAP (ldap://192.168.1.1:389) - Operation: Creating - On: Adldap\Models\User - Distinguished Name: cn=John Doe,dc=acme,dc=org` |
+| `Adldap\Models\Events\Created` | `LDAP (ldap://192.168.1.1:389) - Operation: Created - On: Adldap\Models\User - Distinguished Name: cn=John Doe,dc=acme,dc=org` |
+| `Adldap\Models\Events\Updating` | `LDAP (ldap://192.168.1.1:389) - Operation: Updating - On: Adldap\Models\User - Distinguished Name: cn=John Doe,dc=acme,dc=org` |
+| `Adldap\Models\Events\Updated` | `LDAP (ldap://192.168.1.1:389) - Operation: Updated - On: Adldap\Models\User - Distinguished Name: cn=John Doe,dc=acme,dc=org` |
+| `Adldap\Models\Events\Deleting` | `LDAP (ldap://192.168.1.1:389) - Operation: Deleting - On: Adldap\Models\User - Distinguished Name: cn=John Doe,dc=acme,dc=org` |
+| `Adldap\Models\Events\Deleted` | `LDAP (ldap://192.168.1.1:389) - Operation: Deleted - On: Adldap\Models\User - Distinguished Name: cn=John Doe,dc=acme,dc=org` |
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/media/bg.svg b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/media/bg.svg
new file mode 100644
index 0000000..e70e863
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/media/bg.svg
@@ -0,0 +1 @@
+<svg xmlns='http://www.w3.org/2000/svg' width='100%' height='100%' viewBox='0 0 1600 800'><rect fill='#46ff55' width='1600' height='800'/><g ><path fill='#51ff76' d='M486 705.8c-109.3-21.8-223.4-32.2-335.3-19.4C99.5 692.1 49 703 0 719.8V800h843.8c-115.9-33.2-230.8-68.1-347.6-92.2C492.8 707.1 489.4 706.5 486 705.8z'/><path fill='#57ff94' d='M1600 0H0v719.8c49-16.8 99.5-27.8 150.7-33.5c111.9-12.7 226-2.4 335.3 19.4c3.4 0.7 6.8 1.4 10.2 2c116.8 24 231.7 59 347.6 92.2H1600V0z'/><path fill='#5affb1' d='M478.4 581c3.2 0.8 6.4 1.7 9.5 2.5c196.2 52.5 388.7 133.5 593.5 176.6c174.2 36.6 349.5 29.2 518.6-10.2V0H0v574.9c52.3-17.6 106.5-27.7 161.1-30.9C268.4 537.4 375.7 554.2 478.4 581z'/><path fill='#57ffcd' d='M0 0v429.4c55.6-18.4 113.5-27.3 171.4-27.7c102.8-0.8 203.2 22.7 299.3 54.5c3 1 5.9 2 8.9 3c183.6 62 365.7 146.1 562.4 192.1c186.7 43.7 376.3 34.4 557.9-12.6V0H0z'/><path fill='#50ffe8' d='M181.8 259.4c98.2 6 191.9 35.2 281.3 72.1c2.8 1.1 5.5 2.3 8.3 3.4c171 71.6 342.7 158.5 531.3 207.7c198.8 51.8 403.4 40.8 597.3-14.8V0H0v283.2C59 263.6 120.6 255.7 181.8 259.4z'/><path fill='#7dffe9' d='M1600 0H0v136.3c62.3-20.9 127.7-27.5 192.2-19.2c93.6 12.1 180.5 47.7 263.3 89.6c2.6 1.3 5.1 2.6 7.7 3.9c158.4 81.1 319.7 170.9 500.3 223.2c210.5 61 430.8 49 636.6-16.6V0z'/><path fill='#9effe9' d='M454.9 86.3C600.7 177 751.6 269.3 924.1 325c208.6 67.4 431.3 60.8 637.9-5.3c12.8-4.1 25.4-8.4 38.1-12.9V0H288.1c56 21.3 108.7 50.6 159.7 82C450.2 83.4 452.5 84.9 454.9 86.3z'/><path fill='#baffea' d='M1600 0H498c118.1 85.8 243.5 164.5 386.8 216.2c191.8 69.2 400 74.7 595 21.1c40.8-11.2 81.1-25.2 120.3-41.7V0z'/><path fill='#d2ffea' d='M1397.5 154.8c47.2-10.6 93.6-25.3 138.6-43.8c21.7-8.9 43-18.8 63.9-29.5V0H643.4c62.9 41.7 129.7 78.2 202.1 107.4C1020.4 178.1 1214.2 196.1 1397.5 154.8z'/><path fill='#e9ffeb' d='M1315.3 72.4c75.3-12.6 148.9-37.1 216.8-72.4h-723C966.8 71 1144.7 101 1315.3 72.4z'/></g></svg>
\ No newline at end of file
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/computer.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/computer.md
new file mode 100644
index 0000000..e3057ab
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/computer.md
@@ -0,0 +1,32 @@
+# The Computer Model
+
+> **Note**: This model contains the traits `HasDescription`, `HasLastLogonAndLogOff` & `HasCriticalSystemObject`.
+> For more information, visit the documentation:
+>
+> [HasDescription](/models/traits/has-description.md),
+> [HasLastLogonAndLogOff](/models/traits/has-last-login-last-logoff.md),
+> [HasCriticalSystemObject](/models/traits/has-critical-system-object.md)
+
+## Methods
+
+```php
+$computer = $provider->search()->computers()->find('ACME-EXCHANGE');
+
+// Returns 'Windows Server 2003'
+$computer->getOperatingSystem();
+
+// Returns '5.2 (3790)';
+$computer->getOperatingSystemVersion();
+
+// Returns 'Service Pack 1';
+$computer->getOperatingSystemServicePack();
+
+// Returns 'ACME-DESKTOP001.corp.acme.org'
+$computer->getDnsHostName();
+
+$computer->getLastLogOff();
+
+$computer->getLastLogon();
+
+$computer->getLastLogonTimestamp();
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/contact.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/contact.md
new file mode 100644
index 0000000..e42c8f7
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/contact.md
@@ -0,0 +1,13 @@
+# The Contact Model
+
+The Contact model extends from the base `Adldap\Models\Model` class and contains
+no specific methods / attributes that are limited to it.
+
+## Creation
+
+```php
+// Adldap\Models\Contact
+$contact = $provider->make()->contact([
+ 'cn' => 'Suzy Doe',
+]);
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/container.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/container.md
new file mode 100644
index 0000000..132b549
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/container.md
@@ -0,0 +1,24 @@
+# The Container Model
+
+> **Note**: This model contains the trait `HasDescription` & `HasCriticalSystemObject`.
+> For more information, visit the documentation:
+>
+> [HasDescription](/models/traits/has-description.md),
+> [HasCriticalSystemObject](/models/traits/has-critical-system-object.md),
+
+## Creation
+
+```php
+// Adldap\Models\Container
+$container = $provider->make()->container([
+ 'cn' => 'VPN Users',
+]);
+```
+
+## Methods
+
+The `Container` model contains only one unique method.
+
+```php
+$flags = $container->getSystemFlags();
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/group.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/group.md
new file mode 100644
index 0000000..cf7c6d4
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/group.md
@@ -0,0 +1,253 @@
+# The Group Model
+
+> **Note**: This model contains the trait `HasMemberOf`.
+> For more information, visit the documentation:
+>
+> [HasMemberOf](/models/traits/has-member-of.md)
+
+## Creation
+
+```php
+// Adldap\Models\Group
+$group = $provider->make()->group([
+ 'cn' => 'Managers',
+]);
+
+// Create group's DN through the DN Builder:
+$group = $provider->make()->group();
+
+$dn = $group->getDnBuilder();
+
+$dn->addOu('Workstation Computers');
+
+$dn->addCn("Managers");
+
+$group->setDn($dn);
+
+// Or set the DN manually:
+$ou->setDn('cn=Managers,ou=Workstation Computers,dc=test,dc=local,dc=com');
+
+$group->save();
+```
+
+## Getting a groups members
+
+When you receive a `Group` model instance, it will contain a `member`
+attribute which contains the distinguished names of all
+the members inside the group.
+
+```php
+$group = $provider->search()->groups()->first();
+
+foreach ($group->members as $member) {
+ echo $member; // 'cn=John Doe,dc=corp,dc=acme,dc=org'
+}
+```
+
+But this might not be useful, since we might actually want the models for each member.
+
+This can be easily done with the `getMembers()` method on the group.
+
+```php
+$group = $provider->search()->groups()->first();
+
+foreach ($group->getMembers() as $member) {
+ echo get_class($member); // Instance of `Adldap\Models\Model`
+
+ echo $member->getCommonName();
+}
+```
+
+> **Note**: You should be aware however, that calling the `getMembers()` method will
+> query your `AD` server for **every** member contained in the group to retrieve
+> its model. For larger group sets it may be worth paginating them.
+
+
+### Paginating Group Members
+
+The group you're looking for might contain hundreds / thousands of members.
+
+In this case, your server might only return you a portion of the groups members.
+
+To get around this limit, you need to ask your server to paginate the groups members through a select:
+
+```php
+$group = $provider->search()->groups()->select('member;range=0-500')->first();
+
+foreach ($group->members as $member) {
+ // We'll only have 500 members in this query.
+}
+```
+
+Now, when we have the group instance, we'll only have the first `500` members inside this group.
+However, calling the `getMembers()` method will automatically retrieve the rest of the members for you:
+
+```php
+$group = $provider->search()->groups()->select('member;range=0-500')->first();
+
+foreach ($group->getMembers() as $member) {
+ // Adldap will automatically retrieve the next 500
+ // records until it's retrieved all records.
+ $member->getCommonName();
+}
+```
+
+> **Note**: Groups containing large amounts of users (1000+) will require
+> more memory assigned to PHP. Your mileage will vary.
+
+#### Paginating large sets of Group Members
+
+When requesting group members from groups that contain a large amount of members
+(typically over 1000), you may receive PHP memory limit errors due to
+the large amount of the objects being created in the request.
+
+To resolve this, you will need to retrieve the members manually. However using
+this route you will only be able to retrieve the members distinguished names.
+
+```php
+$from = 0;
+$to = 500;
+$range = "member;range=$from-$to";
+
+// Retrieve the group.
+$group = $provider->search()->select($range)->raw()->find('Accounting');
+
+// Remove the count from the member array.
+unset($group[$range]['count']);
+
+// The array of group members distinguished names.
+$members = $group[$range];
+
+foreach ($members as $member) {
+ echo $member; // 'cn=John Doe,dc=acme,dc=org'
+}
+```
+
+You can then encapsulate the above example into a recursive function to retrieve the remaining group members.
+
+## Getting only a groups member names
+
+To retrieve only the names of the members contained in a group, call the `getMemberNames()` method:
+
+```php
+foreach ($group->getMemberNames() as $name) {
+ // Returns 'John Doe'
+ echo $name;
+}
+```
+
+> **Note**: This method does not query your server for each member to retrieve its name. It
+> only parses the distinguished names from the groups `member` attribute. This means that
+> if you have paginated group members, you will need to perform another query yourself
+> to retrieve the rest of the member names (or just call the `getMembers()` method).
+
+## Setting Group Members
+
+To set members that are apart of the group, you can perform this in two ways:
+
+> **Note**: Remember, this will remove **all** pre-existing members, and set the new given members on the group.
+
+```php
+$members = [
+ 'cn=John Doe,dc=corp,dc=acme,dc=org',
+ 'cn=Jane Doe,dc=corp,dc=acme,dc=org',
+];
+
+$group->setMembers($members);
+
+$group->save();
+```
+
+Or manually:
+
+```php
+$group->member = [
+ 'cn=John Doe,dc=corp,dc=acme,dc=org',
+ 'cn=Jane Doe,dc=corp,dc=acme,dc=org',
+];
+
+$group->save();
+```
+
+## Adding One Member
+
+To add a single member to a group, use the `addMember()` method:
+
+> **Note**: You do not need to call the `save()` method after adding a
+> member. It's automatically called so you can determine
+> if the member was successfully added.
+
+```php
+// We can provide a model, or just a plain DN of the new member
+$user = $provider->search()->users()->first();
+
+if ($group->addMember($user)) {
+ // User was successfully added to the group!
+}
+
+// Or
+
+$user = 'cn=John Doe,dc=corp,dc=acme,dc=org';
+
+if ($group->addMember($user)) {
+ //
+}
+```
+
+## Adding Multiple Group Members
+
+To add multiple members to a group, use the `addMembers()` method:
+
+> **Note**: You do not need to call the `save()` method after adding
+> members. It's automatically called so you can determine
+> if the members were successfully added.
+
+```php
+$members = [
+ 'cn=John Doe,dc=corp,dc=acme,dc=org',
+ 'cn=Jane Doe,dc=corp,dc=acme,dc=org',
+];
+
+$group->addMembers($members);
+
+// Or
+
+$user = $provider->search()->users()->first();
+
+if ($group->addMembers($user)) {
+ //
+}
+```
+
+## Removing One Member
+
+To remove a single member to a group, use the `removeMember()` method:
+
+```php
+// We can provide a model, or just a plain DN of the existing member
+$group = $provider->search()->groups()->first();
+
+$member = $group->getMembers()->first();
+
+if ($group->removeMember($member)) {
+ // Member was successfully removed from the group!
+}
+
+// Or
+
+$user = 'cn=John Doe,dc=corp,dc=acme,dc=org';
+
+if ($group->removeMember($user)) {
+ //
+}
+```
+
+## Removing All Members
+
+To remove all members, use the `removeMembers()` method:
+
+```php
+if ($group->removeMembers()) {
+ // All members were successfully removed!
+}
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/model.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/model.md
new file mode 100644
index 0000000..fbcecc8
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/model.md
@@ -0,0 +1,655 @@
+# Creating / Updating
+
+## Introduction
+
+Adldap2 implements the [ActiveRecord](https://en.wikipedia.org/wiki/Active_record_pattern) pattern.
+This means that each LDAP record in your directory is represented as it's own model instance.
+
+## Creating
+
+Creating LDAP entries manually is always a pain, but Adldap2 makes it effortless. Let's get started.
+
+When you have a provider instance, call the `make()` method. This returns an `Adldap\Models\Factory` instance:
+
+```php
+$factory = $provider->make();
+```
+
+Or you can chain all methods if you'd prefer:
+
+```php
+$user = $provider->make()->user();
+```
+
+### Available Make Methods
+
+When calling a make method, all of them accept an `$attributes` parameter
+to fill the model with your specified attributes.
+
+```php
+// Adldap\Models\User
+$user = $provider->make()->user([
+ 'cn' => 'John Doe',
+]);
+
+// Adldap\Models\Computer
+$computer = $provider->make()->computer([
+ 'cn' => 'COMP-101',
+]);
+
+// Adldap\Models\Contact
+$contact = $provider->make()->contact([
+ 'cn' => 'Suzy Doe',
+]);
+
+// Adldap\Models\Container
+$container = $provider->make()->container([
+ 'cn' => 'VPN Users',
+]);
+
+// Adldap\Models\Group
+$group = $provider->make()->group([
+ 'cn' => 'Managers',
+]);
+
+// Adldap\Models\OrganizationalUnit
+$ou = $provider->make()->ou([
+ 'name' => 'Acme',
+]);
+```
+
+## Saving
+
+When you have any model instance, you can call the `save()` method to persist the
+changes to your server. This method returns a `boolean`. For example:
+
+```php
+$user = $provider->make()->user([
+ 'cn' => 'New User',
+]);
+
+if ($user->save()) {
+ // User was saved.
+} else {
+ // There was an issue saving this user.
+}
+```
+
+> **Note**: When a model is saved successfully (whether created or updated), the
+> models attributes are re-synced in the background from your LDAP server.
+>
+> This allows you to perform other operations during the same
+> request that require an existing model.
+
+### Creating (Manually)
+
+If you are sure the model **does not exist** already inside your LDAP directory, you can use the `create()` method:
+
+```php
+$user = $provider->make()->user([
+ 'cn' => 'New User',
+]);
+
+if ($user->create()) {
+ // User was created.
+} else {
+ // There was an issue creating this user.
+}
+```
+
+> **Note**: When you call the create method, if the model does not have a
+> distinguished name, one will automatically be generated for you using your
+> `base_dn` set in your configuration and the models common name.
+
+### Updating (Manually)
+
+If you are sure the model **does exist** already inside your LDAP directory, you can use the `update()` method:
+
+```php
+$user = $provider->search()->whereEquals('cn', 'John Doe')->firstOrFail();
+
+$user->displayName = 'Suzy Doe';
+
+if ($user->update()) {
+ // User was updated.
+} else {
+ // There was an issue updating this user.
+}
+```
+
+## Checking Existence
+
+If you need to check the existence of a model, use the property `exists`.
+
+How does it know if the model exists in your LDAP directory? Well, when models are constructed from
+search results, the `exists` property on the model is set to `true`.
+
+```php
+$user = $provider->search()->find('jdoe');
+
+$user->exists; // Returns true.
+
+if ($user->delete()) {
+ $user->exists; // Returns false.
+}
+```
+
+If a model is created successfully, the `exists` property is set to `true`:
+
+```php
+$user = $provider->make()->user([
+ 'cn' => 'John Doe',
+]);
+
+$user->exists; // Returns false.
+
+if ($user->save()) {
+ $user->exists; // Returns true.
+}
+```
+
+## Attributes
+
+Due to LDAPs multi-valued nature, all LDAP attributes inside a model have their own array.
+
+For example, a models attributes may contain the following:
+
+```php
+var_dump($user->getAttributes());
+
+// Returns:
+/*
+[
+ 'cn' => [
+ 0 => 'John Doe',
+ ],
+ 'sn' => [
+ 0 => 'Doe',
+ ],
+ 'givenname' => [
+ 0 => 'John'
+ ],
+ 'useraccountcontrol' => [
+ 0 => 512
+ ],
+ 'mail' => [
+ 0 => 'jdoe@acme.org',
+ 1 => 'john-doe@acme.org',
+ ],
+ 'memberof' => [
+ 0 => 'cn=Accountants,ou=Groups,dc=acme,dc=org',
+ 1 => 'cn=Employees,ou=Groups,dc=acme,dc=org',
+ 2 => 'cn=Users,ou=Groups,dc=acme,dc=org',
+ ],
+]
+*/
+```
+
+You can notice in the above dumped array that each attribute contains
+its own array with a value assigned to the first key.
+
+Since all models extend from the base class `Adldap\Models\Model`, there
+are many useful methods that you can use on every model to easily
+retrieve these attributes you're looking for.
+
+### Getting Attributes
+
+You can get attributes in a few ways:
+
+```php
+// Returns an array all of the users attributes.
+$user->getAttributes();
+
+// Returns an array of all the users email addresses.
+// Returns `null` if non-existent.
+$user->getAttribute('mail');
+
+// Returns the users first email address.
+// Returns `null` if non-existent.
+$user->getAttribute('mail', 0);
+
+// Returns the users first email address.
+// Returns `null` if non-existent.
+$user->getFirstAttribute('mail');
+
+// Returns an array of all the users email addresses.
+$user->mail;
+
+// Returns the users first email address.
+$user->mail[0];
+```
+
+#### Using a Getter
+
+Some attributes have methods for easier retrieval so you don't need to look up the LDAP attribute name.
+
+For example, to retrieve a users email address, use the method `getEmail()`:
+
+```php
+$user->getEmail();
+```
+
+##### Other Methods
+
+The following methods are available on all returned models:
+
+```php
+// Returns the model's 'name' attribute.
+$model->getName();
+
+// Returns the model's 'cn' attribute.
+$model->getCommonName();
+
+// Returns the model's 'displayname' attribute.
+$model->getDisplayName();
+
+// Returns the model's 'samaccountname' attriubte.
+$model->getAccountName();
+
+// Returns the model's 'samaccounttype` attribute.
+$model->getAccountType();
+
+// Returns the model's 'whencreated` attribute.
+$model->getCreatedAt();
+
+// Returns the model's 'whencreated` attribute in a MySQL timestamp format.
+$model->getCreatedAtDate();
+
+// Returns the model's 'whencreated' attribute in unix time.
+$model->getCreatedAtTimestamp();
+
+// Returns the model's 'whenchanged` attribute.
+$model->getUpdatedAt();
+
+// Returns the model's 'whenchanged` attribute in a MySQL timestamp format.
+$model->getUpdatedAtDate();
+
+// Returns the model's 'whenchanged` attribute in unix time.
+$model->getUpdatedAtTimestamp();
+
+// Returns the model's 'objectclass' attribute.
+$model->getObjectClass();
+
+// Returns the model's root object category string.
+$model->getObjectCategory();
+
+// Returns the model's object category in an array.
+$model->getObjectCategoryArray();
+
+// Returns the model's object category distinguished name.
+$model->getObjectCategoryDn();
+
+// Returns the model's SID in binary.
+$model->getObjectSid();
+
+// Returns the model's GUID in binary.
+$model->getObjectGuid();
+
+// Returns the model's SID in a string.
+$model->getConvertedSid();
+
+// Returns the model's GUID in a string.
+$model->getConvertedGuid();
+
+// Returns the model's primary group ID.
+$model->getPrimaryGroupId();
+
+// Returns the model's 'instancetype' attribute.
+$model->getInstanceType();
+
+// Returns the model's 'maxpwdage' attribute.
+$model->getMaxPasswordAge();
+```
+
+For more documentation on specific getters, please take a look at the relevant model documentation.
+
+#### Getting Dirty (Modified) Attributes
+
+You can get a models modified attributes using the `getDirty()` method:
+
+```php
+$user = $provider->search()->users()->find('john');
+
+// Returns array [0 => 'John Doe']
+var_dump($user->cn);
+
+$user->setAttribute('cn', 'Jane Doe');
+
+// Returns array ['cn' => [0 => 'Jane Doe']]
+var_dump($user->getDirty());
+
+// The attribute has been modified - returns array [0 => 'Jane Doe']
+var_dump($user->cn);
+```
+
+The method returns an array with the key being the modified attribute,
+and the array being the new values of the attribute.
+
+#### Getting Original (Unmodified) Attributes
+
+You can get a models original attributes using the `getOriginal()` method:
+
+```php
+$user = $provider->search()->users()->find('john');
+
+// Returns array [0 => 'John Doe']
+var_dump($user->cn);
+
+$user->setAttribute('cn', 'Jane Doe');
+
+// The attribute has been modified - returns array [0 => 'Jane Doe']
+var_dump($user->cn);
+
+// Retrieving the original value - returns array [0 => 'John Doe']
+var_dump($user->getOriginal()['cn']);
+```
+
+> **Note**: Keep in mind, when you `save()` a model, the models original
+> attributes will be re-synchronized to the models new attributes.
+
+### Setting Attributes
+
+Just like getting model attributes, there's multiple ways of setting attributes as well:
+
+```php
+// Setting via method:
+$user->setAttribute('cn', 'John Doe');
+
+// Specifying a subkey for overwriting specific attributes:
+$user->setAttribute('mail', 'other-mail@mail.com', 0);
+
+// Setting the first attribute:
+$user->setFirstAttribute('mail', 'jdoe@mail.com');
+
+// Setting via property:
+$user->cn = 'John Doe';
+
+// Mass setting attributes:
+$user->fill([
+ 'cn' => 'John Doe',
+ 'mail' => 'jdoe@mail.com',
+]);
+```
+
+#### Setting Boolean Attributes
+
+When setting boolean attribute values, you cannot use `0` / `1` / `true` / `false` as these
+are simply converted to integer values when saving and your LDAP server will
+likely return an error for doing so on certain attributes.
+
+You will need to use the string versions of the boolean (`'TRUE'` / `'FALSE'`) for the
+boolean attribute to be set properly on your LDAP server.
+
+Here's an example:
+
+```php
+$user->setFirstAttribute('msExchHideFromAddressLists', 'TRUE');
+
+$user->save();
+```
+
+### Creating Attributes
+
+To create an attribute that does not exist on the model, you can set it like a regular property:
+
+```php
+$user = $provider->search()->whereEquals('cn', 'John Doe')->firstOrFail();
+
+$user->new = 'New Attribute';
+
+$user->save();
+```
+
+If the set attribute does not exist on the model already,
+it will automatically be created when you call the `save()` method.
+
+If you'd like manually create new attributes individually, call the `createAttribute($attribute, $value)` method:
+
+```php
+if ($user->createAttribute('new', 'New Attribute')) {
+ // Attribute created.
+}
+```
+
+### Updating Attributes
+
+To modify an attribute you can either use a setter method, or by setting it manually:
+
+> **Note**: You can also utilize setters to create new attributes if your model does not already have the attribute.
+
+```php
+$user = $provider->search()->whereEquals('cn', 'John Doe')->firstOrFail();
+
+$user->cn = 'New Name';
+
+// Or use a setter:
+
+$user->setCommonName('New Name');
+
+$user->save();
+```
+
+If you'd like to update attributes individually, call the `updateAttribute($attribute, $value)` method:
+
+```php
+if ($user->updateAttribute('cn', 'New Name')) {
+ // Successfully updated attribute.
+}
+```
+
+### Removing Attributes
+
+To remove attributes, set the attribute to `NULL`:
+
+```php
+$user->cn = null;
+
+$user->save();
+```
+
+Or, you can call the `deleteAttribute($attribute)` method:
+
+```php
+if ($user->deleteAttribute('cn')) {
+ // Attribute has been deleted.
+}
+```
+
+### Checking Attributes
+
+#### Checking Existence of Attributes
+
+To see if a model contains an attribute, use the method `hasAttribute()`:
+
+```php
+// Checking if a base attribute exists:
+if ($user->hasAttribute('mail')) {
+ // This user contains an email address.
+}
+
+// Checking if a sub attribute exists, by key:
+if ($user->hasAttribute('mail', 1)) {
+ // This user contains a second email address.
+}
+```
+
+#### Counting the Models Attributes
+
+To retrieve the total number of attributes, use the method `countAttributes()`:
+
+```php
+$count = $user->countAttributes();
+
+var_dump($count); // Returns int
+```
+
+#### Checking if a Model is contained in an OU
+
+To check if a model is located inside an OU, use the `inOu()` method:
+
+```php
+if ($model->inOu('User Accounts')) {
+ // This model is inside the 'User Accounts' OU.
+}
+```
+
+You can also use an OU model instance:
+
+```php
+$serviceAccounts = $provider->search()->ous()->find('Service Accounts');
+
+if ($model->inOu($serviceAccounts)) {
+ // This model is inside the 'Service Accounts' OU.
+}
+```
+
+#### Checking if a Model is Writable
+
+To check if the model can be written to, use the method `isWritable()`:
+
+```php
+if ($model->isWritable()) {
+ // You can modify this model.
+}
+```
+
+### Force Re-Syncing A Models Attributes
+
+If you need to forcefully re-sync a models attributes, use the method `syncRaw()`:
+
+```php
+$user->syncRaw();
+```
+
+> **Note**: This will query your LDAP server for the current model, and re-synchronize
+> it's attributes. This is only recommended if your creating / updating / deleting
+> attributes manually through your LDAP connection.
+
+## Moving / Renaming
+
+To move a user from one DN or OU to another, use the `move()` method:
+
+> **Note**: The `move()` method is actually an alias for the `rename()` method.
+
+```php
+// New parent distiguished name.
+$newParentDn = 'OU=New Ou,DC=corp,DC=local';
+
+if ($user->move($newParentDn)) {
+ // User was successfully moved to the new OU.
+}
+```
+
+You can also provide a model to move the child model into:
+
+```php
+// New parent OU.
+$newParentOu = $provider->search()->ous()->find('Accounting');
+
+if ($user->move($newParentOu)) {
+ // User was successfully moved to the new OU.
+}
+```
+
+If you would like to keep the models old RDN along side their new RDN, pass in false in the second parameter:
+
+```php
+// New parent distiguished name.
+$newParentDn = 'OU=New Ou,DC=corp,DC=local';
+
+if ($user->move($newParentDn, $deleteOldRdn = false)) {
+ // User was successfully moved to the new OU,
+ // and their old RDN has been left in-tact.
+}
+```
+
+To rename a users DN, just pass in their new relative distinguished name in the `rename()` method:
+
+```php
+$newRdn = 'cn=New Name';
+
+if ($user->rename($newRdn)) {
+ // User was successfully renamed.
+}
+```
+
+## Deleting
+
+To delete a model, just call the `delete()` method:
+
+```php
+$user = $provider->search()->whereEquals('cn', 'John Doe')->firstOrFail();
+
+echo $user->exists; // Returns true.
+
+if ($user->delete()) {
+ // Successfully deleted user.
+
+ echo $user->exists; // Returns false.
+}
+```
+
+## Extending
+
+> **Note**: This feature was introduced in `v8.0.0`.
+
+To use your own models, you will need to create a new [Schema](../schema.md).
+
+Once you have created your own schema, you must insert it inside the construct of your provider.
+
+Let's walk through this process.
+
+First we'll create our model we'd like to extend / override:
+
+> **Note**: Your custom model **must** extend from an existing Adldap2 model.
+> This is due to methods and attributes that only exist on these classes.
+
+```php
+namespace App\Ldap\Models;
+
+use Adldap\Models\User as Model;
+
+class User extends Model
+{
+ public function getCommonName()
+ {
+ // Overriding model method.
+ }
+}
+```
+
+Now, we'll create our custom schema and return our models class name:
+
+```php
+namespace App\Ldap\Schemas;
+
+use App\Ldap\Models\User;
+
+class LdapSchema extends ActiveDirectory
+{
+ public function userModel()
+ {
+ return User::class;
+ }
+}
+```
+
+Finally, when we create a provider, we need to insert our Schema into the configuration:
+
+```php
+$config = [
+ 'hosts' => ['...'],
+
+ 'username' => 'admin',
+ 'password' => 'P@ssword',
+
+ 'schema' => MyApp\LdapSchema::class,
+];
+
+$ad = new Adldap($config);
+
+$provider = $ad->connect();
+
+// If `jdoe` exists, your custom model will be returned.
+$user = $provider->search()->users()->find('jdoe');
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/organization.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/organization.md
new file mode 100644
index 0000000..57c00e3
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/organization.md
@@ -0,0 +1,19 @@
+# The Organization Model
+
+The Organization model extends from the base `Adldap\Models\Model` class and contains
+no specific methods / attributes that are limited to it.
+
+## Creation
+
+```php
+// Adldap\Models\Organization
+$org = $provider->make()->organization([
+ 'o' => 'Some Company',
+]);
+
+// Set the DN manually:
+
+$org->setDn('o=Some Company,dc=test,dc=local,dc=com');
+
+$org->save();
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/ou.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/ou.md
new file mode 100644
index 0000000..ec473b1
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/ou.md
@@ -0,0 +1,27 @@
+# The OrganizationalUnit Model
+
+The OrganizationalUnit model extends from the base `Adldap\Models\Model` class and contains
+no specific methods / attributes that are limited to it.
+
+## Creation
+
+```php
+// Adldap\Models\OrganizationalUnit
+$ou = $provider->make()->ou([
+ 'name' => 'Workstation Computers',
+]);
+
+// Generate the OU's DN through the DN Builder:
+
+$dn = $ou->getDnBuilder();
+
+$dn->addOu('Workstation Computers');
+
+$ou->setDn($dn);
+
+// Or set the DN manually:
+
+$ou->setDn('ou=Workstation Computers,dc=test,dc=local,dc=com');
+
+$ou->save();
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/printer.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/printer.md
new file mode 100644
index 0000000..4adc666
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/printer.md
@@ -0,0 +1,49 @@
+# The Printer Model
+
+## Methods
+
+```php
+$printer->getPrinterName();
+
+$printer->getPrinterShareName();
+
+$printer->getMemory();
+
+$printer->getUrl();
+
+$printer->getLocation();
+
+$printer->getServerName();
+
+$printer->getColorSupported();
+
+$printer->getDuplexSupported();
+
+$printer->getMediaSupported();
+
+$printer->getStaplingSupported();
+
+$printer->getPrintBinNames();
+
+$printer->getPrintMaxResolution();
+
+$printer->getPrintOrientations();
+
+$printer->getDriverName();
+
+$printer->getDriverVersion();
+
+$printer->getPriority();
+
+$printer->getPrintStartTime();
+
+$printer->getPrintEndTime();
+
+$printer->getPortName();
+
+$printer->getVersionNumber();
+
+$printer->getPrintRate();
+
+$printer->getPrintRateUnit();
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/root-dse.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/root-dse.md
new file mode 100644
index 0000000..e798c0e
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/root-dse.md
@@ -0,0 +1,33 @@
+# The RootDse Model
+
+## Getting the Root DSE
+
+To get the Root DSE of your LDAP server, call the `getRootDse()` method off a new search:
+
+```php
+$rootDse = $provider->search()->getRootDse();
+```
+
+## Getting the schema naming context
+
+To get the Root DSE schema naming context, call the `getSchemaNamingContext()`:
+
+```php
+$rootDse = $provider->search()->getRootDse();
+
+$context = $rootDse->getSchemaNamingContext();
+
+// Returns 'cn=Schema,cn=Configuration,dc=corp,dc=acme,dc=org'
+echo $context;
+```
+
+## Getting the root domain naming context
+
+To get the Root DSE domain naming context, call the `getRootDomainNamingContext()`:
+
+```php
+$context = $rootDse->getRootDomainNamingContext();
+
+// Returns 'dc=corp,dc=acme,dc=org'
+echo $context;
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-critical-system-object.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-critical-system-object.md
new file mode 100644
index 0000000..095acad
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-critical-system-object.md
@@ -0,0 +1,13 @@
+# HasCriticalSystemObject Trait
+
+Models that contain this trait, have the `isCriticalSystemObject` attribute.
+
+There is only one method that accompanies this trait:
+
+```php
+if ($model->isCriticalSystemObject()) {
+
+ //
+
+}
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-description.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-description.md
new file mode 100644
index 0000000..5c26d02
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-description.md
@@ -0,0 +1,11 @@
+# HasDescription Trait
+
+Models that contain this trait, have the `description` attribute.
+
+There are only two methods that accompany this trait:
+
+```php
+$model->getDescription();
+
+$model->setDescription('The models description');
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-last-login-last-logoff.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-last-login-last-logoff.md
new file mode 100644
index 0000000..76078c5
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-last-login-last-logoff.md
@@ -0,0 +1,16 @@
+# HasLastLoginAndLastLogoff Trait
+
+Models that contain this trait have the `lastlogoff`, `lastlogon` and `lastlogontimestamp` attributes.
+
+## Methods
+
+```php
+// Returns the models's last log off attribute.
+$computer->getLastLogOff();
+
+// Returns the models's last log on attribute.
+$computer->getLastLogon();
+
+// Returns the models's last log on timestamp attribute.
+$computer->getLastLogonTimestamp();
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-member-of.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-member-of.md
new file mode 100644
index 0000000..d3063df
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/traits/has-member-of.md
@@ -0,0 +1,166 @@
+# HasMemberOf Trait
+
+Models that contain this trait, have the ability to be apart of a group.
+
+There's many helpful methods to assist you in all of the operations related to group membership, let's get started!
+
+## Retrieving Groups
+
+To retrieve the groups that a model is apart of, call the `getGroups()` method:
+
+```php
+$user = $provider->search()->users()->find('jdoe');
+
+$groups = $user->getGroups();
+
+foreach ($groups as $group) {
+
+ $group->getCommonName(); // ex. 'Accounting'
+
+}
+```
+
+We can also pass in specific fields we need from the returned groups to speed up our queries.
+
+For example, if we only need the groups common name:
+
+```php
+// Group models will be returned with only their common name.
+$groups = $user->getGroups(['cn']);
+```
+
+However, calling `getGroups()` will only retrieve the models immediate groups (non-recursive).
+
+To retrieve nested groups, pass in `true` into the second parameter:
+
+```php
+$groups = $user->getGroups([], $recursive = true);
+```
+
+## Retrieve Group Names
+
+If you only want the models group names, call the `getGroupNames()` method:
+
+```php
+$names = $user->getGroupNames();
+
+foreach ($names as $name) {
+
+ echo $name; // ex. 'Accounting'
+
+}
+```
+
+However, this method will also retrieve only the immediate groups names
+much like the `getGroups()` method. You'll need to pass in `true` in
+the first parameter to retrieve results recursively.
+
+```php
+$names = $user->getGroupNames($recursive = true);
+```
+
+## Checking if the Model is apart of a Group
+
+To check if a model is apart of a certain group, use the `inGroup()` method:
+
+```php
+$group = $provider->search()->groups()->find('Office');
+
+if ($user->inGroup($group)) {
+
+ //
+
+}
+```
+
+You can also check for multiple memberships by passing in an array of groups:
+
+```php
+$groups = $provider->search()->findManyBy('cn', ['Accounting', 'Office']));
+
+if ($user->inGroup($groups->toArray()) {
+
+ // This user is apart of the 'Accounting' and 'Office' group!
+
+}
+```
+
+> **Note**: Much like the other methods above, you'll need to provide a `$recursive`
+> flag to the `inGroup()` method if you'd like recursive results included.
+
+We can also provide distinguished names instead of Group model instances:
+
+```php
+$dns = [
+ 'cn=Accounting,ou=Groups,dc=acme,dc=org',
+ 'cn=Office,ou=Groups,dc=acme,dc=org',
+];
+
+if ($user->inGroup($dns, $recursive = true)) {
+
+ //
+
+}
+```
+
+Or, we can also just provide the name(s) of the group(s).
+
+```php
+$names = [
+ 'Accounting',
+ 'Office',
+];
+
+if ($user->inGroup($names, $recursive = true)) {
+
+ //
+
+}
+```
+
+## Adding a Group
+
+To add the model to a specific group, call the `addGroup()` method:
+
+```php
+$group = $provider->search()->groups()->find('Accounting');
+
+// You can either provide a Group model:
+if ($user->addGroup($group)) {
+
+ //
+
+}
+
+// Or a Groups DN:
+if ($user->addGroup('cn=Accounting,ou=Groups,dc=acme,dc=org')) {
+
+ //
+
+}
+```
+
+> **Note**: You do not need to call the `save()` method for adding / removing groups.
+> This is done automatically so you can perform clean `if` statements on the method.
+
+## Removing a Group
+
+To remove the model from a specific group, call the `removeGroup()` method:
+
+```php
+$group = $user->getGroups()->first();
+
+// You can either provide a Group model:
+if ($user->removeGroup($group)) {
+
+ //
+
+}
+
+// Or the groups DN:
+if ($user->removeGroup('cn=Accounting,ou=Office Groups,dc=acme,dc=org')) {
+
+ //
+
+}
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/user.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/user.md
new file mode 100644
index 0000000..65576e8
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/models/user.md
@@ -0,0 +1,180 @@
+# The User Model
+
+> **Note**: This model contains the trait `HasMemberOf`. For more information, visit the documentation:
+> [HasMemberOfTrait](/models/traits/has-member-of.md)
+
+## Creating
+
+> **Note**: If you need to create users with passwords, SSL or TLS **must** be enabled on your configured connection.
+>
+> The password you enter for the user **must** also obey your LDAP servers password requirements,
+> otherwise you will receive a "Server is unwilling to perform" LDAP exception upon saving.
+
+```php
+// Construct a new User model instance.
+$user = $provider->make()->user();
+
+// Create the users distinguished name.
+// We're adding an OU onto the users base DN to have it be saved in the specified OU.
+$dn = $user->getDnBuilder()->addOu('Users'); // Built DN will be: "CN=John Doe,OU=Users,DC=acme,DC=org";
+
+// Set the users DN, account name.
+$user->setDn($dn);
+$user->setAccountName('jdoe');
+$user->setCommonName('John Doe');
+
+// Set the users password.
+// NOTE: This password must obey your AD servers password requirements
+// (including password history, length, special characters etc.)
+// otherwise saving will fail and you will receive an
+// "LDAP Server is unwilling to perform" message.
+$user->setPassword('correct-horse-battery-staple');
+
+// Get a new account control object for the user.
+$ac = $user->getUserAccountControlObject();
+
+// Mark the account as enabled (normal).
+$ac->accountIsNormal();
+
+// Set the account control on the user and save it.
+$user->setUserAccountControl($ac);
+
+// Save the user.
+$user->save();
+
+// All done! An enabled user will be created and is ready for use.
+```
+
+## Methods
+
+There's a ton of available methods for the User model. Below is a list for a quick reference.
+
+> **Note**: Don't see a method for an LDAP attribute? Create an issue and let us know!
+
+```php
+// Get the users display name.
+$user->getDisplayName();
+
+// Get the users first email address.
+$user->getEmail();
+
+// Get the users title.
+$user->getTitle();
+
+// Get the users department.
+$user->getDepartment();
+
+// Get the users first name.
+$user->getFirstName();
+
+// Get the users last name.
+$user->getLastName();
+
+// Get the users info.
+$user->getInfo();
+
+// Get the users initials.
+$user->getInitials();
+
+// Get the users country.
+$user->getCountry();
+
+// Get the users street address.
+$user->getStreetAddress();
+
+// Get the users postal code.
+$user->getPostalCode();
+
+// Get the users physical delivery office name.
+$user->getPhysicalDeliveryOfficeName();
+
+// Get the users phone number.
+$user->getTelephoneNumber();
+
+// Get the users locale.
+$user->getLocale();
+
+// Get the users company.
+$user->getCompany();
+
+// Get the users other email addresses.
+$user->getOtherMailbox();
+
+// Get the users home mailbox database location (stored as a distinguished name).
+$user->getHomeMdb();
+
+// Get the users email nickname.
+$user->getMailNickname();
+
+// Get the users principal name.
+$user->getUserPrincipalName();
+
+// Get the users proxy email addresses.
+$user->getProxyAddresses();
+
+// Get the users failed login attempts.
+$user->getBadPasswordCount();
+
+// Get the users last failed login attempt timestamp.
+$user->getBadPasswordTime();
+
+// Get the users last password change timestamp.
+$user->getPasswordLastSet();
+
+// Get the users last password change timestamp in unix time.
+$user->getPasswordLastSetTimestamp();
+
+// Get the users last password change timestamp in MySQL date format.
+$user->getPasswordLastSetDate();
+
+// Get the users lockout time.
+$user->getLockoutTime();
+
+// Get the users user account control integer.
+$user->getUserAccountControl();
+
+// Get the users roaming profile path.
+$user->getProfilePath();
+
+// Get the users legacy exchange distinguished name.
+$user->getLegacyExchangeDn();
+
+// Get the users account expiry timestamp.
+$user->getAccountExpiry();
+
+// Get the boolean that determines whether to show this user in the global address book.
+$user->getShowInAddressBook();
+
+// Get the users thumbnail photo.
+$user->getThumbnail();
+
+// Get the users thumbnail photo (base64 encoded for HTML <img src=""> tags).
+$user->getThumbnailEncoded();
+
+// Get the users jpeg photo.
+$user->getJpegPhoto();
+
+// Get the users jpeg photo (base64 encoded for HTML <img src=""> tags).
+$user->getJpegPhotoEncoded();
+
+// Get the users manager.
+$user->getManager();
+
+// Get the users employee ID.
+$user->getEmployeeId();
+
+// Get the users employee number.
+$user->getEmployeeNumber();
+
+// Get the users employee type
+$user->getEmployeeType();
+
+// Get the users room number.
+$user->getRoomNumber();
+
+// Get the users department number.
+$user->getDepartmentNumber();
+
+// Get the users personal title.
+$user->getPersonalTitle();
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/readme.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/readme.md
new file mode 100644
index 0000000..00eaab7
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/readme.md
@@ -0,0 +1,115 @@
+# Introduction
+
+## What is Adldap2?
+
+Adldap2 is a PHP LDAP package that allows you to:
+
+1. Easily manage multiple LDAP connections at once
+2. Perform authentication
+3. Search your LDAP directory with a fluent and easy to use query builder
+4. Create / Update / Delete LDAP entities with ease
+5. And more
+
+## History of Adldap2
+
+Adldap2 was originally created as a fork of the original LDAP library [adLDAP](https://github.com/adldap/adLDAP) due to bugs, and it being completely abandoned.
+
+Adldap2 contains absolutely no similarities to the original repository, and was built to be as easily accessible as possible, with great documentation, and easily understandable syntax.
+
+Much of the API was constructed with Ruby's ActiveRecord and Laravel's Eloquent in mind, and to be an answer to the question:
+
+> _Why can't we use LDAP like we use a database?_
+
+## Why should you use Adldap2?
+
+Working with LDAP in PHP can be a messy and confusing endeavor, especially when using multiple connections, creating and managing entities, performing moves, resetting passwords, and performing ACL modifications to user accounts.
+
+Wrapper classes for LDAP are usually always created in PHP applications.
+
+Adldap2 allows you to easily manage the above problems without reinventing the wheel for every project.
+
+## Implementations
+
+- [Laravel](https://github.com/Adldap2/Adldap2-Laravel)
+
+## Quick Start
+
+Install the package via `composer`:
+
+```
+composer require adldap2/adldap2
+```
+
+Use Adldap2:
+
+```php
+// Construct new Adldap instance.
+$ad = new \Adldap\Adldap();
+
+// Create a configuration array.
+$config = [
+ // An array of your LDAP hosts. You can use either
+ // the host name or the IP address of your host.
+ 'hosts' => ['ACME-DC01.corp.acme.org', '192.168.1.1'],
+
+ // The base distinguished name of your domain to perform searches upon.
+ 'base_dn' => 'dc=corp,dc=acme,dc=org',
+
+ // The account to use for querying / modifying LDAP records. This
+ // does not need to be an admin account. This can also
+ // be a full distinguished name of the user account.
+ 'username' => 'admin@corp.acme.org',
+ 'password' => 'password',
+];
+
+// Add a connection provider to Adldap.
+$ad->addProvider($config);
+
+try {
+ // If a successful connection is made to your server, the provider will be returned.
+ $provider = $ad->connect();
+
+ // Performing a query.
+ $results = $provider->search()->where('cn', '=', 'John Doe')->get();
+
+ // Finding a record.
+ $user = $provider->search()->find('jdoe');
+
+ // Creating a new LDAP entry. You can pass in attributes into the make methods.
+ $user = $provider->make()->user([
+ 'cn' => 'John Doe',
+ 'title' => 'Accountant',
+ 'description' => 'User Account',
+ ]);
+
+ // Setting a model's attribute.
+ $user->cn = 'John Doe';
+
+ // Saving the changes to your LDAP server.
+ if ($user->save()) {
+ // User was saved!
+ }
+} catch (\Adldap\Auth\BindException $e) {
+
+ // There was an issue binding / connecting to the server.
+
+}
+```
+
+## Versioning
+
+Adldap2 is versioned under the [Semantic Versioning](http://semver.org/) guidelines as much as possible.
+
+Releases will be numbered with the following format:
+
+`<major>.<minor>.<patch>`
+
+And constructed with the following guidelines:
+
+* Breaking backward compatibility bumps the major and resets the minor and patch.
+* New additions without breaking backward compatibility bumps the minor and resets the patch.
+* Bug fixes and misc changes bumps the patch.
+
+Minor versions are not maintained individually, and you're encouraged to upgrade through to the next minor version.
+
+Major versions are maintained individually through separate branches.
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/searching.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/searching.md
new file mode 100644
index 0000000..2837767
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/searching.md
@@ -0,0 +1,662 @@
+# Searching
+
+## Introduction
+
+Using the Adldap2 query builder makes building LDAP queries feel effortless.
+
+It allows you to generate LDAP filters using a fluent and
+convenient interface, similar to Eloquent in Laravel.
+
+> **Note:** The Adldap2 query builder escapes all fields & values
+> given to its `where()` methods. There is no need to clean or
+> escape strings before passing them into the query builder.
+
+## Creating a new Query
+
+To create a new search query, call the `search()` method on your connection provider instance:
+
+```php
+$search = $provider->search();
+```
+
+Or you can chain all your methods if you'd prefer:
+
+```php
+$results = $provider->search()->where('cn', '=', 'John Doe')->get();
+```
+
+## Selects
+
+> **Note:** Fields are case in-sensitive. For example, you can
+> insert `CN`, `cn` or `cN`, they will return the same result.
+
+#### Selecting attributes
+
+Selecting only the LDAP attributes you need will increase the speed of your queries.
+
+```php
+// Passing in an array of attributes
+$search->select(['cn', 'samaccountname', 'telephone', 'mail']);
+
+// Passing in each attribute as an argument
+$search->select('cn', 'samaccountname', 'telephone', 'mail');
+```
+
+## Executing Searches
+
+#### Finding a specific record
+
+If you're trying to find a single record, but not sure what the record might be, use the `find()` method:
+
+```php
+$record = $search->find('John Doe');
+
+if ($record) {
+ // Record was found!
+} else {
+ // Hmm, looks like we couldn't find anything...
+}
+```
+
+> **Note**: Using the `find()` method will search for LDAP records using ANR
+> (ambiguous name resolution) and return the first result.
+>
+> Since ActiveDirectory is the only LDAP distribution that supports ANR,
+> an equivalent query will be created for other LDAP distributions
+> that are not compatible.
+>
+> For a more fine-tuned search, use the `findBy()` method below.
+
+##### Finding a record (or failing)
+
+If you'd like to try and find a single record and throw an exception when it hasn't been
+found, use the `findOrFail()` method:
+
+```php
+try {
+
+ $record = $search->findOrFail('John Doe');
+
+} catch (Adldap\Models\ModelNotFoundException $e) {
+ // Record wasn't found!
+}
+```
+
+#### Finding a record by a specific attribute
+
+If you're looking for a single record with a specific attribute, use the `findBy()` method:
+
+```php
+// We're looking for a record with the 'samaccountname' of 'jdoe'.
+$record = $search->findBy('samaccountname', 'jdoe');
+```
+
+##### Finding a record by a specific attribute (or failing)
+
+If you'd like to try and find a single record by a specific attribute and throw
+an exception when it cannot be found, use the `findByOrFail()` method:
+
+```php
+try {
+
+ $record = $search->findByOrFail('samaccountname', 'jdoe');
+
+} catch (Adldap\Models\ModelNotFoundException $e) {
+ // Record wasn't found!
+}
+```
+
+#### Finding a record by its distinguished name
+
+If you're looking for a single record with a specific DN, use the `findByDn()` method:
+
+```php
+$record = $search->findByDn('cn=John Doe,dc=corp,dc=org');
+```
+
+###### Finding a record by its distinguished name (or failing)
+
+If you'd like to try and find a single record by a specific DN and throw
+an exception when it hasn't been found, use the `findByDnOrFail()` method:
+
+```php
+try {
+
+ $record = $search->findByDnOrFail('cn=John Doe,dc=corp,dc=org');
+
+} catch (Adldap\Models\ModelNotFoundException $e) {
+ // Record wasn't found!
+}
+```
+
+#### Retrieving results
+
+To get the results from a search, simply call the `get()` method:
+
+```php
+$results = $search->select(['cn', 'samaccountname'])->get();
+```
+
+> **Note**: Executed searches via the `get()` method will return them inside an
+> `Illuminate\Support\Collection` instance (a glorified array), with allows
+> you to utilize [some extremely handy methods](https://laravel.com/docs/collections).
+>
+> Executed searches via the `first()` method will return **a model instance only**.
+
+##### Retrieving the first record
+
+To retrieve the first record of a search, call the `first()` method:
+
+```php
+$record = $search->first();
+```
+
+> **Note**: If you are using `sortBy()`, calling `first()` will not take this into account. Sorts
+> are performed **after** retrieving query results. If you would like the first record of
+> a sorted result set, call `first()` on a `Collection` of returned models.
+
+###### Retrieving the first record (or failing)
+
+To retrieve the first record of a search or throw an exception when one isn't found, call the `firstOrFail()` method:
+
+```php
+try {
+
+ $record = $search->firstOrFail();
+
+} catch (Adldap\Models\ModelNotFoundException $e) {
+ // Record wasn't found!
+}
+```
+
+## Limit
+
+To limit the results records returned from your LDAP server and increase the
+speed of your queries, you can use the `limit()` method:
+
+```php
+// This will only return 5 records that contain the name of 'John':
+$records = $search->where('cn', 'contains', 'John')->limit(5)->get();
+```
+
+## Wheres
+
+To perform a where clause on the search object, use the `where()` function:
+
+```php
+$search->where('cn', '=', 'John Doe');
+```
+
+This query would look for a record with the common name of 'John Doe' and return the results.
+
+We can also perform a 'where equals' without including the operator:
+
+```php
+$search->whereEquals('cn', 'John Doe');
+```
+
+We can also supply an array of key - value pairs to quickly add multiple wheres:
+
+```php
+$wheres = [
+ 'cn' => 'John Doe',
+ 'samaccountname' => 'jdoe',
+];
+
+$search->where($wheres);
+```
+
+Or, if you require conditionals, you can quickly add multiple wheres with nested arrays:
+
+```php
+$search->where([
+ ['cn', '=', 'John Doe'],
+ ['manager', '!', 'Suzy Doe'],
+]);
+```
+
+#### Where Starts With
+
+We could also perform a search for all objects beginning with the common name of 'John' using the `starts_with` operator:
+
+```php
+$results = $provider->search()->where('cn', 'starts_with', 'John')->get();
+
+// Or use the method whereStartsWith($attribute, $value):
+
+$results = $provider->search()->whereStartsWith('cn', 'John')->get();
+```
+
+#### Where Ends With
+
+We can also search for all objects that end with the common name of `Doe` using the `ends_with` operator:
+
+```php
+$results = $provider->search()->where('cn', 'ends_with', 'Doe')->get();
+
+// Or use the method whereEndsWith($attribute, $value):
+
+$results = $provider->search()->whereEndsWith('cn', 'Doe')->get();
+```
+
+#### Where Between
+
+To search for records between two values, use the `whereBetween` method.
+
+For the example below, we'll retrieve all users who were created between two dates:
+
+```php
+$from = (new DateTime('October 1st 2016'))->format('YmdHis.0\Z');
+$to = (new DateTime('January 1st 2017'))->format('YmdHis.0\Z');
+
+$users = $provider->search()
+ ->users()
+ ->whereBetween('whencreated', [$from, $to])
+ ->get();
+```
+
+#### Where Contains
+
+We can also search for all objects with a common name that contains `John Doe` using the `contains` operator:
+
+```php
+$results = $provider->search()->where('cn', 'contains', 'John Doe')->get();
+
+// Or use the method whereContains($attribute, $value):
+
+$results = $provider->search()->whereContains('cn', 'John Doe')->get();
+```
+
+##### Where Not Contains
+
+You can use a 'where not contains' to perform the inverse of a 'where contains':
+
+```php
+$results = $provider->search()->where('cn', 'not_contains', 'John Doe')->get();
+
+// Or use the method whereNotContains($attribute, $value):
+
+$results = $provider->search()->whereNotContains('cn', 'John Doe');
+```
+
+#### Where Has
+
+Or we can retrieve all objects that have a common name attribute using the wildcard operator (`*`):
+
+```php
+$results = $provider->search()->where('cn', '*')->get();
+
+// Or use the method whereHas($field):
+
+$results = $provider->search()->whereHas('cn')->get();
+```
+
+This type of filter syntax allows you to clearly see what your searching for.
+
+##### Where Not Has
+
+You can use a 'where not has' to perform the inverse of a 'where has':
+
+```php
+$results = $provider->search->where('cn', '!*')->get();
+
+// Or use the method whereNotHas($field):
+
+$results = $provider->search()->whereNotHas($field)->get();
+```
+
+## Or Wheres
+
+To perform an `or where` clause on the search object, use the `orWhere()` method. However,
+please be aware this function performs differently than it would on a database.
+
+For example:
+
+```php
+$results = $search
+ ->where('cn', '=', 'John Doe')
+ ->orWhere('cn', '=', 'Suzy Doe')
+ ->get();
+```
+
+This query would return no results. Since we're already defining that the common name (`cn`) must equal `John Doe`, applying
+the `orWhere()` does not amount to 'Look for an object with the common name as "John Doe" OR "Suzy Doe"'. This query would
+actually amount to 'Look for an object with the common name that <b>equals</b> "John Doe" OR "Suzy Doe"
+
+To solve the above problem, we would use `orWhere()` for both fields. For example:
+
+```php
+$results = $search
+ ->orWhere('cn', '=', 'John Doe')
+ ->orWhere('cn', '=', 'Suzy Doe')
+ ->get();
+```
+
+Now, we'll retrieve both John and Suzy's LDAP records, because the common name can equal either.
+
+> **Note**: You can also use all `where` methods as an or where, for example:
+> `orWhereHas()`, `orWhereContains()`, `orWhereStartsWith()`, `orWhereEndsWith()`
+
+## Dynamic Wheres
+
+To perform a dynamic where, simply suffix a `where` with the field you're looking for.
+
+This feature was directly ported from Laravel's Eloquent.
+
+Here's an example:
+
+```php
+// This query:
+$result = $search->where('cn', '=', 'John Doe')->first();
+
+// Can be converted to:
+$result = $search->whereCn('John Doe')->first();
+```
+
+You can perform this on **any** attribute:
+
+```php
+$result = $search->whereTelephonenumber('555-555-5555')->first();
+```
+
+You can also chain them:
+
+```php
+$result = $search
+ ->whereTelephonenumber('555-555-5555')
+ ->whereGivenname('John Doe')
+ ->whereSn('Doe')
+ ->first();
+```
+
+You can even perform multiple dynamic wheres by separating your fields by an `And`:
+
+```php
+// This would perform a search for a user with the
+// first name of 'John' and last name of 'Doe'.
+$result = $search->whereGivennameAndSn('John', 'Doe')->first();
+```
+
+## Nested Filters
+
+By default, the Adldap2 query builder automatically wraps your queries in `and` / `or` filters for you.
+However, if any further complexity is required, nested filters allow you
+to construct any query fluently and easily.
+
+#### andFilter
+
+The `andFilter` method accepts a closure which allows you to construct a query inside of an `and` LDAP filter:
+
+```php
+$query = $provider->search()->newQuery();
+
+// Creates the filter: (&(givenname=John)(sn=Doe))
+$results = $query->andFilter(function (Adldap\Query\Builder $q) {
+
+ $q->where('givenname', '=', 'John')
+ ->where('sn', '=', 'Doe');
+
+})->get();
+```
+
+The above query would return records that contain the first name `John` **and** the last name `Doe`.
+
+#### orFilter
+
+The `orFilter` method accepts a closure which allows you to construct a query inside of an `or` LDAP filter:
+
+```php
+$query = $provider->search()->newQuery();
+
+
+// Creates the filter: (|(givenname=John)(sn=Doe))
+$results = $query->orFilter(function (Adldap\Query\Builder $q) {
+
+ $q->where('givenname', '=', 'John')
+ ->where('sn', '=', 'Doe');
+
+})->get();
+```
+
+The above query would return records that contain the first name `John` **or** the last name `Doe`.
+
+#### notFilter
+
+The `notFilter` method accepts a closure which allows you to construct a query inside a `not` LDAP filter:
+
+```php
+$query = $provider->search()->newQuery();
+
+// Creates the filter: (!(givenname=John)(sn=Doe))
+$results = $query->notFilter(function (Adldap\Query\Builder $q) {
+
+ $q->where('givenname', '=', 'John')
+ ->where('sn', '=', 'Doe');
+
+})->get();
+```
+
+The above query would return records that **do not** contain the first name `John` **or** the last name `Doe`.
+
+#### Complex Nesting
+
+The above methods `andFilter` / `orFilter` can be chained together and nested
+as many times as you'd like for larger complex queries:
+
+```php
+$query = $provider->search()->newQuery();
+
+$query = $query->orFilter(function (Adldap\Query\Builder $q) {
+ $q->where('givenname', '=', 'John')->where('sn', '=', 'Doe');
+})->andFilter(function (Adldap\Query\Builder $q) {
+ $q->where('department', '=', 'Accounting')->where('title', '=', 'Manager');
+})->getUnescapedQuery();
+
+echo $query; // Returns '(&(|(givenname=John)(sn=Doe))(&(department=Accounting)(title=Manager)))'
+```
+
+## Raw Filters
+
+> **Note**: Raw filters are not escaped. **Do not** accept user input into the raw filter method.
+
+Sometimes you might just want to add a raw filter without using the query builder.
+You can do so by using the `rawFilter()` method:
+
+```php
+$filter = '(samaccountname=jdoe)';
+
+$results = $search->rawFilter($filter)->get();
+
+// Or use an array
+$filters = [
+ '(samaccountname=jdoe)',
+ '(surname=Doe)',
+];
+
+$results = $search->rawFilter($filters)->get();
+
+// Or use multiple arguments
+$results = $search->rawFilter($filters[0], $filters[1])->get();
+
+// Multiple raw filters will be automatically wrapped into an `and` filter:
+$query = $search->getUnescapedQuery();
+
+echo $query; // Returns (&(samaccountname=jdoe)(surname=Doe))
+```
+
+## Sorting
+
+Sorting is really useful when your displaying tabular LDAP results. You can
+easily perform sorts on any LDAP attribute by using the `sortBy()` method:
+
+```php
+$results = $search->whereHas('cn')->sortBy('cn', 'asc')->get();
+```
+
+You can also sort paginated results:
+
+```php
+$results = $search->whereHas('cn')->sortBy('cn', 'asc')->paginate(25);
+```
+
+> **Note**: Sorting occurs *after* results are returned. This is due
+> to PHP not having the functionality of sorting records on
+> the server side before they are returned.
+
+## Paginating
+
+Paginating your search results will allow you to return more results than
+your LDAP cap (usually 1000) and display your results in pages.
+
+> **Note**: Calling `paginate()` will retrieve **all** records from your LDAP server for the current query.
+>
+> This **does not** operate the same way pagination occurs in a database. Pagination of
+> an LDAP query simply allows you to return a larger result set than your
+> LDAP servers configured maximum (usually 1000).
+>
+> The pagination object is simply a collection that allows you to iterate
+> through all the resulting records easily and intuitively.
+
+To perform this, call the `paginate()` method instead of the `get()` method:
+
+```php
+$recordsPerPage = 50;
+
+$currentPage = $_GET['page'];
+
+// This would retrieve all records from your LDAP server inside a new Adldap\Objects\Paginator instance.
+$paginator = $search->paginate($recordsPerPage, $currentPage);
+
+// Returns total number of pages, int
+$paginator->getPages();
+
+// Returns current page number, int
+$paginator->getCurrentPage();
+
+// Returns the amount of entries allowed per page, int
+$paginator->getPerPage();
+
+// Returns all of the results in the entire paginated result
+$paginator->getResults();
+
+// Returns the total amount of retrieved entries, int
+$paginator->count();
+
+// Iterate over the results like normal
+foreach($paginator as $result)
+{
+ echo $result->getCommonName();
+}
+```
+
+## Scopes
+
+Search scopes allow you to easily retrieve common models of a particular 'scope'.
+
+Each scope simply applies the required filters to the search object
+that (when executed) will only return the relevant models.
+
+Here is a list of all available scopes:
+
+```php
+// Retrieve all users (Adldap\Models\User).
+$results = $search->users()->get();
+
+// Retrieve all printers (Adldap\Models\Printer).
+$results = $search->printers()->get();
+
+// Retrieve all organizational units (Adldap\Models\OrganizationalUnit).
+$results = $search->ous()->get();
+
+// Retrieve all organizational units (Adldap\Models\OrganizationalUnit).
+$results = $search->organizations()->get();
+
+// Retrieve all groups (Adldap\Models\Group).
+$results = $search->groups()->get();
+
+// Retrieve all containers (Adldap\Models\Container).
+$results = $search->containers()->get();
+
+// Retrieve all contacts (Adldap\Models\Contact).
+$results = $search->contacts()->get();
+
+// Retrieve all computers (Adldap\Models\Computer).
+$results = $search->computers()->get();
+```
+
+## Base DN
+
+To set the base DN of your search you can use one of two methods:
+
+```php
+// Using the `in()` method:
+$results = $provider->search()->in('ou=Accounting,dc=acme,dc=org')->get();
+
+// Using the `setDn()` method:
+$results = $provider->search()->setDn('ou=Accounting,dc=acme,dc=org')->get();
+
+// You can also include `in()` with the scope
+$results = $provider->search()->organizations()->in('ou=Accounting,dc=acme,dc=org')->get()
+
+```
+
+Either option will return the same results. Use which ever method you prefer to be more readable.
+
+## Search Options
+
+#### Recursive
+
+By default, all searches performed are recursive.
+
+If you'd like to disable recursive search and perform a single level search, use the `listing()` method:
+
+```php
+$result = $provider->search()->listing()->get();
+```
+
+This would perform an `ldap_listing()` instead of an `ldap_search()`.
+
+#### Read
+
+If you'd like to perform a read instead of a listing or a recursive search, use the `read()` method:
+
+```php
+$result = $provider->search()->read()->where('objectClass', '*')->get();
+```
+
+This would perform an `ldap_read()` instead of an `ldap_listing()` or an `ldap_search()`.
+
+> **Note**: Performing a `read()` will always return *one* record in your result.
+
+#### Raw
+
+If you'd like to retrieve the raw LDAP results, use the `raw()` method:
+
+```php
+$rawResults = $provider->search()->raw()->where('cn', '=', 'John Doe')->get();
+
+var_dump($rawResults); // Returns an array
+```
+
+## Retrieving the ran query
+
+If you'd like to retrieve the current query to save or run it at another
+time, use the `getQuery()` method on the query builder.
+
+This will return the escaped filter.
+
+```php
+$query = $provider->search()->where('cn', '=', 'John Doe')->getQuery();
+
+echo $query; // Returns '(cn=\4a\6f\68\6e\20\44\6f\65)'
+```
+
+To retrieve the unescaped filter, call the `getUnescapedQuery()` method:
+
+```php
+$query = $provider->search()->where('cn', '=', 'John Doe')->getUnescapedQuery();
+
+echo $query; // Returns '(cn=John Doe)'
+```
+
+Now that you know how to search your directory, lets move onto [creating / modifying LDAP records](models/model.md).
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/setup.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/setup.md
new file mode 100644
index 0000000..312165c
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/setup.md
@@ -0,0 +1,552 @@
+# Setup
+
+## Configuration
+
+To configure your LDAP connections, you can use two methods:
+
+1. Using an array
+2. Using a `Adldap\Configuration\DomainConfiguration` object
+
+Either or will produce the same results. Use whichever you feel most comfortable with.
+
+### Using an array
+
+```php
+$config = [
+ 'hosts' => [
+ 'DC-01.corp.acme.org',
+ ],
+ '...'
+];
+```
+
+### Using a `DomainConfiguration` object
+
+```php
+// Setting options via first argument:
+$config = new Adldap\Configuration\DomainConfiguration([
+ 'hosts' => [
+ 'DC-01.corp.acme.org',
+ ],
+]);
+
+// Setting via the `set()` method:
+$config->set('hosts', [
+ 'DC-01.corp.acme.org',
+]);
+```
+
+### Options
+
+#### Array Example With All Options
+
+```php
+// Create the configuration array.
+$config = [
+ // Mandatory Configuration Options
+ 'hosts' => ['corp-dc1.corp.acme.org', 'corp-dc2.corp.acme.org'],
+ 'base_dn' => 'dc=corp,dc=acme,dc=org',
+ 'username' => 'admin',
+ 'password' => 'password',
+
+ // Optional Configuration Options
+ 'schema' => Adldap\Schemas\ActiveDirectory::class,
+ 'account_prefix' => 'ACME-',
+ 'account_suffix' => '@acme.org',
+ 'port' => 389,
+ 'follow_referrals' => false,
+ 'use_ssl' => false,
+ 'use_tls' => false,
+ 'version' => 3,
+ 'timeout' => 5,
+
+ // Custom LDAP Options
+ 'custom_options' => [
+ // See: http://php.net/ldap_set_option
+ LDAP_OPT_X_TLS_REQUIRE_CERT => LDAP_OPT_X_TLS_HARD
+ ]
+];
+```
+
+#### Required Options
+
+##### Hosts
+
+The hosts option is an array of IP addresses or hostnames located
+on your network that serve Active Directory.
+
+You insert as many servers or as little as you'd like depending on your forest (with the minimum of one of course).
+
+> **Note:** Do not append your port to your IP addresses or hostnames. Use the `port` configuration option instead.
+
+##### Base Distinguished Name
+
+The base distinguished name is the base distinguished name you'd like to perform operations on.
+
+An example base DN would be `DC=corp,DC=acme,DC=org`.
+
+If one is not defined, you will not retrieve any search results.
+
+> **Note**: Your base DN is **case insensitive**. You do not need to worry about incorrect casing.
+
+##### Username & Password
+
+To connect to your LDAP server, a username and password is required to be able to query and run operations on your server(s).
+
+You can use any account that has these permissions.
+
+> **Note**: To run administration level operations, such as resetting passwords,
+> this account **must** have permissions to do so on your directory.
+
+#### Optional Options
+
+##### Schema
+
+The schema option allows you to configure which directory you're connecting to.
+
+This is a somewhat optional, however this **must** be changed if you're connecting
+to an alternate LDAP variant such as OpenLDAP or FreeIPA.
+
+Below are available schemas:
+
+- `Adldap\Schemas\ActiveDirectory`
+- `Adldap\Schemas\OpenLDAP`
+- `Adldap\Schemas\FreeIPA`
+
+By default, this option is set to the `Adldap\Schemas\ActiveDirectory` schema.
+
+##### Account Prefix
+
+The account prefix option is a string to *prepend* to all usernames that go through the `Guard::attempt()` method.
+
+This option is just for convenience.
+
+It is usually not needed (if utilizing the account suffix), however the functionality is
+in place if you would like to only allow certain users with the specified prefix
+to login, or add a domain so your users do not have to specify one.
+
+##### Account Suffix
+
+The account suffix option is a string to *append* to all usernames that go
+through the `Adldap\Auth\Guard::attempt()` method.
+
+This option is just for convenience.
+
+An example use case for this would be inserting your LDAP users `userPrincipalName` suffix so you don't need to append it manually.
+
+For example, with a `account_suffix` in your configuration set to `@corp.acme.org`:
+
+```php
+$username = 'jdoe';
+$password = 'password';
+
+// Here, an `ldap_bind()` will be called with a username of 'jdoe@corp.acme.org`
+$provider->auth()->attempt($username, $password);
+```
+
+##### Port
+
+The port option is used for authenticating and binding to your LDAP server.
+
+The default ports are already used for non SSL and SSL connections (389 and 636).
+
+Only insert a port if your LDAP server uses a unique port.
+
+##### Follow Referrals
+
+The follow referrals option is a boolean to tell active directory to follow a referral to another server on your network if the server queried knows the information your asking for exists, but does not yet contain a copy of it locally.
+
+This option is defaulted to false.
+
+Disable this option if you're experiencing search / connectivity issues.
+
+For more information, visit: https://technet.microsoft.com/en-us/library/cc978014.aspx
+
+##### SSL & TLS
+
+These Boolean options enable an SSL or TLS connection to your LDAP server.
+
+Only **one** can be set to `true`. You must chose either or.
+
+> **Note**: You **must** enable SSL or TLS to reset passwords in ActiveDirectory.
+
+These options are definitely recommended if you have the ability to connect to your server securely.
+
+> **Note**: TLS is recommended over SSL, as SSL is now labelled as a depreciated mechanism for securely running LDAP operations.
+
+##### Version
+
+The LDAP version to use for your connection.
+
+Must be an integer and can either be `2` or `3`.
+
+##### Timeout
+
+The timeout option allows you to configure the amount of seconds to wait until
+your application receives a response from your LDAP server.
+
+The default is 5 seconds.
+
+##### Custom Options
+
+Arbitrary options can be set for the connection to fine-tune TLS and connection behavior.
+
+Please note that `LDAP_OPT_PROTOCOL_VERSION`, `LDAP_OPT_NETWORK_TIMEOUT` and `LDAP_OPT_REFERRALS` will be ignored if set.
+
+These are set above with the `version`, `timeout` and `follow_referrals` keys respectively.
+
+Valid options are listed in the [PHP documentation for ldap_set_option](http://php.net/ldap_set_option).
+
+## Getting Started
+
+Each LDAP connection you have will be contained inside the `Adldap` instance as its own **connection provider**.
+
+There are a couple of ways you can easily add each of your LDAP connections. Let's walk through them:
+
+**Using a configuration array:**
+```php
+$config = ['...'];
+
+$ad = new Adldap\Adldap();
+
+$ad->addProvider($config);
+
+// You can also specify the name of the
+// connection as the second argument:
+$ad->addProvider($config, 'connection-one');
+```
+
+**Using a DomainConfiguration object:**
+```php
+$ad = new Adldap\Adldap();
+
+$config = new Adldap\Configuration\DomainConfiguration(['...']);
+
+$ad->addProvider($config, 'connection-one');
+```
+
+**Using the constructor:**
+
+> **Note**: When inserting your configuration into a new `Adldap` instance, you
+> need to set a key for each connection. **This will be its connection name**.
+
+```php
+$connections = [
+ 'connection1' => [
+ 'hosts' => ['...'],
+ ],
+ 'connection2' => [
+ 'hosts' => ['...'],
+ ],
+];
+
+$ad = new Adldap\Adldap($connections);
+```
+
+## Connecting
+
+The easiest way to get connected is to call the `connect($name)` method on your `Adldap` instance.
+
+Its first argument accepts the name of your configured connection.
+
+This method will return you a connected **connection provider** when
+successful, and throw an exception when unsuccessful:
+
+```php
+$ad = new Adldap\Adldap();
+
+$config = ['...'];
+
+$connectionName = 'my-connection';
+
+$ad->addProvider($config, $connectionName);
+
+try {
+ $provider = $ad->connect($connectionName);
+
+ // Great, we're connected!
+} catch (Adldap\Auth\BindException $e) {
+ // Failed to connect.
+}
+```
+
+### Using an alternate username / password
+
+If you'd like to connect to your configured connection using a different username and password than your configuration, then simply provide them in the second and third arguments:
+
+```php
+$username = 'server-admin';
+$password = 'my-super-secret-password';
+
+$provider = $ad->connect($connectionName, $username, $password);
+```
+
+### Dynamically Connecting
+
+If you're like me and like chainable (fluent) API's in PHP, then dynamically connecting is a nice option to have.
+
+To dynamically connect, simply call any connection provider method on your `Adldap` instance.
+
+> **Note**: Your default connection will be used when dynamically connecting.
+> More on this below.
+
+Here's an example:
+
+```php
+$ad = new Adldap\Adldap();
+
+$ad->addProvider($config = ['...']);
+
+try {
+ $users = $ad->search()->users()->get();
+} catch (Adldap\Auth\BindException $e) {
+ // Failed to connect.
+}
+```
+
+### Anonymously Binding
+
+If you'd like to anonymously bind, set your `username` and `password` configuration to `null`:
+
+```php
+$ad = new Adldap\Adldap();
+
+$config = [
+ 'username' => null,
+ 'password' => null,
+];
+
+$ad->addProvider($config);
+
+try {
+ $provider = $ad->connect();
+
+ // ...
+} catch (BindException $e) {
+ // Failed.
+}
+```
+
+Or, manually bind your provider and don't pass in a `username` or `password` parameter:
+
+```php
+$config = [
+ 'hosts' => ['...'],
+];
+
+$ad->addProvider($config);
+
+$provider = $ad->getDefaultProvider();
+
+try {
+ $provider->auth()->bind();
+
+ // Successfully bound.
+} catch (BindException $e) {
+ // Failed.
+}
+```
+
+### Setting a Default Connection
+
+Setting a default LDAP connection is used for dynamically connecting.
+
+To set your default connection, call the `setDefaultProvider($name)` method:
+
+```php
+$ad->setDefaultProvider('my-connection');
+
+$computers = $ad->search()->computers()->get();
+```
+
+## Authenticating
+
+If you're looking to authenticate (bind) users using your LDAP connection, call
+the `auth()->attempt()` method on your provider instance:
+
+```php
+$username = 'jdoe';
+$password = 'Password@1';
+
+try {
+ if ($provider->auth()->attempt($username, $password)) {
+ // Passed.
+ } else {
+ // Failed.
+ }
+} catch (Adldap\Auth\UsernameRequiredException $e) {
+ // The user didn't supply a username.
+} catch (Adldap\Auth\PasswordRequiredException $e) {
+ // The user didn't supply a password.
+}
+```
+
+If you'd like all LDAP operations during the same request to be ran under the
+authenticated user, pass in `true` into the last paramter:
+
+```php
+if ($provider->auth()->attempt($username, $password, $bindAsUser = true)) {
+ // Passed.
+} else {
+ // Failed.
+}
+```
+
+---
+
+Now that you've learned the basics of configuration and
+getting yourself connected, continue on to learn
+[how to search your LDAP directory](searching.md).
+
+## Using Other LDAP Servers (OpenLDAP / FreeIPA / etc.)
+
+Alternate LDAP server variants such as OpenLDAP or FreeIPA contain
+some different attribute names than ActiveDirectory.
+
+The Adldap2 schema offers an attribute map for each available LDAP attribute, and
+is completely configurable and customizable.
+
+If you're using an alternate LDAP server variant such as OpenLDAP or FreeIPA, you **must** change the default schema inside your configuration array. If you do not, you won't receive the correct model instances for results, and you won't be
+able to utilize some standard methods available on these models.
+
+By default, Adldap2 is configured to be used with **Microsoft ActiveDirectory**.
+
+When creating your configuration array, set your schema using the `schema` key:
+
+
+**Using configuration array:**
+```php
+$ad = new Adldap\Adldap();
+
+$config = [
+ '...',
+ 'schema' => Adldap\Schemas\OpenLDAP::class
+];
+
+$ad->addProvider($config);
+```
+
+**Using configuration object:**
+```php
+$ad = new Adldap\Adldap();
+
+$config = new Adldap\Configuration\DomainConfiguration();
+
+$config->set('schema', Adldap\Schemas\OpenLDAP::class);
+
+$ad->addProvider($config);
+```
+
+Once you've set the schema of your connection provider, you can use the same API interacting with different LDAP servers.
+
+Continue onto the [searching](searching.md) documentation to learn how to begin querying your LDAP server(s).
+
+## Using G-Suite Secure LDAP Service
+
+G-Suite LDAP service only uses client certificates and no username + password, make sure yo match base_dn with your domian.
+
+```php
+$ad = new \Adldap\Adldap();
+
+// Create a configuration array.
+$config = [
+ 'hosts' => ['ldap.google.com'],
+ 'base_dn' => 'dc=your-domain,dc=com',
+ 'use_tls' => true,
+ 'version' => 3,
+ 'schema' => Adldap\Schemas\GSuite::class,
+ 'custom_options' => [
+ LDAP_OPT_X_TLS_CERTFILE => 'Google_2023_02_05_35779.crt',
+ LDAP_OPT_X_TLS_KEYFILE => 'Google_2023_02_05_35779.key',
+ ]
+];
+
+$ad->addProvider($config);
+
+try {
+ $provider = $ad->connect();
+
+ $results = $provider->search()->ous()->get();
+
+ echo 'OUs:'."\r\n";
+ echo '==============='."\r\n";
+ foreach($results as $ou) {
+ echo $ou->getDn()."\r\n";
+ }
+
+ echo "\r\n";
+
+ $results = $provider->search()->users()->get();
+
+ echo 'Users:'."\r\n";
+ echo '==============='."\r\n";
+ foreach($results as $user) {
+
+ echo $user->getAccountName()."\r\n";
+ }
+
+ echo "\r\n";
+
+ $results = $provider->search()->groups()->get();
+
+ echo 'Groups:'."\r\n";
+ echo '==============='."\r\n";
+ foreach($results as $group) {
+ echo $group->getCommonName().' | '.$group->getDisplayName()."\r\n";
+ }
+
+} catch (\Adldap\Auth\BindException $e) {
+
+ echo 'Error: '.$e->getMessage()."\r\n";
+}
+```
+
+## Raw Operations
+
+### Introduction
+
+If you want to connect to your LDAP server without utilizing Adldap's models (old fashion way), and want to get back the data in a raw format you can easily do so.
+
+If you call `getConnection()` on your connected provider instance, you can perform all LDAP functions on a container class that encapsulates all of PHP's LDAP methods.
+
+You can view all methods avaialble by browsing the LDAP class [here](https://github.com/Adldap2/Adldap2/blob/master/src/Connections/Ldap.php).
+
+Now for some examples:
+
+### Examples
+
+```php
+$ad = new Adldap\Adldap();
+
+$config = ['...'];
+
+$ad->addProvider($config);
+
+$provider = $ad->connect();
+
+$rawConnection = $provider->getConnection();
+
+// Performing a raw search.
+$result = $rawConnection->search($basedn = 'dc=corp,dc=acme,dc=org', $filter = "cn=johndoe", $selectedAttributes = ['cn', 'department']);
+
+$dn = "cn=John Smith,ou=Wizards,dc=example,dc=com";
+
+// Adding a new LDAP record.
+$result = $rawConnection->add($dn, $entry);
+
+// Batch modifying an LDAP record.
+$modifs = [
+ [
+ "attrib" => "telephoneNumber",
+ "modtype" => LDAP_MODIFY_BATCH_ADD,
+ "values" => ["+1 555 555 1717"],
+ ],
+];
+
+$result = $rawConnection->modifyBatch($dn, $modifs);
+
+// Deleting an LDAP record.
+$result = $rawConnection->delete($dn);
+
+// .. etc
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/troubleshooting.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/troubleshooting.md
new file mode 100644
index 0000000..c1e9f2a
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/docs/troubleshooting.md
@@ -0,0 +1,122 @@
+# Troubleshooting
+
+#### Creating and Setting a Users Password
+
+To set a users password when you've created a new one, you need to enable their account, **then** set their password.
+
+For example:
+
+```php
+// Construct a new user instance.
+$user = $provider->make()->user();
+
+// Set the user profile details.
+$user->setAccountName('jdoe');
+$user->setFirstName('John');
+$user->setLastName('Doe');
+$user->setCompany('ACME');
+$user->setEmail('jdoe@acme.com');
+
+// Save the new user.
+if ($user->save()) {
+ // Enable the new user (using user account control).
+ $user->setUserAccountControl(512);
+
+ // Set new user password
+ $user->setPassword('Password123');
+
+ // Save the user.
+ if($user->save()) {
+ // The password was saved successfully.
+ }
+}
+```
+
+#### Determining and Troubleshooting a Binding Failure
+
+> **Note**: The below guide is using ActiveDirectory. Your mileage will vary using other LDAP distributions.
+
+To determine the reason why a bind attempt failed, you can use the event dispatcher to listen for
+the `Failed` event, and retrieve the errors that were returned from your LDAP server:
+
+```php
+use Adldap\Adldap;
+use Adldap\Auth\Events\Failed;
+
+$d = Adldap::getEventDispatcher();
+
+$d->listen(Failed::class, function (Failed $event) {
+ $conn = $event->connection;
+
+ echo $conn->getLastError(); // 'Invalid credentials'
+ echo $conn->getDiagnosticMessage(); // '80090308: LdapErr: DSID-0C09042A, comment: AcceptSecurityContext error, data 532, v3839'
+
+ if ($error = $conn->getDetailedError()) {
+ $error->getErrorCode(); // 49
+ $error->getErrorMessage(); // 'Invalid credentials'
+ $error->getDiagnosticMessage(); // '80090308: LdapErr: DSID-0C09042A, comment: AcceptSecurityContext error, data 532, v3839'
+ }
+});
+```
+
+The above diagnostic message can be parsed down further if needed. The error code after the 'data' string
+in the above message indicates several things about the bind failure. Here is a list:
+
+- 525 - user not found
+- 52e - invalid credentials
+- 530 - not permitted to logon at this time
+- 531 - not permitted to logon at this workstation
+- 532 - password expired
+- 533 - account disabled
+- 701 - account expired
+- 773 - user must reset password
+- 775 - user account locked
+
+From the example above, you can see that the authenticating account has their password expired, due to "532" error code.
+
+#### Retrieving All Records Inside a Group
+
+To retrieve all records inside a particular group (including nested groups), use the `rawFilter()` method:
+
+```php
+// The `memberof:1.2.840.113556.1.4.1941:` string indicates
+// that we want all nested group records as well.
+$filter = '(memberof:1.2.840.113556.1.4.1941:=CN=MyGroup,DC=example,DC=com)';
+
+$users = $provider->search()->rawFilter($filter)->get();
+```
+
+#### I'm connected but not getting any search results!
+
+The first thing you need to ensure is your `base_dn` in your configuration.
+
+Your `base_dn` needs to identical to the base DN on your domain. Even one mistyped character will result in no search results.
+
+If you also include an `ou` in your base DN (ex. `ou=Accounting,dc=corp,dc=acme,dc=org`), you will only receive results inside the `Accounting` OU.
+
+Once you're connected to your LDAP server, retrieve the Root DSE record.
+
+Here's a full example:
+
+```php
+$providers = [
+ 'default' => [
+ 'base_dn' => '',
+ '...',
+ ]
+];
+
+$ad = new Adldap\Adldap($providers);
+
+try {
+ $provider = $ad->connect();
+
+ $root = $provider->search()->getRootDse();
+
+ // ex. Returns 'dc=corp,dc=acme,dc=org'
+ die($root->getRootDomainNamingContext());
+
+} catch (Adldap\Auth\BindException $e) {
+ //
+}
+```
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/license.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/license.md
new file mode 100644
index 0000000..c25dc60
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/license.md
@@ -0,0 +1,8 @@
+The MIT License (MIT)
+Copyright © Steve Bauman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/phpunit.xml b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/phpunit.xml
new file mode 100644
index 0000000..4f327fa
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/phpunit.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+ backupStaticAttributes="false"
+ bootstrap="vendor/autoload.php"
+ colors="true"
+ convertErrorsToExceptions="true"
+ convertNoticesToExceptions="true"
+ convertWarningsToExceptions="true"
+ processIsolation="false"
+ stopOnFailure="false"
+ >
+ <testsuites>
+ <testsuite name="Adldap2 Test Suite">
+ <directory suffix="Test.php">./tests/</directory>
+ </testsuite>
+ </testsuites>
+ <filter>
+ <whitelist processUncoveredFilesFromWhitelist="true">
+ <directory suffix=".php">./src</directory>
+ </whitelist>
+ </filter>
+</phpunit>
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/readme.md b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/readme.md
new file mode 100644
index 0000000..1311332
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/readme.md
@@ -0,0 +1,47 @@
+<p align="center">
+<strong>:wave: Hey there! Looking for something even easier to use for LDAP integration in your PHP applications?</strong>
+</br>
+<h3 align="center">
+ 🎉 Introducing <a href="https://github.com/DirectoryTree/LdapRecord" target="_blank" title="LdapRecord GitHub Repository">LdapRecord</a> 🎉
+</h3>
+</p>
+
+<p align="center">
+ <strong>
+ <a href="https://ldaprecord.com">LdapRecord</a> is the successor to Adldap2 - and comes with a ton of new features.
+ </strong> </br> Adldap2 will continue to be supported with bug fixes, <i>but will not receive new features.</i>
+</p>
+
+<p align="center">
+ <strong>
+ <a href="https://stevebauman.ca/why-ldap-record/">Read Why</a>
+ </strong>
+</p>
+
+<hr/>
+
+<h1 align="center">Adldap2</h1>
+
+<p align="center">
+ <a href="https://travis-ci.org/Adldap2/Adldap2"><img src="https://img.shields.io/travis/Adldap2/Adldap2.svg?style=flat-square"/></a>
+ <a href="https://scrutinizer-ci.com/g/Adldap2/Adldap2/?branch=master"><img src="https://img.shields.io/scrutinizer/g/adLDAP2/adLDAP2/master.svg?style=flat-square"/></a>
+ <a href="https://packagist.org/packages/adldap2/adldap2"><img src="https://img.shields.io/packagist/dt/adldap2/adldap2.svg?style=flat-square"/></a>
+ <a href="https://packagist.org/packages/adldap2/adldap2"><img src="https://img.shields.io/packagist/v/adldap2/adldap2.svg?style=flat-square"/></a>
+ <a href="https://packagist.org/packages/adldap2/adldap2"><img src="https://img.shields.io/packagist/l/adldap2/adldap2.svg?style=flat-square"/></a>
+</p>
+
+<p align="center">
+ Adldap2 is a PHP package that provides LDAP authentication and directory management tools using the <a href="https://en.wikipedia.org/wiki/Active_record_pattern">Active Record pattern</a>.
+</p>
+
+<h4 align="center">
+ <a href="http://adldap2.github.io/Adldap2/#/?id=quick-start">Quickstart</a>
+ <span> · </span>
+ <a href="http://adldap2.github.io/Adldap2/">Documentation</a>
+</h4>
+
+- **Up and running in minutes.** Effortlessly connect to your LDAP servers and start running queries & operations in a matter of minutes.
+
+- **Fluent query builder.** Building LDAP queries has never been so easy. Find the records you're looking for in a couple lines or less with a fluent interface.
+
+- **Supercharged Active Record.** Create and modify LDAP records with ease. All LDAP records are individual models. Simply modify the attributes on the model and save it to persist the changes to your LDAP server.
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Adldap.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Adldap.php
new file mode 100644
index 0000000..5e60697
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Adldap.php
@@ -0,0 +1,194 @@
+<?php
+
+namespace Adldap;
+
+use Adldap\Log\EventLogger;
+use Adldap\Connections\Ldap;
+use InvalidArgumentException;
+use Adldap\Log\LogsInformation;
+use Adldap\Connections\Provider;
+use Adldap\Events\DispatchesEvents;
+use Adldap\Connections\ProviderInterface;
+use Adldap\Connections\ConnectionInterface;
+use Adldap\Configuration\DomainConfiguration;
+
+class Adldap implements AdldapInterface
+{
+ use DispatchesEvents;
+ use LogsInformation;
+ /**
+ * The default provider name.
+ *
+ * @var string
+ */
+ protected $default = 'default';
+
+ /**
+ * The connection providers.
+ *
+ * @var array
+ */
+ protected $providers = [];
+
+ /**
+ * The events to register listeners for during initialization.
+ *
+ * @var array
+ */
+ protected $listen = [
+ 'Adldap\Auth\Events\*',
+ 'Adldap\Query\Events\*',
+ 'Adldap\Models\Events\*',
+ ];
+
+ /**
+ * {@inheritdoc}
+ */
+ public function __construct(array $providers = [])
+ {
+ foreach ($providers as $name => $config) {
+ $this->addProvider($config, $name);
+ }
+
+ if ($default = key($providers)) {
+ $this->setDefaultProvider($default);
+ }
+
+ $this->initEventLogger();
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function addProvider($config, $name = 'default', ConnectionInterface $connection = null)
+ {
+ if ($this->isValidConfig($config)) {
+ $config = new Provider($config, $connection ?? new Ldap($name));
+ }
+
+ if ($config instanceof ProviderInterface) {
+ $this->providers[$name] = $config;
+
+ return $this;
+ }
+
+ throw new InvalidArgumentException(
+ "You must provide a configuration array or an instance of Adldap\Connections\ProviderInterface."
+ );
+ }
+
+ /**
+ * Determines if the given config is valid.
+ *
+ * @param mixed $config
+ *
+ * @return bool
+ */
+ protected function isValidConfig($config)
+ {
+ return is_array($config) || $config instanceof DomainConfiguration;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getProviders()
+ {
+ return $this->providers;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getProvider($name)
+ {
+ if (array_key_exists($name, $this->providers)) {
+ return $this->providers[$name];
+ }
+
+ throw new AdldapException("The connection provider '$name' does not exist.");
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function setDefaultProvider($name = 'default')
+ {
+ if ($this->getProvider($name) instanceof ProviderInterface) {
+ $this->default = $name;
+ }
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getDefaultProvider()
+ {
+ return $this->getProvider($this->default);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function removeProvider($name)
+ {
+ unset($this->providers[$name]);
+
+ return $this;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function connect($name = null, $username = null, $password = null)
+ {
+ $provider = $name ? $this->getProvider($name) : $this->getDefaultProvider();
+
+ return $provider->connect($username, $password);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function __call($method, $parameters)
+ {
+ $provider = $this->getDefaultProvider();
+
+ if (! $provider->getConnection()->isBound()) {
+ $provider->connect();
+ }
+
+ return call_user_func_array([$provider, $method], $parameters);
+ }
+
+ /**
+ * Initializes the event logger.
+ *
+ * @return void
+ */
+ public function initEventLogger()
+ {
+ $dispatcher = static::getEventDispatcher();
+
+ $logger = $this->newEventLogger();
+
+ // We will go through each of our event wildcards and register their listener.
+ foreach ($this->listen as $event) {
+ $dispatcher->listen($event, function ($eventName, $events) use ($logger) {
+ foreach ($events as $event) {
+ $logger->log($event);
+ }
+ });
+ }
+ }
+
+ /**
+ * Returns a new event logger instance.
+ *
+ * @return EventLogger
+ */
+ protected function newEventLogger()
+ {
+ return new EventLogger(static::getLogger());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/AdldapException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/AdldapException.php
new file mode 100644
index 0000000..0939cac
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/AdldapException.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap;
+
+class AdldapException extends \Exception
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/AdldapInterface.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/AdldapInterface.php
new file mode 100644
index 0000000..9e1818f
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/AdldapInterface.php
@@ -0,0 +1,91 @@
+<?php
+
+namespace Adldap;
+
+use Adldap\Connections\ProviderInterface;
+use Adldap\Connections\ConnectionInterface;
+
+interface AdldapInterface
+{
+ /**
+ * Add a provider by the specified name.
+ *
+ * @param mixed $configuration
+ * @param string $name
+ * @param ConnectionInterface $connection
+ *
+ * @throws \InvalidArgumentException When an invalid type is given as the configuration argument.
+ *
+ * @return $this
+ */
+ public function addProvider($configuration, $name, ConnectionInterface $connection = null);
+
+ /**
+ * Returns all of the connection providers.
+ *
+ * @return array
+ */
+ public function getProviders();
+
+ /**
+ * Retrieves a Provider using its specified name.
+ *
+ * @param string $name
+ *
+ * @throws AdldapException When the specified provider does not exist.
+ *
+ * @return ProviderInterface
+ */
+ public function getProvider($name);
+
+ /**
+ * Sets the default provider.
+ *
+ * @param string $name
+ *
+ * @throws AdldapException When the specified provider does not exist.
+ */
+ public function setDefaultProvider($name);
+
+ /**
+ * Retrieves the first default provider.
+ *
+ * @throws AdldapException When no default provider exists.
+ *
+ * @return ProviderInterface
+ */
+ public function getDefaultProvider();
+
+ /**
+ * Removes a provider by the specified name.
+ *
+ * @param string $name
+ *
+ * @return $this
+ */
+ public function removeProvider($name);
+
+ /**
+ * Connects to the specified provider.
+ *
+ * If no username and password is given, then the providers
+ * configured admin credentials are used.
+ *
+ * @param string|null $name
+ * @param string|null $username
+ * @param string|null $password
+ *
+ * @return ProviderInterface
+ */
+ public function connect($name = null, $username = null, $password = null);
+
+ /**
+ * Call methods upon the default provider dynamically.
+ *
+ * @param string $method
+ * @param array $parameters
+ *
+ * @return mixed
+ */
+ public function __call($method, $parameters);
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/BindException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/BindException.php
new file mode 100644
index 0000000..aeef08b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/BindException.php
@@ -0,0 +1,45 @@
+<?php
+
+namespace Adldap\Auth;
+
+use Adldap\AdldapException;
+use Adldap\Connections\DetailedError;
+
+/**
+ * Class BindException.
+ *
+ * Thrown when binding to an LDAP connection fails.
+ */
+class BindException extends AdldapException
+{
+ /**
+ * The detailed LDAP error.
+ *
+ * @var DetailedError
+ */
+ protected $detailedError;
+
+ /**
+ * Sets the detailed error.
+ *
+ * @param DetailedError|null $error
+ *
+ * @return $this
+ */
+ public function setDetailedError(DetailedError $error = null)
+ {
+ $this->detailedError = $error;
+
+ return $this;
+ }
+
+ /**
+ * Returns the detailed error.
+ *
+ * @return DetailedError|null
+ */
+ public function getDetailedError()
+ {
+ return $this->detailedError;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Attempting.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Attempting.php
new file mode 100644
index 0000000..06eb839
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Attempting.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Auth\Events;
+
+class Attempting extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Binding.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Binding.php
new file mode 100644
index 0000000..aa52b4b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Binding.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Auth\Events;
+
+class Binding extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Bound.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Bound.php
new file mode 100644
index 0000000..5fc835d
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Bound.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Auth\Events;
+
+class Bound extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Event.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Event.php
new file mode 100644
index 0000000..1dca6c7
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Event.php
@@ -0,0 +1,73 @@
+<?php
+
+namespace Adldap\Auth\Events;
+
+use Adldap\Connections\ConnectionInterface;
+
+abstract class Event
+{
+ /**
+ * The connection that the username and password is being bound on.
+ *
+ * @var ConnectionInterface
+ */
+ protected $connection;
+
+ /**
+ * The username that is being used for binding.
+ *
+ * @var string
+ */
+ protected $username;
+
+ /**
+ * The password that is being used for binding.
+ *
+ * @var string
+ */
+ protected $password;
+
+ /**
+ * Constructor.
+ *
+ * @param ConnectionInterface $connection
+ * @param string $username
+ * @param string $password
+ */
+ public function __construct(ConnectionInterface $connection, $username, $password)
+ {
+ $this->connection = $connection;
+ $this->username = $username;
+ $this->password = $password;
+ }
+
+ /**
+ * Returns the events connection.
+ *
+ * @return ConnectionInterface
+ */
+ public function getConnection()
+ {
+ return $this->connection;
+ }
+
+ /**
+ * Returns the authentication events username.
+ *
+ * @return string
+ */
+ public function getUsername()
+ {
+ return $this->username;
+ }
+
+ /**
+ * Returns the authentication events password.
+ *
+ * @return string
+ */
+ public function getPassword()
+ {
+ return $this->password;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Failed.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Failed.php
new file mode 100644
index 0000000..e96746e
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Failed.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Auth\Events;
+
+class Failed extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Passed.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Passed.php
new file mode 100644
index 0000000..56ece18
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Events/Passed.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Auth\Events;
+
+class Passed extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Guard.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Guard.php
new file mode 100644
index 0000000..5a0ab4b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/Guard.php
@@ -0,0 +1,259 @@
+<?php
+
+namespace Adldap\Auth;
+
+use Exception;
+use Throwable;
+use Adldap\Auth\Events\Bound;
+use Adldap\Auth\Events\Failed;
+use Adldap\Auth\Events\Passed;
+use Adldap\Auth\Events\Binding;
+use Adldap\Auth\Events\Attempting;
+use Adldap\Events\DispatcherInterface;
+use Adldap\Connections\ConnectionInterface;
+use Adldap\Configuration\DomainConfiguration;
+
+/**
+ * Class Guard.
+ *
+ * Binds users to the current connection.
+ */
+class Guard implements GuardInterface
+{
+ /**
+ * The connection to bind to.
+ *
+ * @var ConnectionInterface
+ */
+ protected $connection;
+
+ /**
+ * The domain configuration to utilize.
+ *
+ * @var DomainConfiguration
+ */
+ protected $configuration;
+
+ /**
+ * The event dispatcher.
+ *
+ * @var DispatcherInterface
+ */
+ protected $events;
+
+ /**
+ * {@inheritdoc}
+ */
+ public function __construct(ConnectionInterface $connection, DomainConfiguration $configuration)
+ {
+ $this->connection = $connection;
+ $this->configuration = $configuration;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function attempt($username, $password, $bindAsUser = false)
+ {
+ $this->validateCredentials($username, $password);
+
+ $this->fireAttemptingEvent($username, $password);
+
+ try {
+ $this->bind(
+ $this->applyPrefixAndSuffix($username),
+ $password
+ );
+
+ $result = true;
+
+ $this->firePassedEvent($username, $password);
+ } catch (BindException $e) {
+ // We'll catch the BindException here to allow
+ // developers to use a simple if / else
+ // using the attempt method.
+ $result = false;
+ }
+
+ // If we're not allowed to bind as the user,
+ // we'll rebind as administrator.
+ if ($bindAsUser === false) {
+ // We won't catch any BindException here so we can
+ // catch rebind failures. However this shouldn't
+ // occur if our credentials are correct
+ // in the first place.
+ $this->bindAsAdministrator();
+ }
+
+ return $result;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function bind($username = null, $password = null)
+ {
+ $this->fireBindingEvent($username, $password);
+
+ try {
+ if (@$this->connection->bind($username, $password) === true) {
+ $this->fireBoundEvent($username, $password);
+ } else {
+ throw new Exception($this->connection->getLastError(), $this->connection->errNo());
+ }
+ } catch (Throwable $e) {
+ $this->fireFailedEvent($username, $password);
+
+ throw (new BindException($e->getMessage(), $e->getCode(), $e))
+ ->setDetailedError($this->connection->getDetailedError());
+ }
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function bindAsAdministrator()
+ {
+ $this->bind(
+ $this->configuration->get('username'),
+ $this->configuration->get('password')
+ );
+ }
+
+ /**
+ * Get the event dispatcher instance.
+ *
+ * @return DispatcherInterface
+ */
+ public function getDispatcher()
+ {
+ return $this->events;
+ }
+
+ /**
+ * Sets the event dispatcher instance.
+ *
+ * @param DispatcherInterface $dispatcher
+ *
+ * @return void
+ */
+ public function setDispatcher(DispatcherInterface $dispatcher)
+ {
+ $this->events = $dispatcher;
+ }
+
+ /**
+ * Applies the prefix and suffix to the given username.
+ *
+ * @param string $username
+ *
+ * @throws \Adldap\Configuration\ConfigurationException If account_suffix or account_prefix do not
+ * exist in the providers domain configuration
+ *
+ * @return string
+ */
+ protected function applyPrefixAndSuffix($username)
+ {
+ $prefix = $this->configuration->get('account_prefix');
+ $suffix = $this->configuration->get('account_suffix');
+
+ return $prefix.$username.$suffix;
+ }
+
+ /**
+ * Validates the specified username and password from being empty.
+ *
+ * @param string $username
+ * @param string $password
+ *
+ * @throws PasswordRequiredException When the given password is empty.
+ * @throws UsernameRequiredException When the given username is empty.
+ */
+ protected function validateCredentials($username, $password)
+ {
+ if (empty($username)) {
+ // Check for an empty username.
+ throw new UsernameRequiredException('A username must be specified.');
+ }
+
+ if (empty($password)) {
+ // Check for an empty password.
+ throw new PasswordRequiredException('A password must be specified.');
+ }
+ }
+
+ /**
+ * Fire the attempting event.
+ *
+ * @param string $username
+ * @param string $password
+ *
+ * @return void
+ */
+ protected function fireAttemptingEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Attempting($this->connection, $username, $password));
+ }
+ }
+
+ /**
+ * Fire the passed event.
+ *
+ * @param string $username
+ * @param string $password
+ *
+ * @return void
+ */
+ protected function firePassedEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Passed($this->connection, $username, $password));
+ }
+ }
+
+ /**
+ * Fire the failed event.
+ *
+ * @param string $username
+ * @param string $password
+ *
+ * @return void
+ */
+ protected function fireFailedEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Failed($this->connection, $username, $password));
+ }
+ }
+
+ /**
+ * Fire the binding event.
+ *
+ * @param string $username
+ * @param string $password
+ *
+ * @return void
+ */
+ protected function fireBindingEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Binding($this->connection, $username, $password));
+ }
+ }
+
+ /**
+ * Fire the bound event.
+ *
+ * @param string $username
+ * @param string $password
+ *
+ * @return void
+ */
+ protected function fireBoundEvent($username, $password)
+ {
+ if (isset($this->events)) {
+ $this->events->fire(new Bound($this->connection, $username, $password));
+ }
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/GuardInterface.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/GuardInterface.php
new file mode 100644
index 0000000..e10da37
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/GuardInterface.php
@@ -0,0 +1,55 @@
+<?php
+
+namespace Adldap\Auth;
+
+use Adldap\Connections\ConnectionInterface;
+use Adldap\Configuration\DomainConfiguration;
+
+interface GuardInterface
+{
+ /**
+ * Constructor.
+ *
+ * @param ConnectionInterface $connection
+ * @param DomainConfiguration $configuration
+ */
+ public function __construct(ConnectionInterface $connection, DomainConfiguration $configuration);
+
+ /**
+ * Authenticates a user using the specified credentials.
+ *
+ * @param string $username The users LDAP username.
+ * @param string $password The users LDAP password.
+ * @param bool $bindAsUser Whether or not to bind as the user.
+ *
+ * @throws \Adldap\Auth\BindException When re-binding to your LDAP server fails.
+ * @throws \Adldap\Auth\UsernameRequiredException When username is empty.
+ * @throws \Adldap\Auth\PasswordRequiredException When password is empty.
+ *
+ * @return bool
+ */
+ public function attempt($username, $password, $bindAsUser = false);
+
+ /**
+ * Binds to the current connection using the inserted credentials.
+ *
+ * @param string|null $username
+ * @param string|null $password
+ *
+ * @throws \Adldap\Auth\BindException If binding to the LDAP server fails.
+ * @throws \Adldap\Connections\ConnectionException If upgrading the connection to TLS fails
+ *
+ * @return void
+ */
+ public function bind($username = null, $password = null);
+
+ /**
+ * Binds to the current LDAP server using the
+ * configuration administrator credentials.
+ *
+ * @throws \Adldap\Auth\BindException When binding as your administrator account fails.
+ *
+ * @return void
+ */
+ public function bindAsAdministrator();
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/PasswordRequiredException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/PasswordRequiredException.php
new file mode 100644
index 0000000..70a76b9
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/PasswordRequiredException.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Adldap\Auth;
+
+use Adldap\AdldapException;
+
+class PasswordRequiredException extends AdldapException
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/UsernameRequiredException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/UsernameRequiredException.php
new file mode 100644
index 0000000..4b48724
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Auth/UsernameRequiredException.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Adldap\Auth;
+
+use Adldap\AdldapException;
+
+class UsernameRequiredException extends AdldapException
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/ConfigurationException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/ConfigurationException.php
new file mode 100644
index 0000000..af62ce4
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/ConfigurationException.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace Adldap\Configuration;
+
+use Adldap\AdldapException;
+
+/**
+ * Class ConfigurationException.
+ *
+ * Thrown when a configuration value does not exist, or a
+ * configuration value being set is not valid.
+ */
+class ConfigurationException extends AdldapException
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/DomainConfiguration.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/DomainConfiguration.php
new file mode 100644
index 0000000..f1e4fb6
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/DomainConfiguration.php
@@ -0,0 +1,161 @@
+<?php
+
+namespace Adldap\Configuration;
+
+use Adldap\Schemas\ActiveDirectory;
+use Adldap\Connections\ConnectionInterface;
+
+/**
+ * Class DomainConfiguration.
+ *
+ * Contains an array of configuration options for a single LDAP connection.
+ */
+class DomainConfiguration
+{
+ /**
+ * The configuration options array.
+ *
+ * The default values for each key indicate the type of value it requires.
+ *
+ * @var array
+ */
+ protected $options = [
+ // An array of LDAP hosts.
+ 'hosts' => [],
+
+ // The global LDAP operation timeout limit in seconds.
+ 'timeout' => 5,
+
+ // The LDAP version to utilize.
+ 'version' => 3,
+
+ // The port to use for connecting to your hosts.
+ 'port' => ConnectionInterface::PORT,
+
+ // The schema to use for your LDAP connection.
+ 'schema' => ActiveDirectory::class,
+
+ // The base distinguished name of your domain.
+ 'base_dn' => '',
+
+ // The username to connect to your hosts with.
+ 'username' => '',
+
+ // The password that is utilized with the above user.
+ 'password' => '',
+
+ // The account prefix to use when authenticating users.
+ 'account_prefix' => null,
+
+ // The account suffix to use when authenticating users.
+ 'account_suffix' => null,
+
+ // Whether or not to use SSL when connecting to your hosts.
+ 'use_ssl' => false,
+
+ // Whether or not to use TLS when connecting to your hosts.
+ 'use_tls' => false,
+
+ // Whether or not follow referrals is enabled when performing LDAP operations.
+ 'follow_referrals' => false,
+
+ // Custom LDAP options that you'd like to utilize.
+ 'custom_options' => [],
+ ];
+
+ /**
+ * Constructor.
+ *
+ * @param array $options
+ *
+ * @throws ConfigurationException When an option value given is an invalid type.
+ */
+ public function __construct(array $options = [])
+ {
+ foreach ($options as $key => $value) {
+ $this->set($key, $value);
+ }
+ }
+
+ /**
+ * Sets a configuration option.
+ *
+ * Throws an exception if the specified option does
+ * not exist, or if it's an invalid type.
+ *
+ * @param string $key
+ * @param mixed $value
+ *
+ * @throws ConfigurationException When an option value given is an invalid type.
+ */
+ public function set($key, $value)
+ {
+ if ($this->validate($key, $value)) {
+ $this->options[$key] = $value;
+ }
+ }
+
+ /**
+ * Returns the value for the specified configuration options.
+ *
+ * Throws an exception if the specified option does not exist.
+ *
+ * @param string $key
+ *
+ * @throws ConfigurationException When the option specified does not exist.
+ *
+ * @return mixed
+ */
+ public function get($key)
+ {
+ if ($this->has($key)) {
+ return $this->options[$key];
+ }
+
+ throw new ConfigurationException("Option {$key} does not exist.");
+ }
+
+ /**
+ * Checks if a configuration option exists.
+ *
+ * @param string $key
+ *
+ * @return bool
+ */
+ public function has($key)
+ {
+ return array_key_exists($key, $this->options);
+ }
+
+ /**
+ * Validates the new configuration option against its
+ * default value to ensure it's the correct type.
+ *
+ * If an invalid type is given, an exception is thrown.
+ *
+ * @param string $key
+ * @param mixed $value
+ *
+ * @throws ConfigurationException When an option value given is an invalid type.
+ *
+ * @return bool
+ */
+ protected function validate($key, $value)
+ {
+ $default = $this->get($key);
+
+ if (is_array($default)) {
+ $validator = new Validators\ArrayValidator($key, $value);
+ } elseif (is_int($default)) {
+ $validator = new Validators\IntegerValidator($key, $value);
+ } elseif (is_bool($default)) {
+ $validator = new Validators\BooleanValidator($key, $value);
+ } elseif (class_exists($default)) {
+ $validator = new Validators\ClassValidator($key, $value);
+ } else {
+ $validator = new Validators\StringOrNullValidator($key, $value);
+ }
+
+ return $validator->validate();
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/ArrayValidator.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/ArrayValidator.php
new file mode 100644
index 0000000..ec5bdb0
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/ArrayValidator.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Adldap\Configuration\Validators;
+
+use Adldap\Configuration\ConfigurationException;
+
+/**
+ * Class ArrayValidator.
+ *
+ * Validates that the configuration value is an array.
+ */
+class ArrayValidator extends Validator
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function validate()
+ {
+ if (!is_array($this->value)) {
+ throw new ConfigurationException("Option {$this->key} must be an array.");
+ }
+
+ return true;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/BooleanValidator.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/BooleanValidator.php
new file mode 100644
index 0000000..23b4846
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/BooleanValidator.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Adldap\Configuration\Validators;
+
+use Adldap\Configuration\ConfigurationException;
+
+/**
+ * Class BooleanValidator.
+ *
+ * Validates that the configuration value is a boolean.
+ */
+class BooleanValidator extends Validator
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function validate()
+ {
+ if (!is_bool($this->value)) {
+ throw new ConfigurationException("Option {$this->key} must be a boolean.");
+ }
+
+ return true;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/ClassValidator.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/ClassValidator.php
new file mode 100644
index 0000000..924c35f
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/ClassValidator.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace Adldap\Configuration\Validators;
+
+use Adldap\Configuration\ConfigurationException;
+
+class ClassValidator extends Validator
+{
+ /**
+ * Validates the configuration value.
+ *
+ * @throws ConfigurationException When the value given fails validation.
+ *
+ * @return bool
+ */
+ public function validate()
+ {
+ if (!class_exists($this->value)) {
+ throw new ConfigurationException("Option {$this->key} must be a valid class.");
+ }
+
+ return true;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/IntegerValidator.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/IntegerValidator.php
new file mode 100644
index 0000000..cd783c4
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/IntegerValidator.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Adldap\Configuration\Validators;
+
+use Adldap\Configuration\ConfigurationException;
+
+/**
+ * Class IntegerValidator.
+ *
+ * Validates that the configuration value is an integer / number.
+ */
+class IntegerValidator extends Validator
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function validate()
+ {
+ if (!is_numeric($this->value)) {
+ throw new ConfigurationException("Option {$this->key} must be an integer.");
+ }
+
+ return true;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/StringOrNullValidator.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/StringOrNullValidator.php
new file mode 100644
index 0000000..717c952
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/StringOrNullValidator.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Adldap\Configuration\Validators;
+
+use Adldap\Configuration\ConfigurationException;
+
+/**
+ * Class StringOrNullValidator.
+ *
+ * Validates that the configuration value is a string or null.
+ */
+class StringOrNullValidator extends Validator
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function validate()
+ {
+ if (is_string($this->value) || is_null($this->value)) {
+ return true;
+ }
+
+ throw new ConfigurationException("Option {$this->key} must be a string or null.");
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/Validator.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/Validator.php
new file mode 100644
index 0000000..983c98c
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Configuration/Validators/Validator.php
@@ -0,0 +1,46 @@
+<?php
+
+namespace Adldap\Configuration\Validators;
+
+/**
+ * Class Validator.
+ *
+ * Validates configuration values.
+ */
+abstract class Validator
+{
+ /**
+ * The configuration key under validation.
+ *
+ * @var string
+ */
+ protected $key;
+
+ /**
+ * The configuration value under validation.
+ *
+ * @var mixed
+ */
+ protected $value;
+
+ /**
+ * Constructor.
+ *
+ * @param string $key
+ * @param mixed $value
+ */
+ public function __construct($key, $value)
+ {
+ $this->key = $key;
+ $this->value = $value;
+ }
+
+ /**
+ * Validates the configuration value.
+ *
+ * @throws \Adldap\Configuration\ConfigurationException When the value given fails validation.
+ *
+ * @return bool
+ */
+ abstract public function validate();
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ConnectionException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ConnectionException.php
new file mode 100644
index 0000000..d8004e6
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ConnectionException.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Adldap\Connections;
+
+use Adldap\AdldapException;
+
+class ConnectionException extends AdldapException
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ConnectionInterface.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ConnectionInterface.php
new file mode 100644
index 0000000..39ddc0e
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ConnectionInterface.php
@@ -0,0 +1,539 @@
+<?php
+
+namespace Adldap\Connections;
+
+/**
+ * The Connection interface used for making connections. Implementing
+ * this interface on connection classes helps unit and functional
+ * test classes that require a connection.
+ *
+ * Interface ConnectionInterface
+ */
+interface ConnectionInterface
+{
+ /**
+ * The SSL LDAP protocol string.
+ *
+ * @var string
+ */
+ const PROTOCOL_SSL = 'ldaps://';
+
+ /**
+ * The standard LDAP protocol string.
+ *
+ * @var string
+ */
+ const PROTOCOL = 'ldap://';
+
+ /**
+ * The LDAP SSL port number.
+ *
+ * @var string
+ */
+ const PORT_SSL = 636;
+
+ /**
+ * The standard LDAP port number.
+ *
+ * @var string
+ */
+ const PORT = 389;
+
+ /**
+ * Constructor.
+ *
+ * @param string|null $name The connection name.
+ */
+ public function __construct($name = null);
+
+ /**
+ * Returns true / false if the current connection instance is using SSL.
+ *
+ * @return bool
+ */
+ public function isUsingSSL();
+
+ /**
+ * Returns true / false if the current connection instance is using TLS.
+ *
+ * @return bool
+ */
+ public function isUsingTLS();
+
+ /**
+ * Returns true / false if the current connection is able to modify passwords.
+ *
+ * @return bool
+ */
+ public function canChangePasswords();
+
+ /**
+ * Returns true / false if the current connection is bound.
+ *
+ * @return bool
+ */
+ public function isBound();
+
+ /**
+ * Sets the current connection to use SSL.
+ *
+ * @param bool $enabled
+ *
+ * @return ConnectionInterface
+ */
+ public function ssl($enabled = true);
+
+ /**
+ * Sets the current connection to use TLS.
+ *
+ * @param bool $enabled
+ *
+ * @return ConnectionInterface
+ */
+ public function tls($enabled = true);
+
+ /**
+ * Returns the full LDAP host URL.
+ *
+ * Ex: ldap://192.168.1.1:386
+ *
+ * @return string|null
+ */
+ public function getHost();
+
+ /**
+ * Returns the connections name.
+ *
+ * @return string|null
+ */
+ public function getName();
+
+ /**
+ * Get the current connection.
+ *
+ * @return mixed
+ */
+ public function getConnection();
+
+ /**
+ * Retrieve the entries from a search result.
+ *
+ * @link http://php.net/manual/en/function.ldap-get-entries.php
+ *
+ * @param $searchResult
+ *
+ * @return mixed
+ */
+ public function getEntries($searchResult);
+
+ /**
+ * Returns the number of entries from a search result.
+ *
+ * @link http://php.net/manual/en/function.ldap-count-entries.php
+ *
+ * @param $searchResult
+ *
+ * @return int
+ */
+ public function countEntries($searchResult);
+
+ /**
+ * Compare value of attribute found in entry specified with DN.
+ *
+ * @link http://php.net/manual/en/function.ldap-compare.php
+ *
+ * @param string $dn
+ * @param string $attribute
+ * @param string $value
+ *
+ * @return mixed
+ */
+ public function compare($dn, $attribute, $value);
+
+ /**
+ * Retrieves the first entry from a search result.
+ *
+ * @link http://php.net/manual/en/function.ldap-first-entry.php
+ *
+ * @param $searchResult
+ *
+ * @return mixed
+ */
+ public function getFirstEntry($searchResult);
+
+ /**
+ * Retrieves the next entry from a search result.
+ *
+ * @link http://php.net/manual/en/function.ldap-next-entry.php
+ *
+ * @param $entry
+ *
+ * @return mixed
+ */
+ public function getNextEntry($entry);
+
+ /**
+ * Retrieves the ldap entry's attributes.
+ *
+ * @link http://php.net/manual/en/function.ldap-get-attributes.php
+ *
+ * @param $entry
+ *
+ * @return mixed
+ */
+ public function getAttributes($entry);
+
+ /**
+ * Retrieve the last error on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-error.php
+ *
+ * @return string
+ */
+ public function getLastError();
+
+ /**
+ * Return detailed information about an error.
+ *
+ * Returns false when there was a successful last request.
+ *
+ * Returns DetailedError when there was an error.
+ *
+ * @return DetailedError|null
+ */
+ public function getDetailedError();
+
+ /**
+ * Get all binary values from the specified result entry.
+ *
+ * @link http://php.net/manual/en/function.ldap-get-values-len.php
+ *
+ * @param $entry
+ * @param $attribute
+ *
+ * @return array
+ */
+ public function getValuesLen($entry, $attribute);
+
+ /**
+ * Sets an option on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-set-option.php
+ *
+ * @param int $option
+ * @param mixed $value
+ *
+ * @return mixed
+ */
+ public function setOption($option, $value);
+
+ /**
+ * Sets options on the current connection.
+ *
+ * @param array $options
+ *
+ * @return mixed
+ */
+ public function setOptions(array $options = []);
+
+ /**
+ * Set a callback function to do re-binds on referral chasing.
+ *
+ * @link http://php.net/manual/en/function.ldap-set-rebind-proc.php
+ *
+ * @param callable $callback
+ *
+ * @return bool
+ */
+ public function setRebindCallback(callable $callback);
+
+ /**
+ * Connects to the specified hostname using the specified port.
+ *
+ * @link http://php.net/manual/en/function.ldap-start-tls.php
+ *
+ * @param string|array $hostname
+ * @param int $port
+ *
+ * @return mixed
+ */
+ public function connect($hostname = [], $port = 389);
+
+ /**
+ * Starts a connection using TLS.
+ *
+ * @link http://php.net/manual/en/function.ldap-start-tls.php
+ *
+ * @throws ConnectionException If starting TLS fails.
+ *
+ * @return mixed
+ */
+ public function startTLS();
+
+ /**
+ * Binds to the current connection using the specified username and password.
+ * If sasl is true, the current connection is bound using SASL.
+ *
+ * @link http://php.net/manual/en/function.ldap-bind.php
+ *
+ * @param string $username
+ * @param string $password
+ * @param bool $sasl
+ *
+ * @throws ConnectionException If starting TLS fails.
+ *
+ * @return bool
+ */
+ public function bind($username, $password, $sasl = false);
+
+ /**
+ * Closes the current connection.
+ *
+ * Returns false if no connection is present.
+ *
+ * @link http://php.net/manual/en/function.ldap-close.php
+ *
+ * @return bool
+ */
+ public function close();
+
+ /**
+ * Performs a search on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-search.php
+ *
+ * @param string $dn
+ * @param string $filter
+ * @param array $fields
+ * @param bool $onlyAttributes
+ * @param int $size
+ * @param int $time
+ *
+ * @return mixed
+ */
+ public function search($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0);
+
+ /**
+ * Reads an entry on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-read.php
+ *
+ * @param string $dn
+ * @param $filter
+ * @param array $fields
+ * @param bool $onlyAttributes
+ * @param int $size
+ * @param int $time
+ *
+ * @return mixed
+ */
+ public function read($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0);
+
+ /**
+ * Performs a single level search on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-list.php
+ *
+ * @param string $dn
+ * @param string $filter
+ * @param array $attributes
+ * @param bool $onlyAttributes
+ * @param int $size
+ * @param int $time
+ *
+ * @return mixed
+ */
+ public function listing($dn, $filter, array $attributes, $onlyAttributes = false, $size = 0, $time = 0);
+
+ /**
+ * Adds an entry to the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-add.php
+ *
+ * @param string $dn
+ * @param array $entry
+ *
+ * @return bool
+ */
+ public function add($dn, array $entry);
+
+ /**
+ * Deletes an entry on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-delete.php
+ *
+ * @param string $dn
+ *
+ * @return bool
+ */
+ public function delete($dn);
+
+ /**
+ * Modify the name of an entry on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-rename.php
+ *
+ * @param string $dn
+ * @param string $newRdn
+ * @param string $newParent
+ * @param bool $deleteOldRdn
+ *
+ * @return bool
+ */
+ public function rename($dn, $newRdn, $newParent, $deleteOldRdn = false);
+
+ /**
+ * Modifies an existing entry on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-modify.php
+ *
+ * @param string $dn
+ * @param array $entry
+ *
+ * @return bool
+ */
+ public function modify($dn, array $entry);
+
+ /**
+ * Batch modifies an existing entry on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-modify-batch.php
+ *
+ * @param string $dn
+ * @param array $values
+ *
+ * @return mixed
+ */
+ public function modifyBatch($dn, array $values);
+
+ /**
+ * Add attribute values to current attributes.
+ *
+ * @link http://php.net/manual/en/function.ldap-mod-add.php
+ *
+ * @param string $dn
+ * @param array $entry
+ *
+ * @return mixed
+ */
+ public function modAdd($dn, array $entry);
+
+ /**
+ * Replaces attribute values with new ones.
+ *
+ * @link http://php.net/manual/en/function.ldap-mod-replace.php
+ *
+ * @param string $dn
+ * @param array $entry
+ *
+ * @return mixed
+ */
+ public function modReplace($dn, array $entry);
+
+ /**
+ * Delete attribute values from current attributes.
+ *
+ * @link http://php.net/manual/en/function.ldap-mod-del.php
+ *
+ * @param string $dn
+ * @param array $entry
+ *
+ * @return mixed
+ */
+ public function modDelete($dn, array $entry);
+
+ /**
+ * Send LDAP pagination control.
+ *
+ * @link http://php.net/manual/en/function.ldap-control-paged-result.php
+ *
+ * @param int $pageSize
+ * @param bool $isCritical
+ * @param string $cookie
+ *
+ * @return mixed
+ */
+ public function controlPagedResult($pageSize = 1000, $isCritical = false, $cookie = '');
+
+ /**
+ * Retrieve the LDAP pagination cookie.
+ *
+ * @link http://php.net/manual/en/function.ldap-control-paged-result-response.php
+ *
+ * @param $result
+ * @param string $cookie
+ *
+ * @return mixed
+ */
+ public function controlPagedResultResponse($result, &$cookie);
+
+ /**
+ * Frees up the memory allocated internally to store the result.
+ *
+ * @link https://www.php.net/manual/en/function.ldap-free-result.php
+ *
+ * @param resource $result
+ *
+ * @return bool
+ */
+ public function freeResult($result);
+
+ /**
+ * Returns the error number of the last command
+ * executed on the current connection.
+ *
+ * @link http://php.net/manual/en/function.ldap-errno.php
+ *
+ * @return int
+ */
+ public function errNo();
+
+ /**
+ * Returns the extended error string of the last command.
+ *
+ * @return string
+ */
+ public function getExtendedError();
+
+ /**
+ * Returns the extended error hex code of the last command.
+ *
+ * @return string|null
+ */
+ public function getExtendedErrorHex();
+
+ /**
+ * Returns the extended error code of the last command.
+ *
+ * @return string
+ */
+ public function getExtendedErrorCode();
+
+ /**
+ * Returns the error string of the specified
+ * error number.
+ *
+ * @link http://php.net/manual/en/function.ldap-err2str.php
+ *
+ * @param int $number
+ *
+ * @return string
+ */
+ public function err2Str($number);
+
+ /**
+ * Return the diagnostic Message.
+ *
+ * @return string
+ */
+ public function getDiagnosticMessage();
+
+ /**
+ * Extract the diagnostic code from the message.
+ *
+ * @param string $message
+ *
+ * @return string|bool
+ */
+ public function extractDiagnosticCode($message);
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/DetailedError.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/DetailedError.php
new file mode 100644
index 0000000..d7554c6
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/DetailedError.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace Adldap\Connections;
+
+class DetailedError
+{
+ /**
+ * The error code from ldap_errno.
+ *
+ * @var int|null
+ */
+ protected $errorCode;
+
+ /**
+ * The error message from ldap_error.
+ *
+ * @var string|null
+ */
+ protected $errorMessage;
+
+ /**
+ * The diagnostic message when retrieved after an ldap_error.
+ *
+ * @var string|null
+ */
+ protected $diagnosticMessage;
+
+ /**
+ * Constructor.
+ *
+ * @param int $errorCode
+ * @param string $errorMessage
+ * @param string $diagnosticMessage
+ */
+ public function __construct($errorCode, $errorMessage, $diagnosticMessage)
+ {
+ $this->errorCode = $errorCode;
+ $this->errorMessage = $errorMessage;
+ $this->diagnosticMessage = $diagnosticMessage;
+ }
+
+ /**
+ * Returns the LDAP error code.
+ *
+ * @return int
+ */
+ public function getErrorCode()
+ {
+ return $this->errorCode;
+ }
+
+ /**
+ * Returns the LDAP error message.
+ *
+ * @return string
+ */
+ public function getErrorMessage()
+ {
+ return $this->errorMessage;
+ }
+
+ /**
+ * Returns the LDAP diagnostic message.
+ *
+ * @return string
+ */
+ public function getDiagnosticMessage()
+ {
+ return $this->diagnosticMessage;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/Ldap.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/Ldap.php
new file mode 100644
index 0000000..2ce83fd
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/Ldap.php
@@ -0,0 +1,545 @@
+<?php
+
+namespace Adldap\Connections;
+
+/**
+ * Class Ldap.
+ *
+ * A class that abstracts PHP's LDAP functions and stores the bound connection.
+ */
+class Ldap implements ConnectionInterface
+{
+ /**
+ * The connection name.
+ *
+ * @var string|null
+ */
+ protected $name;
+
+ /**
+ * The LDAP host that is currently connected.
+ *
+ * @var string|null
+ */
+ protected $host;
+
+ /**
+ * The active LDAP connection.
+ *
+ * @var resource
+ */
+ protected $connection;
+
+ /**
+ * The bound status of the connection.
+ *
+ * @var bool
+ */
+ protected $bound = false;
+
+ /**
+ * Whether the connection must be bound over SSL.
+ *
+ * @var bool
+ */
+ protected $useSSL = false;
+
+ /**
+ * Whether the connection must be bound over TLS.
+ *
+ * @var bool
+ */
+ protected $useTLS = false;
+
+ /**
+ * {@inheritdoc}
+ */
+ public function __construct($name = null)
+ {
+ $this->name = $name;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function isUsingSSL()
+ {
+ return $this->useSSL;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function isUsingTLS()
+ {
+ return $this->useTLS;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function isBound()
+ {
+ return $this->bound;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function canChangePasswords()
+ {
+ return $this->isUsingSSL() || $this->isUsingTLS();
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function ssl($enabled = true)
+ {
+ $this->useSSL = $enabled;
+
+ return $this;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function tls($enabled = true)
+ {
+ $this->useTLS = $enabled;
+
+ return $this;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getHost()
+ {
+ return $this->host;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getName()
+ {
+ return $this->name;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getConnection()
+ {
+ return $this->connection;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getEntries($searchResults)
+ {
+ return ldap_get_entries($this->connection, $searchResults);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getFirstEntry($searchResults)
+ {
+ return ldap_first_entry($this->connection, $searchResults);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getNextEntry($entry)
+ {
+ return ldap_next_entry($this->connection, $entry);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getAttributes($entry)
+ {
+ return ldap_get_attributes($this->connection, $entry);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function countEntries($searchResults)
+ {
+ return ldap_count_entries($this->connection, $searchResults);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function compare($dn, $attribute, $value)
+ {
+ return ldap_compare($this->connection, $dn, $attribute, $value);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getLastError()
+ {
+ return ldap_error($this->connection);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getDetailedError()
+ {
+ // If the returned error number is zero, the last LDAP operation
+ // succeeded. We won't return a detailed error.
+ if ($number = $this->errNo()) {
+ ldap_get_option($this->connection, LDAP_OPT_DIAGNOSTIC_MESSAGE, $message);
+
+ return new DetailedError($number, $this->err2Str($number), $message);
+ }
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getValuesLen($entry, $attribute)
+ {
+ return ldap_get_values_len($this->connection, $entry, $attribute);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function setOption($option, $value)
+ {
+ return ldap_set_option($this->connection, $option, $value);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function setOptions(array $options = [])
+ {
+ foreach ($options as $option => $value) {
+ $this->setOption($option, $value);
+ }
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function setRebindCallback(callable $callback)
+ {
+ return ldap_set_rebind_proc($this->connection, $callback);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function startTLS()
+ {
+ try {
+ return ldap_start_tls($this->connection);
+ } catch (\ErrorException $e) {
+ throw new ConnectionException($e->getMessage(), $e->getCode(), $e);
+ }
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function connect($hosts = [], $port = 389)
+ {
+ $this->host = $this->getConnectionString($hosts, $this->getProtocol(), $port);
+
+ // Reset the bound status if reinitializing the connection.
+ $this->bound = false;
+
+ return $this->connection = ldap_connect($this->host);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function close()
+ {
+ $connection = $this->connection;
+
+ $result = is_resource($connection) ? ldap_close($connection) : false;
+
+ $this->bound = false;
+
+ return $result;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function search($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0)
+ {
+ return ldap_search($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function listing($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0)
+ {
+ return ldap_list($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function read($dn, $filter, array $fields, $onlyAttributes = false, $size = 0, $time = 0)
+ {
+ return ldap_read($this->connection, $dn, $filter, $fields, $onlyAttributes, $size, $time);
+ }
+
+ /**
+ * Extract information from an LDAP result.
+ *
+ * @link https://www.php.net/manual/en/function.ldap-parse-result.php
+ *
+ * @param resource $result
+ * @param int $errorCode
+ * @param string $dn
+ * @param string $errorMessage
+ * @param array $referrals
+ * @param array $serverControls
+ *
+ * @return bool
+ */
+ public function parseResult($result, &$errorCode, &$dn, &$errorMessage, &$referrals, &$serverControls = [])
+ {
+ return $this->supportsServerControlsInMethods() && !empty($serverControls) ?
+ ldap_parse_result($this->connection, $result, $errorCode, $dn, $errorMessage, $referrals, $serverControls) :
+ ldap_parse_result($this->connection, $result, $errorCode, $dn, $errorMessage, $referrals);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function bind($username, $password, $sasl = false)
+ {
+ // Prior to binding, we will upgrade our connectivity to TLS on our current
+ // connection and ensure we are not already bound before upgrading.
+ // This is to prevent subsequent upgrading on several binds.
+ if ($this->isUsingTLS() && !$this->isBound()) {
+ $this->startTLS();
+ }
+
+ if ($sasl) {
+ return $this->bound = ldap_sasl_bind($this->connection, null, null, 'GSSAPI');
+ }
+
+ return $this->bound = ldap_bind(
+ $this->connection,
+ $username,
+ html_entity_decode($password)
+ );
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function add($dn, array $entry)
+ {
+ return ldap_add($this->connection, $dn, $entry);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function delete($dn)
+ {
+ return ldap_delete($this->connection, $dn);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function rename($dn, $newRdn, $newParent, $deleteOldRdn = false)
+ {
+ return ldap_rename($this->connection, $dn, $newRdn, $newParent, $deleteOldRdn);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function modify($dn, array $entry)
+ {
+ return ldap_modify($this->connection, $dn, $entry);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function modifyBatch($dn, array $values)
+ {
+ return ldap_modify_batch($this->connection, $dn, $values);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function modAdd($dn, array $entry)
+ {
+ return ldap_mod_add($this->connection, $dn, $entry);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function modReplace($dn, array $entry)
+ {
+ return ldap_mod_replace($this->connection, $dn, $entry);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function modDelete($dn, array $entry)
+ {
+ return ldap_mod_del($this->connection, $dn, $entry);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function controlPagedResult($pageSize = 1000, $isCritical = false, $cookie = '')
+ {
+ return ldap_control_paged_result($this->connection, $pageSize, $isCritical, $cookie);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function controlPagedResultResponse($result, &$cookie)
+ {
+ return ldap_control_paged_result_response($this->connection, $result, $cookie);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function freeResult($result)
+ {
+ return ldap_free_result($result);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function errNo()
+ {
+ return ldap_errno($this->connection);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getExtendedError()
+ {
+ return $this->getDiagnosticMessage();
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getExtendedErrorHex()
+ {
+ if (preg_match("/(?<=data\s).*?(?=\,)/", $this->getExtendedError(), $code)) {
+ return $code[0];
+ }
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getExtendedErrorCode()
+ {
+ return $this->extractDiagnosticCode($this->getExtendedError());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function err2Str($number)
+ {
+ return ldap_err2str($number);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getDiagnosticMessage()
+ {
+ ldap_get_option($this->connection, LDAP_OPT_ERROR_STRING, $message);
+
+ return $message;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function extractDiagnosticCode($message)
+ {
+ preg_match('/^([\da-fA-F]+):/', $message, $matches);
+
+ return isset($matches[1]) ? $matches[1] : false;
+ }
+
+ /**
+ * Returns the LDAP protocol to utilize for the current connection.
+ *
+ * @return string
+ */
+ public function getProtocol()
+ {
+ return $this->isUsingSSL() ? $this::PROTOCOL_SSL : $this::PROTOCOL;
+ }
+
+ /**
+ * Determine if the current PHP version supports server controls.
+ *
+ * @return bool
+ */
+ public function supportsServerControlsInMethods()
+ {
+ return version_compare(PHP_VERSION, '7.3.0') >= 0;
+ }
+
+ /**
+ * Generates an LDAP connection string for each host given.
+ *
+ * @param string|array $hosts
+ * @param string $protocol
+ * @param string $port
+ *
+ * @return string
+ */
+ protected function getConnectionString($hosts, $protocol, $port)
+ {
+ // If we are using SSL and using the default port, we
+ // will override it to use the default SSL port.
+ if ($this->isUsingSSL() && $port == 389) {
+ $port = self::PORT_SSL;
+ }
+
+ // Normalize hosts into an array.
+ $hosts = is_array($hosts) ? $hosts : [$hosts];
+
+ $hosts = array_map(function ($host) use ($protocol, $port) {
+ return "{$protocol}{$host}:{$port}";
+ }, $hosts);
+
+ return implode(' ', $hosts);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/Provider.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/Provider.php
new file mode 100644
index 0000000..c8db387
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/Provider.php
@@ -0,0 +1,291 @@
+<?php
+
+namespace Adldap\Connections;
+
+use Adldap\Adldap;
+use Adldap\Auth\Guard;
+use Adldap\Query\Cache;
+use InvalidArgumentException;
+use Adldap\Auth\GuardInterface;
+use Adldap\Schemas\ActiveDirectory;
+use Adldap\Schemas\SchemaInterface;
+use Psr\SimpleCache\CacheInterface;
+use Adldap\Models\Factory as ModelFactory;
+use Adldap\Query\Factory as SearchFactory;
+use Adldap\Configuration\DomainConfiguration;
+
+/**
+ * Class Provider.
+ *
+ * Contains the LDAP connection and domain configuration to
+ * instantiate factories for retrieving and creating
+ * LDAP records as well as authentication (binding).
+ */
+class Provider implements ProviderInterface
+{
+ /**
+ * The providers connection.
+ *
+ * @var ConnectionInterface
+ */
+ protected $connection;
+
+ /**
+ * The providers configuration.
+ *
+ * @var DomainConfiguration
+ */
+ protected $configuration;
+
+ /**
+ * The providers schema.
+ *
+ * @var SchemaInterface
+ */
+ protected $schema;
+
+ /**
+ * The providers auth guard instance.
+ *
+ * @var GuardInterface
+ */
+ protected $guard;
+
+ /**
+ * The providers cache instance.
+ *
+ * @var Cache|null
+ */
+ protected $cache;
+
+ /**
+ * {@inheritdoc}
+ */
+ public function __construct($configuration = [], ConnectionInterface $connection = null)
+ {
+ $this->setConfiguration($configuration)
+ ->setConnection($connection);
+ }
+
+ /**
+ * Does nothing. Implemented in order to remain backwards compatible.
+ *
+ * @deprecated since v10.3.0
+ */
+ public function __destruct()
+ {
+ //
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function setConfiguration($configuration = [])
+ {
+ if (is_array($configuration)) {
+ $configuration = new DomainConfiguration($configuration);
+ }
+
+ if ($configuration instanceof DomainConfiguration) {
+ $this->configuration = $configuration;
+
+ $schema = $configuration->get('schema');
+
+ // We will update our schema here when our configuration is set.
+ $this->setSchema(new $schema());
+
+ return $this;
+ }
+
+ $class = DomainConfiguration::class;
+
+ throw new InvalidArgumentException(
+ "Configuration must be array or instance of $class"
+ );
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function setConnection(ConnectionInterface $connection = null)
+ {
+ // We will create a standard connection if one isn't given.
+ $this->connection = $connection ?: new Ldap();
+
+ // Prepare the connection.
+ $this->prepareConnection();
+
+ // Instantiate the LDAP connection.
+ $this->connection->connect(
+ $this->configuration->get('hosts'),
+ $this->configuration->get('port')
+ );
+
+ return $this;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function setSchema(SchemaInterface $schema = null)
+ {
+ $this->schema = $schema ?: new ActiveDirectory();
+
+ return $this;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function setGuard(GuardInterface $guard)
+ {
+ $this->guard = $guard;
+
+ return $this;
+ }
+
+ /**
+ * Sets the cache store.
+ *
+ * @param CacheInterface $store
+ *
+ * @return $this
+ */
+ public function setCache(CacheInterface $store)
+ {
+ $this->cache = new Cache($store);
+
+ return $this;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getConfiguration()
+ {
+ return $this->configuration;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getConnection()
+ {
+ return $this->connection;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getSchema()
+ {
+ return $this->schema;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getGuard()
+ {
+ if (!$this->guard instanceof GuardInterface) {
+ $this->setGuard($this->getDefaultGuard($this->connection, $this->configuration));
+ }
+
+ return $this->guard;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getDefaultGuard(ConnectionInterface $connection, DomainConfiguration $configuration)
+ {
+ $guard = new Guard($connection, $configuration);
+
+ $guard->setDispatcher(Adldap::getEventDispatcher());
+
+ return $guard;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function make()
+ {
+ return new ModelFactory(
+ $this->search()->newQuery()
+ );
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function search()
+ {
+ $factory = new SearchFactory(
+ $this->connection,
+ $this->schema,
+ $this->configuration->get('base_dn')
+ );
+
+ if ($this->cache) {
+ $factory->setCache($this->cache);
+ }
+
+ return $factory;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function auth()
+ {
+ return $this->getGuard();
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function connect($username = null, $password = null)
+ {
+ // Get the default guard instance.
+ $guard = $this->getGuard();
+
+ if (is_null($username) && is_null($password)) {
+ // If both the username and password are null, we'll connect to the server
+ // using the configured administrator username and password.
+ $guard->bindAsAdministrator();
+ } else {
+ // Bind to the server with the specified username and password otherwise.
+ $guard->bind($username, $password);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Prepares the connection by setting configured parameters.
+ *
+ * @throws \Adldap\Configuration\ConfigurationException When configuration options requested do not exist
+ *
+ * @return void
+ */
+ protected function prepareConnection()
+ {
+ if ($this->configuration->get('use_ssl')) {
+ $this->connection->ssl();
+ } elseif ($this->configuration->get('use_tls')) {
+ $this->connection->tls();
+ }
+
+ $options = array_replace(
+ $this->configuration->get('custom_options'),
+ [
+ LDAP_OPT_PROTOCOL_VERSION => $this->configuration->get('version'),
+ LDAP_OPT_NETWORK_TIMEOUT => $this->configuration->get('timeout'),
+ LDAP_OPT_REFERRALS => $this->configuration->get('follow_referrals'),
+ ]
+ );
+
+ $this->connection->setOptions($options);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ProviderInterface.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ProviderInterface.php
new file mode 100644
index 0000000..20749a7
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Connections/ProviderInterface.php
@@ -0,0 +1,129 @@
+<?php
+
+namespace Adldap\Connections;
+
+use Adldap\Auth\GuardInterface;
+use Adldap\Schemas\SchemaInterface;
+use Adldap\Configuration\DomainConfiguration;
+
+interface ProviderInterface
+{
+ /**
+ * Constructor.
+ *
+ * @param array|DomainConfiguration $configuration
+ * @param ConnectionInterface $connection
+ */
+ public function __construct($configuration, ConnectionInterface $connection);
+
+ /**
+ * Returns the current connection instance.
+ *
+ * @return ConnectionInterface
+ */
+ public function getConnection();
+
+ /**
+ * Returns the current configuration instance.
+ *
+ * @return DomainConfiguration
+ */
+ public function getConfiguration();
+
+ /**
+ * Returns the current Guard instance.
+ *
+ * @return \Adldap\Auth\Guard
+ */
+ public function getGuard();
+
+ /**
+ * Returns a new default Guard instance.
+ *
+ * @param ConnectionInterface $connection
+ * @param DomainConfiguration $configuration
+ *
+ * @return \Adldap\Auth\Guard
+ */
+ public function getDefaultGuard(ConnectionInterface $connection, DomainConfiguration $configuration);
+
+ /**
+ * Sets the current connection.
+ *
+ * @param ConnectionInterface $connection
+ *
+ * @return $this
+ */
+ public function setConnection(ConnectionInterface $connection = null);
+
+ /**
+ * Sets the current configuration.
+ *
+ * @param DomainConfiguration|array $configuration
+ *
+ * @throws \Adldap\Configuration\ConfigurationException
+ */
+ public function setConfiguration($configuration = []);
+
+ /**
+ * Sets the current LDAP attribute schema.
+ *
+ * @param SchemaInterface|null $schema
+ *
+ * @return $this
+ */
+ public function setSchema(SchemaInterface $schema = null);
+
+ /**
+ * Returns the current LDAP attribute schema.
+ *
+ * @return SchemaInterface
+ */
+ public function getSchema();
+
+ /**
+ * Sets the current Guard instance.
+ *
+ * @param GuardInterface $guard
+ *
+ * @return $this
+ */
+ public function setGuard(GuardInterface $guard);
+
+ /**
+ * Returns a new Model factory instance.
+ *
+ * @return \Adldap\Models\Factory
+ */
+ public function make();
+
+ /**
+ * Returns a new Search factory instance.
+ *
+ * @return \Adldap\Query\Factory
+ */
+ public function search();
+
+ /**
+ * Returns a new Auth Guard instance.
+ *
+ * @return \Adldap\Auth\Guard
+ */
+ public function auth();
+
+ /**
+ * Connects and Binds to the Domain Controller.
+ *
+ * If no username or password is specified, then the
+ * configured administrator credentials are used.
+ *
+ * @param string|null $username
+ * @param string|null $password
+ *
+ * @throws \Adldap\Auth\BindException If binding to the LDAP server fails.
+ * @throws ConnectionException If upgrading the connection to TLS fails
+ *
+ * @return ProviderInterface
+ */
+ public function connect($username = null, $password = null);
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/Dispatcher.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/Dispatcher.php
new file mode 100644
index 0000000..f81f478
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/Dispatcher.php
@@ -0,0 +1,320 @@
+<?php
+
+namespace Adldap\Events;
+
+use Illuminate\Support\Arr;
+
+/**
+ * Class Dispatcher.
+ *
+ * Handles event listening and dispatching.
+ *
+ * This code was taken out of the Laravel Framework core
+ * with broadcasting and queuing omitted to remove
+ * an extra dependency that would be required.
+ *
+ * @author Taylor Otwell
+ *
+ * @see https://github.com/laravel/framework
+ */
+class Dispatcher implements DispatcherInterface
+{
+ /**
+ * The registered event listeners.
+ *
+ * @var array
+ */
+ protected $listeners = [];
+
+ /**
+ * The wildcard listeners.
+ *
+ * @var array
+ */
+ protected $wildcards = [];
+
+ /**
+ * The cached wildcard listeners.
+ *
+ * @var array
+ */
+ protected $wildcardsCache = [];
+
+ /**
+ * {@inheritdoc}
+ */
+ public function listen($events, $listener)
+ {
+ foreach ((array) $events as $event) {
+ if (strpos($event, '*') !== false) {
+ $this->setupWildcardListen($event, $listener);
+ } else {
+ $this->listeners[$event][] = $this->makeListener($listener);
+ }
+ }
+ }
+
+ /**
+ * Setup a wildcard listener callback.
+ *
+ * @param string $event
+ * @param mixed $listener
+ *
+ * @return void
+ */
+ protected function setupWildcardListen($event, $listener)
+ {
+ $this->wildcards[$event][] = $this->makeListener($listener, true);
+
+ $this->wildcardsCache = [];
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function hasListeners($eventName)
+ {
+ return isset($this->listeners[$eventName]) || isset($this->wildcards[$eventName]);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function until($event, $payload = [])
+ {
+ return $this->dispatch($event, $payload, true);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function fire($event, $payload = [], $halt = false)
+ {
+ return $this->dispatch($event, $payload, $halt);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function dispatch($event, $payload = [], $halt = false)
+ {
+ // When the given "event" is actually an object we will assume it is an event
+ // object and use the class as the event name and this event itself as the
+ // payload to the handler, which makes object based events quite simple.
+ list($event, $payload) = $this->parseEventAndPayload(
+ $event,
+ $payload
+ );
+
+ $responses = [];
+
+ foreach ($this->getListeners($event) as $listener) {
+ $response = $listener($event, $payload);
+
+ // If a response is returned from the listener and event halting is enabled
+ // we will just return this response, and not call the rest of the event
+ // listeners. Otherwise we will add the response on the response list.
+ if ($halt && !is_null($response)) {
+ return $response;
+ }
+
+ // If a boolean false is returned from a listener, we will stop propagating
+ // the event to any further listeners down in the chain, else we keep on
+ // looping through the listeners and firing every one in our sequence.
+ if ($response === false) {
+ break;
+ }
+
+ $responses[] = $response;
+ }
+
+ return $halt ? null : $responses;
+ }
+
+ /**
+ * Parse the given event and payload and prepare them for dispatching.
+ *
+ * @param mixed $event
+ * @param mixed $payload
+ *
+ * @return array
+ */
+ protected function parseEventAndPayload($event, $payload)
+ {
+ if (is_object($event)) {
+ list($payload, $event) = [[$event], get_class($event)];
+ }
+
+ return [$event, Arr::wrap($payload)];
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getListeners($eventName)
+ {
+ $listeners = $this->listeners[$eventName] ?? [];
+
+ $listeners = array_merge(
+ $listeners,
+ $this->wildcardsCache[$eventName] ?? $this->getWildcardListeners($eventName)
+ );
+
+ return class_exists($eventName, false)
+ ? $this->addInterfaceListeners($eventName, $listeners)
+ : $listeners;
+ }
+
+ /**
+ * Get the wildcard listeners for the event.
+ *
+ * @param string $eventName
+ *
+ * @return array
+ */
+ protected function getWildcardListeners($eventName)
+ {
+ $wildcards = [];
+
+ foreach ($this->wildcards as $key => $listeners) {
+ if ($this->wildcardContainsEvent($key, $eventName)) {
+ $wildcards = array_merge($wildcards, $listeners);
+ }
+ }
+
+ return $this->wildcardsCache[$eventName] = $wildcards;
+ }
+
+ /**
+ * Determine if the wildcard matches or contains the given event.
+ *
+ * This function is a direct excerpt from Laravel's Str::is().
+ *
+ * @param string $wildcard
+ * @param string $eventName
+ *
+ * @return bool
+ */
+ protected function wildcardContainsEvent($wildcard, $eventName)
+ {
+ $patterns = Arr::wrap($wildcard);
+
+ if (empty($patterns)) {
+ return false;
+ }
+
+ foreach ($patterns as $pattern) {
+ // If the given event is an exact match we can of course return true right
+ // from the beginning. Otherwise, we will translate asterisks and do an
+ // actual pattern match against the two strings to see if they match.
+ if ($pattern == $eventName) {
+ return true;
+ }
+
+ $pattern = preg_quote($pattern, '#');
+
+ // Asterisks are translated into zero-or-more regular expression wildcards
+ // to make it convenient to check if the strings starts with the given
+ // pattern such as "library/*", making any string check convenient.
+ $pattern = str_replace('\*', '.*', $pattern);
+
+ if (preg_match('#^'.$pattern.'\z#u', $eventName) === 1) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Add the listeners for the event's interfaces to the given array.
+ *
+ * @param string $eventName
+ * @param array $listeners
+ *
+ * @return array
+ */
+ protected function addInterfaceListeners($eventName, array $listeners = [])
+ {
+ foreach (class_implements($eventName) as $interface) {
+ if (isset($this->listeners[$interface])) {
+ foreach ($this->listeners[$interface] as $names) {
+ $listeners = array_merge($listeners, (array) $names);
+ }
+ }
+ }
+
+ return $listeners;
+ }
+
+ /**
+ * Register an event listener with the dispatcher.
+ *
+ * @param \Closure|string $listener
+ * @param bool $wildcard
+ *
+ * @return \Closure
+ */
+ public function makeListener($listener, $wildcard = false)
+ {
+ if (is_string($listener)) {
+ return $this->createClassListener($listener, $wildcard);
+ }
+
+ return function ($event, $payload) use ($listener, $wildcard) {
+ if ($wildcard) {
+ return $listener($event, $payload);
+ }
+
+ return $listener(...array_values($payload));
+ };
+ }
+
+ /**
+ * Create a class based listener.
+ *
+ * @param string $listener
+ * @param bool $wildcard
+ *
+ * @return \Closure
+ */
+ protected function createClassListener($listener, $wildcard = false)
+ {
+ return function ($event, $payload) use ($listener, $wildcard) {
+ if ($wildcard) {
+ return call_user_func($this->parseListenerCallback($listener), $event, $payload);
+ }
+
+ return call_user_func_array(
+ $this->parseListenerCallback($listener),
+ $payload
+ );
+ };
+ }
+
+ /**
+ * Parse the class listener into class and method.
+ *
+ * @param string $listener
+ *
+ * @return array
+ */
+ protected function parseListenerCallback($listener)
+ {
+ return strpos($listener, '@') !== false ?
+ explode('@', $listener, 2) :
+ [$listener, 'handle'];
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function forget($event)
+ {
+ if (strpos($event, '*') !== false) {
+ unset($this->wildcards[$event]);
+ } else {
+ unset($this->listeners[$event]);
+ }
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/DispatcherInterface.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/DispatcherInterface.php
new file mode 100644
index 0000000..e014543
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/DispatcherInterface.php
@@ -0,0 +1,75 @@
+<?php
+
+namespace Adldap\Events;
+
+interface DispatcherInterface
+{
+ /**
+ * Register an event listener with the dispatcher.
+ *
+ * @param string|array $events
+ * @param mixed $listener
+ *
+ * @return void
+ */
+ public function listen($events, $listener);
+
+ /**
+ * Determine if a given event has listeners.
+ *
+ * @param string $eventName
+ *
+ * @return bool
+ */
+ public function hasListeners($eventName);
+
+ /**
+ * Fire an event until the first non-null response is returned.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ *
+ * @return array|null
+ */
+ public function until($event, $payload = []);
+
+ /**
+ * Fire an event and call the listeners.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ * @param bool $halt
+ *
+ * @return mixed
+ */
+ public function fire($event, $payload = [], $halt = false);
+
+ /**
+ * Fire an event and call the listeners.
+ *
+ * @param string|object $event
+ * @param mixed $payload
+ * @param bool $halt
+ *
+ * @return array|null
+ */
+ public function dispatch($event, $payload = [], $halt = false);
+
+ /**
+ * Get all of the listeners for a given event name.
+ *
+ * @param string $eventName
+ *
+ * @return array
+ */
+ public function getListeners($eventName);
+
+ /**
+ * Remove a set of listeners from the dispatcher.
+ *
+ * @param string $event
+ *
+ * @return void
+ */
+ public function forget($event);
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/DispatchesEvents.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/DispatchesEvents.php
new file mode 100644
index 0000000..f530ba4
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Events/DispatchesEvents.php
@@ -0,0 +1,51 @@
+<?php
+
+namespace Adldap\Events;
+
+trait DispatchesEvents
+{
+ /**
+ * The event dispatcher instance.
+ *
+ * @var DispatcherInterface
+ */
+ protected static $dispatcher;
+
+ /**
+ * Get the event dispatcher instance.
+ *
+ * @return DispatcherInterface
+ */
+ public static function getEventDispatcher()
+ {
+ // If no event dispatcher has been set, well instantiate and
+ // set one here. This will be our singleton instance.
+ if (!isset(static::$dispatcher)) {
+ static::setEventDispatcher(new Dispatcher());
+ }
+
+ return static::$dispatcher;
+ }
+
+ /**
+ * Set the event dispatcher instance.
+ *
+ * @param DispatcherInterface $dispatcher
+ *
+ * @return void
+ */
+ public static function setEventDispatcher(DispatcherInterface $dispatcher)
+ {
+ static::$dispatcher = $dispatcher;
+ }
+
+ /**
+ * Unset the event dispatcher instance.
+ *
+ * @return void
+ */
+ public static function unsetEventDispatcher()
+ {
+ static::$dispatcher = null;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Log/EventLogger.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Log/EventLogger.php
new file mode 100644
index 0000000..37d36b8
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Log/EventLogger.php
@@ -0,0 +1,141 @@
+<?php
+
+namespace Adldap\Log;
+
+use ReflectionClass;
+use Psr\Log\LoggerInterface;
+use Adldap\Auth\Events\Failed;
+use Adldap\Auth\Events\Event as AuthEvent;
+use Adldap\Models\Events\Event as ModelEvent;
+use Adldap\Query\Events\QueryExecuted as QueryEvent;
+
+class EventLogger
+{
+ /**
+ * The logger instance.
+ *
+ * @var LoggerInterface|null
+ */
+ protected $logger;
+
+ /**
+ * Constructor.
+ *
+ * @param LoggerInterface $logger
+ */
+ public function __construct(LoggerInterface $logger = null)
+ {
+ $this->logger = $logger;
+ }
+
+ /**
+ * Logs the given event.
+ *
+ * @param mixed $event
+ */
+ public function log($event)
+ {
+ if ($event instanceof AuthEvent) {
+ $this->auth($event);
+ } elseif ($event instanceof ModelEvent) {
+ $this->model($event);
+ } elseif ($event instanceof QueryEvent) {
+ $this->query($event);
+ }
+ }
+
+ /**
+ * Logs an authentication event.
+ *
+ * @param AuthEvent $event
+ *
+ * @return void
+ */
+ public function auth(AuthEvent $event)
+ {
+ if (isset($this->logger)) {
+ $connection = $event->getConnection();
+
+ $message = "LDAP ({$connection->getHost()})"
+ ." - Connection: {$connection->getName()}"
+ ." - Operation: {$this->getOperationName($event)}"
+ ." - Username: {$event->getUsername()}";
+
+ $result = null;
+ $type = 'info';
+
+ if (is_a($event, Failed::class)) {
+ $type = 'warning';
+ $result = " - Reason: {$connection->getLastError()}";
+ }
+
+ $this->logger->$type($message.$result);
+ }
+ }
+
+ /**
+ * Logs a model event.
+ *
+ * @param ModelEvent $event
+ *
+ * @return void
+ */
+ public function model(ModelEvent $event)
+ {
+ if (isset($this->logger)) {
+ $model = $event->getModel();
+
+ $on = get_class($model);
+
+ $connection = $model->getQuery()->getConnection();
+
+ $message = "LDAP ({$connection->getHost()})"
+ ." - Connection: {$connection->getName()}"
+ ." - Operation: {$this->getOperationName($event)}"
+ ." - On: {$on}"
+ ." - Distinguished Name: {$model->getDn()}";
+
+ $this->logger->info($message);
+ }
+ }
+
+ /**
+ * Logs a query event.
+ *
+ * @param QueryEvent $event
+ *
+ * @return void
+ */
+ public function query(QueryEvent $event)
+ {
+ if (isset($this->logger)) {
+ $query = $event->getQuery();
+
+ $connection = $query->getConnection();
+
+ $selected = implode(',', $query->getSelects());
+
+ $message = "LDAP ({$connection->getHost()})"
+ ." - Connection: {$connection->getName()}"
+ ." - Operation: {$this->getOperationName($event)}"
+ ." - Base DN: {$query->getDn()}"
+ ." - Filter: {$query->getUnescapedQuery()}"
+ ." - Selected: ({$selected})"
+ ." - Time Elapsed: {$event->getTime()}";
+
+ $this->logger->info($message);
+ }
+ }
+
+ /**
+ * Returns the operational name of the given event.
+ *
+ * @param mixed $event
+ *
+ * @return string
+ */
+ protected function getOperationName($event)
+ {
+ return (new ReflectionClass($event))->getShortName();
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Log/LogsInformation.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Log/LogsInformation.php
new file mode 100644
index 0000000..d6f5191
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Log/LogsInformation.php
@@ -0,0 +1,47 @@
+<?php
+
+namespace Adldap\Log;
+
+use Psr\Log\LoggerInterface;
+
+trait LogsInformation
+{
+ /**
+ * The logger instance.
+ *
+ * @var LoggerInterface|null
+ */
+ protected static $logger;
+
+ /**
+ * Get the logger instance.
+ *
+ * @return LoggerInterface|null
+ */
+ public static function getLogger()
+ {
+ return static::$logger;
+ }
+
+ /**
+ * Set the logger instance.
+ *
+ * @param LoggerInterface $logger
+ *
+ * @return void
+ */
+ public static function setLogger(LoggerInterface $logger)
+ {
+ static::$logger = $logger;
+ }
+
+ /**
+ * Unset the logger instance.
+ *
+ * @return void
+ */
+ public static function unsetLogger()
+ {
+ static::$logger = null;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/AccountControl.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/AccountControl.php
new file mode 100644
index 0000000..89fd8a4
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/AccountControl.php
@@ -0,0 +1,458 @@
+<?php
+
+namespace Adldap\Models\Attributes;
+
+use ReflectionClass;
+
+/**
+ * The Account Control class.
+ *
+ * This class is for easily building a user account control value.
+ *
+ * @link https://support.microsoft.com/en-us/kb/305144
+ */
+class AccountControl
+{
+ const SCRIPT = 1;
+
+ const ACCOUNTDISABLE = 2;
+
+ const HOMEDIR_REQUIRED = 8;
+
+ const LOCKOUT = 16;
+
+ const PASSWD_NOTREQD = 32;
+
+ const ENCRYPTED_TEXT_PWD_ALLOWED = 128;
+
+ const TEMP_DUPLICATE_ACCOUNT = 256;
+
+ const NORMAL_ACCOUNT = 512;
+
+ const INTERDOMAIN_TRUST_ACCOUNT = 2048;
+
+ const WORKSTATION_TRUST_ACCOUNT = 4096;
+
+ const SERVER_TRUST_ACCOUNT = 8192;
+
+ const DONT_EXPIRE_PASSWORD = 65536;
+
+ const MNS_LOGON_ACCOUNT = 131072;
+
+ const SMARTCARD_REQUIRED = 262144;
+
+ const TRUSTED_FOR_DELEGATION = 524288;
+
+ const NOT_DELEGATED = 1048576;
+
+ const USE_DES_KEY_ONLY = 2097152;
+
+ const DONT_REQ_PREAUTH = 4194304;
+
+ const PASSWORD_EXPIRED = 8388608;
+
+ const TRUSTED_TO_AUTH_FOR_DELEGATION = 16777216;
+
+ const PARTIAL_SECRETS_ACCOUNT = 67108864;
+
+ /**
+ * Stores the values to be added together to
+ * build the user account control integer.
+ *
+ * @var array
+ */
+ protected $values = [];
+
+ /**
+ * Constructor.
+ *
+ * @param int $flag
+ */
+ public function __construct($flag = null)
+ {
+ if (!is_null($flag)) {
+ $this->apply($flag);
+ }
+ }
+
+ /**
+ * Get the value when casted to string.
+ *
+ * @return string
+ */
+ public function __toString()
+ {
+ return (string) $this->getValue();
+ }
+
+ /**
+ * Get the value when casted to int.
+ *
+ * @return int
+ */
+ public function __toInt()
+ {
+ return $this->getValue();
+ }
+
+ /**
+ * Add the value to the account control values.
+ *
+ * @param int $value
+ *
+ * @return AccountControl
+ */
+ public function add($value)
+ {
+ // Use the value as a key so if the same value
+ // is used, it will always be overwritten
+ $this->values[$value] = $value;
+
+ return $this;
+ }
+
+ /**
+ * Remove the value from the account control.
+ *
+ * @param int $value
+ *
+ * @return $this
+ */
+ public function remove($value)
+ {
+ unset($this->values[$value]);
+
+ return $this;
+ }
+
+ /**
+ * Extract and apply the flag.
+ *
+ * @param int $flag
+ */
+ public function apply($flag)
+ {
+ $this->setValues($this->extractFlags($flag));
+ }
+
+ /**
+ * Determine if the current AccountControl object contains the given UAC flag(s).
+ *
+ * @param int $flag
+ *
+ * @return bool
+ */
+ public function has($flag)
+ {
+ // We'll extract the given flag into an array of possible flags, and
+ // see if our AccountControl object contains any of them.
+ $flagsUsed = array_intersect($this->extractFlags($flag), $this->values);
+
+ return in_array($flag, $flagsUsed);
+ }
+
+ /**
+ * The logon script will be run.
+ *
+ * @return AccountControl
+ */
+ public function runLoginScript()
+ {
+ return $this->add(static::SCRIPT);
+ }
+
+ /**
+ * The user account is locked.
+ *
+ * @return AccountControl
+ */
+ public function accountIsLocked()
+ {
+ return $this->add(static::LOCKOUT);
+ }
+
+ /**
+ * The user account is disabled.
+ *
+ * @return AccountControl
+ */
+ public function accountIsDisabled()
+ {
+ return $this->add(static::ACCOUNTDISABLE);
+ }
+
+ /**
+ * This is an account for users whose primary account is in another domain.
+ *
+ * This account provides user access to this domain, but not to any domain that
+ * trusts this domain. This is sometimes referred to as a local user account.
+ *
+ * @return AccountControl
+ */
+ public function accountIsTemporary()
+ {
+ return $this->add(static::TEMP_DUPLICATE_ACCOUNT);
+ }
+
+ /**
+ * This is a default account type that represents a typical user.
+ *
+ * @return AccountControl
+ */
+ public function accountIsNormal()
+ {
+ return $this->add(static::NORMAL_ACCOUNT);
+ }
+
+ /**
+ * This is a permit to trust an account for a system domain that trusts other domains.
+ *
+ * @return AccountControl
+ */
+ public function accountIsForInterdomain()
+ {
+ return $this->add(static::INTERDOMAIN_TRUST_ACCOUNT);
+ }
+
+ /**
+ * This is a computer account for a computer that is running Microsoft
+ * Windows NT 4.0 Workstation, Microsoft Windows NT 4.0 Server, Microsoft
+ * Windows 2000 Professional, or Windows 2000 Server and is a member of this domain.
+ *
+ * @return AccountControl
+ */
+ public function accountIsForWorkstation()
+ {
+ return $this->add(static::WORKSTATION_TRUST_ACCOUNT);
+ }
+
+ /**
+ * This is a computer account for a domain controller that is a member of this domain.
+ *
+ * @return AccountControl
+ */
+ public function accountIsForServer()
+ {
+ return $this->add(static::SERVER_TRUST_ACCOUNT);
+ }
+
+ /**
+ * This is an MNS logon account.
+ *
+ * @return AccountControl
+ */
+ public function accountIsMnsLogon()
+ {
+ return $this->add(static::MNS_LOGON_ACCOUNT);
+ }
+
+ /**
+ * (Windows 2000/Windows Server 2003) This account does
+ * not require Kerberos pre-authentication for logging on.
+ *
+ * @return AccountControl
+ */
+ public function accountDoesNotRequirePreAuth()
+ {
+ return $this->add(static::DONT_REQ_PREAUTH);
+ }
+
+ /**
+ * When this flag is set, it forces the user to log on by using a smart card.
+ *
+ * @return AccountControl
+ */
+ public function accountRequiresSmartCard()
+ {
+ return $this->add(static::SMARTCARD_REQUIRED);
+ }
+
+ /**
+ * (Windows Server 2008/Windows Server 2008 R2) The account is a read-only domain controller (RODC).
+ *
+ * This is a security-sensitive setting. Removing this setting from an RODC compromises security on that server.
+ *
+ * @return AccountControl
+ */
+ public function accountIsReadOnly()
+ {
+ return $this->add(static::PARTIAL_SECRETS_ACCOUNT);
+ }
+
+ /**
+ * The home folder is required.
+ *
+ * @return AccountControl
+ */
+ public function homeFolderIsRequired()
+ {
+ return $this->add(static::HOMEDIR_REQUIRED);
+ }
+
+ /**
+ * No password is required.
+ *
+ * @return AccountControl
+ */
+ public function passwordIsNotRequired()
+ {
+ return $this->add(static::PASSWD_NOTREQD);
+ }
+
+ /**
+ * The user cannot change the password. This is a permission on the user's object.
+ *
+ * For information about how to programmatically set this permission, visit the following link:
+ *
+ * @link http://msdn2.microsoft.com/en-us/library/aa746398.aspx
+ *
+ * @return AccountControl
+ */
+ public function passwordCannotBeChanged()
+ {
+ return $this->add(static::PASSWD_NOTREQD);
+ }
+
+ /**
+ * Represents the password, which should never expire on the account.
+ *
+ * @return AccountControl
+ */
+ public function passwordDoesNotExpire()
+ {
+ return $this->add(static::DONT_EXPIRE_PASSWORD);
+ }
+
+ /**
+ * (Windows 2000/Windows Server 2003) The user's password has expired.
+ *
+ * @return AccountControl
+ */
+ public function passwordIsExpired()
+ {
+ return $this->add(static::PASSWORD_EXPIRED);
+ }
+
+ /**
+ * The user can send an encrypted password.
+ *
+ * @return AccountControl
+ */
+ public function allowEncryptedTextPassword()
+ {
+ return $this->add(static::ENCRYPTED_TEXT_PWD_ALLOWED);
+ }
+
+ /**
+ * When this flag is set, the service account (the user or computer account)
+ * under which a service runs is trusted for Kerberos delegation.
+ *
+ * Any such service can impersonate a client requesting the service.
+ *
+ * To enable a service for Kerberos delegation, you must set this
+ * flag on the userAccountControl property of the service account.
+ *
+ * @return AccountControl
+ */
+ public function trustForDelegation()
+ {
+ return $this->add(static::TRUSTED_FOR_DELEGATION);
+ }
+
+ /**
+ * (Windows 2000/Windows Server 2003) The account is enabled for delegation.
+ *
+ * This is a security-sensitive setting. Accounts that have this option enabled
+ * should be tightly controlled. This setting lets a service that runs under the
+ * account assume a client's identity and authenticate as that user to other remote
+ * servers on the network.
+ *
+ * @return AccountControl
+ */
+ public function trustToAuthForDelegation()
+ {
+ return $this->add(static::TRUSTED_TO_AUTH_FOR_DELEGATION);
+ }
+
+ /**
+ * When this flag is set, the security context of the user is not delegated to a
+ * service even if the service account is set as trusted for Kerberos delegation.
+ *
+ * @return AccountControl
+ */
+ public function doNotTrustForDelegation()
+ {
+ return $this->add(static::NOT_DELEGATED);
+ }
+
+ /**
+ * (Windows 2000/Windows Server 2003) Restrict this principal to
+ * use only Data Encryption Standard (DES) encryption types for keys.
+ *
+ * @return AccountControl
+ */
+ public function useDesKeyOnly()
+ {
+ return $this->add(static::USE_DES_KEY_ONLY);
+ }
+
+ /**
+ * Get the account control value.
+ *
+ * @return int
+ */
+ public function getValue()
+ {
+ return array_sum($this->values);
+ }
+
+ /**
+ * Get the account control flag values.
+ *
+ * @return array
+ */
+ public function getValues()
+ {
+ return $this->values;
+ }
+
+ /**
+ * Set the account control values.
+ *
+ * @param array $flags
+ */
+ public function setValues(array $flags)
+ {
+ $this->values = $flags;
+ }
+
+ /**
+ * Get all possible account control flags.
+ *
+ * @return array
+ */
+ public function getAllFlags()
+ {
+ return (new ReflectionClass(__CLASS__))->getConstants();
+ }
+
+ /**
+ * Extracts the given flag into an array of flags used.
+ *
+ * @param int $flag
+ *
+ * @return array
+ */
+ public function extractFlags($flag)
+ {
+ $flags = [];
+
+ for ($i = 0; $i <= 26; $i++) {
+ if ((int) $flag & (1 << $i)) {
+ $flags[1 << $i] = 1 << $i;
+ }
+ }
+
+ return $flags;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/DistinguishedName.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/DistinguishedName.php
new file mode 100644
index 0000000..e610dbf
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/DistinguishedName.php
@@ -0,0 +1,312 @@
+<?php
+
+namespace Adldap\Models\Attributes;
+
+use Adldap\Utilities;
+
+class DistinguishedName
+{
+ /**
+ * The distinguished name components (in order of assembly).
+ *
+ * @var array
+ */
+ protected $components = [
+ 'cn' => [],
+ 'uid' => [],
+ 'ou' => [],
+ 'dc' => [],
+ 'o' => [],
+ ];
+
+ /**
+ * Constructor.
+ *
+ * @param mixed $baseDn
+ */
+ public function __construct($baseDn = null)
+ {
+ $this->setBase($baseDn);
+ }
+
+ /**
+ * Returns the complete distinguished name.
+ *
+ * @return string
+ */
+ public function __toString()
+ {
+ return $this->get();
+ }
+
+ /**
+ * Returns the complete distinguished name by assembling the RDN components.
+ *
+ * @return string
+ */
+ public function get()
+ {
+ $components = [];
+
+ // We'll go through each component type and assemble its RDN.
+ foreach ($this->components as $component => $values) {
+ array_map(function ($value) use ($component, &$components) {
+ // Assemble the component and escape the value.
+ $components[] = sprintf('%s=%s', $component, ldap_escape($value, '', 2));
+ }, $values);
+ }
+
+ return implode(',', $components);
+ }
+
+ /**
+ * Adds a domain component.
+ *
+ * @param string $dc
+ *
+ * @return DistinguishedName
+ */
+ public function addDc($dc)
+ {
+ $this->addComponent('dc', $dc);
+
+ return $this;
+ }
+
+ /**
+ * Removes a domain component.
+ *
+ * @param string $dc
+ *
+ * @return DistinguishedName
+ */
+ public function removeDc($dc)
+ {
+ $this->removeComponent('dc', $dc);
+
+ return $this;
+ }
+
+ /**
+ * Adds an organization name.
+ *
+ * @param string $o
+ *
+ * @return $this
+ */
+ public function addO($o)
+ {
+ $this->addComponent('o', $o);
+
+ return $this;
+ }
+
+ /**
+ * Removes an organization name.
+ *
+ * @param string $o
+ *
+ * @return DistinguishedName
+ */
+ public function removeO($o)
+ {
+ $this->removeComponent('o', $o);
+
+ return $this;
+ }
+
+ /**
+ * Add a user identifier.
+ *
+ * @param string $uid
+ *
+ * @return DistinguishedName
+ */
+ public function addUid($uid)
+ {
+ $this->addComponent('uid', $uid);
+
+ return $this;
+ }
+
+ /**
+ * Removes a user identifier.
+ *
+ * @param string $uid
+ *
+ * @return DistinguishedName
+ */
+ public function removeUid($uid)
+ {
+ $this->removeComponent('uid', $uid);
+
+ return $this;
+ }
+
+ /**
+ * Adds a common name.
+ *
+ * @param string $cn
+ *
+ * @return DistinguishedName
+ */
+ public function addCn($cn)
+ {
+ $this->addComponent('cn', $cn);
+
+ return $this;
+ }
+
+ /**
+ * Removes a common name.
+ *
+ * @param string $cn
+ *
+ * @return DistinguishedName
+ */
+ public function removeCn($cn)
+ {
+ $this->removeComponent('cn', $cn);
+
+ return $this;
+ }
+
+ /**
+ * Adds an organizational unit.
+ *
+ * @param string $ou
+ *
+ * @return DistinguishedName
+ */
+ public function addOu($ou)
+ {
+ $this->addComponent('ou', $ou);
+
+ return $this;
+ }
+
+ /**
+ * Removes an organizational unit.
+ *
+ * @param string $ou
+ *
+ * @return DistinguishedName
+ */
+ public function removeOu($ou)
+ {
+ $this->removeComponent('ou', $ou);
+
+ return $this;
+ }
+
+ /**
+ * Sets the base RDN of the distinguished name.
+ *
+ * @param string|DistinguishedName $base
+ *
+ * @return DistinguishedName
+ */
+ public function setBase($base)
+ {
+ // Typecast base to string in case we've been given
+ // an instance of the distinguished name object.
+ $base = (string) $base;
+
+ // If the base DN isn't null we'll try to explode it.
+ $base = Utilities::explodeDn($base, false) ?: [];
+
+ // Remove the count key from the exploded distinguished name.
+ unset($base['count']);
+
+ foreach ($base as $key => $rdn) {
+ // We'll break the RDN into pieces
+ $pieces = explode('=', $rdn) ?: [];
+
+ // If there's exactly 2 pieces, then we can work with it.
+ if (count($pieces) === 2) {
+ $attribute = ucfirst(strtolower($pieces[0]));
+
+ $method = 'add'.$attribute;
+
+ if (method_exists($this, $method)) {
+ // We see what type of RDN it is and add each accordingly.
+ call_user_func_array([$this, $method], [$pieces[1]]);
+ }
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Returns an array of all components in the distinguished name.
+ *
+ * If a component name is given ('cn', 'dc' for example) then
+ * the values of that component will be returned.
+ *
+ * @param string|null $component The component to retrieve values of
+ *
+ * @return array
+ */
+ public function getComponents($component = null)
+ {
+ if (is_null($component)) {
+ return $this->components;
+ }
+
+ $this->validateComponentExists($component);
+
+ return $this->components[$component];
+ }
+
+ /**
+ * Adds a component to the distinguished name.
+ *
+ * @param string $component
+ * @param string $value
+ *
+ * @throws \UnexpectedValueException When the given name does not exist.
+ */
+ protected function addComponent($component, $value)
+ {
+ $this->validateComponentExists($component);
+
+ // We need to make sure the value we're given isn't empty before adding it into our components.
+ if (!empty($value)) {
+ $this->components[$component][] = $value;
+ }
+ }
+
+ /**
+ * Removes the given value from the given component.
+ *
+ * @param string $component
+ * @param string $value
+ *
+ * @throws \UnexpectedValueException When the given component does not exist.
+ *
+ * @return void
+ */
+ protected function removeComponent($component, $value)
+ {
+ $this->validateComponentExists($component);
+
+ $this->components[$component] = array_diff($this->components[$component], [$value]);
+ }
+
+ /**
+ * Validates that the given component exists in the available components.
+ *
+ * @param string $component The name of the component to validate.
+ *
+ * @throws \UnexpectedValueException When the given component does not exist.
+ *
+ * @return void
+ */
+ protected function validateComponentExists($component)
+ {
+ if (!array_key_exists($component, $this->components)) {
+ throw new \UnexpectedValueException("The RDN component '$component' does not exist.");
+ }
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/Guid.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/Guid.php
new file mode 100644
index 0000000..6c6a600
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/Guid.php
@@ -0,0 +1,157 @@
+<?php
+
+namespace Adldap\Models\Attributes;
+
+use Adldap\Utilities;
+use InvalidArgumentException;
+
+class Guid
+{
+ /**
+ * The string GUID value.
+ *
+ * @var string
+ */
+ protected $value;
+
+ /**
+ * The guid structure in order by section to parse using substr().
+ *
+ * @author Chad Sikorra <Chad.Sikorra@gmail.com>
+ *
+ * @link https://github.com/ldaptools/ldaptools
+ *
+ * @var array
+ */
+ protected $guidSections = [
+ [[-26, 2], [-28, 2], [-30, 2], [-32, 2]],
+ [[-22, 2], [-24, 2]],
+ [[-18, 2], [-20, 2]],
+ [[-16, 4]],
+ [[-12, 12]],
+ ];
+
+ /**
+ * The hexadecimal octet order based on string position.
+ *
+ * @author Chad Sikorra <Chad.Sikorra@gmail.com>
+ *
+ * @link https://github.com/ldaptools/ldaptools
+ *
+ * @var array
+ */
+ protected $octetSections = [
+ [6, 4, 2, 0],
+ [10, 8],
+ [14, 12],
+ [16, 18, 20, 22, 24, 26, 28, 30],
+ ];
+
+ /**
+ * Determines if the specified GUID is valid.
+ *
+ * @param string $guid
+ *
+ * @return bool
+ */
+ public static function isValid($guid)
+ {
+ return Utilities::isValidGuid($guid);
+ }
+
+ /**
+ * Constructor.
+ *
+ * @param mixed $value
+ *
+ * @throws InvalidArgumentException
+ */
+ public function __construct($value)
+ {
+ if (static::isValid($value)) {
+ $this->value = $value;
+ } elseif ($value = $this->binaryGuidToString($value)) {
+ $this->value = $value;
+ } else {
+ throw new InvalidArgumentException('Invalid Binary / String GUID.');
+ }
+ }
+
+ /**
+ * Returns the string value of the GUID.
+ *
+ * @return string
+ */
+ public function __toString()
+ {
+ return $this->getValue();
+ }
+
+ /**
+ * Returns the string value of the SID.
+ *
+ * @return string
+ */
+ public function getValue()
+ {
+ return $this->value;
+ }
+
+ /**
+ * Get the binary representation of the GUID string.
+ *
+ * @return string
+ */
+ public function getBinary()
+ {
+ $data = '';
+
+ $guid = str_replace('-', '', $this->value);
+
+ foreach ($this->octetSections as $section) {
+ $data .= $this->parseSection($guid, $section, true);
+ }
+
+ return hex2bin($data);
+ }
+
+ /**
+ * Returns the string variant of a binary GUID.
+ *
+ * @param string $binary
+ *
+ * @return string|null
+ */
+ protected function binaryGuidToString($binary)
+ {
+ return Utilities::binaryGuidToString($binary);
+ }
+
+ /**
+ * Return the specified section of the hexadecimal string.
+ *
+ * @author Chad Sikorra <Chad.Sikorra@gmail.com>
+ *
+ * @link https://github.com/ldaptools/ldaptools
+ *
+ * @param string $hex The full hex string.
+ * @param array $sections An array of start and length (unless octet is true, then length is always 2).
+ * @param bool $octet Whether this is for octet string form.
+ *
+ * @return string The concatenated sections in upper-case.
+ */
+ protected function parseSection($hex, array $sections, $octet = false)
+ {
+ $parsedString = '';
+
+ foreach ($sections as $section) {
+ $start = $octet ? $section : $section[0];
+
+ $length = $octet ? 2 : $section[1];
+
+ $parsedString .= substr($hex, $start, $length);
+ }
+
+ return $parsedString;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/MbString.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/MbString.php
new file mode 100644
index 0000000..54a0db8
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/MbString.php
@@ -0,0 +1,80 @@
+<?php
+
+namespace Adldap\Models\Attributes;
+
+class MbString
+{
+ /**
+ * Get the integer value of a specific character.
+ *
+ * @param $string
+ *
+ * @return int
+ */
+ public static function ord($string)
+ {
+ if (self::isLoaded()) {
+ $result = unpack('N', mb_convert_encoding($string, 'UCS-4BE', 'UTF-8'));
+
+ if (is_array($result) === true) {
+ return $result[1];
+ }
+ }
+
+ return ord($string);
+ }
+
+ /**
+ * Get the character for a specific integer value.
+ *
+ * @param $int
+ *
+ * @return string
+ */
+ public static function chr($int)
+ {
+ if (self::isLoaded()) {
+ return mb_convert_encoding(pack('n', $int), 'UTF-8', 'UTF-16BE');
+ }
+
+ return chr($int);
+ }
+
+ /**
+ * Split a string into its individual characters and return it as an array.
+ *
+ * @param string $value
+ *
+ * @return string[]
+ */
+ public static function split($value)
+ {
+ return preg_split('/(?<!^)(?!$)/u', $value);
+ }
+
+ /**
+ * Detects if the given string is UTF 8.
+ *
+ * @param $string
+ *
+ * @return string|false
+ */
+ public static function isUtf8($string)
+ {
+ if (self::isLoaded()) {
+ return mb_detect_encoding($string, 'UTF-8', $strict = true);
+ }
+
+ return $string;
+ }
+
+ /**
+ * Checks if the mbstring extension is enabled in PHP.
+ *
+ * @return bool
+ */
+ public static function isLoaded()
+ {
+ return extension_loaded('mbstring');
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/Sid.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/Sid.php
new file mode 100644
index 0000000..a599e2c
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/Sid.php
@@ -0,0 +1,101 @@
+<?php
+
+namespace Adldap\Models\Attributes;
+
+use Adldap\Utilities;
+use InvalidArgumentException;
+
+class Sid
+{
+ /**
+ * The string SID value.
+ *
+ * @var string
+ */
+ protected $value;
+
+ /**
+ * Determines if the specified SID is valid.
+ *
+ * @param string $sid
+ *
+ * @return bool
+ */
+ public static function isValid($sid)
+ {
+ return Utilities::isValidSid($sid);
+ }
+
+ /**
+ * Constructor.
+ *
+ * @param mixed $value
+ *
+ * @throws InvalidArgumentException
+ */
+ public function __construct($value)
+ {
+ if (static::isValid($value)) {
+ $this->value = $value;
+ } elseif ($value = $this->binarySidToString($value)) {
+ $this->value = $value;
+ } else {
+ throw new InvalidArgumentException('Invalid Binary / String SID.');
+ }
+ }
+
+ /**
+ * Returns the string value of the SID.
+ *
+ * @return string
+ */
+ public function __toString()
+ {
+ return $this->getValue();
+ }
+
+ /**
+ * Returns the string value of the SID.
+ *
+ * @return string
+ */
+ public function getValue()
+ {
+ return $this->value;
+ }
+
+ /**
+ * Returns the binary variant of the SID.
+ *
+ * @return string
+ */
+ public function getBinary()
+ {
+ $sid = explode('-', ltrim($this->value, 'S-'));
+
+ $level = (int) array_shift($sid);
+
+ $authority = (int) array_shift($sid);
+
+ $subAuthorities = array_map('intval', $sid);
+
+ $params = array_merge(
+ ['C2xxNV*', $level, count($subAuthorities), $authority],
+ $subAuthorities
+ );
+
+ return call_user_func_array('pack', $params);
+ }
+
+ /**
+ * Returns the string variant of a binary SID.
+ *
+ * @param string $binary
+ *
+ * @return string|null
+ */
+ protected function binarySidToString($binary)
+ {
+ return Utilities::binarySidToString($binary);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/TSProperty.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/TSProperty.php
new file mode 100644
index 0000000..aa3d63c
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/TSProperty.php
@@ -0,0 +1,396 @@
+<?php
+
+namespace Adldap\Models\Attributes;
+
+class TSProperty
+{
+ /**
+ * Nibble control values. The first value for each is if the nibble is <= 9, otherwise the second value is used.
+ */
+ const NIBBLE_CONTROL = [
+ 'X' => ['001011', '011010'],
+ 'Y' => ['001110', '011010'],
+ ];
+
+ /**
+ * The nibble header.
+ */
+ const NIBBLE_HEADER = '1110';
+
+ /**
+ * Conversion factor needed for time values in the TSPropertyArray (stored in microseconds).
+ */
+ const TIME_CONVERSION = 60 * 1000;
+
+ /**
+ * A simple map to help determine how the property needs to be decoded/encoded from/to its binary value.
+ *
+ * There are some names that are simple repeats but have 'W' at the end. Not sure as to what that signifies. I
+ * cannot find any information on them in Microsoft documentation. However, their values appear to stay in sync with
+ * their non 'W' counterparts. But not doing so when manipulating the data manually does not seem to affect anything.
+ * This probably needs more investigation.
+ *
+ * @var array
+ */
+ protected $propTypes = [
+ 'string' => [
+ 'CtxWFHomeDir',
+ 'CtxWFHomeDirW',
+ 'CtxWFHomeDirDrive',
+ 'CtxWFHomeDirDriveW',
+ 'CtxInitialProgram',
+ 'CtxInitialProgramW',
+ 'CtxWFProfilePath',
+ 'CtxWFProfilePathW',
+ 'CtxWorkDirectory',
+ 'CtxWorkDirectoryW',
+ 'CtxCallbackNumber',
+ ],
+ 'time' => [
+ 'CtxMaxDisconnectionTime',
+ 'CtxMaxConnectionTime',
+ 'CtxMaxIdleTime',
+ ],
+ 'int' => [
+ 'CtxCfgFlags1',
+ 'CtxCfgPresent',
+ 'CtxKeyboardLayout',
+ 'CtxMinEncryptionLevel',
+ 'CtxNWLogonServer',
+ 'CtxShadow',
+ ],
+ ];
+
+ /**
+ * The property name.
+ *
+ * @var string
+ */
+ protected $name;
+
+ /**
+ * The property value.
+ *
+ * @var string|int
+ */
+ protected $value;
+
+ /**
+ * The property value type.
+ *
+ * @var int
+ */
+ protected $valueType = 1;
+
+ /**
+ * Pass binary TSProperty data to construct its object representation.
+ *
+ * @param string|null $value
+ */
+ public function __construct($value = null)
+ {
+ if ($value) {
+ $this->decode(bin2hex($value));
+ }
+ }
+
+ /**
+ * Set the name for the TSProperty.
+ *
+ * @param string $name
+ *
+ * @return TSProperty
+ */
+ public function setName($name)
+ {
+ $this->name = $name;
+
+ return $this;
+ }
+
+ /**
+ * Get the name for the TSProperty.
+ *
+ * @return string
+ */
+ public function getName()
+ {
+ return $this->name;
+ }
+
+ /**
+ * Set the value for the TSProperty.
+ *
+ * @param string|int $value
+ *
+ * @return TSProperty
+ */
+ public function setValue($value)
+ {
+ $this->value = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get the value for the TSProperty.
+ *
+ * @return string|int
+ */
+ public function getValue()
+ {
+ return $this->value;
+ }
+
+ /**
+ * Convert the TSProperty name/value back to its binary
+ * representation for the userParameters blob.
+ *
+ * @return string
+ */
+ public function toBinary()
+ {
+ $name = bin2hex($this->name);
+
+ $binValue = $this->getEncodedValueForProp($this->name, $this->value);
+
+ $valueLen = strlen(bin2hex($binValue)) / 3;
+
+ $binary = hex2bin(
+ $this->dec2hex(strlen($name))
+ .$this->dec2hex($valueLen)
+ .$this->dec2hex($this->valueType)
+ .$name
+ );
+
+ return $binary.$binValue;
+ }
+
+ /**
+ * Given a TSProperty blob, decode the name/value/type/etc.
+ *
+ * @param string $tsProperty
+ */
+ protected function decode($tsProperty)
+ {
+ $nameLength = hexdec(substr($tsProperty, 0, 2));
+
+ // 1 data byte is 3 encoded bytes
+ $valueLength = hexdec(substr($tsProperty, 2, 2)) * 3;
+
+ $this->valueType = hexdec(substr($tsProperty, 4, 2));
+ $this->name = pack('H*', substr($tsProperty, 6, $nameLength));
+ $this->value = $this->getDecodedValueForProp($this->name, substr($tsProperty, 6 + $nameLength, $valueLength));
+ }
+
+ /**
+ * Based on the property name/value in question, get its encoded form.
+ *
+ * @param string $propName
+ * @param string|int $propValue
+ *
+ * @return string
+ */
+ protected function getEncodedValueForProp($propName, $propValue)
+ {
+ if (in_array($propName, $this->propTypes['string'])) {
+ // Simple strings are null terminated. Unsure if this is
+ // needed or simply a product of how ADUC does stuff?
+ $value = $this->encodePropValue($propValue."\0", true);
+ } elseif (in_array($propName, $this->propTypes['time'])) {
+ // Needs to be in microseconds (assuming it is in minute format)...
+ $value = $this->encodePropValue($propValue * self::TIME_CONVERSION);
+ } else {
+ $value = $this->encodePropValue($propValue);
+ }
+
+ return $value;
+ }
+
+ /**
+ * Based on the property name in question, get its actual value from the binary blob value.
+ *
+ * @param string $propName
+ * @param string $propValue
+ *
+ * @return string|int
+ */
+ protected function getDecodedValueForProp($propName, $propValue)
+ {
+ if (in_array($propName, $this->propTypes['string'])) {
+ // Strip away null terminators. I think this should
+ // be desired, otherwise it just ends in confusion.
+ $value = str_replace("\0", '', $this->decodePropValue($propValue, true));
+ } elseif (in_array($propName, $this->propTypes['time'])) {
+ // Convert from microseconds to minutes (how ADUC displays
+ // it anyway, and seems the most practical).
+ $value = hexdec($this->decodePropValue($propValue)) / self::TIME_CONVERSION;
+ } elseif (in_array($propName, $this->propTypes['int'])) {
+ $value = hexdec($this->decodePropValue($propValue));
+ } else {
+ $value = $this->decodePropValue($propValue);
+ }
+
+ return $value;
+ }
+
+ /**
+ * Decode the property by inspecting the nibbles of each blob, checking
+ * the control, and adding up the results into a final value.
+ *
+ * @param string $hex
+ * @param bool $string Whether or not this is simple string data.
+ *
+ * @return string
+ */
+ protected function decodePropValue($hex, $string = false)
+ {
+ $decodePropValue = '';
+
+ $blobs = str_split($hex, 6);
+
+ foreach ($blobs as $blob) {
+ $bin = decbin(hexdec($blob));
+
+ $controlY = substr($bin, 4, 6);
+ $nibbleY = substr($bin, 10, 4);
+ $controlX = substr($bin, 14, 6);
+ $nibbleX = substr($bin, 20, 4);
+
+ $byte = $this->nibbleControl($nibbleX, $controlX).$this->nibbleControl($nibbleY, $controlY);
+
+ if ($string) {
+ $decodePropValue .= MbString::chr(bindec($byte));
+ } else {
+ $decodePropValue = $this->dec2hex(bindec($byte)).$decodePropValue;
+ }
+ }
+
+ return $decodePropValue;
+ }
+
+ /**
+ * Get the encoded property value as a binary blob.
+ *
+ * @param string $value
+ * @param bool $string
+ *
+ * @return string
+ */
+ protected function encodePropValue($value, $string = false)
+ {
+ // An int must be properly padded. (then split and reversed).
+ // For a string, we just split the chars. This seems
+ // to be the easiest way to handle UTF-8 characters
+ // instead of trying to work with their hex values.
+ $chars = $string ? MbString::split($value) : array_reverse(str_split($this->dec2hex($value, 8), 2));
+
+ $encoded = '';
+
+ foreach ($chars as $char) {
+ // Get the bits for the char. Using this method to ensure it is fully padded.
+ $bits = sprintf('%08b', $string ? MbString::ord($char) : hexdec($char));
+ $nibbleX = substr($bits, 0, 4);
+ $nibbleY = substr($bits, 4, 4);
+
+ // Construct the value with the header, high nibble, then low nibble.
+ $value = self::NIBBLE_HEADER;
+
+ foreach (['Y' => $nibbleY, 'X' => $nibbleX] as $nibbleType => $nibble) {
+ $value .= $this->getNibbleWithControl($nibbleType, $nibble);
+ }
+
+ // Convert it back to a binary bit stream
+ foreach ([0, 8, 16] as $start) {
+ $encoded .= $this->packBitString(substr($value, $start, 8), 8);
+ }
+ }
+
+ return $encoded;
+ }
+
+ /**
+ * PHP's pack() function has no 'b' or 'B' template. This is
+ * a workaround that turns a literal bit-string into a
+ * packed byte-string with 8 bits per byte.
+ *
+ * @param string $bits
+ * @param bool $len
+ *
+ * @return string
+ */
+ protected function packBitString($bits, $len)
+ {
+ $bits = substr($bits, 0, $len);
+ // Pad input with zeros to next multiple of 4 above $len
+ $bits = str_pad($bits, 4 * (int) (($len + 3) / 4), '0');
+
+ // Split input into chunks of 4 bits, convert each to hex and pack them
+ $nibbles = str_split($bits, 4);
+ foreach ($nibbles as $i => $nibble) {
+ $nibbles[$i] = base_convert($nibble, 2, 16);
+ }
+
+ return pack('H*', implode('', $nibbles));
+ }
+
+ /**
+ * Based on the control, adjust the nibble accordingly.
+ *
+ * @param string $nibble
+ * @param string $control
+ *
+ * @return string
+ */
+ protected function nibbleControl($nibble, $control)
+ {
+ // This control stays constant for the low/high nibbles,
+ // so it doesn't matter which we compare to
+ if ($control == self::NIBBLE_CONTROL['X'][1]) {
+ $dec = bindec($nibble);
+ $dec += 9;
+ $nibble = str_pad(decbin($dec), 4, '0', STR_PAD_LEFT);
+ }
+
+ return $nibble;
+ }
+
+ /**
+ * Get the nibble value with the control prefixed.
+ *
+ * If the nibble dec is <= 9, the control X equals 001011 and Y equals 001110, otherwise if the nibble dec is > 9
+ * the control for X or Y equals 011010. Additionally, if the dec value of the nibble is > 9, then the nibble value
+ * must be subtracted by 9 before the final value is constructed.
+ *
+ * @param string $nibbleType Either X or Y
+ * @param string $nibble
+ *
+ * @return string
+ */
+ protected function getNibbleWithControl($nibbleType, $nibble)
+ {
+ $dec = bindec($nibble);
+
+ if ($dec > 9) {
+ $dec -= 9;
+ $control = self::NIBBLE_CONTROL[$nibbleType][1];
+ } else {
+ $control = self::NIBBLE_CONTROL[$nibbleType][0];
+ }
+
+ return $control.sprintf('%04d', decbin($dec));
+ }
+
+ /**
+ * Need to make sure hex values are always an even length, so pad as needed.
+ *
+ * @param int $int
+ * @param int $padLength The hex string must be padded to this length (with zeros).
+ *
+ * @return string
+ */
+ protected function dec2hex($int, $padLength = 2)
+ {
+ return str_pad(dechex($int), $padLength, 0, STR_PAD_LEFT);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/TSPropertyArray.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/TSPropertyArray.php
new file mode 100644
index 0000000..4eac74b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Attributes/TSPropertyArray.php
@@ -0,0 +1,295 @@
+<?php
+
+namespace Adldap\Models\Attributes;
+
+use InvalidArgumentException;
+
+class TSPropertyArray
+{
+ /**
+ * Represents that the TSPropertyArray data is valid.
+ */
+ const VALID_SIGNATURE = 'P';
+
+ /**
+ * The default values for the TSPropertyArray structure.
+ *
+ * @var array
+ */
+ const DEFAULTS = [
+ 'CtxCfgPresent' => 2953518677,
+ 'CtxWFProfilePath' => '',
+ 'CtxWFProfilePathW' => '',
+ 'CtxWFHomeDir' => '',
+ 'CtxWFHomeDirW' => '',
+ 'CtxWFHomeDirDrive' => '',
+ 'CtxWFHomeDirDriveW' => '',
+ 'CtxShadow' => 1,
+ 'CtxMaxDisconnectionTime' => 0,
+ 'CtxMaxConnectionTime' => 0,
+ 'CtxMaxIdleTime' => 0,
+ 'CtxWorkDirectory' => '',
+ 'CtxWorkDirectoryW' => '',
+ 'CtxCfgFlags1' => 2418077696,
+ 'CtxInitialProgram' => '',
+ 'CtxInitialProgramW' => '',
+ ];
+
+ /**
+ * @var string The default data that occurs before the TSPropertyArray (CtxCfgPresent with a bunch of spaces...?)
+ */
+ protected $defaultPreBinary = '43747843666750726573656e742020202020202020202020202020202020202020202020202020202020202020202020';
+
+ /**
+ * @var TSProperty[]
+ */
+ protected $tsProperty = [];
+
+ /**
+ * @var string
+ */
+ protected $signature = self::VALID_SIGNATURE;
+
+ /**
+ * Binary data that occurs before the TSPropertyArray data in userParameters.
+ *
+ * @var string
+ */
+ protected $preBinary = '';
+
+ /**
+ * Binary data that occurs after the TSPropertyArray data in userParameters.
+ *
+ * @var string
+ */
+ protected $postBinary = '';
+
+ /**
+ * Construct in one of the following ways:.
+ *
+ * - Pass an array of TSProperty key => value pairs (See DEFAULTS constant).
+ * - Pass the userParameters binary value. The object representation of that will be decoded and constructed.
+ * - Pass nothing and a default set of TSProperty key => value pairs will be used (See DEFAULTS constant).
+ *
+ * @param mixed $tsPropertyArray
+ */
+ public function __construct($tsPropertyArray = null)
+ {
+ $this->preBinary = hex2bin($this->defaultPreBinary);
+
+ if (is_null($tsPropertyArray) || is_array($tsPropertyArray)) {
+ $tsPropertyArray = $tsPropertyArray ?: self::DEFAULTS;
+
+ foreach ($tsPropertyArray as $key => $value) {
+ $tsProperty = new TSProperty();
+
+ $this->tsProperty[$key] = $tsProperty->setName($key)->setValue($value);
+ }
+ } else {
+ $this->decodeUserParameters($tsPropertyArray);
+ }
+ }
+
+ /**
+ * Check if a specific TSProperty exists by its property name.
+ *
+ * @param string $propName
+ *
+ * @return bool
+ */
+ public function has($propName)
+ {
+ return array_key_exists(strtolower($propName), array_change_key_case($this->tsProperty));
+ }
+
+ /**
+ * Get a TSProperty object by its property name (ie. CtxWFProfilePath).
+ *
+ * @param string $propName
+ *
+ * @return TSProperty
+ */
+ public function get($propName)
+ {
+ $this->validateProp($propName);
+
+ return $this->getTsPropObj($propName);
+ }
+
+ /**
+ * Add a TSProperty object. If it already exists, it will be overwritten.
+ *
+ * @param TSProperty $tsProperty
+ *
+ * @return $this
+ */
+ public function add(TSProperty $tsProperty)
+ {
+ $this->tsProperty[$tsProperty->getName()] = $tsProperty;
+
+ return $this;
+ }
+
+ /**
+ * Remove a TSProperty by its property name (ie. CtxMinEncryptionLevel).
+ *
+ * @param string $propName
+ *
+ * @return $this
+ */
+ public function remove($propName)
+ {
+ foreach (array_keys($this->tsProperty) as $property) {
+ if (strtolower($propName) == strtolower($property)) {
+ unset($this->tsProperty[$property]);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set the value for a specific TSProperty by its name.
+ *
+ * @param string $propName
+ * @param mixed $propValue
+ *
+ * @return $this
+ */
+ public function set($propName, $propValue)
+ {
+ $this->validateProp($propName);
+
+ $this->getTsPropObj($propName)->setValue($propValue);
+
+ return $this;
+ }
+
+ /**
+ * Get the full binary representation of the userParameters containing the TSPropertyArray data.
+ *
+ * @return string
+ */
+ public function toBinary()
+ {
+ $binary = $this->preBinary;
+
+ $binary .= hex2bin(str_pad(dechex(MbString::ord($this->signature)), 2, 0, STR_PAD_LEFT));
+
+ $binary .= hex2bin(str_pad(dechex(count($this->tsProperty)), 2, 0, STR_PAD_LEFT));
+
+ foreach ($this->tsProperty as $tsProperty) {
+ $binary .= $tsProperty->toBinary();
+ }
+
+ return $binary.$this->postBinary;
+ }
+
+ /**
+ * Get a simple associative array containing of all TSProperty names and values.
+ *
+ * @return array
+ */
+ public function toArray()
+ {
+ $userParameters = [];
+
+ foreach ($this->tsProperty as $property => $tsPropObj) {
+ $userParameters[$property] = $tsPropObj->getValue();
+ }
+
+ return $userParameters;
+ }
+
+ /**
+ * Get all TSProperty objects.
+ *
+ * @return TSProperty[]
+ */
+ public function getTSProperties()
+ {
+ return $this->tsProperty;
+ }
+
+ /**
+ * Validates that the given property name exists.
+ *
+ * @param string $propName
+ */
+ protected function validateProp($propName)
+ {
+ if (!$this->has($propName)) {
+ throw new InvalidArgumentException(sprintf('TSProperty for "%s" does not exist.', $propName));
+ }
+ }
+
+ /**
+ * @param string $propName
+ *
+ * @return TSProperty
+ */
+ protected function getTsPropObj($propName)
+ {
+ return array_change_key_case($this->tsProperty)[strtolower($propName)];
+ }
+
+ /**
+ * Get an associative array with all of the userParameters property names and values.
+ *
+ * @param string $userParameters
+ *
+ * @return void
+ */
+ protected function decodeUserParameters($userParameters)
+ {
+ $userParameters = bin2hex($userParameters);
+
+ // Save the 96-byte array of reserved data, so as to not ruin anything that may be stored there.
+ $this->preBinary = hex2bin(substr($userParameters, 0, 96));
+ // The signature is a 2-byte unicode character at the front
+ $this->signature = MbString::chr(hexdec(substr($userParameters, 96, 2)));
+ // This asserts the validity of the tsPropertyArray data. For some reason 'P' means valid...
+ if ($this->signature != self::VALID_SIGNATURE) {
+ throw new InvalidArgumentException('Invalid TSPropertyArray data');
+ }
+
+ // The property count is a 2-byte unsigned integer indicating the number of elements for the tsPropertyArray
+ // It starts at position 98. The actual variable data begins at position 100.
+ $length = $this->addTSPropData(substr($userParameters, 100), hexdec(substr($userParameters, 98, 2)));
+
+ // Reserved data length + (count and sig length == 4) + the added lengths of the TSPropertyArray
+ // This saves anything after that variable TSPropertyArray data, so as to not squash anything stored there
+ if (strlen($userParameters) > (96 + 4 + $length)) {
+ $this->postBinary = hex2bin(substr($userParameters, (96 + 4 + $length)));
+ }
+ }
+
+ /**
+ * Given the start of TSPropertyArray hex data, and the count for the number
+ * of TSProperty structures in contains, parse and split out the
+ * individual TSProperty structures. Return the full length
+ * of the TSPropertyArray data.
+ *
+ * @param string $tsPropertyArray
+ * @param int $tsPropCount
+ *
+ * @return int The length of the data in the TSPropertyArray
+ */
+ protected function addTSPropData($tsPropertyArray, $tsPropCount)
+ {
+ $length = 0;
+
+ for ($i = 0; $i < $tsPropCount; $i++) {
+ // Prop length = name length + value length + type length + the space for the length data.
+ $propLength = hexdec(substr($tsPropertyArray, $length, 2)) + (hexdec(substr($tsPropertyArray, $length + 2, 2)) * 3) + 6;
+
+ $tsProperty = new TSProperty(hex2bin(substr($tsPropertyArray, $length, $propLength)));
+
+ $this->tsProperty[$tsProperty->getName()] = $tsProperty;
+
+ $length += $propLength;
+ }
+
+ return $length;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/BatchModification.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/BatchModification.php
new file mode 100644
index 0000000..08ddca8
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/BatchModification.php
@@ -0,0 +1,270 @@
+<?php
+
+namespace Adldap\Models;
+
+use InvalidArgumentException;
+
+/**
+ * Class BatchModification.
+ *
+ * A utility class to assist in the creation of LDAP
+ * batch modifications and ensure their validity.
+ */
+class BatchModification
+{
+ /**
+ * The array keys to be used in batch modifications.
+ */
+ const KEY_ATTRIB = 'attrib';
+ const KEY_MODTYPE = 'modtype';
+ const KEY_VALUES = 'values';
+
+ /**
+ * The original value of the attribute before modification.
+ *
+ * @var null
+ */
+ protected $original = null;
+
+ /**
+ * The attribute of the modification.
+ *
+ * @var int|string
+ */
+ protected $attribute;
+
+ /**
+ * The values of the modification.
+ *
+ * @var array
+ */
+ protected $values = [];
+
+ /**
+ * The modtype integer of the batch modification.
+ *
+ * @var int
+ */
+ protected $type;
+
+ /**
+ * Constructor.
+ *
+ * @param string|null $attribute
+ * @param string|int|null $type
+ * @param array $values
+ */
+ public function __construct($attribute = null, $type = null, $values = [])
+ {
+ $this->setAttribute($attribute)
+ ->setType($type)
+ ->setValues($values);
+ }
+
+ /**
+ * Sets the original value of the attribute before modification.
+ *
+ * @param mixed $original
+ *
+ * @return $this
+ */
+ public function setOriginal($original = null)
+ {
+ $this->original = $original;
+
+ return $this;
+ }
+
+ /**
+ * Returns the original value of the attribute before modification.
+ *
+ * @return mixed
+ */
+ public function getOriginal()
+ {
+ return $this->original;
+ }
+
+ /**
+ * Sets the attribute of the modification.
+ *
+ * @param string $attribute
+ *
+ * @return $this
+ */
+ public function setAttribute($attribute)
+ {
+ $this->attribute = $attribute;
+
+ return $this;
+ }
+
+ /**
+ * Returns the attribute of the modification.
+ *
+ * @return string
+ */
+ public function getAttribute()
+ {
+ return $this->attribute;
+ }
+
+ /**
+ * Sets the values of the modification.
+ *
+ * @param array $values
+ *
+ * @return $this
+ */
+ public function setValues(array $values = [])
+ {
+ $this->values = array_map(function ($value) {
+ // We need to make sure all values given to a batch modification are
+ // strings, otherwise we'll receive an LDAP exception when
+ // we try to process the modification.
+ return (string) $value;
+ }, $values);
+
+ return $this;
+ }
+
+ /**
+ * Returns the values of the modification.
+ *
+ * @return array
+ */
+ public function getValues()
+ {
+ return $this->values;
+ }
+
+ /**
+ * Sets the type of the modification.
+ *
+ * @param int|null $type
+ *
+ * @return $this
+ */
+ public function setType($type = null)
+ {
+ if (!is_null($type) && !$this->isValidType($type)) {
+ throw new InvalidArgumentException('Given batch modification type is invalid.');
+ }
+
+ $this->type = $type;
+
+ return $this;
+ }
+
+ /**
+ * Returns the type of the modification.
+ *
+ * @return int
+ */
+ public function getType()
+ {
+ return $this->type;
+ }
+
+ /**
+ * Determines if the batch modification
+ * is valid in its current state.
+ *
+ * @return bool
+ */
+ public function isValid()
+ {
+ return !is_null($this->get());
+ }
+
+ /**
+ * Builds the type of modification automatically
+ * based on the current and original values.
+ *
+ * @return $this
+ */
+ public function build()
+ {
+ $filtered = array_diff(
+ array_map('trim', $this->values),
+ ['']
+ );
+
+ if (is_null($this->original)) {
+ // If the original value is null, we'll assume
+ // that the attribute doesn't exist yet.
+ if (!empty($filtered)) {
+ // If the filtered array is not empty, we can
+ // assume we're looking to add values
+ // to the current attribute.
+ $this->setType(LDAP_MODIFY_BATCH_ADD);
+ }
+
+ // If the filtered array is empty and there is no original
+ // value, then we can ignore this attribute since
+ // we can't push null values to the server.
+ } else {
+ if (empty($filtered)) {
+ // If there's an original value and the array is
+ // empty then we can assume we are looking
+ // to completely remove all values
+ // of the current attribute.
+ $this->setType(LDAP_MODIFY_BATCH_REMOVE_ALL);
+ } else {
+ // If the array isn't empty then we can assume
+ // we're looking to replace all attributes.
+ $this->setType(LDAP_MODIFY_BATCH_REPLACE);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Returns the built batch modification array.
+ *
+ * @return array|null
+ */
+ public function get()
+ {
+ switch ($this->type) {
+ case LDAP_MODIFY_BATCH_REMOVE_ALL:
+ // A values key cannot be provided when
+ // a remove all type is selected.
+ return [
+ static::KEY_ATTRIB => $this->attribute,
+ static::KEY_MODTYPE => $this->type,
+ ];
+ case LDAP_MODIFY_BATCH_REMOVE:
+ // Fallthrough.
+ case LDAP_MODIFY_BATCH_ADD:
+ // Fallthrough.
+ case LDAP_MODIFY_BATCH_REPLACE:
+ return [
+ static::KEY_ATTRIB => $this->attribute,
+ static::KEY_MODTYPE => $this->type,
+ static::KEY_VALUES => $this->values,
+ ];
+ default:
+ // If the modtype isn't recognized, we'll return null.
+ return;
+ }
+ }
+
+ /**
+ * Determines if the given modtype is valid.
+ *
+ * @param int $type
+ *
+ * @return bool
+ */
+ protected function isValidType($type)
+ {
+ return in_array($type, [
+ LDAP_MODIFY_BATCH_REMOVE_ALL,
+ LDAP_MODIFY_BATCH_REMOVE,
+ LDAP_MODIFY_BATCH_REPLACE,
+ LDAP_MODIFY_BATCH_ADD,
+ ]);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Computer.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Computer.php
new file mode 100644
index 0000000..e00f259
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Computer.php
@@ -0,0 +1,87 @@
+<?php
+
+namespace Adldap\Models;
+
+/**
+ * Class Computer.
+ *
+ * Represents an LDAP computer / server.
+ */
+class Computer extends Entry
+{
+ use Concerns\HasMemberOf;
+ use Concerns\HasDescription;
+ use Concerns\HasLastLogonAndLogOff;
+ use Concerns\HasUserAccountControl;
+ use Concerns\HasCriticalSystemObject;
+
+ /**
+ * Returns the computers operating system.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679076(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getOperatingSystem()
+ {
+ return $this->getFirstAttribute($this->schema->operatingSystem());
+ }
+
+ /**
+ * Returns the computers operating system version.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679079(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getOperatingSystemVersion()
+ {
+ return $this->getFirstAttribute($this->schema->operatingSystemVersion());
+ }
+
+ /**
+ * Returns the computers operating system service pack.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679078(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getOperatingSystemServicePack()
+ {
+ return $this->getFirstAttribute($this->schema->operatingSystemServicePack());
+ }
+
+ /**
+ * Returns the computers DNS host name.
+ *
+ * @return string
+ */
+ public function getDnsHostName()
+ {
+ return $this->getFirstAttribute($this->schema->dnsHostName());
+ }
+
+ /**
+ * Returns the computers bad password time.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675243(v=vs.85).aspx
+ *
+ * @return int
+ */
+ public function getBadPasswordTime()
+ {
+ return $this->getFirstAttribute($this->schema->badPasswordTime());
+ }
+
+ /**
+ * Returns the computers account expiry date.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675098(v=vs.85).aspx
+ *
+ * @return int
+ */
+ public function getAccountExpiry()
+ {
+ return $this->getFirstAttribute($this->schema->accountExpires());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasAttributes.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasAttributes.php
new file mode 100644
index 0000000..2235bbe
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasAttributes.php
@@ -0,0 +1,345 @@
+<?php
+
+namespace Adldap\Models\Concerns;
+
+use Illuminate\Support\Arr;
+
+trait HasAttributes
+{
+ /**
+ * The default output date format for all time related methods.
+ *
+ * Default format is suited for MySQL timestamps.
+ *
+ * @var string
+ */
+ public $dateFormat = 'Y-m-d H:i:s';
+
+ /**
+ * The format that is used to convert timestamps to unix timestamps.
+ *
+ * Currently set for compatibility with Active Directory.
+ *
+ * @var string
+ */
+ protected $timestampFormat = 'YmdHis.0Z';
+
+ /**
+ * The models attributes.
+ *
+ * @var array
+ */
+ protected $attributes = [];
+
+ /**
+ * The models original attributes.
+ *
+ * @var array
+ */
+ protected $original = [];
+
+ /**
+ * Dynamically retrieve attributes on the object.
+ *
+ * @param mixed $key
+ *
+ * @return bool
+ */
+ public function __get($key)
+ {
+ return $this->getAttribute($key);
+ }
+
+ /**
+ * Dynamically set attributes on the object.
+ *
+ * @param mixed $key
+ * @param mixed $value
+ *
+ * @return $this
+ */
+ public function __set($key, $value)
+ {
+ return $this->setAttribute($key, $value);
+ }
+
+ /**
+ * Synchronizes the models original attributes
+ * with the model's current attributes.
+ *
+ * @return $this
+ */
+ public function syncOriginal()
+ {
+ $this->original = $this->attributes;
+
+ return $this;
+ }
+
+ /**
+ * Returns the models attribute with the specified key.
+ *
+ * If a sub-key is specified, it will try and
+ * retrieve it from the parent keys array.
+ *
+ * @param int|string $key
+ * @param int|string $subKey
+ *
+ * @return mixed
+ */
+ public function getAttribute($key, $subKey = null)
+ {
+ if (!$key) {
+ return;
+ }
+
+ // We'll normalize the given key to prevent case sensitivity issues.
+ $key = $this->normalizeAttributeKey($key);
+
+ if (is_null($subKey) && $this->hasAttribute($key)) {
+ return $this->attributes[$key];
+ } elseif ($this->hasAttribute($key, $subKey)) {
+ return $this->attributes[$key][$subKey];
+ }
+ }
+
+ /**
+ * Returns the first attribute by the specified key.
+ *
+ * @param string $key
+ *
+ * @return mixed
+ */
+ public function getFirstAttribute($key)
+ {
+ return $this->getAttribute($key, 0);
+ }
+
+ /**
+ * Returns all of the models attributes.
+ *
+ * @return array
+ */
+ public function getAttributes()
+ {
+ return $this->attributes;
+ }
+
+ /**
+ * Fills the entry with the supplied attributes.
+ *
+ * @param array $attributes
+ *
+ * @return $this
+ */
+ public function fill(array $attributes = [])
+ {
+ foreach ($attributes as $key => $value) {
+ $this->setAttribute($key, $value);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Sets an attributes value by the specified key and sub-key.
+ *
+ * @param int|string $key
+ * @param mixed $value
+ * @param int|string $subKey
+ *
+ * @return $this
+ */
+ public function setAttribute($key, $value, $subKey = null)
+ {
+ // Normalize key.
+ $key = $this->normalizeAttributeKey($key);
+
+ // If the key is equal to 'dn', we'll automatically
+ // change it to the full attribute name.
+ $key = ($key == 'dn' ? $this->schema->distinguishedName() : $key);
+
+ if (is_null($subKey)) {
+ // We need to ensure all attributes are set as arrays so all
+ // of our model methods retrieve attributes correctly.
+ $this->attributes[$key] = is_array($value) ? $value : [$value];
+ } else {
+ $this->attributes[$key][$subKey] = $value;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Sets the first attributes value by the specified key.
+ *
+ * @param int|string $key
+ * @param mixed $value
+ *
+ * @return $this
+ */
+ public function setFirstAttribute($key, $value)
+ {
+ return $this->setAttribute($key, $value, 0);
+ }
+
+ /**
+ * Sets the attributes property.
+ *
+ * Used when constructing an existing LDAP record.
+ *
+ * @param array $attributes
+ *
+ * @return $this
+ */
+ public function setRawAttributes(array $attributes = [])
+ {
+ // We'll filter out those annoying 'count' keys returned with LDAP results,
+ // and lowercase all root array keys to prevent any casing issues.
+ $this->attributes = array_change_key_case($this->filterRawAttributes($attributes), CASE_LOWER);
+
+ // We'll pull out the distinguished name from our raw attributes
+ // and set it into our attributes array with the full attribute
+ // definition. This allows us to normalize distinguished
+ // names across different LDAP variants.
+ if ($dn = Arr::get($attributes, 'dn')) {
+ // In some LDAP variants, the distinguished
+ // name is returned as an array.
+ if (is_array($dn)) {
+ $dn = Arr::first($dn);
+ }
+
+ $this->setDistinguishedName($dn);
+ }
+
+ $this->syncOriginal();
+
+ // Set exists to true since raw attributes are only
+ // set in the case of attributes being loaded by
+ // query results.
+ $this->exists = true;
+
+ return $this;
+ }
+
+ /**
+ * Filters the count key recursively from raw LDAP attributes.
+ *
+ * @param array $attributes
+ * @param array|string $keys
+ *
+ * @return array
+ */
+ public function filterRawAttributes(array $attributes = [], $keys = ['count', 'dn'])
+ {
+ $attributes = Arr::except($attributes, $keys);
+
+ array_walk($attributes, function (&$value) use ($keys) {
+ $value = is_array($value) ?
+ $this->filterRawAttributes($value, $keys) :
+ $value;
+ });
+
+ return $attributes;
+ }
+
+ /**
+ * Returns true / false if the specified attribute
+ * exists in the attributes array.
+ *
+ * @param int|string $key
+ * @param int|string $subKey
+ *
+ * @return bool
+ */
+ public function hasAttribute($key, $subKey = null)
+ {
+ // Normalize key.
+ $key = $this->normalizeAttributeKey($key);
+
+ if (is_null($subKey)) {
+ return Arr::has($this->attributes, $key);
+ }
+
+ return Arr::has($this->attributes, "$key.$subKey");
+ }
+
+ /**
+ * Returns the number of attributes inside
+ * the attributes property.
+ *
+ * @return int
+ */
+ public function countAttributes()
+ {
+ return count($this->getAttributes());
+ }
+
+ /**
+ * Returns the models original attributes.
+ *
+ * @return array
+ */
+ public function getOriginal()
+ {
+ return $this->original;
+ }
+
+ /**
+ * Get the attributes that have been changed since last sync.
+ *
+ * @return array
+ */
+ public function getDirty()
+ {
+ $dirty = [];
+
+ foreach ($this->attributes as $key => $value) {
+ if (!$this->originalIsEquivalent($key)) {
+ // We need to reset the array's indices using array_values due to
+ // LDAP requiring consecutive indices (0, 1, 2 etc.)
+ $dirty[$key] = array_values($value);
+ }
+ }
+
+ return $dirty;
+ }
+
+ /**
+ * Returns a normalized attribute key.
+ *
+ * @param string $key
+ *
+ * @return string
+ */
+ protected function normalizeAttributeKey($key)
+ {
+ return strtolower($key);
+ }
+
+ /**
+ * Determine if the new and old values for a given key are equivalent.
+ *
+ * @param string $key
+ *
+ * @return bool
+ */
+ protected function originalIsEquivalent($key)
+ {
+ if (!array_key_exists($key, $this->original)) {
+ return false;
+ }
+
+ $current = $this->attributes[$key];
+
+ $original = $this->original[$key];
+
+ if ($current === $original) {
+ return true;
+ }
+
+ return is_numeric($current) &&
+ is_numeric($original) &&
+ strcmp((string) $current, (string) $original) === 0;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasCriticalSystemObject.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasCriticalSystemObject.php
new file mode 100644
index 0000000..e85cac1
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasCriticalSystemObject.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace Adldap\Models\Concerns;
+
+trait HasCriticalSystemObject
+{
+ /**
+ * Returns true / false if the entry is a critical system object.
+ *
+ * @return null|bool
+ */
+ public function isCriticalSystemObject()
+ {
+ $attribute = $this->getFirstAttribute($this->schema->isCriticalSystemObject());
+
+ return $this->convertStringToBool($attribute);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasDescription.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasDescription.php
new file mode 100644
index 0000000..dfc05ed
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasDescription.php
@@ -0,0 +1,30 @@
+<?php
+
+namespace Adldap\Models\Concerns;
+
+trait HasDescription
+{
+ /**
+ * Returns the models's description.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675492(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getDescription()
+ {
+ return $this->getFirstAttribute($this->schema->description());
+ }
+
+ /**
+ * Sets the models's description.
+ *
+ * @param string $description
+ *
+ * @return $this
+ */
+ public function setDescription($description)
+ {
+ return $this->setFirstAttribute($this->schema->description(), $description);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasEvents.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasEvents.php
new file mode 100644
index 0000000..37abb81
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasEvents.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace Adldap\Models\Concerns;
+
+use Adldap\Adldap;
+use Adldap\Models\Events\Event;
+
+trait HasEvents
+{
+ /**
+ * Fires the specified model event.
+ *
+ * @param Event $event
+ *
+ * @return mixed
+ */
+ protected function fireModelEvent(Event $event)
+ {
+ return Adldap::getEventDispatcher()->fire($event);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasLastLogonAndLogOff.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasLastLogonAndLogOff.php
new file mode 100644
index 0000000..3aee2a5
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasLastLogonAndLogOff.php
@@ -0,0 +1,42 @@
+<?php
+
+namespace Adldap\Models\Concerns;
+
+trait HasLastLogonAndLogOff
+{
+ /**
+ * Returns the models's last log off date.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676822(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getLastLogOff()
+ {
+ return $this->getFirstAttribute($this->schema->lastLogOff());
+ }
+
+ /**
+ * Returns the models's last log on date.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676823(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getLastLogon()
+ {
+ return $this->getFirstAttribute($this->schema->lastLogOn());
+ }
+
+ /**
+ * Returns the models's last log on timestamp.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676824(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getLastLogonTimestamp()
+ {
+ return $this->getFirstAttribute($this->schema->lastLogOnTimestamp());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasMemberOf.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasMemberOf.php
new file mode 100644
index 0000000..3c1b85e
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasMemberOf.php
@@ -0,0 +1,260 @@
+<?php
+
+namespace Adldap\Models\Concerns;
+
+use Adldap\Utilities;
+use Adldap\Models\User;
+use Adldap\Models\Group;
+use Adldap\Query\Collection;
+
+trait HasMemberOf
+{
+ /**
+ * Returns an array of distinguished names of groups that the current model belongs to.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms677099(v=vs.85).aspx
+ *
+ * @return array
+ */
+ public function getMemberOf()
+ {
+ $dns = $this->getAttribute($this->schema->memberOf());
+
+ // Normalize returned distinguished names if the attribute is null.
+ return is_array($dns) ? $dns : [];
+ }
+
+ /**
+ * Adds the current model to the specified group.
+ *
+ * @param string|Group $group
+ *
+ * @return bool
+ */
+ public function addGroup($group)
+ {
+ if (is_string($group)) {
+ // If the group is a string, we'll assume the dev is passing
+ // in a DN string of the group. We'll try to locate it.
+ $group = $this->query->newInstance()->findByDn($group);
+ }
+
+ if ($group instanceof Group) {
+ // If the group is Group model instance, we can
+ // add the current models DN to the group.
+ return $group->addMember($this->getDn());
+ }
+
+ return false;
+ }
+
+ /**
+ * Removes the current model from the specified group.
+ *
+ * @param string|Group $group
+ *
+ * @return bool
+ */
+ public function removeGroup($group)
+ {
+ if (is_string($group)) {
+ // If the group is a string, we'll assume the dev is passing
+ // in a DN string of the group. We'll try to locate it.
+ $group = $this->query->newInstance()->findByDn($group);
+ }
+
+ if ($group instanceof Group) {
+ // If the group is Group model instance, we can
+ // remove the current models DN from the group.
+ return $group->removeMember($this->getDn());
+ }
+
+ return false;
+ }
+
+ /**
+ * Removes the current model from all groups.
+ *
+ * @return array The group distinguished names that were successfully removed
+ */
+ public function removeAllGroups()
+ {
+ $removed = [];
+
+ foreach ($this->getMemberOf() as $group) {
+ if ($this->removeGroup($group)) {
+ $removed[] = $group;
+ }
+ }
+
+ return $removed;
+ }
+
+ /**
+ * Returns the models groups that it is apart of.
+ *
+ * If a recursive option is given, groups of groups
+ * are retrieved and then merged with
+ * the resulting collection.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms677099(v=vs.85).aspx
+ *
+ * @param array $fields
+ * @param bool $recursive
+ * @param array $visited
+ *
+ * @return Collection
+ */
+ public function getGroups(array $fields = ['*'], $recursive = false, array $visited = [])
+ {
+ if (!in_array($this->schema->memberOf(), $fields)) {
+ // We want to make sure that we always select the memberof
+ // field in case developers want recursive members.
+ $fields = array_merge($fields, [$this->schema->memberOf()]);
+ }
+
+ $groups = $this->getGroupsByNames($this->getMemberOf(), $fields);
+
+ // We need to check if we're working with a User model. Only users
+ // contain a primary group. If we are, we'll merge the users
+ // primary group into the resulting collection.
+ if ($this instanceof User && $primary = $this->getPrimaryGroup()) {
+ $groups->push($primary);
+ }
+
+ // If recursive results are requested, we'll ask each group
+ // for their groups, and merge the resulting collection.
+ if ($recursive) {
+ /** @var Group $group */
+ foreach ($groups as $group) {
+ // We need to validate that we haven't already queried
+ // for this group's members so we don't allow
+ // infinite recursion in case of circular
+ // group dependencies in LDAP.
+ if (!in_array($group->getDn(), $visited)) {
+ $visited[] = $group->getDn();
+
+ $members = $group->getGroups($fields, $recursive, $visited);
+
+ /** @var Group $member */
+ foreach ($members as $member) {
+ $visited[] = $member->getDn();
+ }
+
+ $groups = $groups->merge($members);
+ }
+ }
+ }
+
+ return $groups;
+ }
+
+ /**
+ * Returns the models groups names in a single dimension array.
+ *
+ * If a recursive option is given, groups of groups
+ * are retrieved and then merged with
+ * the resulting collection.
+ *
+ * @param bool $recursive
+ *
+ * @return array
+ */
+ public function getGroupNames($recursive = false)
+ {
+ $fields = [$this->schema->commonName(), $this->schema->memberOf()];
+
+ $names = $this->getGroups($fields, $recursive)->map(function (Group $group) {
+ return $group->getCommonName();
+ })->toArray();
+
+ return array_unique($names);
+ }
+
+ /**
+ * Determine if the current model is a member of the specified group(s).
+ *
+ * @param mixed $group
+ * @param bool $recursive
+ *
+ * @return bool
+ */
+ public function inGroup($group, $recursive = false)
+ {
+ $memberOf = $this->getGroups(['cn'], $recursive);
+
+ if ($group instanceof Collection) {
+ // If we've been given a collection then we'll convert
+ // it to an array to normalize the value.
+ $group = $group->toArray();
+ }
+
+ $groups = is_array($group) ? $group : [$group];
+
+ foreach ($groups as $group) {
+ // We need to iterate through each given group that the
+ // model must be apart of, then go through the models
+ // actual groups and perform validation.
+ $exists = $memberOf->filter(function (Group $parent) use ($group) {
+ return $this->groupIsParent($group, $parent);
+ })->count() !== 0;
+
+ if (!$exists) {
+ // If the current group isn't at all contained
+ // in the memberOf collection, we'll
+ // return false here.
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * Retrieves groups by their distinguished name.
+ *
+ * @param array $dns
+ * @param array $fields
+ *
+ * @return Collection
+ */
+ protected function getGroupsByNames(array $dns = [], $fields = [])
+ {
+ $query = $this->query->newInstance();
+
+ return $query->newCollection($dns)->map(function ($dn) use ($query, $fields) {
+ return $query->select($fields)->clearFilters()->findByDn($dn);
+ })->filter(function ($group) {
+ return $group instanceof Group;
+ });
+ }
+
+ /**
+ * Validates if the specified group is the given parent instance.
+ *
+ * @param Group|string $group
+ * @param Group $parent
+ *
+ * @return bool
+ */
+ protected function groupIsParent($group, Group $parent)
+ {
+ if ($group instanceof Group) {
+ // We've been given a group instance, we'll compare their DNs.
+ return $parent->getDn() === $group->getDn();
+ }
+
+ if (Utilities::explodeDn($group)) {
+ // We've been given a DN, we'll compare it to the parents.
+ return $parent->getDn() === $group;
+ }
+
+ if (!empty($group)) {
+ // We've been given just a string, we'll
+ // compare it to the parents name.
+ return $parent->getCommonName() === $group;
+ }
+
+ return false;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasUserAccountControl.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasUserAccountControl.php
new file mode 100644
index 0000000..857378b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasUserAccountControl.php
@@ -0,0 +1,60 @@
+<?php
+
+namespace Adldap\Models\Concerns;
+
+use Adldap\Models\Attributes\AccountControl;
+
+trait HasUserAccountControl
+{
+ /**
+ * Returns the users user account control integer.
+ *
+ * @return string
+ */
+ public function getUserAccountControl()
+ {
+ return $this->getFirstAttribute($this->schema->userAccountControl());
+ }
+
+ /**
+ * Returns the users user account control as an AccountControl object.
+ *
+ * @return AccountControl
+ */
+ public function getUserAccountControlObject()
+ {
+ return new AccountControl($this->getUserAccountControl());
+ }
+
+ /**
+ * Sets the users account control property.
+ *
+ * @param int|string|AccountControl $accountControl
+ *
+ * @return $this
+ */
+ public function setUserAccountControl($accountControl)
+ {
+ return $this->setAttribute($this->schema->userAccountControl(), (string) $accountControl);
+ }
+
+ /**
+ * Returns if the user is disabled.
+ *
+ * @return bool
+ */
+ public function isDisabled()
+ {
+ return ($this->getUserAccountControl() & AccountControl::ACCOUNTDISABLE) === AccountControl::ACCOUNTDISABLE;
+ }
+
+ /**
+ * Returns if the user is enabled.
+ *
+ * @return bool
+ */
+ public function isEnabled()
+ {
+ return $this->getUserAccountControl() === null ? false : !$this->isDisabled();
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasUserProperties.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasUserProperties.php
new file mode 100644
index 0000000..0d1c541
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Concerns/HasUserProperties.php
@@ -0,0 +1,453 @@
+<?php
+
+namespace Adldap\Models\Concerns;
+
+trait HasUserProperties
+{
+ /**
+ * Returns the users country.
+ *
+ * @return string|null
+ */
+ public function getCountry()
+ {
+ return $this->getFirstAttribute($this->schema->country());
+ }
+
+ /**
+ * Sets the users country.
+ *
+ * @param string $country
+ *
+ * @return $this
+ */
+ public function setCountry($country)
+ {
+ return $this->setFirstAttribute($this->schema->country(), $country);
+ }
+
+ /**
+ * Returns the users department.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675490(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getDepartment()
+ {
+ return $this->getFirstAttribute($this->schema->department());
+ }
+
+ /**
+ * Sets the users department.
+ *
+ * @param string $department
+ *
+ * @return $this
+ */
+ public function setDepartment($department)
+ {
+ return $this->setFirstAttribute($this->schema->department(), $department);
+ }
+
+ /**
+ * Returns the users email address.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676855(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getEmail()
+ {
+ return $this->getFirstAttribute($this->schema->email());
+ }
+
+ /**
+ * Sets the users email.
+ *
+ * Keep in mind this will remove all other
+ * email addresses the user currently has.
+ *
+ * @param string $email
+ *
+ * @return $this
+ */
+ public function setEmail($email)
+ {
+ return $this->setFirstAttribute($this->schema->email(), $email);
+ }
+
+ /**
+ * Returns the users facsimile number.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675675(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getFacsimileNumber()
+ {
+ return $this->getFirstAttribute($this->schema->facsimile());
+ }
+
+ /**
+ * Sets the users facsimile number.
+ *
+ * @param string $number
+ *
+ * @return $this
+ */
+ public function setFacsimileNumber($number)
+ {
+ return $this->setFirstAttribute($this->schema->facsimile(), $number);
+ }
+
+ /**
+ * Returns the users first name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675719(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getFirstName()
+ {
+ return $this->getFirstAttribute($this->schema->firstName());
+ }
+
+ /**
+ * Sets the users first name.
+ *
+ * @param string $firstName
+ *
+ * @return $this
+ */
+ public function setFirstName($firstName)
+ {
+ return $this->setFirstAttribute($this->schema->firstName(), $firstName);
+ }
+
+ /**
+ * Returns the users initials.
+ *
+ * @return string|null
+ */
+ public function getInitials()
+ {
+ return $this->getFirstAttribute($this->schema->initials());
+ }
+
+ /**
+ * Sets the users initials.
+ *
+ * @param string $initials
+ *
+ * @return $this
+ */
+ public function setInitials($initials)
+ {
+ return $this->setFirstAttribute($this->schema->initials(), $initials);
+ }
+
+ /**
+ * Returns the users IP Phone.
+ *
+ * @return string|null
+ */
+ public function getIpPhone()
+ {
+ return $this->getFirstAttribute($this->schema->ipPhone());
+ }
+
+ /**
+ * Sets the users IP phone.
+ *
+ * @param string $ip
+ *
+ * @return $this
+ */
+ public function setIpPhone($ip)
+ {
+ return $this->setFirstAttribute($this->schema->ipPhone(), $ip);
+ }
+
+ /**
+ * Returns the users last name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679872(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getLastName()
+ {
+ return $this->getFirstAttribute($this->schema->lastName());
+ }
+
+ /**
+ * Sets the users last name.
+ *
+ * @param string $lastName
+ *
+ * @return $this
+ */
+ public function setLastName($lastName)
+ {
+ return $this->setFirstAttribute($this->schema->lastName(), $lastName);
+ }
+
+ /**
+ * Returns the users postal code.
+ *
+ * @return string|null
+ */
+ public function getPostalCode()
+ {
+ return $this->getFirstAttribute($this->schema->postalCode());
+ }
+
+ /**
+ * Sets the users postal code.
+ *
+ * @param string $postalCode
+ *
+ * @return $this
+ */
+ public function setPostalCode($postalCode)
+ {
+ return $this->setFirstAttribute($this->schema->postalCode(), $postalCode);
+ }
+
+ /**
+ * Get the users post office box.
+ *
+ * @return string|null
+ */
+ public function getPostOfficeBox()
+ {
+ return $this->getFirstAttribute($this->schema->postOfficeBox());
+ }
+
+ /**
+ * Sets the users post office box.
+ *
+ * @param string|int $box
+ *
+ * @return $this
+ */
+ public function setPostOfficeBox($box)
+ {
+ return $this->setFirstAttribute($this->schema->postOfficeBox(), $box);
+ }
+
+ /**
+ * Sets the users proxy addresses.
+ *
+ * This will remove all proxy addresses on the user and insert the specified addresses.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679424(v=vs.85).aspx
+ *
+ * @param array $addresses
+ *
+ * @return $this
+ */
+ public function setProxyAddresses(array $addresses = [])
+ {
+ return $this->setAttribute($this->schema->proxyAddresses(), $addresses);
+ }
+
+ /**
+ * Add's a single proxy address to the user.
+ *
+ * @param string $address
+ *
+ * @return $this
+ */
+ public function addProxyAddress($address)
+ {
+ $addresses = $this->getProxyAddresses();
+
+ $addresses[] = $address;
+
+ return $this->setAttribute($this->schema->proxyAddresses(), $addresses);
+ }
+
+ /**
+ * Returns the users proxy addresses.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679424(v=vs.85).aspx
+ *
+ * @return array
+ */
+ public function getProxyAddresses()
+ {
+ return $this->getAttribute($this->schema->proxyAddresses()) ?? [];
+ }
+
+ /**
+ * Returns the users street address.
+ *
+ * @return string|null
+ */
+ public function getStreetAddress()
+ {
+ return $this->getFirstAttribute($this->schema->streetAddress());
+ }
+
+ /**
+ * Sets the users street address.
+ *
+ * @param string $address
+ *
+ * @return $this
+ */
+ public function setStreetAddress($address)
+ {
+ return $this->setFirstAttribute($this->schema->streetAddress(), $address);
+ }
+
+ /**
+ * Returns the users title.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680037(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getTitle()
+ {
+ return $this->getFirstAttribute($this->schema->title());
+ }
+
+ /**
+ * Sets the users title.
+ *
+ * @param string $title
+ *
+ * @return $this
+ */
+ public function setTitle($title)
+ {
+ return $this->setFirstAttribute($this->schema->title(), $title);
+ }
+
+ /**
+ * Returns the users telephone number.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680027(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getTelephoneNumber()
+ {
+ return $this->getFirstAttribute($this->schema->telephone());
+ }
+
+ /**
+ * Sets the users telephone number.
+ *
+ * @param string $number
+ *
+ * @return $this
+ */
+ public function setTelephoneNumber($number)
+ {
+ return $this->setFirstAttribute($this->schema->telephone(), $number);
+ }
+
+ /**
+ * Returns the users primary mobile phone number.
+ *
+ * @return string|null
+ */
+ public function getMobileNumber()
+ {
+ return $this->getFirstAttribute($this->schema->mobile());
+ }
+
+ /**
+ * Sets the users primary mobile phone number.
+ *
+ * @param string $number
+ *
+ * @return $this
+ */
+ public function setMobileNumber($number)
+ {
+ return $this->setFirstAttribute($this->schema->mobile(), $number);
+ }
+
+ /**
+ * Returns the users secondary (other) mobile phone number.
+ *
+ * @return string|null
+ */
+ public function getOtherMobileNumber()
+ {
+ return $this->getFirstAttribute($this->schema->otherMobile());
+ }
+
+ /**
+ * Sets the users secondary (other) mobile phone number.
+ *
+ * @param string $number
+ *
+ * @return $this
+ */
+ public function setOtherMobileNumber($number)
+ {
+ return $this->setFirstAttribute($this->schema->otherMobile(), $number);
+ }
+
+ /**
+ * Returns the users other mailbox attribute.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679091(v=vs.85).aspx
+ *
+ * @return array
+ */
+ public function getOtherMailbox()
+ {
+ return $this->getAttribute($this->schema->otherMailbox());
+ }
+
+ /**
+ * Sets the users other mailboxes.
+ *
+ * @param array $otherMailbox
+ *
+ * @return $this
+ */
+ public function setOtherMailbox($otherMailbox = [])
+ {
+ return $this->setAttribute($this->schema->otherMailbox(), $otherMailbox);
+ }
+
+ /**
+ * Returns the distinguished name of the user who is the user's manager.
+ *
+ * @return string|null
+ */
+ public function getManager()
+ {
+ return $this->getFirstAttribute($this->schema->manager());
+ }
+
+ /**
+ * Sets the distinguished name of the user who is the user's manager.
+ *
+ * @param string $managerDn
+ *
+ * @return $this
+ */
+ public function setManager($managerDn)
+ {
+ return $this->setFirstAttribute($this->schema->manager(), $managerDn);
+ }
+
+ /**
+ * Returns the users mail nickname.
+ *
+ * @return string|null
+ */
+ public function getMailNickname()
+ {
+ return $this->getFirstAttribute($this->schema->emailNickname());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Contact.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Contact.php
new file mode 100644
index 0000000..517a35b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Contact.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace Adldap\Models;
+
+/**
+ * Class Contact.
+ *
+ * Represents an LDAP contact.
+ */
+class Contact extends Entry
+{
+ use Concerns\HasMemberOf;
+ use Concerns\HasUserProperties;
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Container.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Container.php
new file mode 100644
index 0000000..faaf1a1
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Container.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace Adldap\Models;
+
+/**
+ * Class Container.
+ *
+ * Represents an LDAP container.
+ */
+class Container extends Entry
+{
+ use Concerns\HasDescription;
+ use Concerns\HasCriticalSystemObject;
+
+ /**
+ * Returns the containers system flags integer.
+ *
+ * An integer value that contains flags that define additional properties of the class.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680022(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getSystemFlags()
+ {
+ return $this->getFirstAttribute($this->schema->systemFlags());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Entry.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Entry.php
new file mode 100644
index 0000000..be6ef1d
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Entry.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Adldap\Models;
+
+/**
+ * Class Entry.
+ *
+ * Represents an LDAP record that could not be identified as another type of model.
+ */
+class Entry extends Model
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Created.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Created.php
new file mode 100644
index 0000000..7e98bc1
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Created.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+class Created extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Creating.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Creating.php
new file mode 100644
index 0000000..8482da8
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Creating.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+class Creating extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Deleted.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Deleted.php
new file mode 100644
index 0000000..6cfd954
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Deleted.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+class Deleted extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Deleting.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Deleting.php
new file mode 100644
index 0000000..2718376
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Deleting.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+class Deleting extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Event.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Event.php
new file mode 100644
index 0000000..821e391
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Event.php
@@ -0,0 +1,35 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+use Adldap\Models\Model;
+
+abstract class Event
+{
+ /**
+ * The model that the event is being triggered on.
+ *
+ * @var Model
+ */
+ protected $model;
+
+ /**
+ * Constructor.
+ *
+ * @param Model $model
+ */
+ public function __construct(Model $model)
+ {
+ $this->model = $model;
+ }
+
+ /**
+ * Returns the model that generated the event.
+ *
+ * @return Model
+ */
+ public function getModel()
+ {
+ return $this->model;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Saved.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Saved.php
new file mode 100644
index 0000000..f775e2e
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Saved.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+class Saved extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Saving.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Saving.php
new file mode 100644
index 0000000..b187294
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Saving.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+class Saving extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Updated.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Updated.php
new file mode 100644
index 0000000..ce0721f
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Updated.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+class Updated extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Updating.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Updating.php
new file mode 100644
index 0000000..4f33e66
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Events/Updating.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Models\Events;
+
+class Updating extends Event
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Factory.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Factory.php
new file mode 100644
index 0000000..92ad91e
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Factory.php
@@ -0,0 +1,209 @@
+<?php
+
+namespace Adldap\Models;
+
+use Adldap\Query\Builder;
+use Adldap\Schemas\ActiveDirectory;
+use Adldap\Schemas\SchemaInterface;
+
+/**
+ * Class Factory.
+ *
+ * Creates new LDAP models.
+ */
+class Factory
+{
+ /**
+ * The LDAP query builder.
+ *
+ * @var Builder
+ */
+ protected $query;
+
+ /**
+ * The LDAP schema.
+ *
+ * @var SchemaInterface
+ */
+ protected $schema;
+
+ /**
+ * Constructor.
+ *
+ * @param Builder $builder
+ */
+ public function __construct(Builder $builder)
+ {
+ $this->setQuery($builder)
+ ->setSchema($builder->getSchema());
+ }
+
+ /**
+ * Sets the current query builder.
+ *
+ * @param Builder $builder
+ *
+ * @return $this
+ */
+ public function setQuery(Builder $builder)
+ {
+ $this->query = $builder;
+
+ return $this;
+ }
+
+ /**
+ * Sets the current schema.
+ *
+ * If null is given, a default ActiveDirectory schema is set.
+ *
+ * @param SchemaInterface|null $schema
+ *
+ * @return $this
+ */
+ public function setSchema(SchemaInterface $schema = null)
+ {
+ $this->schema = $schema ?: new ActiveDirectory();
+
+ return $this;
+ }
+
+ /**
+ * Creates a new generic LDAP entry instance.
+ *
+ * @param array $attributes
+ *
+ * @return Entry
+ */
+ public function entry(array $attributes = [])
+ {
+ $model = $this->schema->entryModel();
+
+ return new $model($attributes, $this->query);
+ }
+
+ /**
+ * Creates a new user instance.
+ *
+ * @param array $attributes
+ *
+ * @return User
+ */
+ public function user(array $attributes = [])
+ {
+ $model = $this->schema->userModel();
+
+ return (new $model($attributes, $this->query))
+ ->setAttribute($this->schema->objectClass(), $this->schema->userObjectClasses());
+ }
+
+ /**
+ * Creates a new organizational unit instance.
+ *
+ * @param array $attributes
+ *
+ * @return OrganizationalUnit
+ */
+ public function ou(array $attributes = [])
+ {
+ $model = $this->schema->organizationalUnitModel();
+
+ return (new $model($attributes, $this->query))
+ ->setAttribute($this->schema->objectClass(), [
+ $this->schema->top(),
+ $this->schema->organizationalUnit(),
+ ]);
+ }
+
+ /**
+ * Creates a new organizational unit instance.
+ *
+ * @param array $attributes
+ *
+ * @return Organization
+ */
+ public function organization(array $attributes = [])
+ {
+ $model = $this->schema->organizationModel();
+
+ return (new $model($attributes, $this->query))
+ ->setAttribute($this->schema->objectClass(), [
+ $this->schema->top(),
+ $this->schema->organization(),
+ ]);
+ }
+
+ /**
+ * Creates a new group instance.
+ *
+ * @param array $attributes
+ *
+ * @return Group
+ */
+ public function group(array $attributes = [])
+ {
+ $model = $this->schema->groupModel();
+
+ return (new $model($attributes, $this->query))
+ ->setAttribute($this->schema->objectClass(), [
+ $this->schema->top(),
+ $this->schema->objectCategoryGroup(),
+ ]);
+ }
+
+ /**
+ * Creates a new organizational unit instance.
+ *
+ * @param array $attributes
+ *
+ * @return Container
+ */
+ public function container(array $attributes = [])
+ {
+ $model = $this->schema->containerModel();
+
+ return (new $model($attributes, $this->query))
+ ->setAttribute($this->schema->objectClass(), $this->schema->objectClassContainer());
+ }
+
+ /**
+ * Creates a new user instance as a contact.
+ *
+ * @param array $attributes
+ *
+ * @return User
+ */
+ public function contact(array $attributes = [])
+ {
+ $model = $this->schema->contactModel();
+
+ return (new $model($attributes, $this->query))
+ ->setAttribute($this->schema->objectClass(), [
+ $this->schema->top(),
+ $this->schema->person(),
+ $this->schema->organizationalPerson(),
+ $this->schema->contact(),
+ ]);
+ }
+
+ /**
+ * Creates a new computer instance.
+ *
+ * @param array $attributes
+ *
+ * @return Computer
+ */
+ public function computer(array $attributes = [])
+ {
+ $model = $this->schema->computerModel();
+
+ return (new $model($attributes, $this->query))
+ ->setAttribute($this->schema->objectClass(), [
+ $this->schema->top(),
+ $this->schema->person(),
+ $this->schema->organizationalPerson(),
+ $this->schema->user(),
+ $this->schema->computer(),
+ ]);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ForeignSecurityPrincipal.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ForeignSecurityPrincipal.php
new file mode 100644
index 0000000..b0d15d8
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ForeignSecurityPrincipal.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Adldap\Models;
+
+/**
+ * Class ForeignSecurityPrincipal.
+ *
+ * Represents an LDAP ForeignSecurityPrincipal.
+ */
+class ForeignSecurityPrincipal extends Entry
+{
+ use Concerns\HasMemberOf;
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Group.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Group.php
new file mode 100644
index 0000000..7a89457
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Group.php
@@ -0,0 +1,288 @@
+<?php
+
+namespace Adldap\Models;
+
+use Adldap\Utilities;
+use InvalidArgumentException;
+
+/**
+ * Class Group.
+ *
+ * Represents an LDAP group (security / distribution).
+ */
+class Group extends Entry
+{
+ use Concerns\HasMemberOf;
+ use Concerns\HasDescription;
+
+ /**
+ * Returns all users apart of the current group.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms677097(v=vs.85).aspx
+ *
+ * @return \Adldap\Query\Collection
+ */
+ public function getMembers()
+ {
+ $members = $this->getMembersFromAttribute($this->schema->member());
+
+ if (count($members) === 0) {
+ $members = $this->getPaginatedMembers();
+ }
+
+ return $this->newCollection($members);
+ }
+
+ /**
+ * Returns the group's member names only.
+ *
+ * @return array
+ */
+ public function getMemberNames()
+ {
+ $members = [];
+
+ $dns = $this->getAttribute($this->schema->member()) ?: [];
+
+ foreach ($dns as $dn) {
+ $exploded = Utilities::explodeDn($dn);
+
+ if (array_key_exists(0, $exploded)) {
+ $members[] = $exploded[0];
+ }
+ }
+
+ return $members;
+ }
+
+ /**
+ * Sets the groups members using an array of user DNs.
+ *
+ * @param array $entries
+ *
+ * @return $this
+ */
+ public function setMembers(array $entries)
+ {
+ return $this->setAttribute($this->schema->member(), $entries);
+ }
+
+ /**
+ * Adds multiple entries to the current group.
+ *
+ * @param array $members
+ *
+ * @return bool
+ */
+ public function addMembers(array $members)
+ {
+ $members = array_map(function ($member) {
+ return $member instanceof Model
+ ? $member->getDn()
+ : $member;
+ }, $members);
+
+ $mod = $this->newBatchModification(
+ $this->schema->member(),
+ LDAP_MODIFY_BATCH_ADD,
+ $members
+ );
+
+ return $this->addModification($mod)->save();
+ }
+
+ /**
+ * Adds an entry to the current group.
+ *
+ * @param string|Entry $member
+ *
+ * @throws InvalidArgumentException When the given entry is empty or contains no distinguished name.
+ *
+ * @return bool
+ */
+ public function addMember($member)
+ {
+ $member = ($member instanceof Model ? $member->getDn() : $member);
+
+ if (is_null($member)) {
+ throw new InvalidArgumentException(
+ 'Cannot add member to group. The members distinguished name cannot be null.'
+ );
+ }
+
+ $mod = $this->newBatchModification(
+ $this->schema->member(),
+ LDAP_MODIFY_BATCH_ADD,
+ [$member]
+ );
+
+ return $this->addModification($mod)->save();
+ }
+
+ /**
+ * Removes an entry from the current group.
+ *
+ * @param string|Entry $member
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return bool
+ */
+ public function removeMember($member)
+ {
+ $member = ($member instanceof Model ? $member->getDn() : $member);
+
+ if (is_null($member)) {
+ throw new InvalidArgumentException(
+ 'Cannot remove member to group. The members distinguished name cannot be null.'
+ );
+ }
+
+ $mod = $this->newBatchModification(
+ $this->schema->member(),
+ LDAP_MODIFY_BATCH_REMOVE,
+ [$member]
+ );
+
+ return $this->addModification($mod)->save();
+ }
+
+ /**
+ * Removes all members from the current group.
+ *
+ * @return bool
+ */
+ public function removeMembers()
+ {
+ $mod = $this->newBatchModification(
+ $this->schema->member(),
+ LDAP_MODIFY_BATCH_REMOVE_ALL
+ );
+
+ return $this->addModification($mod)->save();
+ }
+
+ /**
+ * Returns the group type integer.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675935(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getGroupType()
+ {
+ return $this->getFirstAttribute($this->schema->groupType());
+ }
+
+ /**
+ * Retrieves group members by the specified model attribute.
+ *
+ * @param $attribute
+ *
+ * @return array
+ */
+ protected function getMembersFromAttribute($attribute)
+ {
+ $members = [];
+
+ $entries = $this->getAttribute($attribute) ?: [];
+
+ $query = $this->query->newInstance();
+
+ // Retrieving the member identifier to allow
+ // compatibility with LDAP variants.
+ $identifier = $this->schema->memberIdentifier();
+
+ foreach ($entries as $entry) {
+ // If our identifier is a distinguished name, then we need to
+ // use an alternate query method, as we can't locate records
+ // by distinguished names using an LDAP filter.
+ if ($identifier == 'dn' || $identifier == 'distinguishedname') {
+ $member = $query->findByDn($entry);
+ } else {
+ // We'll ensure we clear our filters when retrieving each member,
+ // so we can continue fetching the next one in line.
+ $member = $query->clearFilters()->findBy($identifier, $entry);
+ }
+
+ // We'll double check that we've received a model from
+ // our query before adding it into our results.
+ if ($member instanceof Model) {
+ $members[] = $member;
+ }
+ }
+
+ return $members;
+ }
+
+ /**
+ * Retrieves members that are contained in a member range.
+ *
+ * @return array
+ */
+ protected function getPaginatedMembers()
+ {
+ $members = [];
+
+ $keys = array_keys($this->attributes);
+
+ // We need to filter out the model attributes so
+ // we only retrieve the member range.
+ $attributes = array_values(array_filter($keys, function ($key) {
+ return strpos($key, 'member;range') !== false;
+ }));
+
+ // We'll grab the member range key so we can run a
+ // regex on it to determine the range.
+ $key = reset($attributes);
+
+ preg_match_all(
+ '/member;range\=([0-9]{1,4})-([0-9*]{1,4})/',
+ $key,
+ $matches
+ );
+
+ if ($key && count($matches) == 3) {
+ // Retrieve the ending range number.
+ $to = $matches[2][0];
+
+ // Retrieve the current groups members from the
+ // current range string (ex. 'member;0-50').
+ $members = $this->getMembersFromAttribute($key);
+
+ // If the query already included all member results (indicated
+ // by the '*'), then we can return here. Otherwise we need
+ // to continue on and retrieve the rest.
+ if ($to === '*') {
+ return $members;
+ }
+
+ // Determine the amount of members we're requesting per query.
+ $range = $to - $matches[1][0];
+
+ // Set our starting range to our last end range plus one.
+ $from = $to + 1;
+
+ // We'll determine the new end range by adding the
+ // total range to our new starting range.
+ $to = $from + $range;
+
+ // We'll need to query for the current model again but with
+ // a new range to retrieve the other members.
+ /** @var Group $group */
+ $group = $this->query->newInstance()->findByDn(
+ $this->getDn(),
+ [$this->query->getSchema()->memberRange($from, $to)]
+ );
+
+ // Finally, we'll merge our current members
+ // with the newly returned members.
+ $members = array_merge(
+ $members,
+ $group->getMembers()->toArray()
+ );
+ }
+
+ return $members;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Model.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Model.php
new file mode 100644
index 0000000..3bad2ea
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Model.php
@@ -0,0 +1,1266 @@
+<?php
+
+namespace Adldap\Models;
+
+use DateTime;
+use ArrayAccess;
+use Adldap\Utilities;
+use JsonSerializable;
+use Adldap\Query\Builder;
+use Illuminate\Support\Arr;
+use Adldap\Query\Collection;
+use InvalidArgumentException;
+use UnexpectedValueException;
+use Adldap\Models\Attributes\Sid;
+use Adldap\Models\Attributes\Guid;
+use Adldap\Schemas\SchemaInterface;
+use Adldap\Models\Attributes\MbString;
+use Adldap\Connections\ConnectionException;
+use Adldap\Models\Attributes\DistinguishedName;
+
+/**
+ * Class Model.
+ *
+ * Represents an LDAP record and provides the ability
+ * to modify / retrieve data from the record.
+ */
+abstract class Model implements ArrayAccess, JsonSerializable
+{
+ use Concerns\HasEvents;
+ use Concerns\HasAttributes;
+
+ /**
+ * Indicates if the model exists.
+ *
+ * @var bool
+ */
+ public $exists = false;
+
+ /**
+ * The current query builder instance.
+ *
+ * @var Builder
+ */
+ protected $query;
+
+ /**
+ * The current LDAP attribute schema.
+ *
+ * @var SchemaInterface
+ */
+ protected $schema;
+
+ /**
+ * Contains the models modifications.
+ *
+ * @var array
+ */
+ protected $modifications = [];
+
+ /**
+ * Constructor.
+ *
+ * @param array $attributes
+ * @param Builder $builder
+ */
+ public function __construct(array $attributes, Builder $builder)
+ {
+ $this->setQuery($builder)
+ ->setSchema($builder->getSchema())
+ ->fill($attributes);
+ }
+
+ /**
+ * Returns the models distinguished name when the model is converted to a string.
+ *
+ * @return null|string
+ */
+ public function __toString()
+ {
+ return $this->getDn();
+ }
+
+ /**
+ * Sets the current query builder.
+ *
+ * @param Builder $builder
+ *
+ * @return $this
+ */
+ public function setQuery(Builder $builder)
+ {
+ $this->query = $builder;
+
+ return $this;
+ }
+
+ /**
+ * Returns the current query builder.
+ *
+ * @return Builder
+ */
+ public function getQuery()
+ {
+ return $this->query;
+ }
+
+ /**
+ * Returns a new query builder instance.
+ *
+ * @return Builder
+ */
+ public function newQuery()
+ {
+ return $this->query->newInstance();
+ }
+
+ /**
+ * Returns a new batch modification.
+ *
+ * @param string|null $attribute
+ * @param string|int|null $type
+ * @param array $values
+ *
+ * @return BatchModification
+ */
+ public function newBatchModification($attribute = null, $type = null, $values = [])
+ {
+ return new BatchModification($attribute, $type, $values);
+ }
+
+ /**
+ * Returns a new collection with the specified items.
+ *
+ * @param mixed $items
+ *
+ * @return Collection
+ */
+ public function newCollection($items = [])
+ {
+ return new Collection($items);
+ }
+
+ /**
+ * Sets the current model schema.
+ *
+ * @param SchemaInterface $schema
+ *
+ * @return $this
+ */
+ public function setSchema(SchemaInterface $schema)
+ {
+ $this->schema = $schema;
+
+ return $this;
+ }
+
+ /**
+ * Returns the current model schema.
+ *
+ * @return SchemaInterface
+ */
+ public function getSchema()
+ {
+ return $this->schema;
+ }
+
+ /**
+ * Determine if the given offset exists.
+ *
+ * @param string $offset
+ *
+ * @return bool
+ */
+ public function offsetExists($offset)
+ {
+ return !is_null($this->getAttribute($offset));
+ }
+
+ /**
+ * Get the value for a given offset.
+ *
+ * @param string $offset
+ *
+ * @return mixed
+ */
+ public function offsetGet($offset)
+ {
+ return $this->getAttribute($offset);
+ }
+
+ /**
+ * Set the value at the given offset.
+ *
+ * @param string $offset
+ * @param mixed $value
+ *
+ * @return void
+ */
+ public function offsetSet($offset, $value)
+ {
+ $this->setAttribute($offset, $value);
+ }
+
+ /**
+ * Unset the value at the given offset.
+ *
+ * @param string $offset
+ *
+ * @return void
+ */
+ public function offsetUnset($offset)
+ {
+ unset($this->attributes[$offset]);
+ }
+
+ /**
+ * Determine if an attribute exists on the model.
+ *
+ * @param string $key
+ *
+ * @return bool
+ */
+ public function __isset($key)
+ {
+ return $this->offsetExists($key);
+ }
+
+ /**
+ * Convert the object into something JSON serializable.
+ *
+ * @return array
+ */
+ public function jsonSerialize()
+ {
+ $attributes = $this->getAttributes();
+
+ array_walk_recursive($attributes, function (&$val) {
+ if (MbString::isLoaded()) {
+ // If we're able to detect the attribute
+ // encoding, we'll encode only the
+ // attributes that need to be.
+ if (!MbString::isUtf8($val)) {
+ $val = utf8_encode($val);
+ }
+ } else {
+ // If the mbstring extension is not loaded, we'll
+ // encode all attributes to make sure
+ // they are encoded properly.
+ $val = utf8_encode($val);
+ }
+ });
+
+ // We'll replace the binary GUID and SID with
+ // their string equivalents for convenience.
+ return array_replace($attributes, [
+ $this->schema->objectGuid() => $this->getConvertedGuid(),
+ $this->schema->objectSid() => $this->getConvertedSid(),
+ ]);
+ }
+
+ /**
+ * Reload a fresh model instance from the directory.
+ *
+ * @return static|null
+ */
+ public function fresh()
+ {
+ $model = $this->query->newInstance()->findByDn($this->getDn());
+
+ return $model instanceof self ? $model : null;
+ }
+
+ /**
+ * Synchronizes the current models attributes with the directory values.
+ *
+ * @return bool
+ */
+ public function syncRaw()
+ {
+ if ($model = $this->fresh()) {
+ $this->setRawAttributes($model->getAttributes());
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Returns the models batch modifications to be processed.
+ *
+ * @return array
+ */
+ public function getModifications()
+ {
+ $this->buildModificationsFromDirty();
+
+ return $this->modifications;
+ }
+
+ /**
+ * Sets the models modifications array.
+ *
+ * @param array $modifications
+ *
+ * @return $this
+ */
+ public function setModifications(array $modifications = [])
+ {
+ $this->modifications = $modifications;
+
+ return $this;
+ }
+
+ /**
+ * Adds a batch modification to the models modifications array.
+ *
+ * @param array|BatchModification $mod
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return $this
+ */
+ public function addModification($mod = [])
+ {
+ if ($mod instanceof BatchModification) {
+ $mod = $mod->get();
+ }
+
+ if ($this->isValidModification($mod)) {
+ $this->modifications[] = $mod;
+
+ return $this;
+ }
+
+ throw new InvalidArgumentException(
+ "The batch modification array does not include the mandatory 'attrib' or 'modtype' keys."
+ );
+ }
+
+ /**
+ * Returns the model's distinguished name string.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/aa366101(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getDistinguishedName()
+ {
+ return $this->getFirstAttribute($this->schema->distinguishedName());
+ }
+
+ /**
+ * Sets the model's distinguished name attribute.
+ *
+ * @param string|DistinguishedName $dn
+ *
+ * @return $this
+ */
+ public function setDistinguishedName($dn)
+ {
+ $this->setFirstAttribute($this->schema->distinguishedName(), (string) $dn);
+
+ return $this;
+ }
+
+ /**
+ * Returns the model's distinguished name string.
+ *
+ * (Alias for getDistinguishedName())
+ *
+ * @link https://msdn.microsoft.com/en-us/library/aa366101(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getDn()
+ {
+ return $this->getDistinguishedName();
+ }
+
+ /**
+ * Returns a DistinguishedName object for modifying the current models DN.
+ *
+ * @return DistinguishedName
+ */
+ public function getDnBuilder()
+ {
+ // If we currently don't have a distinguished name, we'll set
+ // it to our base, otherwise we'll use our query's base DN.
+ $dn = $this->getDistinguishedName() ?: $this->query->getDn();
+
+ return $this->getNewDnBuilder($dn);
+ }
+
+ /**
+ * Returns the models distinguished name components.
+ *
+ * @param bool $removeAttributePrefixes
+ *
+ * @return array
+ */
+ public function getDnComponents($removeAttributePrefixes = true)
+ {
+ if ($components = Utilities::explodeDn($this->getDn(), $removeAttributePrefixes)) {
+ unset($components['count']);
+
+ return $components;
+ }
+
+ return [];
+ }
+
+ /**
+ * Returns the distinguished name that the model is a leaf of.
+ *
+ * @return string
+ */
+ public function getDnRoot()
+ {
+ $components = $this->getDnComponents(false);
+
+ // Shift off the beginning of the array;
+ // This contains the models RDN.
+ array_shift($components);
+
+ return implode(',', $components);
+ }
+
+ /**
+ * Returns a new DistinguishedName object for building onto.
+ *
+ * @param string $baseDn
+ *
+ * @return DistinguishedName
+ */
+ public function getNewDnBuilder($baseDn = '')
+ {
+ return new DistinguishedName($baseDn);
+ }
+
+ /**
+ * Sets the model's distinguished name attribute.
+ *
+ * (Alias for setDistinguishedName())
+ *
+ * @param string $dn
+ *
+ * @return $this
+ */
+ public function setDn($dn)
+ {
+ return $this->setDistinguishedName($dn);
+ }
+
+ /**
+ * Returns the model's hex object SID.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679024(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getObjectSid()
+ {
+ return $this->getFirstAttribute($this->schema->objectSid());
+ }
+
+ /**
+ * Returns the model's binary object GUID.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679021(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getObjectGuid()
+ {
+ return $this->getFirstAttribute($this->schema->objectGuid());
+ }
+
+ /**
+ * Returns the model's GUID.
+ *
+ * @return string|null
+ */
+ public function getConvertedGuid()
+ {
+ try {
+ return (string) new Guid($this->getObjectGuid());
+ } catch (InvalidArgumentException $e) {
+ return;
+ }
+ }
+
+ /**
+ * Returns the model's SID.
+ *
+ * @return string|null
+ */
+ public function getConvertedSid()
+ {
+ try {
+ return (string) new Sid($this->getObjectSid());
+ } catch (InvalidArgumentException $e) {
+ return;
+ }
+ }
+
+ /**
+ * Returns the model's common name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675449(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getCommonName()
+ {
+ return $this->getFirstAttribute($this->schema->commonName());
+ }
+
+ /**
+ * Sets the model's common name.
+ *
+ * @param string $name
+ *
+ * @return $this
+ */
+ public function setCommonName($name)
+ {
+ return $this->setFirstAttribute($this->schema->commonName(), $name);
+ }
+
+ /**
+ * Returns the model's name. An LDAP alias for the CN attribute.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675449(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getName()
+ {
+ return $this->getFirstAttribute($this->schema->name());
+ }
+
+ /**
+ * Sets the model's name.
+ *
+ * @param string $name
+ *
+ * @return Model
+ */
+ public function setName($name)
+ {
+ return $this->setFirstAttribute($this->schema->name(), $name);
+ }
+
+ /**
+ * Returns the model's display name.
+ *
+ * @return string
+ */
+ public function getDisplayName()
+ {
+ return $this->getFirstAttribute($this->schema->displayName());
+ }
+
+ /**
+ * Sets the model's display name.
+ *
+ * @param string $displayName
+ *
+ * @return $this
+ */
+ public function setDisplayName($displayName)
+ {
+ return $this->setFirstAttribute($this->schema->displayName(), $displayName);
+ }
+
+ /**
+ * Returns the model's samaccountname.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679635(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getAccountName()
+ {
+ return $this->getFirstAttribute($this->schema->accountName());
+ }
+
+ /**
+ * Sets the model's samaccountname.
+ *
+ * @param string $accountName
+ *
+ * @return Model
+ */
+ public function setAccountName($accountName)
+ {
+ return $this->setFirstAttribute($this->schema->accountName(), $accountName);
+ }
+
+ /**
+ * Returns the model's userPrincipalName.
+ *
+ * @link https://docs.microsoft.com/en-us/windows/win32/adschema/a-userprincipalname
+ *
+ * @return string
+ */
+ public function getUserPrincipalName()
+ {
+ return $this->getFirstAttribute($this->schema->userPrincipalName());
+ }
+
+ /**
+ * Sets the model's userPrincipalName.
+ *
+ * @param string $upn
+ *
+ * @return Model
+ */
+ public function setUserPrincipalName($upn)
+ {
+ return $this->setFirstAttribute($this->schema->userPrincipalName(), $upn);
+ }
+
+ /**
+ * Returns the model's samaccounttype.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679637(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getAccountType()
+ {
+ return $this->getFirstAttribute($this->schema->accountType());
+ }
+
+ /**
+ * Returns the model's `whenCreated` time.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680924(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getCreatedAt()
+ {
+ return $this->getFirstAttribute($this->schema->createdAt());
+ }
+
+ /**
+ * Returns the created at time in a mysql formatted date.
+ *
+ * @return string
+ */
+ public function getCreatedAtDate()
+ {
+ return (new DateTime())->setTimestamp($this->getCreatedAtTimestamp())->format($this->dateFormat);
+ }
+
+ /**
+ * Returns the created at time in a unix timestamp format.
+ *
+ * @return float
+ */
+ public function getCreatedAtTimestamp()
+ {
+ return DateTime::createFromFormat($this->timestampFormat, $this->getCreatedAt())->getTimestamp();
+ }
+
+ /**
+ * Returns the model's `whenChanged` time.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680921(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getUpdatedAt()
+ {
+ return $this->getFirstAttribute($this->schema->updatedAt());
+ }
+
+ /**
+ * Returns the updated at time in a mysql formatted date.
+ *
+ * @return string
+ */
+ public function getUpdatedAtDate()
+ {
+ return (new DateTime())->setTimestamp($this->getUpdatedAtTimestamp())->format($this->dateFormat);
+ }
+
+ /**
+ * Returns the updated at time in a unix timestamp format.
+ *
+ * @return float
+ */
+ public function getUpdatedAtTimestamp()
+ {
+ return DateTime::createFromFormat($this->timestampFormat, $this->getUpdatedAt())->getTimestamp();
+ }
+
+ /**
+ * Returns the Container of the current Model.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679012(v=vs.85).aspx
+ *
+ * @return Container|Entry|bool
+ */
+ public function getObjectClass()
+ {
+ return $this->query->findByDn($this->getObjectCategoryDn());
+ }
+
+ /**
+ * Returns the CN of the model's object category.
+ *
+ * @return null|string
+ */
+ public function getObjectCategory()
+ {
+ $category = $this->getObjectCategoryArray();
+
+ if (is_array($category) && array_key_exists(0, $category)) {
+ return $category[0];
+ }
+ }
+
+ /**
+ * Returns the model's object category DN in an exploded array.
+ *
+ * @return array|false
+ */
+ public function getObjectCategoryArray()
+ {
+ return Utilities::explodeDn($this->getObjectCategoryDn());
+ }
+
+ /**
+ * Returns the model's object category DN string.
+ *
+ * @return null|string
+ */
+ public function getObjectCategoryDn()
+ {
+ return $this->getFirstAttribute($this->schema->objectCategory());
+ }
+
+ /**
+ * Returns the model's primary group ID.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679375(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrimaryGroupId()
+ {
+ return $this->getFirstAttribute($this->schema->primaryGroupId());
+ }
+
+ /**
+ * Returns the model's instance type.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676204(v=vs.85).aspx
+ *
+ * @return int
+ */
+ public function getInstanceType()
+ {
+ return $this->getFirstAttribute($this->schema->instanceType());
+ }
+
+ /**
+ * Returns the distinguished name of the user who is assigned to manage this object.
+ *
+ * @return string|null
+ */
+ public function getManagedBy()
+ {
+ return $this->getFirstAttribute($this->schema->managedBy());
+ }
+
+ /**
+ * Returns the user model of the user who is assigned to manage this object.
+ *
+ * Returns false otherwise.
+ *
+ * @return User|bool
+ */
+ public function getManagedByUser()
+ {
+ if ($dn = $this->getManagedBy()) {
+ return $this->query->newInstance()->findByDn($dn);
+ }
+
+ return false;
+ }
+
+ /**
+ * Sets the user who is assigned to managed this object.
+ *
+ * @param Model|string $dn
+ *
+ * @return $this
+ */
+ public function setManagedBy($dn)
+ {
+ if ($dn instanceof self) {
+ $dn = $dn->getDn();
+ }
+
+ return $this->setFirstAttribute($this->schema->managedBy(), $dn);
+ }
+
+ /**
+ * Returns the model's max password age.
+ *
+ * @return string
+ */
+ public function getMaxPasswordAge()
+ {
+ return $this->getFirstAttribute($this->schema->maxPasswordAge());
+ }
+
+ /**
+ * Returns the model's max password age in days.
+ *
+ * @return int
+ */
+ public function getMaxPasswordAgeDays()
+ {
+ $age = $this->getMaxPasswordAge();
+
+ return (int) (abs($age) / 10000000 / 60 / 60 / 24);
+ }
+
+ /**
+ * Determine if the current model is located inside the given OU.
+ *
+ * If a model instance is given, the strict parameter is ignored.
+ *
+ * @param Model|string $ou The organizational unit to check.
+ * @param bool $strict Whether the check is case-sensitive.
+ *
+ * @return bool
+ */
+ public function inOu($ou, $strict = false)
+ {
+ if ($ou instanceof self) {
+ // If we've been given an OU model, we can
+ // just check if the OU's DN is inside
+ // the current models DN.
+ return (bool) strpos($this->getDn(), $ou->getDn());
+ }
+
+ $suffix = $strict ? '' : 'i';
+
+ return (bool) preg_grep("/{$ou}/{$suffix}", $this->getDnBuilder()->getComponents('ou'));
+ }
+
+ /**
+ * Returns true / false if the current model is writable
+ * by checking its instance type integer.
+ *
+ * @return bool
+ */
+ public function isWritable()
+ {
+ return (int) $this->getInstanceType() === 4;
+ }
+
+ /**
+ * Saves the changes to LDAP and returns the results.
+ *
+ * @param array $attributes The attributes to update or create for the current entry.
+ *
+ * @return bool
+ */
+ public function save(array $attributes = [])
+ {
+ $this->fireModelEvent(new Events\Saving($this));
+
+ $saved = $this->exists ? $this->update($attributes) : $this->create($attributes);
+
+ if ($saved) {
+ $this->fireModelEvent(new Events\Saved($this));
+ }
+
+ return $saved;
+ }
+
+ /**
+ * Updates the model.
+ *
+ * @param array $attributes The attributes to update for the current entry.
+ *
+ * @return bool
+ */
+ public function update(array $attributes = [])
+ {
+ $this->fill($attributes);
+
+ $modifications = $this->getModifications();
+
+ if (count($modifications) > 0) {
+ $this->fireModelEvent(new Events\Updating($this));
+
+ // Push the update.
+ if ($this->query->getConnection()->modifyBatch($this->getDn(), $modifications)) {
+ // Re-sync attributes.
+ $this->syncRaw();
+
+ $this->fireModelEvent(new Events\Updated($this));
+
+ // Re-set the models modifications.
+ $this->modifications = [];
+
+ return true;
+ }
+
+ // Modification failed, return false.
+ return false;
+ }
+
+ // We need to return true here because modify batch will
+ // return false if no modifications are made
+ // but this may not always be the case.
+ return true;
+ }
+
+ /**
+ * Creates the entry in LDAP.
+ *
+ * @param array $attributes The attributes for the new entry.
+ *
+ * @throws UnexpectedValueException
+ *
+ * @return bool
+ */
+ public function create(array $attributes = [])
+ {
+ $this->fill($attributes);
+
+ if (empty($this->getDn())) {
+ // If the model doesn't currently have a distinguished
+ // name set, we'll create one automatically using
+ // the current query builders base DN.
+ $dn = $this->getCreatableDn();
+
+ // If the dn we receive is the same as our queries base DN, we need
+ // to throw an exception. The LDAP object must have a valid RDN.
+ if ($dn->get() == $this->query->getDn()) {
+ throw new UnexpectedValueException("An LDAP object must have a valid RDN to be created. '$dn' given.");
+ }
+
+ $this->setDn($dn);
+ }
+
+ $this->fireModelEvent(new Events\Creating($this));
+
+ // Create the entry.
+ $created = $this->query->getConnection()->add($this->getDn(), $this->getCreatableAttributes());
+
+ if ($created) {
+ // If the entry was created we'll re-sync
+ // the models attributes from the server.
+ $this->syncRaw();
+
+ $this->fireModelEvent(new Events\Created($this));
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Creates an attribute on the current model.
+ *
+ * @param string $attribute The attribute to create
+ * @param mixed $value The value of the new attribute
+ * @param bool $sync Whether to re-sync all attributes
+ *
+ * @return bool
+ */
+ public function createAttribute($attribute, $value, $sync = true)
+ {
+ if (
+ $this->exists &&
+ $this->query->getConnection()->modAdd($this->getDn(), [$attribute => $value])
+ ) {
+ if ($sync) {
+ $this->syncRaw();
+ }
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Updates the specified attribute with the specified value.
+ *
+ * @param string $attribute The attribute to modify
+ * @param mixed $value The new value for the attribute
+ * @param bool $sync Whether to re-sync all attributes
+ *
+ * @return bool
+ */
+ public function updateAttribute($attribute, $value, $sync = true)
+ {
+ if (
+ $this->exists &&
+ $this->query->getConnection()->modReplace($this->getDn(), [$attribute => $value])
+ ) {
+ if ($sync) {
+ $this->syncRaw();
+ }
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Deletes an attribute on the current entry.
+ *
+ * @param string|array $attributes The attribute(s) to delete
+ * @param bool $sync Whether to re-sync all attributes
+ *
+ * Delete specific values in attributes:
+ *
+ * ["memberuid" => "username"]
+ *
+ * Delete an entire attribute:
+ *
+ * ["memberuid" => []]
+ *
+ * @return bool
+ */
+ public function deleteAttribute($attributes, $sync = true)
+ {
+ // If we've been given a string, we'll assume we're removing a
+ // single attribute. Otherwise, we'll assume it's
+ // an array of attributes to remove.
+ $attributes = is_string($attributes) ? [$attributes => []] : $attributes;
+
+ if (
+ $this->exists &&
+ $this->query->getConnection()->modDelete($this->getDn(), $attributes)
+ ) {
+ if ($sync) {
+ $this->syncRaw();
+ }
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Deletes the current entry.
+ *
+ * Throws a ModelNotFoundException if the current model does
+ * not exist or does not contain a distinguished name.
+ *
+ * @param bool $recursive Whether to recursively delete leaf nodes (models that are children).
+ *
+ * @throws ModelDoesNotExistException
+ *
+ * @return bool
+ */
+ public function delete($recursive = false)
+ {
+ $dn = $this->getDn();
+
+ if ($this->exists === false || empty($dn)) {
+ // Make sure the record exists before we can delete it.
+ // Otherwise, we'll throw an exception.
+ throw (new ModelDoesNotExistException())->setModel(get_class($this));
+ }
+
+ $this->fireModelEvent(new Events\Deleting($this));
+
+ if ($recursive) {
+ // If recursive is requested, we'll retrieve all direct leaf nodes
+ // by executing a 'listing' and delete each resulting model.
+ $this->newQuery()->listing()->in($this->getDn())->get()->each(function (self $model) use ($recursive) {
+ $model->delete($recursive);
+ });
+ }
+
+ if ($this->query->getConnection()->delete($dn)) {
+ // If the deletion was successful, we'll mark the model
+ // as non-existing and fire the deleted event.
+ $this->exists = false;
+
+ $this->fireModelEvent(new Events\Deleted($this));
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Moves the current model into the given new parent.
+ *
+ * For example: $user->move($ou);
+ *
+ * @param Model|string $newParentDn The new parent of the current model.
+ * @param bool $deleteOldRdn Whether to delete the old models relative distinguished name once renamed / moved.
+ *
+ * @return bool
+ */
+ public function move($newParentDn, $deleteOldRdn = true)
+ {
+ // First we'll explode the current models distinguished name and keep their attributes prefixes.
+ $parts = Utilities::explodeDn($this->getDn(), $removeAttrPrefixes = false);
+
+ // If the current model has an empty RDN, we can't move it.
+ if ((int) Arr::first($parts) === 0) {
+ throw new UnexpectedValueException('Current model does not contain an RDN to move.');
+ }
+
+ // Looks like we have a DN. We'll retrieve the leftmost RDN (the identifier).
+ $rdn = Arr::get($parts, 0);
+
+ return $this->rename($rdn, $newParentDn, $deleteOldRdn);
+ }
+
+ /**
+ * Renames the current model to a new RDN and new parent.
+ *
+ * @param string $rdn The models new relative distinguished name. Example: "cn=JohnDoe"
+ * @param Model|string|null $newParentDn The models new parent distinguished name (if moving). Leave this null if you are only renaming. Example: "ou=MovedUsers,dc=acme,dc=org"
+ * @param bool|true $deleteOldRdn Whether to delete the old models relative distinguished name once renamed / moved.
+ *
+ * @return bool
+ */
+ public function rename($rdn, $newParentDn = null, $deleteOldRdn = true)
+ {
+ if ($newParentDn instanceof self) {
+ $newParentDn = $newParentDn->getDn();
+ }
+
+ $moved = $this->query->getConnection()->rename($this->getDn(), $rdn, $newParentDn, $deleteOldRdn);
+
+ if ($moved) {
+ // If the model was successfully moved, we'll set its
+ // new DN so we can sync it's attributes properly.
+ $this->setDn("{$rdn},{$newParentDn}");
+
+ $this->syncRaw();
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Constructs a new distinguished name that is creatable in the directory.
+ *
+ * @return DistinguishedName|string
+ */
+ protected function getCreatableDn()
+ {
+ return $this->getDnBuilder()->addCn($this->getCommonName());
+ }
+
+ /**
+ * Returns the models creatable attributes.
+ *
+ * @return mixed
+ */
+ protected function getCreatableAttributes()
+ {
+ return Arr::except($this->getAttributes(), [$this->schema->distinguishedName()]);
+ }
+
+ /**
+ * Determines if the given modification is valid.
+ *
+ * @param mixed $mod
+ *
+ * @return bool
+ */
+ protected function isValidModification($mod)
+ {
+ return is_array($mod) &&
+ array_key_exists(BatchModification::KEY_MODTYPE, $mod) &&
+ array_key_exists(BatchModification::KEY_ATTRIB, $mod);
+ }
+
+ /**
+ * Builds the models modifications from its dirty attributes.
+ *
+ * @return array
+ */
+ protected function buildModificationsFromDirty()
+ {
+ foreach ($this->getDirty() as $attribute => $values) {
+ // Make sure values is always an array.
+ $values = (is_array($values) ? $values : [$values]);
+
+ // Create a new modification.
+ $modification = $this->newBatchModification($attribute, null, $values);
+
+ if (array_key_exists($attribute, $this->original)) {
+ // If the attribute we're modifying has an original value, we'll give the
+ // BatchModification object its values to automatically determine
+ // which type of LDAP operation we need to perform.
+ $modification->setOriginal($this->original[$attribute]);
+ }
+
+ // Build the modification from its
+ // possible original values.
+ $modification->build();
+
+ if ($modification->isValid()) {
+ // Finally, we'll add the modification to the model.
+ $this->addModification($modification);
+ }
+ }
+
+ return $this->modifications;
+ }
+
+ /**
+ * Validates that the current LDAP connection is secure.
+ *
+ * @throws ConnectionException
+ *
+ * @return void
+ */
+ protected function validateSecureConnection()
+ {
+ if (!$this->query->getConnection()->canChangePasswords()) {
+ throw new ConnectionException(
+ 'You must be connected to your LDAP server with TLS or SSL to perform this operation.'
+ );
+ }
+ }
+
+ /**
+ * Converts the inserted string boolean to a PHP boolean.
+ *
+ * @param string $bool
+ *
+ * @return null|bool
+ */
+ protected function convertStringToBool($bool)
+ {
+ $bool = strtoupper($bool);
+
+ if ($bool === strtoupper($this->schema->false())) {
+ return false;
+ } elseif ($bool === strtoupper($this->schema->true())) {
+ return true;
+ } else {
+ return;
+ }
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ModelDoesNotExistException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ModelDoesNotExistException.php
new file mode 100644
index 0000000..3935610
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ModelDoesNotExistException.php
@@ -0,0 +1,36 @@
+<?php
+
+namespace Adldap\Models;
+
+use Adldap\AdldapException;
+
+/**
+ * Class ModelDoesNotExistException.
+ *
+ * Thrown when a model being saved / updated does not actually exist.
+ */
+class ModelDoesNotExistException extends AdldapException
+{
+ /**
+ * The class name of the model that does not exist.
+ *
+ * @var string
+ */
+ protected $model;
+
+ /**
+ * Sets the model that does not exist.
+ *
+ * @param string $model
+ *
+ * @return ModelDoesNotExistException
+ */
+ public function setModel($model)
+ {
+ $this->model = $model;
+
+ $this->message = "Model [{$model}] does not exist.";
+
+ return $this;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ModelNotFoundException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ModelNotFoundException.php
new file mode 100644
index 0000000..6cc3334
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/ModelNotFoundException.php
@@ -0,0 +1,45 @@
+<?php
+
+namespace Adldap\Models;
+
+use Adldap\AdldapException;
+
+/**
+ * Class ModelNotFoundException.
+ *
+ * Thrown when an LDAP record is not found.
+ */
+class ModelNotFoundException extends AdldapException
+{
+ /**
+ * The query filter that was used.
+ *
+ * @var string
+ */
+ protected $query;
+
+ /**
+ * The base DN of the query that was used.
+ *
+ * @var string
+ */
+ protected $baseDn;
+
+ /**
+ * Sets the query that was used.
+ *
+ * @param string $query
+ * @param string $baseDn
+ *
+ * @return ModelNotFoundException
+ */
+ public function setQuery($query, $baseDn)
+ {
+ $this->query = $query;
+ $this->baseDn = $baseDn;
+
+ $this->message = "No LDAP query results for filter: [{$query}] in: [{$baseDn}]";
+
+ return $this;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Organization.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Organization.php
new file mode 100644
index 0000000..88129d0
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Organization.php
@@ -0,0 +1,31 @@
+<?php
+
+namespace Adldap\Models;
+
+/**
+ * Class Organization.
+ *
+ * Represents an LDAP organization.
+ */
+class Organization extends Entry
+{
+ use Concerns\HasDescription;
+
+ /**
+ * Retrieves the organization units OU attribute.
+ *
+ * @return string
+ */
+ public function getOrganization()
+ {
+ return $this->getFirstAttribute($this->schema->organizationName());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ protected function getCreatableDn()
+ {
+ return $this->getDnBuilder()->addO($this->getOrganization());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/OrganizationalUnit.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/OrganizationalUnit.php
new file mode 100644
index 0000000..0571e4d
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/OrganizationalUnit.php
@@ -0,0 +1,31 @@
+<?php
+
+namespace Adldap\Models;
+
+/**
+ * Class OrganizationalUnit.
+ *
+ * Represents an LDAP organizational unit.
+ */
+class OrganizationalUnit extends Entry
+{
+ use Concerns\HasDescription;
+
+ /**
+ * Retrieves the organization units OU attribute.
+ *
+ * @return string
+ */
+ public function getOu()
+ {
+ return $this->getFirstAttribute($this->schema->organizationalUnitShort());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ protected function getCreatableDn()
+ {
+ return $this->getDnBuilder()->addOU($this->getOu());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Printer.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Printer.php
new file mode 100644
index 0000000..e055866
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/Printer.php
@@ -0,0 +1,286 @@
+<?php
+
+namespace Adldap\Models;
+
+/**
+ * Class Printer.
+ *
+ * Represents an LDAP printer.
+ */
+class Printer extends Entry
+{
+ /**
+ * Returns the printers name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679385(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrinterName()
+ {
+ return $this->getFirstAttribute($this->schema->printerName());
+ }
+
+ /**
+ * Returns the printers share name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679408(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrinterShareName()
+ {
+ return $this->getFirstAttribute($this->schema->printerShareName());
+ }
+
+ /**
+ * Returns the printers memory.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679396(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getMemory()
+ {
+ return $this->getFirstAttribute($this->schema->printerMemory());
+ }
+
+ /**
+ * Returns the printers URL.
+ *
+ * @return string
+ */
+ public function getUrl()
+ {
+ return $this->getFirstAttribute($this->schema->url());
+ }
+
+ /**
+ * Returns the printers location.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676839(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getLocation()
+ {
+ return $this->getFirstAttribute($this->schema->location());
+ }
+
+ /**
+ * Returns the server name that the
+ * current printer is connected to.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679772(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getServerName()
+ {
+ return $this->getFirstAttribute($this->schema->serverName());
+ }
+
+ /**
+ * Returns true / false if the printer can print in color.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679382(v=vs.85).aspx
+ *
+ * @return null|bool
+ */
+ public function getColorSupported()
+ {
+ return $this->convertStringToBool(
+ $this->getFirstAttribute(
+ $this->schema->printerColorSupported()
+ )
+ );
+ }
+
+ /**
+ * Returns true / false if the printer supports duplex printing.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679383(v=vs.85).aspx
+ *
+ * @return null|bool
+ */
+ public function getDuplexSupported()
+ {
+ return $this->convertStringToBool(
+ $this->getFirstAttribute(
+ $this->schema->printerDuplexSupported()
+ )
+ );
+ }
+
+ /**
+ * Returns an array of printer paper types that the printer supports.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679395(v=vs.85).aspx
+ *
+ * @return array
+ */
+ public function getMediaSupported()
+ {
+ return $this->getAttribute($this->schema->printerMediaSupported());
+ }
+
+ /**
+ * Returns true / false if the printer supports stapling.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679410(v=vs.85).aspx
+ *
+ * @return null|bool
+ */
+ public function getStaplingSupported()
+ {
+ return $this->convertStringToBool(
+ $this->getFirstAttribute(
+ $this->schema->printerStaplingSupported()
+ )
+ );
+ }
+
+ /**
+ * Returns an array of the printers bin names.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679380(v=vs.85).aspx
+ *
+ * @return array
+ */
+ public function getPrintBinNames()
+ {
+ return $this->getAttribute($this->schema->printerBinNames());
+ }
+
+ /**
+ * Returns the printers maximum resolution.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679391(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrintMaxResolution()
+ {
+ return $this->getFirstAttribute($this->schema->printerMaxResolutionSupported());
+ }
+
+ /**
+ * Returns the printers orientations supported.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679402(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrintOrientations()
+ {
+ return $this->getFirstAttribute($this->schema->printerOrientationSupported());
+ }
+
+ /**
+ * Returns the driver name of the printer.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675652(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getDriverName()
+ {
+ return $this->getFirstAttribute($this->schema->driverName());
+ }
+
+ /**
+ * Returns the printer drivers version number.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675653(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getDriverVersion()
+ {
+ return $this->getFirstAttribute($this->schema->driverVersion());
+ }
+
+ /**
+ * Returns the priority number of the printer.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679413(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPriority()
+ {
+ return $this->getFirstAttribute($this->schema->priority());
+ }
+
+ /**
+ * Returns the printers start time.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679411(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrintStartTime()
+ {
+ return $this->getFirstAttribute($this->schema->printerStartTime());
+ }
+
+ /**
+ * Returns the printers end time.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679384(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrintEndTime()
+ {
+ return $this->getFirstAttribute($this->schema->printerEndTime());
+ }
+
+ /**
+ * Returns the port name of printer.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679131(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPortName()
+ {
+ return $this->getFirstAttribute($this->schema->portName());
+ }
+
+ /**
+ * Returns the printers version number.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680897(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getVersionNumber()
+ {
+ return $this->getFirstAttribute($this->schema->versionNumber());
+ }
+
+ /**
+ * Returns the print rate.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679405(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrintRate()
+ {
+ return $this->getFirstAttribute($this->schema->printerPrintRate());
+ }
+
+ /**
+ * Returns the print rate unit.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679406(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getPrintRateUnit()
+ {
+ return $this->getFirstAttribute($this->schema->printerPrintRateUnit());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/RootDse.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/RootDse.php
new file mode 100644
index 0000000..31156c1
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/RootDse.php
@@ -0,0 +1,85 @@
+<?php
+
+namespace Adldap\Models;
+
+use DateTime;
+
+/**
+ * Class RootDse.
+ *
+ * Represents the LDAP connections Root DSE record.
+ */
+class RootDse extends Model
+{
+ /**
+ * Returns the hosts current time in unix timestamp format.
+ *
+ * @return int
+ */
+ public function getCurrentTime()
+ {
+ $time = $this->getFirstAttribute($this->schema->currentTime());
+
+ return DateTime::createFromFormat($this->timestampFormat, $time)->getTimestamp();
+ }
+
+ /**
+ * Returns the hosts current time in the models date format.
+ *
+ * @return string
+ */
+ public function getCurrentTimeDate()
+ {
+ return (new DateTime())->setTimestamp($this->getCurrentTime())->format($this->dateFormat);
+ }
+
+ /**
+ * Returns the hosts configuration naming context.
+ *
+ * @return string
+ */
+ public function getConfigurationNamingContext()
+ {
+ return $this->getFirstAttribute($this->schema->configurationNamingContext());
+ }
+
+ /**
+ * Returns the hosts schema naming context.
+ *
+ * @return string
+ */
+ public function getSchemaNamingContext()
+ {
+ return $this->getFirstAttribute($this->schema->schemaNamingContext());
+ }
+
+ /**
+ * Returns the hosts DNS name.
+ *
+ * @return string
+ */
+ public function getDnsHostName()
+ {
+ return $this->getFirstAttribute($this->schema->dnsHostName());
+ }
+
+ /**
+ * Returns the current hosts server name.
+ *
+ * @return string
+ */
+ public function getServerName()
+ {
+ return $this->getFirstAttribute($this->schema->serverName());
+ }
+
+ /**
+ * Returns the DN of the root domain NC for this DC's forest.
+ *
+ * @return mixed
+ */
+ public function getRootDomainNamingContext()
+ {
+ return $this->getFirstAttribute($this->schema->rootDomainNamingContext());
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/User.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/User.php
new file mode 100644
index 0000000..14c3343
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/User.php
@@ -0,0 +1,1054 @@
+<?php
+
+namespace Adldap\Models;
+
+use DateTime;
+use Adldap\Utilities;
+use Adldap\AdldapException;
+use Adldap\Schemas\ActiveDirectory;
+use Adldap\Models\Attributes\AccountControl;
+use Adldap\Models\Attributes\TSPropertyArray;
+use Illuminate\Contracts\Auth\Authenticatable;
+
+/**
+ * Class User.
+ *
+ * Represents an LDAP user.
+ */
+class User extends Entry implements Authenticatable
+{
+ use Concerns\HasUserProperties;
+ use Concerns\HasDescription;
+ use Concerns\HasMemberOf;
+ use Concerns\HasLastLogonAndLogOff;
+ use Concerns\HasUserAccountControl;
+
+ /** @var callable|null */
+ private static $passwordStrategy;
+
+ /**
+ * Password will be processed using given callback before saving.
+ *
+ * @param callable $strategy
+ */
+ public static function usePasswordStrategy(callable $strategy)
+ {
+ static::$passwordStrategy = $strategy;
+ }
+
+ /**
+ * Will return user set password strategy or default one.
+ *
+ * @return callable
+ */
+ public static function getPasswordStrategy(): callable
+ {
+ return static::$passwordStrategy ?? function ($password) {
+ return Utilities::encodePassword($password);
+ };
+ }
+
+ /**
+ * Get the name of the unique identifier for the user.
+ *
+ * @return string
+ */
+ public function getAuthIdentifierName()
+ {
+ return $this->schema->objectGuid();
+ }
+
+ /**
+ * Get the unique identifier for the user.
+ *
+ * @return mixed
+ */
+ public function getAuthIdentifier()
+ {
+ return $this->getConvertedGuid();
+ }
+
+ /**
+ * Get the password for the user.
+ *
+ * @return string
+ */
+ public function getAuthPassword()
+ {
+ }
+
+ /**
+ * Get the token value for the "remember me" session.
+ *
+ * @return string
+ */
+ public function getRememberToken()
+ {
+ }
+
+ /**
+ * Set the token value for the "remember me" session.
+ *
+ * @param string $value
+ *
+ * @return void
+ */
+ public function setRememberToken($value)
+ {
+ }
+
+ /**
+ * Get the column name for the "remember me" token.
+ *
+ * @return string
+ */
+ public function getRememberTokenName()
+ {
+ }
+
+ /**
+ * Returns the department number.
+ *
+ * @return string
+ */
+ public function getDepartmentNumber()
+ {
+ return $this->getFirstAttribute($this->schema->departmentNumber());
+ }
+
+ /**
+ * Sets the department number.
+ *
+ * @param string $number
+ *
+ * @return $this
+ */
+ public function setDepartmentNumber($number)
+ {
+ return $this->setFirstAttribute($this->schema->departmentNumber(), $number);
+ }
+
+ /**
+ * Returns the users info.
+ *
+ * @return mixed
+ */
+ public function getInfo()
+ {
+ return $this->getFirstAttribute($this->schema->info());
+ }
+
+ /**
+ * Sets the users info.
+ *
+ * @param string $info
+ *
+ * @return $this
+ */
+ public function setInfo($info)
+ {
+ return $this->setFirstAttribute($this->schema->info(), $info);
+ }
+
+ /**
+ * Returns the users physical delivery office name.
+ *
+ * @return string
+ */
+ public function getPhysicalDeliveryOfficeName()
+ {
+ return $this->getFirstAttribute($this->schema->physicalDeliveryOfficeName());
+ }
+
+ /**
+ * Sets the users physical delivery office name.
+ *
+ * @param string $deliveryOffice
+ *
+ * @return $this
+ */
+ public function setPhysicalDeliveryOfficeName($deliveryOffice)
+ {
+ return $this->setFirstAttribute($this->schema->physicalDeliveryOfficeName(), $deliveryOffice);
+ }
+
+ /**
+ * Returns the users locale.
+ *
+ * @return string
+ */
+ public function getLocale()
+ {
+ return $this->getFirstAttribute($this->schema->locale());
+ }
+
+ /**
+ * Sets the users locale.
+ *
+ * @param string $locale
+ *
+ * @return $this
+ */
+ public function setLocale($locale)
+ {
+ return $this->setFirstAttribute($this->schema->locale(), $locale);
+ }
+
+ /**
+ * Returns the users company.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675457(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getCompany()
+ {
+ return $this->getFirstAttribute($this->schema->company());
+ }
+
+ /**
+ * Sets the users company.
+ *
+ * @param string $company
+ *
+ * @return $this
+ */
+ public function setCompany($company)
+ {
+ return $this->setFirstAttribute($this->schema->company(), $company);
+ }
+
+ /**
+ * Returns the users mailbox store DN.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/aa487565(v=exchg.65).aspx
+ *
+ * @return string
+ */
+ public function getHomeMdb()
+ {
+ return $this->getFirstAttribute($this->schema->homeMdb());
+ }
+
+ /**
+ * Sets the users home drive.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676191(v=vs.85).aspx
+ *
+ * @return $this
+ */
+ public function setHomeDrive($drive)
+ {
+ return $this->setAttribute($this->schema->homeDrive(), $drive);
+ }
+
+ /**
+ * Specifies the drive letter to which to map the UNC path specified by homeDirectory.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676191(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getHomeDrive()
+ {
+ return $this->getFirstAttribute($this->schema->homeDrive());
+ }
+
+ /**
+ * Sets the users home directory.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676190(v=vs.85).aspx
+ *
+ * @param string $directory
+ *
+ * @return $this
+ */
+ public function setHomeDirectory($directory)
+ {
+ return $this->setAttribute($this->schema->homeDirectory(), $directory);
+ }
+
+ /**
+ * The home directory for the account.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676190(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function getHomeDirectory()
+ {
+ return $this->getFirstAttribute($this->schema->homeDirectory());
+ }
+
+ /**
+ * The user's main home phone number.
+ *
+ * @link https://docs.microsoft.com/en-us/windows/desktop/ADSchema/a-homephone
+ *
+ * @return string|null
+ */
+ public function getHomePhone()
+ {
+ return $this->getFirstAttribute($this->schema->homePhone());
+ }
+
+ /**
+ * Returns the users principal name.
+ *
+ * This is usually their email address.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680857(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getUserPrincipalName()
+ {
+ return $this->getFirstAttribute($this->schema->userPrincipalName());
+ }
+
+ /**
+ * Sets the users user principal name.
+ *
+ * @param string $userPrincipalName
+ *
+ * @return $this
+ */
+ public function setUserPrincipalName($userPrincipalName)
+ {
+ return $this->setFirstAttribute($this->schema->userPrincipalName(), $userPrincipalName);
+ }
+
+ /**
+ * Returns an array of workstations the user is assigned to.
+ *
+ * @return array
+ */
+ public function getUserWorkstations()
+ {
+ $workstations = $this->getFirstAttribute($this->schema->userWorkstations());
+
+ return array_filter(explode(',', $workstations));
+ }
+
+ /**
+ * Sets the workstations the user can login to.
+ *
+ * @param string|array $workstations The names of the workstations the user can login to.
+ * Must be an array of names, or a comma separated
+ * list of names.
+ *
+ * @return $this
+ */
+ public function setUserWorkstations($workstations = [])
+ {
+ if (is_array($workstations)) {
+ $workstations = implode(',', $workstations);
+ }
+
+ return $this->setFirstAttribute($this->schema->userWorkstations(), $workstations);
+ }
+
+ /**
+ * Returns the users script path if the user has one.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679656(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function getScriptPath()
+ {
+ return $this->getFirstAttribute($this->schema->scriptPath());
+ }
+
+ /**
+ * Sets the users script path.
+ *
+ * @param string $path
+ *
+ * @return $this
+ */
+ public function setScriptPath($path)
+ {
+ return $this->setFirstAttribute($this->schema->scriptPath(), $path);
+ }
+
+ /**
+ * Returns the users bad password count.
+ *
+ * @return string
+ */
+ public function getBadPasswordCount()
+ {
+ return $this->getFirstAttribute($this->schema->badPasswordCount());
+ }
+
+ /**
+ * Returns the users bad password time.
+ *
+ * @return string
+ */
+ public function getBadPasswordTime()
+ {
+ return $this->getFirstAttribute($this->schema->badPasswordTime());
+ }
+
+ /**
+ * Returns the bad password time unix timestamp.
+ *
+ * @return float|null
+ */
+ public function getBadPasswordTimestamp()
+ {
+ if ($time = $this->getBadPasswordTime()) {
+ return Utilities::convertWindowsTimeToUnixTime($time);
+ }
+ }
+
+ /**
+ * Returns the formatted timestamp of the bad password date.
+ *
+ * @throws \Exception
+ *
+ * @return string|null
+ */
+ public function getBadPasswordDate()
+ {
+ if ($timestamp = $this->getBadPasswordTimestamp()) {
+ return (new DateTime())->setTimestamp($timestamp)->format($this->dateFormat);
+ }
+ }
+
+ /**
+ * Returns the time when the users password was set last.
+ *
+ * @return string
+ */
+ public function getPasswordLastSet()
+ {
+ return $this->getFirstAttribute($this->schema->passwordLastSet());
+ }
+
+ /**
+ * Returns the password last set unix timestamp.
+ *
+ * @return float|null
+ */
+ public function getPasswordLastSetTimestamp()
+ {
+ if ($time = $this->getPasswordLastSet()) {
+ return Utilities::convertWindowsTimeToUnixTime($time);
+ }
+ }
+
+ /**
+ * Returns the formatted timestamp of the password last set date.
+ *
+ * @throws \Exception
+ *
+ * @return string|null
+ */
+ public function getPasswordLastSetDate()
+ {
+ if ($timestamp = $this->getPasswordLastSetTimestamp()) {
+ return (new DateTime())->setTimestamp($timestamp)->format($this->dateFormat);
+ }
+ }
+
+ /**
+ * Returns the users lockout time.
+ *
+ * @return string
+ */
+ public function getLockoutTime()
+ {
+ return $this->getFirstAttribute($this->schema->lockoutTime());
+ }
+
+ /**
+ * Returns the users lockout unix timestamp.
+ *
+ * @return float|null
+ */
+ public function getLockoutTimestamp()
+ {
+ if ($time = $this->getLockoutTime()) {
+ return Utilities::convertWindowsTimeToUnixTime($time);
+ }
+ }
+
+ /**
+ * Returns the formatted timestamp of the lockout date.
+ *
+ * @throws \Exception
+ *
+ * @return string|null
+ */
+ public function getLockoutDate()
+ {
+ if ($timestamp = $this->getLockoutTimestamp()) {
+ return (new DateTime())->setTimestamp($timestamp)->format($this->dateFormat);
+ }
+ }
+
+ /**
+ * Clears the accounts lockout time, unlocking the account.
+ *
+ * @return $this
+ */
+ public function setClearLockoutTime()
+ {
+ return $this->setFirstAttribute($this->schema->lockoutTime(), 0);
+ }
+
+ /**
+ * Returns the users profile file path.
+ *
+ * @return string
+ */
+ public function getProfilePath()
+ {
+ return $this->getFirstAttribute($this->schema->profilePath());
+ }
+
+ /**
+ * Sets the users profile path.
+ *
+ * @param string $path
+ *
+ * @return $this
+ */
+ public function setProfilePath($path)
+ {
+ return $this->setFirstAttribute($this->schema->profilePath(), $path);
+ }
+
+ /**
+ * Returns the users legacy exchange distinguished name.
+ *
+ * @return string
+ */
+ public function getLegacyExchangeDn()
+ {
+ return $this->getFirstAttribute($this->schema->legacyExchangeDn());
+ }
+
+ /**
+ * Sets the users account expiry date.
+ *
+ * If no expiry time is given, the account is set to never expire.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675098(v=vs.85).aspx
+ *
+ * @param float $expiryTime
+ *
+ * @return $this
+ */
+ public function setAccountExpiry($expiryTime)
+ {
+ $time = is_null($expiryTime) ? '9223372036854775807' : (string) Utilities::convertUnixTimeToWindowsTime($expiryTime);
+
+ return $this->setFirstAttribute($this->schema->accountExpires(), $time);
+ }
+
+ /**
+ * Returns an array of address book DNs
+ * that the user is listed to be shown in.
+ *
+ * @return array
+ */
+ public function getShowInAddressBook()
+ {
+ return $this->getAttribute($this->schema->showInAddressBook());
+ }
+
+ /**
+ * Returns the users thumbnail photo base 64 encoded.
+ *
+ * Suitable for inserting into an HTML image element.
+ *
+ * @return string|null
+ */
+ public function getThumbnailEncoded()
+ {
+ if ($data = base64_decode($this->getThumbnail(), $strict = true)) {
+ // In case we don't have the file info extension enabled,
+ // we'll set the jpeg mime type as default.
+ $mime = 'image/jpeg';
+
+ $image = base64_encode($data);
+
+ if (function_exists('finfo_open')) {
+ $finfo = finfo_open();
+
+ $mime = finfo_buffer($finfo, $data, FILEINFO_MIME_TYPE);
+
+ return "data:$mime;base64,$image";
+ }
+
+ return "data:$mime;base64,$image";
+ }
+ }
+
+ /**
+ * Returns the users thumbnail photo.
+ *
+ * @return mixed
+ */
+ public function getThumbnail()
+ {
+ return $this->getFirstAttribute($this->schema->thumbnail());
+ }
+
+ /**
+ * Sets the users thumbnail photo.
+ *
+ * @param string $data
+ * @param bool $encode
+ *
+ * @return $this
+ */
+ public function setThumbnail($data, $encode = true)
+ {
+ if ($encode && !base64_decode($data, $strict = true)) {
+ // If the string we're given is not base 64 encoded, then
+ // we will encode it before setting it on the user.
+ $data = base64_encode($data);
+ }
+
+ return $this->setAttribute($this->schema->thumbnail(), $data);
+ }
+
+ /**
+ * Returns the users JPEG photo.
+ *
+ * @return null|string
+ */
+ public function getJpegPhotoEncoded()
+ {
+ $jpeg = $this->getJpegPhoto();
+
+ return is_null($jpeg) ? $jpeg : 'data:image/jpeg;base64,'.base64_encode($jpeg);
+ }
+
+ /**
+ * Returns the users JPEG photo.
+ *
+ * @return mixed
+ */
+ public function getJpegPhoto()
+ {
+ return $this->getFirstAttribute($this->schema->jpegPhoto());
+ }
+
+ /**
+ * Sets the users JPEG photo.
+ *
+ * @param string $string
+ *
+ * @return $this
+ */
+ public function setJpegPhoto($string)
+ {
+ if (!base64_decode($string, $strict = true)) {
+ $string = base64_encode($string);
+ }
+
+ return $this->setAttribute($this->schema->jpegPhoto(), $string);
+ }
+
+ /**
+ * Return the employee ID.
+ *
+ * @return string
+ */
+ public function getEmployeeId()
+ {
+ return $this->getFirstAttribute($this->schema->employeeId());
+ }
+
+ /**
+ * Sets the employee ID.
+ *
+ * @param string $employeeId
+ *
+ * @return $this
+ */
+ public function setEmployeeId($employeeId)
+ {
+ return $this->setFirstAttribute($this->schema->employeeId(), $employeeId);
+ }
+
+ /**
+ * Returns the employee type.
+ *
+ * @return string|null
+ */
+ public function getEmployeeType()
+ {
+ return $this->getFirstAttribute($this->schema->employeeType());
+ }
+
+ /**
+ * Sets the employee type.
+ *
+ * @param string $type
+ *
+ * @return $this
+ */
+ public function setEmployeeType($type)
+ {
+ return $this->setFirstAttribute($this->schema->employeeType(), $type);
+ }
+
+ /**
+ * Returns the employee number.
+ *
+ * @return string
+ */
+ public function getEmployeeNumber()
+ {
+ return $this->getFirstAttribute($this->schema->employeeNumber());
+ }
+
+ /**
+ * Sets the employee number.
+ *
+ * @param string $number
+ *
+ * @return $this
+ */
+ public function setEmployeeNumber($number)
+ {
+ return $this->setFirstAttribute($this->schema->employeeNumber(), $number);
+ }
+
+ /**
+ * Returns the room number.
+ *
+ * @return string
+ */
+ public function getRoomNumber()
+ {
+ return $this->getFirstAttribute($this->schema->roomNumber());
+ }
+
+ /**
+ * Sets the room number.
+ *
+ * @param string $number
+ *
+ * @return $this
+ */
+ public function setRoomNumber($number)
+ {
+ return $this->setFirstAttribute($this->schema->roomNumber(), $number);
+ }
+
+ /**
+ * Return the personal title.
+ *
+ * @return $this
+ */
+ public function getPersonalTitle()
+ {
+ return $this->getFirstAttribute($this->schema->personalTitle());
+ }
+
+ /**
+ * Sets the personal title.
+ *
+ * @param string $personalTitle
+ *
+ * @return $this
+ */
+ public function setPersonalTitle($personalTitle)
+ {
+ return $this->setFirstAttribute($this->schema->personalTitle(), $personalTitle);
+ }
+
+ /**
+ * Return the user parameters.
+ *
+ * @return TSPropertyArray
+ */
+ public function getUserParameters()
+ {
+ return new TSPropertyArray($this->getFirstAttribute('userparameters'));
+ }
+
+ /**
+ * Sets the user parameters.
+ *
+ * @param TSPropertyArray $userParameters
+ *
+ * @return $this
+ */
+ public function setUserParameters(TSPropertyArray $userParameters)
+ {
+ return $this->setFirstAttribute('userparameters', $userParameters->toBinary());
+ }
+
+ /**
+ * Retrieves the primary group of the current user.
+ *
+ * @return Model|bool
+ */
+ public function getPrimaryGroup()
+ {
+ $groupSid = preg_replace('/\d+$/', $this->getPrimaryGroupId(), $this->getConvertedSid());
+
+ return $this->query->newInstance()->findBySid($groupSid);
+ }
+
+ /**
+ * Sets the password on the current user.
+ *
+ * @param string $password
+ *
+ * @throws AdldapException When no SSL or TLS secured connection is present.
+ *
+ * @return $this
+ */
+ public function setPassword($password)
+ {
+ $this->validateSecureConnection();
+
+ $encodedPassword = call_user_func(static::getPasswordStrategy(), $password);
+
+ if ($this->exists) {
+ // If the record exists, we need to add a batch replace
+ // modification, otherwise we'll receive a "type or
+ // value" exists exception from our LDAP server.
+ return $this->addModification(
+ $this->newBatchModification(
+ $this->schema->unicodePassword(),
+ LDAP_MODIFY_BATCH_REPLACE,
+ [$encodedPassword]
+ )
+ );
+ } else {
+ // Otherwise, we are creating a new record
+ // and we can set the attribute normally.
+ return $this->setFirstAttribute(
+ $this->schema->unicodePassword(),
+ $encodedPassword
+ );
+ }
+ }
+
+ /**
+ * Sets the option to force the password change at the next logon.
+ *
+ * Does not work if the "Password never expires" option is enabled.
+ *
+ * @return $this
+ */
+ public function setEnableForcePasswordChange()
+ {
+ return $this->setFirstAttribute($this->schema->passwordLastSet(), 0);
+ }
+
+ /**
+ * Sets the option to disable forcing a password change at the next logon.
+ *
+ * @return $this
+ */
+ public function setDisableForcePasswordChange()
+ {
+ return $this->setFirstAttribute($this->schema->passwordLastSet(), -1);
+ }
+
+ /**
+ * Change the password of the current user. This must be performed over SSL / TLS.
+ *
+ * Throws an exception on failure.
+ *
+ * @param string $oldPassword The new password
+ * @param string $newPassword The old password
+ * @param bool $replaceNotRemove Alternative password change method. Set to true if you're receiving 'CONSTRAINT'
+ * errors.
+ *
+ * @throws UserPasswordPolicyException When the new password does not match your password policy.
+ * @throws UserPasswordIncorrectException When the old password is incorrect.
+ * @throws AdldapException When an unknown cause of failure occurs.
+ *
+ * @return true
+ */
+ public function changePassword($oldPassword, $newPassword, $replaceNotRemove = false)
+ {
+ $this->validateSecureConnection();
+
+ $attribute = $this->schema->unicodePassword();
+
+ $modifications = [];
+
+ if ($replaceNotRemove) {
+ $modifications[] = $this->newBatchModification(
+ $attribute,
+ LDAP_MODIFY_BATCH_REPLACE,
+ [call_user_func(static::getPasswordStrategy(), $newPassword)]
+ );
+ } else {
+ // Create batch modification for removing the old password.
+ $modifications[] = $this->newBatchModification(
+ $attribute,
+ LDAP_MODIFY_BATCH_REMOVE,
+ [call_user_func(static::getPasswordStrategy(), $oldPassword)]
+ );
+
+ // Create batch modification for adding the new password.
+ $modifications[] = $this->newBatchModification(
+ $attribute,
+ LDAP_MODIFY_BATCH_ADD,
+ [call_user_func(static::getPasswordStrategy(), $newPassword)]
+ );
+ }
+
+ // Add the modifications.
+ foreach ($modifications as $modification) {
+ $this->addModification($modification);
+ }
+
+ $result = @$this->update();
+
+ if (!$result) {
+ // If the user failed to update, we'll see if we can
+ // figure out why by retrieving the extended error.
+ $error = $this->query->getConnection()->getExtendedError();
+ $code = $this->query->getConnection()->getExtendedErrorCode();
+
+ switch ($code) {
+ case '0000052D':
+ throw new UserPasswordPolicyException(
+ "Error: $code. Your new password does not match the password policy."
+ );
+ case '00000056':
+ throw new UserPasswordIncorrectException(
+ "Error: $code. Your old password is incorrect."
+ );
+ default:
+ throw new AdldapException($error);
+ }
+ }
+
+ return $result;
+ }
+
+ /**
+ * Return true / false if LDAP User is active (enabled & not expired).
+ *
+ * @return bool
+ */
+ public function isActive()
+ {
+ return $this->isEnabled() && !$this->isExpired();
+ }
+
+ /**
+ * Return true / false if the LDAP User is expired.
+ *
+ * @param DateTime $date Optional date
+ *
+ * @return bool
+ */
+ public function isExpired(DateTime $date = null)
+ {
+ // Here we'll determine if the account expires by checking is expiration date.
+ if ($expirationDate = $this->expirationDate()) {
+ $date = $date ?: new DateTime();
+
+ return $expirationDate <= $date;
+ }
+
+ // The account has no expiry date.
+ return false;
+ }
+
+ /**
+ * Return the expiration date of the user account.
+ *
+ * @throws \Exception
+ *
+ * @return DateTime|null
+ */
+ public function expirationDate()
+ {
+ $accountExpiry = $this->getAccountExpiry();
+
+ // If the account expiry is zero or the expiry is equal to
+ // ActiveDirectory's 'never expire' value,
+ // then we'll return null here.
+ if ($accountExpiry == 0 || $accountExpiry == $this->getSchema()->neverExpiresDate()) {
+ return;
+ }
+
+ $unixTime = Utilities::convertWindowsTimeToUnixTime($accountExpiry);
+
+ return (new DateTime())->setTimestamp($unixTime);
+ }
+
+ /**
+ * Returns the users account expiry date.
+ *
+ * @return string
+ */
+ public function getAccountExpiry()
+ {
+ return $this->getFirstAttribute($this->schema->accountExpires());
+ }
+
+ /**
+ * Returns true / false if the users password is expired.
+ *
+ * @return bool
+ */
+ public function passwordExpired()
+ {
+ // First we'll check the users userAccountControl to see if
+ // it contains the 'password does not expire' flag.
+ if ($this->getUserAccountControlObject()->has(AccountControl::DONT_EXPIRE_PASSWORD)) {
+ return false;
+ }
+
+ $lastSet = (int) $this->getPasswordLastSet();
+
+ if ($lastSet === 0) {
+ // If the users last set time is zero, the password has
+ // been manually expired by an administrator.
+ return true;
+ }
+
+ // We'll check if we're using the ActiveDirectory schema to retrieve
+ // the max password age, as this is an AD-only feature.
+ if ($this->schema instanceof ActiveDirectory) {
+ $query = $this->query->newInstance();
+
+ // We need to get the root domain object to be able to
+ // retrieve the max password age on the domain.
+ $rootDomainObject = $query->select($this->schema->maxPasswordAge())
+ ->whereHas($this->schema->objectClass())
+ ->first();
+
+ $maxPasswordAge = $rootDomainObject->getMaxPasswordAge();
+
+ if (empty($maxPasswordAge)) {
+ // There is not a max password age set on the LDAP server.
+ return false;
+ }
+
+ // convert from 100 nanosecond ticks to seconds
+ $maxPasswordAgeSeconds = $maxPasswordAge / 10000000;
+
+ $lastSetUnixEpoch = Utilities::convertWindowsTimeToUnixTime($lastSet);
+ $passwordExpiryTime = $lastSetUnixEpoch - $maxPasswordAgeSeconds;
+
+ $expiresAt = (new DateTime())->setTimestamp($passwordExpiryTime);
+
+ // If our current time is greater than the users password
+ // expiry time, the users password has expired.
+ return (new DateTime())->getTimestamp() >= $expiresAt->getTimestamp();
+ }
+
+ return false;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/UserPasswordIncorrectException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/UserPasswordIncorrectException.php
new file mode 100644
index 0000000..44cb39b
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/UserPasswordIncorrectException.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace Adldap\Models;
+
+use Adldap\AdldapException;
+
+/**
+ * Class UserPasswordIncorrectException.
+ *
+ * Thrown when a users password is being changed
+ * and their current password given is incorrect.
+ */
+class UserPasswordIncorrectException extends AdldapException
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/UserPasswordPolicyException.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/UserPasswordPolicyException.php
new file mode 100644
index 0000000..9a99faa
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Models/UserPasswordPolicyException.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace Adldap\Models;
+
+use Adldap\AdldapException;
+
+/**
+ * Class UserPasswordPolicyException.
+ *
+ * Thrown when a users password is being changed but their new password
+ * does not conform to the LDAP servers password policy.
+ */
+class UserPasswordPolicyException extends AdldapException
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Builder.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Builder.php
new file mode 100644
index 0000000..48f253f
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Builder.php
@@ -0,0 +1,1956 @@
+<?php
+
+namespace Adldap\Query;
+
+use Closure;
+use Adldap\Adldap;
+use Adldap\Utilities;
+use Adldap\Models\Model;
+use Illuminate\Support\Arr;
+use InvalidArgumentException;
+use Adldap\Schemas\ActiveDirectory;
+use Adldap\Schemas\SchemaInterface;
+use Adldap\Query\Events\QueryExecuted;
+use Adldap\Models\ModelNotFoundException;
+use Adldap\Connections\ConnectionInterface;
+
+class Builder
+{
+ /**
+ * The selected columns to retrieve on the query.
+ *
+ * @var array
+ */
+ public $columns = ['*'];
+
+ /**
+ * The query filters.
+ *
+ * @var array
+ */
+ public $filters = [
+ 'and' => [],
+ 'or' => [],
+ 'raw' => [],
+ ];
+
+ /**
+ * The size limit of the query.
+ *
+ * @var int
+ */
+ public $limit = 0;
+
+ /**
+ * Determines whether the current query is paginated.
+ *
+ * @var bool
+ */
+ public $paginated = false;
+
+ /**
+ * The field to sort search results by.
+ *
+ * @var string
+ */
+ protected $sortByField = '';
+
+ /**
+ * The direction to sort the results by.
+ *
+ * @var string
+ */
+ protected $sortByDirection = '';
+
+ /**
+ * The sort flags for sorting query results.
+ *
+ * @var int
+ */
+ protected $sortByFlags;
+
+ /**
+ * The distinguished name to perform searches upon.
+ *
+ * @var string|null
+ */
+ protected $dn;
+
+ /**
+ * The default query type.
+ *
+ * @var string
+ */
+ protected $type = 'search';
+
+ /**
+ * Determines whether or not to return LDAP results in their raw array format.
+ *
+ * @var bool
+ */
+ protected $raw = false;
+
+ /**
+ * Determines whether the query is nested.
+ *
+ * @var bool
+ */
+ protected $nested = false;
+
+ /**
+ * Determines whether the query should be cached.
+ *
+ * @var bool
+ */
+ protected $caching = false;
+
+ /**
+ * How long the query should be cached until.
+ *
+ * @var \DateTimeInterface|null
+ */
+ protected $cacheUntil = null;
+
+ /**
+ * Determines whether the query cache must be flushed.
+ *
+ * @var bool
+ */
+ protected $flushCache = false;
+
+ /**
+ * The current connection instance.
+ *
+ * @var ConnectionInterface
+ */
+ protected $connection;
+
+ /**
+ * The current grammar instance.
+ *
+ * @var Grammar
+ */
+ protected $grammar;
+
+ /**
+ * The current schema instance.
+ *
+ * @var SchemaInterface
+ */
+ protected $schema;
+
+ /**
+ * The current cache instance.
+ *
+ * @var Cache|null
+ */
+ protected $cache;
+
+ /**
+ * Constructor.
+ *
+ * @param ConnectionInterface $connection
+ * @param Grammar|null $grammar
+ * @param SchemaInterface|null $schema
+ */
+ public function __construct(ConnectionInterface $connection, Grammar $grammar = null, SchemaInterface $schema = null)
+ {
+ $this->setConnection($connection)
+ ->setGrammar($grammar)
+ ->setSchema($schema);
+ }
+
+ /**
+ * Sets the current connection.
+ *
+ * @param ConnectionInterface $connection
+ *
+ * @return Builder
+ */
+ public function setConnection(ConnectionInterface $connection)
+ {
+ $this->connection = $connection;
+
+ return $this;
+ }
+
+ /**
+ * Sets the current filter grammar.
+ *
+ * @param Grammar|null $grammar
+ *
+ * @return Builder
+ */
+ public function setGrammar(Grammar $grammar = null)
+ {
+ $this->grammar = $grammar ?: new Grammar();
+
+ return $this;
+ }
+
+ /**
+ * Sets the current schema.
+ *
+ * @param SchemaInterface|null $schema
+ *
+ * @return Builder
+ */
+ public function setSchema(SchemaInterface $schema = null)
+ {
+ $this->schema = $schema ?: new ActiveDirectory();
+
+ return $this;
+ }
+
+ /**
+ * Returns the current schema.
+ *
+ * @return SchemaInterface
+ */
+ public function getSchema()
+ {
+ return $this->schema;
+ }
+
+ /**
+ * Sets the cache to store query results.
+ *
+ * @param Cache|null $cache
+ */
+ public function setCache(Cache $cache = null)
+ {
+ $this->cache = $cache;
+
+ return $this;
+ }
+
+ /**
+ * Returns a new Query Builder instance.
+ *
+ * @param string $baseDn
+ *
+ * @return Builder
+ */
+ public function newInstance($baseDn = null)
+ {
+ // We'll set the base DN of the new Builder so
+ // developers don't need to do this manually.
+ $dn = is_null($baseDn) ? $this->getDn() : $baseDn;
+
+ return (new static($this->connection, $this->grammar, $this->schema))
+ ->setDn($dn);
+ }
+
+ /**
+ * Returns a new nested Query Builder instance.
+ *
+ * @param Closure|null $closure
+ *
+ * @return $this
+ */
+ public function newNestedInstance(Closure $closure = null)
+ {
+ $query = $this->newInstance()->nested();
+
+ if ($closure) {
+ call_user_func($closure, $query);
+ }
+
+ return $query;
+ }
+
+ /**
+ * Returns the current query.
+ *
+ * @return Collection|array
+ */
+ public function get()
+ {
+ // We'll mute any warnings / errors here. We just need to
+ // know if any query results were returned.
+ return @$this->query($this->getQuery());
+ }
+
+ /**
+ * Compiles and returns the current query string.
+ *
+ * @return string
+ */
+ public function getQuery()
+ {
+ // We need to ensure we have at least one filter, as
+ // no query results will be returned otherwise.
+ if (count(array_filter($this->filters)) === 0) {
+ $this->whereHas($this->schema->objectClass());
+ }
+
+ return $this->grammar->compile($this);
+ }
+
+ /**
+ * Returns the unescaped query.
+ *
+ * @return string
+ */
+ public function getUnescapedQuery()
+ {
+ return Utilities::unescape($this->getQuery());
+ }
+
+ /**
+ * Returns the current Grammar instance.
+ *
+ * @return Grammar
+ */
+ public function getGrammar()
+ {
+ return $this->grammar;
+ }
+
+ /**
+ * Returns the current Connection instance.
+ *
+ * @return ConnectionInterface
+ */
+ public function getConnection()
+ {
+ return $this->connection;
+ }
+
+ /**
+ * Returns the builders DN to perform searches upon.
+ *
+ * @return string
+ */
+ public function getDn()
+ {
+ return $this->dn;
+ }
+
+ /**
+ * Sets the DN to perform searches upon.
+ *
+ * @param string|Model|null $dn
+ *
+ * @return Builder
+ */
+ public function setDn($dn = null)
+ {
+ $this->dn = $dn instanceof Model ? $dn->getDn() : $dn;
+
+ return $this;
+ }
+
+ /**
+ * Alias for setting the base DN of the query.
+ *
+ * @param string|Model|null $dn
+ *
+ * @return Builder
+ */
+ public function in($dn = null)
+ {
+ return $this->setDn($dn);
+ }
+
+ /**
+ * Sets the size limit of the current query.
+ *
+ * @param int $limit
+ *
+ * @return Builder
+ */
+ public function limit($limit = 0)
+ {
+ $this->limit = $limit;
+
+ return $this;
+ }
+
+ /**
+ * Performs the specified query on the current LDAP connection.
+ *
+ * @param string $query
+ *
+ * @return \Adldap\Query\Collection|array
+ */
+ public function query($query)
+ {
+ $start = microtime(true);
+
+ // Here we will create the execution callback. This allows us
+ // to only execute an LDAP request if caching is disabled
+ // or if no cache of the given query exists yet.
+ $callback = function () use ($query) {
+ return $this->parse($this->run($query));
+ };
+
+ // If caching is enabled and we have a cache instance available,
+ // we will try to retrieve the cached results instead.
+ // Otherwise, we will simply execute the callback.
+ if ($this->caching && $this->cache) {
+ $results = $this->getCachedResponse($this->getCacheKey($query), $callback);
+ } else {
+ $results = $callback();
+ }
+
+ // Log the query.
+ $this->logQuery($this, $this->type, $this->getElapsedTime($start));
+
+ // Process & return the results.
+ return $this->newProcessor()->process($results);
+ }
+
+ /**
+ * Paginates the current LDAP query.
+ *
+ * @param int $perPage
+ * @param int $currentPage
+ * @param bool $isCritical
+ *
+ * @return Paginator
+ */
+ public function paginate($perPage = 1000, $currentPage = 0, $isCritical = true)
+ {
+ $this->paginated = true;
+
+ $start = microtime(true);
+
+ $query = $this->getQuery();
+
+ // Here we will create the pagination callback. This allows us
+ // to only execute an LDAP request if caching is disabled
+ // or if no cache of the given query exists yet.
+ $callback = function () use ($query, $perPage, $isCritical) {
+ return $this->runPaginate($query, $perPage, $isCritical);
+ };
+
+ // If caching is enabled and we have a cache instance available,
+ // we will try to retrieve the cached results instead.
+ if ($this->caching && $this->cache) {
+ $pages = $this->getCachedResponse($this->getCacheKey($query), $callback);
+ } else {
+ $pages = $callback();
+ }
+
+ // Log the query.
+ $this->logQuery($this, 'paginate', $this->getElapsedTime($start));
+
+ // Process & return the results.
+ return $this->newProcessor()->processPaginated($pages, $perPage, $currentPage);
+ }
+
+ /**
+ * Get the cached response or execute and cache the callback value.
+ *
+ * @param string $key
+ * @param Closure $callback
+ *
+ * @return mixed
+ */
+ protected function getCachedResponse($key, Closure $callback)
+ {
+ if ($this->flushCache) {
+ $this->cache->delete($key);
+ }
+
+ return $this->cache->remember($key, $this->cacheUntil, $callback);
+ }
+
+ /**
+ * Runs the query operation with the given filter.
+ *
+ * @param string $filter
+ *
+ * @return resource
+ */
+ protected function run($filter)
+ {
+ return $this->connection->{$this->type}(
+ $this->getDn(),
+ $filter,
+ $this->getSelects(),
+ $onlyAttributes = false,
+ $this->limit
+ );
+ }
+
+ /**
+ * Runs the paginate operation with the given filter.
+ *
+ * @param string $filter
+ * @param int $perPage
+ * @param bool $isCritical
+ *
+ * @return array
+ */
+ protected function runPaginate($filter, $perPage, $isCritical)
+ {
+ return $this->connection->supportsServerControlsInMethods() ?
+ $this->compatiblePaginationCallback($filter, $perPage, $isCritical) :
+ $this->deprecatedPaginationCallback($filter, $perPage, $isCritical);
+ }
+
+ /**
+ * Create a deprecated pagination callback compatible with PHP 7.2.
+ *
+ * @param string $filter
+ * @param int $perPage
+ * @param bool $isCritical
+ *
+ * @return array
+ */
+ protected function deprecatedPaginationCallback($filter, $perPage, $isCritical)
+ {
+ $pages = [];
+
+ $cookie = '';
+
+ do {
+ $this->connection->controlPagedResult($perPage, $isCritical, $cookie);
+
+ if (! $resource = $this->run($filter)) {
+ break;
+ }
+
+ // If we have been given a valid resource, we will retrieve the next
+ // pagination cookie to send for our next pagination request.
+ $this->connection->controlPagedResultResponse($resource, $cookie);
+
+ $pages[] = $this->parse($resource);
+ } while (!empty($cookie));
+
+ // Reset paged result on the current connection. We won't pass in the current $perPage
+ // parameter since we want to reset the page size to the default '1000'. Sending '0'
+ // eliminates any further opportunity for running queries in the same request,
+ // even though that is supposed to be the correct usage.
+ $this->connection->controlPagedResult();
+
+ return $pages;
+ }
+
+ /**
+ * Create a compatible pagination callback compatible with PHP 7.3 and greater.
+ *
+ * @param string $filter
+ * @param int $perPage
+ * @param bool $isCritical
+ *
+ * @return array
+ */
+ protected function compatiblePaginationCallback($filter, $perPage, $isCritical)
+ {
+ $pages = [];
+
+ // Setup our paged results control.
+ $controls = [
+ LDAP_CONTROL_PAGEDRESULTS => [
+ 'oid' => LDAP_CONTROL_PAGEDRESULTS,
+ 'isCritical' => $isCritical,
+ 'value' => [
+ 'size' => $perPage,
+ 'cookie' => '',
+ ],
+ ],
+ ];
+
+ do {
+ // Update the server controls.
+ $this->connection->setOption(LDAP_OPT_SERVER_CONTROLS, $controls);
+
+ if (! $resource = $this->run($filter)) {
+ break;
+ }
+
+ $errorCode = $dn = $errorMessage = $refs = null;
+
+ // Update the server controls with the servers response.
+ $this->connection->parseResult($resource, $errorCode, $dn, $errorMessage, $refs, $controls);
+
+ $pages[] = $this->parse($resource);
+
+ // Reset paged result on the current connection. We won't pass in the current $perPage
+ // parameter since we want to reset the page size to the default '1000'. Sending '0'
+ // eliminates any further opportunity for running queries in the same request,
+ // even though that is supposed to be the correct usage.
+ $controls[LDAP_CONTROL_PAGEDRESULTS]['value']['size'] = $perPage;
+ } while (!empty($controls[LDAP_CONTROL_PAGEDRESULTS]['value']['cookie']));
+
+ // After running the query, we will clear the LDAP server controls. This
+ // allows the controls to be automatically reset before each new query
+ // that is conducted on the same connection during each request.
+ $this->connection->setOption(LDAP_OPT_SERVER_CONTROLS, []);
+
+ return $pages;
+ }
+
+ /**
+ * Parses the given LDAP resource by retrieving its entries.
+ *
+ * @param resource $resource
+ *
+ * @return array
+ */
+ protected function parse($resource)
+ {
+ // Normalize entries. Get entries returns false on failure.
+ // We'll always want an array in this situation.
+ $entries = $this->connection->getEntries($resource) ?: [];
+
+ // Free up memory.
+ if (is_resource($resource)) {
+ $this->connection->freeResult($resource);
+ }
+
+ return $entries;
+ }
+
+ /**
+ * Returns the cache key.
+ *
+ * @param string $query
+ *
+ * @return string
+ */
+ protected function getCacheKey($query)
+ {
+ $key = $this->connection->getHost()
+ .$this->type
+ .$this->getDn()
+ .$query
+ .implode('', $this->getSelects())
+ .$this->limit
+ .$this->paginated;
+
+ return md5($key);
+ }
+
+ /**
+ * Returns the first entry in a search result.
+ *
+ * @param array|string $columns
+ *
+ * @return Model|array|null
+ */
+ public function first($columns = [])
+ {
+ $results = $this->select($columns)->limit(1)->get();
+
+ // Since results may be returned inside an array if `raw()`
+ // is specified, then we'll use our array helper
+ // to retrieve the first result.
+ return Arr::get($results, 0);
+ }
+
+ /**
+ * Returns the first entry in a search result.
+ *
+ * If no entry is found, an exception is thrown.
+ *
+ * @param array|string $columns
+ *
+ * @throws ModelNotFoundException
+ *
+ * @return Model|array
+ */
+ public function firstOrFail($columns = [])
+ {
+ $record = $this->first($columns);
+
+ if (!$record) {
+ throw (new ModelNotFoundException())
+ ->setQuery($this->getUnescapedQuery(), $this->getDn());
+ }
+
+ return $record;
+ }
+
+ /**
+ * Finds a record by the specified attribute and value.
+ *
+ * @param string $attribute
+ * @param string $value
+ * @param array|string $columns
+ *
+ * @return Model|array|false
+ */
+ public function findBy($attribute, $value, $columns = [])
+ {
+ try {
+ return $this->findByOrFail($attribute, $value, $columns);
+ } catch (ModelNotFoundException $e) {
+ return;
+ }
+ }
+
+ /**
+ * Finds a record by the specified attribute and value.
+ *
+ * If no record is found an exception is thrown.
+ *
+ * @param string $attribute
+ * @param string $value
+ * @param array|string $columns
+ *
+ * @throws ModelNotFoundException
+ *
+ * @return Model|array
+ */
+ public function findByOrFail($attribute, $value, $columns = [])
+ {
+ return $this->whereEquals($attribute, $value)->firstOrFail($columns);
+ }
+
+ /**
+ * Finds a record using ambiguous name resolution.
+ *
+ * @param string|array $value
+ * @param array|string $columns
+ *
+ * @return Model|array|null
+ */
+ public function find($value, $columns = [])
+ {
+ if (is_array($value)) {
+ return $this->findMany($value, $columns);
+ }
+
+ // If we're not using ActiveDirectory, we can't use ANR. We'll make our own query.
+ if (!is_a($this->schema, ActiveDirectory::class)) {
+ return $this->prepareAnrEquivalentQuery($value)->first($columns);
+ }
+
+ return $this->findBy($this->schema->anr(), $value, $columns);
+ }
+
+ /**
+ * Finds multiple records using ambiguous name resolution.
+ *
+ * @param array $values
+ * @param array $columns
+ *
+ * @return \Adldap\Query\Collection|array
+ */
+ public function findMany(array $values = [], $columns = [])
+ {
+ $this->select($columns);
+
+ if (!is_a($this->schema, ActiveDirectory::class)) {
+ $query = $this;
+
+ foreach ($values as $value) {
+ $query->prepareAnrEquivalentQuery($value);
+ }
+
+ return $query->get();
+ }
+
+ return $this->findManyBy($this->schema->anr(), $values);
+ }
+
+ /**
+ * Creates an ANR equivalent query for LDAP distributions that do not support ANR.
+ *
+ * @param string $value
+ *
+ * @return Builder
+ */
+ protected function prepareAnrEquivalentQuery($value)
+ {
+ return $this->orFilter(function (self $query) use ($value) {
+ $locateBy = [
+ $this->schema->name(),
+ $this->schema->email(),
+ $this->schema->userId(),
+ $this->schema->lastName(),
+ $this->schema->firstName(),
+ $this->schema->commonName(),
+ $this->schema->displayName(),
+ ];
+
+ foreach ($locateBy as $attribute) {
+ $query->whereEquals($attribute, $value);
+ }
+ });
+ }
+
+ /**
+ * Finds many records by the specified attribute.
+ *
+ * @param string $attribute
+ * @param array $values
+ * @param array $columns
+ *
+ * @return \Adldap\Query\Collection|array
+ */
+ public function findManyBy($attribute, array $values = [], $columns = [])
+ {
+ $query = $this->select($columns);
+
+ foreach ($values as $value) {
+ $query->orWhere([$attribute => $value]);
+ }
+
+ return $query->get();
+ }
+
+ /**
+ * Finds a record using ambiguous name resolution.
+ *
+ * If a record is not found, an exception is thrown.
+ *
+ * @param string $value
+ * @param array|string $columns
+ *
+ * @throws ModelNotFoundException
+ *
+ * @return Model|array
+ */
+ public function findOrFail($value, $columns = [])
+ {
+ $entry = $this->find($value, $columns);
+
+ // Make sure we check if the result is an entry or an array before
+ // we throw an exception in case the user wants raw results.
+ if (!$entry instanceof Model && !is_array($entry)) {
+ throw (new ModelNotFoundException())
+ ->setQuery($this->getUnescapedQuery(), $this->getDn());
+ }
+
+ return $entry;
+ }
+
+ /**
+ * Finds a record by its distinguished name.
+ *
+ * @param string $dn
+ * @param array|string $columns
+ *
+ * @return bool|Model
+ */
+ public function findByDn($dn, $columns = [])
+ {
+ try {
+ return $this->findByDnOrFail($dn, $columns);
+ } catch (ModelNotFoundException $e) {
+ return;
+ }
+ }
+
+ /**
+ * Finds a record by its distinguished name.
+ *
+ * Fails upon no records returned.
+ *
+ * @param string $dn
+ * @param array|string $columns
+ *
+ * @throws ModelNotFoundException
+ *
+ * @return Model|array
+ */
+ public function findByDnOrFail($dn, $columns = [])
+ {
+ // Since we're setting our base DN to be able to retrieve a model
+ // by its distinguished name, we need to set it back to
+ // our configured base so it is not overwritten.
+ $base = $this->getDn();
+
+ $model = $this->setDn($dn)
+ ->read()
+ ->whereHas($this->schema->objectClass())
+ ->firstOrFail($columns);
+
+ // Reset the models query builder (in case a model is returned).
+ // Otherwise, we must be requesting a raw result.
+ if ($model instanceof Model) {
+ $model->setQuery($this->in($base));
+ }
+
+ return $model;
+ }
+
+ /**
+ * Finds a record by its string GUID.
+ *
+ * @param string $guid
+ * @param array|string $columns
+ *
+ * @return Model|array|false
+ */
+ public function findByGuid($guid, $columns = [])
+ {
+ try {
+ return $this->findByGuidOrFail($guid, $columns);
+ } catch (ModelNotFoundException $e) {
+ return;
+ }
+ }
+
+ /**
+ * Finds a record by its string GUID.
+ *
+ * Fails upon no records returned.
+ *
+ * @param string $guid
+ * @param array|string $columns
+ *
+ * @throws ModelNotFoundException
+ *
+ * @return Model|array
+ */
+ public function findByGuidOrFail($guid, $columns = [])
+ {
+ if ($this->schema->objectGuidRequiresConversion()) {
+ $guid = Utilities::stringGuidToHex($guid);
+ }
+
+ return $this->select($columns)->whereRaw([
+ $this->schema->objectGuid() => $guid,
+ ])->firstOrFail();
+ }
+
+ /**
+ * Finds a record by its Object SID.
+ *
+ * @param string $sid
+ * @param array|string $columns
+ *
+ * @return Model|array|false
+ */
+ public function findBySid($sid, $columns = [])
+ {
+ try {
+ return $this->findBySidOrFail($sid, $columns);
+ } catch (ModelNotFoundException $e) {
+ return;
+ }
+ }
+
+ /**
+ * Finds a record by its Object SID.
+ *
+ * Fails upon no records returned.
+ *
+ * @param string $sid
+ * @param array|string $columns
+ *
+ * @throws ModelNotFoundException
+ *
+ * @return Model|array
+ */
+ public function findBySidOrFail($sid, $columns = [])
+ {
+ return $this->findByOrFail($this->schema->objectSid(), $sid, $columns);
+ }
+
+ /**
+ * Finds the Base DN of your domain controller.
+ *
+ * @return string|bool
+ */
+ public function findBaseDn()
+ {
+ $result = $this->setDn(null)
+ ->read()
+ ->raw()
+ ->whereHas($this->schema->objectClass())
+ ->first();
+
+ $key = $this->schema->defaultNamingContext();
+
+ if (is_array($result) && array_key_exists($key, $result)) {
+ if (array_key_exists(0, $result[$key])) {
+ return $result[$key][0];
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Adds the inserted fields to query on the current LDAP connection.
+ *
+ * @param array|string $columns
+ *
+ * @return Builder
+ */
+ public function select($columns = [])
+ {
+ $columns = is_array($columns) ? $columns : func_get_args();
+
+ if (!empty($columns)) {
+ $this->columns = $columns;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Adds a raw filter to the current query.
+ *
+ * @param array|string $filters
+ *
+ * @return Builder
+ */
+ public function rawFilter($filters = [])
+ {
+ $filters = is_array($filters) ? $filters : func_get_args();
+
+ foreach ($filters as $filter) {
+ $this->filters['raw'][] = $filter;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Adds a nested 'and' filter to the current query.
+ *
+ * @param Closure $closure
+ *
+ * @return Builder
+ */
+ public function andFilter(Closure $closure)
+ {
+ $query = $this->newNestedInstance($closure);
+
+ $filter = $this->grammar->compileAnd($query->getQuery());
+
+ return $this->rawFilter($filter);
+ }
+
+ /**
+ * Adds a nested 'or' filter to the current query.
+ *
+ * @param Closure $closure
+ *
+ * @return Builder
+ */
+ public function orFilter(Closure $closure)
+ {
+ $query = $this->newNestedInstance($closure);
+
+ $filter = $this->grammar->compileOr($query->getQuery());
+
+ return $this->rawFilter($filter);
+ }
+
+ /**
+ * Adds a nested 'not' filter to the current query.
+ *
+ * @param Closure $closure
+ *
+ * @return Builder
+ */
+ public function notFilter(Closure $closure)
+ {
+ $query = $this->newNestedInstance($closure);
+
+ $filter = $this->grammar->compileNot($query->getQuery());
+
+ return $this->rawFilter($filter);
+ }
+
+ /**
+ * Adds a where clause to the current query.
+ *
+ * @param string|array $field
+ * @param string $operator
+ * @param string $value
+ * @param string $boolean
+ * @param bool $raw
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return Builder
+ */
+ public function where($field, $operator = null, $value = null, $boolean = 'and', $raw = false)
+ {
+ if (is_array($field)) {
+ // If the column is an array, we will assume it is an array of
+ // key-value pairs and can add them each as a where clause.
+ return $this->addArrayOfWheres($field, $boolean, $raw);
+ }
+
+ // We'll bypass the 'has' and 'notHas' operator since they
+ // only require two arguments inside the where method.
+ $bypass = [Operator::$has, Operator::$notHas];
+
+ // Here we will make some assumptions about the operator. If only
+ // 2 values are passed to the method, we will assume that
+ // the operator is 'equals' and keep going.
+ if (func_num_args() === 2 && in_array($operator, $bypass) === false) {
+ list($value, $operator) = [$operator, '='];
+ }
+
+ if (!in_array($operator, Operator::all())) {
+ throw new InvalidArgumentException("Invalid where operator: {$operator}");
+ }
+
+ // We'll escape the value if raw isn't requested.
+ $value = $raw ? $value : $this->escape($value);
+
+ $field = $this->escape($field, $ignore = null, 3);
+
+ $this->addFilter($boolean, compact('field', 'operator', 'value'));
+
+ return $this;
+ }
+
+ /**
+ * Adds a raw where clause to the current query.
+ *
+ * Values given to this method are not escaped.
+ *
+ * @param string|array $field
+ * @param string $operator
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereRaw($field, $operator = null, $value = null)
+ {
+ return $this->where($field, $operator, $value, 'and', true);
+ }
+
+ /**
+ * Adds a 'where equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereEquals($field, $value)
+ {
+ return $this->where($field, Operator::$equals, $value);
+ }
+
+ /**
+ * Adds a 'where not equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereNotEquals($field, $value)
+ {
+ return $this->where($field, Operator::$doesNotEqual, $value);
+ }
+
+ /**
+ * Adds a 'where approximately equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereApproximatelyEquals($field, $value)
+ {
+ return $this->where($field, Operator::$approximatelyEquals, $value);
+ }
+
+ /**
+ * Adds a 'where has' clause to the current query.
+ *
+ * @param string $field
+ *
+ * @return Builder
+ */
+ public function whereHas($field)
+ {
+ return $this->where($field, Operator::$has);
+ }
+
+ /**
+ * Adds a 'where not has' clause to the current query.
+ *
+ * @param string $field
+ *
+ * @return Builder
+ */
+ public function whereNotHas($field)
+ {
+ return $this->where($field, Operator::$notHas);
+ }
+
+ /**
+ * Adds a 'where contains' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereContains($field, $value)
+ {
+ return $this->where($field, Operator::$contains, $value);
+ }
+
+ /**
+ * Adds a 'where contains' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereNotContains($field, $value)
+ {
+ return $this->where($field, Operator::$notContains, $value);
+ }
+
+ /**
+ * Query for entries that match any of the values provided for the given field.
+ *
+ * @param string $field
+ * @param array $values
+ *
+ * @return Builder
+ */
+ public function whereIn($field, array $values)
+ {
+ return $this->orFilter(function (self $query) use ($field, $values) {
+ foreach ($values as $value) {
+ $query->whereEquals($field, $value);
+ }
+ });
+ }
+
+ /**
+ * Adds a 'between' clause to the current query.
+ *
+ * @param string $field
+ * @param array $values
+ *
+ * @return Builder
+ */
+ public function whereBetween($field, array $values)
+ {
+ return $this->where([
+ [$field, '>=', $values[0]],
+ [$field, '<=', $values[1]],
+ ]);
+ }
+
+ /**
+ * Adds a 'where starts with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereStartsWith($field, $value)
+ {
+ return $this->where($field, Operator::$startsWith, $value);
+ }
+
+ /**
+ * Adds a 'where *not* starts with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereNotStartsWith($field, $value)
+ {
+ return $this->where($field, Operator::$notStartsWith, $value);
+ }
+
+ /**
+ * Adds a 'where ends with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereEndsWith($field, $value)
+ {
+ return $this->where($field, Operator::$endsWith, $value);
+ }
+
+ /**
+ * Adds a 'where *not* ends with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function whereNotEndsWith($field, $value)
+ {
+ return $this->where($field, Operator::$notEndsWith, $value);
+ }
+
+ /**
+ * Adds a enabled filter to the current query.
+ *
+ * @return Builder
+ */
+ public function whereEnabled()
+ {
+ return $this->rawFilter($this->schema->filterEnabled());
+ }
+
+ /**
+ * Adds a disabled filter to the current query.
+ *
+ * @return Builder
+ */
+ public function whereDisabled()
+ {
+ return $this->rawFilter($this->schema->filterDisabled());
+ }
+
+ /**
+ * Adds a 'member of' filter to the current query.
+ *
+ * @param string $dn
+ *
+ * @return Builder
+ */
+ public function whereMemberOf($dn)
+ {
+ return $this->whereEquals($this->schema->memberOfRecursive(), $dn);
+ }
+
+ /**
+ * Adds an 'or where' clause to the current query.
+ *
+ * @param array|string $field
+ * @param string|null $operator
+ * @param string|null $value
+ *
+ * @return Builder
+ */
+ public function orWhere($field, $operator = null, $value = null)
+ {
+ return $this->where($field, $operator, $value, 'or');
+ }
+
+ /**
+ * Adds a raw or where clause to the current query.
+ *
+ * Values given to this method are not escaped.
+ *
+ * @param string $field
+ * @param string $operator
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereRaw($field, $operator = null, $value = null)
+ {
+ return $this->where($field, $operator, $value, 'or', true);
+ }
+
+ /**
+ * Adds an 'or where has' clause to the current query.
+ *
+ * @param string $field
+ *
+ * @return Builder
+ */
+ public function orWhereHas($field)
+ {
+ return $this->orWhere($field, Operator::$has);
+ }
+
+ /**
+ * Adds a 'where not has' clause to the current query.
+ *
+ * @param string $field
+ *
+ * @return Builder
+ */
+ public function orWhereNotHas($field)
+ {
+ return $this->orWhere($field, Operator::$notHas);
+ }
+
+ /**
+ * Adds an 'or where equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereEquals($field, $value)
+ {
+ return $this->orWhere($field, Operator::$equals, $value);
+ }
+
+ /**
+ * Adds an 'or where not equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereNotEquals($field, $value)
+ {
+ return $this->orWhere($field, Operator::$doesNotEqual, $value);
+ }
+
+ /**
+ * Adds a 'or where approximately equals' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereApproximatelyEquals($field, $value)
+ {
+ return $this->orWhere($field, Operator::$approximatelyEquals, $value);
+ }
+
+ /**
+ * Adds an 'or where contains' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereContains($field, $value)
+ {
+ return $this->orWhere($field, Operator::$contains, $value);
+ }
+
+ /**
+ * Adds an 'or where *not* contains' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereNotContains($field, $value)
+ {
+ return $this->orWhere($field, Operator::$notContains, $value);
+ }
+
+ /**
+ * Adds an 'or where starts with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereStartsWith($field, $value)
+ {
+ return $this->orWhere($field, Operator::$startsWith, $value);
+ }
+
+ /**
+ * Adds an 'or where *not* starts with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereNotStartsWith($field, $value)
+ {
+ return $this->orWhere($field, Operator::$notStartsWith, $value);
+ }
+
+ /**
+ * Adds an 'or where ends with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereEndsWith($field, $value)
+ {
+ return $this->orWhere($field, Operator::$endsWith, $value);
+ }
+
+ /**
+ * Adds an 'or where *not* ends with' clause to the current query.
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return Builder
+ */
+ public function orWhereNotEndsWith($field, $value)
+ {
+ return $this->orWhere($field, Operator::$notEndsWith, $value);
+ }
+
+ /**
+ * Adds an 'or where member of' filter to the current query.
+ *
+ * @param string $dn
+ *
+ * @return Builder
+ */
+ public function orWhereMemberOf($dn)
+ {
+ return $this->orWhereEquals($this->schema->memberOfRecursive(), $dn);
+ }
+
+ /**
+ * Adds a filter onto the current query.
+ *
+ * @param string $type The type of filter to add.
+ * @param array $bindings The bindings of the filter.
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return $this
+ */
+ public function addFilter($type, array $bindings)
+ {
+ // Here we will ensure we have been given a proper filter type.
+ if (!array_key_exists($type, $this->filters)) {
+ throw new InvalidArgumentException("Invalid filter type: {$type}.");
+ }
+
+ // The required filter key bindings.
+ $required = ['field', 'operator', 'value'];
+
+ // Here we will ensure the proper key bindings are given.
+ if (count(array_intersect_key(array_flip($required), $bindings)) !== count($required)) {
+ // Retrieve the keys that are missing in the bindings array.
+ $missing = implode(', ', array_diff($required, array_flip($bindings)));
+
+ throw new InvalidArgumentException("Invalid filter bindings. Missing: {$missing} keys.");
+ }
+
+ $this->filters[$type][] = $bindings;
+
+ return $this;
+ }
+
+ /**
+ * Clear the query builders filters.
+ *
+ * @return $this
+ */
+ public function clearFilters()
+ {
+ foreach ($this->filters as $type => $filters) {
+ $this->filters[$type] = [];
+ }
+
+ return $this;
+ }
+
+ /**
+ * Returns true / false depending if the current object
+ * contains selects.
+ *
+ * @return bool
+ */
+ public function hasSelects()
+ {
+ return count($this->getSelects()) > 0;
+ }
+
+ /**
+ * Returns the current selected fields to retrieve.
+ *
+ * @return array
+ */
+ public function getSelects()
+ {
+ $selects = $this->columns;
+
+ // If the asterisk is not provided in the selected columns, we need to
+ // ensure we always select the object class and category, as these
+ // are used for constructing models. The asterisk indicates that
+ // we want all attributes returned for LDAP records.
+ if (!in_array('*', $selects)) {
+ $selects[] = $this->schema->objectCategory();
+ $selects[] = $this->schema->objectClass();
+ }
+
+ return $selects;
+ }
+
+ /**
+ * Sorts the LDAP search results by the specified field and direction.
+ *
+ * @param string $field
+ * @param string $direction
+ * @param int|null $flags
+ *
+ * @return Builder
+ */
+ public function sortBy($field, $direction = 'asc', $flags = null)
+ {
+ $this->sortByField = $field;
+
+ // Normalize direction.
+ $direction = strtolower($direction);
+
+ if ($direction === 'asc' || $direction === 'desc') {
+ $this->sortByDirection = $direction;
+ }
+
+ if (is_null($flags)) {
+ $this->sortByFlags = SORT_NATURAL + SORT_FLAG_CASE;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set the query to search on the base distinguished name.
+ *
+ * This will result in one record being returned.
+ *
+ * @return Builder
+ */
+ public function read()
+ {
+ $this->type = 'read';
+
+ return $this;
+ }
+
+ /**
+ * Set the query to search one level on the base distinguished name.
+ *
+ * @return Builder
+ */
+ public function listing()
+ {
+ $this->type = 'listing';
+
+ return $this;
+ }
+
+ /**
+ * Sets the query to search the entire directory on the base distinguished name.
+ *
+ * @return Builder
+ */
+ public function recursive()
+ {
+ $this->type = 'search';
+
+ return $this;
+ }
+
+ /**
+ * Whether to return the LDAP results in their raw format.
+ *
+ * @param bool $raw
+ *
+ * @return Builder
+ */
+ public function raw($raw = true)
+ {
+ $this->raw = (bool) $raw;
+
+ return $this;
+ }
+
+ /**
+ * Whether the current query is nested.
+ *
+ * @param bool $nested
+ *
+ * @return Builder
+ */
+ public function nested($nested = true)
+ {
+ $this->nested = (bool) $nested;
+
+ return $this;
+ }
+
+ /**
+ * Enables caching on the current query until the given date.
+ *
+ * If flushing is enabled, the query cache will be flushed and then re-cached.
+ *
+ * @param \DateTimeInterface $until When to expire the query cache.
+ * @param bool $flush Whether to force-flush the query cache.
+ *
+ * @return $this
+ */
+ public function cache(\DateTimeInterface $until = null, $flush = false)
+ {
+ $this->caching = true;
+ $this->cacheUntil = $until;
+ $this->flushCache = $flush;
+
+ return $this;
+ }
+
+ /**
+ * Returns an escaped string for use in an LDAP filter.
+ *
+ * @param string $value
+ * @param string $ignore
+ * @param int $flags
+ *
+ * @return string
+ */
+ public function escape($value, $ignore = '', $flags = 0)
+ {
+ return ldap_escape($value, $ignore, $flags);
+ }
+
+ /**
+ * Returns the query builders sort by field.
+ *
+ * @return string
+ */
+ public function getSortByField()
+ {
+ return $this->sortByField;
+ }
+
+ /**
+ * Returns the query builders sort by direction.
+ *
+ * @return string
+ */
+ public function getSortByDirection()
+ {
+ return $this->sortByDirection;
+ }
+
+ /**
+ * Returns the query builders sort by flags.
+ *
+ * @return int
+ */
+ public function getSortByFlags()
+ {
+ return $this->sortByFlags;
+ }
+
+ /**
+ * Returns true / false if the current query is nested.
+ *
+ * @return bool
+ */
+ public function isNested()
+ {
+ return $this->nested === true;
+ }
+
+ /**
+ * Returns bool that determines whether the current
+ * query builder will return raw results.
+ *
+ * @return bool
+ */
+ public function isRaw()
+ {
+ return $this->raw;
+ }
+
+ /**
+ * Returns bool that determines whether the current
+ * query builder will return paginated results.
+ *
+ * @return bool
+ */
+ public function isPaginated()
+ {
+ return $this->paginated;
+ }
+
+ /**
+ * Returns bool that determines whether the current
+ * query builder will return sorted results.
+ *
+ * @return bool
+ */
+ public function isSorted()
+ {
+ return $this->sortByField ? true : false;
+ }
+
+ /**
+ * Handle dynamic method calls on the query builder object to be directed to the query processor.
+ *
+ * @param string $method
+ * @param array $parameters
+ *
+ * @return mixed
+ */
+ public function __call($method, $parameters)
+ {
+ // We'll check if the beginning of the method being called contains
+ // 'where'. If so, we'll assume it's a dynamic 'where' clause.
+ if (substr($method, 0, 5) === 'where') {
+ return $this->dynamicWhere($method, $parameters);
+ }
+
+ return call_user_func_array([$this->newProcessor(), $method], $parameters);
+ }
+
+ /**
+ * Handles dynamic "where" clauses to the query.
+ *
+ * @param string $method
+ * @param array $parameters
+ *
+ * @return Builder
+ */
+ public function dynamicWhere($method, $parameters)
+ {
+ $finder = substr($method, 5);
+
+ $segments = preg_split('/(And|Or)(?=[A-Z])/', $finder, -1, PREG_SPLIT_DELIM_CAPTURE);
+
+ // The connector variable will determine which connector will be used for the
+ // query condition. We will change it as we come across new boolean values
+ // in the dynamic method strings, which could contain a number of these.
+ $connector = 'and';
+
+ $index = 0;
+
+ foreach ($segments as $segment) {
+ // If the segment is not a boolean connector, we can assume it is a column's name
+ // and we will add it to the query as a new constraint as a where clause, then
+ // we can keep iterating through the dynamic method string's segments again.
+ if ($segment != 'And' && $segment != 'Or') {
+ $this->addDynamic($segment, $connector, $parameters, $index);
+
+ $index++;
+ }
+
+ // Otherwise, we will store the connector so we know how the next where clause we
+ // find in the query should be connected to the previous ones, meaning we will
+ // have the proper boolean connector to connect the next where clause found.
+ else {
+ $connector = $segment;
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Adds an array of wheres to the current query.
+ *
+ * @param array $wheres
+ * @param string $boolean
+ * @param bool $raw
+ *
+ * @return Builder
+ */
+ protected function addArrayOfWheres($wheres, $boolean, $raw)
+ {
+ foreach ($wheres as $key => $value) {
+ if (is_numeric($key) && is_array($value)) {
+ // If the key is numeric and the value is an array, we'll
+ // assume we've been given an array with conditionals.
+ list($field, $condition) = $value;
+
+ // Since a value is optional for some conditionals, we will
+ // try and retrieve the third parameter from the array,
+ // but is entirely optional.
+ $value = Arr::get($value, 2);
+
+ $this->where($field, $condition, $value, $boolean);
+ } else {
+ // If the value is not an array, we will assume an equals clause.
+ $this->where($key, Operator::$equals, $value, $boolean, $raw);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Add a single dynamic where clause statement to the query.
+ *
+ * @param string $segment
+ * @param string $connector
+ * @param array $parameters
+ * @param int $index
+ *
+ * @return void
+ */
+ protected function addDynamic($segment, $connector, $parameters, $index)
+ {
+ // We'll format the 'where' boolean and field here to avoid casing issues.
+ $bool = strtolower($connector);
+ $field = strtolower($segment);
+
+ $this->where($field, '=', $parameters[$index], $bool);
+ }
+
+ /**
+ * Logs the given executed query information by firing its query event.
+ *
+ * @param Builder $query
+ * @param string $type
+ * @param null|float $time
+ */
+ protected function logQuery($query, $type, $time = null)
+ {
+ $args = [$query, $time];
+
+ switch ($type) {
+ case 'listing':
+ $event = new Events\Listing(...$args);
+ break;
+ case 'read':
+ $event = new Events\Read(...$args);
+ break;
+ case 'paginate':
+ $event = new Events\Paginate(...$args);
+ break;
+ default:
+ $event = new Events\Search(...$args);
+ break;
+ }
+
+ $this->fireQueryEvent($event);
+ }
+
+ /**
+ * Fires the given query event.
+ *
+ * @param QueryExecuted $event
+ */
+ protected function fireQueryEvent(QueryExecuted $event)
+ {
+ Adldap::getEventDispatcher()->fire($event);
+ }
+
+ /**
+ * Get the elapsed time since a given starting point.
+ *
+ * @param int $start
+ *
+ * @return float
+ */
+ protected function getElapsedTime($start)
+ {
+ return round((microtime(true) - $start) * 1000, 2);
+ }
+
+ /**
+ * Returns a new query Processor instance.
+ *
+ * @return Processor
+ */
+ protected function newProcessor()
+ {
+ return new Processor($this);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Cache.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Cache.php
new file mode 100644
index 0000000..9b0206a
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Cache.php
@@ -0,0 +1,95 @@
+<?php
+
+namespace Adldap\Query;
+
+use Closure;
+use Psr\SimpleCache\CacheInterface;
+
+class Cache
+{
+ /**
+ * The cache driver.
+ *
+ * @var CacheInterface
+ */
+ protected $store;
+
+ /**
+ * Constructor.
+ *
+ * @param CacheInterface $store
+ */
+ public function __construct(CacheInterface $store)
+ {
+ $this->store = $store;
+ }
+
+ /**
+ * Get an item from the cache.
+ *
+ * @param string $key
+ *
+ * @throws \Psr\SimpleCache\InvalidArgumentException
+ *
+ * @return mixed
+ */
+ public function get($key)
+ {
+ return $this->store->get($key);
+ }
+
+ /**
+ * Store an item in the cache.
+ *
+ * @param string $key
+ * @param mixed $value
+ * @param \DateTimeInterface|\DateInterval|int|null $ttl
+ *
+ * @throws \Psr\SimpleCache\InvalidArgumentException
+ *
+ * @return bool
+ */
+ public function put($key, $value, $ttl = null)
+ {
+ return $this->store->set($key, $value, $ttl);
+ }
+
+ /**
+ * Get an item from the cache, or execute the given Closure and store the result.
+ *
+ * @param string $key
+ * @param \DateTimeInterface|\DateInterval|int|null $ttl
+ * @param Closure $callback
+ *
+ * @throws \Psr\SimpleCache\InvalidArgumentException
+ *
+ * @return mixed
+ */
+ public function remember($key, $ttl, Closure $callback)
+ {
+ $value = $this->get($key);
+
+ if (!is_null($value)) {
+ return $value;
+ }
+
+ $this->put($key, $value = $callback(), $ttl);
+
+ return $value;
+ }
+
+ /**
+ * Delete an item from the cache.
+ *
+ * @param string $key
+ *
+ * @throws \Psr\Cache\InvalidArgumentException
+ * @throws \Psr\SimpleCache\InvalidArgumentException
+ *
+ * @return bool
+ */
+ public function delete($key)
+ {
+ return $this->store->delete($key);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Collection.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Collection.php
new file mode 100644
index 0000000..b9b6616
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Collection.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace Adldap\Query;
+
+use Adldap\Models\Model;
+use Illuminate\Support\Collection as BaseCollection;
+
+class Collection extends BaseCollection
+{
+ /**
+ * {@inheritdoc}
+ */
+ protected function valueRetriever($value)
+ {
+ if ($this->useAsCallable($value)) {
+ return $value;
+ }
+
+ return function ($item) use ($value) {
+ if ($item instanceof Model) {
+ return $item->getFirstAttribute($value);
+ }
+
+ return data_get($item, $value);
+ };
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Listing.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Listing.php
new file mode 100644
index 0000000..0ca05b7
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Listing.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Query\Events;
+
+class Listing extends QueryExecuted
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Paginate.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Paginate.php
new file mode 100644
index 0000000..2a7666d
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Paginate.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Query\Events;
+
+class Paginate extends QueryExecuted
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/QueryExecuted.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/QueryExecuted.php
new file mode 100644
index 0000000..3779276
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/QueryExecuted.php
@@ -0,0 +1,54 @@
+<?php
+
+namespace Adldap\Query\Events;
+
+use Adldap\Query\Builder;
+
+class QueryExecuted
+{
+ /**
+ * The LDAP filter that was used for the query.
+ *
+ * @var string
+ */
+ protected $query;
+
+ /**
+ * The number of milliseconds it took to execute the query.
+ *
+ * @var float
+ */
+ protected $time;
+
+ /**
+ * Constructor.
+ *
+ * @param Builder $query
+ * @param null|float $time
+ */
+ public function __construct(Builder $query, $time = null)
+ {
+ $this->query = $query;
+ $this->time = $time;
+ }
+
+ /**
+ * Returns the LDAP filter that was used for the query.
+ *
+ * @return Builder
+ */
+ public function getQuery()
+ {
+ return $this->query;
+ }
+
+ /**
+ * Returns the number of milliseconds it took to execute the query.
+ *
+ * @return float|null
+ */
+ public function getTime()
+ {
+ return $this->time;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Read.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Read.php
new file mode 100644
index 0000000..4e0e65d
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Read.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Query\Events;
+
+class Read extends QueryExecuted
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Search.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Search.php
new file mode 100644
index 0000000..35fe913
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Events/Search.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Adldap\Query\Events;
+
+class Search extends QueryExecuted
+{
+ //
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Factory.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Factory.php
new file mode 100644
index 0000000..199107e
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Factory.php
@@ -0,0 +1,297 @@
+<?php
+
+namespace Adldap\Query;
+
+use Adldap\Models\RootDse;
+use Adldap\Schemas\ActiveDirectory;
+use Adldap\Schemas\SchemaInterface;
+use Adldap\Connections\ConnectionInterface;
+
+/**
+ * Adldap2 Search Factory.
+ *
+ * Constructs new LDAP queries.
+ *
+ *
+ * @mixin Builder
+ */
+class Factory
+{
+ /**
+ * @var ConnectionInterface
+ */
+ protected $connection;
+
+ /**
+ * Stores the current schema instance.
+ *
+ * @var SchemaInterface
+ */
+ protected $schema;
+
+ /**
+ * The base DN to use for the search.
+ *
+ * @var string|null
+ */
+ protected $base;
+
+ /**
+ * The query cache.
+ *
+ * @var Cache
+ */
+ protected $cache;
+
+ /**
+ * Constructor.
+ *
+ * @param ConnectionInterface $connection The connection to use when constructing a new query.
+ * @param SchemaInterface|null $schema The schema to use for the query and models located.
+ * @param string $baseDn The base DN to use for all searches.
+ */
+ public function __construct(ConnectionInterface $connection, SchemaInterface $schema = null, $baseDn = '')
+ {
+ $this->setConnection($connection)
+ ->setSchema($schema)
+ ->setBaseDn($baseDn);
+ }
+
+ /**
+ * Sets the connection property.
+ *
+ * @param ConnectionInterface $connection
+ *
+ * @return $this
+ */
+ public function setConnection(ConnectionInterface $connection)
+ {
+ $this->connection = $connection;
+
+ return $this;
+ }
+
+ /**
+ * Sets the schema property.
+ *
+ * @param SchemaInterface|null $schema
+ *
+ * @return $this
+ */
+ public function setSchema(SchemaInterface $schema = null)
+ {
+ $this->schema = $schema ?: new ActiveDirectory();
+
+ return $this;
+ }
+
+ /**
+ * Sets the base distinguished name to perform searches upon.
+ *
+ * @param string $base
+ *
+ * @return $this
+ */
+ public function setBaseDn($base = '')
+ {
+ $this->base = $base;
+
+ return $this;
+ }
+
+ /**
+ * Sets the cache for storing query results.
+ *
+ * @param Cache $cache
+ *
+ * @return $this
+ */
+ public function setCache(Cache $cache)
+ {
+ $this->cache = $cache;
+
+ return $this;
+ }
+
+ /**
+ * Returns a new query builder instance.
+ *
+ * @return Builder
+ */
+ public function newQuery()
+ {
+ return $this->newBuilder()->in($this->base);
+ }
+
+ /**
+ * Performs a global 'all' search query on the current
+ * connection by performing a search for all entries
+ * that contain a common name attribute.
+ *
+ * @return \Adldap\Query\Collection|array
+ */
+ public function get()
+ {
+ return $this->newQuery()->whereHas($this->schema->commonName())->get();
+ }
+
+ /**
+ * Returns a query builder scoped to users.
+ *
+ * @return Builder
+ */
+ public function users()
+ {
+ $wheres = [
+ [$this->schema->objectClass(), Operator::$equals, $this->schema->objectClassUser()],
+ [$this->schema->objectCategory(), Operator::$equals, $this->schema->objectCategoryPerson()],
+ ];
+
+ // OpenLDAP doesn't like specifying the omission of user objectclasses
+ // equal to `contact`. We'll make sure we're working with
+ // ActiveDirectory before adding this filter.
+ if (is_a($this->schema, ActiveDirectory::class)) {
+ $wheres[] = [$this->schema->objectClass(), Operator::$doesNotEqual, $this->schema->objectClassContact()];
+ }
+
+ return $this->where($wheres);
+ }
+
+ /**
+ * Returns a query builder scoped to printers.
+ *
+ * @return Builder
+ */
+ public function printers()
+ {
+ return $this->where([
+ $this->schema->objectClass() => $this->schema->objectClassPrinter(),
+ ]);
+ }
+
+ /**
+ * Returns a query builder scoped to organizational units.
+ *
+ * @return Builder
+ */
+ public function ous()
+ {
+ return $this->where([
+ $this->schema->objectClass() => $this->schema->objectClassOu(),
+ ]);
+ }
+
+ /**
+ * Returns a query builder scoped to organizations.
+ *
+ * @return Builder
+ */
+ public function organizations()
+ {
+ return $this->where([
+ $this->schema->objectClass() => $this->schema->objectClassOrganization(),
+ ]);
+ }
+
+ /**
+ * Returns a query builder scoped to groups.
+ *
+ * @return Builder
+ */
+ public function groups()
+ {
+ return $this->where([
+ $this->schema->objectClass() => $this->schema->objectClassGroup(),
+ ]);
+ }
+
+ /**
+ * Returns a query builder scoped to containers.
+ *
+ * @return Builder
+ */
+ public function containers()
+ {
+ return $this->where([
+ $this->schema->objectClass() => $this->schema->objectClassContainer(),
+ ]);
+ }
+
+ /**
+ * Returns a query builder scoped to contacts.
+ *
+ * @return Builder
+ */
+ public function contacts()
+ {
+ return $this->where([
+ $this->schema->objectClass() => $this->schema->objectClassContact(),
+ ]);
+ }
+
+ /**
+ * Returns a query builder scoped to computers.
+ *
+ * @return Builder
+ */
+ public function computers()
+ {
+ return $this->where([
+ $this->schema->objectClass() => $this->schema->objectClassComputer(),
+ ]);
+ }
+
+ /**
+ * Returns the root DSE record.
+ *
+ * @return RootDse|null
+ */
+ public function getRootDse()
+ {
+ $query = $this->newQuery();
+
+ $root = $query->in('')->read()->whereHas($this->schema->objectClass())->first();
+
+ if ($root) {
+ return (new RootDse([], $query))
+ ->setRawAttributes($root->getAttributes());
+ }
+ }
+
+ /**
+ * Handle dynamic method calls on the query builder object.
+ *
+ * @param string $method
+ * @param array $parameters
+ *
+ * @return mixed
+ */
+ public function __call($method, $parameters)
+ {
+ return call_user_func_array([$this->newQuery(), $method], $parameters);
+ }
+
+ /**
+ * Returns a new query grammar instance.
+ *
+ * @return Grammar
+ */
+ protected function newGrammar()
+ {
+ return new Grammar();
+ }
+
+ /**
+ * Returns a new query builder instance.
+ *
+ * @return Builder
+ */
+ protected function newBuilder()
+ {
+ $builder = new Builder($this->connection, $this->newGrammar(), $this->schema);
+
+ $builder->setCache($this->cache);
+
+ return $builder;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Grammar.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Grammar.php
new file mode 100644
index 0000000..dcda3d7
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Grammar.php
@@ -0,0 +1,390 @@
+<?php
+
+namespace Adldap\Query;
+
+class Grammar
+{
+ /**
+ * Wraps a query string in brackets.
+ *
+ * Produces: (query)
+ *
+ * @param string $query
+ * @param string $prefix
+ * @param string $suffix
+ *
+ * @return string
+ */
+ public function wrap($query, $prefix = '(', $suffix = ')')
+ {
+ return $prefix.$query.$suffix;
+ }
+
+ /**
+ * Compiles the Builder instance into an LDAP query string.
+ *
+ * @param Builder $builder
+ *
+ * @return string
+ */
+ public function compile(Builder $builder)
+ {
+ $ands = $builder->filters['and'];
+ $ors = $builder->filters['or'];
+ $raws = $builder->filters['raw'];
+
+ $query = $this->concatenate($raws);
+
+ $query = $this->compileWheres($ands, $query);
+
+ $query = $this->compileOrWheres($ors, $query);
+
+ // We need to check if the query is already nested, otherwise
+ // we'll nest it here and return the result.
+ if (!$builder->isNested()) {
+ $total = count($ands) + count($raws);
+
+ // Make sure we wrap the query in an 'and' if using
+ // multiple filters. We also need to check if only
+ // one where is used with multiple orWheres, that
+ // we wrap it in an `and` query.
+ if ($total > 1 || (count($ands) === 1 && count($ors) > 0)) {
+ $query = $this->compileAnd($query);
+ }
+ }
+
+ return $query;
+ }
+
+ /**
+ * Concatenates filters into a single string.
+ *
+ * @param array $bindings
+ *
+ * @return string
+ */
+ public function concatenate(array $bindings = [])
+ {
+ // Filter out empty query segments.
+ $bindings = array_filter($bindings, function ($value) {
+ return (string) $value !== '';
+ });
+
+ return implode('', $bindings);
+ }
+
+ /**
+ * Returns a query string for equals.
+ *
+ * Produces: (field=value)
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileEquals($field, $value)
+ {
+ return $this->wrap($field.Operator::$equals.$value);
+ }
+
+ /**
+ * Returns a query string for does not equal.
+ *
+ * Produces: (!(field=value))
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileDoesNotEqual($field, $value)
+ {
+ return $this->compileNot($this->compileEquals($field, $value));
+ }
+
+ /**
+ * Alias for does not equal operator (!=) operator.
+ *
+ * Produces: (!(field=value))
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileDoesNotEqualAlias($field, $value)
+ {
+ return $this->compileDoesNotEqual($field, $value);
+ }
+
+ /**
+ * Returns a query string for greater than or equals.
+ *
+ * Produces: (field>=value)
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileGreaterThanOrEquals($field, $value)
+ {
+ return $this->wrap($field.Operator::$greaterThanOrEquals.$value);
+ }
+
+ /**
+ * Returns a query string for less than or equals.
+ *
+ * Produces: (field<=value)
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileLessThanOrEquals($field, $value)
+ {
+ return $this->wrap($field.Operator::$lessThanOrEquals.$value);
+ }
+
+ /**
+ * Returns a query string for approximately equals.
+ *
+ * Produces: (field~=value)
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileApproximatelyEquals($field, $value)
+ {
+ return $this->wrap($field.Operator::$approximatelyEquals.$value);
+ }
+
+ /**
+ * Returns a query string for starts with.
+ *
+ * Produces: (field=value*)
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileStartsWith($field, $value)
+ {
+ return $this->wrap($field.Operator::$equals.$value.Operator::$has);
+ }
+
+ /**
+ * Returns a query string for does not start with.
+ *
+ * Produces: (!(field=*value))
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileNotStartsWith($field, $value)
+ {
+ return $this->compileNot($this->compileStartsWith($field, $value));
+ }
+
+ /**
+ * Returns a query string for ends with.
+ *
+ * Produces: (field=*value)
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileEndsWith($field, $value)
+ {
+ return $this->wrap($field.Operator::$equals.Operator::$has.$value);
+ }
+
+ /**
+ * Returns a query string for does not end with.
+ *
+ * Produces: (!(field=value*))
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileNotEndsWith($field, $value)
+ {
+ return $this->compileNot($this->compileEndsWith($field, $value));
+ }
+
+ /**
+ * Returns a query string for contains.
+ *
+ * Produces: (field=*value*)
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileContains($field, $value)
+ {
+ return $this->wrap($field.Operator::$equals.Operator::$has.$value.Operator::$has);
+ }
+
+ /**
+ * Returns a query string for does not contain.
+ *
+ * Produces: (!(field=*value*))
+ *
+ * @param string $field
+ * @param string $value
+ *
+ * @return string
+ */
+ public function compileNotContains($field, $value)
+ {
+ return $this->compileNot($this->compileContains($field, $value));
+ }
+
+ /**
+ * Returns a query string for a where has.
+ *
+ * Produces: (field=*)
+ *
+ * @param string $field
+ *
+ * @return string
+ */
+ public function compileHas($field)
+ {
+ return $this->wrap($field.Operator::$equals.Operator::$has);
+ }
+
+ /**
+ * Returns a query string for a where does not have.
+ *
+ * Produces: (!(field=*))
+ *
+ * @param string $field
+ *
+ * @return string
+ */
+ public function compileNotHas($field)
+ {
+ return $this->compileNot($this->compileHas($field));
+ }
+
+ /**
+ * Wraps the inserted query inside an AND operator.
+ *
+ * Produces: (&query)
+ *
+ * @param string $query
+ *
+ * @return string
+ */
+ public function compileAnd($query)
+ {
+ return $query ? $this->wrap($query, '(&') : '';
+ }
+
+ /**
+ * Wraps the inserted query inside an OR operator.
+ *
+ * Produces: (|query)
+ *
+ * @param string $query
+ *
+ * @return string
+ */
+ public function compileOr($query)
+ {
+ return $query ? $this->wrap($query, '(|') : '';
+ }
+
+ /**
+ * Wraps the inserted query inside an NOT operator.
+ *
+ * @param string $query
+ *
+ * @return string
+ */
+ public function compileNot($query)
+ {
+ return $query ? $this->wrap($query, '(!') : '';
+ }
+
+ /**
+ * Assembles all where clauses in the current wheres property.
+ *
+ * @param array $wheres
+ * @param string $query
+ *
+ * @return string
+ */
+ protected function compileWheres(array $wheres = [], $query = '')
+ {
+ foreach ($wheres as $where) {
+ $query .= $this->compileWhere($where);
+ }
+
+ return $query;
+ }
+
+ /**
+ * Assembles all or where clauses in the current orWheres property.
+ *
+ * @param array $orWheres
+ * @param string $query
+ *
+ * @return string
+ */
+ protected function compileOrWheres(array $orWheres = [], $query = '')
+ {
+ $or = '';
+
+ foreach ($orWheres as $where) {
+ $or .= $this->compileWhere($where);
+ }
+
+ // Make sure we wrap the query in an 'or' if using multiple
+ // orWheres. For example (|(QUERY)(ORWHEREQUERY)).
+ if (($query && count($orWheres) > 0) || count($orWheres) > 1) {
+ $query .= $this->compileOr($or);
+ } else {
+ $query .= $or;
+ }
+
+ return $query;
+ }
+
+ /**
+ * Assembles a single where query based
+ * on its operator and returns it.
+ *
+ * @param array $where
+ *
+ * @return string|null
+ */
+ protected function compileWhere(array $where)
+ {
+ // Get the name of the operator.
+ if ($name = array_search($where['operator'], Operator::all())) {
+ // If the name was found we'll camel case it
+ // to run it through the compile method.
+ $method = 'compile'.ucfirst($name);
+
+ // Make sure the compile method exists for the operator.
+ if (method_exists($this, $method)) {
+ return $this->{$method}($where['field'], $where['value']);
+ }
+ }
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Operator.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Operator.php
new file mode 100644
index 0000000..75b3289
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Operator.php
@@ -0,0 +1,116 @@
+<?php
+
+namespace Adldap\Query;
+
+use ReflectionClass;
+
+class Operator
+{
+ /**
+ * The 'has' wildcard operator.
+ *
+ * @var string
+ */
+ public static $has = '*';
+
+ /**
+ * The custom `notHas` operator.
+ *
+ * @var string
+ */
+ public static $notHas = '!*';
+
+ /**
+ * The equals operator.
+ *
+ * @var string
+ */
+ public static $equals = '=';
+
+ /**
+ * The does not equal operator.
+ *
+ * @var string
+ */
+ public static $doesNotEqual = '!';
+
+ /**
+ * The does not equal operator (alias).
+ *
+ * @var string
+ */
+ public static $doesNotEqualAlias = '!=';
+
+ /**
+ * The greater than or equal to operator.
+ *
+ * @var string
+ */
+ public static $greaterThanOrEquals = '>=';
+
+ /**
+ * The less than or equal to operator.
+ *
+ * @var string
+ */
+ public static $lessThanOrEquals = '<=';
+
+ /**
+ * The approximately equal to operator.
+ *
+ * @var string
+ */
+ public static $approximatelyEquals = '~=';
+
+ /**
+ * The custom starts with operator.
+ *
+ * @var string
+ */
+ public static $startsWith = 'starts_with';
+
+ /**
+ * The custom not starts with operator.
+ *
+ * @var string
+ */
+ public static $notStartsWith = 'not_starts_with';
+
+ /**
+ * The custom ends with operator.
+ *
+ * @var string
+ */
+ public static $endsWith = 'ends_with';
+
+ /**
+ * The custom not ends with operator.
+ *
+ * @var string
+ */
+ public static $notEndsWith = 'not_ends_with';
+
+ /**
+ * The custom contains operator.
+ *
+ * @var string
+ */
+ public static $contains = 'contains';
+
+ /**
+ * The custom not contains operator.
+ *
+ * @var string
+ */
+ public static $notContains = 'not_contains';
+
+ /**
+ * Returns all available operators.
+ *
+ * @return array
+ */
+ public static function all()
+ {
+ return (new ReflectionClass(new static()))->getStaticProperties();
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Paginator.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Paginator.php
new file mode 100644
index 0000000..0f61fe2
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Paginator.php
@@ -0,0 +1,206 @@
+<?php
+
+namespace Adldap\Query;
+
+use Countable;
+use ArrayIterator;
+use IteratorAggregate;
+
+class Paginator implements Countable, IteratorAggregate
+{
+ /**
+ * The complete results array.
+ *
+ * @var array
+ */
+ protected $results = [];
+
+ /**
+ * The total amount of pages.
+ *
+ * @var int
+ */
+ protected $pages;
+
+ /**
+ * The amount of entries per page.
+ *
+ * @var int
+ */
+ protected $perPage;
+
+ /**
+ * The current page number.
+ *
+ * @var int
+ */
+ protected $currentPage;
+
+ /**
+ * The current entry offset number.
+ *
+ * @var int
+ */
+ protected $currentOffset;
+
+ /**
+ * Constructor.
+ *
+ * @param array $results
+ * @param int $perPage
+ * @param int $currentPage
+ * @param int $pages
+ */
+ public function __construct(array $results = [], $perPage = 50, $currentPage = 0, $pages = 0)
+ {
+ $this->setResults($results)
+ ->setPerPage($perPage)
+ ->setCurrentPage($currentPage)
+ ->setPages($pages)
+ ->setCurrentOffset(($this->getCurrentPage() * $this->getPerPage()));
+ }
+
+ /**
+ * Get an iterator for the entries.
+ *
+ * @return ArrayIterator
+ */
+ public function getIterator()
+ {
+ $entries = array_slice($this->getResults(), $this->getCurrentOffset(), $this->getPerPage(), true);
+
+ return new ArrayIterator($entries);
+ }
+
+ /**
+ * Returns the complete results array.
+ *
+ * @return array
+ */
+ public function getResults()
+ {
+ return $this->results;
+ }
+
+ /**
+ * Returns the total amount of pages
+ * in a paginated result.
+ *
+ * @return int
+ */
+ public function getPages()
+ {
+ return $this->pages;
+ }
+
+ /**
+ * Returns the total amount of entries
+ * allowed per page.
+ *
+ * @return int
+ */
+ public function getPerPage()
+ {
+ return $this->perPage;
+ }
+
+ /**
+ * Returns the current page number.
+ *
+ * @return int
+ */
+ public function getCurrentPage()
+ {
+ return $this->currentPage;
+ }
+
+ /**
+ * Returns the current offset number.
+ *
+ * @return int
+ */
+ public function getCurrentOffset()
+ {
+ return $this->currentOffset;
+ }
+
+ /**
+ * Returns the total amount of results.
+ *
+ * @return int
+ */
+ public function count()
+ {
+ return count($this->results);
+ }
+
+ /**
+ * Sets the results array property.
+ *
+ * @param array $results
+ *
+ * @return Paginator
+ */
+ protected function setResults(array $results)
+ {
+ $this->results = $results;
+
+ return $this;
+ }
+
+ /**
+ * Sets the total number of pages.
+ *
+ * @param int $pages
+ *
+ * @return Paginator
+ */
+ protected function setPages($pages = 0)
+ {
+ $this->pages = (int) $pages;
+
+ return $this;
+ }
+
+ /**
+ * Sets the number of entries per page.
+ *
+ * @param int $perPage
+ *
+ * @return Paginator
+ */
+ protected function setPerPage($perPage = 50)
+ {
+ $this->perPage = (int) $perPage;
+
+ return $this;
+ }
+
+ /**
+ * Sets the current page number.
+ *
+ * @param int $currentPage
+ *
+ * @return Paginator
+ */
+ protected function setCurrentPage($currentPage = 0)
+ {
+ $this->currentPage = (int) $currentPage;
+
+ return $this;
+ }
+
+ /**
+ * Sets the current offset number.
+ *
+ * @param int $offset
+ *
+ * @return Paginator
+ */
+ protected function setCurrentOffset($offset = 0)
+ {
+ $this->currentOffset = (int) $offset;
+
+ return $this;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Processor.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Processor.php
new file mode 100644
index 0000000..e4e5329
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Query/Processor.php
@@ -0,0 +1,211 @@
+<?php
+
+namespace Adldap\Query;
+
+use Adldap\Models\Entry;
+use Adldap\Models\Model;
+use InvalidArgumentException;
+use Adldap\Schemas\SchemaInterface;
+use Adldap\Connections\ConnectionInterface;
+
+class Processor
+{
+ /**
+ * @var Builder
+ */
+ protected $builder;
+
+ /**
+ * @var ConnectionInterface
+ */
+ protected $connection;
+
+ /**
+ * @var SchemaInterface
+ */
+ protected $schema;
+
+ /**
+ * Constructor.
+ *
+ * @param Builder $builder
+ */
+ public function __construct(Builder $builder)
+ {
+ $this->builder = $builder;
+ $this->schema = $builder->getSchema();
+ $this->connection = $builder->getConnection();
+ }
+
+ /**
+ * Processes LDAP search results and constructs their model instances.
+ *
+ * @param array $entries The LDAP entries to process.
+ *
+ * @return Collection|array
+ */
+ public function process($entries)
+ {
+ if ($this->builder->isRaw()) {
+ // If the builder is asking for a raw
+ // LDAP result, we can return here.
+ return $entries;
+ }
+
+ $models = [];
+
+ if (array_key_exists('count', $entries)) {
+ for ($i = 0; $i < $entries['count']; $i++) {
+ // We'll go through each entry and construct a new
+ // model instance with the raw LDAP attributes.
+ $models[] = $this->newLdapEntry($entries[$i]);
+ }
+ }
+
+ // If the query contains paginated results, we'll return them here.
+ if ($this->builder->isPaginated()) {
+ return $models;
+ }
+
+ // If the query is requested to be sorted, we'll perform
+ // that here and return the resulting collection.
+ if ($this->builder->isSorted()) {
+ return $this->processSort($models);
+ }
+
+ // Otherwise, we'll return a regular unsorted collection.
+ return $this->newCollection($models);
+ }
+
+ /**
+ * Processes paginated LDAP results.
+ *
+ * @param array $pages
+ * @param int $perPage
+ * @param int $currentPage
+ *
+ * @return Paginator
+ */
+ public function processPaginated(array $pages = [], $perPage = 50, $currentPage = 0)
+ {
+ $models = [];
+
+ foreach ($pages as $entries) {
+ // Go through each page and process the results into an objects array.
+ $models = array_merge($models, $this->process($entries));
+ }
+
+ $models = $this->processSort($models)->toArray();
+
+ return $this->newPaginator($models, $perPage, $currentPage, count($pages));
+ }
+
+ /**
+ * Returns a new LDAP Entry instance.
+ *
+ * @param array $attributes
+ *
+ * @return Entry
+ */
+ public function newLdapEntry(array $attributes = [])
+ {
+ $objectClass = $this->schema->objectClass();
+
+ // We need to ensure the record contains an object class to be able to
+ // determine its type. Otherwise, we create a default Entry model.
+ if (array_key_exists($objectClass, $attributes) && array_key_exists(0, $attributes[$objectClass])) {
+ // Retrieve all of the object classes from the LDAP
+ // entry and lowercase them for comparisons.
+ $classes = array_map('strtolower', $attributes[$objectClass]);
+
+ // Retrieve the model mapping.
+ $models = $this->schema->objectClassModelMap();
+
+ // Retrieve the object class mappings (with strtolower keys).
+ $mappings = array_map('strtolower', array_keys($models));
+
+ // Retrieve the model from the map using the entry's object class.
+ $map = array_intersect($mappings, $classes);
+
+ if (count($map) > 0) {
+ // Retrieve the model using the object class.
+ $model = $models[current($map)];
+
+ // Construct and return a new model.
+ return $this->newModel([], $model)
+ ->setRawAttributes($attributes);
+ }
+ }
+
+ // A default entry model if the object class isn't found.
+ return $this->newModel()->setRawAttributes($attributes);
+ }
+
+ /**
+ * Creates a new model instance.
+ *
+ * @param array $attributes
+ * @param string|null $model
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return mixed|Entry
+ */
+ public function newModel($attributes = [], $model = null)
+ {
+ $model = (class_exists($model) ? $model : $this->schema->entryModel());
+
+ if (!is_subclass_of($model, $base = Model::class)) {
+ throw new InvalidArgumentException("The given model class '{$model}' must extend the base model class '{$base}'");
+ }
+
+ return new $model($attributes, $this->builder->newInstance());
+ }
+
+ /**
+ * Returns a new Paginator object instance.
+ *
+ * @param array $models
+ * @param int $perPage
+ * @param int $currentPage
+ * @param int $pages
+ *
+ * @return Paginator
+ */
+ public function newPaginator(array $models = [], $perPage = 25, $currentPage = 0, $pages = 1)
+ {
+ return new Paginator($models, $perPage, $currentPage, $pages);
+ }
+
+ /**
+ * Returns a new collection instance.
+ *
+ * @param array $items
+ *
+ * @return Collection
+ */
+ public function newCollection(array $items = [])
+ {
+ return new Collection($items);
+ }
+
+ /**
+ * Sorts LDAP search results.
+ *
+ * @param array $models
+ *
+ * @return Collection
+ */
+ protected function processSort(array $models = [])
+ {
+ $field = $this->builder->getSortByField();
+
+ $flags = $this->builder->getSortByFlags();
+
+ $direction = $this->builder->getSortByDirection();
+
+ $desc = ($direction === 'desc' ? true : false);
+
+ return $this->newCollection($models)->sortBy($field, $flags, $desc);
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/ActiveDirectory.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/ActiveDirectory.php
new file mode 100644
index 0000000..09f0314
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/ActiveDirectory.php
@@ -0,0 +1,94 @@
+<?php
+
+namespace Adldap\Schemas;
+
+class ActiveDirectory extends Schema
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedName()
+ {
+ return 'distinguishedname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedNameSubKey()
+ {
+ return 0;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterEnabled()
+ {
+ return '(!(UserAccountControl:1.2.840.113556.1.4.803:=2))';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterDisabled()
+ {
+ return '(UserAccountControl:1.2.840.113556.1.4.803:=2)';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lockoutTime()
+ {
+ return 'lockouttime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassGroup()
+ {
+ return 'group';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassOu()
+ {
+ return 'organizationalunit';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassPerson()
+ {
+ return 'person';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuid()
+ {
+ return 'objectguid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuidRequiresConversion()
+ {
+ return true;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategory()
+ {
+ return 'objectcategory';
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/Directory389.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/Directory389.php
new file mode 100644
index 0000000..f51a8a4
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/Directory389.php
@@ -0,0 +1,110 @@
+<?php
+
+namespace Adldap\Schemas;
+
+class Directory389 extends Schema
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function accountName()
+ {
+ return 'uid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedName()
+ {
+ return 'dn';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedNameSubKey()
+ {
+ //
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterEnabled()
+ {
+ return sprintf('(!(%s=*))', $this->lockoutTime());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterDisabled()
+ {
+ return sprintf('(%s=*)', $this->lockoutTime());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lockoutTime()
+ {
+ return 'pwdAccountLockedTime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategory()
+ {
+ return 'objectclass';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassGroup()
+ {
+ return 'groupofnames';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassOu()
+ {
+ return 'organizationalUnit';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassPerson()
+ {
+ return 'inetorgperson';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassUser()
+ {
+ return 'inetorgperson';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuid()
+ {
+ return 'nsuniqueid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuidRequiresConversion()
+ {
+ return false;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/EDirectory.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/EDirectory.php
new file mode 100644
index 0000000..db31011
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/EDirectory.php
@@ -0,0 +1,110 @@
+<?php
+
+namespace Adldap\Schemas;
+
+class EDirectory extends Schema
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function accountName()
+ {
+ return 'uid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedName()
+ {
+ return 'dn';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedNameSubKey()
+ {
+ //
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterEnabled()
+ {
+ return sprintf('(!(%s=*))', $this->lockoutTime());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterDisabled()
+ {
+ return sprintf('(%s=*)', $this->lockoutTime());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lockoutTime()
+ {
+ return 'pwdAccountLockedTime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategory()
+ {
+ return 'objectclass';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassGroup()
+ {
+ return 'groupofnames';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassOu()
+ {
+ return 'organizationalUnit';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassPerson()
+ {
+ return 'inetorgperson';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassUser()
+ {
+ return 'inetorgperson';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuid()
+ {
+ return 'guid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuidRequiresConversion()
+ {
+ return false;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/FreeIPA.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/FreeIPA.php
new file mode 100644
index 0000000..410f6f9
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/FreeIPA.php
@@ -0,0 +1,126 @@
+<?php
+
+namespace Adldap\Schemas;
+
+class FreeIPA extends Schema
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function accountName()
+ {
+ return 'uid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedName()
+ {
+ return 'dn';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategory()
+ {
+ return 'objectclass';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassGroup()
+ {
+ return 'ipausergroup';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function userPrincipalName()
+ {
+ return 'krbCanonicalName';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedNameSubKey()
+ {
+ return 0;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterEnabled()
+ {
+ return '(!(UserAccountControl:1.2.840.113556.1.4.803:=2))';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterDisabled()
+ {
+ return '(UserAccountControl:1.2.840.113556.1.4.803:=2)';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lockoutTime()
+ {
+ return 'lockouttime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function passwordLastSet()
+ {
+ return 'krbLastPwdChange';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassOu()
+ {
+ return 'organizationalunit';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassPerson()
+ {
+ return 'person';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassUser()
+ {
+ return 'organizationalPerson';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuid()
+ {
+ return 'ipaUniqueID';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuidRequiresConversion()
+ {
+ return false;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/OpenLDAP.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/OpenLDAP.php
new file mode 100644
index 0000000..d598617
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/OpenLDAP.php
@@ -0,0 +1,110 @@
+<?php
+
+namespace Adldap\Schemas;
+
+class OpenLDAP extends Schema
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function accountName()
+ {
+ return 'uid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedName()
+ {
+ return 'dn';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function distinguishedNameSubKey()
+ {
+ //
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterEnabled()
+ {
+ return sprintf('(!(%s=*))', $this->lockoutTime());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function filterDisabled()
+ {
+ return sprintf('(%s=*)', $this->lockoutTime());
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lockoutTime()
+ {
+ return 'pwdAccountLockedTime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategory()
+ {
+ return 'objectclass';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassGroup()
+ {
+ return 'groupofnames';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassOu()
+ {
+ return 'organizationalUnit';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassPerson()
+ {
+ return 'inetorgperson';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassUser()
+ {
+ return 'inetorgperson';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuid()
+ {
+ return 'entryuuid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectGuidRequiresConversion()
+ {
+ return false;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/Schema.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/Schema.php
new file mode 100644
index 0000000..ac76452
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/Schema.php
@@ -0,0 +1,1264 @@
+<?php
+
+namespace Adldap\Schemas;
+
+use Adldap\Models\User;
+use Adldap\Models\Entry;
+use Adldap\Models\Group;
+use Adldap\Models\Contact;
+use Adldap\Models\Printer;
+use Adldap\Models\Computer;
+use Adldap\Models\Container;
+use Adldap\Models\Organization;
+use Adldap\Models\OrganizationalUnit;
+use Adldap\Models\ForeignSecurityPrincipal;
+
+abstract class Schema implements SchemaInterface
+{
+ /**
+ * {@inheritdoc}
+ */
+ public function accountExpires()
+ {
+ return 'accountexpires';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function accountName()
+ {
+ return 'samaccountname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function accountType()
+ {
+ return 'samaccounttype';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function adminDisplayName()
+ {
+ return 'admindisplayname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function anr()
+ {
+ return 'anr';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function badPasswordCount()
+ {
+ return 'badpwdcount';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function badPasswordTime()
+ {
+ return 'badpasswordtime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function commonName()
+ {
+ return 'cn';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function company()
+ {
+ return 'company';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function computer()
+ {
+ return 'computer';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function computerModel()
+ {
+ return Computer::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function configurationNamingContext()
+ {
+ return 'configurationnamingcontext';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function contact()
+ {
+ return 'contact';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function contactModel()
+ {
+ return Contact::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function containerModel()
+ {
+ return Container::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function country()
+ {
+ return 'c';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function createdAt()
+ {
+ return 'whencreated';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function currentTime()
+ {
+ return 'currenttime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function defaultNamingContext()
+ {
+ return 'defaultnamingcontext';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function department()
+ {
+ return 'department';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function departmentNumber()
+ {
+ return 'departmentnumber';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function description()
+ {
+ return 'description';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function displayName()
+ {
+ return 'displayname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function dnsHostName()
+ {
+ return 'dnshostname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function domainComponent()
+ {
+ return 'dc';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function driverName()
+ {
+ return 'drivername';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function driverVersion()
+ {
+ return 'driverversion';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function email()
+ {
+ return 'mail';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function emailNickname()
+ {
+ return 'mailnickname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function employeeId()
+ {
+ return 'employeeid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function employeeNumber()
+ {
+ return 'employeenumber';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function employeeType()
+ {
+ return 'employeetype';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function entryModel()
+ {
+ return Entry::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function false()
+ {
+ return 'FALSE';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function firstName()
+ {
+ return 'givenname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function groupModel()
+ {
+ return Group::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function groupType()
+ {
+ return 'grouptype';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function homeAddress()
+ {
+ return 'homepostaladdress';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function homeMdb()
+ {
+ return 'homemdb';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function homeDrive()
+ {
+ return 'homedrive';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function homeDirectory()
+ {
+ return 'homedirectory';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function homePhone()
+ {
+ return 'homephone';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function info()
+ {
+ return 'info';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function initials()
+ {
+ return 'initials';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function instanceType()
+ {
+ return 'instancetype';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function ipPhone()
+ {
+ return 'ipphone';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function isCriticalSystemObject()
+ {
+ return 'iscriticalsystemobject';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function jpegPhoto()
+ {
+ return 'jpegphoto';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lastLogOff()
+ {
+ return 'lastlogoff';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lastLogOn()
+ {
+ return 'lastlogon';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lastLogOnTimestamp()
+ {
+ return 'lastlogontimestamp';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function lastName()
+ {
+ return 'sn';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function legacyExchangeDn()
+ {
+ return 'legacyexchangedn';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function locale()
+ {
+ return 'l';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function location()
+ {
+ return 'location';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function manager()
+ {
+ return 'manager';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function managedBy()
+ {
+ return 'managedby';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function maxPasswordAge()
+ {
+ return 'maxpwdage';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function member()
+ {
+ return 'member';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function memberIdentifier()
+ {
+ return 'distinguishedname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function memberOf()
+ {
+ return 'memberof';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function memberOfRecursive()
+ {
+ return 'memberof:1.2.840.113556.1.4.1941:';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function memberRange($from, $to)
+ {
+ return $this->member().";range={$from}-{$to}";
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function messageTrackingEnabled()
+ {
+ return 'messagetrackingenabled';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function msExchangeServer()
+ {
+ return 'ms-exch-exchange-server';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function name()
+ {
+ return 'name';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function neverExpiresDate()
+ {
+ return '9223372036854775807';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryComputer()
+ {
+ return 'computer';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryContainer()
+ {
+ return 'container';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryExchangePrivateMdb()
+ {
+ return 'msexchprivatemdb';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryExchangeServer()
+ {
+ return 'msExchExchangeServer';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryExchangeStorageGroup()
+ {
+ return 'msExchStorageGroup';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryGroup()
+ {
+ return 'group';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryOrganizationalUnit()
+ {
+ return 'organizational-unit';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryPerson()
+ {
+ return 'person';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectCategoryPrinter()
+ {
+ return 'print-queue';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClass()
+ {
+ return 'objectclass';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassComputer()
+ {
+ return 'computer';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassContact()
+ {
+ return 'contact';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassContainer()
+ {
+ return 'container';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassOrganization()
+ {
+ return 'organization';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassPrinter()
+ {
+ return 'printqueue';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassUser()
+ {
+ return 'user';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassForeignSecurityPrincipal()
+ {
+ return 'foreignsecurityprincipal';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectClassModelMap()
+ {
+ return [
+ $this->objectClassComputer() => $this->computerModel(),
+ $this->objectClassContact() => $this->contactModel(),
+ $this->objectClassPerson() => $this->userModel(),
+ $this->objectClassGroup() => $this->groupModel(),
+ $this->objectClassContainer() => $this->containerModel(),
+ $this->objectClassPrinter() => $this->printerModel(),
+ $this->objectClassOrganization() => $this->organizationModel(),
+ $this->objectClassOu() => $this->organizationalUnitModel(),
+ $this->objectClassForeignSecurityPrincipal() => $this->foreignSecurityPrincipalModel(),
+ ];
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectSid()
+ {
+ return 'objectsid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function objectSidRequiresConversion()
+ {
+ return true;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function operatingSystem()
+ {
+ return 'operatingsystem';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function operatingSystemServicePack()
+ {
+ return 'operatingsystemservicepack';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function operatingSystemVersion()
+ {
+ return 'operatingsystemversion';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function organization()
+ {
+ return 'organization';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function organizationName()
+ {
+ return 'o';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function organizationalPerson()
+ {
+ return 'organizationalperson';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function organizationalUnit()
+ {
+ return 'organizationalunit';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function organizationalUnitModel()
+ {
+ return OrganizationalUnit::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function organizationModel()
+ {
+ return Organization::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function organizationalUnitShort()
+ {
+ return 'ou';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function otherMailbox()
+ {
+ return 'othermailbox';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function passwordLastSet()
+ {
+ return 'pwdlastset';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function person()
+ {
+ return 'person';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function personalTitle()
+ {
+ return 'personaltitle';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function physicalDeliveryOfficeName()
+ {
+ return 'physicaldeliveryofficename';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function portName()
+ {
+ return 'portname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function postalCode()
+ {
+ return 'postalcode';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function postOfficeBox()
+ {
+ return 'postofficebox';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function primaryGroupId()
+ {
+ return 'primarygroupid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerBinNames()
+ {
+ return 'printbinnames';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerColorSupported()
+ {
+ return 'printcolor';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerDuplexSupported()
+ {
+ return 'printduplexsupported';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerEndTime()
+ {
+ return 'printendtime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerMaxResolutionSupported()
+ {
+ return 'printmaxresolutionsupported';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerMediaSupported()
+ {
+ return 'printmediasupported';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerMemory()
+ {
+ return 'printmemory';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerModel()
+ {
+ return Printer::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerName()
+ {
+ return 'printername';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerOrientationSupported()
+ {
+ return 'printorientationssupported';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerPrintRate()
+ {
+ return 'printrate';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerPrintRateUnit()
+ {
+ return 'printrateunit';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerShareName()
+ {
+ return 'printsharename';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerStaplingSupported()
+ {
+ return 'printstaplingsupported';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function printerStartTime()
+ {
+ return 'printstarttime';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function priority()
+ {
+ return 'priority';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function profilePath()
+ {
+ return 'profilepath';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function proxyAddresses()
+ {
+ return 'proxyaddresses';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function roomNumber()
+ {
+ return 'roomnumber';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function rootDomainNamingContext()
+ {
+ return 'rootdomainnamingcontext';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function schemaNamingContext()
+ {
+ return 'schemanamingcontext';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function scriptPath()
+ {
+ return 'scriptpath';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function serialNumber()
+ {
+ return 'serialnumber';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function serverName()
+ {
+ return 'servername';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function showInAddressBook()
+ {
+ return 'showinaddressbook';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function street()
+ {
+ return 'street';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function streetAddress()
+ {
+ return 'streetaddress';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function systemFlags()
+ {
+ return 'systemflags';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function telephone()
+ {
+ return 'telephonenumber';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function mobile()
+ {
+ return 'mobile';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function otherMobile()
+ {
+ return 'othermobile';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function facsimile()
+ {
+ return 'facsimiletelephonenumber';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function thumbnail()
+ {
+ return 'thumbnailphoto';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function title()
+ {
+ return 'title';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function top()
+ {
+ return 'top';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function true()
+ {
+ return 'TRUE';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function unicodePassword()
+ {
+ return 'unicodepwd';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function updatedAt()
+ {
+ return 'whenchanged';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function url()
+ {
+ return 'url';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function user()
+ {
+ return 'user';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function userAccountControl()
+ {
+ return 'useraccountcontrol';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function userId()
+ {
+ return 'uid';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function userModel()
+ {
+ return User::class;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function userObjectClasses(): array
+ {
+ return [
+ $this->top(),
+ $this->person(),
+ $this->organizationalPerson(),
+ $this->objectClassUser(),
+ ];
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function userPrincipalName()
+ {
+ return 'userprincipalname';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function userWorkstations()
+ {
+ return 'userworkstations';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function versionNumber()
+ {
+ return 'versionnumber';
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function foreignSecurityPrincipalModel()
+ {
+ return ForeignSecurityPrincipal::class;
+ }
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/SchemaInterface.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/SchemaInterface.php
new file mode 100644
index 0000000..023df74
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Schemas/SchemaInterface.php
@@ -0,0 +1,1421 @@
+<?php
+
+namespace Adldap\Schemas;
+
+interface SchemaInterface
+{
+ /**
+ * The date when the account expires. This value represents the number of 100-nanosecond
+ * intervals since January 1, 1601 (UTC). A value of 0 or 0x7FFFFFFFFFFFFFFF
+ * (9223372036854775807) indicates that the account never expires.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675098(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function accountExpires();
+
+ /**
+ * The logon name used to support clients and servers running earlier versions of the
+ * operating system, such as Windows NT 4.0, Windows 95, Windows 98,
+ * and LAN Manager. This attribute must be 20 characters or
+ * less to support earlier clients.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679635(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function accountName();
+
+ /**
+ * This attribute contains information about every account type object.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679637(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function accountType();
+
+ /**
+ * The name to be displayed on admin screens.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675214(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function adminDisplayName();
+
+ /**
+ * Ambiguous name resolution attribute to be used when choosing between objects.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675223(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function anr();
+
+ /**
+ * The number of times the user tried to log on to the account using
+ * an incorrect password. A value of 0 indicates that the
+ * value is unknown.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675244(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function badPasswordCount();
+
+ /**
+ * The last time and date that an attempt to log on to this
+ * account was made with a password that is not valid.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675243(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function badPasswordTime();
+
+ /**
+ * The name that represents an object.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675449(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function commonName();
+
+ /**
+ * The user's company name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675457(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function company();
+
+ /**
+ * The object class computer string.
+ *
+ * Used when constructing new Computer models.
+ *
+ * @return string
+ */
+ public function computer();
+
+ /**
+ * The class name of the Computer model.
+ *
+ * @return string
+ */
+ public function computerModel();
+
+ /**
+ * DN enterprise configuration naming context.
+ *
+ * @link https://support.microsoft.com/en-us/kb/219005
+ *
+ * @return string
+ */
+ public function configurationNamingContext();
+
+ /**
+ * The object class contact string.
+ *
+ * Used when constructing new User models.
+ *
+ * @return string
+ */
+ public function contact();
+
+ /**
+ * The class name of the Contact model.
+ *
+ * @return string
+ */
+ public function contactModel();
+
+ /**
+ * The class name of the Container model.
+ *
+ * @return string
+ */
+ public function containerModel();
+
+ /**
+ * The entry's country attribute.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675432(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function country();
+
+ /**
+ * The entry's created at attribute.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680924(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function createdAt();
+
+ /**
+ * The entry's current time attribute.
+ *
+ * This attribute is only available with the Root DSE record.
+ *
+ * @return string
+ */
+ public function currentTime();
+
+ /**
+ * This is the default NC for a particular server.
+ *
+ * By default, the DN for the domain of which this directory server is a member.
+ *
+ * @link https://support.microsoft.com/en-us/kb/219005
+ *
+ * @return string
+ */
+ public function defaultNamingContext();
+
+ /**
+ * Contains the name for the department in which the user works.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675490(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function department();
+
+ /**
+ * Identifies a department within an organization.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675491(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function departmentNumber();
+
+ /**
+ * Contains the description to display for an object. This value is restricted
+ * as single-valued for backward compatibility in some cases but
+ * is allowed to be multi-valued in others.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675492(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function description();
+
+ /**
+ * The display name for an object. This is usually the combination
+ * of the users first name, middle initial, and last name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675514(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function displayName();
+
+ /**
+ * The LDAP API references an LDAP object by its distinguished name (DN).
+ *
+ * A DN is a sequence of relative distinguished names (RDN) connected by commas.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/aa366101(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function distinguishedName();
+
+ /**
+ * The LDAP API references an LDAP object by its distinguished name (DN).
+ *
+ * Different vendors expect the value of the distinguished name to be in
+ * different places. For example ActiveDirectory expects distinguishedname
+ * value to be the first element in an array, however OpenLDAP expects
+ * the dn attribute to contain the value, not an array.
+ *
+ * @deprecated since 10.0.0
+ *
+ * @return int|null
+ */
+ public function distinguishedNameSubKey();
+
+ /**
+ * Name of computer as registered in DNS.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675524(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function dnsHostName();
+
+ /**
+ * Domain Component located inside an RDN.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/aa366101(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function domainComponent();
+
+ /**
+ * The device driver name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675652(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function driverName();
+
+ /**
+ * The Version number of device driver.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675653(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function driverVersion();
+
+ /**
+ * The list of email addresses for a contact.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676855(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function email();
+
+ /**
+ * The email nickname for the user.
+ *
+ * @return string
+ */
+ public function emailNickname();
+
+ /**
+ * The ID of an employee.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675662(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function employeeId();
+
+ /**
+ * The number assigned to an employee other than the ID.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675663(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function employeeNumber();
+
+ /**
+ * The job category for an employee.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675664(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function employeeType();
+
+ /**
+ * The class name of the Entry model.
+ *
+ * @return string
+ */
+ public function entryModel();
+
+ /**
+ * The LDAP `false` boolean in string form for conversion.
+ *
+ * @return string
+ */
+ public function false();
+
+ /**
+ * The LDAP filter to query for enabled users.
+ *
+ * @return mixed
+ */
+ public function filterEnabled();
+
+ /**
+ * The LDAP filter to query for disabled users.
+ *
+ * @return mixed
+ */
+ public function filterDisabled();
+
+ /**
+ * Contains the given name (first name) of the user.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675719(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function firstName();
+
+ /**
+ * The class name of the Group model.
+ *
+ * @return string
+ */
+ public function groupModel();
+
+ /**
+ * Contains a set of flags that define the type and scope of a group object.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms675935(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function groupType();
+
+ /**
+ * A user's home address.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676193(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function homeAddress();
+
+ /**
+ * The users mailbox database location.
+ *
+ * @return string
+ */
+ public function homeMdb();
+
+ /**
+ * Specifies the drive letter to which to map the UNC path specified by homeDirectory.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676191(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function homeDrive();
+
+ /**
+ * The home directory for the account.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676190(v=vs.85).aspx
+ *
+ * @return string|null
+ */
+ public function homeDirectory();
+
+ /**
+ * The user's main home phone number.
+ *
+ * @link https://docs.microsoft.com/en-us/windows/desktop/ADSchema/a-homephone
+ *
+ * @return string|null
+ */
+ public function homePhone();
+
+ /**
+ * The users extra notable information.
+ *
+ * @return string
+ */
+ public function info();
+
+ /**
+ * Contains the initials for parts of the user's full name.
+ *
+ * This may be used as the middle initial in the Windows Address Book.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676202(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function initials();
+
+ /**
+ * A bitfield that dictates how the object is instantiated on a particular server.
+ *
+ * The value of this attribute can differ on different replicas even if the replicas are in sync.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676204(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function instanceType();
+
+ /**
+ * Specifies the TCP/IP address for the phone. Used by telephony.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/cc221092.aspx
+ *
+ * @return string
+ */
+ public function ipPhone();
+
+ /**
+ * If TRUE, the object hosting this attribute must be replicated during installation of a new replica.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676798(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function isCriticalSystemObject();
+
+ /**
+ * Used to store one or more images of a person using the JPEG File Interchange Format [JFIF].
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676813(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function jpegPhoto();
+
+ /**
+ * This attribute is not used.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676822(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function lastLogOff();
+
+ /**
+ * The last time the user logged on. This value is stored as a large integer that
+ * represents the number of 100-nanosecond intervals since January 1, 1601 (UTC).
+ *
+ * A value of zero means that the last logon time is unknown.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676823(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function lastLogOn();
+
+ /**
+ * This is the time that the user last logged into the domain.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676824(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function lastLogOnTimestamp();
+
+ /**
+ * This attribute contains the family or last name for a user.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679872(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function lastName();
+
+ /**
+ * The distinguished name previously used by Exchange.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676830(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function legacyExchangeDn();
+
+ /**
+ * The users locale.
+ *
+ * @return string
+ */
+ public function locale();
+
+ /**
+ * The user's location, such as office number.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676839(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function location();
+
+ /**
+ * The date and time (UTC) that this account was locked out. This value is stored
+ * as a large integer that represents the number of 100-nanosecond intervals
+ * since January 1, 1601 (UTC). A value of zero means that the
+ * account is not currently locked out.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676843(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function lockoutTime();
+
+ /**
+ * Contains the distinguished name of the user who is the user's manager.
+ *
+ * The manager's user object contains a directReports property that
+ * contains references to all user objects that have their manager
+ * properties set to this distinguished name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676859(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function manager();
+
+ /**
+ * The distinguished name of the user that is assigned to manage this object.
+ *
+ * @link https://docs.microsoft.com/en-us/windows/desktop/adschema/a-managedby
+ *
+ * @return string
+ */
+ public function managedBy();
+
+ /**
+ * The maximum amount of time, in 100-nanosecond intervals, a password is valid.
+ *
+ * This value is stored as a large integer that represents the number of
+ * 100-nanosecond intervals from the time the password was set
+ * before the password expires.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms676863(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function maxPasswordAge();
+
+ /**
+ * The list of users that belong to the group.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms677097(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function member();
+
+ /**
+ * The identifier of records that belong to a group.
+ *
+ * For example, in ActiveDirectory, the 'member' attribute on
+ * a group record contains a list of distinguished names,
+ * so `distinguishedname` would be the identifier.
+ *
+ * In other environments such as Sun Directory
+ * Server, this identifier would be `uid`.
+ *
+ * @return string
+ */
+ public function memberIdentifier();
+
+ /**
+ * The distinguished names of the groups to which this object belongs.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms677099(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function memberOf();
+
+ /**
+ * The distinguished names of the groups to which this object belongs.
+ *
+ * This string contains a rule OID indicating the inclusion of ancestral and child members.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms677099(v=vs.85).aspx
+ * @link https://msdn.microsoft.com/en-us/library/aa746475(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function memberOfRecursive();
+
+ /**
+ * The range limited list of users that belong to the group. See range limit in Active Directory
+ * (Range Retrieval of Attribute Values https://msdn.microsoft.com/en-us/library/cc223242.aspx)
+ * Issue #342.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms677097(v=vs.85).aspx
+ *
+ * @param string|int $from
+ * @param string|int $to
+ *
+ * @return string
+ */
+ public function memberRange($from, $to);
+
+ /**
+ * @link https://msdn.microsoft.com/en-us/library/ms981934(v=exchg.65).aspx
+ *
+ * @return string
+ */
+ public function messageTrackingEnabled();
+
+ /**
+ * The object category of an exchange server.
+ *
+ * @return string
+ */
+ public function msExchangeServer();
+
+ /**
+ * The general name of the entry.
+ *
+ * @return string
+ */
+ public function name();
+
+ /**
+ * Returns a string value indicating that an account does not expire.
+ *
+ * @return string
+ */
+ public function neverExpiresDate();
+
+ /**
+ * An object class name used to group objects of this or derived classes.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679011(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function objectCategory();
+
+ /**
+ * The computer object category.
+ *
+ * @return string
+ */
+ public function objectCategoryComputer();
+
+ /**
+ * The container object category.
+ *
+ * @return string
+ */
+ public function objectCategoryContainer();
+
+ /**
+ * The exchange private MDB category.
+ *
+ * @return string
+ */
+ public function objectCategoryExchangePrivateMdb();
+
+ /**
+ * The exchange server object category.
+ *
+ * @return string
+ */
+ public function objectCategoryExchangeServer();
+
+ /**
+ * The exchange storage group object category.
+ *
+ * @return string
+ */
+ public function objectCategoryExchangeStorageGroup();
+
+ /**
+ * The group object category.
+ *
+ * @return string
+ */
+ public function objectCategoryGroup();
+
+ /**
+ * The organizational unit category.
+ *
+ * @return string
+ */
+ public function objectCategoryOrganizationalUnit();
+
+ /**
+ * The person object category.
+ *
+ * @return string
+ */
+ public function objectCategoryPerson();
+
+ /**
+ * The printer object category.
+ *
+ * @return string
+ */
+ public function objectCategoryPrinter();
+
+ /**
+ * The list of classes from which this class is derived.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679012(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function objectClass();
+
+ /**
+ * The computer object class.
+ *
+ * @return string
+ */
+ public function objectClassComputer();
+
+ /**
+ * The contact object class.
+ *
+ * @return string
+ */
+ public function objectClassContact();
+
+ /**
+ * The container object class.
+ *
+ * @return string
+ */
+ public function objectClassContainer();
+
+ /**
+ * The group object class.
+ *
+ * @return string
+ */
+ public function objectClassGroup();
+
+ /**
+ * The ou object class.
+ *
+ * @return string
+ */
+ public function objectClassOu();
+
+ /**
+ * The person object class.
+ *
+ * Represents people who are associated with an organization in some way.
+ *
+ * @return string
+ */
+ public function objectClassPerson();
+
+ /**
+ * The printer object class.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms683911(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function objectClassPrinter();
+
+ /**
+ * The user object class.
+ *
+ * @return string
+ */
+ public function objectClassUser();
+
+ /**
+ * The object class model map.
+ *
+ * @return array
+ */
+ public function objectClassModelMap();
+
+ /**
+ * The unique identifier for an object.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679021(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function objectGuid();
+
+ /**
+ * Determine whether the object GUID requires conversion from binary.
+ *
+ * @return bool
+ */
+ public function objectGuidRequiresConversion();
+
+ /**
+ * A binary value that specifies the security identifier (SID) of the user.
+ *
+ * The SID is a unique value used to identify the user as a security principal.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679024(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function objectSid();
+
+ /**
+ * Determine whether the object SID requires conversion from binary.
+ *
+ * @return bool
+ */
+ public function objectSidRequiresConversion();
+
+ /**
+ * The Operating System name, for example, Windows Vista Enterprise.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679076(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function operatingSystem();
+
+ /**
+ * The operating system service pack ID string (for example, SP3).
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679078(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function operatingSystemServicePack();
+
+ /**
+ * The operating system version string, for example, 4.0.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679079(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function operatingSystemVersion();
+
+ /**
+ * The RDN version of organization name for use in distinguished names.
+ *
+ * @return mixed
+ */
+ public function organizationName();
+
+ /**
+ * This class is used for objects that contain organizational information about a user,
+ * such as the employee number, department, manager, title, office address, and so on.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms683883(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function organizationalPerson();
+
+ /**
+ * A container for storing users, computers, and other account objects.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms683886(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function organizationalUnit();
+
+ /**
+ * The class name of the Organizational Unit model.
+ *
+ * @return string
+ */
+ public function organizationalUnitModel();
+
+ /**
+ * The RDN version of organizational unit for use in distinguished names.
+ *
+ * @return string
+ */
+ public function organizationalUnitShort();
+
+ /**
+ * Contains other additional mail addresses in a form such as CCMAIL: JohnDoe.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679091(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function otherMailbox();
+
+ /**
+ * The date and time that the password for this account was last changed.
+ *
+ * This value is stored as a large integer that represents the number of 100 nanosecond intervals
+ * since January 1, 1601 (UTC). If this value is set to 0 and the User-Account-Control attribute
+ * does not contain the UF_DONT_EXPIRE_PASSWD flag, then the user must set the password at
+ * the next logon.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679430(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function passwordLastSet();
+
+ /**
+ * The person object class.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms683895(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function person();
+
+ /**
+ * The user's title.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679115(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function personalTitle();
+
+ /**
+ * Contains the office location in the user's place of business.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679117(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function physicalDeliveryOfficeName();
+
+ /**
+ * List of port names. For example, for printer ports or comm ports.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679131(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function portName();
+
+ /**
+ * The postal or zip code for mail delivery.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679366(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function postalCode();
+
+ /**
+ * The post office box number for this object.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679367(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function postOfficeBox();
+
+ /**
+ * Contains the relative identifier (RID) for the primary group of the user.
+ *
+ * By default, this is the RID for the Domain Users group.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679375(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function primaryGroupId();
+
+ /**
+ * A list of printer bin names.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679380(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerBinNames();
+
+ /**
+ * If a printer can print in color.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679382(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerColorSupported();
+
+ /**
+ * Indicates the type of duplex support a printer has.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679383(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerDuplexSupported();
+
+ /**
+ * The time a print queue stops servicing jobs.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679384(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerEndTime();
+
+ /**
+ * The maximum printer resolution.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679391(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerMaxResolutionSupported();
+
+ /**
+ * A list of media supported by a printer.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679395(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerMediaSupported();
+
+ /**
+ * The amount of memory installed in a printer.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679396(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerMemory();
+
+ /**
+ * The class name of the Printer model.
+ *
+ * @return string
+ */
+ public function printerModel();
+
+ /**
+ * The display name of an attached printer.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679385(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerName();
+
+ /**
+ * The page rotation for landscape printing.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679402(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerOrientationSupported();
+
+ /**
+ * Driver-supplied print rate.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679405(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerPrintRate();
+
+ /**
+ * Driver-supplied print rate unit.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679406(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerPrintRateUnit();
+
+ /**
+ * The printer's share name.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679408(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerShareName();
+
+ /**
+ * If the printer supports stapling. Supplied by the driver.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679410(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerStaplingSupported();
+
+ /**
+ * The time a print queue begins servicing jobs.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679411(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function printerStartTime();
+
+ /**
+ * The current priority (of a process, print job, and so on).
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679413(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function priority();
+
+ /**
+ * Specifies a path to the user's profile. This value can be a null
+ * string, a local absolute path, or a UNC path.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679422(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function profilePath();
+
+ /**
+ * A proxy address is the address by which a Microsoft Exchange Server recipient
+ * object is recognized in a foreign mail system. Proxy addresses are required
+ * for all recipient objects, such as custom recipients and distribution lists.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679424(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function proxyAddresses();
+
+ /**
+ * The room number of an object.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679615(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function roomNumber();
+
+ /**
+ * The DN of the root domain NC for this DC's forest.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/cc223262.aspx
+ *
+ * @return mixed
+ */
+ public function rootDomainNamingContext();
+
+ /**
+ * The attribute.
+ *
+ * @return mixed
+ */
+ public function schemaNamingContext();
+
+ /**
+ * This attribute specifies the path for the user's logon script. The string can be null.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679656(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function scriptPath();
+
+ /**
+ * Part of X.500 specification. Not used by Active Directory.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679771(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function serialNumber();
+
+ /**
+ * The name of a server.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679772(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function serverName();
+
+ /**
+ * This attribute is used to indicate in which MAPI address books an object will appear.
+ *
+ * It is usually maintained by the Exchange Recipient Update Service.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679822(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function showInAddressBook();
+
+ /**
+ * The street address.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679882(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function street();
+
+ /**
+ * The street address.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms679882(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function streetAddress();
+
+ /**
+ * An integer value that contains flags that define additional properties of the class.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680022(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function systemFlags();
+
+ /**
+ * The primary telephone number.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680027(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function telephone();
+
+ /**
+ * The primary mobile phone number.
+ *
+ * @link https://docs.microsoft.com/en-us/windows/desktop/adschema/a-mobile
+ *
+ * @return string
+ */
+ public function mobile();
+
+ /**
+ * The secondary mobile phone number.
+ *
+ * @link https://docs.microsoft.com/en-us/windows/desktop/ADSchema/a-othermobile
+ *
+ * @return string
+ */
+ public function otherMobile();
+
+ /**
+ * The users thumbnail photo path.
+ *
+ * @return string
+ */
+ public function thumbnail();
+
+ /**
+ * Contains the user's job title.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680037(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function title();
+
+ /**
+ * The top level class from which all classes are derived.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms683975(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function top();
+
+ /**
+ * The LDAP `true` boolean in string form for conversion.
+ *
+ * @return string
+ */
+ public function true();
+
+ /**
+ * The password of the user in Windows NT one-way format (OWF). Windows 2000 uses the Windows NT OWF.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680513(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function unicodePassword();
+
+ /**
+ * The date when this object was last changed.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680921(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function updatedAt();
+
+ /**
+ * The entry's URL attribute.
+ *
+ * @return string
+ */
+ public function url();
+
+ /**
+ * The user object class.
+ *
+ * This class is used to store information about an employee or contractor who works for an organization.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms683980(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function user();
+
+ /**
+ * Flags that control the behavior of the user account.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680832(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function userAccountControl();
+
+ /**
+ * The user ID attribute.
+ *
+ * @return string
+ */
+ public function userId();
+
+ /**
+ * The class name of the User model.
+ *
+ * @return string
+ */
+ public function userModel();
+
+ /**
+ * The object classes that User models must be constructed with.
+ *
+ * @return array
+ */
+ public function userObjectClasses(): array;
+
+ /**
+ * This attribute contains the UPN that is an Internet-style login name for
+ * a user based on the Internet standard RFC 822.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680857(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function userPrincipalName();
+
+ /**
+ * Contains the NetBIOS or DNS names of the computers running Windows NT Workstation
+ * or Windows 2000 Professional from which the user can log on.
+ *
+ * Each NetBIOS name is separated by a comma.
+ *
+ * Multiple names should be separated by commas.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680868(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function userWorkstations();
+
+ /**
+ * A general purpose version number.
+ *
+ * @link https://msdn.microsoft.com/en-us/library/ms680897(v=vs.85).aspx
+ *
+ * @return string
+ */
+ public function versionNumber();
+}
diff --git a/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Utilities.php b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Utilities.php
new file mode 100644
index 0000000..1c70e8c
--- /dev/null
+++ b/mailcow/src/mailcow-dockerized/data/web/inc/lib/vendor/adldap2/adldap2/src/Utilities.php
@@ -0,0 +1,232 @@
+<?php
+
+namespace Adldap;
+
+class Utilities
+{
+ /**
+ * Converts a DN string into an array of RDNs.
+ *
+ * This will also decode hex characters into their true
+ * UTF-8 representation embedded inside the DN as well.
+ *
+ * @param string $dn
+ * @param bool $removeAttributePrefixes
+ *
+ * @return array|false
+ */
+ public static function explodeDn($dn, $removeAttributePrefixes = true)
+ {
+ $dn = ldap_explode_dn($dn, ($removeAttributePrefixes ? 1 : 0));
+
+ if (is_array($dn) && array_key_exists('count', $dn)) {
+ foreach ($dn as $rdn => $value) {
+ $dn[$rdn] = self::unescape($value);
+ }
+ }
+
+ return $dn;
+ }
+
+ /**
+ * Un-escapes a hexadecimal string into
+ * its original string representation.
+ *
+ * @param string $value
+ *
+ * @return string
+ */
+ public static function unescape($value)
+ {
+ return preg_replace_callback('/\\\([0-9A-Fa-f]{2})/', function ($matches) {
+ return chr(hexdec($matches[1]));
+ }, $value);
+ }
+
+ /**
+ * Convert a binary SID to a string SID.
+ *
+ * @author Chad Sikorra
+ *
+ * @link https://github.com/ChadSikorra
+ * @link https://stackoverflow.com/questions/39533560/php-ldap-get-user-sid
+ *
+ * @param string $value The Binary SID
+ *
+ * @return string|null
+ */
+ public static function binarySidToString($value)
+ {
+ // Revision - 8bit unsigned int (C1)
+ // Count - 8bit unsigned int (C1)
+ // 2 null bytes
+ // ID - 32bit unsigned long, big-endian order
+ $sid = @unpack('C1rev/C1count/x2/N1id', $value);
+
+ if (!isset($sid['id']) || !isset($sid['rev'])) {
+ return;
+ }
+
+ $revisionLevel = $sid['rev'];
+
+ $identifierAuthority = $sid['id'];
+
+ $subs = isset($sid['count']) ? $sid['count'] : 0;
+
+ $sidHex = $subs ? bin2hex($value) : '';
+
+ $subAuthorities = [];
+
+ // The sub-authorities depend on the count, so only get as
+ // many as the count, regardless of data beyond it.
+ for ($i = 0; $i < $subs; $i++) {
+ $data = implode('', array_reverse(
+ str_split(
+ substr($sidHex, 16 + ($i * 8), 8),
+ 2
+ )
+ ));
+
+ $subAuthorities[] = hexdec($data);
+ }
+
+ // Tack on the 'S-' and glue it all together...
+ return 'S-'.$revisionLevel.'-'.$identifierAuthority.implode(
+ preg_filter('/^/', '-', $subAuthorities)
+ );
+ }
+
+ /**
+ * Convert a binary GUID to a string GUID.
+ *
+ * @param string $binGuid
+ *
+ * @return string|null
+ */
+ public static function binaryGuidToString($binGuid)
+ {
+ if (trim($binGuid) == '' || is_null($binGuid)) {
+ return;
+ }
+
+ $hex = unpack('H*hex', $binGuid)['hex'];
+
+ $hex1 = substr($hex, -26, 2).substr($hex, -28, 2).substr($hex, -30, 2).substr($hex, -32, 2);
+ $hex2 = substr($hex, -22, 2).substr($hex, -24, 2);
+ $hex3 = substr($hex, -18, 2).substr($hex, -20, 2);
+ $hex4 = substr($hex, -16, 4);
+ $hex5 = substr($hex, -12, 12);
+
+ $guid = sprintf('%s-%s-%s-%s-%s', $hex1, $hex2, $hex3, $hex4, $hex5);
+
+ return $guid;
+ }
+
+ /**
+ * Converts a string GUID to it's hex variant.
+ *
+ * @param string $string
+ *
+ * @return string
+ */
+ public static function stringGuidToHex($string)
+ {
+ $hex = '\\'.substr($string, 6, 2).'\\'.substr($string, 4, 2).'\\'.substr($string, 2, 2).'\\'.substr($string, 0, 2);
+ $hex = $hex.'\\'.substr($string, 11, 2).'\\'.substr($string, 9, 2);
+ $hex = $hex.'\\'.substr($string, 16, 2).'\\'.substr($string, 14, 2);
+ $hex = $hex.'\\'.substr($string, 19, 2).'\\'.substr($string, 21, 2);
+ $hex = $hex.'\\'.substr($string, 24, 2).'\\'.substr($string, 26, 2).'\\'.substr($string, 28, 2).'\\'.substr($string, 30, 2).'\\'.substr($string, 32, 2).'\\'.substr($string, 34, 2);
+
+ return $hex;
+ }
+
+ /**
+ * Encode a password for transmission over LDAP.
+ *
+ * @param string $password The password to encode
+ *
+ * @return string
+ */
+ public static function encodePassword($password)
+ {
+ return iconv('UTF-8', 'UTF-16LE', '"'.$password.'"');
+ }
+
+ /**
+ * Salt and hash a password to make its SSHA OpenLDAP version.
+ *
+ * @param string $password The password to create
+ *
+ * @return string
+ */
+ public static function makeSSHAPassword($password)
+ {
+ mt_srand((float) microtime() * 1000000);
+ $salt = pack('CCCC', mt_rand(), mt_rand(), mt_rand(), mt_rand());
+
+ return '{SSHA}'.base64_encode(pack('H*', sha1($password.$salt)).$salt);
+ }
+
+ /**
+ * Round a Windows timestamp down to seconds and remove
+ * the seconds between 1601-01-01 and 1970-01-01.
+ *
+ * @param float $windowsTime
+ *
+ * @return float
+ */
+ public static function convertWindowsTimeToUnixTime($windowsTime)
+ {
+ return round($windowsTime / 10000000) - 11644473600;
+ }
+
+ /**
+ * Convert a Unix timestamp to Windows timestamp.
+ *
+ * @param float $unixTime
+ *
+ * @return float
+ */
+ public static function convertUnixTimeToWindowsTime($unixTime)
+ {
+ return ($unixTime + 11644473600) * 10000000;
+ }
+
+ /**
+ * Validates that the inserted string is an object SID.
+ *
+ * @param string $sid
+ *
+ * @return bool
+ */
+ public static function isValidSid($sid)
+ {
+ return (bool) preg_match("/^S-\d(-\d{1,10}){1,16}$/i", $sid);
+ }
+
+ /**
+ * Validates that the inserted string is an object GUID.
+ *
+ * @param string $guid
+ *
+ * @return bool
+ */
+ public static function isValidGuid($guid)
+ {
+ return (bool) preg_match('/^([0-9a-fA-F]){8}(-([0-9a-fA-F]){4}){3}-([0-9a-fA-F]){12}$|^([0-9a-fA-F]{8}-){3}[0-9a-fA-F]{8}$/', $guid);
+ }
+
+ /**
+ * Converts an ignore string into an array.
+ *
+ * @param string $ignore
+ *
+ * @return array
+ */
+ protected static function ignoreStrToArray($ignore)
+ {
+ $ignore = trim($ignore);
+
+ return $ignore ? str_split($ignore) : [];
+ }
+}
