com doc/tr: New translation: reference/hash/functions/hash-equals.xml reference/hash/functions/hash-hkdf.xml
reference/hash/functions/hash-hmac-algos.xml reference/hash/functions/hash-pbkdf2.xml

From: Date: Thu, 18 Mar 2021 19:45:05 +0000
Subject: com doc/tr: New translation: reference/hash/functions/hash-equals.xml reference/hash/functions/hash-hkdf.xml
reference/hash/functions/hash-hmac-algos.xml reference/hash/functions/hash-pbkdf2.xml
Groups: php.doc.tr 
Request: Send a blank email to doc-tr+get-2609@lists.php.net to get a copy of this message
Commit: 3f88b49b8b8295d52ebd3a6bca3550f65d0c50d6 Author: Nilgün Belma Bugüner <nilgun@php.net> Thu, 18 Mar 2021 22:45:05 +0300 Parents: 0c5f188a535e8d463a967e86203202246988d6ae Branches: master Link: http://git.php.net/?p=doc/tr.git;a=commitdiff;h=3f88b49b8b8295d52ebd3a6bca3550f65d0c50d6 Log: New translation Changed paths: A reference/hash/functions/hash-equals.xml A reference/hash/functions/hash-hkdf.xml A reference/hash/functions/hash-hmac-algos.xml A reference/hash/functions/hash-pbkdf2.xml

diff --git a/reference/hash/functions/hash-equals.xml b/reference/hash/functions/hash-equals.xml new file mode 100644 index 00000000..729d1ea9 --- /dev/null +++ b/reference/hash/functions/hash-equals.xml @@ -0,0 +1,130 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision$ --> +<!-- EN-Revision: 01a7e4684e48c837813eb6492dd8a8c2887f48d3 Maintainer: nilgun Status: ready --> +<refentry xml:id="function.hash-equals" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>hash_equals</refname> + <refpurpose>Zamanlama saldırısı güvenli dize karşılaştırması</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>hash_equals</methodname> + <methodparam><type>string</type><parameter>bilinen_dzg</parameter></methodparam> + <methodparam><type>string</type><parameter>kullanıcı_dzg</parameter></methodparam> + </methodsynopsis> + <para> + İki dizgenin uzunluklarını aynı zamanı kullanarak karşılaştırır. + Uzunluklar farklıysa hemen &false; döner. + </para> + <para> + Bu işlev, zamanlama saldırılarını azaltmak için kullanılmalıdır; Örneğin, + <function>crypt</function> parola aşlarını denerken. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <variablelist> + <varlistentry> + <term><parameter>bilinen_dzg</parameter></term> + <listitem> + <para> + Karşılaştırılacak dizge + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>kullanıcı_dzg</parameter></term> + <listitem> + <para> + Kullanıcının sağladığı dizge + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + İki dizge benzerse &true; yoksa &false; döner. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + Aktarılan değiştirgelerden biri dizge değilse <constant>E_WARNING</constant> + seviyesinde bir ileti çıktılanır. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example xml:id="foobar.examples.basic"> + <title>- <function>hash_equals</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +$umulan = crypt('12345', '$2a$07$usesomesillystringforsalt$'); +$dogru = crypt('12345', '$2a$07$usesomesillystringforsalt$'); +$yanlis = crypt('apple', '$2a$07$usesomesillystringforsalt$'); + +var_dump(hash_equals($umulan, $dogru)); +var_dump(hash_equals($umulan, $yanlis)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +bool(true) +bool(false) +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Başarılı bir karşılaştırma için verilen dizgeler eşit uzunlukta olmalıdır. + Uzunluklar farklıysa hemen &false; döner. Zamanlama saldırısı durumunda + bilinen dizgenin uzunluğu değişebilir. + </para> + </note> + <note> + <para> + Kullanıcını sağladığı dizgeyi ilk değil ikinci değiştirgede belirtmek + önemlidir. + </para> + </note> + </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 +--> diff --git a/reference/hash/functions/hash-hkdf.xml b/reference/hash/functions/hash-hkdf.xml new file mode 100644 index 00000000..e7b63ee9 --- /dev/null +++ b/reference/hash/functions/hash-hkdf.xml @@ -0,0 +1,163 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: nilgun Status: ready --> +<refentry xml:id="function.hash-hkdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>hash_hkdf</refname> + <refpurpose>Sağlanan anahtar girdisinden HKDF anahtar türevi oluşturur + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>hash_hkdf</methodname> + <methodparam><type>string</type><parameter>algo</parameter></methodparam> + <methodparam><type>string</type><parameter>anahtar</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>uzunluk</parameter><initializer>0</initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>bilgi</parameter><initializer>""</initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>tuz</parameter><initializer>""</initializer></methodparam> + </methodsynopsis> + + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>algo</parameter></term> + <listitem> + <para> + Seçilen aşlama algoritmasının ismi ("md5", "sha256", "haval160,4" ve + benzerleri). Desteklenen algoritmaların listesi + <function>hash_algos</function> işlevinde bulunabilir. + <note> + <para> + Kriptografik olmayan aşlama algoritmalarına izin verilmez. + </para> + </note> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>anahtar</parameter></term> + <listitem> + <para> + Kullanılacak anahtar (ikil veri). Boş olamaz. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> <parameter>uzunluk</parameter></term> + <listitem> + <para> + İstenen çıktının bayt cinsinden uzunluğu. + En çok algoritma aş uzunluğunun 255 katı olabilir. + </para> + <para> + <parameter>uzunluk</parameter> olarak <literal>0</literal> verilirse, + öntanımlı çıktı uzunluğu seçilen aş boyutunun 255 katından + büyük olamaz. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>bilgi</parameter></term> + <listitem> + <para> + Application/context-specific bilgi dizgesi. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>tuz</parameter></term> + <listitem> + <para> + Türetme sırasında kullanılacak tuz. + </para> + <para> + Seçimlik olmasına rağmen, rasgele bir tuz HKDF'nin gücünü önemli ölçüde + arttırır. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Türetilen anahtarın ham ikil gösterimini içeren bir + dizge,&return.falseforfailure;. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + <parameter>anahtar</parameter> boşsa veya <parameter>algo</parameter> + kriptografik değilse ya da <parameter>uzunluk</parameter> negatif veya çok + (algoritma aş uzunluğunun 255 katından) büyükse, bir + <constant>E_WARNING</constant> çıktılanır. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- <function>hash_hkdf</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Rasgele bir anahtar ve türetme sırasında anahtarı güçlendirecek tuz üret +$girdiAnh = random_bytes(32); +$tuz = random_bytes(16); + +// yukarıda oluşturulan girdiyi kullanılarak ayrı bir anahtar çifti türet +$şifrelemeAnh = hash_hkdf('sha256', $girdiAnh, 32, 'aes-256-encryption', $tuz); +$kimlikKanıtAnh = hash_hkdf('sha256', $girdiAnh, 32, 'sha-256-authentication', $salt); + +var_dump(şifrelemeAnh !== $kimlikKanıtAnh); // bool(true) +?> +]]> + </programlisting> + <para> + Yukarıdaki örnekte, şifreleme için AES-256, kimlik kanıtlama için SHA-256 + kullanılarak bir anahtar çifti üretir (encrypt-then-HMAC oluşturmaya uygun) + </para> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>hash_pbkdf2</function></member> + <member><link xlink:href="&url.rfc;5869">RFC 5869</link></member> + <member><link xlink:href="&url.git.hub;narfbg/hash_hkdf_compat">kullanıcı alanı gerçeklenim</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 +--> diff --git a/reference/hash/functions/hash-hmac-algos.xml b/reference/hash/functions/hash-hmac-algos.xml new file mode 100644 index 00000000..4be9ad22 --- /dev/null +++ b/reference/hash/functions/hash-hmac-algos.xml @@ -0,0 +1,133 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision$ --> +<!-- EN-Revision: 38fb328862c0e14c63c33f295398e28b66d301d5 Maintainer: nilgun Status: ready --> +<refentry xml:id="function.hash-hmac-algos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>hash_hmac_algos</refname> + <refpurpose>hash_hmac için uygun kayıtlı aşlama algoritmalarının listesini + döndürür</refpurpose> + </refnamediv> + + <refsect1 role="description"><!-- {{{ --> + &reftitle.description; + <methodsynopsis role="procedural"> + <type>array</type><methodname>hash_hmac_algos</methodname> + <void /> + </methodsynopsis> + </refsect1><!-- }}} --> + + <refsect1 role="returnvalues"><!-- {{{ --> + &reftitle.returnvalues; + <para> + <function>hash_hmac</function> işlevi için elverişli aşlama algoritmalarından + desteklenenlerin listesini içeren sayısal indisli bir dizi döndürür. + </para> + </refsect1><!-- }}} --> + + <refsect1 role="examples"><!-- {{{ --> + &reftitle.examples; + <example xml:id="hash-hmac-algos.example.basic"><!-- {{{ --> + <title>- <function>hash_hmac_algos</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +print_r(hash_hmac_algos()); +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Array +( + [0] => md2 + [1] => md4 + [2] => md5 + [3] => sha1 + [4] => sha224 + [5] => sha256 + [6] => sha384 + [7] => sha512/224 + [8] => sha512/256 + [9] => sha512 + [10] => sha3-224 + [11] => sha3-256 + [12] => sha3-384 + [13] => sha3-512 + [14] => ripemd128 + [15] => ripemd160 + [16] => ripemd256 + [17] => ripemd320 + [18] => whirlpool + [19] => tiger128,3 + [20] => tiger160,3 + [21] => tiger192,3 + [22] => tiger128,4 + [23] => tiger160,4 + [24] => tiger192,4 + [25] => snefru + [26] => snefru256 + [27] => gost + [28] => gost-crypto + [29] => haval128,3 + [30] => haval160,3 + [31] => haval192,3 + [32] => haval224,3 + [33] => haval256,3 + [34] => haval128,4 + [35] => haval160,4 + [36] => haval192,4 + [37] => haval224,4 + [38] => haval256,4 + [39] => haval128,5 + [40] => haval160,5 + [41] => haval192,5 + [42] => haval224,5 + [43] => haval256,5 +) +]]> + </screen> + </example><!-- }}} --> + </refsect1><!-- }}} --> + + <refsect1 role="notes"><!-- {{{ --> + &reftitle.notes; + <note> + <para> + PHP 7.2.0 öncesinde, desteklenen aş algoritmaların bir listesini almanın + tek yolu, <function>hash_hmac</function> için uygun olmayan aş + algoritmalarını da döndüren <function>hash_algos</function> işlevini + çağırmaktı. + </para> + </note> + </refsect1><!-- }}} --> + + <refsect1 role="seealso"><!-- {{{ --> + &reftitle.seealso; + <simplelist> + <member><function>hash_hmac</function></member> + <member><function>hash_algos</function></member> + </simplelist> + </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 +--> diff --git a/reference/hash/functions/hash-pbkdf2.xml b/reference/hash/functions/hash-pbkdf2.xml new file mode 100644 index 00000000..ea52aec7 --- /dev/null +++ b/reference/hash/functions/hash-pbkdf2.xml @@ -0,0 +1,207 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- EN-Revision: dabaf662b17f594cd536ff68ea807b0fbc99d0ee Maintainer: nilgun Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.hash-pbkdf2"> + <refnamediv> + <refname>hash_pbkdf2</refname> + <refpurpose>Belirtilen bir parolanın PBKDF2 anahtar türevini döndürür + </refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis role="procedural"> + <type>string</type><methodname>hash_pbkdf2</methodname> + <methodparam><type>string</type><parameter>algo</parameter></methodparam> + <methodparam><type>string</type><parameter>parola</parameter></methodparam> + <methodparam><type>string</type><parameter>tuz</parameter></methodparam> + <methodparam><type>int</type><parameter>yineleme</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>uzunluk</parameter><initializer>0</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>ikil</parameter><initializer>&false;</initializer></methodparam> + </methodsynopsis> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>algo</parameter></term> + <listitem> + <para> + Seçilen aşlama algoritmasının ismi ("md5", "sha256", "haval160,4" ve + benzerleri). Desteklenen algoritmaların listesi + <function>hash_algos</function> işlevinde bulunabilir. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>parola</parameter></term> + <listitem> + <para> + Türetim için kullanılacak parola. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>tuz</parameter></term> + <listitem> + <para> + Türetim için kullanılacak tuz. Rasgele bir değer üretilmelidir. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>yineleme</parameter></term> + <listitem> + <para> + Türetim için dahili olarak uygulanacak yinelemelerin sayısı. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>uzunluk</parameter></term> + <listitem> + <para> + Çıktı dizgesinin uzunluğu. <parameter>ikil</parameter> &true; ise + türetilen anahtarın bayt cinsinden uzunluğudur; &false; ise türetilen + anahtar uzunluğunun iki katı olmalıdır (her bayt için iki harf/rakam + döner). + </para> + <para> + <literal>0</literal> ise belirtilen algoritmanın tüm çıktısı kullanılır. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>ikil</parameter></term> + <listitem> + <para> + &true; ise ham ikil veri, &false; ise küçük harfli onaltılıklar + çıktılanır. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"><!-- {{{ --> + &reftitle.returnvalues; + <para> + <parameter>ikil</parameter> &true; ise türetilen anahtarın ham ikil gösterimi, + &false; ise küçük harfli onaltılık gösterimi döner + </para> + </refsect1><!-- }}} --> + + <refsect1 role="errors"><!-- {{{ --> + &reftitle.errors; + <para> + Algoritma bilinmiyorsa, <parameter>yineleme</parameter> sıfırdan küçük + veya eşitse, <parameter>uzunluk</parameter> sıfırdan küçükse veya + <parameter>tuz</parameter> çok uzunsa (<constant>INT_MAX</constant><literal> + - 4</literal>'ten büyükse), bir <constant>E_WARNING</constant> çıktılanır. + </para> + </refsect1><!-- }}} --> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>7.2.0</entry> + <entry>Kriptografik olmayan aş işlevlerinin (adler32, crc32, crc32b, + fnv132, fnv1a32, fnv164, fnv1a64, joaat) kullanımı iptal edildi.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- <function>hash_pbkdf2</function> genel kullanım örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +$parola = "password"; +$yineleme = 1000; + +// openssl_random_pseudo_bytes(), random_bytes() +// veya uygun bir rasgelelik kaynağı ile rasgele bir tuz üret +$tuz = openssl_random_pseudo_bytes(16); + +$aş = hash_pbkdf2("sha256", $parola, $tuz, $yineleme, 20); +echo $aş; +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +120fb6cffcf8b32c43e7 +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <caution> + <para> + PBKDF2 yöntemi depolama için parolaları aşlamada kullanılabilir. + Bununla birlikte, <function>password_hash</function> veya + <constant>CRYPT_BLOWFISH</constant> ile <function>crypt</function> + parola depolamaya daha uygundur. + </para> + </caution> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>crypt</function></member> + <member><function>password_hash</function></member> + <member><function>hash</function></member> + <member><function>hash_algos</function></member> + <member><function>hash_init</function></member> + <member><function>hash_hmac</function></member> + <member><function>hash_hmac_file</function></member> + <member><function>openssl_pbkdf2</function></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 +-->
« previous php.doc.tr (#2609) next »