Mark Overmeer > XML-Compile-WSS-Signature-1.09 > XML::Compile::WSS::SecToken::X509v3

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

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 1.09   Source   Latest Release: XML-Compile-WSS-Signature-2.01

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

syntax highlighting: