Zend_Auth_Adapter_DbTable proporciona la capacidad de autenticarse contra credenciales almacenadas en una tabla de base de datos. Debido a que Zend_Auth_Adapter_DbTable requiere que se pase una instancia de Zend_Db_Adapter_Abstract a su constructor, cada instancia está vinculada a una conexión de base de datos en particular. Otras opciones de configuración pueden establecerse mediante el constructor y mediante métodos de instancia, uno para cada opción.

Las opciones de configuración disponibles incluyen:

// Create an in-memory SQLite database connection
$dbAdapter = new Zend_Db_Adapter_Pdo_Sqlite(array('dbname' =>
                                                  ':memory:'));

// Build a simple table creation query
$sqlCreate = 'CREATE TABLE [users] ('
           . '[id] INTEGER  NOT NULL PRIMARY KEY, '
           . '[username] VARCHAR(50) UNIQUE NOT NULL, '
           . '[password] VARCHAR(32) NULL, '
           . '[real_name] VARCHAR(150) NULL)';

// Create the authentication credentials table
$dbAdapter->query($sqlCreate);

// Build a query to insert a row for which authentication may succeed
$sqlInsert = "INSERT INTO users (username, password, real_name) "
           . "VALUES ('my_username', 'my_password', 'My Real Name')";

// Insert the data
$dbAdapter->query($sqlInsert);

// Configure the instance with constructor parameters...
$authAdapter = new Zend_Auth_Adapter_DbTable(
    $dbAdapter,
    'users',
    'username',
    'password'
);

// ...or configure the instance with setter methods
$authAdapter = new Zend_Auth_Adapter_DbTable($dbAdapter);

$authAdapter
    ->setTableName('users')
    ->setIdentityColumn('username')
    ->setCredentialColumn('password')
;

// Set the input credential values (e.g., from a login form)
$authAdapter
    ->setIdentity('my_username')
    ->setCredential('my_password')
;

// Perform the authentication query, saving the result

// Print the identity
echo $result->getIdentity() . "\n\n";

// Print the result row
print_r($authAdapter->getResultRowObject());

/* Output:
my_username

Array
(
    [id] => 1
    [username] => my_username
    [password] => my_password
    [real_name] => My Real Name
)

Por defecto, Zend_Auth_Adapter_DbTable devuelve al objeto auth la identidad proporcionada tras una autenticación exitosa. Otro caso de uso, en el que los desarrolladores desean almacenar en el mecanismo de almacenamiento persistente de Zend_Auth un objeto de identidad que contenga otra información útil, se resuelve usando el método getResultRowObject() para devolver un objeto stdClass. El siguiente fragmento de código ilustra su uso:

// authenticate with Zend_Auth_Adapter_DbTable
$result = $this->_auth->authenticate($adapter);

if ($result->isValid()) {
    // store the identity as an object where only the username and
    // real_name have been returned
    $storage = $this->_auth->getStorage();
    $storage->write($adapter->getResultRowObject(array(
        'username',
        'real_name',
    )));

    // store the identity as an object where the password column has
    // been omitted
    $storage->write($adapter->getResultRowObject(
        null,
        'password'
    ));

    /* ... */

} else {

    /* ... */

}

Si bien el propósito principal de Zend_Auth (y por consiguiente de Zend_Auth_Adapter_DbTable) es principalmente la autenticación y no la autorización, hay algunas instancias y problemas que rozan la línea entre a qué dominio pertenecen. Dependiendo de cómo haya decidido explicar su problema, a veces tiene sentido resolver lo que podría parecer un problema de autorización dentro del adaptador de autenticación.

Con esa aclaración fuera del camino, Zend_Auth_Adapter_DbTable tiene algunos mecanismos incorporados que pueden aprovecharse para verificaciones adicionales en el momento de la autenticación para resolver algunos problemas comunes de los usuarios.

// The status field value of an account is not equal to "compromised"
$adapter = new Zend_Auth_Adapter_DbTable(
    $db,
    'users',
    'username',
    'password',
    'MD5(?) AND status != "compromised"'
);

// The active field value of an account is equal to "TRUE"
$adapter = new Zend_Auth_Adapter_DbTable(
    $db,
    'users',
    'username',
    'password',
    'MD5(?) AND active = "TRUE"'

Otro escenario puede ser la implementación de un mecanismo de "salting" (salado). El salado es un término que se refiere a una técnica que puede mejorar en gran medida la seguridad de su aplicación. Se basa en la idea de que concatenar una cadena aleatoria a cada contraseña hace que sea imposible lograr un ataque de fuerza bruta exitoso en la base de datos usando valores de hash precalculados de un diccionario.

Por lo tanto, necesitamos modificar nuestra tabla para almacenar nuestra cadena de sal:

$sqlAlter = "ALTER TABLE [users] "
          . "ADD COLUMN [password_salt] "
          . "AFTER [password]";

Aquí hay una forma sencilla de generar una cadena de sal para cada usuario en el registro:

for ($i = 0; $i < 50; $i++) {
    $dynamicSalt .= chr(rand(33, 126));

Y ahora construyamos el adaptador:

$adapter = new Zend_Auth_Adapter_DbTable(
    $db,
    'users',
    'username',
    'password',
    "MD5(CONCAT('"
    . Zend_Registry::get('staticSalt')
    . "', ?, password_salt))"
);

	Nota
	Puede mejorar aún más la seguridad usando un valor de sal estático codificado directamente en su aplicación. En caso de que su base de datos se vea comprometida (por ejemplo, mediante un ataque de inyección SQL) pero su servidor web permanezca intacto, sus datos seguirán siendo inutilizables para el atacante.

Otra alternativa es usar el método getDbSelect() de Zend_Auth_Adapter_DbTable después de que se haya construido el adaptador. Este método devolverá la instancia del objeto Zend_Db_Select que se utilizará para completar la rutina authenticate(). Es importante notar que este método siempre devolverá el mismo objeto sin importar si se ha llamado o no a authenticate(). Este objeto no tendrá ninguna de la información de identidad o credencial en él, ya que esos valores se colocan en el objeto select en el momento de authenticate().

Un ejemplo de una situación en la que se podría querer usar el método getDbSelect() sería verificar el estado de un usuario, en otras palabras, ver si la cuenta de ese usuario está habilitada.

// Continuing with the example from above
$adapter = new Zend_Auth_Adapter_DbTable(
    $db,
    'users',
    'username',
    'password',
    'MD5(?)'
);

// get select object (by reference)
$select = $adapter->getDbSelect();
$select->where('active = "TRUE"');

// authenticate, this ensures that users.active = TRUE
$adapter->authenticate();