Mark Overmeer > XML-Compile-WSS-Signature-2.01 > XML::Compile::WSS::SignedInfo

Download:
XML-Compile-WSS-Signature-2.01.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 2.01   Source  

NAME ^

XML::Compile::WSS::SignedInfo - administrating a SignedInfo block

SYNOPSIS ^

  # Not for end-users
  my $sig = XML::Compile::WSS::Signature->new(signedinfo => HASH);
  my $si  = $sig->signedinfo;

DESCRIPTION ^

The administration and reading/writing for the SignedInfo structure.

METHODS ^

Constructors

XML::Compile::WSS::SignedInfo->fromConfig(HASH|PAIRS)

All OPTIONS for new()

XML::Compile::WSS::SignedInfo->new(WSS, OPTIONS)
 -Option       --Default
  c14n           <created internally>
  canon_method   C14N_EXC_NO_COMM
  digest_method  DSIG_SHA1
  prefix_list    [ds wsu xenc SOAP-ENV]
  wss            <required>
c14n => XML::Compile::C14N object
canon_method => CANON

The algorithm to be used for canonicalization of some component. These constants are pre-defined with nice C14N_* names in XML::Compile::C14N::Util.

digest_method => DIGEST

The algorithm used to sign the body digest, when sending.

The digest name is an ugly constant which has a nice DSIG_* alias defined in XML::Compile::WSS::Util. The digest is implemented via the Digest module, and its plugins.

prefix_list => ARRAY

Used for canonicalization.

wss => XML::Compile::WSS object

Optional when a c14n is provided.

Attributes

$obj->c14n()
$obj->defaultCanonMethod()
$obj->defaultDigestMethod()
$obj->defaultPrefixList()

Handlers

$obj->builder(WSS, OPTIONS)

Not for end-users. Returns a CODE which will be called to produce the data for a ds_SignedInfo block. The OPTIONS can overrule the defaults set by new()

Digest

Canonicalization

With "canonicalization" you apply a set of rules to translate an XML structure into a standardized ("canonical") format.

XML offers freedom on where to put namespace declarations, blanks between elements, order of attributes, and so on. However, when you want to sign an element, meaningless changes do change the result. Canonical format enforces a set of rules, and produces bytes.

The "Digital Signature v1" supports c14n. DSIG version 2 uses c14n2... which is not yet supported.

SEE ALSO ^

This module is part of XML-Compile-WSS-Signature distribution version 2.01, built on October 11, 2013. 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::WSS::Signature, XML::Compile::Tester, XML::Compile::Cache, XML::Compile::Dumper, XML::Compile::RPC, XML::Rewrite 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 2012-2013 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

syntax highlighting: