source: trunk/lib/Auth_SQL.inc.php @ 421

Last change on this file since 421 was 421, checked in by anonymous, 11 years ago

Added switch for login_form_allow_autocomplete
File size: 49.9 KB
Line 
1<?php
2/**
3 * The Strangecode Codebase - a general application development framework for PHP
4 * For details visit the project site: <http://trac.strangecode.com/codebase/>
5 * Copyright 2001-2012 Strangecode, LLC
6 *
7 * This file is part of The Strangecode Codebase.
8 *
9 * The Strangecode Codebase is free software: you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License as published by the
11 * Free Software Foundation, either version 3 of the License, or (at your option)
12 * any later version.
13 *
14 * The Strangecode Codebase is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
16 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
17 * details.
18 *
19 * You should have received a copy of the GNU General Public License along with
20 * The Strangecode Codebase. If not, see <http://www.gnu.org/licenses/>.
21 */
22
23/*
24* The Auth_SQL class provides a SQL implementation for authentication.
25*
26* @author  Quinn Comendant <quinn@strangecode.com>
27* @version 2.1
28*/
29
30// Available encryption types for class Auth_SQL.
31define('AUTH_ENCRYPT_PLAINTEXT', 1);
32define('AUTH_ENCRYPT_CRYPT', 2);
33define('AUTH_ENCRYPT_SHA1', 3);
34define('AUTH_ENCRYPT_SHA1_HARDENED', 4);
35define('AUTH_ENCRYPT_MD5', 5);
36define('AUTH_ENCRYPT_MD5_HARDENED', 6);
37
38require_once dirname(__FILE__) . '/Email.inc.php';
39
40class Auth_SQL {
41       
42    // Namespace of this auth object.
43    var $_ns;
44   
45    // Static var for test.
46    var $_authentication_tested;
47
48    // Parameters to be configured by setParam.
49    var $_params = array();
50    var $_default_params = array(
51
52        // Automatically create table and verify columns. Better set to false after site launch.
53        // This value is overwritten by the $app->getParam('db_create_tables') setting if it is available.
54        'create_table' => true,
55
56        // The database table containing users to authenticate.
57        'db_table' => 'user_tbl',
58
59        // The name of the primary key for the db_table.
60        'db_primary_key' => 'user_id',
61
62        // The name of the username key for the db_table.
63        'db_username_column' => 'username',
64
65        // If using the db_login_table feature, specify the db_login_table. The primary key must match the primary key for the db_table.
66        'db_login_table' => 'user_login_tbl',
67
68        // The type of encryption to use for passwords stored in the db_table. Use one of the AUTH_ENCRYPT_* types specified above.
69        // Hardened password hashes rely on the same key/salt being used to compare encryptions.
70        // Be aware that when using one of the hardened types the App signing_key or $more_salt below cannot change!
71        'encryption_type' => AUTH_ENCRYPT_MD5,
72
73        // The URL to the login script.
74        'login_url' => '/',
75
76        // The maximum amount of time a user is allowed to be logged in. They will be forced to login again if they expire.
77        // In seconds. 21600 seconds = 6 hours.
78        'login_timeout' => 21600,
79
80        // The maximum amount of time a user is allowed to be idle before their session expires. They will be forced to login again if they expire.
81        // In seconds. 3600 seconds = 1 hour.
82        'idle_timeout' => 3600,
83
84        // The period of time to compare login abuse attempts. If a threshold of logins is reached in this amount of time the account is blocked.
85        // Days and hours, like this: 'DD:HH'
86        'login_abuse_timeframe' => '04:00',
87
88        // The number of warnings a user will receive (and their password reset each time) before their account is completely blocked.
89        'login_abuse_warnings' => 3,
90
91        // The maximum number of IP addresses a user can login with over the timeout period before their account is blocked.
92        'login_abuse_max_ips' => 5,
93
94        // The IP address subnet size threshold. Uses a CIDR notation network mask (see CIDR cheat-sheet at bottom).
95        // Any integer between 0 and 32 is permitted. Setting this to '24' permits any address in a
96        // class C network (255.255.255.0) to be considered the same. Setting to '32' compares each IP absolutely.
97        // Setting to '0' ignores all IPs, thus disabling login_abuse checking.
98        'login_abuse_ip_bitmask' => 32,
99
100        // Specify usernames to exclude from the account abuse detection system. This is specified as a hardcoded array provided at
101        // class instantiation time, or can be saved in the db_table under the login_abuse_exempt field.
102        'login_abuse_exempt_usernames' => array(),
103
104        // Specify usernames to exclude from remote_ip matching. Users behind proxy servers should be appended to this array so their shifting remote IP will not log them out.
105        'match_remote_ip_exempt_usernames' => array(),
106
107        // Match the user's current remote IP against the one they logged in with.
108        'match_remote_ip' => true,
109
110        // An array of IP blocks that are bypass the remote_ip comparison check. Useful for dynamic IPs or those behind proxy servers.
111        'trusted_networks' => array(),
112
113        // Allow user accounts to be blocked? Requires the user table to have the columns 'blocked' and 'blocked_reason'
114        'blocking' => false,
115
116        // Use a db_login_table to detect excessive logins. This requires blocking to be enabled.
117        'abuse_detection' => false,
118
119        // Allow users to save login form passwords in their browser? Setting to 'true' may pose a potential security risk.
120        'login_form_allow_autocomplete' => false,
121    );
122
123    /**
124     * Constructs a new authentication object.
125     *
126     * @access public
127     * @param optional array $params  A hash containing parameters.
128     */
129    function Auth_SQL($namespace='')
130    {
131        $app =& App::getInstance();
132       
133        $this->_ns = $namespace;
134       
135        // Initialize default parameters.
136        $this->setParam($this->_default_params);
137
138        // Get create tables config from global context.
139        if (!is_null($app->getParam('db_create_tables'))) {
140            $this->setParam(array('create_table' => $app->getParam('db_create_tables')));
141        }
142
143        if (!isset($_SESSION['_auth_sql'][$this->_ns])) {
144            $this->clear();
145        }
146    }
147
148    /**
149     * Setup the database tables for this class.
150     *
151     * @access  public
152     * @author  Quinn Comendant <quinn@strangecode.com>
153     * @since   26 Aug 2005 17:09:36
154     */
155    function initDB($recreate_db=false)
156    {
157        $app =& App::getInstance();
158        $db =& DB::getInstance();
159   
160   
161        static $_db_tested = false;
162
163        if ($recreate_db || !$_db_tested && $this->getParam('create_table')) {
164
165            // User table.
166            if ($recreate_db) {
167                $db->query("DROP TABLE IF EXISTS " . $this->getParam('db_table'));
168                $app->logMsg(sprintf('Dropping and recreating table %s.', $this->getParam('db_table')), LOG_INFO, __FILE__, __LINE__);
169            }
170
171            // The minimal columns for a table compatable with the Auth_SQL class.
172            $db->query("CREATE TABLE IF NOT EXISTS " . $db->escapeString($this->getParam('db_table')) . " (
173                " . $this->getParam('db_primary_key') . " smallint(11) NOT NULL auto_increment,
174                " . $this->getParam('db_username_column') . " varchar(255) NOT NULL default '',
175                userpass VARCHAR(255) NOT NULL DEFAULT '',
176                first_name VARCHAR(255) NOT NULL DEFAULT '',
177                last_name VARCHAR(255) NOT NULL DEFAULT '',
178                email VARCHAR(255) NOT NULL DEFAULT '',
179                login_abuse_exempt ENUM('TRUE') DEFAULT NULL,
180                blocked ENUM('TRUE') DEFAULT NULL,
181                blocked_reason VARCHAR(255) NOT NULL DEFAULT '',
182                abuse_warning_level TINYINT(4) NOT NULL DEFAULT '0',
183                seconds_online INT(11) NOT NULL DEFAULT '0',
184                last_login_datetime DATETIME NOT NULL DEFAULT '0000-00-00 00:00:00',
185                last_access_datetime DATETIME NOT NULL DEFAULT '0000-00-00 00:00:00',
186                last_login_ip VARCHAR(255) NOT NULL DEFAULT '0.0.0.0',
187                added_by_user_id SMALLINT(11) DEFAULT NULL,
188                modified_by_user_id SMALLINT(11) DEFAULT NULL,
189                added_datetime DATETIME NOT NULL DEFAULT '0000-00-00 00:00:00',
190                modified_datetime DATETIME NOT NULL DEFAULT '0000-00-00 00:00:00',
191                PRIMARY KEY (" . $this->getParam('db_primary_key') . "),
192                KEY " . $this->getParam('db_username_column') . " (" . $this->getParam('db_username_column') . "),
193                KEY userpass (userpass),
194                KEY email (email)
195            )");
196
197            if (!$db->columnExists($this->getParam('db_table'), array(
198                $this->getParam('db_primary_key'),
199                $this->getParam('db_username_column'),
200                'userpass',
201                'first_name',
202                'last_name',
203                'email',
204                'login_abuse_exempt',
205                'blocked',
206                'blocked_reason',
207                'abuse_warning_level',
208                'seconds_online',
209                'last_login_datetime',
210                'last_access_datetime',
211                'last_login_ip',
212                'added_by_user_id',
213                'modified_by_user_id',
214                'added_datetime',
215                'modified_datetime',
216            ), false, false)) {
217                $app->logMsg(sprintf('Database table %s has invalid columns. Please update this table manually.', $this->getParam('db_table')), LOG_ALERT, __FILE__, __LINE__);
218                trigger_error(sprintf('Database table %s has invalid columns. Please update this table manually.', $this->getParam('db_table')), E_USER_ERROR);
219            }
220
221            // Login table is used for abuse_detection features.
222            if ($this->getParam('abuse_detection')) {
223                if ($recreate_db) {
224                    $db->query("DROP TABLE IF EXISTS " . $this->getParam('db_login_table'));
225                    $app->logMsg(sprintf('Dropping and recreating table %s.', $this->getParam('db_login_table')), LOG_INFO, __FILE__, __LINE__);
226                }
227                $db->query("CREATE TABLE IF NOT EXISTS " . $this->getParam('db_login_table') . " (
228                    " . $this->getParam('db_primary_key') . " SMALLINT(11) NOT NULL DEFAULT '0',
229                    login_datetime DATETIME NOT NULL DEFAULT '0000-00-00 00:00:00',
230                    remote_ip_binary CHAR(32) NOT NULL DEFAULT '',
231                    KEY " . $this->getParam('db_primary_key') . " (" . $this->getParam('db_primary_key') . "),
232                    KEY login_datetime (login_datetime),
233                    KEY remote_ip_binary (remote_ip_binary)
234                )");
235
236                if (!$db->columnExists($this->getParam('db_login_table'), array(
237                    $this->getParam('db_primary_key'),
238                    'login_datetime',
239                    'remote_ip_binary',
240                ), false, false)) {
241                    $app->logMsg(sprintf('Database table %s has invalid columns. Please update this table manually.', $this->getParam('db_login_table')), LOG_ALERT, __FILE__, __LINE__);
242                    trigger_error(sprintf('Database table %s has invalid columns. Please update this table manually.', $this->getParam('db_login_table')), E_USER_ERROR);
243                }
244            }
245        }
246        $_db_tested = true;
247    }
248
249    /**
250     * Set the params of an auth object.
251     *
252     * @param  array $params   Array of parameter keys and value to set.
253     * @return bool true on success, false on failure
254     */
255    function setParam($params)
256    {
257        if (isset($params['match_remote_ip_exempt_usernames'])) {
258            $params['match_remote_ip_exempt_usernames'] = array_map('strtolower', $params['match_remote_ip_exempt_usernames']);
259        }
260        if (isset($params['login_abuse_exempt_usernames'])) {
261            $params['login_abuse_exempt_usernames'] = array_map('strtolower', $params['login_abuse_exempt_usernames']);
262        }
263        if (isset($params) && is_array($params)) {
264            // Merge new parameters with old overriding only those passed.
265            $this->_params = array_merge($this->_params, $params);
266        }
267    }
268
269    /**
270     * Return the value of a parameter, if it exists.
271     *
272     * @access public
273     * @param string $param        Which parameter to return.
274     * @return mixed               Configured parameter value.
275     */
276    function getParam($param)
277    {
278        $app =& App::getInstance();
279   
280        if (isset($this->_params[$param])) {
281            return $this->_params[$param];
282        } else {
283            $app->logMsg(sprintf('Parameter is not set: %s', $param), LOG_DEBUG, __FILE__, __LINE__);
284            return null;
285        }
286    }
287
288    /**
289     * Clear any authentication tokens in the current session. A.K.A. logout.
290     *
291     * @access public
292     */
293    function clear()
294    {
295        $db =& DB::getInstance();
296   
297        $this->initDB();
298
299        if ($this->get('user_id', false)) {
300            // FIX ME: Should we check if the session is active?
301            $db->query("
302                UPDATE " . $this->_params['db_table'] . " SET
303                seconds_online = seconds_online + (UNIX_TIMESTAMP() - UNIX_TIMESTAMP(last_access_datetime)),
304                last_login_datetime = '0000-00-00 00:00:00'
305                WHERE " . $this->_params['db_primary_key'] . " = '" . $this->get('user_id') . "'
306            ");
307        }
308        $_SESSION['_auth_sql'][$this->_ns] = array(
309            'authenticated'         => false,
310            'user_id'               => null,
311            'username'              => null,
312            'login_datetime'        => null,
313            'last_access_datetime'  => null,
314            'remote_ip'             => getRemoteAddr(),
315            'login_abuse_exempt'    => null,
316            'match_remote_ip_exempt'=> null,
317            'user_data'             => null,
318        );
319    }
320
321    /**
322     * Sets a variable into a registered auth session.
323     *
324     * @access public
325     * @param mixed $key      Which value to set.
326     * @param mixed $val      Value to set variable to.
327     */
328    function set($key, $val)
329    {
330        if (!isset($_SESSION['_auth_sql'][$this->_ns]['user_data'])) {
331            $_SESSION['_auth_sql'][$this->_ns]['user_data'] = array();
332        }
333        $_SESSION['_auth_sql'][$this->_ns]['user_data'][$key] = $val;
334    }
335
336    /**
337     * Returns a specified value from a registered auth session.
338     *
339     * @access public
340     * @param mixed $key      Which value to return.
341     * @param mixed $default  Value to return if key not found in user_data.
342     * @return mixed          Value stored in session.
343     */
344    function get($key, $default='')
345    {
346        if (isset($_SESSION['_auth_sql'][$this->_ns][$key])) {
347            return $_SESSION['_auth_sql'][$this->_ns][$key];
348        } else if (isset($_SESSION['_auth_sql'][$this->_ns]['user_data'][$key])) {
349            return $_SESSION['_auth_sql'][$this->_ns]['user_data'][$key];
350        } else {
351            return $default;
352        }
353    }
354
355    /**
356     * Find out if a set of login credentials are valid.
357     *
358     * @access private
359     * @param string $username      The username to check.
360     * @param string $password      The password to compare to username.
361     * @return mixed  False if credentials not found in DB, or returns DB row matching credentials.
362     */
363    function authenticate($username, $password)
364    {
365        $app =& App::getInstance();
366        $db =& DB::getInstance();
367
368        $this->initDB();
369
370        switch ($this->_params['encryption_type']) {
371        case AUTH_ENCRYPT_CRYPT :
372            // Query DB for user matching credentials. Compare cyphertext with salted-encrypted password.
373            $qid = $db->query("
374                SELECT *, " . $this->_params['db_primary_key'] . " AS user_id
375                FROM " . $this->_params['db_table'] . "
376                WHERE " . $this->_params['db_username_column'] . " = '" . $db->escapeString($username) . "'
377                AND BINARY userpass = ENCRYPT('" . $db->escapeString($password) . "', LEFT(userpass, 2)))
378            ");
379            break;
380        case AUTH_ENCRYPT_PLAINTEXT :
381        case AUTH_ENCRYPT_MD5 :
382        case AUTH_ENCRYPT_SHA1 :
383        default :
384            // Query DB for user matching credentials. Directly compare cyphertext with result from encryptPassword().
385            $qid = $db->query("
386                SELECT *, " . $this->_params['db_primary_key'] . " AS user_id
387                FROM " . $this->_params['db_table'] . "
388                WHERE " . $this->_params['db_username_column'] . " = '" . $db->escapeString($username) . "'
389                AND BINARY userpass = '" . $db->escapeString($this->encryptPassword($password)) . "'
390            ");
391            break;
392        }
393
394        // Return user data if found.
395        if ($user_data = mysql_fetch_assoc($qid)) {
396            // Don't return password value.
397            unset($user_data['userpass']);
398            $app->logMsg(sprintf('Authentication successful for user_id %s (%s)', $user_data['user_id'], $username), LOG_INFO, __FILE__, __LINE__);
399            return $user_data;
400        } else {
401            $app->logMsg(sprintf('Authentication failed for username %s (encrypted attempted password: %s)', $username, $this->encryptPassword($password)), LOG_NOTICE, __FILE__, __LINE__);
402            return false;
403        }
404    }
405
406    /**
407     * If user authenticated, register login into session.
408     *
409     * @access private
410     * @param string $username     The username to check.
411     * @param string $password     The password to compare to username.
412     * @return boolean  Whether or not the credentials are valid.
413     */
414    function login($username, $password)
415    {
416        $app =& App::getInstance();
417        $db =& DB::getInstance();
418   
419        $this->initDB();
420
421        $this->clear();
422
423        if (!$user_data = $this->authenticate($username, $password)) {
424            // No login: failed authentication!
425            return false;
426        }
427       
428        // Convert 'priv' to 'user_type' nomenclature.
429        if (isset($user_data['priv'])) {
430            $user_data['user_type'] = $user_data['priv'];
431        }
432
433        // Register authenticated session.
434        $_SESSION['_auth_sql'][$this->_ns] = array(
435            'authenticated'         => true,
436            'user_id'               => $user_data['user_id'],
437            'username'              => $username,
438            'login_datetime'        => date('Y-m-d H:i:s'),
439            'last_access_datetime'  => date('Y-m-d H:i:s'),
440            'remote_ip'             => getRemoteAddr(),
441            'login_abuse_exempt'    => isset($user_data['login_abuse_exempt']) ? !empty($user_data['login_abuse_exempt']) : in_array(strtolower($username), $this->_params['login_abuse_exempt_usernames']),
442            'match_remote_ip_exempt'=> isset($user_data['match_remote_ip_exempt']) ? !empty($user_data['match_remote_ip_exempt']) : in_array(strtolower($username), $this->_params['match_remote_ip_exempt_usernames']),
443            'user_data'             => $user_data
444        );
445
446        /**
447         * Check if the account is blocked, respond in context to reason. Cancel the login if blocked.
448         */
449        if ($this->getParam('blocking')) {
450            if (!empty($user_data['blocked'])) {
451
452                $app->logMsg(sprintf('User_id %s (%s) login failed due to blocked account: %s', $this->get('user_id'), $this->get('username'), $this->get('blocked_reason')), LOG_NOTICE, __FILE__, __LINE__);
453
454                switch ($user_data['blocked_reason']) {
455                    case 'account abuse' :
456                        $app->raiseMsg(sprintf(_("This account has been blocked due to possible account abuse. Please contact us to reactivate."), null), MSG_WARNING, __FILE__, __LINE__);
457                        break;
458                    default :
459                        $app->raiseMsg(sprintf(_("This account is currently not active. %s"), $user_data['blocked_reason']), MSG_WARNING, __FILE__, __LINE__);
460                        break;
461                }
462
463                // No login: user is blocked!
464                $this->clear();
465                return false;
466            }
467        }
468
469        /**
470         * Check the db_login_table for too many logins under this account.
471         * (1) Count the number of unique IP addresses that logged in under this user within the login_abuse_timeframe
472         * (2) If this number exceeds the login_abuse_max_ips, assume multiple people are logging in under the same account.
473        **/
474        if ($this->getParam('abuse_detection') && !$this->get('login_abuse_exempt')) {
475            $qid = $db->query("
476                SELECT COUNT(DISTINCT LEFT(remote_ip_binary, " . $this->_params['login_abuse_ip_bitmask'] . "))
477                FROM " . $this->_params['db_login_table'] . "
478                WHERE " . $this->_params['db_primary_key'] . " = '" . $this->get('user_id') . "'
479                AND DATE_ADD(login_datetime, INTERVAL '" . $this->_params['login_abuse_timeframe'] . "' DAY_HOUR) > NOW()
480            ");
481            list($distinct_ips) = mysql_fetch_row($qid);
482            if ($distinct_ips > $this->_params['login_abuse_max_ips']) {
483                if ($this->get('abuse_warning_level') < $this->_params['login_abuse_warnings']) {
484                    // Warn the user with a password reset.
485                    $this->resetPassword(null, _("This is a security precaution. We have detected this account has been accessed from multiple computers simultaneously. It is against policy to share login information with others. If further account abuse is detected this account will be blocked."));
486                    $app->raiseMsg(_("Your password has been reset as a security precaution. Please check your email for more information."), MSG_NOTICE, __FILE__, __LINE__);
487                    $app->logMsg(sprintf('Account abuse detected for user_id %s (%s) from IP %s', $this->get('user_id'), $this->get('username'), $this->get('remote_ip')), LOG_WARNING, __FILE__, __LINE__);
488                } else {
489                    // Block the account with the reason of account abuse.
490                    $this->blockAccount(null, 'account abuse');
491                    $app->raiseMsg(_("Your account has been blocked as a security precaution. Please contact us for more information."), MSG_NOTICE, __FILE__, __LINE__);
492                    $app->logMsg(sprintf('Account blocked for user_id %s (%s) from IP %s', $this->get('user_id'), $this->get('username'), $this->get('remote_ip')), LOG_ALERT, __FILE__, __LINE__);
493                }
494                // Increment user's warning level.
495                $db->query("UPDATE " . $this->_params['db_table'] . " SET abuse_warning_level = abuse_warning_level + 1 WHERE " . $this->_params['db_primary_key'] . " = '" . $this->get('user_id') . "'");
496                // Reset the login counter for this user.
497                $db->query("DELETE FROM " . $this->_params['db_login_table'] . " WHERE " . $this->_params['db_primary_key'] . " = '" . $this->get('user_id') . "'");
498                // No login: reset password because of account abuse!
499                $this->clear();
500                return false;
501            }
502
503            // Update the login counter table with this login access. Convert IP to binary.
504            // TODO: after MySQL 5.0.23 is released this query could benefit from INSERT DELAYED.
505            $db->query("
506                INSERT INTO " . $this->_params['db_login_table'] . " (
507                    " . $this->_params['db_primary_key'] . ",
508                    login_datetime,
509                    remote_ip_binary
510                ) VALUES (
511                    '" . $this->get('user_id') . "',
512                    '" . $this->get('login_datetime') . "',
513                    '" . sprintf('%032b', ip2long($this->get('remote_ip'))) . "'
514                )
515            ");
516        }
517
518        // Update user table with this login.
519        $db->query("
520            UPDATE " . $this->_params['db_table'] . " SET
521                last_login_datetime = '" . $this->get('login_datetime') . "',
522                last_access_datetime = '" . $this->get('login_datetime') . "',
523                last_login_ip = '" . $this->get('remote_ip') . "'
524            WHERE " . $this->_params['db_primary_key'] . " = '" . $this->get('user_id') . "'
525        ");
526
527        // We're logged-in!
528        return true;
529    }
530
531    /**
532     * Test if user has a currently logged-in session.
533     *  - authentication flag set to true
534     *  - username not empty
535     *  - total logged-in time is not greater than login_timeout
536     *  - idle time is not greater than idle_timeout
537     *  - remote address is the same as the login remote address (aol users excluded).
538     *
539     * @access public
540     */
541    function isLoggedIn($user_id=null)
542    {
543        $app =& App::getInstance();
544        $db =& DB::getInstance();
545
546        $this->initDB();
547
548        if (isset($user_id)) {
549            // Check the login status of a specific user.
550            $qid = $db->query("
551                SELECT 1 FROM " . $this->_params['db_table'] . "
552                WHERE " . $this->_params['db_primary_key'] . " = '" . $db->escapeString($user_id) . "'
553                AND DATE_ADD(last_login_datetime, INTERVAL '" . $this->_params['login_timeout'] . "' SECOND) > NOW()
554                AND DATE_ADD(last_access_datetime, INTERVAL '" . $this->_params['idle_timeout'] . "' SECOND) > NOW()
555            ");
556            $login_status = (mysql_num_rows($qid) > 0);
557            $app->logMsg(sprintf('Returning %s login status for user_id %s', ($login_status ? 'true' : 'false'), $user_id), LOG_DEBUG, __FILE__, __LINE__);
558            return $login_status;
559        }
560
561        // User login test need only be run once per script execution. We cache the result in the session.
562        if ($this->_authentication_tested && isset($_SESSION['_auth_sql'][$this->_ns]['authenticated'])) {
563            $app->logMsg(sprintf('Returning cached authentication status: %s', ($_SESSION['_auth_sql'][$this->_ns]['authenticated'] ? 'true' : 'false')), LOG_DEBUG, __FILE__, __LINE__);
564            return $_SESSION['_auth_sql'][$this->_ns]['authenticated'];
565        }
566
567        // Tesing login should occur once. This is the first time. Set flag.
568        $this->_authentication_tested = true;
569
570        // Some users will access from networks with a changing IP number (i.e. behind a proxy server).
571        // These users must be allowed entry by adding their IP to the list of trusted_networks, or their usernames to the list of match_remote_ip_exempt_usernames.
572        if ($trusted_net = ipInRange(getRemoteAddr(), $this->_params['trusted_networks'])) {
573            $user_in_trusted_network = true;
574            $app->logMsg(sprintf('User_id %s accessing from trusted network %s',
575                ($this->get('user_id') ? $this->get('user_id') . ' (' .  $this->get('username') . ')' : 'unknown'),
576                $trusted_net
577            ), LOG_DEBUG, __FILE__, __LINE__);
578        } else if (preg_match('/proxy.aol.com$/i', getRemoteAddr(true))) {
579            $user_in_trusted_network = true;
580            $app->logMsg(sprintf('User_id %s accessing from trusted network proxy.aol.com',
581                ($this->get('user_id') ? $this->get('user_id') . ' (' .  $this->get('username') . ')' : 'unknown')
582            ), LOG_DEBUG, __FILE__, __LINE__);
583        } else {
584            $user_in_trusted_network = false;
585        }
586       
587        // Do we match the user's remote IP at all? Yes, if set in config and not disabled for specific user.
588        if ($this->getParam('match_remote_ip') && !$this->get('match_remote_ip_exempt')) {
589            $remote_ip_is_matched = (isset($_SESSION['_auth_sql'][$this->_ns]['remote_ip']) && $_SESSION['_auth_sql'][$this->_ns]['remote_ip'] == getRemoteAddr()) || $user_in_trusted_network;
590        } else {
591            $app->logMsg(sprintf('User_id %s exempt from remote_ip match (comparing %s == %s)', 
592                ($this->get('user_id') ? $this->get('user_id') . ' (' .  $this->get('username') . ')' : 'unknown'),
593                $_SESSION['_auth_sql'][$this->_ns]['remote_ip'],
594                getRemoteAddr()
595            ), LOG_DEBUG, __FILE__, __LINE__);
596            $remote_ip_is_matched = true;
597        }
598
599        // Test login with information stored in session. Skip IP matching for users from trusted networks.
600        if (isset($_SESSION['_auth_sql'][$this->_ns]['authenticated']) 
601            && true === $_SESSION['_auth_sql'][$this->_ns]['authenticated']
602            && isset($_SESSION['_auth_sql'][$this->_ns]['username'])
603            && !empty($_SESSION['_auth_sql'][$this->_ns]['username'])
604            && isset($_SESSION['_auth_sql'][$this->_ns]['login_datetime'])
605            && strtotime($_SESSION['_auth_sql'][$this->_ns]['login_datetime']) > time() - $this->_params['login_timeout']
606            && isset($_SESSION['_auth_sql'][$this->_ns]['last_access_datetime'])
607            && strtotime($_SESSION['_auth_sql'][$this->_ns]['last_access_datetime']) > time() - $this->_params['idle_timeout']
608            && $remote_ip_is_matched
609        ) {
610            // User is authenticated!
611            $_SESSION['_auth_sql'][$this->_ns]['last_access_datetime'] = date('Y-m-d H:i:s');
612
613            // Update the DB with the last_access_datetime and increment the seconds_online.
614            $db->query("
615                UPDATE " . $this->_params['db_table'] . " SET
616                seconds_online = seconds_online + (UNIX_TIMESTAMP() - UNIX_TIMESTAMP(last_access_datetime)) + 1,
617                last_access_datetime = '" . $this->get('last_access_datetime') . "'
618                WHERE " . $this->_params['db_primary_key'] . " = '" . $this->get('user_id') . "'
619            ");
620            if (mysql_affected_rows($db->getDBH()) > 0) {
621                // User record still exists in DB. Do this to ensure user was not delete from DB between accesses. Notice "+ 1" in SQL above to ensure record is modified.
622                return true;
623            } else {
624                $app->logMsg(sprintf('Session update failed; record not found for user_id %s (%s).', $this->get('user_id'), $this->get('username')), LOG_NOTICE, __FILE__, __LINE__);
625            }
626        } else if (isset($_SESSION['_auth_sql'][$this->_ns]['authenticated']) && true === $_SESSION['_auth_sql'][$this->_ns]['authenticated']) {
627            // User is authenticated, but login has expired.
628            if (strtotime($_SESSION['_auth_sql'][$this->_ns]['last_access_datetime']) > time() - 43200) {
629                // Only raise message if last session is less than 12 hours old.
630                $app->raiseMsg(_("Your session has expired. You need to log-in again."), MSG_NOTICE, __FILE__, __LINE__);
631            }
632
633            // Log the reason for login expiration.
634            $expire_reasons = array();
635            if (empty($_SESSION['_auth_sql'][$this->_ns]['username'])) {
636                $expire_reasons[] = 'username not found';
637            }
638            if (strtotime($_SESSION['_auth_sql'][$this->_ns]['login_datetime']) <= time() - $this->_params['login_timeout']) {
639                $expire_reasons[] = sprintf('login_timeout expired (%s older than %s seconds ago)', $_SESSION['_auth_sql'][$this->_ns]['login_datetime'], $this->_params['login_timeout']);
640            }
641            if (strtotime($_SESSION['_auth_sql'][$this->_ns]['last_access_datetime']) <= time() - $this->_params['idle_timeout']) {
642                $expire_reasons[] = sprintf('idle_timeout expired (%s older than %s seconds ago)', $_SESSION['_auth_sql'][$this->_ns]['last_access_datetime'], $this->_params['idle_timeout']);
643            }
644            if ($_SESSION['_auth_sql'][$this->_ns]['remote_ip'] != getRemoteAddr()) {
645                if ($this->getParam('match_remote_ip') && !$this->get('match_remote_ip_exempt') && !$user_in_trusted_network) {
646                    // There are three cases when a remote IP match will be the cause of a session termination:
647                    //   1. match_remote_ip config is enabled
648                    //   2. user is not match_remote_ip_exempt (set in the user_data, or in the match_remote_ip_exempt_usernames list)
649                    //   3. the user is connecting from a trusted network (their IP is listed in the trusted_networks or from *.proxy.aol.com)
650                    $expire_reasons[] = sprintf('remote_ip not matched (%s != %s)', $_SESSION['_auth_sql'][$this->_ns]['remote_ip'], getRemoteAddr());
651                } else {
652                    $expire_reasons[] = sprintf('remote_ip not matched but user was exempt from this check (%s != %s)', $_SESSION['_auth_sql'][$this->_ns]['remote_ip'], getRemoteAddr());
653                }
654            }
655            $app->logMsg(sprintf('User_id %s (%s) session expired: %s', $this->get('user_id'), $this->get('username'), join(', ', $expire_reasons)), LOG_INFO, __FILE__, __LINE__);
656        } else {
657            $app->logMsg(sprintf('Session not authenticated: %s', getDump($_SESSION['_auth_sql'][$this->_ns])), LOG_DEBUG, __FILE__, __LINE__);
658        }
659
660        // User is not authenticated.
661        $this->clear();
662        return false;
663    }
664
665    /**
666     * Redirect user to login page if they are not logged in.
667     *
668     * @param string $message The text description of a message to raise.
669     * @param int    $type    The type of message: MSG_NOTICE,
670     *                        MSG_SUCCESS, MSG_WARNING, or MSG_ERR.
671     * @param string $file    __FILE__.
672     * @param string $line    __LINE__.
673     * @access public
674     */
675    function requireLogin($message='', $type=MSG_NOTICE, $file=null, $line=null)
676    {
677        $app =& App::getInstance();
678   
679        if (!$this->isLoggedIn()) {
680            // Display message for requiring login. (RaiseMsg will ignore empty strings.)
681            if ('' != $message) {
682                $app->raiseMsg($message, $type, $file, $line);
683            }
684
685            // Login scripts must have the same 'login' tag for boomerangURL verification/manipulation.
686            $app->setBoomerangURL(absoluteMe(), 'login');
687            $app->dieURL($this->_params['login_url']);
688        }
689    }
690
691    /**
692     * This sets the 'blocked' field for a user in the db_table, and also
693     * adds an optional reason
694     *
695     * @param  string   $reason      The reason for blocking the account.
696     */
697    function blockAccount($user_id=null, $reason='')
698    {
699        $app =& App::getInstance();
700        $db =& DB::getInstance();
701   
702        $this->initDB();
703
704        if ($this->getParam('blocking')) {
705            if (mb_strlen($db->escapeString($reason)) > 255) {
706                // blocked_reason field is varchar(255).
707                $app->logMsg(sprintf('Blocked reason provided is greater than 255 characters: %s', $reason), LOG_WARNING, __FILE__, __LINE__);
708            }
709
710            // Get user_id if specified.
711            $user_id = isset($user_id) ? $user_id : $this->get('user_id');
712            $db->query("
713                UPDATE " . $this->_params['db_table'] . " SET
714                blocked = 'true',
715                blocked_reason = '" . $db->escapeString($reason) . "'
716                WHERE " . $this->_params['db_primary_key'] . " = '" . $db->escapeString($user_id) . "'
717            ");
718        }
719    }
720
721    /**
722     * Tests if the "blocked" flag is set for a user.
723     *
724     * @param  int      $user_id    User id to look for.
725     * @return boolean              True if the user is blocked, false otherwise.
726     */
727    function isBlocked($user_id=null)
728    {
729        $db =& DB::getInstance();
730
731        $this->initDB();
732
733        if ($this->getParam('blocking')) {
734            // Get user_id if specified.
735            $user_id = isset($user_id) ? $user_id : $this->getVal('user_id');
736            $qid = $db->query("
737                SELECT 1
738                FROM " . $this->_params['db_table'] . "
739                WHERE blocked = 'true'
740                AND " . $this->_params['db_primary_key'] . " = '" . $db->escapeString($user_id) . "'
741            ");
742            return mysql_num_rows($qid) === 1;
743        }
744    }
745
746    /**
747     * Unblocks a user in the db_table, and clears any blocked_reason.
748     */
749    function unblockAccount($user_id=null)
750    {
751        $db =& DB::getInstance();
752   
753        $this->initDB();
754   
755        if ($this->getParam('blocking')) {
756            // Get user_id if specified.
757            $user_id = isset($user_id) ? $user_id : $this->get('user_id');
758            $db->query("
759                UPDATE " . $this->_params['db_table'] . " SET
760                blocked = '',
761                blocked_reason = ''
762                WHERE " . $this->_params['db_primary_key'] . " = '" . $db->escapeString($user_id) . "'
763            ");
764        }
765    }
766
767    /**
768     * Returns true if username already exists in database.
769     *
770     * @param  string  $username    Username to look for.
771     * @return bool                 True if username exists.
772     */
773    function usernameExists($username)
774    {
775        $db =& DB::getInstance();
776   
777        $this->initDB();
778
779        $qid = $db->query("
780            SELECT 1
781            FROM " . $this->_params['db_table'] . "
782            WHERE " . $this->_params['db_username_column'] . " = '" . $db->escapeString($username) . "'
783        ");
784        return (mysql_num_rows($qid) > 0);
785    }
786
787    /**
788     * Returns a username for a specified user id.
789     *
790     * @param  string  $user_id     User id to look for.
791     * @return string               Username, or false if none found.
792     */
793    function getUsername($user_id)
794    {
795        $db =& DB::getInstance();
796   
797        $this->initDB();
798
799        $qid = $db->query("
800            SELECT " . $this->_params['db_username_column'] . "
801            FROM " . $this->_params['db_table'] . "
802            WHERE " . $this->_params['db_primary_key'] . " = '" . $db->escapeString($user_id) . "'
803        ");
804        if (list($username) = mysql_fetch_row($qid)) {
805            return $username;
806        } else {
807            return false;
808        }
809    }
810
811    /**
812     * Returns a randomly generated password based on $pattern. The pattern is any
813     * sequence of 'x', 'V', 'C', 'v', 'c', or 'd' and if it is something like 'cvccv' this
814     * function will generate a pronounceable password. Recommend using more complex
815     * patterns, at minimum the US State Department standard: cvcddcvc.
816     *
817     * - x    a random upper or lower alpha character or digit
818     * - C    a random upper or lower consonant
819     * - V    a random upper or lower vowel
820     * - c    a random lowercase consonant
821     * - v    a random lowercase vowel
822     * - d    a random digit
823     *
824     * @param  string $pattern  a sequence of character types, above.
825     * @return string           a password
826     */
827    function generatePassword($pattern='CvcdCvc')
828    {
829        $app =& App::getInstance();
830        if (preg_match('/[^xCVcvd]/', $pattern)) {
831            $app->logMsg(sprintf('Invalid pattern: %s', $pattern), LOG_WARNING, __FILE__, __LINE__);
832            $pattern='CvcdCvc';
833        }
834        $str = '';
835        for ($i=0; $i<mb_strlen($pattern); $i++) {
836            $x = mb_substr('bcdfghjklmnprstvwxzBCDFGHJKLMNPRSTVWXZaeiouyAEIOUY0123456789!@#%&*-=+.?', (mt_rand() % 71), 1);
837            $c = mb_substr('bcdfghjklmnprstvwxz', (mt_rand() % 19), 1);
838            $C = mb_substr('bcdfghjklmnprstvwxzBCDFGHJKLMNPRSTVWXZ', (mt_rand() % 38), 1);
839            $v = mb_substr('aeiouy', (mt_rand() % 6), 1);
840            $V = mb_substr('aeiouyAEIOUY', (mt_rand() % 12), 1);
841            $d = mb_substr('0123456789', (mt_rand() % 10), 1);
842            $str .= $$pattern[$i];
843        }
844        return $str;
845    }
846
847    /**
848     *
849     */
850    function encryptPassword($password, $salt=null)
851    {
852        $app =& App::getInstance();
853       
854        // Existing password hashes rely on the same key/salt being used to compare encryptions.
855        // Don't change this (or the value applied to signing_key) unless you know existing hashes or signatures will not be affected!
856        $more_salt = 'B36D18E5-3FE4-4D58-8150-F26642852B81';
857       
858        switch ($this->_params['encryption_type']) {
859        case AUTH_ENCRYPT_PLAINTEXT :
860            return $password;
861            break;
862
863        case AUTH_ENCRYPT_CRYPT :
864            // If comparing plaintext password with a hash, provide first two chars of the hash as the salt.
865            return isset($salt) ? crypt($password, mb_substr($salt, 0, 2)) : crypt($password);
866            break;
867
868        case AUTH_ENCRYPT_SHA1 :
869            return sha1($password);
870            break;
871
872        case AUTH_ENCRYPT_SHA1_HARDENED :
873            $hash = sha1($app->getParam('signing_key') . $password . $more_salt);
874            // Increase key strength by 12 bits.
875            for ($i=0; $i < 4096; $i++) { 
876                $hash = sha1($hash); 
877            } 
878            return $hash;
879            break;
880
881        case AUTH_ENCRYPT_MD5 :
882            return md5($password);
883            break;
884
885        case AUTH_ENCRYPT_MD5_HARDENED :
886            // Include salt to improve hash
887            $hash = md5($app->getParam('signing_key') . $password . $more_salt);
888            // Increase key strength by 12 bits.
889            for ($i=0; $i < 4096; $i++) { 
890                $hash = md5($hash); 
891            } 
892            return $hash;
893            break;
894
895        default :
896            $app->logMsg(sprintf('Authentication encrypt type specified is unrecognized: %s', $this->_params['encryption_type']), LOG_NOTICE, __FILE__, __LINE__);
897            return false;
898            break;
899        }
900    }
901
902    /**
903     *
904     */
905    function setPassword($user_id=null, $password)
906    {
907        $app =& App::getInstance();
908        $db =& DB::getInstance();
909   
910        $this->initDB();
911
912        // Get user_id if specified.
913        $user_id = isset($user_id) ? $user_id : $this->get('user_id');
914
915        // Get old password.
916        $qid = $db->query("
917            SELECT userpass
918            FROM " . $this->_params['db_table'] . "
919            WHERE " . $this->_params['db_primary_key'] . " = '" . $db->escapeString($user_id) . "'
920        ");
921        if (!list($old_encrypted_password) = mysql_fetch_row($qid)) {
922            $app->logMsg(sprintf('Cannot set password for nonexistent user_id %s', $user_id), LOG_NOTICE, __FILE__, __LINE__);
923            return false;
924        }
925       
926        // Compare old with new to ensure we're actually *changing* the password.
927        $encrypted_password = $this->encryptPassword($password);
928        if ($old_encrypted_password == $encrypted_password) {
929            $app->logMsg(sprintf('Not setting password: new is the same as old.', null), LOG_INFO, __FILE__, __LINE__);
930            return false;
931        }
932
933        // Issue the password change query.
934        $db->query("
935            UPDATE " . $this->_params['db_table'] . "
936            SET userpass = '" . $db->escapeString($encrypted_password) . "'
937            WHERE " . $this->_params['db_primary_key'] . " = '" . $db->escapeString($user_id) . "'
938        ");
939       
940        if (mysql_affected_rows($db->getDBH()) != 1) {
941            $app->logMsg(sprintf('Failed to update password for user_id %s', $user_id), LOG_WARNING, __FILE__, __LINE__);
942            return false;
943        }
944       
945        return true;
946    }
947
948    /**
949     * Resets the password for the user with the specified id.
950     *
951     * @param  string $user_id   The id of the user to reset.
952     * @param  string $reason    Additional message to add to the reset email.
953     * @return string            The user's new password.
954     */
955    function resetPassword($user_id=null, $reason='')
956    {
957        $app =& App::getInstance();
958        $db =& DB::getInstance();
959   
960        $this->initDB();
961
962        // Get user_id if specified.
963        $user_id = isset($user_id) ? $user_id : $this->get('user_id');
964
965        // Reset password of a specific user.
966        $qid = $db->query("
967            SELECT * FROM " . $this->_params['db_table'] . "
968            WHERE " . $this->_params['db_primary_key'] . " = '" . $db->escapeString($user_id) . "'
969        ");
970        if (!$user_data = mysql_fetch_assoc($qid)) {
971            $app->logMsg(sprintf('Reset password failed. User_id %s not found.', $user_id), LOG_NOTICE, __FILE__, __LINE__);
972            return false;
973        }
974
975        // Get new password.
976        $password = $this->generatePassword();
977
978        // Update password query.
979        $this->setPassword($user_id, $password);
980
981        // Make sure user has an email on record before continuing.
982        if (!isset($user_data['email']) || '' == trim($user_data['email'])) {
983            $app->logMsg(sprintf('Password reset but notification failed, no email address for user_id %s (%s).', $user_data[$this->_params['db_primary_key']], $user_data[$this->_params['db_username_column']]), LOG_NOTICE, __FILE__, __LINE__);
984        } else {
985            // Send the new password in an email.
986            $email = new Email(array(
987                'to' => $user_data['email'],
988                'from' => sprintf('%s <%s>', $app->getParam('site_name'), $app->getParam('site_email')),
989                'subject' => sprintf('%s password change', $app->getParam('site_name'))
990            ));
991            $email->setTemplate('codebase/services/templates/email_reset_password.txt');
992            $email->replace(array(
993                'SITE_NAME' => $app->getParam('site_name'),
994                'SITE_URL' => $app->getParam('site_url'),
995                'SITE_EMAIL' => $app->getParam('site_email'),
996                'NAME' => ('' != $user_data['first_name'] . $user_data['last_name'] ? $user_data['first_name'] . ' ' . $user_data['last_name'] : $user_data[$this->_params['db_username_column']]),
997                'USERNAME' => $user_data[$this->_params['db_username_column']],
998                'PASSWORD' => $password,
999                'REASON' => ('' == trim($reason) ? '' : trim($reason) . ' '), // Add a space after the reason if it exists for better formatting.
1000            ));
1001            $email->send();
1002        }
1003
1004        return array(
1005            'username' => $user_data[$this->_params['db_username_column']],
1006            'userpass' => $password
1007        );
1008    }
1009
1010    /**
1011     * If the current user has access to the specified $security_zone, return true.
1012     * If the optional $user_type is supplied, test that against the zone.
1013     *
1014     * NOTE: "user_type" used to be called "priv" in some older implementations.
1015     *
1016     * @param  constant $security_zone   string of comma delimited privileges for the zone
1017     * @param  string   $user_type       a privilege that might be found in a zone
1018     * @return bool     true if user is a member of security zone, false otherwise
1019     */
1020    function inClearanceZone($security_zone, $user_type='')
1021    {
1022        // return true; /// WTF?
1023        $zone_members = preg_split('/,\s*/', $security_zone);
1024        $user_type = empty($user_type) ? $this->get('user_type') : $user_type;
1025
1026        // If the current user's privilege level is NOT in that array or if the
1027        // user has no privilege, return false. Otherwise the user is clear.
1028        if (!in_array($user_type, $zone_members) || empty($user_type)) {
1029            return false;
1030        } else {
1031            return true;
1032        }
1033    }
1034
1035    /**
1036     * This function tests a list of arguments $security_zone against the priv that the current user has.
1037     * If the user doesn't have one of the supplied privs, die.
1038     *
1039     * NOTE: "user_type" used to be called "priv" in some older implementations.
1040     *
1041     * @param  constant $security_zone   string of comma delimited privileges for the zone
1042     */
1043    function requireAccessClearance($security_zone, $message='')
1044    {
1045        $app =& App::getInstance();
1046   
1047        // return true; /// WTF?
1048        $zone_members = preg_split('/,\s*/', $security_zone);
1049
1050        /* If the current user's privilege level is NOT in that array or if the
1051         * user has no privilege, DIE with a message. */
1052        if (!in_array($this->get('user_type'), $zone_members) || !$this->get('user_type')) {
1053            $message = empty($message) ? _("You have insufficient privileges to view that page.") : $message;
1054            $app->raiseMsg($message, MSG_NOTICE, __FILE__, __LINE__);
1055            $app->dieBoomerangURL();
1056        }
1057    }
1058
1059} // end class
1060
1061// CIDR cheat-sheet
1062//
1063// Netmask              Netmask (binary)                 CIDR     Notes
1064// _____________________________________________________________________________
1065// 255.255.255.255  11111111.11111111.11111111.11111111  /32  Host (single addr)
1066// 255.255.255.254  11111111.11111111.11111111.11111110  /31  Unusable
1067// 255.255.255.252  11111111.11111111.11111111.11111100  /30    2  useable
1068// 255.255.255.248  11111111.11111111.11111111.11111000  /29    6  useable
1069// 255.255.255.240  11111111.11111111.11111111.11110000  /28   14  useable
1070// 255.255.255.224  11111111.11111111.11111111.11100000  /27   30  useable
1071// 255.255.255.192  11111111.11111111.11111111.11000000  /26   62  useable
1072// 255.255.255.128  11111111.11111111.11111111.10000000  /25  126  useable
1073// 255.255.255.0    11111111.11111111.11111111.00000000  /24 "Class C" 254 useable
1074//
1075// 255.255.254.0    11111111.11111111.11111110.00000000  /23    2  Class C's
1076// 255.255.252.0    11111111.11111111.11111100.00000000  /22    4  Class C's
1077// 255.255.248.0    11111111.11111111.11111000.00000000  /21    8  Class C's
1078// 255.255.240.0    11111111.11111111.11110000.00000000  /20   16  Class C's
1079// 255.255.224.0    11111111.11111111.11100000.00000000  /19   32  Class C's
1080// 255.255.192.0    11111111.11111111.11000000.00000000  /18   64  Class C's
1081// 255.255.128.0    11111111.11111111.10000000.00000000  /17  128  Class C's
1082// 255.255.0.0      11111111.11111111.00000000.00000000  /16  "Class B"
1083//
1084// 255.254.0.0      11111111.11111110.00000000.00000000  /15    2  Class B's
1085// 255.252.0.0      11111111.11111100.00000000.00000000  /14    4  Class B's
1086// 255.248.0.0      11111111.11111000.00000000.00000000  /13    8  Class B's
1087// 255.240.0.0      11111111.11110000.00000000.00000000  /12   16  Class B's
1088// 255.224.0.0      11111111.11100000.00000000.00000000  /11   32  Class B's
1089// 255.192.0.0      11111111.11000000.00000000.00000000  /10   64  Class B's
1090// 255.128.0.0      11111111.10000000.00000000.00000000  /9   128  Class B's
1091// 255.0.0.0        11111111.00000000.00000000.00000000  /8   "Class A"
1092//
1093// 254.0.0.0        11111110.00000000.00000000.00000000  /7
1094// 252.0.0.0        11111100.00000000.00000000.00000000  /6
1095// 248.0.0.0        11111000.00000000.00000000.00000000  /5
1096// 240.0.0.0        11110000.00000000.00000000.00000000  /4
1097// 224.0.0.0        11100000.00000000.00000000.00000000  /3
1098// 192.0.0.0        11000000.00000000.00000000.00000000  /2
1099// 128.0.0.0        10000000.00000000.00000000.00000000  /1
1100// 0.0.0.0          00000000.00000000.00000000.00000000  /0   IP space
1101?>
Note: See TracBrowser for help on using the repository browser.