/ 
XML-Compile-WSS-Signature-1.09
River stage zero No dependents
/ XML::Compile::WSS::SecToken::X509v3

NAME

XML::Compile::WSS::SecToken::X509v3 - WSS Security Token X509v3 style

INHERITANCE

XML::Compile::WSS::SecToken::X509v3
  is a XML::Compile::WSS::SecToken

SYNOPSIS

# Most verbose
my $certfn = 'cert.pem';
my $cert   = Crypt::OpenSSL::X509->new_from_file($certfn);
my $token  = XML::Compile::WSS::SecToken::X509v3->new
  ( id          => 'some-wsu-id'
  , certificate => $cert
  );
$wss->sigature(token => $token, ...);

# Shortest
$wss->signature(token => $cert, ...);

# More syntax
my $token = XML::Compile::WSS::SecToken->new
  ( type        => XTP10_X509v3
  , id          => 'some-wsu-id'
  , certificate => $cert
  );

my $token = XML::Compile::WSS::SecToken::X509v3
  ->fromFile($cert_fn, format => FORMAT_ASN1);

DESCRIPTION

Use an X509 certificate as security token.

CPAN lists a few modules which wrap a X509 certificate, for the moment only Crypt::OpenSSL::X509 is supported, patches for other implementations are welcomed.

See docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0.pdf

Supported token types

Not supporter (yet)

METHODS

XML::Compile::WSS::SecToken::X509v3->fromFile(FILENAME, OPTIONS)

[1.07] read the certificate from a file. You can pass all OPTIONS provided by new() plus some specific parameters.

-Option--Default
 format  FORMAT_PEM
format => FORMAT_*

The file format is not always auto-detected, so you may need to provide it explicition. The constants are exported by Crypt::OpenSSL::X509

Constructors

XML::Compile::WSS::SecToken::X509v3->fromBinSecToken(WSS, DATA)

See "Constructors" in XML::Compile::WSS::SecToken

XML::Compile::WSS::SecToken::X509v3->fromConfig(CONFIG, OPTIONS)

See "Constructors" in XML::Compile::WSS::SecToken

XML::Compile::WSS::SecToken::X509v3->new(OPTIONS)

Either the certificate object or a cert_file must be specified.

-Option     --Defined in                 --Default
 binary       XML::Compile::WSS::SecToken  undef
 certificate                               undef
 id           XML::Compile::WSS::SecToken  'my-token'
 type         XML::Compile::WSS::SecToken  XTP10_X509v3
binary => BYTES
certificate => CERTIFICATE
id => wsu::Id
type => TOKENTYPE

Attributes

$obj->certificate()
$obj->id()

See "Attributes" in XML::Compile::WSS::SecToken

$obj->type()

See "Attributes" in XML::Compile::WSS::SecToken

Handlers

$obj->asBinary()

See "Handlers" in XML::Compile::WSS::SecToken

$obj->makeBinSecTokenWriter(WSS)

See "Handlers" in XML::Compile::WSS::SecToken

SEE ALSO

This module is part of XML-Compile-WSS-Signature distribution version 1.09, built on January 18, 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, 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 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