mbk-lab
/
nextcloud
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Fix Argon2 descriptions 

The threads option for the password_hash function does not define the maximum allowed number of CPU threads to be used by the hashing algorithm but the exact number of threads that is used.

Similarly the memory_cost option for the password_hash function does not define the maximum allowed memory to be used by the hashing algorithm, but the exact amount of memory that is used by the hashing table. The minimum value is 8 KiB per thread.

The time_cost option for the password_hash function does not define the allowed time in seconds, but the number of iterations for the hash function.

If the minimum values are understood, the minimum values are used instead.

Signed-off-by: MichaIng <micha@dietpi.com>
This commit is contained in:
MichaIng 2020-10-09 20:18:32 +02:00 committed by backportbot[bot]
parent 98c22e2c77
commit d8ff570971
1 changed files with 14 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
config/config.sample.php
View File

@ -1530,28 +1530,27 @@ $CONFIG = [
*/ */
/** /**
* The allowed maximum memory in KiB to be used by the algorithm for computing a * The number of CPU threads to be used by the algorithm for computing a hash.
* hash. The smallest possible value is 8. Values that undershoot the minimum * The value must be an integer, and the minimum value is 1. Rationally it does
* will be ignored in favor of the default. * 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 minimum.
*/
'hashingThreads' => PASSWORD_ARGON2_DEFAULT_THREADS,
/**
* The memory in KiB to be used by the algorithm for computing a hash. The value
* must be an integer, and the minimum value is 8 times the number of CPU threads.
* Values that undershoot the minimum will be ignored in favor of the minimum.
*/ */
'hashingMemoryCost' => PASSWORD_ARGON2_DEFAULT_MEMORY_COST, 'hashingMemoryCost' => PASSWORD_ARGON2_DEFAULT_MEMORY_COST,
/** /**
* The allowed maximum time in seconds that can be used by the algorithm for * The number of iterations that are used by the algorithm for computing a hash.
* computing a hash. The value must be an integer, and the minimum value is 1. * The value must be an integer, and the minimum value is 1. Values that
* Values that undershoot the minimum will be ignored in favor of the default. * undershoot the minimum will be ignored in favor of the minimum.
*/ */
'hashingTimeCost' => PASSWORD_ARGON2_DEFAULT_TIME_COST, 'hashingTimeCost' => PASSWORD_ARGON2_DEFAULT_TIME_COST,
/**
* The allowed number of CPU threads that can be used by the algorithm for
* 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,
/** /**
* The hashing cost used by hashes generated by Nextcloud * The hashing cost used by hashes generated by Nextcloud
* Using a higher value requires more time and CPU power to calculate the hashes * Using a higher value requires more time and CPU power to calculate the hashes