package Plack::Middleware::Session::Cookie; use strict; use parent qw(Plack::Middleware::Session); use Plack::Util::Accessor qw(secret session_key domain expires path secure httponly serializer deserializer); use Digest::HMAC_SHA1; use MIME::Base64 (); use Storable (); use Time::HiRes; use Plack::Util; use Plack::Session::State::Cookie; sub prepare_app { my $self = shift; die "Plack::Session::Middleware::Cookie requires setting 'secret' option." unless $self->secret; $self->session_key("plack_session") unless $self->session_key; $self->serializer(sub {MIME::Base64::encode(Storable::nfreeze($_[0]), '' )}) unless $self->serializer; $self->deserializer(sub {Storable::thaw(MIME::Base64::decode($_[0]))}) unless $self->deserializer; $self->state( Plack::Session::State::Cookie->new ); for my $attr (qw(session_key path domain expires secure httponly)) { $self->state->$attr($self->$attr); } } sub _compare { my($s1, $s2) = @_; return if length $s1 != length $s2; my $r = 0; for my $i (0..length($s1) - 1) { $r |= ord(substr $s1, $i) ^ ord(substr $s2, $i); } return $r == 0; } sub get_session { my($self, $request) = @_; my $cookie = $self->state->get_session_id($request) or return; my($time, $b64, $sig) = split /:/, $cookie, 3; _compare($self->sig($b64), $sig) or return; # NOTE: do something with $time? my $session = $self->deserializer->($b64); return ($self->generate_id, $session); } sub generate_id { my $self = shift; return scalar Time::HiRes::gettimeofday; } sub commit { } sub save_state { my($self, $id, $res, $env) = @_; my $cookie = $self->_serialize($id, $env->{'psgix.session'}); $self->state->finalize($cookie, $res, $env->{'psgix.session.options'}); } sub _serialize { my($self, $id, $session) = @_; my $b64 = $self->serializer->($session); join ":", $id, $b64, $self->sig($b64); } sub sig { my($self, $b64) = @_; return '.' unless $self->secret; Digest::HMAC_SHA1::hmac_sha1_hex($b64, $self->secret); } 1; __END__ =head1 NAME Plack::Middleware::Session::Cookie - Session middleware that saves session data in the cookie =head1 SYNOPSIS enable "Session::Cookie"; =head1 DESCRIPTION This middleware component allows you to use the cookie as a sole cookie state and store, without any server side storage to do the session management. This middleware utilizes its own state and store automatically for you, so you can't override the objects. =head1 CONFIGURATIONS This middleware is a subclass of L and accepts most configuration of the parent class. In addition, following options are accepted. =over 4 =item secret Server side secret to sign the session data using HMAC SHA1. Defaults to nothing (i.e. do not sign) but B to set your own secret string. Unless you use your own serializer/deserializer, running this middleware without setting a secret is vulnerable to arbitrary code execution. B. =item session_key, domain, expires, path, secure, httponly Accessors for the cookie attributes. See L for these options. =back =head1 AUTHOR Tatsuhiko Miyagawa =head1 SEE ALSO Rack::Session::Cookie L =cut