svn: /phpdoc/de/trunk/reference/password/ constants.xml reference.xml setup.xml

Added: phpdoc/de/trunk/reference/password/constants.xml
===================================================================
--- phpdoc/de/trunk/reference/password/constants.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/password/constants.xml	2018-12-03 17:34:05 UTC (rev 346156)
@@ -0,0 +1,211 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 346125 $ -->
+<!-- EN-Revision: 346125 Maintainer: nobody Status: ready -->
+
+<appendix xml:id="password.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.constants;
+ &extension.constants.core;
+
+ <para>
+  <variablelist>
+   <varlistentry xml:id="constant.password-bcrypt">
+    <term>
+     <constant>PASSWORD_BCRYPT</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <para>
+      <constant>PASSWORD_BCRYPT</constant> wird verwendet um neue Passwort-Hashes
+      unter Verwendung des <constant>CRYPT_BLOWFISH</constant> Algorithmus zu erzeugen.
+     </para>
+     <para>
+      Dies ergibt immer einen Hash, der das "$2y$" Crypt-Format verwendet, und
+      der immer 60 Zeichen lang ist.
+     </para>
+     <para>
+      Unterstützte Optionen:
+     </para>
+     <itemizedlist>
+      <listitem>
+       <para>
+        <literal>salt</literal> (<type>string</type>) - um manuell ein Salt bereit zu stellen,
+        wenn dass Passwort gehasht wird. Es ist zu beachten, dass dies die automatische
+        Erzeugung eines Salt verhindert.
+       </para>
+       <para>
+        Wird diese Option ausgelassen, dann wird von <function>password_hash</function>
+        ein zufälliges Salt für jedes gehashte Passwort erzeugt. Dies ist der vorgesehene
+        Operationsmodus, und von PHP 7.0.0 an ist die salt Option missbilligt.
+       </para>
+      </listitem>
+      <listitem>
+       <para>
+        <literal>cost</literal> (<type>integer</type>) - bezeichnet den algorithmischen Aufwand,
+        der angewendet werden soll. Beispiele dieses Wertes können der <function>crypt</function>
+        Dokumentation entnommen werden.
+       </para>
+       <para>
+        Wird diese Option ausgelassen, dann wird der Standardwert <literal>10</literal>
+        verwendet. Das ist eine gute Ausgangsbasis, aber es ist zu erwägen, diesen Wert
+        in Abhängigkeit von der Hardware zu erhöhen.
+       </para>
+      </listitem>
+     </itemizedlist>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.password-argon2i">
+    <term>
+     <constant>PASSWORD_ARGON2I</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <para>
+      <constant>PASSWORD_ARGON2I</constant> wird verwendet um neue Passwort-Hashes
+      unter Verwendung des Argon2i-Algorithmus zu erzeugen.
+     </para>
+     <para>
+      Unterstützte Optionen:
+     </para>
+     <itemizedlist>
+      <listitem>
+       <para>
+        <literal>memory_cost</literal> (<type>integer</type>) - die Obergrenze des Speichers
+        (in Bytes), die verwendet werden darf, um den Argon2-Hash zu berechnen.
+        Der Vorgabewert ist <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant>.
+       </para>
+      </listitem>
+      <listitem>
+       <para>
+        <literal>time_cost</literal> (<type>integer</type>) - die Höchstdauer der Berechnung
+        des Argon2-Hashs.
+        Der Vorgabewert ist <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant>.
+       </para>
+      </listitem>
+      <listitem>
+       <para>
+        <literal>threads</literal> (<type>integer</type>) - Die Anzahl der Threads, die für
+        die Berechnung des Argon2-Hashs verwendet werden.
+        Der Vorgabewert ist <constant>PASSWORD_ARGON2_DEFAULT_THREADS</constant>.
+       </para>
+      </listitem>
+     </itemizedlist>
+     <para>
+      Verfügbar von PHP 7.2.0 an.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.password-argon2id">
+    <term>
+     <constant>PASSWORD_ARGON2ID</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <para>
+      <constant>PASSWORD_ARGON2ID</constant> wird verwendet um neue Passwort-Hashes
+      unter Verwendung des Argon2id-Algorithmus zu erzeugen. Es werden dieselben Optionen wie bei
+      <link linkend="constant.password-argon2i"><constant>PASSWORD_ARGON2I</constant></link>
+      unterstützt.
+     </para>
+     <para>
+      Verfügbar von PHP 7.3.0 an.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.password-argon2-default-memory-cost">
+    <term>
+     <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <para>
+      Der Vorgabewert des Speichers in Bytes, den Argon2lib beim Versuch den Hash
+      zu berechnen, verwenden wird.
+     </para>
+     <para>
+      Verfügbar von PHP 7.2.0 an.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.password-argon2-default-time-cost">
+    <term>
+     <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <para>
+      Der Vorgabewert der Dauer, die Argon2lib beim Versuch den Hash zu berechnen,
+      verwenden wird.
+     </para>
+     <para>
+      Verfügbar von PHP 7.2.0 an.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.password-argon2-default-threads">
+    <term>
+     <constant>PASSWORD_ARGON2_DEFAULT_THREADS</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <para>
+      Der Vorgabewert der Threads, die Argon2lib verwenden wird.
+     </para>
+     <para>
+      Verfügbar von PHP 7.2.0 an.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.password-default">
+    <term>
+     <constant>PASSWORD_DEFAULT</constant>
+     (<type>integer</type>)
+    </term>
+    <listitem>
+     <para>
+      Der Vorgabewert des Algorithmus, der für das Hashing verwendet wird, wenn
+      kein Algorithmus angegeben wird. Dies kann sich in neueren PHP-Releases ändern,
+      wenn neuere, stärkere Hash-Algorithmen unterstützt werden.
+     </para>
+     <para>
+      Es ist zu betonen, dass sich im Lauf der Zeit diese Konstante ändern kann
+      (und vermutlich wird). Daher ist zu beachten, dass sich die Länge des resultierenden
+      Hashs ändern kann. Also sollte bei Verwendung von <constant>PASSWORD_DEFAULT</constant>
+      der sich ergebende Hash so gespeichert werden, dass er mehr als 60 Zeichen
+      lang sein kann (255 ist die empfohlene Länge).
+     </para>
+     <para>
+      Werte dieser Konstante:
+     </para>
+     <itemizedlist>
+      <listitem>
+       <simpara>
+        PHP 5.5.0 - <constant>PASSWORD_BCRYPT</constant>
+       </simpara>
+      </listitem>
+     </itemizedlist>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </para>
+</appendix>
+
+<!-- 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
+-->

Added: phpdoc/de/trunk/reference/password/reference.xml
===================================================================
--- phpdoc/de/trunk/reference/password/reference.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/password/reference.xml	2018-12-03 17:34:05 UTC (rev 346156)
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 328470 $ -->
+<!-- EN-Revision: 328470 Maintainer: nobody Status: ready -->
+
+<reference xml:id="ref.password" xmlns="http://docbook.org/ns/docbook">
+ <title>Passwort-Hashing-&Functions;</title>
+
+ &reference.password.entities.functions;
+
+</reference>
+
+<!-- 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
+-->

Added: phpdoc/de/trunk/reference/password/setup.xml
===================================================================
--- phpdoc/de/trunk/reference/password/setup.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/password/setup.xml	2018-12-03 17:34:05 UTC (rev 346156)
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 346125 $ -->
+<!-- EN-Revision: 346125 Maintainer: nobody Status: ready -->
+
+<chapter xml:id="password.setup" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+
+ <section xml:id="password.requirements">
+  &reftitle.required;
+  &no.requirement;
+  <para>
+   Für Argon2 Passwort-Hashing wird allerdings <link xlink:href="&url.libargon2;">libargon2</link>
+   benotigt. Von PHP 7.3.0 an wird libargon2 Version 20161029 oder später benötigt.
+  </para>
+ </section>
+
+ <section xml:id="password.installation">
+  &reftitle.install;
+  &no.install;
+  <para>
+   Um Argon2-Passwort-Hashing zu aktivieren, muss PHP allerdings mit libargon2
+   Unterstützung unter Verwendung der Konfigurationsoption
+   <option role="configure">--with-password-argon2[=DIR]</option> kompiliert werden.
+  </para>
+ </section>
+
+ <section xml:id="password.configuration">
+  &reftitle.runtime;
+  &no.config;
+ </section>
+
+ <section xml:id="password.resources">
+  &reftitle.resources;
+  &no.resource;
+ </section>
+
+</chapter>
+
+<!-- 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
+-->