org.opencms.security

接口 I_CmsPasswordHandler

所有超级接口:

I_CmsConfigurationParameterHandler

所有已知实现类:

CmsDefaultPasswordHandler

public interface I_CmsPasswordHandler
extends I_CmsConfigurationParameterHandler

Defines methods for OpenCms password validation.

从以下版本开始:

6.0.0

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	CONVERT_DIGEST_ENCODING Flag for conversion of the password encoding.
static java.lang.String	DIGEST_TYPE_MD5 String to identify the key value for md5 password hashes.
static java.lang.String	DIGEST_TYPE_PLAIN String to identify the key value for unhashed passwords.
static java.lang.String	DIGEST_TYPE_SHA String to identify the key value for sha password hashes.
static java.lang.String	DIGEST_TYPE_SSHA String to identify the key value for sha password hashes with 4 byte salt.

从接口继承的字段 org.opencms.configuration.I_CmsConfigurationParameterHandler

ADD_PARAMETER_METHOD, INIT_CONFIGURATION_METHOD

方法概要

方法

限定符和类型	方法和说明
java.lang.String	digest(java.lang.String password) Creates an OpenCms password digest according to the default setting for method/encodings.
java.lang.String	digest(java.lang.String password, java.lang.String digestType, java.lang.String inputEncoding) Creates an OpenCms password digest.
java.lang.String	getDigestType() Returns the default digest type.
java.lang.String	getInputEncoding() Returns the default password encoding.
void	setDigestType(java.lang.String digestType) Sets the default digest type.
void	setInputEncoding(java.lang.String inputEncoding) Sets the default input encoding.
void	validatePassword(java.lang.String password) This method checks if a new password follows the rules for new passwords, which are defined by a Class configured in the opencms.properties file.

从接口继承的方法 org.opencms.configuration.I_CmsConfigurationParameterHandler

addConfigurationParameter, getConfiguration, initConfiguration

字段详细资料

CONVERT_DIGEST_ENCODING

static final java.lang.String CONVERT_DIGEST_ENCODING

Flag for conversion of the password encoding.

另请参阅:

常量字段值

DIGEST_TYPE_MD5

static final java.lang.String DIGEST_TYPE_MD5

String to identify the key value for md5 password hashes.

另请参阅:

常量字段值

DIGEST_TYPE_PLAIN

static final java.lang.String DIGEST_TYPE_PLAIN

String to identify the key value for unhashed passwords.

另请参阅:

常量字段值

DIGEST_TYPE_SHA

static final java.lang.String DIGEST_TYPE_SHA

String to identify the key value for sha password hashes.

另请参阅:

常量字段值

DIGEST_TYPE_SSHA

static final java.lang.String DIGEST_TYPE_SSHA

String to identify the key value for sha password hashes with 4 byte salt.

另请参阅:

常量字段值

方法详细资料

digest

java.lang.String digest(java.lang.String password)
                        throws CmsPasswordEncryptionException

Creates an OpenCms password digest according to the default setting for method/encodings.

参数:

password - the password to encrypt

返回:

the password digest

抛出:

CmsPasswordEncryptionException - if something goes wrong

digest

java.lang.String digest(java.lang.String password,
                      java.lang.String digestType,
                      java.lang.String inputEncoding)
                        throws CmsPasswordEncryptionException

Creates an OpenCms password digest.

参数:

password - the password to encrypt

digestType - the algorithm used for encryption (i.e. MD5, SHA ...)

inputEncoding - the encoding used when converting the password to bytes (i.e. UTF-8)

返回:

the password digest

抛出:

CmsPasswordEncryptionException - if something goes wrong

getDigestType

java.lang.String getDigestType()

Returns the default digest type.

返回:

the default digest type

getInputEncoding

java.lang.String getInputEncoding()

Returns the default password encoding.

返回:

the default password encoding

setDigestType

void setDigestType(java.lang.String digestType)

Sets the default digest type.

参数:

digestType - the digest type used

setInputEncoding

void setInputEncoding(java.lang.String inputEncoding)

Sets the default input encoding.

参数:

inputEncoding - the encoding used for translation the password string to bytes

validatePassword

void validatePassword(java.lang.String password)
                      throws CmsSecurityException

This method checks if a new password follows the rules for new passwords, which are defined by a Class configured in the opencms.properties file.

If this method throws no exception the password is valid.

参数:

password - the password to check

抛出:

CmsSecurityException - if validation of the password failed