documentation/manual/pl/module_specs/Zend_Auth_Adapter_Digest.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="zend.auth.adapter.digest">
   4
   5     <title>Uwierzytelnianie Digest</title>
   6
   7     <sect2 id="zend.auth.adapter.digest.introduction">
   8
   9         <title>Wprowadzenie</title>
  10
  11         <para>
  12             <ulink url="http://en.wikipedia.org/wiki/Digest_access_authentication">Uwierzytelnianie Digest</ulink>
  13             jest metodą uwierzytelniania <acronym>HTTP</acronym>, która udoskonala
  14             <ulink url="http://en.wikipedia.org/wiki/Basic_authentication_scheme">uwierzytelnianie Basic</ulink>
  15             dostarczając sposób uwierzytelniania bez konieczności przesyłania
  16             hasła w postaci czystego tekstu poprzez sieć.
  17         </para>
  18
  19         <para>
  20             Ten adapter pozwala na uwierzytelnianie w oparciu o pliki tekstowe
  21             zawierające linie, w których znajdują się podstawowe elementy
  22             uwierzytelniania digest:
  23         </para>
  24
  25         <itemizedlist>
  26             <listitem>
  27                 <para>
  28                     nazwa użytkownika, jak na przykład "<emphasis><filename>joe.user</filename></emphasis>"
  29                 </para>
  30             </listitem>
  31             <listitem>
  32                 <para>
  33                     nazwa obszaru, jak na przykład "<emphasis>Administrative Area</emphasis>"
  34                 </para>
  35             </listitem>
  36             <listitem>
  37                 <para>
  38                     skrót <acronym>MD5</acronym> nazwy użytkownika, nazwy obszaru oraz hasła,
  39                     oddzielonych dwukropkami
  40                 </para>
  41             </listitem>
  42         </itemizedlist>
  43
  44         <para>
  45             Powyższe elementy są oddzielone dwukropkami, tak jak w poniższym przykładzie
  46             (w którym hasłem jest "<emphasis>somePassword</emphasis>"):
  47         </para>
  48
  49         <programlisting language="txt"><![CDATA[
  50 someUser:Some Realm:fde17b91c3a510ecbaf7dbd37f59d4f8
  51 ]]></programlisting>
  52
  53     </sect2>
  54
  55     <sect2 id="zend.auth.adapter.digest.specifics">
  56
  57         <title>Parametry</title>
  58
  59         <para>
  60             Adapter uwierzytelniania digest, <classname>Zend_Auth_Adapter_Digest</classname>,
  61             wymaga ustawienia kilku wejściowych parametrów:
  62         </para>
  63
  64         <itemizedlist>
  65             <listitem>
  66                 <para>
  67                     filename - plik na podstawie którego przeprowadzane są
  68                     zapytania uwierzytelniania
  69                 </para>
  70             </listitem>
  71             <listitem>
  72                 <para>
  73                     realm - obszar uwierzytelniania Digest
  74                 </para>
  75             </listitem>
  76             <listitem>
  77                 <para>
  78                     username - użytkownik uwierzytelniania Digest
  79                 </para>
  80             </listitem>
  81             <listitem>
  82                 <para>
  83                     password - hasło dla użytkownika danego obszaru
  84                 </para>
  85             </listitem>
  86         </itemizedlist>
  87
  88         <para>
  89             Te parametry muszą być ustawione przed wywołaniem metody
  90             <methodname>authenticate()</methodname>.
  91         </para>
  92
  93     </sect2>
  94
  95     <sect2 id="zend.auth.adapter.digest.identity">
  96
  97         <title>Tożsamość</title>
  98
  99         <para>
 100             Adapter uwierzytelniania digest zwraca obiekt <classname>Zend_Auth_Result</classname>,
 101             który został wypełniony danymi tożsamości w postaci tablicy posiadajacej
 102             klucze <emphasis>realm</emphasis> oraz <emphasis>username</emphasis>. Odpowiednie
 103             wartości tablicy powiązane z tymi kluczami odpowiadają wartościom
 104             ustawionym przed wywołaniem metody <methodname>authenticate()</methodname>.
 105         </para>
 106
 107         <programlisting language="php"><![CDATA[
 108 $adapter = new Zend_Auth_Adapter_Digest($filename,
 109                                         $realm,
 110                                         $username,
 111                                         $password);
 112
 113 $result = $adapter->authenticate();
 114
 115 $identity = $result->getIdentity();
 116
 117 print_r($identity);
 118
 119 /*
 120 Array
 121 (
 122     [realm] => Some Realm
 123     [username] => someUser
 124 )
 125 */
 126 ]]></programlisting>
 127
 128     </sect2>
 129 </sect1>