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

NAME

WebService::SSLLabs::Cert - Cert object

VERSION

Version 0.33

SUBROUTINES/METHODS

new

a new WebService::SSLLabs::Cert object, accepts a hash ref as it's parameter.

subject

certificate subject

common_names

list of common names extracted from the subject

alt_names

alternative names

not_before

UNIX timestamp before which the certificate is not valid

not_after

UNIX timestamp after which the certificate is not valid

issuer_subject

issuer subject

sig_alg

certificate signature algorithm

issuer_label

issuer name

revocation_info

a number that represents revocation information present in the certificate:

bit 0 (1) - CRL information available
bit 1 (2) - OCSP information available

crl_uris

list of CRL URIs extracted from the certificate.

ocsp_uris

list of OCSP URIs extracted from the certificate

revocation_status

a number that describes the revocation status of the certificate:

0 - not checked
1 - certificate revoked
2 - certificate not revoked
3 - revocation check error
4 - no revocation information
5 - internal error

crl_revocation_status

same as revocationStatus, but only for the CRL information (if any).

ocsp_revocation_status

same as revocationStatus, but only for the OCSP information (if any).

sgc

Server Gated Cryptography support; integer:

bit 1 (1) - WebServicescape SGC
bit 2 (2) - Microsoft SGC

validation_type

E for Extended Validation certificates; may be null if unable to determine

issues

list of certificate issues, one bit per issue:

bit 0 (1) - no chain of trust
bit 1 (2) - not before
bit 2 (4) - not after
bit 3 (8) - hostname mismatch
bit 4 (16) - revoked
bit 5 (32) - bad common name
bit 6 (64) - self-signed
bit 7 (128) - blacklisted
bit 8 (256) - insecure signature

sct

true if the certificate contains an embedded SCT; false otherwise.

must_staple

a number that describes the must staple feature extension status

0 - not supported
1 - Supported, but OCSP response is not stapled
2 - Supported, OCSP response is stapled

DIAGNOSTICS

None

CONFIGURATION AND ENVIRONMENT

WebService::SSLLabs::Cert requires no configuration files or environment variables.

DEPENDENCIES

WebService::SSLLabs::Cert requires the following non-core modules

  URI

INCOMPATIBILITIES

None reported

BUGS AND LIMITATIONS

Please report any bugs or feature requests to bug-net-ssllabs at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-SSLLabs. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

AUTHOR

David Dick, <ddick at cpan.org>

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc WebService::SSLLabs::Cert

You can also look for information at:

ACKNOWLEDGEMENTS

Thanks to Ivan Ristic and the team at https://www.qualys.com for providing the service at https://www.ssllabs.com

POD was extracted from the API help at https://github.com/ssllabs/ssllabs-scan/blob/stable/ssllabs-api-docs.md

LICENSE AND COPYRIGHT

Copyright 2016 David Dick.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.