POG - Password Operations Gem
Copyright © 2007 Operis Systems, LLC
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License You may obtain a copy of the License at
www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
What is POG?
POG is a Ruby gem for simplifying password hashing and salting, password-hash authentication, password strength testing, and random password generation.
Using POG in your application
-
Install the gem
%> gem install pog
-
Add the following line to your files
require 'pog'
-
You’re ready. The best place to go from here is the documentation for the Password class.
Class Password
Password encapsulates a password and provides functionality for hashing, hash-based authentication, and random password generation.
Class RandomStringGenerator
RandomStringGenerator provides the functionality to generate random Strings. It could be called RandomPasswordGenerator.
Class Salt
Salt encapsulates a password’s salt and provides functionality for password salting and random salt generation.
Class PasswordTests
PasswordTests provides functionality for testing strength of passwords.
Module CharacterRanges
CharacterRanges provides preset ranges for sets of ASCII characters for random password generation. CharacterRanges is mixed into the Password and RandomStringGenerator classes.
Ruby Core Modifications
String
There is an added sanitize
method to completely sanitize a String from memory.