From 61c98f7493edee7d5e87376e77a9cc7c9e50c64e Mon Sep 17 00:00:00 2001 From: Lord Hepipud Date: Wed, 10 Feb 2021 16:01:44 +0100 Subject: [PATCH] Docs: Ignore SSL-Errors documentation Fixes #199 --- doc/06-Framework-Usage.md | 1 + .../04-Disable-Certificate-Validation.md | 17 +++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 doc/frameworkusage/04-Disable-Certificate-Validation.md diff --git a/doc/06-Framework-Usage.md b/doc/06-Framework-Usage.md index 964e936..4a3119b 100644 --- a/doc/06-Framework-Usage.md +++ b/doc/06-Framework-Usage.md @@ -7,6 +7,7 @@ The Icinga PowerShell Framework ships with a bunch of Cmdlets for monitoring, me * [Automated Framework and Component deployment](frameworkusage/01-Automated-Framework-and-Component-Deployment.md) * [Enable Proxy Server](frameworkusage/02-Enable-Proxy-Server.md) * [Install Wizard Guide](frameworkusage/03-Install-Wizard-Guide.md) +* [Disable Certificate Validation](frameworkusage/04-Disable-Certificate-Validation.md) ## Icinga Agent Management diff --git a/doc/frameworkusage/04-Disable-Certificate-Validation.md b/doc/frameworkusage/04-Disable-Certificate-Validation.md new file mode 100644 index 0000000..c3fff87 --- /dev/null +++ b/doc/frameworkusage/04-Disable-Certificate-Validation.md @@ -0,0 +1,17 @@ +# Disable Certificate Validation + +In some cases it might be required to disable checks for certificates while performing web requests. This is especially true while using self signed certificates which are not installed on the local Windows machine. + +## Disable Validation + +To disable the certificate check for the entire certificate chain, you can simply use the following command within an Icinga Shell: + +```powershell +Enable-IcingaUntrustedCertificateValidation +``` + +Once enabled, certificates will no longer be checked while using this PowerShell instance. Web calls by using `Invoke-WebRequest` or `Invoke-IcingaWebRequest` will proceed, regardless of the certificate behind and possible SSL/TLS errors. + +## Enable Validation + +To enable the validation again, you will have to close the PowerShell session and create a new one. There is no Cmdlet available to enable it again.