Code Monkey home page Code Monkey logo

prtg-sslreport's Introduction

Overview

Qualys SSL Report Grading for PRTG is a custom PowerShell script that queries the Qualys SSL Labs Service and allows you to grade a (public) web property's SSL Settings

Installation

  • Copy the *.ps1 and *.psm1 files to the PRTG Network Monitor\Custom Sensors\EXEXML folder on your Probe(s) where you want to use the Sensor from.

  • Copy the *.ovl files to the PRTG Network Monitor\lookups\custom folder on your Probe(s) where you want to use the Sensor from.

  • Create a new Sensor of type EXE/script Advanced (Make sure you use Advanced!)

  • Give the Sensor an appropriate Name (e.g. SSL Grade)

  • Select QualysSSLReport.ps1 in EXE/Script

  • Use -ServerName %host as a parameter, which uses the hostname of the parent device, or specify a name directly using e.g. -ServerName microsoft.com

  • It's a good idea to set a Mutex to not overwhelm the Qualys API or get throttled when you have multiple sensors with this type. Use e.g. michelz.prtg.qualys.mutex as value

  • Set the timeout to an appropriate value (it's not uncommon that this scan takes 10 minutes - so we recommend at least 600 seconds)

  • Set the scanning interval to something very low, like 6 hours. We don't want to overwhelm the Qualys API or get throttled. The result also doesn't change often. Use at least 1 hour.

Release Notes

Date Version Description
2019-11-22 Version 0.1 Initial Version
2021-03-19 Version 0.1.1 Updated input from "host" to match parameter name of function "ServerName"
2022-06-07 Version 0.1.2 Updated error handling
2022-06-07 Version 0.1.3 Improve cache behavior

prtg-sslreport's People

Contributors

michelz avatar thigley986 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

prtg-sslreport's Issues

Sensor Result - STATUS: CONTENT:

When I follow the directions and create a sensor for hctime.hilscher-clarke.com, I get a sensor in a down state that simply displays "STATUS: CONTENT:"

IPv6 support - Trust Error

I love the script, great work.
I have one issue though, since setting up IPv6 on my website and AAAA record for the website i get a "Trust Error" on the ipv6 channel when running your script. When manually running a test on the SSL Labs website it passes without issue on the IPv6 address.
I'm quite happy to just disable the IPv6 channel as a work around, but i haven't been able to workout how to do that?
Thanks for help.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.