IntroducciónZend_Auth provee una API para autenticación e incluye adaptadores concretos de autenticación para
escenarios de casos de uso común.
Zend_Auth es concerniente sólo con autenticación y no con
autorización. Autenticación es vagamente definido como: determinar
si una entidad realmente es lo que pretende ser (o sea, identificación), basandose en un grupo de
credenciales. Autorización, el proceso de decidir si se permite a una entidad: acceso a, o el
realizar operaciones en, otras entidades esta fuera del alcance de Zend_Auth. Para más información sobre
autorización y control de acceso con Zend Framework, por favor vea
Zend_Acl.
La clase Zend_Authimplementa el patrón Singleton - sólo una instancia de la clase está
disponible - a través de su método estático getInstance(). Esto significa que usar el operador new
y la keyword clone no va a funcionar con la clase Zend_Auth : use
Zend_Auth::getInstance() en su lugar.
Adaptadores
Un adaptador Zend_Auth es usado para autenticar en contra de un tipo particular de servicio de autenticación,
como LDAP, RDBMS, o almacenamiento basado en ficheros. Diferentes adaptadores pueden tener opciones y compotamientos
muy diferentes, pero algunas cosas básicas son comunes entre los adaptadores de autenticación. Por ejemplo,
aceptar credenciales de autenticación (incluyendo una identidad supuesta), realizar consultas ante el
servicio de autenticación, y regresar resultados, son comunes para los adaptadores Zend_Auth.
Cada clase adaptadora Zend_Auth implementa Zend_Auth_Adapter_Interface. Esta interface define un
metodo, authenticate(), que la clase adaptadora debe implementar para realizar una peticion de
autenticación. Cada clase adaptadora debe ser preparada antes de llamar a authenticate(). Esta preparación
del adaptador incluye la creación de credenciales (p.ej. nombre de usuario y contraseña) y la definición de valores para opciones
de configuración especificos del adaptador, como valores de coneccion a base de datos para un adaptador de tabla de base de datos.
El siguente ejemplo es un adaptador de autenticación que requiere que un nombre de usuario y contraseña sean especificados
para la autenticación. Otros detalles, como la forma de realizar peticiones al servicio de autenticación, han sido
omitídos por brevedad:
Como se ha indicado en su docblock, authenticate() debe regresar una instancia de
Zend_Auth_Result (o de una clase derivada de Zend_Auth_Result). Si por alguna
razón es imposible realizar una petición de autenticación, authenticate() debería arrojar
una excepción que se derive de Zend_Auth_Adapter_Exception.
Resultados
Los adaptadores Zend_Auth regresan una instancia de Zend_Auth_Result con
authenticate() para representar el resultado de un intento de autenticación. Los adaptadores
llenan el objeto Zend_Auth_Result en cuanto se construye, así que los siguientes cuatro métodos
proveen un grupo básico de operaciones "frente al usuario" que son comunes a los resultados de adaptadores Zend_Auth:
isValid() - regresa true si y solo si el resultado representa un
intento de autenticación exitoso
getCode() - regresa una constante identificadora Zend_Auth_Result para
determinar el tipo de fallo en la autenticación o si ha sido exitosa. Este puede ser usado
en situaciones cuando el desarrollador desea distinguir entre varios tipos de resultados
de autenticación. Esto permite a los desarrolladores, por ejemplo, mantener estadísticas
detalladas de los resultados de autenticación. Otro uso de esta característica es: proporcionar
al usuario mensajes específicos detallados por razones de usabilidad, aunque los desarrolladores
son exhortados a considerar el riesgo de proporcionar tales detalles a los usuarios, en vez de
un mensaje general de fallo en la autenticación. Para más información, vea las siguientes notas:
getIdentity() - regresa la identidad del intento de autenticación
getMessages() - regresa un arreglo de mensajes pertinentes a un fallido
intento de autenticación
El desarrollador podría desear ramificar basado en el tipo de resultado de la autenticación a fin de
realizar operaciones mas específicas. Algunas operaciones que los desarrolladores podrían encontrar útiles
son: bloquear cuentas despues de varios intentos fallidos de ingresar una contraseña, marcar una dirección IP
despues de que ha intentado muchas identidades no existentes, y porporcionar al usuario mensajes especificos
resultados de la autenticación. Los siguientes codigos de resultado están disponibles:
El siguiente ejemplo ilustra como un desarrollador podría ramificar basado en el código resultado:
_auth->authenticate($adapter);
switch ($result->getCode()) {
case Zend_Auth_Result::FAILURE_IDENTITY_NOT_FOUND:
/** realiza algo para identidad inexistente **/
break;
case Zend_Auth_Result::FAILURE_CREDENTIAL_INVALID:
/** realiza algo para credencial invalida **/
break;
case Zend_Auth_Result::SUCCESS:
/** realiza algo para autenticación exitosa **/
break;
default:
/** realiza algo para otras fallas **/
break;
}
]]>Persistencia de Identidad
Autenticar una petición que incluye credenciales de autenticación es util por sí mismo, pero también
es importante el soportar mantener la identidad autenticada sin tener que presentar las credenciales
de autenticación con cada petición.
HTTP es un protocolo sin estado, sin embargo, se han desarrollado técnicas como las cookies y sesiones
a fin de facilitar mantener el estado a través de multiples peticiones en aplicaciones web del lado del servidor.
Persistencia por Defecto en la Sesión PHP
Por defecto, Zend_Auth provee almacenamiento persistente de la identidad desde un intento
de autenticación exitoso usando la sesión PHP. En un intento de autenticación exitoso,
end_Auth::authenticate() almacena la identidad del resultado de autenticación en
almacenamiento persistente. A menos que se configure diferente, Zend_Auth usa una clase de
almacenamiento llamada Zend_Auth_Storage_Session, la cual, a su vez usa
Zend_Session. Una clase diferente podría ser utilizada mediante
proveer un objeto que implemente Zend_Auth_Storage_Interface a Zend_Auth::setStorage()
Si el automático almacenamiento persistente de la identidad no es apropiado para un caso en particular,
entonces los desarrolladores podrían dejar de usar la clase Zend_Auth al mismo tiempo,
utilizando en su lugar una clase adaptadora directamente.
Modifying the Session NamespaceZend_Auth_Storage_Session usa un espacionombre (namespace) de sesión 'Zend_Auth'.
Este espacio-nombre podría ser OVERRIDDEN al pasar un valor diferente al contructor de
Zend_Auth_Storage_Session, y este valor es pasado internamente al constructor de
Zend_Session_Namespace. Esto debería ocurrir antes de que se intente la autenticación, ya que
Zend_Auth::authenticate() realiza el almacenamiento automático de la identidad.
setStorage(new Zend_Auth_Storage_Session('unEspacionombre'));
/**
* @todo Set up the auth adapter, $authAdapter
*/
// Autenticar, almacenando el resultado, y persistiendo la identidad en
// suceso
$result = $auth->authenticate($authAdapter);
]]>Implementando Almacenamiento Personalizado
En ocaciones los desarrolladores podrían necesitar usar un diferente comportamiento de persistencia de identidad
que el provisto por Zend_Auth_Storage_Session. Para esos casos los desarrolladores podrían simplemente
implementar Zend_Auth_Storage_Interface y suplir una instancia de la clase a
Zend_Auth::setStorage().
Usando una Clase de Almacenamiento Personalizada
Para poder utilizar una clase de almacenamiento persistente de identidad diferente a
Zend_Auth_Storage_Session, el desarrollador implementa Zend_Auth_Storage_Interface:
A fin de poder usar esta clase de almacenamiento personalizada, Zend_Auth::setStorage()
es invocada antes de intentar una petición de autenticación:
setStorage(new MyStorage());
/**
* @por hacer Configurar el adaptador de autenticación, $authAdapter
*/
// Autenticar, almacenando el resultado, y persistiendo la identidad
// si hay exito
$result = Zend_Auth::getInstance()->authenticate($authAdapter);
]]>Uso
Hay dos formas provistas de usar adaptadores Zend_Auth:
indirectamente, a través de Zend_Auth::authenticate()
directamente, a través del metodoauthenticate() del adaptador
El siguiente ejemplo ilustra como usar el adaptador :Zend_Auth: indirectamente, a través
del uso de la clase Zend_Auth:
authenticate($authAdapter);
if (!$result->isValid()) {
// Fautenticación fallida: imprime el por que
foreach ($result->getMessages() as $message) {
echo "$message\n";
}
} else {
// Autenticación exitosa, la identidad ($username) es almacenada
// en la sesión
// $result->getIdentity() === $auth->getIdentity()
// $result->getIdentity() === $username
}
]]>
Una vez que la autenticación ha sido intentada en una petición, como en el ejemplo anterior,
es fácil verificar si existe una identidad autenticada exitosamente:
hasIdentity()) {
// Existe la identidad; obtenla
$identity = $auth->getIdentity();
}
]]>
Para remover una identidad del almacenamiento persistente, simplemente usa el metodo clearIdentity()method.
Comunmente esto sería usado para implementar una operación "cerrar sesión" en la aplicación:
clearIdentity();
]]>
Cuando el uso automático de almacenamiento persistente es inapropiado para un caso en particular,
el desarrollador podría simplemente omitir el uso de la clase Zend_Auth, usando una
clase adaptadora directamente. El uso directo de una clase adaptadora implica configurar y preparar
un objeto adaptador y despues llamar a su metodo authenticate(). Los detalles específicos
del adaptador son discutidos en la documentación de cada adaptador. El siguiente ejemplo utiliza
directamente MyAuthAdapter:
authenticate();
if (!$result->isValid()) {
// Autenticación fallida, imprime el porque
foreach ($result->getMessages() as $message) {
echo "$message\n";
}
} else {
// Autenticación exitosa
// $result->getIdentity() === $username
}
]]>