module C7Decrypt::Type7
Public Class Methods
This method determines if an encryption seed is valid or not
and throw a specific exeception
@param [FixNum] the seed used in the encryption process @raise [Exceptions::InvalidEncryptionSeed] @return [Nil]
# File lib/c7decrypt/type7/type7.rb, line 151 def self.check_seed(seed) if seed < 0 || seed > 15 raise Exceptions::InvalidEncryptionSeed, "'#{seed.to_s}' seed is not a valid seed (only 0 - 15 allowed)" end return nil end
This method determines if an encrypted hash is corrupted/invalid
and throw a specific exeception
@param [String] the Cisco Type-7 Encrypted String @raise [Exceptions::InvalidFirstCharacter,
Exceptions::InvalidCharacter, Exceptions::OddNumberOfCharacters]
@return [Nil]
# File lib/c7decrypt/type7/type7.rb, line 119 def self.check_type_7_errors(e_text) valid_first_chars = (0..15).to_a.collect {|c| sprintf("%02d", c)} first_char = e_text[0,2] # Check for an invalid first character in the has unless valid_first_chars.include? first_char raise Exceptions::InvalidFirstCharacter, "'#{e_text}' hash contains an invalid first chracter (only '00' - '15' allowed)" end # Check for an invalid character in the hash unless e_text.match(/^[A-Z0-9]+$/) raise Exceptions::InvalidCharacter, "'#{e_text}' hash contains an invalid character (only upper-alpha numeric allowed)" end # Check for an odd number of characters in the hash unless e_text.size % 2 == 0 raise Exceptions::OddNumberOfCharacters, "'#{e_text}' hash contains odd length of chars (only even number of chars allowed)" end return nil end
The Decryption Method for Cisco Type-7 Encrypted Strings @param [String] the Cisco Type-7 Encrypted String @raise [Exceptions::InvalidFirstCharacter,
Exceptions::InvalidCharacter, Exceptions::OddNumberOfCharacters]
@return [String] the Decrypted String
# File lib/c7decrypt/type7/type7.rb, line 13 def self.decrypt(e_text) check_type_7_errors(e_text) d_text = "" seed = nil e_text.scan(/../).each_with_index do |char,i| if i == 0 seed = char.to_i - 1 else d_text += decrypt_char(char, i, seed) end end return d_text end
A helper method to decrypt an arracy of Cisco Type-7 Encrypted Strings @param [Array>String] an array of Cisco Type-7 Encrypted Strings @raise [Exceptions::InvalidFirstCharacter,
Exceptions::InvalidCharacter, Exceptions::OddNumberOfCharacters]
@return [Array>String] an array of Decrypted Strings
# File lib/c7decrypt/type7/type7.rb, line 76 def self.decrypt_array(pw_array) pw_array.collect {|pw| decrypt(pw)} end
The method for decrypting a single character @param [String] the encrypted char @param [Integer] the index of the char pair in encrypted string @param [Integer] the seed used in the decryption process @return [String] the string of the decrypted char
# File lib/c7decrypt/type7/type7.rb, line 66 def self.decrypt_char(char, i, seed) (char.hex^Constants::VT_TABLE[(i + seed) % 53]).chr end
This method scans a raw config file for type 7 passwords and
decrypts them
@param [String] a string of the config file path that contains
Cisco Type-7 Encrypted Strings
@raise [Exceptions::InvalidFirstCharacter,
Exceptions::InvalidCharacter, Exceptions::OddNumberOfCharacters]
@return [Array>String] an array of Decrypted Strings
# File lib/c7decrypt/type7/type7.rb, line 99 def self.decrypt_config(file) f = File.open(file, 'r').to_a decrypt_array(f.collect {|line| type_7_matches(line)}.flatten) end
The Encryption Method for Cisco Type-7 Encrypted Strings @param [String] the plaintext password @param [String] the seed for the encryption used @raise [Exceptions::InvalidEncryptionSeed,
Exceptions::InvalidFirstCharacter, Exceptions::InvalidCharacter, Exceptions::OddNumberOfCharacters]
@return [String] the encrypted password
# File lib/c7decrypt/type7/type7.rb, line 38 def self.encrypt(d_text, seed = 2) check_seed(seed) e_text = sprintf("%02d", seed) d_text.each_char.each_with_index do |d_char,i| e_text += encrypt_char(d_char, i, seed) end check_type_7_errors(e_text) return e_text end
A helper method to encrypt an arracy of passwords @param [Array>String] an array of plain-text passwords @raise [Exceptions::InvalidEncryptionSeed,
Exceptions::InvalidFirstCharacter, Exceptions::InvalidCharacter, Exceptions::OddNumberOfCharacters]
@return [Array>String] an array of encrypted passwords
# File lib/c7decrypt/type7/type7.rb, line 87 def self.encrypt_array(pt_array, seed = 2) pt_array.collect {|pw| encrypt(pw, seed)} end
The method for encrypting a single character @param [String] the plain text char @param [FixNum] the index of the char in plaintext string @param [FixNum] the seed used in the encryption process @return [String] the string of the encrypted char
# File lib/c7decrypt/type7/type7.rb, line 57 def self.encrypt_char(char, i, seed) sprintf("%02X", char.unpack('C')[0] ^ Constants::VT_TABLE[(i + seed) % 53]) end
This method scans a config line for encrypted type-7 passwords and
returns an array of results
@param [String] a line with potential encrypted type-7 passwords @return [Array>String] an array of Cisco type-7 encrypted Strings
# File lib/c7decrypt/type7/type7.rb, line 108 def self.type_7_matches(string) Constants::TYPE_7_REGEXES.collect {|regex| string.scan(regex)}.flatten.uniq end