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_Auth implementa 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 metodo
authenticate() 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
}
]]>