NAME

CGI::Session::ID::sha512 - CGI::Session ID driver for generating SHA-512 based IDs

SYNOPSIS

    use CGI::Session;
    $session = new CGI::Session('id:sha512', undef);

DESCRIPTION

Use this module to generate SHA-512 encoded hexadecimal IDs for CGI::Session objects. This library does not require any arguments. To use it, add id:sha512 to the DSN string when creating CGI::Session objects.

Keep in mind

Keep in mind that a SHA-512 encoded hexadecimal string will have 128 characters. Don't forget to take this into account when using a database to store your session. For example, when using the default table layout with MySQL you'd want to create a table like:

    CREATE TABLE sessions (
        id CHAR(128) NOT NULL PRIMARY KEY,
        a_session NOT NULL,
    );

CAVEATS

There are no caveats with this module, but rather with the way CGI::Session loads this module:

DSN string converted to lower case

For in depth discourse about this, please read the CGI::Session::ID::sha documentation.

SEE ALSO

CGI::Session, Digest::SHA, and our Web site: http://code.google.com/p/perl-cgi-session-id-sha/.

AUTHOR

Michael De Soto, <desoto@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2008 Michael De Soto. All rights reserved.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.