Zend_Auth_Adapter_Http ofrece una implementación mayormente conforme con RFC-2617, de autenticación HTTP Basic y Digest. La autenticación Digest es un método de autenticación HTTP que mejora la autenticación Basic al proporcionar una forma de autenticarse sin tener que transmitir la contraseña en texto claro a través de la red.

Características principales:

Hay algunas características notables de RFC-2617 que aún no están implementadas:

Este adaptador consta de dos subcomponentes: la propia clase de autenticación HTTP, y los llamados "Resolvers" (resolutores). La clase de autenticación HTTP encapsula la lógica para llevar a cabo tanto la autenticación Basic como la Digest. Utiliza un resolutor para buscar la identidad de un cliente en algún almacén de datos (un archivo de texto por defecto) y recuperar las credenciales de dicho almacén. Las credenciales "resueltas" se comparan entonces con los valores enviados por el cliente para determinar si la autenticación tiene éxito.

La clase Zend_Auth_Adapter_Http requiere que se le pase un array de configuración a su constructor. Existen varias opciones de configuración disponibles, y algunas son obligatorias:

Nota

La implementación actual de nonce_timeout tiene algunos efectos secundarios interesantes. Se supone que este parámetro determina el tiempo de vida válido de un nonce dado, o efectivamente cuánto tiempo se acepta la información de autenticación de un cliente. Actualmente, si se establece en 3600 (por ejemplo), hará que el adaptador solicite nuevas credenciales al cliente cada hora, en punto. Esto se resolverá en una futura versión, una vez que se implementen el seguimiento de nonces y el soporte de "stale".

El trabajo del resolutor es tomar un nombre de usuario y un ámbito (realm), y devolver algún tipo de valor de credencial. La autenticación Basic espera recibir la versión codificada en Base64 de la contraseña del usuario. La autenticación Digest espera recibir un hash del nombre de usuario, el ámbito y su contraseña (cada uno separado por dos puntos). Actualmente, el único algoritmo de hash soportado es MD5.

Zend_Auth_Adapter_Http depende de objetos que implementen Zend_Auth_Adapter_Http_Resolver_Interface. Con este adaptador se incluye una clase resolutora de archivo de texto, pero se puede crear cualquier otro tipo de resolutor simplemente implementando la interfaz del resolutor.

<username>:<realm>:<credentials>\n

$path     = 'files/passwd.txt';
$resolver = new Zend_Auth_Adapter_Http_Resolver_File($path);

$path     = 'files/passwd.txt';
$resolver = new Zend_Auth_Adapter_Http_Resolver_File();
$resolver->setFile($path);

Primero, configure un array con los valores de configuración requeridos:

$config = array(
    'accept_schemes' => 'basic digest',
    'realm'          => 'My Web Site',
    'digest_domains' => '/members_only /my_account',
    'nonce_timeout'  => 3600,
);

Este array hará que el adaptador acepte tanto autenticación Basic como Digest, y requerirá acceso autenticado a todas las áreas del sitio bajo /members_only y /my_account. El valor del ámbito (realm) suele mostrarlo el navegador en el cuadro de diálogo de contraseña. El nonce_timeout, por supuesto, se comporta como se ha descrito anteriormente.

A continuación, cree el objeto Zend_Auth_Adapter_Http:

$adapter = new Zend_Auth_Adapter_Http($config);

Dado que soportamos tanto la autenticación Basic como la Digest, necesitamos dos objetos resolutores diferentes. Tenga en cuenta que esto bien podría ser dos clases distintas:

$basicResolver = new Zend_Auth_Adapter_Http_Resolver_File();
$basicResolver->setFile('files/basicPasswd.txt');

$digestResolver = new Zend_Auth_Adapter_Http_Resolver_File();
$digestResolver->setFile('files/digestPasswd.txt');

$adapter->setBasicResolver($basicResolver);
$adapter->setDigestResolver($digestResolver);

Finalmente, realizamos la autenticación. El adaptador necesita una referencia tanto al objeto Request como al objeto Response para poder hacer su trabajo:

assert($request instanceof Zend_Controller_Request_Http);
assert($response instanceof Zend_Controller_Response_Http);

$adapter->setRequest($request);
$adapter->setResponse($response);

$result = $adapter->authenticate();
if (!$result->isValid()) {
    // Bad userame/password, or canceled password prompt
}