=head1 NAME

XML::Compile::SOAP::WSS - Web Service Security used in SOAP

=head1 INHERITANCE

 XML::Compile::SOAP::WSS
   is a XML::Compile::WSS

 XML::Compile::SOAP::WSS
   is a XML::Compile::SOAP::Extension

=head1 SYNOPSIS

 # use WSS via WSDL,
 use XML::Compile::SOAP::WSDL11;  # first
 use XML::Compile::SOAP::WSS;     # hooks into wsdl

 # you really need next line
 my $wss  = XML::Compile::SOAP::WSS->new(version => '1.1');

 my $wsdl = XML::Compile::WSDL11->new(...);
 my $call = $wsdl->compileClient('some_operation');

 # security header fields start with wss_ or wsu_
 my $token = $wss->wsseBasicAuth($user, $password);
 my ($data, $trace) = $call->(wsse_Security => $token, %data);

=head1 DESCRIPTION

The Web Service Security protocol is implemented by the super
class L<XML::Compile::WSS|XML::Compile::WSS>. This extension seeks to integrate
that specification with SOAP.

=head1 METHODS

=head2 Constructors

=over 4

=item XML::Compile::SOAP::WSS-E<gt>B<new>(OPTIONS)

 -Option --Defined in     --Default
  schema   XML::Compile::WSS  undef
  version  XML::Compile::WSS  <required>

=over 2

=item schema => L<XML::Compile::Cache|XML::Compile::Cache>

=item version => '1.1'|MODULE

=back

=back

=head2 Attributes

=over 4

=item $obj-E<gt>B<schema>()

See L<XML::Compile::WSS/"Attributes">

=item $obj-E<gt>B<version>()

See L<XML::Compile::WSS/"Attributes">

=back

=head2 Simplifications

=over 4

=item $obj-E<gt>B<wsseBasicAuth>(USERNAME, PASSWORD, [PWTYPE, OPTIONS])

See L<XML::Compile::WSS/"Simplifications">

=item $obj-E<gt>B<wsseTimestamp>(CREATED, EXPIRES, OPTIONS)

See L<XML::Compile::WSS/"Simplifications">

=back

=head2 Internals

=over 4

=item $obj-E<gt>B<loadSchemas>(SCHEMA)

See L<XML::Compile::WSS/"Internals">

=back

=head2 SEE ALSO

=head1 SEE ALSO

This module is part of XML-Compile-WSS distribution version 0.911,
built on September 01, 2012. Website: F<http://perl.overmeer.net/xml-compile/>

Other distributions in this suite:
L<XML::Compile>,
L<XML::Compile::SOAP>,
L<XML::Compile::SOAP12>,
L<XML::Compile::SOAP::Daemon>,
L<XML::Compile::SOAP::WSA>,
L<XML::Compile::C14N>,
L<XML::Compile::WSS>,
L<XML::Compile::Tester>,
L<XML::Compile::Cache>,
L<XML::Compile::Dumper>,
L<XML::Compile::RPC>,
L<XML::Rewrite>,
L<XML::eXistDB>,
and
L<XML::LibXML::Simple>.

Please post questions or ideas to the mailinglist at
F<http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/xml-compile>
For live contact with other developers, visit the C<#xml-compile> channel
on C<irc.perl.org>.

=head1 LICENSE

Copyrights 2011-2012 by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
See F<http://www.perl.com/perl/misc/Artistic.html>

