| 1 |
NAME |
| 2 |
Digest::BubbleBabble - Create bubble-babble fingerprints |
| 3 |
|
| 4 |
SYNOPSIS |
| 5 |
# Create a fingerprint of a simple string. |
| 6 |
use Digest::BubbleBabble qw( bubblebabble ); |
| 7 |
my $fingerprint = bubblebabble( Digest => "Pineapple" ); |
| 8 |
|
| 9 |
# Create a fingerprint of a SHA-1 hash. |
| 10 |
use Digest::SHA1 qw( sha1 ); |
| 11 |
$fingerprint = bubblebabble( Digest => sha1("hello") ); |
| 12 |
|
| 13 |
DESCRIPTION |
| 14 |
*Digest::BubbleBabble* takes a message digest (often generated by either |
| 15 |
of the MD5 or SHA-1 message digest algorithms) and creates a fingerprint |
| 16 |
of that digest in "bubble babble" format. Bubble babble is a method of |
| 17 |
representing a message digest as a string of "real" words, to make the |
| 18 |
fingerprint easier to remember. The "words" are not necessarily real |
| 19 |
words, but they look more like words than a string of hex characters. |
| 20 |
|
| 21 |
Bubble babble fingerprinting is used by the SSH2 suite (and, |
| 22 |
consequently, by *Net::SSH::Perl*, the Perl SSH implementation) to |
| 23 |
display easy-to-remember key fingerprints. The key (a DSA or RSA key) is |
| 24 |
converted into a textual form, digested using *Digest::SHA1*, and run |
| 25 |
through *bubblebabble* to create the key fingerprint. |
| 26 |
|
| 27 |
USAGE |
| 28 |
*Digest::BubbleBabble* conditionally exports one function called |
| 29 |
*bubblebabble*; to import the function you must choose to import it, |
| 30 |
like this: |
| 31 |
|
| 32 |
use Digest::BubbleBabble qw( bubblebabble ); |
| 33 |
|
| 34 |
bubblebabble( Digest => $digest ) |
| 35 |
Currently takes only one pair of arguments, the key of which must be |
| 36 |
*Digest*, the value of which is the actual message digest *$digest*. You |
| 37 |
should generate this message digest yourself using either *Digest::MD5* |
| 38 |
of *Digest::SHA1*. |
| 39 |
|
| 40 |
Returns the bubble babble form of the digest. |
| 41 |
|
| 42 |
SEE ALSO |
| 43 |
The BubbleBabble specification is available at: |
| 44 |
http://web.mit.edu/kenta/www/one/bubblebabble/spec/jrtrjwzi/draft-huima- |
| 45 |
01.txt |
| 46 |
|
| 47 |
LICENSE |
| 48 |
Digest::BubbleBabble is free software; you may redistribute it and/or |
| 49 |
modify it under the same terms as Perl itself. |
| 50 |
|
| 51 |
AUTHOR & COPYRIGHTS |
| 52 |
Benjamin Trott, [email protected] |
| 53 |
|
| 54 |
Except where otherwise noted, Digest::BubbleBabble is Copyright 2001 |
| 55 |
Benjamin Trott. All rights reserved. |
| 56 |
|