BaseFilter::__construct() - Code Metrics - simplesamlphp/simplesamlphp-module-ldap - Measure and Improve Code Quality continuously with Scrutinizer

BaseFilter::__construct() A
last analyzed 2025-10-28 23:12 UTC

↳ Parent: BaseFilter

Complexity

Conditions	3
Paths	2

Size

Total Lines	78
Code Lines	40

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	3
eloc	40
nc	2
nop	2
dl	0
loc	78
rs	9.28
c	0
b	0
f	0

How to fix Long Method

<?php

/**
 * This base LDAP filter class can be extended to enable real filter classes direct access
 * access to the authsource ldap config and connects to the ldap server.
 *
 * @package simplesamlphp/simplesamlphp-module-ldap
 */

declare(strict_types=1);

namespace SimpleSAML\Module\ldap\Auth\Process;

use SimpleSAML\Auth;
use SimpleSAML\Configuration;
use SimpleSAML\Error;
use SimpleSAML\Logger;
use SimpleSAML\Module\ldap\ConnectorFactory;
use SimpleSAML\Module\ldap\ConnectorInterface;

abstract class BaseFilter extends Auth\ProcessingFilter
{
    /**
     * TODO: Support ldap:LDAPMulti, if possible
     *
     * @var string[]
     */
    protected static array $ldapsources = ['ldap:Ldap', 'authX509:X509userCert'];

    /**
     * List of attribute "alias's" linked to the real attribute
     * name. Used for abstraction / configuration of the LDAP
     * attribute names, which may change between dir service.
     *
     * @var array<mixed>
     */
    protected array $attribute_map;

    /**
     * The base DN of the LDAP connection. Used when searching the LDAP server.
     *
     * @var array<mixed>
     */
    protected array $searchBase;

    /**
     * The construct method will change the filter config into
     * a \SimpleSAML\Configuration object and store it here for
     * later use, if needed.
     *
     * @var \SimpleSAML\Configuration
     */
    protected Configuration $config;

    /**
     * Array of LDAP connection objects. Stored here to be accessed later during processing.
     *
     * @var \SimpleSAML\Module\ldap\ConnectorInterface
     */
    protected ConnectorInterface $connector;

    /**
     * The class "title" used in logging and exception messages.
     * This should be prepended to the beginning of the message.
     *
     * @var string
     */
    protected string $title = 'ldap:BaseFilter';

    /**
     * List of LDAP object types, used to determine the type of
     * object that a DN references.
     *
     * @var array<mixed>
     */
    protected array $type_map;


    /**
     * Checks the authsource, if defined, for configuration values
     * to the LDAP server. Then sets up the LDAP connection for the
     * instance/object and stores everything in class members.
     *
     * @throws \SimpleSAML\Error\Exception
     * @param array<mixed> &$config
     * @param mixed $reserved
     */
    public function __construct(array &$config, $reserved)
    {
        parent::__construct($config, $reserved);

        // Change the class $title to match it's true name
        // This way if the class is extended the proper name is used
        $classname = explode('_', get_class($this));
        $classname = end($classname);
        $this->title = 'ldap:' . $classname;

        // Log the construction
        Logger::debug(sprintf('%s : Creating and configuring the filter.', $this->title));

        // If an authsource was defined (an not empty string)...
        if (isset($config['authsource']) && $config['authsource'] !== '') {
            $authconfig = $this->parseAuthSourceConfig($config['authsource']);

            // Merge the authsource config with the filter config,
            // but have the filter config override the authsource config
            $config = array_merge($authconfig, $config);

            // Authsource complete
            Logger::debug(sprintf(
                '%s : Retrieved authsource [%s] configuration values: %s',
                $this->title,
                $config['authsource'],
                $this->varExport($authconfig),
            ));
        }

        // Convert the config array to a config class,
        // that way we can verify type and define defaults.
        // Store in the instance in-case needed later, by a child class.
        $this->config = Configuration::loadFromArray($config, 'ldap:AuthProcess');

        // Initialize the Ldap-object
        $this->connector = ConnectorFactory::fromAuthSource($config['authsource']);

        // Set all the filter values, setting defaults if needed
        $this->searchBase = $this->config->getOptionalArray('search.base', []);

        // Log the member values retrieved above
        Logger::debug(sprintf(
            '%s : Configuration values retrieved; BaseDN: %s',
            $this->title,
            $this->varExport($this->searchBase),
        ));

        // Setup the attribute map which will be used to search LDAP
        $this->attribute_map = [
            'dn'       => $this->config->getOptionalString('attribute.dn', 'distinguishedName'),
            'groups'   => $this->config->getOptionalString('attribute.groups', 'groups'),
            'member'   => $this->config->getOptionalString('attribute.member', 'member'),
            'memberOf' => $this->config->getOptionalString('attribute.memberOf', 'memberOf'),
            'name'     => $this->config->getOptionalString('attribute.groupname', 'name'),
            'return'   => $this->config->getOptionalString('attribute.return', 'distinguishedName'),
            'type'     => $this->config->getOptionalString('attribute.type', 'objectClass'),
            'username' => $this->config->getOptionalString('attribute.username', 'sAMAccountName'),
        ];

        // Log the attribute map
        Logger::debug(sprintf(
            '%s : Attribute map created: %s',
            $this->title,
            $this->varExport($this->attribute_map),
        ));

        // Setup the object type map which is used to determine a DNs' type
        $this->type_map = [
            'group' => $this->config->getOptionalString('type.group', 'group'),
            'user'  => $this->config->getOptionalString('type.user', 'user'),
        ];

        // Log the type map
        Logger::debug(sprintf(
            '%s : Type map created: %s',
            $this->title,
            $this->varExport($this->type_map),
        ));
    }


    /**
     * Parse authsource config
     *
     * @param string $as The name of the authsource
     * @return array<mixed>
     */
    private function parseAuthSourceConfig(string $as): array
    {
        // Log the authsource request
        Logger::debug(sprintf(
            '%s : Attempting to get configuration values from authsource [%s]',
            $this->title,
            $as,
        ));

        // Get the authsources file, which should contain the config
        $authsources = Configuration::getConfig('authsources.php');

        // Verify that the authsource config exists
        if (!$authsources->hasValue($as)) {
            throw new Error\Exception(sprintf(
                '%s : Authsource [%s] defined in filter parameters not found in authsources.php',
                $this->title,
                $as,
            ));
        }

        // Get just the specified authsource config values
        $authsource = $authsources->getArray($as);

        // Make sure it is an ldap source
        if (isset($authsource[0]) && !in_array($authsource[0], self::$ldapsources)) {
            throw new Error\Exception(sprintf(
                '%s : Authsource [%s] specified in filter parameters is not an ldap:LDAP type',
                $this->title,
                $as,
            ));
        }

        // Build the authsource config
        $authconfig = [];
        if (isset($authsource['connection_string'])) {
            $authconfig['connection_string'] = $authsource['connection_string'];
        }
        if (isset($authsource['encryption'])) {
            $authconfig['encryption'] = $authsource['encryption'];
        }
        if (isset($authsource['version'])) {
            $authconfig['version'] = $authsource['version'];
        }
        if (isset($authsource['timeout'])) {
            $authconfig['timeout'] = $authsource['timeout'];
        }
        if (isset($authsource['debug'])) {
            $authconfig['debug']      = $authsource['debug'];
        }
        if (isset($authsource['referrals'])) {
            $authconfig['referrals']  = $authsource['referrals'];
        }

        // only set when search.enabled = true
        if (isset($authsource['search.enable']) && ($authsource['search.enable'] === true)) {
            if (isset($authsource['search.base'])) {
                $authconfig['search.base'] = $authsource['search.base'];
            }
            if (isset($authsource['search.scope'])) {
                $authconfig['search.scope'] = $authsource['search.scope'];
            }

            if (isset($authsource['search.username'])) {
                $authconfig['search.username']   = $authsource['search.username'];
            }
            if (isset($authsource['search.password'])) {
                $authconfig['search.password']   = $authsource['search.password'];
            }

            // Only set the username attribute if the authsource specifies one attribute
            if (
                isset($authsource['search.attributes'])
                && is_array($authsource['search.attributes'])
                && count($authsource['search.attributes']) == 1
            ) {
                $authconfig['attribute.username'] = reset($authsource['search.attributes']);
            }
        }

        // only set when priv.read = true
        if (isset($authsource['priv.read']) && $authsource['priv.read']) {
            if (isset($authsource['priv.username'])) {
                $authconfig['priv.username'] = $authsource['priv.username'];
            }
            if (isset($authsource['priv.password'])) {
                $authconfig['priv.password'] = $authsource['priv.password'];
            }
        }

        return $authconfig;
    }


    /**
     * Local utility function to get details about a variable,
     * basically converting it to a string to be used in a log
     * message. The var_export() function returns several lines
     * so this will remove the new lines and trim each line.
     *
     * @param mixed $value
     * @return string
     */
    protected function varExport($value): string
    {
        if (is_array($value)) {
            // remove sensitive data
            foreach ($value as $key => &$val) {
                if ($key === 'search.password' || $key === 'priv.password') {
                    $val = empty($val) ? '' : '********';
                }
            }
            unset($val);
        }

        $export = var_export($value, true);
        $lines = explode("\n", $export);
        foreach ($lines as &$line) {
            $line = trim($line);
        }
        return implode(' ', $lines);
    }
}


1			<?php
2
3			/**
4			* This base LDAP filter class can be extended to enable real filter classes direct access
5			* access to the authsource ldap config and connects to the ldap server.
6			*
7			* @package simplesamlphp/simplesamlphp-module-ldap
8			*/
9
10			declare(strict_types=1);
11
12			namespace SimpleSAML\Module\ldap\Auth\Process;
13
14			use SimpleSAML\Auth;
15			use SimpleSAML\Configuration;
16			use SimpleSAML\Error;
17			use SimpleSAML\Logger;
18			use SimpleSAML\Module\ldap\ConnectorFactory;
19			use SimpleSAML\Module\ldap\ConnectorInterface;
20
21			abstract class BaseFilter extends Auth\ProcessingFilter
22			{
23			/**
24			* TODO: Support ldap:LDAPMulti, if possible
25			*
26			* @var string[]
27			*/
28			protected static array $ldapsources = ['ldap:Ldap', 'authX509:X509userCert'];
29
30			/**
31			* List of attribute "alias's" linked to the real attribute
32			* name. Used for abstraction / configuration of the LDAP
33			* attribute names, which may change between dir service.
34			*
35			* @var array<mixed>
36			*/
37			protected array $attribute_map;
38
39			/**
40			* The base DN of the LDAP connection. Used when searching the LDAP server.
41			*
42			* @var array<mixed>
43			*/
44			protected array $searchBase;
45
46			/**
47			* The construct method will change the filter config into
48			* a \SimpleSAML\Configuration object and store it here for
49			* later use, if needed.
50			*
51			* @var \SimpleSAML\Configuration
52			*/
53			protected Configuration $config;
54
55			/**
56			* Array of LDAP connection objects. Stored here to be accessed later during processing.
57			*
58			* @var \SimpleSAML\Module\ldap\ConnectorInterface
59			*/
60			protected ConnectorInterface $connector;
61
62			/**
63			* The class "title" used in logging and exception messages.
64			* This should be prepended to the beginning of the message.
65			*
66			* @var string
67			*/
68			protected string $title = 'ldap:BaseFilter';
69
70			/**
71			* List of LDAP object types, used to determine the type of
72			* object that a DN references.
73			*
74			* @var array<mixed>
75			*/
76			protected array $type_map;
77
78
79			/**
80			* Checks the authsource, if defined, for configuration values
81			* to the LDAP server. Then sets up the LDAP connection for the
82			* instance/object and stores everything in class members.
83			*
84			* @throws \SimpleSAML\Error\Exception
85			* @param array<mixed> &$config
86			* @param mixed $reserved
87			*/
88			public function __construct(array &$config, $reserved)
89			{
90			parent::__construct($config, $reserved);
91
92			// Change the class $title to match it's true name
93			// This way if the class is extended the proper name is used
94			$classname = explode('_', get_class($this));
95			$classname = end($classname);
96			$this->title = 'ldap:' . $classname;
97
98			// Log the construction
99			Logger::debug(sprintf('%s : Creating and configuring the filter.', $this->title));
100
101			// If an authsource was defined (an not empty string)...
102			if (isset($config['authsource']) && $config['authsource'] !== '') {
103			$authconfig = $this->parseAuthSourceConfig($config['authsource']);
104
105			// Merge the authsource config with the filter config,
106			// but have the filter config override the authsource config
107			$config = array_merge($authconfig, $config);
108
109			// Authsource complete
110			Logger::debug(sprintf(
111			'%s : Retrieved authsource [%s] configuration values: %s',
112			$this->title,
113			$config['authsource'],
114			$this->varExport($authconfig),
115			));
116			}
117
118			// Convert the config array to a config class,
119			// that way we can verify type and define defaults.
120			// Store in the instance in-case needed later, by a child class.
121			$this->config = Configuration::loadFromArray($config, 'ldap:AuthProcess');
122
123			// Initialize the Ldap-object
124			$this->connector = ConnectorFactory::fromAuthSource($config['authsource']);
125
126			// Set all the filter values, setting defaults if needed
127			$this->searchBase = $this->config->getOptionalArray('search.base', []);
128
129			// Log the member values retrieved above
130			Logger::debug(sprintf(
131			'%s : Configuration values retrieved; BaseDN: %s',
132			$this->title,
133			$this->varExport($this->searchBase),
134			));
135
136			// Setup the attribute map which will be used to search LDAP
137			$this->attribute_map = [
138			'dn' => $this->config->getOptionalString('attribute.dn', 'distinguishedName'),
139			'groups' => $this->config->getOptionalString('attribute.groups', 'groups'),
140			'member' => $this->config->getOptionalString('attribute.member', 'member'),
141			'memberOf' => $this->config->getOptionalString('attribute.memberOf', 'memberOf'),
142			'name' => $this->config->getOptionalString('attribute.groupname', 'name'),
143			'return' => $this->config->getOptionalString('attribute.return', 'distinguishedName'),
144			'type' => $this->config->getOptionalString('attribute.type', 'objectClass'),
145			'username' => $this->config->getOptionalString('attribute.username', 'sAMAccountName'),
146			];
147
148			// Log the attribute map
149			Logger::debug(sprintf(
150			'%s : Attribute map created: %s',
151			$this->title,
152			$this->varExport($this->attribute_map),
153			));
154
155			// Setup the object type map which is used to determine a DNs' type
156			$this->type_map = [
157			'group' => $this->config->getOptionalString('type.group', 'group'),
158			'user' => $this->config->getOptionalString('type.user', 'user'),
159			];
160
161			// Log the type map
162			Logger::debug(sprintf(
163			'%s : Type map created: %s',
164			$this->title,
165			$this->varExport($this->type_map),
166			));
167			}
168
169
170			/**
171			* Parse authsource config
172			*
173			* @param string $as The name of the authsource
174			* @return array<mixed>
175			*/
176			private function parseAuthSourceConfig(string $as): array
177			{
178			// Log the authsource request
179			Logger::debug(sprintf(
180			'%s : Attempting to get configuration values from authsource [%s]',
181			$this->title,
182			$as,
183			));
184
185			// Get the authsources file, which should contain the config
186			$authsources = Configuration::getConfig('authsources.php');
187
188			// Verify that the authsource config exists
189			if (!$authsources->hasValue($as)) {
190			throw new Error\Exception(sprintf(
191			'%s : Authsource [%s] defined in filter parameters not found in authsources.php',
192			$this->title,
193			$as,
194			));
195			}
196
197			// Get just the specified authsource config values
198			$authsource = $authsources->getArray($as);
199
200			// Make sure it is an ldap source
201			if (isset($authsource[0]) && !in_array($authsource[0], self::$ldapsources)) {
202			throw new Error\Exception(sprintf(
203			'%s : Authsource [%s] specified in filter parameters is not an ldap:LDAP type',
204			$this->title,
205			$as,
206			));
207			}
208
209			// Build the authsource config
210			$authconfig = [];
211			if (isset($authsource['connection_string'])) {
212			$authconfig['connection_string'] = $authsource['connection_string'];
213			}
214			if (isset($authsource['encryption'])) {
215			$authconfig['encryption'] = $authsource['encryption'];
216			}
217			if (isset($authsource['version'])) {
218			$authconfig['version'] = $authsource['version'];
219			}
220			if (isset($authsource['timeout'])) {
221			$authconfig['timeout'] = $authsource['timeout'];
222			}
223			if (isset($authsource['debug'])) {
224			$authconfig['debug'] = $authsource['debug'];
225			}
226			if (isset($authsource['referrals'])) {
227			$authconfig['referrals'] = $authsource['referrals'];
228			}
229
230			// only set when search.enabled = true
231			if (isset($authsource['search.enable']) && ($authsource['search.enable'] === true)) {
232			if (isset($authsource['search.base'])) {
233			$authconfig['search.base'] = $authsource['search.base'];
234			}
235			if (isset($authsource['search.scope'])) {
236			$authconfig['search.scope'] = $authsource['search.scope'];
237			}
238
239			if (isset($authsource['search.username'])) {
240			$authconfig['search.username'] = $authsource['search.username'];
241			}
242			if (isset($authsource['search.password'])) {
243			$authconfig['search.password'] = $authsource['search.password'];
244			}
245
246			// Only set the username attribute if the authsource specifies one attribute
247			if (
248			isset($authsource['search.attributes'])
249			&& is_array($authsource['search.attributes'])
250			&& count($authsource['search.attributes']) == 1
251			) {
252			$authconfig['attribute.username'] = reset($authsource['search.attributes']);
253			}
254			}
255
256			// only set when priv.read = true
257			if (isset($authsource['priv.read']) && $authsource['priv.read']) {
258			if (isset($authsource['priv.username'])) {
259			$authconfig['priv.username'] = $authsource['priv.username'];
260			}
261			if (isset($authsource['priv.password'])) {
262			$authconfig['priv.password'] = $authsource['priv.password'];
263			}
264			}
265
266			return $authconfig;
267			}
268
269
270			/**
271			* Local utility function to get details about a variable,
272			* basically converting it to a string to be used in a log
273			* message. The var_export() function returns several lines
274			* so this will remove the new lines and trim each line.
275			*
276			* @param mixed $value
277			* @return string
278			*/
279			protected function varExport($value): string
280			{
281			if (is_array($value)) {
282			// remove sensitive data
283			foreach ($value as $key => &$val) {
284			if ($key === 'search.password' \|\| $key === 'priv.password') {
285			$val = empty($val) ? '' : '********';
286			}
287			}
288			unset($val);
289			}
290
291			$export = var_export($value, true);
292			$lines = explode("\n", $export);
293			foreach ($lines as &$line) {
294			$line = trim($line);
295			}
296			return implode(' ', $lines);
297			}
298			}
299

simplesamlphp / simplesamlphp-module-ldap

BaseFilter::__construct() A last analyzed 2025-10-28 23:12 UTC

Complexity

Size

Duplication

Importance

How to fix Long Method

Long Method

Duplication Side-by-Side

Filter issues like

BaseFilter::__construct() A
last analyzed 2025-10-28 23:12 UTC