Localization updates
[Packages/TYPO3.CMS.git] / typo3 / sysext / sv / class.tx_sv_authbase.php
1 <?php
2 /***************************************************************
3 * Copyright notice
4 *
5 * (c) 2004-2005 René Fritz <r.fritz@colorcube.de>
6 * All rights reserved
7 *
8 * This script is part of the TYPO3 project. The TYPO3 project is
9 * free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * The GNU General Public License can be found at
15 * http://www.gnu.org/copyleft/gpl.html.
16 * A copy is found in the textfile GPL.txt and important notices to the license
17 * from the author is found in LICENSE.txt distributed with these scripts.
18 *
19 *
20 * This script is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
24 *
25 * This copyright notice MUST APPEAR in all copies of the script!
26 ***************************************************************/
27 /**
28 * Service base class for 'User authentication'.
29 *
30 * @author René Fritz <r.fritz@colorcube.de>
31 */
32 /**
33 * [CLASS/FUNCTION INDEX of SCRIPT]
34 *
35 *
36 *
37 * 62: class tx_sv_authbase extends t3lib_svbase
38 * 87: function initAuth($mode, $loginData, $authInfo, &$pObj)
39 * 110: function compareUident($user, $loginData, $security_level='')
40 * 129: function writelog($type,$action,$error,$details_nr,$details,$data,$tablename='',$recuid='',$recpid='')
41 *
42 * SECTION: create/update user - EXPERIMENTAL
43 * 158: function fetchUserRecord($username, $extraWhere='', $dbUserSetup='')
44 *
45 * TOTAL FUNCTIONS: 4
46 * (This index is automatically created/updated by the extension "extdeveval")
47 *
48 */
49
50 require_once(PATH_t3lib.'class.t3lib_svbase.php');
51
52
53
54
55 /**
56 * Authentication services class
57 *
58 * @author René Fritz <r.fritz@colorcube.de>
59 * @package TYPO3
60 * @subpackage tx_sv
61 */
62 class tx_sv_authbase extends t3lib_svbase {
63
64 var $pObj; // Parent object
65
66 var $mode; // Subtype of the service which is used to call the service.
67
68 var $login = array(); // Submitted login form data
69 var $authInfo = array(); // Various data
70
71 var $db_user = array(); // User db table definition
72 var $db_groups = array(); // Usergroups db table definition
73
74 var $writeAttemptLog = false; // If the writelog() functions is called if a login-attempt has be tried without success
75 var $writeDevLog = false; // If the t3lib_div::devLog() function should be used
76
77
78 /**
79 * Initialize authentication service
80 *
81 * @param string Subtype of the service which is used to call the service.
82 * @param array Submitted login form data
83 * @param array Information array. Holds submitted form data etc.
84 * @param object Parent object
85 * @return void
86 */
87 function initAuth($mode, $loginData, $authInfo, &$pObj) {
88
89 $this->pObj = &$pObj;
90
91 $this->mode = $mode; // sub type
92 $this->login = $loginData;
93 $this->authInfo = $authInfo;
94
95 $this->db_user = $this->getServiceOption('db_user', $authInfo['db_user'], FALSE);
96 $this->db_groups = $this->getServiceOption('db_groups', $authInfo['db_groups'], FALSE);
97
98 $this->writeAttemptLog = $this->pObj->writeAttemptLog;
99 $this->writeDevLog = $this->pObj->writeDevLog;
100 }
101
102 /**
103 * Check the login data with the user record data for builtin login methods
104 *
105 * @param array user data array
106 * @param array login data array
107 * @param string security_level
108 * @return boolean true if login data matched
109 */
110 function compareUident($user, $loginData, $security_level='') {
111 return $this->pObj->compareUident($user, $loginData, $security_level);
112 }
113
114 /**
115 * Writes to log database table in pObj
116 *
117 * @param integer $type: denotes which module that has submitted the entry. This is the current list: 1=tce_db; 2=tce_file; 3=system (eg. sys_history save); 4=modules; 254=Personal settings changed; 255=login / out action: 1=login, 2=logout, 3=failed login (+ errorcode 3), 4=failure_warning_email sent
118 * @param integer $action: denotes which specific operation that wrote the entry (eg. 'delete', 'upload', 'update' and so on...). Specific for each $type. Also used to trigger update of the interface. (see the log-module for the meaning of each number !!)
119 * @param integer $error: flag. 0 = message, 1 = error (user problem), 2 = System Error (which should not happen), 3 = security notice (admin)
120 * @param integer $details_nr: The message number. Specific for each $type and $action. in the future this will make it possible to translate errormessages to other languages
121 * @param string $details: Default text that follows the message
122 * @param array $data: Data that follows the log. Might be used to carry special information. If an array the first 5 entries (0-4) will be sprintf'ed the details-text...
123 * @param string $tablename: Special field used by tce_main.php. These ($tablename, $recuid, $recpid) holds the reference to the record which the log-entry is about. (Was used in attic status.php to update the interface.)
124 * @param integer $recuid: Special field used by tce_main.php. These ($tablename, $recuid, $recpid) holds the reference to the record which the log-entry is about. (Was used in attic status.php to update the interface.)
125 * @param integer $recpid: Special field used by tce_main.php. These ($tablename, $recuid, $recpid) holds the reference to the record which the log-entry is about. (Was used in attic status.php to update the interface.)
126 * @return void
127 * @see t3lib_userauthgroup::writelog()
128 */
129 function writelog($type,$action,$error,$details_nr,$details,$data,$tablename='',$recuid='',$recpid='') {
130 if($this->writeAttemptLog) {
131 $this->pObj->writelog($type,$action,$error,$details_nr,$details,$data,$tablename,$recuid,$recpid);
132 }
133 }
134
135
136
137
138
139
140
141
142
143
144 /*************************
145 *
146 * create/update user - EXPERIMENTAL
147 *
148 *************************/
149
150 /**
151 * Get a user from DB by username
152 *
153 * @param string user name
154 * @param string additional WHERE clause: " AND ...
155 * @param array User db table definition: $this->db_user
156 * @return mixed user array or false
157 */
158 function fetchUserRecord($username, $extraWhere='', $dbUserSetup='') {
159
160 $dbUser = is_array($dbUserSetup) ? $dbUserSetup : $this->db_user;
161 $user = $this->pObj->fetchUserRecord($dbUser, $username, $extraWhere);
162
163 return $user;
164 }
165 }
166
167 ?>