ldapauth/ldapauth.php

   1 <?php
   2
   3 /**
   4  * Name: LDAP Authenticate
   5  * Description: Authenticate a user against an LDAP directory
   6  * Version: 1.1
   7  * Author: Mike Macgirvin <http://macgirvin.com/profile/mike>
   8  * Author: aymhce
   9  */
  10
  11 /**
  12  * Friendica addon
  13  *
  14  * Module: LDAP Authenticate
  15  *
  16  * Authenticate a user against an LDAP directory
  17  * Useful for Windows Active Directory and other LDAP-based organisations
  18  * to maintain a single password across the organisation.
  19  *
  20  * Optionally authenticates only if a member of a given group in the directory.
  21  *
  22  * By default, the person must have registered with Friendica using the normal registration
  23  * procedures in order to have a Friendica user record, contact, and profile.
  24  * However, it's possible with an option to automate the creation of a Friendica basic account.
  25  *
  26  * Note when using with Windows Active Directory: you may need to set TLS_CACERT in your site
  27  * ldap.conf file to the signing cert for your LDAP server.
  28  *
  29  * The configuration options for this module may be set in the config/addon.config.php file
  30  * e.g.:
  31  *
  32  * [ldapauth]
  33  * ; ldap hostname server - required
  34  * ldap_server = host.example.com
  35  * ; dn to search users - required
  36  * ldap_searchdn = ou=users,dc=example,dc=com
  37  * ; attribute to find username - required
  38  * ldap_userattr = uid
  39  *
  40  * ; admin dn - optional - only if ldap server dont have anonymous access
  41  * ldap_binddn = cn=admin,dc=example,dc=com
  42  * ; admin password - optional - only if ldap server dont have anonymous access
  43  * ldap_bindpw = password
  44  *
  45  * ; for create Friendica account if user exist in ldap
  46  * ;     required an email and a simple (beautiful) nickname on user ldap object
  47  * ;   active account creation - optional - default none
  48  * ldap_autocreateaccount = true
  49  * ;   attribute to get email - optional - default : 'mail'
  50  * ldap_autocreateaccount_emailattribute = mail
  51  * ;   attribute to get nickname - optional - default : 'givenName'
  52  * ldap_autocreateaccount_nameattribute = cn
  53  *
  54  * ...etc.
  55  */
  56
  57 use Friendica\App;
  58 use Friendica\Core\Hook;
  59 use Friendica\Core\Logger;
  60 use Friendica\Database\DBA;
  61 use Friendica\DI;
  62 use Friendica\Model\User;
  63 use Friendica\Core\Config\Util\ConfigFileLoader;
  64
  65 function ldapauth_install()
  66 {
  67         Hook::register('load_config',  'addon/ldapauth/ldapauth.php', 'ldapauth_load_config');
  68         Hook::register('authenticate', 'addon/ldapauth/ldapauth.php', 'ldapauth_hook_authenticate');
  69 }
  70
  71 function ldapauth_load_config(App $a, ConfigFileLoader $loader)
  72 {
  73         $a->getConfigCache()->load($loader->loadAddonConfig('ldapauth'));
  74 }
  75
  76 function ldapauth_hook_authenticate(App $a, array &$b)
  77 {
  78         $user = ldapauth_authenticate($b['username'], $b['password']);
  79         if (!empty($user['uid'])) {
  80                 $b['user_record'] = User::getById($user['uid']);
  81                 $b['authenticated'] = 1;
  82         }
  83 }
  84
  85 function ldapauth_authenticate($username, $password)
  86 {
  87         $ldap_server   = DI::config()->get('ldapauth', 'ldap_server');
  88         $ldap_binddn   = DI::config()->get('ldapauth', 'ldap_binddn');
  89         $ldap_bindpw   = DI::config()->get('ldapauth', 'ldap_bindpw');
  90         $ldap_searchdn = DI::config()->get('ldapauth', 'ldap_searchdn');
  91         $ldap_userattr = DI::config()->get('ldapauth', 'ldap_userattr');
  92         $ldap_group    = DI::config()->get('ldapauth', 'ldap_group');
  93         $ldap_autocreateaccount = DI::config()->get('ldapauth', 'ldap_autocreateaccount');
  94         $ldap_autocreateaccount_emailattribute = DI::config()->get('ldapauth', 'ldap_autocreateaccount_emailattribute');
  95         $ldap_autocreateaccount_nameattribute  = DI::config()->get('ldapauth', 'ldap_autocreateaccount_nameattribute');
  96
  97         if (!extension_loaded('ldap') || !strlen($ldap_server)) {
  98                 Logger::error('Addon not configured or missing php-ldap extension', ['extension_loaded' => extension_loaded('ldap'), 'server' => $ldap_server]);
  99                 return false;
 100         }
 101
 102         if (!strlen($password)) {
 103                 Logger::error('Empty password disallowed', ['provided_password_length' => strlen($password)]);
 104                 return false;
 105         }
 106
 107         $connect = @ldap_connect($ldap_server);
 108         if ($connect === false) {
 109                 Logger::warning('Could not connect to LDAP server', ['server' => $ldap_server]);
 110                 return false;
 111         }
 112
 113         @ldap_set_option($connect, LDAP_OPT_PROTOCOL_VERSION, 3);
 114         @ldap_set_option($connect, LDAP_OPT_REFERRALS, 0);
 115         if ((@ldap_bind($connect, $ldap_binddn, $ldap_bindpw)) === false) {
 116                 Logger::warning('Could not bind to LDAP server', ['server' => $ldap_server, 'binddn' => $ldap_binddn, 'errno' => ldap_errno($connect), 'error' => ldap_error($connect)]);
 117                 return false;
 118         }
 119
 120         $res = @ldap_search($connect, $ldap_searchdn, $ldap_userattr . '=' . $username);
 121         if (!$res) {
 122                 Logger::notice('LDAP user not found.', ['searchdn' => $ldap_searchdn, 'userattr' => $ldap_userattr, 'username' => $username, 'errno' => ldap_errno($connect), 'error' => ldap_error($connect)]);
 123                 return false;
 124         }
 125
 126         $id = @ldap_first_entry($connect, $res);
 127         if (!$id) {
 128                 Logger::notice('Could not retrieve first LDAP entry.', ['searchdn' => $ldap_searchdn, 'userattr' => $ldap_userattr, 'username' => $username, 'errno' => ldap_errno($connect), 'error' => ldap_error($connect)]);
 129                 return false;
 130         }
 131
 132         $dn = @ldap_get_dn($connect, $id);
 133         if (!@ldap_bind($connect, $dn, $password)) {
 134                 Logger::notice('Could not authenticate LDAP user with provided password', ['errno' => ldap_errno($connect), 'error' => ldap_error($connect)]);
 135                 return false;
 136         }
 137
 138         if (strlen($ldap_group) && @ldap_compare($connect, $ldap_group, 'member', $dn) !== true) {
 139                 $errno = @ldap_errno($connect);
 140                 if ($errno === 32) {
 141                         Logger::notice('LDAP Access Control Group does not exist', ['errno' => $errno, 'error' => ldap_error($connect)]);
 142                 } elseif ($errno === 16) {
 143                         Logger::notice('LDAP membership attribute does not exist in access control group', ['errno' => $errno, 'error' => ldap_error($connect)]);
 144                 } else {
 145                         Logger::notice('LDAP user isn\'t part of the authorized group', ['dn' => $dn]);
 146                 }
 147
 148                 @ldap_close($connect);
 149                 return false;
 150         }
 151
 152         if ($ldap_autocreateaccount == 'true' && !DBA::exists('user', ['nickname' => $username])) {
 153                 if (!strlen($ldap_autocreateaccount_emailattribute)) {
 154                         $ldap_autocreateaccount_emailattribute = 'mail';
 155                 }
 156                 if (!strlen($ldap_autocreateaccount_nameattribute)) {
 157                         $ldap_autocreateaccount_nameattribute = 'givenName';
 158                 }
 159                 $email_values = @ldap_get_values($connect, $id, $ldap_autocreateaccount_emailattribute);
 160                 $name_values = @ldap_get_values($connect, $id, $ldap_autocreateaccount_nameattribute);
 161
 162                 return ldap_createaccount($username, $password, $email_values[0] ?? '', $name_values[0] ?? '');
 163         }
 164
 165         try {
 166                 $authentication = User::getAuthenticationInfo($username);
 167                 return User::getById($authentication['uid']);
 168         } catch (Exception $e) {
 169                 Logger::notice('LDAP authentication error: ' . $e->getMessage());
 170                 return false;
 171         }
 172 }
 173
 174 function ldap_createaccount($username, $password, $email, $name)
 175 {
 176         if (!strlen($email) || !strlen($name)) {
 177                 Logger::notice('Could not create local user from LDAP data, no email or nickname provided');
 178                 return false;
 179         }
 180
 181         try {
 182                 $user = User::create([
 183                         'username' => $name,
 184                         'nickname' => $username,
 185                         'email'    => $email,
 186                         'password' => $password,
 187                         'verified' => 1
 188                 ]);
 189                 Logger::info('Local user created from LDAP data', ['username' => $username, 'name' => $name]);
 190                 return $user;
 191         } catch (Exception $ex) {
 192                 Logger::error('Could not create local user from LDAP data', ['username' => $username, 'exception' => $ex->getMessage()]);
 193         }
 194
 195         return false;
 196 }