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

See documentation in the base class.

METHODS

See documentation in the base class.

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

See documentation in the base class.

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
 encoding     XML::Compile::WSS::SecToken  WSM10_BASE64
 fingerprint  XML::Compile::WSS::SecToken  <from certificate>
 id           XML::Compile::WSS::SecToken  'my-token'
 type         XML::Compile::WSS::SecToken  XTP10_X509v3
 uri          XML::Compile::WSS::SecToken  <unique>

binary => BYTES

certificate => CERTIFICATE

encoding => WSM10*

fingerprint => STRING

id => wsu::Id

type => TOKENTYPE

uri => NAME

Attributes

See documentation in the base class.

$obj->certificate()

$obj->encoding()

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

$obj->fingerprint()

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

$obj->id()

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

$obj->type()

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

Handlers

See documentation in the base class.

$obj->asBinary()

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

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