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:

• RT: CPAN's request tracker (report bugs here)

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-SSLLabs

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/WebService-SSLLabs

• CPAN Ratings

  http://cpanratings.perl.org/d/WebService-SSLLabs

• Search CPAN

  http://search.cpan.org/dist/WebService-SSLLabs/

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.

cpanm WebService::SSLLabs

perl -MCPAN -e shell
install WebService::SSLLabs