password_schema_validator
Password Schema Validator is an extension for Active Model Validations that provides an easy way to validate a password or a string against a user defined schema. This gem is a motivation from the npm module - https://github.com/tarunbatra/password-validator
Install
gem 'password_schema_validator', '~> 1.0'
Usage
Password Schema Validator needs to be used like a usual Rails model validation. Suppose, a field named 'password' is to be validated. For this, a schema needs to be defined with the options available in the 'password_schema_validator' and this schema should to be passed to the 'with_schema' validator.
class User
validates :name, presence: true
validates :password, with_schema: {
min_len: 5,
max_len: 10,
digits: true
}
end
and now, one can use this as .........
user = User.new(name: "duke_nukem", password: "pass")
user.valid? # false
user.errors.messages # { :password => ["must be minimum 5 character long", "must contain digits"] }
user = User.new(name: "duke_nukem", password: "$pass123")
user.valid? # true
Validation Options
| Option key | Value datatype | Description |
|---|---|---|
| min_len | integer |
validates if the password has at least "min_len" characters. |
| max_len | integer |
validates if the password has not more than "max_len" characters. |
| lower_case | boolean |
validates if the password has at least one lower case character. |
| upper_case | boolean |
validates if the password has at least one upper case character. |
| letters | boolean |
validates if the password has at least one letter [a-z, A-Z]. |
| digits | boolean |
validates if the password has at least one numerical character. |
| special_charater | boolean |
validates if the password has at least one special character. |
| discarded_words | array |
validates if the password if not one among the discarded word list. |
ToDo
- Add option to support a dictionary of weak passwords to prevent user from choosing some weak passwords like "password" or "password123".
- Add option to support explicitely specify allowed special characters in the options.
- Documentation via Rdoc.
Contributing
Pull Requests and Bug Fixes are most welcome.
- Fork the Project.
- Run bundle.
- Make your feature branch or Bug-Fix.
- Add tests for it. This is important so that it doesn't break future versions unintentionally.
- Commit the changes without messing with the history or version.
- Create Pull request.