3 * StatusNet, the distributed open-source microblogging tool
5 * Superclass for plugins that do authentication
9 * LICENCE: This program is free software: you can redistribute it and/or modify
10 * it under the terms of the GNU Affero General Public License as published by
11 * the Free Software Foundation, either version 3 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU Affero General Public License for more details.
19 * You should have received a copy of the GNU Affero General Public License
20 * along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * @author Craig Andrews <candrews@integralblue.com>
25 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
26 * @link http://status.net/
29 if (!defined('STATUSNET') && !defined('LACONICA')) {
34 * Superclass for plugins that do authentication
38 * @author Craig Andrews <candrews@integralblue.com>
39 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
40 * @link http://status.net/
43 abstract class AuthenticationPlugin extends Plugin
45 //is this plugin authoritative for authentication?
46 public $authoritative = false;
48 //should accounts be automatically created after a successful login attempt?
49 public $autoregistration = false;
51 //can the user change their email address
52 public $password_changeable=true;
54 //unique name for this authentication provider
55 public $provider_name;
57 //------------Auth plugin should implement some (or all) of these methods------------\\
59 * Check if a nickname/password combination is valid
62 * @return boolean true if the credentials are valid, false if they are invalid.
64 function checkPassword($username, $password)
70 * Automatically register a user when they attempt to login with valid credentials.
71 * User::register($data) is a very useful method for this implementation
73 * @return mixed instance of User, or false (if user couldn't be created)
75 function autoRegister($username)
77 $registration_data = array();
78 $registration_data['nickname'] = $username ;
79 return User::register($registration_data);
83 * Change a user's password
84 * The old password has been verified to be valid by this plugin before this call is made
88 * @return boolean true if the password was changed, false if password changing failed for some reason
90 function changePassword($username,$oldpassword,$newpassword)
95 //------------Below are the methods that connect StatusNet to the implementing Auth plugin------------\\
96 function onInitializePlugin(){
97 if(!isset($this->provider_name)){
98 throw new Exception("must specify a provider_name for this authentication provider");
102 function onStartCheckPassword($nickname, $password, &$authenticatedUser){
103 //map the nickname to a username
104 $user_username = new User_username();
105 $user_username->username=$nickname;
106 $user_username->provider_name=$this->provider_name;
107 if($user_username->find() && $user_username->fetch()){
108 $username = $user_username->username;
109 $authenticated = $this->checkPassword($username, $password);
111 $authenticatedUser = User::staticGet('id', $user_username->user_id);
115 $user = User::staticGet('nickname', $nickname);
117 //make sure a different provider isn't handling this nickname
118 $user_username = new User_username();
119 $user_username->username=$nickname;
120 if(!$user_username->find()){
121 //no other provider claims this username, so it's safe for us to handle it
122 $authenticated = $this->checkPassword($nickname, $password);
124 $authenticatedUser = User::staticGet('nickname', $nickname);
125 User_username::register($authenticatedUser,$nickname,$this->provider_name);
130 if($this->autoregistration){
131 $authenticated = $this->checkPassword($nickname, $password);
133 $user = $this->autoregister($nickname);
135 $authenticatedUser = $user;
136 User_username::register($authenticatedUser,$nickname,$this->provider_name);
143 if($this->authoritative){
146 //we're not authoritative, so let other handlers try
151 function onStartChangePassword($user,$oldpassword,$newpassword)
153 if($this->password_changeable){
154 $user_username = new User_username();
155 $user_username->user_id=$user->id;
156 $user_username->provider_name=$this->provider_name;
157 if($user_username->find() && $user_username->fetch()){
158 $authenticated = $this->checkPassword($user_username->username, $oldpassword);
160 $result = $this->changePassword($user_username->username,$oldpassword,$newpassword);
162 //stop handling of other handlers, because what was requested was done
165 throw new Exception(_('Password changing failed'));
168 if($this->authoritative){
169 //since we're authoritative, no other plugin could do this
170 throw new Exception(_('Password changing failed'));
172 //let another handler try
178 if($this->authoritative){
179 //since we're authoritative, no other plugin could do this
180 throw new Exception(_('Password changing is not allowed'));
185 function onStartAccountSettingsPasswordMenuItem($widget)
187 if($this->authoritative && !$this->password_changeable){
188 //since we're authoritative, no other plugin could change passwords, so do not render the menu item
193 function onAutoload($cls)
197 case 'User_username':
198 require_once(INSTALLDIR.'/plugins/Authentication/User_username.php');
205 function onCheckSchema() {
206 $schema = Schema::get();
207 $schema->ensureDataObject('User_username');
211 function onUserDeleteRelated($user, &$tables)
213 $tables[] = 'User_username';