PasswordPolicyResponseControl.java revision 6870993d12bf8a2b9d5cd103dc5ccabc42f9bf5d
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at legal-notices/CDDLv1_0.txt.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information:
* Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*
*
* Copyright 2010 Sun Microsystems, Inc.
* Portions Copyright 2012-2014 ForgeRock AS.
*/
/**
* The password policy response control as defined in
* draft-behera-ldap-password-policy.
*
* <pre>
* Connection connection = ...;
* String DN = ...;
* char[] password = ...;
*
* try {
* BindRequest request = Requests.newSimpleBindRequest(DN, password)
* .addControl(PasswordPolicyRequestControl.newControl(true));
*
* BindResult result = connection.bind(request);
*
* PasswordPolicyResponseControl control =
* result.getControl(PasswordPolicyResponseControl.DECODER,
* new DecodeOptions());
* if (!(control == null) && !(control.getWarningType() == null)) {
* // Password policy warning, use control.getWarningType(),
* // and control.getWarningValue().
* }
* } catch (LdapException e) {
* Result result = e.getResult();
* try {
* PasswordPolicyResponseControl control =
* result.getControl(PasswordPolicyResponseControl.DECODER,
* new DecodeOptions());
* if (!(control == null)) {
* // Password policy error, use control.getErrorType().
* }
* } catch (DecodeException de) {
* // Failed to decode the response control.
* }
* } catch (DecodeException e) {
* // Failed to decode the response control.
* }
* </pre>
*
* If the client has sent a passwordPolicyRequest control, the server (when
* solicited by the inclusion of the request control) sends this control with
* the following operation responses: bindResponse, modifyResponse, addResponse,
* compareResponse and possibly extendedResponse, to inform of various
* conditions, and MAY be sent with other operations (in the case of the
* changeAfterReset error).
*
* @see PasswordPolicyRequestControl
* @see PasswordPolicyWarningType
* @see PasswordPolicyErrorType
* @see <a href="http://tools.ietf.org/html/draft-behera-ldap-password-policy">
* draft-behera-ldap-password-policy - Password Policy for LDAP Directories
* </a>
*/
public final class PasswordPolicyResponseControl implements Control {
/**
* The OID for the password policy control from
* draft-behera-ldap-password-policy.
*/
private final int warningValue;
private final PasswordPolicyErrorType errorType;
private final PasswordPolicyWarningType warningType;
/**
* A decoder which can be used for decoding the password policy response
* control.
*/
if (control instanceof PasswordPolicyResponseControl) {
return (PasswordPolicyResponseControl) control;
}
final LocalizableMessage message =
}
// The response control must always have a value.
}
try {
int warningValue = -1;
// Its a CHOICE element. Read as sequence to
// retrieve
// nested element.
if (warningChoiceValue < 0
final LocalizableMessage message =
.peekType()));
} else {
}
}
if (errorValue < 0
final LocalizableMessage message =
} else {
}
}
} catch (final IOException e) {
final LocalizableMessage message =
}
}
return OID;
}
};
/**
* Creates a new password policy response control with the provided error.
*
* @param errorType
* The password policy error type.
* @return The new control.
* @throws NullPointerException
* If {@code errorType} was {@code null}.
*/
}
/**
* Creates a new password policy response control with the provided warning.
*
* @param warningType
* The password policy warning type.
* @param warningValue
* The password policy warning value.
* @return The new control.
* @throws IllegalArgumentException
* If {@code warningValue} was negative.
* @throws NullPointerException
* If {@code warningType} was {@code null}.
*/
public static PasswordPolicyResponseControl newControl(
}
/**
* Creates a new password policy response control with the provided warning
* and error.
*
* @param warningType
* The password policy warning type.
* @param warningValue
* The password policy warning value.
* @param errorType
* The password policy error type.
* @return The new control.
* @throws IllegalArgumentException
* If {@code warningValue} was negative.
* @throws NullPointerException
* If {@code warningType} or {@code errorType} was {@code null}.
*/
public static PasswordPolicyResponseControl newControl(
final PasswordPolicyErrorType errorType) {
}
private final boolean isCritical;
/**
* The BER type value for the warning element of the control value.
*/
private static final byte TYPE_WARNING_ELEMENT = (byte) 0xA0;
/**
* The BER type value for the error element of the control value.
*/
private static final byte TYPE_ERROR_ELEMENT = (byte) 0x81;
private PasswordPolicyResponseControl(final boolean isCritical,
final PasswordPolicyErrorType errorType) {
this.isCritical = isCritical;
this.warningType = warningType;
this.warningValue = warningValue;
}
/**
* Returns the password policy error type, if available.
*
* @return The password policy error type, or {@code null} if this control
* does not contain a error.
*/
public PasswordPolicyErrorType getErrorType() {
return errorType;
}
/** {@inheritDoc} */
return OID;
}
/** {@inheritDoc} */
public ByteString getValue() {
try {
if (warningType != null) {
// Just write the CHOICE element as a single element SEQUENCE.
}
}
return buffer.toByteString();
} catch (final IOException ioe) {
// This should never happen unless there is a bug somewhere.
throw new RuntimeException(ioe);
}
}
/**
* Returns the password policy warning type, if available.
*
* @return The password policy warning type, or {@code null} if this control
* does not contain a warning.
*/
public PasswordPolicyWarningType getWarningType() {
return warningType;
}
/**
* Returns the password policy warning value, if available. The value is
* undefined if this control does not contain a warning.
*
* @return The password policy warning value, or {@code -1} if this control
* does not contain a warning.
*/
public int getWarningValue() {
return warningValue;
}
/** {@inheritDoc} */
public boolean hasValue() {
return true;
}
/** {@inheritDoc} */
public boolean isCritical() {
return isCritical;
}
/** {@inheritDoc} */
if (warningType != null) {
}
}
}
}