/ 
Net-SSLLabs-0.10
/ Net::SSLLabs::Host

NAME

Net::SSLLabs::Host - Host object

VERSION

Version 0.10

SUBROUTINES/METHODS

new

a new Net::SSLLabs::Host object, accepts a hash ref as it's parameter.

host

assessment host, which can be a hostname or an IP address

port

assessment port (e.g., 443)

protocol

protocol (e.g., HTTP)

is_public

true if this assessment publicly available (listed on the SSL Labs assessment boards)

status

assessment status; possible values: DNS, ERROR, IN_PROGRESS, and READY.

status_message

status message in English. When status is ERROR, this field will contain an error message.

start_time

assessment starting time, in milliseconds since 1970

test_time

assessment completion time, in milliseconds since 1970

engine_version

assessment engine version (e.g., "1.0.120")

criteria_version

grading criteria version (e.g., "2009")

cache_expiry_time

when will the assessment results expire from the cache (typically set only for assessment with errors; otherwise the results stay in the cache for as long as there's sufficient room)

endpoints

list of Net::SSLLabs::Endpoint objects

cert_hostnames

the list of certificate hostnames collected from the certificates seen during assessment. The hostnames may not be valid. This field is available only if the server certificate doesn't match the requested hostname. In that case, this field saves you some time as you don't have to inspect the certificates yourself to find out what valid hostnames might be.

DIAGNOSTICS

None

CONFIGURATION AND ENVIRONMENT

Net::SSLLabs::Host requires no configuration files or environment variables.

DEPENDENCIES

Net::SSLLabs::Host requires no non-core modules

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=Net-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 Net::SSLLabs::Host

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 2015 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.