Class EnvironmentStringDigesterConfig
- All Implemented Interfaces:
DigesterConfig
,StringDigesterConfig
Implementation for StringDigesterConfig
which can retrieve configuration
values from environment variables or system properties.
The name of the environment variable or system property (JVM property) to query for each parameter can be set with its corresponding setXEnvName or setXSysProperty method.
As this class extends SimpleDigesterConfig
, parameter values
can be also set with the usual setX methods.
For any of the configuration parameters, if its value is not configured in any way, a null value will be returned by the corresponding getX method.
- Since:
- 1.3
- Author:
- Daniel Fernández
-
Constructor Summary
ConstructorsConstructorDescriptionCreates a new EnvironmentStringDigesterConfig instance. -
Method Summary
Modifier and TypeMethodDescriptionAdds the returned (plain) prefix at the beginning of generated digests, and also expects to find it in any plain message provided for matching operations (raising anEncryptionOperationNotPossibleException
if not).Retrieve the name of the environment variable which value has been loaded as a value for the "prefix" parameter.Retrieve the name of the JVM system property which value has been loaded as a value for the "prefix" parameter.This parameter lets the user specify the form in which String output will be encoded.Retrieve the name of the environment variable which value has been loaded as the String output type.Retrieve the name of the JVM system property which value has been loaded as the String output type.Adds the returned (plain) suffix at the end of generated digests, and also expects to find it in any plain message provided for matching operations (raising anEncryptionOperationNotPossibleException
if not).Retrieve the name of the environment variable which value has been loaded as a value for the "suffix" parameter.Retrieve the name of the JVM system property which value has been loaded as a value for the "suffix" parameter.Retrieve the name of the environment variable which value has been loaded as a value for the "unicode normalization ignored" parameter.Retrieve the name of the JVM system property which value has been loaded as a value for the "unicode normalization ignored" parameter.This parameter lets the user specify if the Unicode text normalization step performed during String digest and matching should be ignored.void
Sets the prefix to be added at the beginning of encryption results, and also to be expected at the beginning of plain messages provided for matching operations (raising anEncryptionOperationNotPossibleException
if not).void
setPrefixEnvName
(String prefixEnvName) Set the config object to use the specified environment variable to load the value for the "prefix" parameter.void
setPrefixSysPropertyName
(String prefixSysPropertyName) Set the config object to use the specified JVM system property to load a value for the "prefix" parameter.void
setStringOutputType
(String stringOutputType) Sets the the form in which String output will be encoded.void
setStringOutputTypeEnvName
(String stringOutputTypeEnvName) Set the config object to use the specified environment variable to load the value for the String output type.void
setStringOutputTypeSysPropertyName
(String stringOutputTypeSysPropertyName) Set the config object to use the specified JVM system property to load the value for the String output type.void
Sets the suffix to be added at the end of encryption results, and also to be expected at the end of plain messages provided for matching operations (raising anEncryptionOperationNotPossibleException
if not).void
setSuffixEnvName
(String suffixEnvName) Set the config object to use the specified environment variable to load the value for the "suffix" parameter.void
setSuffixSysPropertyName
(String suffixSysPropertyName) Set the config object to use the specified JVM system property to load a value for the "suffix" parameter.void
setUnicodeNormalizationIgnored
(Boolean unicodeNormalizationIgnored) Sets whether the unicode text normalization step should be ignored.void
setUnicodeNormalizationIgnored
(String unicodeNormalizationIgnored) Sets whether the unicode text normalization step should be ignored.void
setUnicodeNormalizationIgnoredEnvName
(String unicodeNormalizationIgnoredEnvName) Set the config object to use the specified environment variable to load the value for the "unicode normalization ignored" parameter.void
setUnicodeNormalizationIgnoredSysPropertyName
(String unicodeNormalizationIgnoredSysPropertyName) Set the config object to use the specified JVM system property to load a value for the "unicode normalization ignored" parameter.Methods inherited from class org.jasypt.digest.config.EnvironmentDigesterConfig
getAlgorithmEnvName, getAlgorithmSysPropertyName, getInvertPositionOfPlainSaltInEncryptionResultsEnvName, getInvertPositionOfPlainSaltInEncryptionResultsSysPropertyName, getInvertPositionOfSaltInMessageBeforeDigestingEnvName, getInvertPositionOfSaltInMessageBeforeDigestingSysPropertyName, getIterationsEnvName, getIterationsSysPropertyName, getPoolSizeEnvName, getPoolSizeSysPropertyName, getProviderClassNameEnvName, getProviderClassNameSysPropertyName, getProviderNameEnvName, getProviderNameSysPropertyName, getSaltGeneratorClassNameEnvName, getSaltGeneratorClassNameSysPropertyName, getSaltSizeBytesEnvName, getSaltSizeBytesSysPropertyName, getUseLenientSaltSizeCheckEnvName, getUseLenientSaltSizeCheckSysPropertyName, setAlgorithm, setAlgorithmEnvName, setAlgorithmSysPropertyName, setInvertPositionOfPlainSaltInEncryptionResults, setInvertPositionOfPlainSaltInEncryptionResultsEnvName, setInvertPositionOfPlainSaltInEncryptionResultsSysPropertyName, setInvertPositionOfSaltInMessageBeforeDigesting, setInvertPositionOfSaltInMessageBeforeDigestingEnvName, setInvertPositionOfSaltInMessageBeforeDigestingSysPropertyName, setIterations, setIterations, setIterationsEnvName, setIterationsSysPropertyName, setPoolSize, setPoolSize, setPoolSizeEnvName, setPoolSizeSysPropertyName, setProvider, setProviderClassName, setProviderClassNameEnvName, setProviderClassNameSysPropertyName, setProviderName, setProviderNameEnvName, setProviderNameSysPropertyName, setSaltGenerator, setSaltGeneratorClassName, setSaltGeneratorClassNameEnvName, setSaltGeneratorClassNameSysPropertyName, setSaltSizeBytes, setSaltSizeBytes, setSaltSizeBytesEnvName, setSaltSizeBytesSysPropertyName, setUseLenientSaltSizeCheck, setUseLenientSaltSizeCheckEnvName, setUseLenientSaltSizeCheckSysPropertyName
Methods inherited from class org.jasypt.digest.config.SimpleDigesterConfig
getAlgorithm, getInvertPositionOfPlainSaltInEncryptionResults, getInvertPositionOfSaltInMessageBeforeDigesting, getIterations, getPoolSize, getProvider, getProviderName, getSaltGenerator, getSaltSizeBytes, getUseLenientSaltSizeCheck
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.jasypt.digest.config.DigesterConfig
getAlgorithm, getInvertPositionOfPlainSaltInEncryptionResults, getInvertPositionOfSaltInMessageBeforeDigesting, getIterations, getPoolSize, getProvider, getProviderName, getSaltGenerator, getSaltSizeBytes, getUseLenientSaltSizeCheck
-
Constructor Details
-
EnvironmentStringDigesterConfig
public EnvironmentStringDigesterConfig()Creates a new EnvironmentStringDigesterConfig instance.
-
-
Method Details
-
getUnicodeNormalizationIgnoredEnvName
Retrieve the name of the environment variable which value has been loaded as a value for the "unicode normalization ignored" parameter.- Returns:
- the name of the variable
-
setUnicodeNormalizationIgnoredEnvName
Set the config object to use the specified environment variable to load the value for the "unicode normalization ignored" parameter.- Parameters:
unicodeNormalizationIgnoredEnvName
- the name of the environment variable
-
getUnicodeNormalizationIgnoredSysPropertyName
Retrieve the name of the JVM system property which value has been loaded as a value for the "unicode normalization ignored" parameter.- Returns:
- the name of the property
-
setUnicodeNormalizationIgnoredSysPropertyName
public void setUnicodeNormalizationIgnoredSysPropertyName(String unicodeNormalizationIgnoredSysPropertyName) Set the config object to use the specified JVM system property to load a value for the "unicode normalization ignored" parameter.- Parameters:
unicodeNormalizationIgnoredSysPropertyName
- the name of the property
-
getStringOutputTypeEnvName
Retrieve the name of the environment variable which value has been loaded as the String output type.- Returns:
- the name of the variable
-
setStringOutputTypeEnvName
Set the config object to use the specified environment variable to load the value for the String output type.- Parameters:
stringOutputTypeEnvName
- the name of the environment variable
-
getStringOutputTypeSysPropertyName
Retrieve the name of the JVM system property which value has been loaded as the String output type.- Returns:
- the name of the property
-
setStringOutputTypeSysPropertyName
Set the config object to use the specified JVM system property to load the value for the String output type.- Parameters:
stringOutputTypeSysPropertyName
- the name of the property
-
setUnicodeNormalizationIgnored
Sets whether the unicode text normalization step should be ignored.
The Java Virtual Machine internally handles all Strings as UNICODE. When digesting or matching digests in jasypt, these Strings are first normalized to its NFC form so that digest matching is not affected by the specific form in which the messages where input.
It is normally safe (and recommended) to leave this parameter set to its default FALSE value (and thus DO perform normalization operations). But in some specific cases in which issues with legacy software could arise, it might be useful to set this to TRUE.
For more information on unicode text normalization, see this issue of Core Java Technologies Tech Tips.
If not set, null will be returned.
- Parameters:
unicodeNormalizationIgnored
- whether the unicode text normalization step should be ignored or not.
-
setUnicodeNormalizationIgnored
Sets whether the unicode text normalization step should be ignored.
The Java Virtual Machine internally handles all Strings as UNICODE. When digesting or matching digests in jasypt, these Strings are first normalized to its NFC form so that digest matching is not affected by the specific form in which the messages where input.
It is normally safe (and recommended) to leave this parameter set to its default FALSE value (and thus DO perform normalization operations). But in some specific cases in which issues with legacy software could arise, it might be useful to set this to TRUE.
For more information on unicode text normalization, see this issue of Core Java Technologies Tech Tips.
If not set, null will be returned.
- Parameters:
unicodeNormalizationIgnored
- whether the unicode text normalization step should be ignored or not.- Since:
- 1.4
-
setStringOutputType
Sets the the form in which String output will be encoded. Available encoding types are:
- base64 (default)
- hexadecimal
If not set, null will be returned.
- Parameters:
stringOutputType
- the string output type.
-
setPrefix
Sets the prefix to be added at the beginning of encryption results, and also to be expected at the beginning of plain messages provided for matching operations (raising an
EncryptionOperationNotPossibleException
if not).If not set, null will be returned.
Determines the result of:
getPrefix()
- Parameters:
prefix
-- Since:
- 1.7
-
setSuffix
Sets the suffix to be added at the end of encryption results, and also to be expected at the end of plain messages provided for matching operations (raising an
EncryptionOperationNotPossibleException
if not).If not set, null will be returned.
Determines the result of:
getSuffix()
- Parameters:
suffix
-- Since:
- 1.7
-
isUnicodeNormalizationIgnored
Description copied from interface:StringDigesterConfig
This parameter lets the user specify if the Unicode text normalization step performed during String digest and matching should be ignored.
The Java Virtual Machine internally handles all Strings as UNICODE. When digesting or matching digests in jasypt, these Strings are first normalized to its NFC form so that digest matching is not affected by the specific form in which the messages where input.
It is normally safe (and recommended) to leave this parameter set to its default FALSE value (and thus DO perform normalization operations). But in some specific cases in which issues with legacy software could arise, it might be useful to set this to TRUE.
For more information on unicode text normalization, see this issue of Core Java Technologies Tech Tips.
- Specified by:
isUnicodeNormalizationIgnored
in interfaceStringDigesterConfig
- Returns:
- whether the unicode text normalization step should be ignored or not.
-
getStringOutputType
Description copied from interface:StringDigesterConfig
This parameter lets the user specify the form in which String output will be encoded. Available encoding types are:
- base64 (default)
- hexadecimal
- Specified by:
getStringOutputType
in interfaceStringDigesterConfig
- Returns:
- The name of the encoding type for String output
-
getPrefix
Description copied from interface:StringDigesterConfig
Adds the returned (plain) prefix at the beginning of generated digests, and also expects to find it in any plain message provided for matching operations (raising an
EncryptionOperationNotPossibleException
if not).- Specified by:
getPrefix
in interfaceStringDigesterConfig
- Returns:
- the prefix to be added to all digests
-
getSuffix
Description copied from interface:StringDigesterConfig
Adds the returned (plain) suffix at the end of generated digests, and also expects to find it in any plain message provided for matching operations (raising an
EncryptionOperationNotPossibleException
if not).- Specified by:
getSuffix
in interfaceStringDigesterConfig
- Returns:
- the suffix to be added to all digests
-
getPrefixEnvName
Retrieve the name of the environment variable which value has been loaded as a value for the "prefix" parameter.- Returns:
- the name of the variable
- Since:
- 1.7
-
setPrefixEnvName
Set the config object to use the specified environment variable to load the value for the "prefix" parameter.- Parameters:
prefixEnvName
- the name of the environment variable- Since:
- 1.7
-
getPrefixSysPropertyName
Retrieve the name of the JVM system property which value has been loaded as a value for the "prefix" parameter.- Returns:
- the name of the property
- Since:
- 1.7
-
setPrefixSysPropertyName
Set the config object to use the specified JVM system property to load a value for the "prefix" parameter.- Parameters:
prefixSysPropertyName
- the name of the property- Since:
- 1.7
-
getSuffixEnvName
Retrieve the name of the environment variable which value has been loaded as a value for the "suffix" parameter.- Returns:
- the name of the variable
- Since:
- 1.7
-
setSuffixEnvName
Set the config object to use the specified environment variable to load the value for the "suffix" parameter.- Parameters:
suffixEnvName
- the name of the environment variable- Since:
- 1.7
-
getSuffixSysPropertyName
Retrieve the name of the JVM system property which value has been loaded as a value for the "suffix" parameter.- Returns:
- the name of the property
- Since:
- 1.7
-
setSuffixSysPropertyName
Set the config object to use the specified JVM system property to load a value for the "suffix" parameter.- Parameters:
suffixSysPropertyName
- the name of the property- Since:
- 1.7
-