/**
* Creates a new user
*
* @param loggedInUser The current user
* @param desiredLogin The login for the new user
* @param desiredPassword The password for the new user
* @param firstName The first name of the new user
* @param lastName The last name of the new user
* @param email The email address for the new user
* @param usePamAuth Should this user authenticate via PAM?
* @return Returns 1 if successful (exception otherwise)
* @throws FaultException A FaultException is thrown if the loggedInUser doesn't have permissions
* to create new users in thier org.
* @xmlrpc.doc Create a new user.
* @xmlrpc.param #param("string", "sessionKey")
* @xmlrpc.param #param_desc("string", "desiredLogin", "Desired login name, will fail if already
* in use.")
* @xmlrpc.param #param("string", "desiredPassword")
* @xmlrpc.param #param("string", "firstName")
* @xmlrpc.param #param("string", "lastName")
* @xmlrpc.param #param_desc("string", "email", "User's e-mail address.")
* @xmlrpc.param #param_desc("int", "usePamAuth", "1 if you wish to use PAM authentication for
* this user, 0 otherwise.")
* @xmlrpc.returntype #return_int_success()
*/
public int create(
User loggedInUser,
String desiredLogin,
String desiredPassword,
String firstName,
String lastName,
String email,
Integer usePamAuth)
throws FaultException {
// Logged in user must be an org admin and we must be on a sat to do this.
ensureOrgAdmin(loggedInUser);
ensurePasswordOrPamAuth(usePamAuth, desiredPassword);
boolean pamAuth = BooleanUtils.toBoolean(usePamAuth, new Integer(1), new Integer(0));
if (pamAuth) {
desiredPassword = getDefaultPasswordForPamAuth();
}
CreateUserCommand command = new CreateUserCommand();
command.setUsePamAuthentication(pamAuth);
command.setLogin(desiredLogin);
command.setPassword(desiredPassword);
command.setFirstNames(firstName);
command.setLastName(lastName);
command.setEmail(email);
command.setOrg(loggedInUser.getOrg());
command.setCompany(loggedInUser.getCompany());
// Validate the user to be
ValidatorError[] errors = command.validate();
if (errors.length > 0) {
StringBuilder errorString = new StringBuilder();
LocalizationService ls = LocalizationService.getInstance();
// Build a sane error message here
for (int i = 0; i < errors.length; i++) {
ValidatorError err = errors[i];
errorString.append(ls.getMessage(err.getKey(), err.getValues()));
if (i != errors.length - 1) {
errorString.append(" :: ");
}
}
// Throw a BadParameterException with our message string
throw new BadParameterException(errorString.toString());
}
command.storeNewUser();
return 1;
}
