documentation/manual/es/module_specs/Zend_Auth_Adapter_Digest.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2     <!-- EN-Revision: 20763 -->
   3     <!-- Reviewed: no -->
   4 <sect1 id="zend.auth.adapter.digest">
   5
   6     <title>Autenticación "Digest"</title>
   7
   8     <sect2 id="zend.auth.adapter.digest.introduction">
   9
  10         <title>Introducción</title>
  11
  12         <para>
  13             La
  14             <ulink url="http://en.wikipedia.org/wiki/Digest_access_authentication">Autenticación
  15                 "Digest"</ulink>
  16             es un método de la autenticación
  17             <acronym>HTTP</acronym>
  18             que mejora la
  19             <ulink url="http://en.wikipedia.org/wiki/Basic_authentication_scheme">Autenticación
  20                 Básica</ulink>
  21             proporcionando una manera de
  22             autenticar sin tener que transmitir la contraseña de manera
  23             clara a
  24             través de la red.
  25         </para>
  26
  27         <para>Este adaptador permite la autentificación contra archivos de
  28             texto que contengan líneas
  29             que tengan los elementos básicos de la
  30             autenticación "Digest":
  31        </para>
  32
  33         <itemizedlist>
  34             <listitem>
  35                 <para>
  36                     username, tal como
  37                     "
  38                     <emphasis>
  39                         <filename>joe.user</filename>
  40                     </emphasis>
  41                     "
  42                 </para>
  43             </listitem>
  44             <listitem>
  45                 <para>
  46                     realm, tal como "
  47                     <emphasis>Administrative Area</emphasis>
  48                     "
  49                 </para>
  50             </listitem>
  51             <listitem>
  52                 <para>
  53                     Hash
  54                     <acronym>MD5</acronym>
  55                     del username, realm y password,
  56                     separados por dos puntos
  57                 </para>
  58             </listitem>
  59         </itemizedlist>
  60
  61         <para>
  62             Los elementos anteriores están separados por dos
  63             puntos, como en el ejemplo siguiente (en
  64             el que la contraseña es
  65             "
  66             <emphasis>somePassword</emphasis>
  67             "):
  68         </para>
  69
  70         <programlisting language="txt"><![CDATA[
  71 someUser:Some Realm:fde17b91c3a510ecbaf7dbd37f59d4f8
  72 ]]></programlisting>
  73
  74     </sect2>
  75
  76     <sect2 id="zend.auth.adapter.digest.specifics">
  77
  78         <title>Detalles Específicos</title>
  79
  80         <para>
  81             El adaptador de autenticación "Digest",
  82             <classname>Zend_Auth_Adapter_Digest</classname>
  83             , requiere varios
  84             parámetros de entrada:
  85         </para>
  86
  87         <itemizedlist>
  88             <listitem>
  89                 <para>filename - Nombre del archivo contra el que se
  90                     realiza la autenticación de las consultas</para>
  91             </listitem>
  92             <listitem>
  93                 <para>realm - Domino de la autenticación "Digest"</para>
  94             </listitem>
  95             <listitem>
  96                 <para>username - Usuario de la autenticación "Digest"
  97                    </para>
  98             </listitem>
  99             <listitem>
 100                 <para>password - Contraseña para el usuario del dominio
 101                    </para>
 102             </listitem>
 103         </itemizedlist>
 104         <para>
 105             Estos parámetros deben ser establecidos antes de
 106             llamar a
 107             <methodname>authenticate()</methodname>
 108             .
 109         </para>
 110
 111     </sect2>
 112
 113     <sect2 id="zend.auth.adapter.digest.identity">
 114
 115         <title>Identidad</title>
 116
 117         <para>
 118             El adaptador de autenticación "Digest" devuelve un objeto
 119             <classname>Zend_Auth_Result</classname>
 120             , que ha sido rellenado
 121             con la identidad como un array que tenga claves
 122             <emphasis>realm</emphasis>
 123             y
 124             <emphasis>username</emphasis>
 125             . Los respectivos valores del
 126             array asociados con esas claves correspondes con los
 127             valores fijados
 128             andes de llamar a
 129             <methodname>authenticate()</methodname>
 130             .
 131         </para>
 132
 133         <programlisting language="php"><![CDATA[
 134 $adapter = new Zend_Auth_Adapter_Digest($filename,
 135                                         $realm,
 136                                         $username,
 137                                         $password);
 138
 139 $result = $adapter->authenticate();
 140
 141 $identity = $result->getIdentity();
 142
 143 print_r($identity);
 144
 145 /*
 146 Array
 147 (
 148     [realm] => Some Realm
 149     [username] => someUser
 150 )
 151 */
 152 ]]></programlisting>
 153
 154     </sect2>
 155
 156 </sect1>