org.springframework.security.ldap.ppolicy
Class PasswordPolicyResponseControl

java.lang.Object
  org.springframework.security.ldap.ppolicy.PasswordPolicyControl
      org.springframework.security.ldap.ppolicy.PasswordPolicyResponseControl

All Implemented Interfaces:

Serializable, Control

public class PasswordPolicyResponseControl
extends PasswordPolicyControl

Represents the response control received when a PasswordPolicyControl is used when binding to a directory. Currently tested with the OpenLDAP 2.3.19 implementation of the LDAP Password Policy Draft. It extends the request control with the control specific data. This is accomplished by the properties timeBeforeExpiration, graceLoginsRemaining.

Version:

$Id: PasswordPolicyResponseControl.java,v 1.4 2009/03/04 07:25:07 itslxt Exp $

Author:

Stefan Zoerner, Luke Taylor

See Also:

PasswordPolicyControl, Stefan Zoerner's IBM developerworks article on LDAP controls., Serialized Form

Field Summary

Fields inherited from class org.springframework.security.ldap.ppolicy.PasswordPolicyControl

OID

Fields inherited from interface javax.naming.ldap.Control

CRITICAL, NONCRITICAL

Constructor Summary

PasswordPolicyResponseControl(byte[] encodedValue)
Decodes the Ber encoded control data.

Method Summary

byte[]	getEncodedValue() Returns the unchanged value of the response control.
PasswordPolicyErrorStatus	getErrorStatus()
int	getGraceLoginsRemaining() Returns the graceLoginsRemaining.
int	getTimeBeforeExpiration() Returns the timeBeforeExpiration.
boolean	hasError() Checks whether an error is present.
boolean	hasWarning() Checks whether a warning is present.
boolean	isChangeAfterReset()
boolean	isExpired()
boolean	isLocked() Determines whether an account locked error has been returned.
boolean	isUsingGraceLogins()
String	toString() Create a textual representation containing error and warning messages, if any are present.

Methods inherited from class org.springframework.security.ldap.ppolicy.PasswordPolicyControl

getID, isCritical

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PasswordPolicyResponseControl

public PasswordPolicyResponseControl(byte[] encodedValue)

Decodes the Ber encoded control data. The ASN.1 value of the control data is:

    PasswordPolicyResponseValue ::= SEQUENCE {       warning [0] CHOICE {
           timeBeforeExpiration [0] INTEGER (0 .. maxInt),
           graceAuthNsRemaining [1] INTEGER (0 .. maxInt) } OPTIONAL,       error   [1] ENUMERATED {
           passwordExpired             (0),          accountLocked               (1),
           changeAfterReset            (2),          passwordModNotAllowed       (3),
           mustSupplyOldPassword       (4),          insufficientPasswordQuality (5),
           passwordTooShort            (6),          passwordTooYoung            (7),
           passwordInHistory           (8) } OPTIONAL }

Method Detail

getEncodedValue

public byte[] getEncodedValue()

Returns the unchanged value of the response control. Returns the unchanged value of the response control as byte array.

Specified by:

getEncodedValue in interface Control

Overrides:

getEncodedValue in class PasswordPolicyControl

Returns:

always null

getErrorStatus

public PasswordPolicyErrorStatus getErrorStatus()

getGraceLoginsRemaining

public int getGraceLoginsRemaining()

Returns the graceLoginsRemaining.

Returns:

Returns the graceLoginsRemaining.

getTimeBeforeExpiration

public int getTimeBeforeExpiration()

Returns the timeBeforeExpiration.

Returns:

Returns the time before expiration in seconds

hasError

public boolean hasError()

Checks whether an error is present.

Returns:

true, if an error is present

hasWarning

public boolean hasWarning()

Checks whether a warning is present.

Returns:

true, if a warning is present

isExpired

public boolean isExpired()

isChangeAfterReset

public boolean isChangeAfterReset()

isUsingGraceLogins

public boolean isUsingGraceLogins()

isLocked

public boolean isLocked()

Determines whether an account locked error has been returned.

Returns:

true if the account is locked.

toString

public String toString()

Create a textual representation containing error and warning messages, if any are present.

Overrides:

toString in class Object

Returns:

error and warning messages