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

Extends "DESCRIPTION" in XML::Compile::WSS::SecToken.

METHODS

Extends "METHODS" in XML::Compile::WSS::SecToken.

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

Extends "Constructors" in XML::Compile::WSS::SecToken.

XML::Compile::WSS::SecToken::X509v3->fromConfig($config, %options)

Inherited, 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

Extends "Attributes" in XML::Compile::WSS::SecToken.

$obj->certificate()

$obj->encoding()

Inherited, see "Attributes" in XML::Compile::WSS::SecToken

$obj->fingerprint()

Inherited, see "Attributes" in XML::Compile::WSS::SecToken

$obj->id()

Inherited, see "Attributes" in XML::Compile::WSS::SecToken

$obj->type()

Inherited, see "Attributes" in XML::Compile::WSS::SecToken

Handlers

Extends "Handlers" in XML::Compile::WSS::SecToken.

$obj->asBinary()

Inherited, see "Handlers" in XML::Compile::WSS::SecToken

SEE ALSO

This module is part of XML-Compile-WSS-Signature distribution version 2.02, built on July 16, 2016. Website: http://perl.overmeer.net/xml-compile/

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-2016 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