Deprecated API

Contents

• Terminally Deprecated
• Classes
• Fields
• Methods
• Constructors
• Enum Constants

Terminally Deprecated Elements

Element	Description
com.aoapps.security.HashedKey(byte[])	This represents a hash using the previous default algorithm, please use HashedKey(com.aoapps.security.HashedKey.Algorithm, byte[]) instead.
com.aoapps.security.HashedKey.ALGORITHM	This is the value matching the previous default algorithm, please use HashedKey.Algorithm.getAlgorithmName() instead.
com.aoapps.security.HashedKey.Algorithm.hash(byte[])	Please use HashedKey.Algorithm.hash(com.aoapps.security.Key) instead.
com.aoapps.security.HashedKey.Algorithm.validateKey(Function<? super String, Ex>, byte[])	Please use HashedKey.Algorithm.validateKey(java.util.function.Function, com.aoapps.security.Key) instead.
com.aoapps.security.HashedKey.generateKey()	This generates a key for the previous default algorithm, using the previous default of 256-bit length, please use HashedKey.Algorithm.generateKey() instead.
com.aoapps.security.HashedKey.hash(byte[])	This generates a hash for the previous default algorithm and does not zero the key, please use HashedKey.Algorithm.hash(byte[]) instead.
com.aoapps.security.HashedKey.HASH_BYTES	This is the value matching the previous default algorithm, please use HashedKey.Algorithm.getHashBytes() instead.
com.aoapps.security.HashedPassword(byte[], int, byte[])	This represents a hash using the previous default algorithm, please use HashedPassword(com.aoapps.security.Password), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm), or HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int) instead.
com.aoapps.security.HashedPassword(String)	Please use HashedPassword(com.aoapps.security.Password) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, byte[], int)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, byte[], int) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, int)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, int, SecureRandom)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int, java.security.SecureRandom) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, int, Random)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int, java.util.Random) so the password may be destroyed. Please use SecureRandom. This method should only be used after careful consideration.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, SecureRandom)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, java.security.SecureRandom) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, Random)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, java.util.Random) so the password may be destroyed. Please use SecureRandom. This method should only be used after careful consideration.
com.aoapps.security.HashedPassword(String, SecureRandom)	Please use HashedPassword(com.aoapps.security.Password, java.security.SecureRandom) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, Random)	Please use HashedPassword(com.aoapps.security.Password, java.util.Random) so the password may be destroyed. Please use SecureRandom. This method should only be used after careful consideration.
com.aoapps.security.HashedPassword.Algorithm.hash(String, byte[], int)	Please use HashedPassword.Algorithm.hash(com.aoapps.security.Password, byte[], int) so the password may be destroyed.
com.aoapps.security.HashedPassword.generateSalt()	This generates a salt for the previous default algorithm, please use HashedPassword.Algorithm.generateSalt(), HashedPassword(com.aoapps.security.Password), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int) instead.
com.aoapps.security.HashedPassword.hash(String, byte[], int)	This generates a hash for the previous default algorithm and does not allow the password to be destroyed, please use HashedPassword.Algorithm.hash(com.aoapps.security.Password, byte[], int), HashedPassword(com.aoapps.security.Password), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int) instead.
com.aoapps.security.HashedPassword.HASH_BYTES	This is the value matching the previous default algorithm, please use HashedPassword.Algorithm.getHashBytes() instead.
com.aoapps.security.HashedPassword.matches(String)	Please use HashedPassword.matches(com.aoapps.security.Password) so the password may be destroyed.
com.aoapps.security.HashedPassword.RECOMMENDED_ITERATIONS	This is the value matching the previous default algorithm, please use HashedPassword.Algorithm.getRecommendedIterations() instead.
com.aoapps.security.HashedPassword.SALT_BYTES	This is the value matching the previous default algorithm, please use HashedPassword.Algorithm.getSaltBytes() instead.
com.aoapps.security.UnixCrypt	This is not secure anymore. We will be removing in a future major version update. If you still require this type of encryption, please use UnixCrypt.
com.aoapps.security.UnixCrypt.crypt(String)	This is not secure anymore. Please use UnixCrypt.crypt(java.lang.String)
com.aoapps.security.UnixCrypt.crypt(String, String)	This is not secure anymore. Please use UnixCrypt.crypt(java.lang.String, java.lang.String)
com.aoapps.security.UnixCrypt.main(String[])	This is not secure anymore. Please use UnixCrypt

Deprecated Classes

Class	Description
com.aoapps.security.UnixCrypt	This is not secure anymore. We will be removing in a future major version update. If you still require this type of encryption, please use UnixCrypt.

Deprecated Fields

Field	Description
com.aoapps.security.HashedKey.ALGORITHM	This is the value matching the previous default algorithm, please use HashedKey.Algorithm.getAlgorithmName() instead.
com.aoapps.security.HashedKey.HASH_BYTES	This is the value matching the previous default algorithm, please use HashedKey.Algorithm.getHashBytes() instead.
com.aoapps.security.HashedPassword.HASH_BYTES	This is the value matching the previous default algorithm, please use HashedPassword.Algorithm.getHashBytes() instead.
com.aoapps.security.HashedPassword.RECOMMENDED_ITERATIONS	This is the value matching the previous default algorithm, please use HashedPassword.Algorithm.getRecommendedIterations() instead.
com.aoapps.security.HashedPassword.SALT_BYTES	This is the value matching the previous default algorithm, please use HashedPassword.Algorithm.getSaltBytes() instead.

Deprecated Methods

Method	Description
com.aoapps.security.HashedKey.Algorithm.generateKey(Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.
com.aoapps.security.HashedKey.Algorithm.hash(byte[])	Please use HashedKey.Algorithm.hash(com.aoapps.security.Key) instead.
com.aoapps.security.HashedKey.Algorithm.validateKey(Function<? super String, Ex>, byte[])	Please use HashedKey.Algorithm.validateKey(java.util.function.Function, com.aoapps.security.Key) instead.
com.aoapps.security.HashedKey.generateKey()	This generates a key for the previous default algorithm, using the previous default of 256-bit length, please use HashedKey.Algorithm.generateKey() instead.
com.aoapps.security.HashedKey.hash(byte[])	This generates a hash for the previous default algorithm and does not zero the key, please use HashedKey.Algorithm.hash(byte[]) instead.
com.aoapps.security.HashedPassword.Algorithm.generateSalt(Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.
com.aoapps.security.HashedPassword.Algorithm.hash(String, byte[], int)	Please use HashedPassword.Algorithm.hash(com.aoapps.security.Password, byte[], int) so the password may be destroyed.
com.aoapps.security.HashedPassword.generateSalt()	This generates a salt for the previous default algorithm, please use HashedPassword.Algorithm.generateSalt(), HashedPassword(com.aoapps.security.Password), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int) instead.
com.aoapps.security.HashedPassword.hash(String, byte[], int)	This generates a hash for the previous default algorithm and does not allow the password to be destroyed, please use HashedPassword.Algorithm.hash(com.aoapps.security.Password, byte[], int), HashedPassword(com.aoapps.security.Password), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int) instead.
com.aoapps.security.HashedPassword.matches(String)	Please use HashedPassword.matches(com.aoapps.security.Password) so the password may be destroyed.
com.aoapps.security.UnixCrypt.crypt(String)	This is not secure anymore. Please use UnixCrypt.crypt(java.lang.String)
com.aoapps.security.UnixCrypt.crypt(String, String)	This is not secure anymore. Please use UnixCrypt.crypt(java.lang.String, java.lang.String)
com.aoapps.security.UnixCrypt.main(String[])	This is not secure anymore. Please use UnixCrypt

Deprecated Constructors

Constructor	Description
com.aoapps.security.HashedKey(byte[])	This represents a hash using the previous default algorithm, please use HashedKey(com.aoapps.security.HashedKey.Algorithm, byte[]) instead.
com.aoapps.security.HashedKey(HashedKey.Algorithm, byte[])	Please use HashedKey.valueOf(com.aoapps.security.HashedKey.Algorithm, byte[]), which is able to automatically return the HashedKey.NO_KEY singleton.
com.aoapps.security.HashedPassword(byte[], int, byte[])	This represents a hash using the previous default algorithm, please use HashedPassword(com.aoapps.security.Password), HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm), or HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int) instead.
com.aoapps.security.HashedPassword(HashedPassword.Algorithm, byte[], int, byte[])	Please use HashedPassword.valueOf(com.aoapps.security.HashedPassword.Algorithm, byte[], int, byte[]), which is able to automatically return the HashedPassword.NO_PASSWORD singleton.
com.aoapps.security.HashedPassword(Password, HashedPassword.Algorithm, int, Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.
com.aoapps.security.HashedPassword(Password, HashedPassword.Algorithm, Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.
com.aoapps.security.HashedPassword(Password, Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.
com.aoapps.security.HashedPassword(String)	Please use HashedPassword(com.aoapps.security.Password) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, byte[], int)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, byte[], int) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, int)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, int, SecureRandom)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int, java.security.SecureRandom) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, int, Random)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, int, java.util.Random) so the password may be destroyed. Please use SecureRandom. This method should only be used after careful consideration.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, SecureRandom)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, java.security.SecureRandom) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, HashedPassword.Algorithm, Random)	Please use HashedPassword(com.aoapps.security.Password, com.aoapps.security.HashedPassword.Algorithm, java.util.Random) so the password may be destroyed. Please use SecureRandom. This method should only be used after careful consideration.
com.aoapps.security.HashedPassword(String, SecureRandom)	Please use HashedPassword(com.aoapps.security.Password, java.security.SecureRandom) so the password may be destroyed.
com.aoapps.security.HashedPassword(String, Random)	Please use HashedPassword(com.aoapps.security.Password, java.util.Random) so the password may be destroyed. Please use SecureRandom. This method should only be used after careful consideration.
com.aoapps.security.Identifier(Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.
com.aoapps.security.SmallIdentifier(Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.
com.aoapps.security.UnprotectedKey(int, Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.
com.aoapps.security.UnprotectedPassword(Random)	Please use SecureRandom. This method will stay, but will remain deprecated since it should only be used after careful consideration.

Deprecated Enum Constants

Enum Constant	Description
com.aoapps.security.HashedKey.Algorithm.MD5	MD5 should not be used for any cryptographic purpose.
com.aoapps.security.HashedKey.Algorithm.SHA_1	SHA-1 should no longer be used for any cryptographic purpose.
com.aoapps.security.HashedKey.Algorithm.SHA_224	Collision resistance of at least 128 bits is required
com.aoapps.security.HashedKey.Algorithm.SHA_512_224	Collision resistance of at least 128 bits is required
com.aoapps.security.HashedKey.Algorithm.SHA3_224	Collision resistance of at least 128 bits is required
com.aoapps.security.HashedPassword.Algorithm.CRYPT	UnixCrypt should not be used for any cryptographic purpose, plus this is barely salted and not iterated so is subject to both dictionary and brute-force attacks.
com.aoapps.security.HashedPassword.Algorithm.MD5	MD5 should not be used for any cryptographic purpose, plus this is neither salted nor iterated so is subject to both dictionary and brute-force attacks.
com.aoapps.security.HashedPassword.Algorithm.PBKDF2WITHHMACSHA1	This was the previous algorithm used. Please use HashedPassword.Algorithm.PBKDF2WITHHMACSHA512, which is the current HashedPassword.RECOMMENDED_ALGORITHM, for new passwords.
com.aoapps.security.HashedPassword.Algorithm.PBKDF2WITHHMACSHA224	Collision resistance of at least 128 bits is required
com.aoapps.security.HashedPassword.Algorithm.SHA_1	SHA-1 should no longer be used for any cryptographic purpose, plus this is neither salted nor iterated so is subject to both dictionary and brute-force attacks.