archived-doc-tr/reference/strings/functions/crypt.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: nilgun Status: ready -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.crypt">
 <refnamediv>
  <refname>crypt</refname>
  <refpurpose>Tek yönlü dizge aşlama</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  &note.not-bin-safe;
 </refsynopsisdiv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>crypt</methodname>
   <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>dizge</parameter></methodparam>
   <methodparam><type>string</type><parameter>tuz</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>crypt</function> işlevi standart Unix <abbrev>DES</abbrev>
   şifreleme algoritmasını veya sistemdeki uygun algoritmalardan birini
   kullanarak <parameter>dizge</parameter> dizgesinin aşlanmış sürümünü
   döndürür.
   <function>password_verify</function> işlevi <function>crypt</function>
   işlevi ile uyumludur. Bu bakımdan <function>crypt</function> ile
   oluşturulan parola aşları <function>password_verify</function> ile
   kullanılabilir.
  </para>
  <para>
   PHP 8.0.0 öncesinde <parameter>tuz</parameter> bağımsız değişkeni isteğe
   bağlıydı. Bununla birlikte, <function>crypt</function> tuzsuz zayıf
   bir aş oluşturur ve bu durumda bir <constant>E_NOTICE</constant>
   seviyesinde bir hatası üretir. Daha iyi güvenlik için yeterince güçlü
   bir tuz belirlemek gerekir.
  </para>
  <para>
   <function>password_hash</function> güçlü bir aş kullanır, güçlü bir tuz
   üretir ve uygun turları otomatik olarak uygular.
   <function>password_hash</function> basit bir <function>crypt</function>
   sarmalayıcısıdır ve mevcut parola aşlarıyla uyumludur.
   <function>password_hash</function> kullanmak daha güvenlidir ve önerilir.
  </para>
  <para>
   Aş türü <parameter>tuz</parameter> bağımsız değişkeniyle tetiklenir.
   <parameter>tuz</parameter> belirtilmemişse ya standart iki karakterlik (DES)
   ya da MD5 şifrelemesinin varlığına bağlı olarak oniki karakterlik tuz otomatik
   olarak üretilir. PHP, kullanılabilecek aşlar tarafından izin verilen geçerli
   en uzun tuzu belirleyen <constant>CRYPT_SALT_LENGTH</constant> adında bir
   sabit içerir.
  </para>
  <para>
   Standart DES şifrelemesinde <function>crypt</function> işlevi tuz olarak
   çıktının ilk iki karakterini döndürür. Ayrıca, dizgenin sadece ilk sekiz
   karakterini kullanır, bu nedenle ilk sekiz karakteri aynı olan sekiz
   karakterden daha uzun dizgeler için tuz aynı olduğu sürece hep aynı sonucu
   üretir.
  </para>
  <simpara>
   Desteklenen aş türleri:
  </simpara>
  <itemizedlist>
   <listitem>
    <simpara>
     <constant>CRYPT_STD_DES</constant> - "./0-9A-Za-z" kalıbından
     iki karakter içeren standart DES aşı. Tuzda geçersiz karakter kullanımı
     işlevin başarısız olmasına sebep olur.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>CRYPT_EXT_DES</constant> - Dokuz karakterlik tuz kullanan
     gelişkin DES aşı. "Tuz", bir alt çizginin ardından 4 karakterlik yineleme
     sayısı ve 4 karakterlik tuzdan oluşan 9 karakterli bir dizedir. Bu 4
     karakterlik dizelerin herbiri 24 bitle kodlanır ve en düşük değerli
     karakter baştadır. <literal>0</literal> ila <literal>63</literal>
     arasındaki değerler <literal>./0-9A-Za-z</literal> kalıbından kodlanmıştır.
     Tuzda geçersiz karakter kullanımı, işlevin başarısız olmasına sebep olur.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>CRYPT_MD5</constant> - $1$ ile başlayan on iki karakterlik MD5
     aşı.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>CRYPT_BLOWFISH</constant> - Tuzlu blowfish aşı şöyle oluşur:
     "$2a$", "$2x$" veya "$2y$", iki basamaklı bir bedel bağımsız değişkeni,
     "$" ve "./0-9A-Za-z" kalıbından 22 karakter. Tuzda bu aralığın dışındaki
     karakterlerin kullanılması, işlevin sıfır uzunluklu bir dize döndürmesine
     sebep olur. İki basamaklı bedel bağımsız değişkeni, temel Blowfish tabanlı
     aşlama algoritması için yineleme sayımının 2'lik tabanda logaritmasıdır
     ve 04-31 aralığında olmalıdır; bu aralığın dışındaki değerler işlevin
     başarısız olmasına sebep olur. "$2x$" aşları görece zayıftır; "$2a$"
     aşları uyumludur ve bu zayıflığı azaltır. Yeni aşlar için "$2y$"
     kullanılmalıdır.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>CRYPT_SHA256</constant> - SHA-256 aşı, $5$ ile başlayan
     onaltı karakterlik bir tuza sahiptir. Tuz dizesi 'rounds=&lt;N&gt;$'
     ile başlıyorsa, N'nin sayısal değeri, Blowfish'teki bedel bağımsız değişkenine
     benzer şekilde, aşlama döngüsündeki tur sayısını belirtmek için
     kullanılır. Öntanımlı tur sayısı 5000'dir, en az 1000 ve en çok
     999.999.999'dur. Bu aralığın dışında bir N seçilirse en yakın sınır
     değer kullanılır.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <constant>CRYPT_SHA512</constant> - SHA-512 aşı, $6$ ile başlayan
     onaltı karakterlik bir tuza sahiptir. Tuz dizesi 'rounds=&lt;N&gt;$'
     ile başlıyorsa, N'nin sayısal değeri, Blowfish'teki bedel bağımsız değişkenine
     benzer şekilde, aşlama döngüsündeki tur sayısını belirtmek için
     kullanılır. Öntanımlı tur sayısı 5000'dir, en az 1000 ve en çok
     999.999.999'dur. Bu aralığın dışında bir N seçilirse en yakın sınır
     değer kullanılır.
     </simpara>
    </listitem>
  </itemizedlist>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>dizge</parameter></term>
     <listitem>
      <para>
       Aşlanacak dizge.
      </para>
      <caution>
       <para>
        <constant>CRYPT_BLOWFISH</constant> algoritmasının kullanımı,
        <parameter>dizge</parameter> bağımsız değişkeninin 72 bayt uzunlukta
        kırpılmasına sebep olur.
       </para>
      </caution>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>tuz</parameter></term>
     <listitem>
      <para>
       Aşlamaye göre değişen tuz dizgesi. Belirtilmezse,
       davranış algoritma gerçeklenimi tarafından tanımlanır ve beklenmedik
       sonuçlara yol açabilir.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Aşlama uygulanmış dizge veya 13 karakterden daha kısa olan ve başarısızlık
   durumunda tuzdan farklı olacağı garanti edilen bir dizge döndürür.
  </para>
  <warning>
   <simpara>
    Parolalar doğrulanırken, <function>crypt</function> çıktısını önceden
    bilinen aş ile karşılaştırmak için zamanlama saldırılarına açık olmayan
    bir dizge karşılaştırma işlevi kullanılmalıdır. PHP'de bu kullanım için
    <function>hash_equals</function> işlevi bulunur.
   </simpara>
  </warning>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.0.0</entry>
       <entry>
        <parameter>tuz</parameter> bağımsız değişkeni artık isteğe bağlı değil.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>crypt</function> örnekleri</title>
    <programlisting role="php">
<![CDATA[
<?php
$kullanıcı_girdisi = 'rasmuslerdorf';
$aşlıParola = '$6$rounds=1000000$NJy4rIPjpOaU$0ACEYGg/aKCY3v8O8AfyiO7CTfZQ8/W231Qfh2tRLmfdvFD6XfHk12u6hMr9cYIA4hnpjLNSTRtUwYr9km9Ij/';

// Mevcut crypt() aşını PHP dışı yazılımlarla uyumlu olacak şekilde doğrula.
if (hash_equals($aşlıParola, crypt($kullanıcı_girdisi, $aşlıParola))) {
   echo "Parola doğru!";
}
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <simpara>
    <function>crypt</function> tek yönlü algoritma kullandığından tekrar özgün
    dizgeyi elde etmeyi sağlayacak bir işlev yoktur.
   </simpara>
  </note>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>hash_equals</function></member>
    <member><function>password_hash</function></member>
    <member><link xlink:href="http://belgeler.gen.tr/man/man3/man3-crypt.html">
    crypt işlevinin Unix kılavuz sayfası</link></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->