NAME

WebService::SSLLabs::Endpoint - Endpoint object

VERSION

Version 0.33

SUBROUTINES/METHODS

new

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

ready

will return the current WebService::SSLLabs::Endpoint object if status is equal to Ready. Otherwise it will return undef.

subject

certificate subject

ip_address

endpoint IP address, in IPv4 or IPv6 format.

server_name

server name retrieved via reverse DNS

status_message

assessment status message

status_details

code of the operation currently in progress

status_details_message

description of the operation currently in progress

grade

possible values: A+, A-, A-F, T (no trust) and M (certificate name mismatch)

grade_trust_ignored

grade (as above), if trust issues are ignored

has_warnings

if this endpoint has warnings that might affect the score (e.g., get A- instead of A).

is_exceptional

this flag will be raised when an exceptional configuration is encountered. The SSL Labs test will give such sites an A+.

progress

assessment progress, which is a value from 0 to 100, and -1 if the assessment has not yet started

duration

assessment duration, in milliseconds

eta

estimated time, in seconds, until the completion of the assessment

delegation

indicates domain name delegation with and without the www prefix

bit 0 (1) - set for non-prefixed access
bit 1 (2) - set for prefixed access

details

this field contains an EndpointDetails object. It's not present by default, but can be enabled by using the "all" paramerer to the analyze API call.

DIAGNOSTICS

None

CONFIGURATION AND ENVIRONMENT

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

DEPENDENCIES

WebService::SSLLabs::Endpoint 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=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::Endpoint

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.