Skip to content

Commit

Permalink
extended documentation
Browse files Browse the repository at this point in the history
Signed-off-by: Arthur Schiwon <blizzz@arthur-schiwon.de>
  • Loading branch information
blizzz committed Feb 21, 2020
1 parent 11a5e99 commit 8e19aaa
Showing 1 changed file with 17 additions and 10 deletions.
27 changes: 17 additions & 10 deletions config/config.sample.php
Expand Up @@ -1425,27 +1425,34 @@
/**
* Hashing
*
* Nextcloud uses the Argon2 algorithm (with PHP >= 7.2) to create hashes by its
* own and exposes its configuration options as following. More information can
* be found at: https://www.php.net/manual/en/function.password-hash.php
* Nextcloud uses the Argon2 algorithm (available with PHP >= 7.2 if compiled
* with it) to create hashes by its own and exposes its configuration options as
* following. The default depends on the PHP build. More information can be
* found at: https://www.php.net/manual/en/function.password-hash.php
*/

/**
* The allowed maximum memory to be used by the algorithm for computing a hash.
* The allowed maximum memory in KiB to be used by the algorithm for computing a
* hash. The smallest possible value is 8. Values that undershoot the minimum
* will be ignored in favor of the default.
*/
'hashingMemoryCost' => PASSWORD_ARGON2_DEFAULT_MEMORY_COST,
'hashingMemoryCost' => 65536,

/**
* The allowed maximum time that can be used by the algorithm for computing a
* hash.
* The allowed maximum time in seconds that can be used by the algorithm for
* computing a hash. The value must be an integer, and the minimum value is 1.
* Values that undershoot the minimum will be ignored in favor of the default.
*/
'hashingTimeCost' => PASSWORD_ARGON2_DEFAULT_TIME_COST,
'hashingTimeCost' => 4,

/**
* The allowed number of CPU threads that can be used by the algorithm for
* computing a hash.
* computing a hash. The value must be an integer, and the minimum value is 1.
* Rationally it does not help to provide a number higher than the available
* threads on the machine. Values that undershoot the minimum will be ignored
* in favor of the default.
*/
'hashingThreads' => PASSWORD_ARGON2_DEFAULT_THREADS,
'hashingThreads' => 1,

/**
* The hashing cost used by hashes generated by Nextcloud
Expand Down

0 comments on commit 8e19aaa

Please sign in to comment.