NAME

Net::Trustico - Perl extension for ordering SSL certificates from Trustico via their API.

SYNOPSIS

  use Net::Trustico;
  
  my $t = Net::Trustico->new( username => $user, password => $pass );

  die unless $t->hello( $testString );

  my $a = {
    title => 'Ms',
    firstname => 'Eliza',
    lastname => 'Xample',
    organisation => 'E.Xample',
    role => 'WebSite Owner',
    email => 'e.xample@example.com',
    phonecc => '44',
    phoneac => '020',
    phonen => '9460234',
    address1 => '1 High Street',
    city => 'MyTown',
    state => 'London',
    postcode => 'SW1 4AA',
    country => 'GB'
  };

  my $t = $a;

  my %result = $t->order( product => $product,
                          csr => $csr,
                          period => 12,
                          approver => 'admin@example.com',
                          insurance => 0,
                          servercount => 1,
                          admin => $a,
                          techusereseller => 1,
                          novalidation => 0
                          );

  my $status = $t->status( orderid => $id );

DESCRIPTION

Perl module for ordering SSL certificates from Trustico.

METHODS

new

Initiates the module.

Parameters:

username - your Trustico reseller account username

password - the password for your reseller account.

hello

Tests the connection to the Trustico API by sending a string of text and testing that the same string is returned.

This function returns true if the connection is OK or false if not.

You can call this method with a string of your own or no parameters. If no parameters are passed a standard string is used to test the connection.

order

Submits an order to the Trustico API and returns a hash reference confirming order details on success or undef.

Parameters:

product - the product code for the relevant product as provided by the products() method.

renewal - the order will be processed as a renewal if this parameter is passed.

csr - the CSR for the certificate

period - period for the certificate in months. Valid options are detailed in the details provided by the products() method.

approver - Approver email address. Must be one of admin, administrator hostmaster, root, webmaster or postmaster prepended to the domain supplied in the request

insurance - Re-issue insurance required - 1 or 0

servercount - Number of server licenses requires.

novalidation- If set to 1 the CSR can be blank to be provded later via the Trustico reseller management interface.

special - Special instructions to issuer. Up to 255 characters

admin - Admin contact details hash ref

tech - Tech contact details hash ref

org - Organisation details hash ref (required for products with ORG vetting type only - will be ignored if not required)

Tech contact hash ref must contain either the following fields:

    title, firstname, lastname, organisation, email, phonecc, phoneac, 
    phonen, address1, city, state, postcode, country.

The tech contact may also contain an optional address2 field

Alternatively the tech contact may be omitted if the techusereseller field is set to 1 in which case the default details provided via the Trustico reseller control panel will be used.

Admin contact hash must contain all of the fields required for the Tech contact plus a role field.

The admin contact may also contain the following optional fields:

    taxid, memdate (ISO format)

status

Gets the status of the order specified by the orderid parameter.

The returned details are in a hash reference.

products

Returns a hash containing a list of product codes and the details for each product.

SEE ALSO

http://www.trustico.com/

AUTHOR

Jason Clifford, <jason@ukfsn.org>

COPYRIGHT AND LICENSE

Copyright (C) 2010 by Jason Clifford

This library is free software; you can redistribute it and/or modify it under the terms of the FSF GPL version 2.0 or later.

cpanm Net::Trustico

perl -MCPAN -e shell
install Net::Trustico