documentation/manual/he/module_specs/Zend_Auth_Adapter_Digest.xml

   1 <sect1 id="zend.auth.adapter.digest">
   2
   3     <title>אימות מתקדם</title>
   4
   5     <sect2 id="zend.auth.adapter.digest.introduction">
   6
   7         <title>הקדמה</title>
   8
   9         <para>
  10             <ulink url="http://en.wikipedia.org/wiki/Digest_access_authentication">אימות מתקדם</ulink>
  11             הינה שיטת אימות בעזרת פרוטוקול HTTP אשר משפרת את
  12             <ulink url="http://en.wikipedia.org/wiki/Basic_authentication_scheme">אימות בסיסי</ulink>
  13             על ידי מתן אפשרות לאמת נתונים של משתמש דרך שרתים ללא צורך בהעברת הסיסמא בתור טקסט רגיל.
  14         </para>
  15
  16         <para>
  17             מתאם זה מאפשר לאמת מול קבצי טקסט המכילים שורות התואמים לאלמנטים הבסיסים של אימות מתקדם:
  18             <itemizedlist>
  19                 <listitem>
  20                     <para>
  21                         שם משתמש, כמו "<code>joe.user</code>"
  22                     </para>
  23                 </listitem>
  24                 <listitem>
  25                     <para>
  26                         תחום, לדוגמא "<code>לוח בקרה</code>"
  27                     </para>
  28                 </listitem>
  29                 <listitem>
  30                     <para>
  31                         הצפנת MD5 של שם המשתמש, התחום והסיסמא, מופרדים בנקודותיים.
  32                     </para>
  33                 </listitem>
  34             </itemizedlist>
  35             האלמנטים למעלה מופרדים בנקודותיים, כמו בדוגמא הבאה ("<code>somePassword</code>"):
  36         </para>
  37
  38         <programlisting><![CDATA[
  39 someUser:Some Realm:fde17b91c3a510ecbaf7dbd37f59d4f8
  40 ]]>
  41 </programlisting>
  42
  43     </sect2>
  44
  45     <sect2 id="zend.auth.adapter.digest.specifics">
  46
  47         <title>מאפיינים</title>
  48
  49         <para>
  50            רכיב <code>Zend_Auth_Adapter_Digest</code>, אשר משמש בתור מתאם אימות מתקדם, דורש כמה פרמטרים:
  51             <itemizedlist>
  52                 <listitem>
  53                     <para>
  54                         שם הקובץ - שם הקובץ שמולו כל שאילתות האימות יבוצעו.
  55                     </para>
  56                 </listitem>
  57                 <listitem>
  58                     <para>
  59                         תחום - התחום שבו האימות מתבצע עליו
  60
  61                     </para>
  62                 </listitem>
  63                 <listitem>
  64                     <para>
  65                         שם משתמש - שם משתמש לאימות
  66
  67                     </para>
  68                 </listitem>
  69                 <listitem>
  70                     <para>
  71                         סיסמא - סיסמא למשתמש של אותו תחום
  72                     </para>
  73                 </listitem>
  74             </itemizedlist>
  75             פרמטרים אלו צריכים להיות מוגדרים לפני הקריאה אל <code>authenticate()</code>.
  76         </para>
  77
  78     </sect2>
  79
  80     <sect2 id="zend.auth.adapter.digest.identity">
  81
  82         <title>זהות</title>
  83
  84         <para>
  85             המתאם המתקדם מחזיר אובייקט של <code>Zend_Auth_Result</code>, אשר נוצרה עם הזהות בתור מערך אשר מכיל מפתחות של <code>realm</code> ו <code>username</code>.
  86             הערכים במערך מקושרים למפתחות אשר הוגדרו לפני קריאה ל  <code>authenticate()</code>.
  87         </para>
  88
  89         <programlisting role="php"><![CDATA[
  90 $adapter = new Zend_Auth_Adapter_Digest($filename,
  91                                         $realm,
  92                                         $username,
  93                                         $password);
  94
  95 $result = $adapter->authenticate();
  96
  97 $identity = $result->getIdentity();
  98
  99 print_r($identity);
 100
 101 /*
 102 Array
 103 (
 104     [realm] => Some Realm
 105     [username] => someUser
 106 )
 107 */
 108 ]]>
 109         </programlisting>
 110
 111     </sect2>
 112
 113 </sect1>
 114 <!--
 115 vim:se ts=4 sw=4 et:
 116 -->