AzStackHci.DiagnosticSettings

0.6.6

Private/AzStackHci.Network.Helpers.ps1

                                # ////////////////////////////////////////////////////////////////////////////

# Test if proxy is enabled and return boolean

function Get-Proxy

{

    <#

    .SYNOPSIS

        Check if proxy is enabled and return boolean and proxy server uri

    #>

    begin {

        # Write-Debug "Get-Proxy: Beginning proxy detection process"

    }

    process {

        $line1, $line2, $line3, $JsonLines = netsh winhttp show advproxy

        $ProxyInformation = $JsonLines | ConvertFrom-Json -ErrorAction SilentlyContinue

        # Return True/False and the Proxy server uri as a PSObject

        $ProxyReturnVariable = New-Object PsObject -Property @{

            # True/False

            Enabled = [bool]$ProxyInformation.Proxy

            # Proxy server URI

            Server = $ProxyInformation.Proxy

            # Proxy bypass list

            # ProxyBypass = $proxy.Bypass

        }

        # Check if the Proxy is enabled and if the proxy server is set

        if($ProxyReturnVariable.Enabled) {

            if(-not($ProxyReturnVariable.Server)){

                # In case the proxy server is not set from netsh winhttp show advproxy output

                $proxyUri = [Uri]$null

                $ProxyTest = [System.Net.WebRequest]::GetSystemWebProxy()

                $ProxyTest.Credentials = [System.Net.CredentialCache]::DefaultCredentials

                # use a known URL to test the proxy server, but http, in case of Arc Gateway, to prevent "localhost" from being returned

                # This is a known URL that should be accessible from any network

                $TestUrl = [System.Uri]::new("http://oneocsp.microsoft.com")

                # Test the proxy server using a known URL

                $proxyUri = $ProxyTest.GetProxy($TestUrl)

                if($proxyUri -eq $TestUrl) {

                    # Proxy is not required, so do not use it

                    $ProxyReturnVariable.Enabled = $false

                    Write-HostAzS "`t`nNo proxy server detected, using direct connection...`n" -ForegroundColor Green

                } else {

                    # Proxy is required, so use it

                    $ProxyReturnVariable.Server = $proxyUri

                }

            }

            # Check if the proxy server string has a semi-colon which can be used for Arc Gateway

            if(-not [string]::IsNullOrWhiteSpace($ProxyReturnVariable.Server) -and $ProxyReturnVariable.Server -match ";"){

                # In case the proxy server is set from netsh winhttp show advproxy output

                [array]$ProxyStrings = $ProxyReturnVariable.Server.ToString().Split(";")

            }

            if($ProxyStrings){

                # Check if the proxy server string has a semi-colon which can be used for Arc Gateway

                # Multiple proxy servers detected

                Write-HostAzS "`n`tArc Gateway scenario detected (possible), as multiple proxy servers detected ('netsh winhttp show advproxy')..."

                ForEach($ProxyServer in $ProxyStrings){

                    # Trim the proxy server string

                    $ProxyServer = $ProxyServer.Trim()

                    if($ProxyServer -like "http=*"){

                        # HTTP proxy server (should be customer proxy server)

                        # Check if the proxy server is set from netsh winhttp show advproxy output

                        Write-HostAzS "`tHTTP Proxy server detected, using proxy: $($ProxyServer)" -ForegroundColor Green    

                    } elseif($ProxyServer -like "https=*"){

                        # HTTPS proxy server (might be Arc Gateway Agent, "localhost")

                        # Check if the proxy server is set from netsh winhttp show advproxy output

                        Write-HostAzS "`tHTTPS Proxy server detected, using proxy: $($ProxyServer)" -ForegroundColor Green    

                    } else {

                        # Other proxy server detected

                        # Check if the proxy server is set from netsh winhttp show advproxy output

                        Write-HostAzS "`tProxy server detected, using proxy: $($ProxyServer)" -ForegroundColor Green    

                    }

                } # End ForEach

                Write-HostAzS ""

            } else {

                # Single proxy detected

                Write-HostAzS "`t`nProxy server detected, using proxy: $($ProxyReturnVariable.Server)`n" -ForegroundColor Green

            }

        } else {

            # Proxy is NOT enabled

            # No proxy server detected, so use direct connection

            Write-HostAzS "`t`nNo proxy server detected, using direct connection...`n" -ForegroundColor Green

        }

    } # End of process block

    end {

        # Write-Debug "Get-Proxy: Proxy detection process completed"

        # Return the ProxyReturnVariable object

        Return $ProxyReturnVariable

    }

} # End Function Get-Proxy

# ////////////////////////////////////////////////////////////////////////////

# This function retrieves the SSL certificate chain from a remote HTTPS endpoint

# It uses the System.Net.Http.HttpClient class to make the request and capture the certificate chain.

#

# Renamed from Get-SslCertificateChain in v0.6.6 to avoid a name collision with the

# AzStackHci.EnvironmentChecker module (10.2509+), which exports a function with the

# same name but a different parameter set. Because Get-AzStackHciEnvironmentCheckerModule

# Import-Module's that module from inside our module's session state, EnvironmentChecker's

# exported Get-SslCertificateChain shadowed our private helper, breaking certificate-detail

# capture for every HTTPS endpoint with: "A parameter cannot be found that matches

# parameter name 'AllowAutoRedirect'". Renaming the private helper resolves the conflict

# permanently.

function Get-AzSHciSslCertificateChain

{

    <#

    .SYNOPSIS

        Retrieve remote ssl certificate & chain from https endpoint for Desktop and Core

    .NOTES

        Credit: https://github.com/markekraus

    #>

    [CmdletBinding()]

    param (

        [system.uri]

        $url,

        [Parameter()]

        [bool]

        $AllowAutoRedirect,

        [Parameter()]

        [string]

        $Proxy

    )

    begin {

        # Write-Debug "Get-AzSHciSslCertificateChain: Beginning SSL certificate chain retrieval for '$url'"

    }

    process {

    try

    {

        $cs = @'

    using System;

    using System.Collections.Generic;

    using System.Net.Http;

    using System.Net.Security;

    using System.Security.Cryptography.X509Certificates;

    namespace CertificateCapture

    {

        public class Utility

        {

            public static Func<HttpRequestMessage,X509Certificate2,X509Chain,SslPolicyErrors,Boolean> ValidationCallback =

                (message, cert, chain, errors) => {

                    CapturedCertificates.Clear();

                    var newCert = new X509Certificate2(cert);

                    var newChain = new X509Chain();

                    newChain.Build(newCert);

                    CapturedCertificates.Add(new CapturedCertificate(){

                        Certificate =  newCert,

                        CertificateChain = newChain,

                        PolicyErrors = errors,

                        URI = message.RequestUri

                    });

                    return true;

                };

            public static List<CapturedCertificate> CapturedCertificates = new List<CapturedCertificate>();

        }

        public class CapturedCertificate

        {

            public X509Certificate2 Certificate { get; set; }

            public X509Chain CertificateChain { get; set; }

            public SslPolicyErrors PolicyErrors { get; set; }

            public Uri URI { get; set; }

        }

    }

'@

        try

        {

            if (-not ('CertificateCapture.Utility' -as [type]))

            {

                if ($PSEdition -ne 'Core')

                {

                    Add-Type -AssemblyName System.Net.Http

                    Add-Type $cs -ReferencedAssemblies System.Net.Http

                }

                else

                {

                    Add-Type $cs

                }

            }

        }

        catch

        {

            if ($_.Exception.Message -notmatch 'Definition of new types is not supported in this language mode')

            {

                throw "Language mode does not allow this test Error: $_"

            }

        }

        # Reset variables, in case cached.

        Remove-Variable Certs, Handler, Client, Request -ErrorAction SilentlyContinue

        # Create a new list to hold captured certificates.

        $Certs = [CertificateCapture.Utility]::CapturedCertificates

        # Clear any previously captured certificates.

        $Certs.Clear()

        # Create the HttpClientHandler.

        $Handler = [System.Net.Http.HttpClientHandler]::new()

        # This is important to capture the certificate chain of the first endpoint, not redirected endpoints.

        if($AllowAutoRedirect -eq $false)

        {

            # Set the handler to not allow auto redirects

            # https://learn.microsoft.com/en-us/dotnet/api/system.net.http.httpclienthandler.allowautoredirect

            $Handler.AllowAutoRedirect = $false

        }

        if ($Proxy)

        {

            $Handler.Proxy = New-Object System.Net.WebProxy($proxy)

        }

        # Set the ServerCertificateCustomValidationCallback to our custom callback.

        $Handler.ServerCertificateCustomValidationCallback = [CertificateCapture.Utility]::ValidationCallback

        # Create the HttpClient with the handler

        $Client = [System.Net.Http.HttpClient]::new($Handler)

        # Set a timeout to 15 seconds (reduced from 60s to limit impact of unresponsive backend pool servers):

        $Client.Timeout = [timespan]::FromTicks($script:CERT_CAPTURE_TIMEOUT_TICKS)

        try {

            # Setup the request to the URL.

            $Request = $Client.GetAsync($url)

            # Wait for the request to complete calling the Result method.

            $Null = $Request.Result

            # Check if the request is completed and that certificates were captured.

            if(($Request.IsCompleted) -and $Certs){

                # Return the captured certificate chain

                Write-Debug "Successfully obtained SSL certificate chain from endpoint: '$url'"

                return $Certs.CertificateChain

            } else {

                # Return null if no certificates were captured.

                Write-Debug "Failed to obtain SSL certificate chain from endpoint: '$url'"

                return $null

            }

        }

        finally {

            # Dispose IDisposable resources to prevent socket/handle leaks

            if ($Request) { $Request.Dispose() }

            if ($Client)  { $Client.Dispose() }

            if ($Handler) { $Handler.Dispose() }

        }

    }

    catch

    {

        throw $_

    }

    } # End of process block

    end {

        # Write-Debug "Get-AzSHciSslCertificateChain: SSL certificate chain retrieval completed"

    }

} # End Function Get-AzSHciSslCertificateChain

# SIG # Begin signature block

# MIInbgYJKoZIhvcNAQcCoIInXzCCJ1sCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCC1f+kUPLztR6YV

# zlMJ/zu67Xv9J7tCM73GT6aj9pGGuaCCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1

# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP

# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC

# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf

# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j

# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT

# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT

# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw

# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w

# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl

# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC

# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN

# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK

# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK

# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY

# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu

# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE

# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz

# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6

# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO

# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD

# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC

# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX

# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ

# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq

# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo

# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv

# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a

# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1

# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO

# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7

# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ

# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS

# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm

# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3

# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E

# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX

# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP

# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw

# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC

# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D

# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY

# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI

# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6

# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w

# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7

# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK

# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK

# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw

# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT

# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghn7MIIZ9wIBATBu

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZI

# hvcNAQkEMSIEICzEzpLqLODVa0dPmkn8PHcCenS0bBM+ZeZ8zCQb9gquMEIGCisG

# AQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEABScxbz+Od8wwAWCSHEh9

# EZ0aEkBRoKvQab5t+gerbxvACvD839V0VjJKKsgxqccz4kxzTWtG/ijXJICxquEb

# idHl1qUxagCct7LUngT2hMQMMbbZDCijpVYYLojhq62ZVKkBUCJTKv/7FjdYg+9w

# Z+jeUX1FM008FdL+wlcpM0Kof7gMRZ9cIlaYmKmPEwDbM024tkrVvgqsCML6NsiB

# BdmdGeO5kg7l2inkb0L0xzvbf3XwNC7VVCp//Sp9VqzC0/EQW9HMnQrWLCSXabIQ

# 0eeGtkLCMgMhJC3t0BVwldC9Qt76DJGooAph7fqFB+GJfq3NO89OXKmxuXSZFgtb

# 2aGCF60wghepBgorBgEEAYI3AwMBMYIXmTCCF5UGCSqGSIb3DQEHAqCCF4YwgheC

# AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIB

# QQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCAALodhKvIIU43/5ufS

# JND9KqOQSZo99cSJRVm17kAZuwIGaeyDroWjGBMyMDI2MDQyODIxNTI1Mi45MDla

# MASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0

# ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2RjFBLTA1RTAtRDk0NzElMCMG

# A1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEfswggcoMIIFEKAD

# AgECAhMzAAACHAlVFdfDWQfRAAEAAAIcMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m

# dCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgzMVoXDTI2MTExMzE4

# NDgzMVowgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD

# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTAr

# BgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUG

# A1UECxMeblNoaWVsZCBUU1MgRVNOOjZGMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxN

# aWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOC

# Ag8AMIICCgKCAgEAow0xEAUaFIyyLIXeFzeI8IKyBON2u0Dr02ISE5p9G5CUXfnF

# u2S0E1gWCMvDWpopX6lRxjmgnqaL3BtnWlBVTo8xUNRZu23ie4YBMAJB7Ut6mnqn

# HVwvDJxGO4TD3SnrCd+yg35B9QFejq3o4+OByvXjynaypZyukcQaLsKQvoxE8ElH

# H7zcOXEJWmU3rnXzaW/S4SH3OPhoUbTTcy6nUgKx5pRWiQ24UEPLYzcxGJjqjkz+

# GiCWGPFHDMdW86laWvmCslouQPsN2eBk8dxJcEZmW4l6p4TthoXcfexEA9YdYaMz

# 10aMhZNpdsNaDtDQUMDEC3k1D1My69MXSPlUmD9xFyDlkXiVa7BCEp3XcVtqTgzH

# Gwr28JD6oE7zEPYeuZOiuCBXTZSo/wk3tbDlsESbIPV6inYqrzxiMYqlxfCdzC3C

# imh9/NT/Lk9/aU+Iyyc9b3OaT0dZ8wgLaVDCGELRMrqyImdFHv0MudctzW/kPsV3

# Ja9ufpKWujEiN3CW//X8hFa9j5ImNeQzcMit3MoSaoGwnbiZJX1IyibIphlqccXF

# k4oTTSOQBsAUw8U0gwOnM5UJD8mBUBd65Np6NBkx2cviJ4I34GyXFCWyy5Ft1QsB

# YyVfAG3KOhCfPHQf8lQzJvLr57YW0bD/xVs4Ag4gTS6KZNyFEfX9jFdRlr0CAwEA

# AaOCAUkwggFFMB0GA1UdDgQWBBRa3mOCzB8u7zpvDh8MGKVYLCk7ZDAfBgNVHSME

# GDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1l

# LVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsG

# AQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01p

# Y3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMB

# Af8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDAN

# BgkqhkiG9w0BAQsFAAOCAgEAklb6w/deaid3BujQCtWFBe0n9pkyRy+yyWEg70iD

# woJ5u0e0O+4GerNzdZb1zTPsHJ8EGMyo1K7ytL21+pmdFMTl19PC8OJ5Y2p+XKUQ

# y2dD+hggRMmJgDQsgbOCxHYeO+jg4t+vg61wUrovzzLkH3z0PJXXvoNuBj9Lda9C

# iNMd60451Kube99ArSf6ZMj3t0p4rFbgSazDs+8TJ+8KA5GVaYjPHj9rlMuI3Wjo

# hEc9apnQ6hMjMck3jlHZIwluVYeUQE0qjmApfMtTAEzbMUdY8sLTunL1GkbDSeKn

# 9O7llBGnNtyM1uM9Mdv1VyWh0z/IriQKIjntqqGyoF0HvDHOFZCyUDBPLflyiu7Y

# 1zQ/sPounsb96aBfQdq3h3LOn6t+m9EnNz/G6MzzWvpJk6YgTHTIqeQN/F/XpiPv

# bfek3nq/PYbL3au+kBfRUHiCFXSvt6lor0HC626vUmz9ZNPOxwEWLuccomxsy3Jw

# WH79vsM/7ARqoG5h6d6NahfaOuRP4XI9xtdH3Pa/NCLyQjxKXyLxzwQzjddkX2Ep

# TJnlypuhPmEdea59Uz2E303LxyXSnKBvGsAnyWYAfnejr3YAiL9YrN2l2dn198Rp

# A4DCm9QtZYiwC0q2fuUvui34PfPIUZByf7wHuuWu50hY9WLx1kOMI8xyo7AI6TaN

# rnIwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEB

# CwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYD

# VQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAe

# Fw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGm

# TOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/H

# ZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDc

# wUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62A

# W36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1w

# jjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCG

# MFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ

# 1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP

# 8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFz

# ymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHz

# NgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3

# xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsG

# AQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/

# LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEG

# DCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29m

# dC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYB

# BQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8G

# A1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQw

# VgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9j

# cmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUF

# BwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3Br

# aS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQEL

# BQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfC

# cTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AF

# vonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l

# 9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn

# 8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5m

# O0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyx

# TkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4

# S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9

# y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM

# +Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhw

# RNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDVjCCAj4C

# AQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0

# ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2RjFBLTA1RTAtRDk0NzElMCMG

# A1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIa

# AxUAWmTiA01u5mxq/nVxiRJLMOskVGeggYMwgYCkfjB8MQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T

# dGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO2bnzwwIhgPMjAyNjA0Mjgy

# MTAzNTZaGA8yMDI2MDQyOTIxMDM1NlowdDA6BgorBgEEAYRZCgQBMSwwKjAKAgUA

# 7ZufPAIBADAHAgEAAgIPbDAHAgEAAgITrTAKAgUA7ZzwvAIBADA2BgorBgEEAYRZ

# CgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0G

# CSqGSIb3DQEBCwUAA4IBAQBr6wa/gtdJkh0pHlNsg+3Uxb3TAaQnUhtikO130sdX

# Jc5JLaKcZE+YVGfjpgDFbsV67Qj8Quns7ynbsEUJ5VEDr0xKrRMMaPtQVjwsISdA

# Pw3gqfqKQ6RiO1tkF0sRLXIi0KtrF6YeF3k6eTZzHml4zqOt7BBHlmel7Q7otVIX

# mARU1q8IH85whDGm4OQH2R4o9xzKh7LNcC90ymkdFjSooKLgiKzJ0Js3OVmTmvmq

# M8AMmbZSTx0KkSLD7uW2NKeBhGDuRQBFrvPFtQfJ8a1FCRp9Tv8AWn6qOBjUzmbI

# WQNsV/sPPtKvLIttW/iguyfkX0MfaMaQHA6XJENSu8epMYIEDTCCBAkCAQEwgZMw

# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd

# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIcCVUV18NZB9EAAQAA

# AhwwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRAB

# BDAvBgkqhkiG9w0BCQQxIgQgJkH53ReQNpF5ur8aGQlq5pyyRwynLSNbzKnhOInX

# QS0wgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCCgIGkmNhdo7+KE7dWhI+E2

# Ctx2RLWoYvvJodCIciHHaDCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBD

# QSAyMDEwAhMzAAACHAlVFdfDWQfRAAEAAAIcMCIEIDPDrXj+JvbehrLdy4OSVfjQ

# HMxRQqrnhL//e2Z+eEzLMA0GCSqGSIb3DQEBCwUABIICAILI3uyTj/99EYVda7Dg

# 06jjNe2afDbOwPVSaf+pd4ErUnw7ANyQrTgSz2an4GJsWgq7pH7/KBHILqCrr+WX

# DToB28r8zNZ6Y8g8JQjxnotEgiFrG/z5ByDtrNlOQz72wlH9Y1xMgSCSAKwOxYcP

# b2kPHzYVJdm60znY9iesawJ1k3vXBlnkNlCh0L+3KOu+ixS0ifHOm0DxtYIKJwFX

# 5LyZ6xcmpj9PSpEuDG825Djm8ENrSyqhNQ2jbMWzvglSpcTGacPsnBQT7bf2nz3S

# F/IqUtB2Un2TYMkiXVZ78x7PHkQHSyjZG8zPxRuKfUh/wLKh+qpPgZn2pFioAFGi

# 9dn047qAgjTPrlwByvQuz5rWYz8ZvpOcmLHO2v8mONoZQ2nwfJUWy2ULI0qeRX4f

# 3RZXg4q2HYF/uLobC2MARFYx3b57yixjgA2R+0oKhKz6eZ6/8kdKhq8xzGtdI+An

# fg+weAVPo2lucraw5Yg4/sQLO+KlQEgafJ1SmNkh2CfO76MLxI+qP80IS3UMv742

# 6Zo4TKQ87BvLjlWdRG8UzPtp7HVvc7uXUt6GEJKxTfC2HFpSbVbxhDyphxKHD5ug

# YplhOrbMZueYsbdjRh0nDrrKJK7yR8YLsW/wpmV1OCHnfx2Rn6YDa4nI7TzVCSnm

# b/73Cy/hnt9n0SjfAKzidh/k

# SIG # End signature block