Authen::Passphrase::EggdropBlowfish(3pm)

NAME
Authen::Passphrase::EggdropBlowfish - passphrases using Eggdrop's blowfish.mod

SYNOPSIS
        use Authen::Passphrase::EggdropBlowfish;

        $ppr = Authen::Passphrase::EggdropBlowfish->new(
                hash_base64 => "9tpsG/61YqX/");

        $ppr = Authen::Passphrase::EggdropBlowfish->new(
                passphrase => "passphrase");

        $hash = $ppr->hash;
        $hash_base64 = $ppr->hash_base64;

        if($ppr->match($passphrase)) { ...

DESCRIPTION
An object of this class encapsulates a passphrase hashed using the Blowfish-based algorithm used in Eggdrop's blowfish.mod. This is a subclass of Authen::Passphrase, and this document assumes that the reader is familiar with the documentation for that class.

This hash scheme uses no salt, and does not accept a zero-length passphrase. It uses the passphrase as a Blowfish key to encrypt a standard plaintext block. The hash is the ciphertext block. The standard Blowfish key schedule only accepts keys from 8 to 56 bytes long; this algorithm relaxes that requirement and accepts any non-zero length. Up to 72 bytes of passphrase/key are significant; any more are ignored.

In Eggdrop the hash is represented as a "+" followed by twelve base 64 digits. The first six digits encode the second half of the hash, and the last six encode the first half. Within each half the bytes are encoded in reverse order. The base 64 digits are ".", "/", "0" to "9", "a" to "z", "A" to "Z" (in that order).

Warning: The hash is small by modern standards, and the lack of salt is a weakness in this scheme. For a scheme that makes better use of Blowfish see Authen::Passphrase::BlowfishCrypt.

CONSTRUCTOR

Authen::Passphrase::EggdropBlowfish->new(ATTR => VALUE, ...)
    Generates a new passphrase recogniser object using the Eggdrop blowfish.mod algorithm. The following attributes may be given:

    hash
        The hash, as a string of eight bytes.

    hash_base64
        The hash, as a string of twelve base 64 digits.

    passphrase
        A passphrase that will be accepted.

    Either the hash or the passphrase must be given.

METHODS

$ppr->hash
    Returns the hash value, as a string of eight bytes.

$ppr->hash_base64
    Returns the hash value, as a string of twelve base 64 digits.

$ppr->match(PASSPHRASE)
    This method is part of the standard Authen::Passphrase interface.

SEE ALSO
Authen::Passphrase, Crypt::Eksblowfish::Uklblowfish

AUTHOR
Andrew Main (Zefram) <zefram@fysh.org>

COPYRIGHT
Copyright (C) 2006, 2007, 2009, 2010, 2012 Andrew Main (Zefram) <zefram@fysh.org>

LICENSE
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.