The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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