view release on metacpan or  search on metacpan

lib/Authen/Passphrase/SaltedSHA512.pm  view on Meta::CPAN

relates to the random number generator used by Authen::Passphrase.  This
module uses a different random number generator -- not the one from
Authen::Passphrase.  You may decide that if a failure to install traces back
to a random number generation module for Authen::Passphrase a forced install
could still be appropriate.

=head1 DEPENDENCIES

This module has the following non-core immediate dependencies:

=over 4

=item Authen::Passphrase (which provides Authen::Passphrase::SaltedDigest)

=item L<Bytes::Random::Secure|http://search.cpan.org/perldoc?Bytes::Random::Secure>

=back

Each of these has its own list of non-core dependencies as well.  But it's a
well-tested set of dependencies, with broad portability demonstrated by the
smoke tests.  Most important, we're using not only a cryptographically strong
random number generator, but also a strong source to seed the generator.

=head1 CONFIGURATION AND ENVIRONMENT

This module should be installable on most platforms via the traditional CPAN
installers, or by unpacking the tarball and repeating the well-known mantra:

    make
    make test
    make install


=head1 DIAGNOSTICS

As this module subclasses Authen::Passphrase::SaltedDigest, all of the
warnings and diagnostic messages produced by that module will be present in
this module.

=head1 SEE ALSO

=over 4

=item * Additional examples are provided in the C<examples/> folder within
the module's build directory.

=item * L<Authen::Passphrase|http://search.cpan.org/perldoc?Authen::Passphrase>

=item * L<Authen::Passphrase::SaltedDigest|http://search.cpan.org/perldoc?Authen::Passphrase::SaltedDigest>

=item * L<Bytes::Random::Secure|http://search.cpan.org/perldoc?Bytes::Random::Secure>

=item * L<Wikipedia article on SHA-2 (SHA-512)|http://en.wikipedia.org/wiki/SHA-2>

=back

=head1 AUTHOR

David Oswald, C<< <davido at cpan.org> >>

=head1 BUGS AND LIMITATIONS

Please report any bugs or feature requests to
C<bug-authen-passphrase-saltedsha512 at rt.cpan.org>, or through the web
interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Authen-Passphrase-SaltedSHA512>.
I will be notified, and then you'll automatically be notified of progress on
your bug as I make changes.

Password protection and authentication is an arms race of sorts.  For now,
SHA-512 hasn't been broken, and for now, the random number generator used
to generate random salt is considered cryptographically sound.  However,
this module is only one element in what necessarily must be a system-wide
approach to robust security.


=head1 SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Authen::Passphrase::SaltedSHA512


You can also look for information at:

=over 4

=item * This module's GitHub repository

L<http://github.com/daoswald/Authen-Passphrase-SaltedSHA512>

=item * RT: CPAN's request tracker (report bugs here)

L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Authen-Passphrase-SaltedSHA512>

=item * AnnoCPAN: Annotated CPAN documentation

L<http://annocpan.org/dist/Authen-Passphrase-SaltedSHA512>

=item * CPAN Ratings

L<http://cpanratings.perl.org/d/Authen-Passphrase-SaltedSHA512>

=item * Search CPAN

L<http://search.cpan.org/dist/Authen-Passphrase-SaltedSHA512/>

=back


=head1 ACKNOWLEDGEMENTS

Thanks go to the following individuals for providing input, suggestions, or
code:

=over 4

=item * Matt S. Trout -- Suggested the Authen::Passphrase family as a nice
foundation upon which this module could be easily constructed.

=item * M. Aaron Bossert -- Provided some module suggestions that, while
ultimately weren't used, started me on path that combined with further