NAME

Net::Domain::TMCH::CRL - TMCH Certificates Revokation List

INHERITANCE

 Net::Domain::TMCH::CRL
   is a Exporter

SYNOPSIS

  # End-user interface

  my $tmch = Net::Domain::TMCH->new
    ( ...
    , cert_revocations => $fn    # or $uri
    );
  $crl = $tmch->crl;

  # create explicitly

  my $crl  = Net::Domain::TMCH::CRL->fromFile($fn, %options);
  my $crl  = Net::Domain::TMCH::CRL->fromURI($uri, %options);
  my $crl  = Net::Domain::TMCH::CRL->new(source => 'hardcoded'
    , revoked => \@serials);
  my $tmch = Net::Domain::TMCH->new(..., cert_revocations => $crl);

  if($crl->isRevoked($certificate)) ...
  if($crl->isRevoked($certificate->serial)) ...

DESCRIPTION

Draft RFC http://tools.ietf.org/html/draft-lozano-tmch-func-07 specifies a way for TLD (domain registries) to exchange trademark rights (brand registrations). This module manages the revocation list for TMV (Trademark Validator) certificates.

METHODS

Constructors

$obj->fromFile(FILENAME, OPTIONS)

Read a CRL from file, for instance a cached or test CRL. The OPTIONS are passed to new().

$obj->fromString(STRING, OPTIONS)

Read a CRL from STRING, for instance a cached or test CRL. The OPTIONS are passed to new().

$obj->fromURI(URI, OPTIONS)

Create a new CRL object from an URI, which is collected via LWP. The OPTIONS are passed to new().

Net::Domain::TMCH::CRL->new(OPTIONS)
 -Option --Default
  revoked  []
  source   <required>
revoked => HASH|ARRAY

ARRAY of serial numbers from revoked certificates, or a HASH of which the keys are the revoked serials.

source => STRING|FILENAME|URI

Identification for the source of this list, to be used in error message and such.

Attributes

$obj->source()

Actions

$obj->isRevoked(CERTIFICATE|SERIAL)

Checks whether a CERTIFICATE (Crypt::OpenSSL::X509 object) has been revoked. It is sufficient to provide a SERIAL number of the certificate.

SEE ALSO

This module is part of Net-Domain-TMCH distribution version 0.17, built on January 13, 2014. Development was supported by NIC.at, the Austrian Domainname Registry.

 Website: F<http://perl.overmeer.net/net-domain-tmch/>

The documentation and interface style is consistent with a large set of modules, belonging to the XML::Compile suite.

LICENSE

Copyrights 2013-2014 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