DigestCredentialHandlerBase (Apache Tomcat 8.0.15 API Documentation)

java.lang.Object
- org.apache.catalina.realm.DigestCredentialHandlerBase

All Implemented Interfaces:

CredentialHandler

Direct Known Subclasses:

MessageDigestCredentialHandler, SecretKeyCredentialHandler
```
public abstract class DigestCredentialHandlerBase
extends Object
implements CredentialHandler
```
Base implementation for the Tomcat provided CredentialHandlers.

Field Summary

Fields
Modifier and Type Field and Description

static int DEFAULT_SALT_LENGTH

protected static StringManager sm

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_SALT_LENGTH`
`protected static StringManager`	`sm`

Constructor Summary

Constructors
Constructor and Description

DigestCredentialHandlerBase()

Constructors
Constructor and Description
`DigestCredentialHandlerBase()`

Method Summary

Methods
Modifier and Type	Method and Description
`abstract String`	`getAlgorithm()` Get the algorithm used to convert input credentials to stored credentials.
`protected abstract int`	`getDefaultIterations()` Get the default number of iterations used by the `CredentialHandler`.
`protected int`	`getDefaultSaltLength()` Get the default salt length used by the `CredentialHandler`.
`int`	`getIterations()` Return the number of iterations of the associated algorithm that will be used when creating a new stored credential for a given input credential.
`protected abstract Log`	`getLog()` Obtain the logger for the CredentialHandler instance.
`boolean`	`getLogInvalidStoredCredentials()` When checking input credentials against stored credentials will a warning message be logged if invalid stored credentials are discovered?
`int`	`getSaltLength()` Return the salt length that will be used when creating a new stored credential for a given input credential.
`protected boolean`	`matchesSaltIterationsEncoded(String inputCredentials, String storedCredentials)` Checks whether the provided credential matches the stored credential when the stored credential is in the form salt$iteration-count$credential
`String`	`mutate(String userCredential)` Generates the equivalent stored credentials for the given input credentials.
`protected abstract String`	`mutate(String inputCredentials, byte[] salt, int iterations)` Generates the equivalent stored credentials for the given input credentials, salt and iterations.
`abstract void`	`setAlgorithm(String algorithm)` Set the algorithm used to convert input credentials to stored credentials.
`void`	`setIterations(int iterations)` Set the number of iterations of the associated algorithm that will be used when creating a new stored credential for a given input credential.
`void`	`setLogInvalidStoredCredentials(boolean logInvalidStoredCredentials)` Set whether a warning message will be logged if invalid stored credentials are discovered while checking input credentials against stored credentials?
`void`	`setSaltLength(int saltLength)` Set the salt length that will be used when creating a new stored credential for a given input credential.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.catalina.CredentialHandler
matches

- Field Detail
  - sm
```
protected static final StringManager sm
```
  - DEFAULT_SALT_LENGTH
```
public static final int DEFAULT_SALT_LENGTH
```
    See Also:
    Constant Field Values
- Constructor Detail
  - DigestCredentialHandlerBase
```
public DigestCredentialHandlerBase()
```
- Method Detail
  - getIterations
```
public int getIterations()
```
    Return the number of iterations of the associated algorithm that will be used when creating a new stored credential for a given input credential.
  - setIterations
```
public void setIterations(int iterations)
```
    Set the number of iterations of the associated algorithm that will be used when creating a new stored credential for a given input credential.
  - getSaltLength
```
public int getSaltLength()
```
    Return the salt length that will be used when creating a new stored credential for a given input credential.
  - setSaltLength
```
public void setSaltLength(int saltLength)
```
    Set the salt length that will be used when creating a new stored credential for a given input credential.
  - getLogInvalidStoredCredentials
```
public boolean getLogInvalidStoredCredentials()
```
    When checking input credentials against stored credentials will a warning message be logged if invalid stored credentials are discovered?
  - setLogInvalidStoredCredentials
```
public void setLogInvalidStoredCredentials(boolean logInvalidStoredCredentials)
```
    Set whether a warning message will be logged if invalid stored credentials are discovered while checking input credentials against stored credentials?
  - mutate
```
public String mutate(String userCredential)
```
    Description copied from interface: CredentialHandler
    
    Generates the equivalent stored credentials for the given input credentials.
    
    Specified by:
    
    mutate in interface CredentialHandler
    
    Parameters:
    userCredential - User provided credentials
    
    Returns:
    The equivalent stored credentials for the given input credentials
  - matchesSaltIterationsEncoded
```
protected boolean matchesSaltIterationsEncoded(String inputCredentials,
                                   String storedCredentials)
```
    Checks whether the provided credential matches the stored credential when the stored credential is in the form salt$iteration-count$credential
    
    Parameters:
    inputCredentials - The input credential
    storedCredentials - The stored credential
    
    Returns:
    true if they match, otherwise false
  - getDefaultSaltLength
```
protected int getDefaultSaltLength()
```
    Get the default salt length used by the CredentialHandler.
  - mutate
```
protected abstract String mutate(String inputCredentials,
            byte[] salt,
            int iterations)
```
    Generates the equivalent stored credentials for the given input credentials, salt and iterations.
    
    Parameters:
    inputCredentials - User provided credentials
    salt - Salt, if any
    iterations - Number of iterations of the algorithm associated with this CredentialHandler applied to the inputCredentials to generate the equivalent stored credentials
    
    Returns:
    The equivalent stored credentials for the given input credentials
  - setAlgorithm
```
public abstract void setAlgorithm(String algorithm)
                           throws NoSuchAlgorithmException
```
    Set the algorithm used to convert input credentials to stored credentials.
    
    Throws:
    
    NoSuchAlgorithmException
  - getAlgorithm
```
public abstract String getAlgorithm()
```
    Get the algorithm used to convert input credentials to stored credentials.
  - getDefaultIterations
```
protected abstract int getDefaultIterations()
```
    Get the default number of iterations used by the CredentialHandler.
  - getLog
```
protected abstract Log getLog()
```
    Obtain the logger for the CredentialHandler instance.

Class DigestCredentialHandlerBase

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.apache.catalina.CredentialHandler

Field Detail

sm

DEFAULT_SALT_LENGTH

Constructor Detail

DigestCredentialHandlerBase

Method Detail

getIterations

setIterations

getSaltLength

setSaltLength

getLogInvalidStoredCredentials

setLogInvalidStoredCredentials

mutate

matchesSaltIterationsEncoded

getDefaultSaltLength

mutate

setAlgorithm

getAlgorithm

getDefaultIterations

getLog