The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
XML-Compile-WSS-1.02
River stage one • 4 direct dependents • 5 total dependents
2 ++
/ XML::Compile::SOAP::WSS

NAME

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

INHERITANCE

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

SYNOPSIS

 use XML::Compile::SOAP::WSDL11;
 use XML::Compile::SOAP::WSS;

 # strict order of instantiation!
 my $wss  = XML::Compile::SOAP::WSS->new; # hooks WSDL parser
 my $wsdl = XML::Compile::WSDL11->new($wsdlfn);    

 my $auth = $wss->basicAuth               # add Security record
   ( username => $user
   , password => $password
   );

 # Will include all defined security features
 my $call = $wsdl->compileClient($opname);
 my ($answer, $trace) = $call->(%data);

 # Only explicit security features:
 my $call = $wsdl->compileClient($opname);
 my ($answer, $trace) = $call->(wsse_Security => $auth, %data);
 my $trace = $call->(wsse_Security => [$auth], %data);

DESCRIPTION

The Web Service Security protocol is implemented in extensions of XML::Compile::WSS. This module integrates WSS in SOAP usage.

This module is an XML::Compile::SOAP::Extension, a plugin for the SOAP code. Some of these protocols implemented with these plugins behave badly: interfere with the WSDL specification. Therefore, these WSDL plugins have to be instantiated before the WSDL files get read. The use of the information can only take place when all schema's are read, so these security features can only be created after that.

METHODS

Constructors

XML::Compile::SOAP::WSS->new(OPTIONS)

Usually, you do not call new() but one of the specific constructors. Depends on the WSS feature you need.

Attributes

$obj->addWSS(WSSOBJ)

Add a new XML::Compile::WSS object to the list of maintained.

$obj->schema()
$obj->wssConfigs()

Security features

$obj->basicAuth(OPTIONS)

Implements username/password authentication. See documentation in XML::Compile::WSS::BasicAuth. The OPTIONS are passed to its new() method.

$obj->signature(OPTIONS)

Put a crypto signature on one or more elements. See documentation in XML::Compile::WSS::Signature. The OPTIONS are passed to its new() method.

$obj->timestamp(OPTIONS)

Adds a timestamp record to the Security header. See documentation in XML::Compile::WSS::Timestamp. The OPTIONS are passed to its new() method.

SEE ALSO

This module is part of XML-Compile-WSS distribution version 1.02, built on October 22, 2012. Website: http://perl.overmeer.net/xml-compile/

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

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

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 http://www.perl.com/perl/misc/Artistic.html