com.sap.engine.lib.security

Interface LoginExceptionDetails

public interface LoginExceptionDetails

This interface is to be implemented by providers of jaas login functionality. It is desireable that such components use an implementation of this interface rather than simply throwing LoginException. That way they will be able to provide a more precise information about the cause of the failed logon. Components that login to J2EE Engine will be able to determine that cause and to react accordingly. The possible reasons for a failed logon are defined by the interface constants.

Field Summary

static byte	ACTIVE_USERS_LIMIT_RECHED No more users can login at the moment.
static byte	CERTIFICATE_IS_NOT_TRUSTED The certificate is not in a proper format or does not contain the proper fields.
static byte	CHANGE_PASSWORD_ALPHA_NOT_ALLOWED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_ALPHANUM_REQUIRED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_CHANGE_PASSWORD_NOT_ALLOWED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_FAILED Constant used in all other cases when password change failed.
static byte	CHANGE_PASSWORD_LOWER_CASE_NOT_ALLOWED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_LOWERCASE_REQUIRED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_MIXED_CASE_REQUIRED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_NEW_PASSWORD_INVALID Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_NO_CONFIRM_PASSWORD Confirmation password is missing.
static byte	CHANGE_PASSWORD_NO_IDENTICAL_PASSWORDS New password and confirmation password are not identical.
static byte	CHANGE_PASSWORD_NO_NEW_PASSWORD New password is missing.
static byte	CHANGE_PASSWORD_NO_PASSWORD Old password is missing.
static byte	CHANGE_PASSWORD_NO_PASSWORD_LOGON Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_NUMERIC_NOT_ALLOWED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_NUMERIC_REQUIRED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_OLDPASSWORD_IN_NEWPASSWORD Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_PASSWORD_CONTAINED_IN_HISTORY Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_PASSWORD_MAX_IDLE_TIME_EXCEEDED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_SPEC_CHARS_REQUIRED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_SPECIAL_CHARS_NOT_ALLOWED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_TOO_LONG Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_TOO_MANY_INVALID_LOGON_ATTEMPTS Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_TOO_SHORT Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_USERID_CONTAINED_IN_PASSWORD Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	CHANGE_PASSWORD_WHITESPACES_NOT_ALLOWED Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	DIGEST_CREDENTIALS_NOT_VALID The digest string received from the client is not valid.
static byte	EMERGENCY_USER_IS_ACTIVE The server is in emergency mode.
static byte	HEADER_VARIABLE_AUTHENTICATION_FAILED Authomatic authentication with header variable failed.
static byte	IO_EXCEPTION Some IOException appeared in the proces of getting or setting the security credentials.
static byte	NO_LOGIN_MODULE_SUCCEEDED None of the login modules in the authentication stack succeeded.
static byte	NO_PASSWORD The user has no password but attempts to logon with password.
static byte	NO_USER_MAPPED_TO_THIS_CERTIFICATE The given certificate does not belong to any of the server users.
static byte	P4_TICKET_NOT_VALID The p4 ticket received from the client is not trusted.
static byte	PASSWORD_EXPIRED The user password has expired and / or the password change attempt is not successful.
static byte	PASSWORD_LOCKED User cannot logon because his password is locked.
static byte	PASSWORD_NOT_USED_FOR_LONG_TIME The user cannot logon with password because he has not used it for quite a long time.
static byte	SAP_LOGON_TICKET_HAS_EXPIRED The validity period of the ticket has passed.
static byte	SAP_LOGON_TICKET_IS_NOT_TRUSTED The ticket cannot be accepted on that system.
static byte	SPNEGO_AUTHENTICATION_FAILED Authomatic aunthentication with SPNego failed.
static byte	UNABLE_TO_CREATE_SAP_LOGON_TICKET The creation of SAP Logon Ticket has failed.
static byte	UNABLE_TO_GET_SAP_LOGON_TICKET The server cannot get SAP Logon Ticket from the client
static byte	UNABLE_TO_PASS_SAP_LOGON_TICKET The server cannot pass the created ticket to the client.
static byte	UNKNOWN_CHANGE_PASSWORD_ERROR Deprecated. replaced by CHANGE_PASSWORD_FAILED
static byte	USER_ALREADY_LOGGED_IN User cannot authenticate because he is already logged in.
static byte	USER_IS_CURRENTLY_NOT_VALID The user account is either expired, or is not valid yet.
static byte	USER_IS_LOCKED The user is locked either by the administrator of the system, or after several subsequent failed attempts to login with wrong credentials.
static byte	USER_NOT_LOGGED_IN User cannot log out because he is not logged in.
static byte	USERNAME_IS_NOT_VALID Username does not exists in the userstore.
static byte	WRONG_USERNAME_PASSWORD_COMBINATION User name or password is not correct.

Method Summary

byte	getExceptionCause() Gets the cause of the login exception.

Field Detail

WRONG_USERNAME_PASSWORD_COMBINATION

static final byte WRONG_USERNAME_PASSWORD_COMBINATION

User name or password is not correct.

See Also:

Constant Field Values

PASSWORD_EXPIRED

static final byte PASSWORD_EXPIRED

The user password has expired and / or the password change attempt is not successful.

See Also:

Constant Field Values

USER_IS_CURRENTLY_NOT_VALID

static final byte USER_IS_CURRENTLY_NOT_VALID

The user account is either expired, or is not valid yet.

See Also:

Constant Field Values

USER_IS_LOCKED

static final byte USER_IS_LOCKED

The user is locked either by the administrator of the system, or after several subsequent failed attempts to login with wrong credentials.

See Also:

Constant Field Values

CERTIFICATE_IS_NOT_TRUSTED

static final byte CERTIFICATE_IS_NOT_TRUSTED

The certificate is not in a proper format or does not contain the proper fields.

See Also:

Constant Field Values

NO_USER_MAPPED_TO_THIS_CERTIFICATE

static final byte NO_USER_MAPPED_TO_THIS_CERTIFICATE

The given certificate does not belong to any of the server users.

See Also:

Constant Field Values

SAP_LOGON_TICKET_HAS_EXPIRED

static final byte SAP_LOGON_TICKET_HAS_EXPIRED

The validity period of the ticket has passed.

See Also:

Constant Field Values

SAP_LOGON_TICKET_IS_NOT_TRUSTED

static final byte SAP_LOGON_TICKET_IS_NOT_TRUSTED

The ticket cannot be accepted on that system.

See Also:

Constant Field Values

UNABLE_TO_CREATE_SAP_LOGON_TICKET

static final byte UNABLE_TO_CREATE_SAP_LOGON_TICKET

The creation of SAP Logon Ticket has failed.

See Also:

Constant Field Values

EMERGENCY_USER_IS_ACTIVE

static final byte EMERGENCY_USER_IS_ACTIVE

The server is in emergency mode. Only the emergency user can login.

See Also:

Constant Field Values

UNABLE_TO_PASS_SAP_LOGON_TICKET

static final byte UNABLE_TO_PASS_SAP_LOGON_TICKET

The server cannot pass the created ticket to the client.

See Also:

Constant Field Values

UNABLE_TO_GET_SAP_LOGON_TICKET

static final byte UNABLE_TO_GET_SAP_LOGON_TICKET

The server cannot get SAP Logon Ticket from the client

See Also:

Constant Field Values

DIGEST_CREDENTIALS_NOT_VALID

static final byte DIGEST_CREDENTIALS_NOT_VALID

The digest string received from the client is not valid.

See Also:

Constant Field Values

P4_TICKET_NOT_VALID

static final byte P4_TICKET_NOT_VALID

The p4 ticket received from the client is not trusted.

See Also:

Constant Field Values

ACTIVE_USERS_LIMIT_RECHED

static final byte ACTIVE_USERS_LIMIT_RECHED

No more users can login at the moment.

See Also:

Constant Field Values

USER_ALREADY_LOGGED_IN

static final byte USER_ALREADY_LOGGED_IN

User cannot authenticate because he is already logged in.

See Also:

Constant Field Values

USER_NOT_LOGGED_IN

static final byte USER_NOT_LOGGED_IN

User cannot log out because he is not logged in.

See Also:

Constant Field Values

NO_LOGIN_MODULE_SUCCEEDED

static final byte NO_LOGIN_MODULE_SUCCEEDED

None of the login modules in the authentication stack succeeded.

See Also:

Constant Field Values

IO_EXCEPTION

static final byte IO_EXCEPTION

Some IOException appeared in the proces of getting or setting the security credentials.

See Also:

Constant Field Values

NO_PASSWORD

static final byte NO_PASSWORD

The user has no password but attempts to logon with password.

See Also:

Constant Field Values

PASSWORD_NOT_USED_FOR_LONG_TIME

static final byte PASSWORD_NOT_USED_FOR_LONG_TIME

The user cannot logon with password because he has not used it for quite a long time.

See Also:

Constant Field Values

PASSWORD_LOCKED

static final byte PASSWORD_LOCKED

User cannot logon because his password is locked.

See Also:

Constant Field Values

CHANGE_PASSWORD_NO_PASSWORD

static final byte CHANGE_PASSWORD_NO_PASSWORD

Old password is missing.

See Also:

Constant Field Values

CHANGE_PASSWORD_NO_NEW_PASSWORD

static final byte CHANGE_PASSWORD_NO_NEW_PASSWORD

New password is missing.

See Also:

Constant Field Values

CHANGE_PASSWORD_NO_CONFIRM_PASSWORD

static final byte CHANGE_PASSWORD_NO_CONFIRM_PASSWORD

Confirmation password is missing.

See Also:

Constant Field Values

CHANGE_PASSWORD_NO_IDENTICAL_PASSWORDS

static final byte CHANGE_PASSWORD_NO_IDENTICAL_PASSWORDS

New password and confirmation password are not identical.

See Also:

Constant Field Values

CHANGE_PASSWORD_FAILED

static final byte CHANGE_PASSWORD_FAILED

Constant used in all other cases when password change failed.

See Also:

Constant Field Values

CHANGE_PASSWORD_WHITESPACES_NOT_ALLOWED

static final byte CHANGE_PASSWORD_WHITESPACES_NOT_ALLOWED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must not contains whitespaces.

See Also:

Constant Field Values

CHANGE_PASSWORD_NUMERIC_REQUIRED

static final byte CHANGE_PASSWORD_NUMERIC_REQUIRED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must contains digits.

See Also:

Constant Field Values

CHANGE_PASSWORD_TOO_SHORT

static final byte CHANGE_PASSWORD_TOO_SHORT

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password is too short.

See Also:

Constant Field Values

CHANGE_PASSWORD_TOO_LONG

static final byte CHANGE_PASSWORD_TOO_LONG

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password is too long.

See Also:

Constant Field Values

CHANGE_PASSWORD_LOWERCASE_REQUIRED

static final byte CHANGE_PASSWORD_LOWERCASE_REQUIRED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must contains characters in lower case.

See Also:

Constant Field Values

CHANGE_PASSWORD_SPEC_CHARS_REQUIRED

static final byte CHANGE_PASSWORD_SPEC_CHARS_REQUIRED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must contains special characters.

See Also:

Constant Field Values

CHANGE_PASSWORD_ALPHANUM_REQUIRED

static final byte CHANGE_PASSWORD_ALPHANUM_REQUIRED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must contains alpha and numeric characters.

See Also:

Constant Field Values

CHANGE_PASSWORD_MIXED_CASE_REQUIRED

static final byte CHANGE_PASSWORD_MIXED_CASE_REQUIRED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must contains upper and lower case characters.

See Also:

Constant Field Values

CHANGE_PASSWORD_LOWER_CASE_NOT_ALLOWED

static final byte CHANGE_PASSWORD_LOWER_CASE_NOT_ALLOWED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must not contains characters in lower case.

See Also:

Constant Field Values

CHANGE_PASSWORD_ALPHA_NOT_ALLOWED

static final byte CHANGE_PASSWORD_ALPHA_NOT_ALLOWED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must not include alphas.

See Also:

Constant Field Values

CHANGE_PASSWORD_NUMERIC_NOT_ALLOWED

static final byte CHANGE_PASSWORD_NUMERIC_NOT_ALLOWED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password must not include numeric.

See Also:

Constant Field Values

CHANGE_PASSWORD_SPECIAL_CHARS_NOT_ALLOWED

static final byte CHANGE_PASSWORD_SPECIAL_CHARS_NOT_ALLOWED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password mist not include special characters.

See Also:

Constant Field Values

CHANGE_PASSWORD_CHANGE_PASSWORD_NOT_ALLOWED

static final byte CHANGE_PASSWORD_CHANGE_PASSWORD_NOT_ALLOWED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

Password change is not allowed.

See Also:

Constant Field Values

CHANGE_PASSWORD_USERID_CONTAINED_IN_PASSWORD

static final byte CHANGE_PASSWORD_USERID_CONTAINED_IN_PASSWORD

Deprecated. replaced by CHANGE_PASSWORD_FAILED

User ID cannot be contained in the password.

See Also:

Constant Field Values

CHANGE_PASSWORD_PASSWORD_CONTAINED_IN_HISTORY

static final byte CHANGE_PASSWORD_PASSWORD_CONTAINED_IN_HISTORY

Deprecated. replaced by CHANGE_PASSWORD_FAILED

Cannot set new password. Password is contained in the history.

See Also:

Constant Field Values

CHANGE_PASSWORD_NEW_PASSWORD_INVALID

static final byte CHANGE_PASSWORD_NEW_PASSWORD_INVALID

Deprecated. replaced by CHANGE_PASSWORD_FAILED

New password is not valid.

See Also:

Constant Field Values

CHANGE_PASSWORD_OLDPASSWORD_IN_NEWPASSWORD

static final byte CHANGE_PASSWORD_OLDPASSWORD_IN_NEWPASSWORD

Deprecated. replaced by CHANGE_PASSWORD_FAILED

Old password is found in the new one.

See Also:

Constant Field Values

CHANGE_PASSWORD_NO_PASSWORD_LOGON

static final byte CHANGE_PASSWORD_NO_PASSWORD_LOGON

Deprecated. replaced by CHANGE_PASSWORD_FAILED

Cannot set new password. No password.

See Also:

Constant Field Values

CHANGE_PASSWORD_PASSWORD_MAX_IDLE_TIME_EXCEEDED

static final byte CHANGE_PASSWORD_PASSWORD_MAX_IDLE_TIME_EXCEEDED

Deprecated. replaced by CHANGE_PASSWORD_FAILED

Cannot set new password. The password has expired.

See Also:

Constant Field Values

CHANGE_PASSWORD_TOO_MANY_INVALID_LOGON_ATTEMPTS

static final byte CHANGE_PASSWORD_TOO_MANY_INVALID_LOGON_ATTEMPTS

Deprecated. replaced by CHANGE_PASSWORD_FAILED

Cannot set new password. The password is locked due to many unsuccessful attempts.

See Also:

Constant Field Values

UNKNOWN_CHANGE_PASSWORD_ERROR

static final byte UNKNOWN_CHANGE_PASSWORD_ERROR

Deprecated. replaced by CHANGE_PASSWORD_FAILED

Unknown change password error

See Also:

Constant Field Values

SPNEGO_AUTHENTICATION_FAILED

static final byte SPNEGO_AUTHENTICATION_FAILED

Authomatic aunthentication with SPNego failed.

See Also:

Constant Field Values

HEADER_VARIABLE_AUTHENTICATION_FAILED

static final byte HEADER_VARIABLE_AUTHENTICATION_FAILED

Authomatic authentication with header variable failed.

See Also:

Constant Field Values

USERNAME_IS_NOT_VALID

static final byte USERNAME_IS_NOT_VALID

Username does not exists in the userstore.

See Also:

Constant Field Values

Method Detail

getExceptionCause

byte getExceptionCause()

Gets the cause of the login exception.

Returns:

an identifier of the exception cause.

Access Rights

This class can be accessed from:

SC	DC
[sap.com] SAP_BUILDT	[sap.com] tc/bi/wstech
[sap.com] ENGINEAPI	[sap.com] webservices_lib
[sap.com] ENGFACADE	[sap.com] tc/je/security/api
[sap.com] CORE-TOOLS	[sap.com] com.sap.engine.client.lib