/*
* 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
* trunk/opendj3/legal-notices/CDDLv1_0.txt
* or http://forgerock.org/license/CDDLv1.0.html.
* 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
* trunk/opendj3/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 2011 ForgeRock AS
*/
package com.forgerock.opendj.ldap.tools;
import static com.forgerock.opendj.ldap.tools.ToolsMessages.*;
import static com.forgerock.opendj.ldap.tools.ToolConstants.*;
import static com.forgerock.opendj.ldap.tools.Utils.filterExitCode;
import static org.forgerock.opendj.ldap.ErrorResultException.newErrorResult;
import org.forgerock.i18n.LocalizableMessage;
import org.forgerock.opendj.ldap.*;
import org.forgerock.opendj.ldap.controls.Control;
import org.forgerock.opendj.ldap.requests.PasswordModifyExtendedRequest;
import org.forgerock.opendj.ldap.requests.Requests;
import org.forgerock.opendj.ldap.responses.PasswordModifyExtendedResult;
/**
* A tool that can be used to issue LDAP password modify extended requests to
* the Directory Server. It exposes the three primary options available for this
* operation, which are:
*
* - The user identity whose password should be changed.
* - The current password for the user.
* - The new password for the user.
*
* All of these are optional components that may be included or omitted from the
* request.
*/
public final class LDAPPasswordModify extends ConsoleApplication
{
/**
* Parses the command-line arguments, establishes a connection to the
* Directory Server, sends the password modify request, and reads the
* response.
*
* @param args
* The command-line arguments provided to this program.
*/
public static void main(final String[] args)
{
final int retCode = new LDAPPasswordModify().run(args);
System.exit(filterExitCode(retCode));
}
private BooleanArgument verbose;
private LDAPPasswordModify()
{
// Nothing to do.
}
/**
* {@inheritDoc}
*/
@Override
public boolean isVerbose()
{
return verbose.isPresent();
}
private int run(final String[] args)
{
// Create the command-line argument parser for use with this
// program.
final LocalizableMessage toolDescription = INFO_LDAPPWMOD_TOOL_DESCRIPTION
.get();
final ArgumentParser argParser = new ArgumentParser(
LDAPPasswordModify.class.getName(), toolDescription, false);
ConnectionFactoryProvider connectionFactoryProvider;
ConnectionFactory connectionFactory;
FileBasedArgument currentPWFile;
FileBasedArgument newPWFile;
BooleanArgument showUsage;
IntegerArgument version;
StringArgument currentPW;
StringArgument controlStr;
StringArgument newPW;
StringArgument proxyAuthzID;
StringArgument propertiesFileArgument;
BooleanArgument noPropertiesFileArgument;
try
{
connectionFactoryProvider =
new ConnectionFactoryProvider(argParser, this);
propertiesFileArgument = new StringArgument("propertiesFilePath", null,
OPTION_LONG_PROP_FILE_PATH, false, false, true,
INFO_PROP_FILE_PATH_PLACEHOLDER.get(), null, null,
INFO_DESCRIPTION_PROP_FILE_PATH.get());
argParser.addArgument(propertiesFileArgument);
argParser.setFilePropertiesArgument(propertiesFileArgument);
noPropertiesFileArgument = new BooleanArgument(
"noPropertiesFileArgument", null, OPTION_LONG_NO_PROP_FILE,
INFO_DESCRIPTION_NO_PROP_FILE.get());
argParser.addArgument(noPropertiesFileArgument);
argParser.setNoPropertiesFileArgument(noPropertiesFileArgument);
newPW = new StringArgument("newpw", 'n', "newPassword", false, false,
true, INFO_NEW_PASSWORD_PLACEHOLDER.get(), null, null,
INFO_LDAPPWMOD_DESCRIPTION_NEWPW.get());
newPW.setPropertyName("newPassword");
argParser.addArgument(newPW);
newPWFile = new FileBasedArgument("newpwfile", 'F', "newPasswordFile",
false, false, INFO_FILE_PLACEHOLDER.get(), null, null,
INFO_LDAPPWMOD_DESCRIPTION_NEWPWFILE.get());
newPWFile.setPropertyName("newPasswordFile");
argParser.addArgument(newPWFile);
currentPW = new StringArgument("currentpw", 'c', "currentPassword",
false, false, true, INFO_CURRENT_PASSWORD_PLACEHOLDER.get(), null,
null, INFO_LDAPPWMOD_DESCRIPTION_CURRENTPW.get());
currentPW.setPropertyName("currentPassword");
argParser.addArgument(currentPW);
currentPWFile = new FileBasedArgument("currentpwfile", 'C',
"currentPasswordFile", false, false, INFO_FILE_PLACEHOLDER.get(),
null, null, INFO_LDAPPWMOD_DESCRIPTION_CURRENTPWFILE.get());
currentPWFile.setPropertyName("currentPasswordFile");
argParser.addArgument(currentPWFile);
proxyAuthzID = new StringArgument("authzid", 'a', "authzID", false,
false, true, INFO_PROXYAUTHID_PLACEHOLDER.get(), null, null,
INFO_LDAPPWMOD_DESCRIPTION_AUTHZID.get());
proxyAuthzID.setPropertyName("authzID");
argParser.addArgument(proxyAuthzID);
controlStr = new StringArgument("control", 'J', "control", false, true,
true, INFO_LDAP_CONTROL_PLACEHOLDER.get(), null, null,
INFO_DESCRIPTION_CONTROLS.get());
controlStr.setPropertyName("control");
argParser.addArgument(controlStr);
version = new IntegerArgument("version", OPTION_SHORT_PROTOCOL_VERSION,
OPTION_LONG_PROTOCOL_VERSION, false, false, true,
INFO_PROTOCOL_VERSION_PLACEHOLDER.get(), 3, null,
INFO_DESCRIPTION_VERSION.get());
version.setPropertyName(OPTION_LONG_PROTOCOL_VERSION);
argParser.addArgument(version);
verbose = new BooleanArgument("verbose", 'v', "verbose",
INFO_DESCRIPTION_VERBOSE.get());
verbose.setPropertyName("verbose");
argParser.addArgument(verbose);
showUsage = new BooleanArgument("showUsage", OPTION_SHORT_HELP,
OPTION_LONG_HELP, INFO_DESCRIPTION_SHOWUSAGE.get());
argParser.addArgument(showUsage);
argParser.setUsageArgument(showUsage, getOutputStream());
}
catch (final ArgumentException ae)
{
final LocalizableMessage message = ERR_CANNOT_INITIALIZE_ARGS.get(ae
.getMessage());
println(message);
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
// Parse the command-line arguments provided to this program.
try
{
argParser.parseArguments(args);
// If we should just display usage or version information,
// then print it and exit.
if (argParser.usageOrVersionDisplayed())
{
return 0;
}
connectionFactory =
connectionFactoryProvider.getAuthenticatedConnectionFactory();
}
catch (final ArgumentException ae)
{
final LocalizableMessage message = ERR_ERROR_PARSING_ARGS.get(ae
.getMessage());
println(message);
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
final PasswordModifyExtendedRequest request = Requests
.newPasswordModifyExtendedRequest();
try
{
final int versionNumber = version.getIntValue();
if (versionNumber != 2 && versionNumber != 3)
{
println(ERR_DESCRIPTION_INVALID_VERSION.get(String
.valueOf(versionNumber)));
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
}
catch (final ArgumentException ae)
{
println(ERR_DESCRIPTION_INVALID_VERSION.get(String.valueOf(version
.getValue())));
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
if (controlStr.isPresent())
{
for (final String ctrlString : controlStr.getValues())
{
try
{
final Control ctrl = Utils.getControl(ctrlString);
request.addControl(ctrl);
}
catch (final DecodeException de)
{
final LocalizableMessage message = ERR_TOOL_INVALID_CONTROL_STRING
.get(ctrlString);
println(message);
ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
}
}
if (newPW.isPresent() && newPWFile.isPresent())
{
final LocalizableMessage message = ERR_LDAPPWMOD_CONFLICTING_ARGS.get(
newPW.getLongIdentifier(), newPWFile.getLongIdentifier());
println(message);
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
if (currentPW.isPresent() && currentPWFile.isPresent())
{
final LocalizableMessage message = ERR_LDAPPWMOD_CONFLICTING_ARGS.get(
currentPW.getLongIdentifier(), currentPWFile.getLongIdentifier());
println(message);
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
Connection connection;
try
{
connection = connectionFactory.getConnection();
}
catch (final ErrorResultException ere)
{
return Utils.printErrorMessage(this, ere);
}
catch (final InterruptedException e)
{
// This shouldn't happen because there are no other threads to
// interrupt this one.
println(LocalizableMessage.raw(e.getLocalizedMessage()));
return ResultCode.CLIENT_SIDE_USER_CANCELLED.intValue();
}
if (proxyAuthzID.isPresent())
{
request.setUserIdentity(proxyAuthzID.getValue());
}
if (currentPW.isPresent())
{
request.setOldPassword(ByteString.valueOf(currentPW.getValue()));
}
else if (currentPWFile.isPresent())
{
request.setOldPassword(ByteString.valueOf(currentPWFile.getValue()));
}
if (newPW.isPresent())
{
request.setNewPassword(ByteString.valueOf(newPW.getValue()));
}
else if (newPWFile.isPresent())
{
request.setNewPassword(ByteString.valueOf(newPWFile.getValue()));
}
PasswordModifyExtendedResult result;
try
{
try
{
result = connection.extendedRequest(request);
}
catch (final InterruptedException e)
{
// This shouldn't happen because there are no other threads to
// interrupt this one.
throw newErrorResult(ResultCode.CLIENT_SIDE_USER_CANCELLED,
e.getLocalizedMessage(), e);
}
}
catch (final ErrorResultException e)
{
LocalizableMessage message = ERR_LDAPPWMOD_FAILED
.get(e.getResult().getResultCode().intValue(), e.getResult()
.getResultCode().toString());
println(message);
final String errorMessage = e.getResult().getDiagnosticMessage();
if ((errorMessage != null) && (errorMessage.length() > 0))
{
message = ERR_LDAPPWMOD_FAILURE_ERROR_MESSAGE.get(errorMessage);
println(message);
}
final String matchedDN = e.getResult().getMatchedDN();
if (matchedDN != null && matchedDN.length() > 0)
{
message = ERR_LDAPPWMOD_FAILURE_MATCHED_DN.get(matchedDN);
println(message);
}
return e.getResult().getResultCode().intValue();
}
LocalizableMessage message = INFO_LDAPPWMOD_SUCCESSFUL.get();
println(message);
final String additionalInfo = result.getDiagnosticMessage();
if ((additionalInfo != null) && (additionalInfo.length() > 0))
{
message = INFO_LDAPPWMOD_ADDITIONAL_INFO.get(additionalInfo);
println(message);
}
if (result.getGeneratedPassword() != null)
{
message = INFO_LDAPPWMOD_GENERATED_PASSWORD.get(result
.getGeneratedPassword().toString());
println(message);
}
return 0;
}
}