httpunitPS

A PowerShell port of httpunit.

This is not a 100% accurate port of httpunit. The goal of this module is to utilize Net.Http.HttpClient to more closely simulate a .Net client application. It also provides easy access to the Windows Certificate store for client certificate authentication.

CI

Install

Install-Module -Name httpunitPS or Install-PSResource -Name httpunitPS

Docs

Full Docs

Config File

TOML, YAML, JSON, and PSD1 formats are supported for the config file.

Each plan can have:

• label A label for documentation purposes.
• url The URL to retrieve.
• ips For http/https, a list of IPs to send the URL to. Default is "use DNS". Otherwise the connection is made to the IP address listed, ignoring DNS. Pass '*' to test all resolved addresses.
• code For http/https, the expected status code, default 200.
• string For http/https, a string we expect to find in the result.
• timeout An optional timeout for the test in the format "hh:mm:ss". Default is 3 seconds.
• certificate For http/https, a path to a certificate in the Windows Store to pass as a Client Certificate. If just a Thumbprint is provided, it will look in cert:\LocalMachine\My.
• tags An optional list of tags for the test. Used for when you want to only run a subset of tests with the -tags flag.
• insecureSkipVerify Will allow testing of untrusted or self-signed certificates.
• plan.headers For http/https, a list of keys and values to validate the response headers.

A sample TOML config file

[[plan]]
label = "google"url = "https://www.google.com"code = 200timeout = "0:0:10"
[plan.headers]
Server = "gws"

A sample YAML config file

Plan:
- code: 200label: googletimeout: "0:0:10"url: https://www.google.comtags: [run]

Test-SSLCertificate

The SSLCertificate commands may be moved to a separate module in the future.

• Get-SSLCertificateGet the SSL Certificate for given host.
• Show-SSLCertificateUIDisplays a dialog box with detailed information about the specified x509 certificate.
• Test-SSLCertificateTest the validitiy of a given certificate.

PS >Get-SSLCertificateexpired.badssl.com|Test-SSLCertificate-ErrorVariable validation
False

Validation failures produces an error message.

Test-SSLCertificate: Certificate failed chain validation:
A required certificate is not within its validity period when verifying against the current system clock or the timestamp in the signed file.

Inspect the certificate chain inside the ErrorRecord.

PS >$validation.TargetObject.ChainElements.Certificate
Thumbprint Subject EnhancedKeyUsageList
-------------------------------------
404BBD2F1F4CC2FDEEF13AABDD523EF61F1C71F3 CN=*.badssl.com, OU… {Server Authentication, Client Authentication}
339CDD57CFD5B141169B615FF31428782D1DA639 CN=COMODO RSA Domai… {Server Authentication, Client Authentication}
AFE5D244A8D1194230FF479FE2F897BBCD7A8CB4 CN=COMODO RSA Certi…