This update adds expanded password hash compatibility and migration support.
Recommended for new passwords:
Other configurable algorithms:
- PBKDF2_SHA256
- PBKDF2_SHA512
- SALTEDSHA512
- SHA256 - MaxAuth salted SHA-256 same like JPremium SHA256
- SHA512 - MaxAuth salted SHA-512 same like JPremium SHA512
Migration-only hashes accepted from the database:
- SALTEDSHA256
- DOUBLE_SHA512
- AUTHME_SHA256
- AUTHME_SHA
- PBKDF2
- CSHA256 - classic unsalted SHA-256
- CSHA512 - classic unsalted SHA-512
- MD5VB
- IPB3
- IPB4
- JOOMLA
- MYBB
- PHPBB
- PHPFUSION
- SMF
- WBB3
- WBB4
- XFBCRYPT
- ROYALAUTH
- MD5
- SHA1
- DOUBLE_MD5
- DOUBLE_SHA1
- BCRYPT2Y
When
rehashPasswordWhenUsingDifferentAlgorithm is enabled, passwords using legacy or different algorithms are automatically upgraded after successful login.
New password configuration:
Code (YAML):
#+------------------------------------------------------------------------------------------------------+
#| PASSWORDS |
#+------------------------------------------------------------------------------------------------------+
# Password hashing algorithm for new cracked-player passwords.
# Recommended values: ARGON2ID, BCRYPT.
# Other configurable values: PBKDF2_SHA256, PBKDF2_SHA512, SALTEDSHA512, SHA256, SHA512.
# SHA256 and SHA512 are MaxAuth salted hashes. Classic unsalted SHA hashes are migration-only as CSHA256 and CSHA512.
passwordHashingAlgorithm
: ARGON2ID
# Re-hash a password on login when it uses a different algorithm than configured above.
# Useful when migrating from legacy algorithms to ARGON2ID or BCRYPT.
# Migration-only hashes accepted from the database include:
# SALTEDSHA256, DOUBLE_SHA512, AUTHME_SHA256, AUTHME_SHA, PBKDF2, CSHA256, CSHA512,
# MD5VB, IPB3, IPB4, JOOMLA, MYBB, PHPBB, PHPFUSION, SMF, WBB3, WBB4, XFBCRYPT,
# ROYALAUTH, MD5, SHA1, DOUBLE_MD5, DOUBLE_SHA1, BCRYPT2Y.
rehashPasswordWhenUsingDifferentAlgorithm
: true
# Regular expression that cracked-player passwords must match.
# Default: 6-25 non-whitespace characters.
safePasswordPattern
: '
[\S
]
{6,25
}'
Note: Legacy hash support is intended for migration only. For new installations,
ARGON2ID or
BCRYPT is recommended.