CGI-Application-Plugin-WSSE
---------------------------

Use this module to implement WSSE Username Token authentication in your 
CGI::Application based module.  This protocol is transported over HTTP headers
and is safe to send as clear text while still providing security against
password sniffing and replay attacks.

INSTALLATION

f you have the Module::Signature module installed, you can verify the
integrity of this distribution by typing:

    cpansign -v
    
Module::Signature requires GnuPG which you can get from: 
http://www.gnupg.org/download/
A binary version for Windows is available from that page.
            
Then to install this module, run the following commands:
            
    perl Build.pl
    ./Build
    ./Build test
    ./Build install

On Windows you don't need to type the preliminary ./

Alternatively, you can do:

    perl Makefile.PL
    make
    make test
    make install

If you are using ActiveState perl on Windows and you don't have a make 
utility, you can download nmake from:
http://download.microsoft.com/download/vc15/patch/1.52/w95/en-us/nmake15.exe
(Replace make with nmake in the instructions above if you are using it.)

If you are using Strawberry perl on Windows, it comes with a make utility 
called dmake.  (Replace make with dmake in the instructions above if you are
using it.)

DEPENDENCIES

This module requires version 5.008 or higher of perl and these other modules:

perl             5.008
CGI::Application 4.04
Digest::SHA1

At build time you will need the above modules plus the following if you want
to run the tests:

LWP::Authen::Wsse
Test::WWW::Mechanize::CGIApp

The signature can be tested by installing the following module:

Module::Signature

and setting the environment variable TEST_SIGNATURE to 1.

Further tests are contained in the xt subdirectory of the distribution.  Only
the author really needs to run them but if you want to do so as well, you 
will need to install the following modules:

Perl::Critic           1.098
Perl::MinimumVersion   1.20
Pod::Coverage          0.18
Pod::Simple            3.07
Test::CPAN::Meta       0.12
Test::DistManifest     1.003
Test::HasVersion       0.012
Test::Kwalitee
Test::MinimumVersion   0.008
Test::Perl::Critic     1.01
Test::Pod              1.26
Test::Pod::Coverage    1.08

They are all available on CPAN (http://www.cpan.org)

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc 
command.

    perldoc Authen::Simple::WSSE

You can also look for information at:

    Search CPAN
        http://search.cpan.org/dist/CGI-Application-Plugin-WSSE

    CPAN Request Tracker:
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=CGI-Application-Plugin-WSSE

    AnnoCPAN, annotated CPAN documentation:
        http://annocpan.org/dist/CGI-Application-Plugin-WSSE

    CPAN Ratings:
        http://cpanratings.perl.org/d/CGI-Application-Plugin-WSSE

COPYRIGHT AND LICENCE

Copyright (C) 2011, Consolidated Braincells Inc.  All rights reserved.

This distribution is free software; you can redistribute it and/or modify it
under the terms of either:

a) the GNU General Public License as published by the Free Software
Foundation; either version 2, or (at your option) any later version, or

b) the Artistic License version 2.0.

The full text of the license can be found in the LICENSE file included
with this distribution.