class.ilSamlMappedUserAttributeValueParser.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
final readonly class ilSamlMappedUserAttributeValueParser
{
    private const string ATTR_REGEX = '/^(.*?)(\|(\d+))?$/';
 
    public function __construct(
        private ilExternalAuthUserAttributeMappingRule $rule,
        private array $userData
    ) {
    }
 
    private function getValueIndex(): int
    {
        $index = 0;
 
        $matches = [];
        preg_match(self::ATTR_REGEX, $this->rule->getExternalAttribute(), $matches);
 
        if (is_array($matches) && isset($matches[3]) && is_numeric($matches[3])) {
            $index = (int) $matches[3];
        }
 
        return max($index, 0);
    }
 
    public function getAttributeKey(): string
    {
        $attribute = '';
 
        $matches = [];
        preg_match(self::ATTR_REGEX, $this->rule->getExternalAttribute(), $matches);
 
        if (is_array($matches) && isset($matches[1]) && is_string($matches[1])) {
            $attribute = $matches[1];
        }
 
        return $attribute;
    }
 
    public function parse(): string
    {
        $attributeKey = $this->getAttributeKey();
 
        if (!array_key_exists($attributeKey, $this->userData)) {
            throw new ilSamlException(sprintf(
                "Configured external attribute of mapping '%s' -> '%s' does not exist in SAML attribute data.",
                $this->rule->getAttribute(),
                $this->rule->getExternalAttribute()
            ));
        }
 
        $value = $this->userData[$attributeKey];
 
        if (is_array($value)) {
            $valueIndex = $this->getValueIndex();
 
            if (!array_key_exists($valueIndex, $value)) {
                throw new ilSamlException(sprintf(
                    "Configured external attribute of mapping '%s' -> '%s' does not exist in SAML attribute data.",
                    $this->rule->getAttribute(),
                    $this->rule->getExternalAttribute()
                ));
            }
 
            $value = $value[$valueIndex];
        }
 
        if (!is_scalar($value)) {
            throw new ilSamlException(sprintf(
                "Could not parse a scalar value based on the user attribute mapping '%s' -> '%s'.",
                $this->rule->getAttribute(),
                $this->rule->getExternalAttribute()
            ));
        }
 
        return (string) $value;
    }
}