Difference between revisions of "Create password validator"

From OpenKM Documentation
Jump to: navigation, search
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
You can create your own password validation in OpenKM. By default OpenKM has password validation disabled and there's used the '''NoPasswordValidator''' class. Also there's some default OpenKM password validation class called '''CompletePasswordValidator''' class.  
+
You can create your own password validation in OpenKM. By default OpenKM has password validation disabled and uses the '''NoPasswordValidator''' class. Also there's some default OpenKM password validation class called '''CompletePasswordValidator''' class.  
  
 +
Enabling '''CompletePasswordValidator''' class can configure minimum and maximum password length, number of lowercase and uppercase characters, number of numeric characters and number of special characters that appear in a password. You can see more information at [[Application configuration]].
  
−
Enabling '''CompletePasswordValidator''' class can configure minimum and maximum password length, number of lowercase and uppercase characters, number of numeric characters and number of special characters that appearing in password. You can see more information at [[Application_configuration]]
+
You can also create your own password class that must implement the PasswordValidator interface:
−
 
 
−
 
 
−
You can also create your own password class that must implements the PasswordValidator interface:
 
  
 
<source lang="java">
 
<source lang="java">
 
public interface PasswordValidator {
 
public interface PasswordValidator {
 
 
−
/**
+
  /**
−
* Validate
+
  * Validate
−
*  
+
  *  
−
* @param password
+
  * @param password
−
* @throws ValidatorException
+
  * @throws ValidatorException
−
*/
+
  */
−
public void Validate(String password) throws ValidatorException;
+
  public void Validate(String password) throws ValidatorException;
 
 
 +
}
 +
</source>
 +
 +
'''CompletePasswordValidator''' class:
 +
<source lang="java">
 +
/**
 +
* Complex password validator
 +
*/
 +
public class CompletePasswordValidator implements PasswordValidator {
 +
  @SuppressWarnings("unused")
 +
  private static Logger log = LoggerFactory.getLogger(CompletePasswordValidator.class);
 +
 +
  @Override
 +
  public void Validate(String password) throws ValidatorException {
 +
    validateLength(password);
 +
    checkLowerCase(password);
 +
    checkUpperCase(password);
 +
    checkDigits(password);
 +
    checkSpecial(password);
 +
  }
 +
 +
  /**
 +
  * Validate length
 +
  */
 +
  private void validateLength(String password) throws ValidatorException {
 +
    if (Config.VALIDATOR_PASSWORD_MIN_LENGTH > 0 &&
 +
        password.length() < Config.VALIDATOR_PASSWORD_MIN_LENGTH) {
 +
      throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_LENGTH);
 +
    }
 +
 +
    if (Config.VALIDATOR_PASSWORD_MAX_LENGTH > 0 &&
 +
        password.length() > Config.VALIDATOR_PASSWORD_MAX_LENGTH) {
 +
      throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MAX_LENGTH);
 +
    }
 +
  }
 +
 +
  /**
 +
  * Validate lowercase characters
 +
  */
 +
  private void checkLowerCase(String password) throws ValidatorException {
 +
    int count = 0;
 +
 +
    if (Config.VALIDATOR_PASSWORD_MIN_LOWERCASE > 0) {
 +
      for (int i=0; i<password.length(); i++) {
 +
        if (Character.isLowerCase(password.charAt(i))) {
 +
          count ++;
 +
        }
 +
      }
 +
 +
      if (Config.VALIDATOR_PASSWORD_MIN_LOWERCASE > count) {
 +
        throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_LOWERCASE);
 +
      }
 +
    }
 +
  }
 +
 +
  /**
 +
  * Validate uppercase characters
 +
  */
 +
  private void checkUpperCase(String password) throws ValidatorException {
 +
    int count = 0;
 +
 +
    if (Config.VALIDATOR_PASSWORD_MIN_UPPERCASE > 0) {
 +
      for (int i=0; i<password.length(); i++) {
 +
        if (Character.isUpperCase(password.charAt(i))) {
 +
          count ++;
 +
        }
 +
      }
 +
 +
      if (Config.VALIDATOR_PASSWORD_MIN_UPPERCASE > count) {
 +
        throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_UPPERCASE);
 +
      }
 +
    }
 +
  }
 +
 +
  /**
 +
  * Validate digits
 +
  */
 +
  private void checkDigits(String password) throws ValidatorException {
 +
    int count = 0;
 +
 +
    if (Config.VALIDATOR_PASSWORD_MIN_DIGITS > 0) {
 +
      for (int i=0; i<password.length(); i++) {
 +
        if (Character.isDigit(password.charAt(i))) {
 +
          count ++;
 +
        }
 +
      }
 +
 +
      if (Config.VALIDATOR_PASSWORD_MIN_DIGITS > count) {
 +
        throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_DIGITS);
 +
      }
 +
    }
 +
  }
 +
 +
  /**
 +
  * Validate special characters
 +
  */
 +
  private void checkSpecial(String password) throws ValidatorException {
 +
    int count = 0;
 +
 +
    if (Config.VALIDATOR_PASSWORD_MIN_SPECIAL > 0) {
 +
      for (int i=0; i<password.length(); i++) {
 +
        if (!Character.isLetterOrDigit(password.charAt(i)) &&
 +
    !Character.isWhitespace(password.charAt(i))) {
 +
          count ++;
 +
        }
 +
      }
 +
 +
      if (Config.VALIDATOR_PASSWORD_MIN_SPECIAL > count) {
 +
        throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_SPECIAL);
 +
      }
 +
    }
 +
  }
 
}
 
}
 
</source>
 
</source>
  
 
[[Category: Installation Guide]]
 
[[Category: Installation Guide]]
−
[[Category: OKM Network]]
 

Latest revision as of 16:54, 11 December 2012

You can create your own password validation in OpenKM. By default OpenKM has password validation disabled and uses the NoPasswordValidator class. Also there's some default OpenKM password validation class called CompletePasswordValidator class.

Enabling CompletePasswordValidator class can configure minimum and maximum password length, number of lowercase and uppercase characters, number of numeric characters and number of special characters that appear in a password. You can see more information at Application configuration.

You can also create your own password class that must implement the PasswordValidator interface: 

public interface PasswordValidator {
	
  /**
   * Validate
   * 
   * @param password
   * @throws ValidatorException
   */
  public void Validate(String password) throws ValidatorException;
	
}

CompletePasswordValidator class: 

/**
 * Complex password validator
 */
public class CompletePasswordValidator implements PasswordValidator {
  @SuppressWarnings("unused")
  private static Logger log = LoggerFactory.getLogger(CompletePasswordValidator.class);

  @Override
  public void Validate(String password) throws ValidatorException {
    validateLength(password);
    checkLowerCase(password);
    checkUpperCase(password);
    checkDigits(password);
    checkSpecial(password);
  }

  /**
   * Validate length
   */
  private void validateLength(String password) throws ValidatorException {
    if (Config.VALIDATOR_PASSWORD_MIN_LENGTH > 0 && 
        password.length() < Config.VALIDATOR_PASSWORD_MIN_LENGTH) {
      throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_LENGTH); 
    }

    if (Config.VALIDATOR_PASSWORD_MAX_LENGTH > 0 && 
        password.length() > Config.VALIDATOR_PASSWORD_MAX_LENGTH) {
      throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MAX_LENGTH); 
    }
  }

  /**
   * Validate lowercase characters
   */
  private void checkLowerCase(String password) throws ValidatorException {
    int count = 0;

    if (Config.VALIDATOR_PASSWORD_MIN_LOWERCASE > 0) {
      for (int i=0; i<password.length(); i++) {
        if (Character.isLowerCase(password.charAt(i))) {
          count ++;
        }
      }

      if (Config.VALIDATOR_PASSWORD_MIN_LOWERCASE > count) {
        throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_LOWERCASE); 
      }
    }
  }

  /**
   * Validate uppercase characters
   */
  private void checkUpperCase(String password) throws ValidatorException {
    int count = 0;

    if (Config.VALIDATOR_PASSWORD_MIN_UPPERCASE > 0) {
      for (int i=0; i<password.length(); i++) {
        if (Character.isUpperCase(password.charAt(i))) {
          count ++;
        }
      }

      if (Config.VALIDATOR_PASSWORD_MIN_UPPERCASE > count) {
        throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_UPPERCASE); 
      }
    }
  }
	
  /**
   * Validate digits
   */
  private void checkDigits(String password) throws ValidatorException {
    int count = 0;

    if (Config.VALIDATOR_PASSWORD_MIN_DIGITS > 0) {
      for (int i=0; i<password.length(); i++) {
        if (Character.isDigit(password.charAt(i))) {
          count ++;
        }
      }

      if (Config.VALIDATOR_PASSWORD_MIN_DIGITS > count) {
        throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_DIGITS); 
      }
    }
  }

  /**
   * Validate special characters
   */
  private void checkSpecial(String password) throws ValidatorException {
    int count = 0;

    if (Config.VALIDATOR_PASSWORD_MIN_SPECIAL > 0) {
      for (int i=0; i<password.length(); i++) {
        if (!Character.isLetterOrDigit(password.charAt(i)) &&
	    !Character.isWhitespace(password.charAt(i))) {
          count ++;
        }
      }

      if (Config.VALIDATOR_PASSWORD_MIN_SPECIAL > count) {
        throw new ValidatorException(Config.VALIDATOR_PASSWORD_ERROR_MIN_SPECIAL); 
      }
    }
  }
}
Retrieved from "https://www.openkm.com/wiki/index.php?title=Create_password_validator&oldid=8280"