-
Notifications
You must be signed in to change notification settings - Fork 24
/
hash-equals.xml
138 lines (128 loc) · 3.91 KB
/
hash-equals.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa 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><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>bilinen_dzg</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>kullanıcı_dzg</parameter></methodparam>
</methodsynopsis>
<para>
Yürütme sırasında <parameter>bilinen_dzg</parameter> içeriği hakkında
bilgi sızdırmaksızın iki dizgenin eşit olup olmadığına bakar.
</para>
<para>
Bu işlev, zamanlama saldırılarını azaltmak için kullanılabilir.
<code>===</code> ile düzenli karşılaştırma yapmak, iki değerin farklı olup
olmadığına ve ilk farkın hangi konumda bulunabileceğine bağlı olarak daha
fazla veya daha az zaman alacaktır, dolayısıyla
<parameter>bilinen_dzg</parameter> içeriği hakkında bilgi sızdırılacaktır.
</para>
<caution>
<para>
Kullanıcı tarafından sağlanan dizgenin birinci yerine ikinci bağımsız
değişken olarak belirtilmesi önemlidir.
</para>
</caution>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>bilinen_dzg</parameter></term>
<listitem>
<para>
Gizli tutulması gereken dizge.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>kullanıcı_dzg</parameter></term>
<listitem>
<para>
Karşılaştıma için 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="examples">
&reftitle.examples;
<para>
<example xml:id="foobar.examples.basic">
<title>- <function>hash_equals</function> örneği</title>
<programlisting role="php">
<![CDATA[
<?php
$gizliAnahtar = '8uRhAeH89naXfFXKGOEj';
// Değer ve imzayı kullanıcı örn. URL içinde sağlar ve
// $_GET kullanılarak alınır.
$değer = 'username=rasmuslerdorf';
$imza = '8c35009d3b50caf7f5d2c1e031842e6b7823a1bb781d33c5237cd27b57b5f327';
if (hash_equals(hash_hmac('sha256', $değer, $gizliAnahtar), $signature)) {
echo "Değer doğru imzalanmış.", PHP_EOL;
} else {
echo "Değer tahrif edilmiş.", PHP_EOL;
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Değer doğru imzalanmış.
]]>
</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>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>hash_hmac</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
-->