NAME

Comodo::DCV - DCV logic for COMODO SSL APIs

SYNOPSIS

use Comodo::DCV;

#The following acts on a DER-formatted (i.e., binary) CSR only.
my ($filename, $contents) = Comodo::DCV::get_filename_and_contents( $csr_der );

DESCRIPTION

This module implements logic that is necessary for HTTP-based validation according to COMODO’s APIs for SSL certificate issuance, as documented at http://secure.comodo.net/api/pdf/latest/Domain%20Control%20Validation.pdf.

You can verify this module’s output by comparing it to that from https://secure.comodo.net/utilities/decodeCSR.html.

NOTE: This module works on DER-formatted (binary) CSRs. If you need to work with PEM-formatted (text/Base64) CSRs, first convert them via Crypt::Format or similar logic.

BREAKING CHANGE: 20 JULY 2017 UPDATE

As of 20 July 2017, Comodo will no longer look for SHA-1 hashes in DCV files; the new format is to use SHA-256 hashes. There is also a change of path for the DCV check, from $document_root/$MD5.txt to $document_root/.well-known/pki-validation/$MD5.txt. Any services that might interact with Comodo’s DCV thus need to stop using the old logic and start using the new.

Comodo has their new logic is in place as of 10 July 2017.

Note that this means you’ll need to ensure that $document_root/.well-known/pki-validation exists. That’s something that this module will NOT do for you.

BUGS

Please report to https://github.com/FGasper/p5-Comodo-DCV/issues. Thank you!

AUTHOR

Felipe Gasper
CPAN ID: FELIPE

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.