File: ProcessingFilter.php

package info (click to toggle)
simplesamlphp 1.13.1-2%2Bdeb8u1
  • links: PTS, VCS
  • area: main
  • in suites: jessie
  • size: 11,304 kB
  • sloc: php: 65,124; xml: 629; python: 376; sh: 193; perl: 185; makefile: 43
file content (68 lines) | stat: -rw-r--r-- 1,981 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
<?php


/**
 * Base class for authentication processing filters.
 *
 * All authentication processing filters must support serialization.
 *
 * The current request is stored in an associative array. It has the following defined attributes:
 * - 'Attributes'  The attributes of the user.
 * - 'Destination'  Metadata of the destination (SP).
 * - 'Source'  Metadata of the source (IdP).
 *
 * It may also contain other attributes. If an authentication processing filter wishes to store other
 * information in it, it should have a name on the form 'module:filter:attributename', to avoid name
 * collisions.
 *
 * @author Olav Morken, UNINETT AS.
 * @package simpleSAMLphp
 */
abstract class SimpleSAML_Auth_ProcessingFilter {

	/**
	 * Priority of this filter.
	 *
	 * Used when merging IdP and SP processing chains.
	 * The priority can be any integer. The default for most filters is 50. Filters may however
	 * specify their own default, if they typically should be amongst the first or the last filters.
	 *
	 * The prioroty can also be overridden by the user by specifying the '%priority' option.
	 */
	public $priority = 50;


	/**
	 * Constructor for a processing filter.
	 *
	 * Any processing filter which implements its own constructor must call this
	 * constructor first.
	 *
	 * @param array &$config  Configuration for this filter.
	 * @param mixed $reserved  For future use.
	 */
	public function __construct(&$config, $reserved) {
		assert('is_array($config)');

		if(array_key_exists('%priority', $config)) {
			$this->priority = $config['%priority'];
			if(!is_int($this->priority)) {
				throw new Exception('Invalid priority: ' . var_export($this->priority, TRUE));
			}
			unset($config['%priority']);
		}
	}


	/**
	 * Process a request.
	 *
	 * When a filter returns from this function, it is assumed to have completed its task.
	 *
	 * @param array &$request  The request we are currently processing.
	 */
	abstract public function process(&$request);

}

?>