CAS_ProxyChain Class Reference

A normal proxy-chain definition that lists each level of the chain as either a string or regular expression. More...

Inheritance diagram for CAS_ProxyChain:

Collaboration diagram for CAS_ProxyChain:

Public Member Functions
	__construct (array $chain)
	A chain is an array of strings or regexp strings that will be matched against. More...
	matches (array $list)
	Match a list of proxies. More...
Public Member Functions inherited from CAS_ProxyChain_Interface
	matches (array $list)
	Match a list of proxies. More...

Protected Member Functions
	isSizeValid (array $list)
	Validate the size of the the list as compared to our chain. More...

Protected Attributes
	$chain = array()

Detailed Description

A normal proxy-chain definition that lists each level of the chain as either a string or regular expression.

Definition at line 42 of file ProxyChain.php.

Constructor & Destructor Documentation

__construct()

CAS_ProxyChain::__construct

(

array

$chain

)

A chain is an array of strings or regexp strings that will be matched against.

Regexp will be matched with preg_match and strings will be matched from the beginning. A string must fully match the beginning of an proxy url. So you can define a full domain as acceptable or go further down. Proxies have to be defined in reverse from the service to the user. If a user hits service A get proxied via B to service C the list of acceptable proxies on C would be array(B,A);

Parameters

array

$chain

A chain of proxies

Definition at line 58 of file ProxyChain.php.

    {
        // Ensure that we have an indexed array
        $this->chain = array_values($chain);
    }

Member Function Documentation

isSizeValid()

CAS_ProxyChain::isSizeValid ( array  $list )

protected

Validate the size of the the list as compared to our chain.

Parameters

array

$list

List of proxies

Returns

bool

Definition at line 121 of file ProxyChain.php.

Referenced by matches().

    {
        return (sizeof($this->chain) == sizeof($list));
    }

Here is the caller graph for this function:

matches()

CAS_ProxyChain::matches

(

array

$list

)

Match a list of proxies.

Parameters

array

$list

The list of proxies in front of this service.

Returns

bool

Definition at line 71 of file ProxyChain.php.

References $i, isSizeValid(), and phpCAS\trace().

    {
        $list = array_values($list);  // Ensure that we have an indexed array
        if ($this->isSizeValid($list)) {
            $mismatch = false;
            foreach ($this->chain as $i => $search) {
                $proxy_url = $list[$i];
                if (preg_match('/^\/.*\/[ixASUXu]*$/s', $search)) {
                    if (preg_match($search, $proxy_url)) {
                        phpCAS::trace(
                            "Found regexp " . $search . " matching " . $proxy_url
                        );
                    } else {
                        phpCAS::trace(
                            "No regexp match " . $search . " != " . $proxy_url
                        );
                        $mismatch = true;
                        break;
                    }
                } else {
                    if (strncasecmp($search, $proxy_url, strlen($search)) == 0) {
                        phpCAS::trace(
                            "Found string " . $search . " matching " . $proxy_url
                        );
                    } else {
                        phpCAS::trace(
                            "No match " . $search . " != " . $proxy_url
                        );
                        $mismatch = true;
                        break;
                    }
                }
            }
            if (!$mismatch) {
                phpCAS::trace("Proxy chain matches");
                return true;
            }
        } else {
            phpCAS::trace("Proxy chain skipped: size mismatch");
        }
        return false;
    }

Here is the call graph for this function:

Field Documentation

$chain

CAS_ProxyChain::$chain = array()

protected

Definition at line 44 of file ProxyChain.php.

---

The documentation for this class was generated from the following file:

• Services/CAS/lib/CAS/ProxyChain.php