NAME

Crypt::XKCDCommon1949 - xkcd password style wordlist provider

SYNOPSIS

use Crypt::XKCDCommon1949 qw(xkcd_common_1949);
my @wordlist = xkcd_common_1949;

# but you probably want to use the interface to Crypt::Diceware
# or Crypt::XkcdPassword or Acme::MetaSyntatic described below

DESCRIPTION

Crypt::XKCDCommon1949 providers a simple wordlist based on the 1949 english words most frequently occurening in newspapers published by http://passphra.se (which is in turn based on data published at http://www.paulnoll.com/Books/Clear-English/English-3000-common-words.html)

This list of words is handy as it represents a compromise between having a reasonable number of words to pick from (almost 11 bits of entropy per word) and having a word that someone is likely to be able to remember.

Please be aware that while passwords generated with this wordlist are much more secure than the standard type "human readable" password if many randomly picked words are used to constuct a password, the passwords are not as secure as less readable passwords consisting of random characters (such as those generated by password vault software such as 1Password.) Use at your own risk.

Exported Symbols

Can be exported on demand or used fully qualified

xkcd_common_1949

Function returning 1949 common english words.

@words

Array containing 1949 common english words.

Using this module with other Perl modules

Support is baked in for other modules:

Crypt::Diceware

Crypt::Diceware is the most secure of the options listed here, using proper random numbers to pick the words. It requires non-pure-perl dependancies however.

use Crypt::Diceware words => { wordlist => 'XKCDCommon1949' }
say join " ", words(4);

Crypt::XkcdPassword

Crypt::XkcdPassword can be configured to use proper random numbers, but by default (as in the example shown below) it doesn't.

say Crypt::XkcdPassword->new( words => "XKCDCommon1949" )
                       ->make_password(4);

Acme::MetaSyntatic

For completeness. Doesn't have proper random number generator, relies on List::Util's shuffle method to do the random picking.

use Acme::MetaSyntactic qw( xkcdcommon1949 );
say join " ", metaxkcdcommon1949(4);

AUTHOR

Written by Mark Fowler <mark@twoshortplanks.com>

COPYRIGHT

Copyright Mark Fowler 2013. All Rights Reserved.

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

Note that the majority of this module is just a table of data taken from http://passphras.se. Tables of data aren't generally considered copyrightable (see http://www.lib.umich.edu/copyright-office-mpublishing/copyrightability-charts-tables-and-graphs for an explanation)

BUGS

Bugs should be reported via this distribution's CPAN RT queue. This can be found at https://rt.cpan.org/Dist/Display.html?Crypt-XKCDCommon1949

You can also address issues by forking this distribution on github and sending pull requests. It can be found at http://github.com/2shortplanks/Crypt-XKCDCommon1949

SEE ALSO

http://xkcd.com/936/, http://preshing.com/20110811/xkcd-password-generator

Crypt::Diceware, Crypt::XkcdPassword, Acme::MetaSyntactic