SpeculationControl

1.0.10

SpeculationControl.psm1

                                function Get-SpeculationControlSettings {

  <#

  .SYNOPSIS

  This function queries the speculation control settings for the system.

  .DESCRIPTION

  This function queries the speculation control settings for the system.

  .PARAMETER Quiet

  This parameter suppresses host output that is displayed by default.

  #>

  [CmdletBinding()]

  param (

    [switch]$Quiet

  )

  process {

    $NtQSIDefinition = @'

    [DllImport("ntdll.dll")]

    public static extern int NtQuerySystemInformation(uint systemInformationClass, IntPtr systemInformation, uint systemInformationLength, IntPtr returnLength);

'@

    $ntdll = Add-Type -MemberDefinition $NtQSIDefinition -Name 'ntdll' -Namespace 'Win32' -PassThru

    [System.IntPtr]$systemInformationPtr = [System.Runtime.InteropServices.Marshal]::AllocHGlobal(4)

    [System.IntPtr]$returnLengthPtr = [System.Runtime.InteropServices.Marshal]::AllocHGlobal(4)

    $object = New-Object -TypeName PSObject

    try {

        $cpu = Get-CimInstance Win32_Processor

        if ($cpu -is [array]) {

            $cpu = $cpu[0]

        }

        $manufacturer = $cpu.Manufacturer

        #

        # Query branch target injection information.

        #

        if ($Quiet -ne $true) {

            Write-Host "For more information about the output below, please refer to https://support.microsoft.com/en-in/help/4074629" -ForegroundColor Cyan

            Write-Host

            Write-Host "Speculation control settings for CVE-2017-5715 [branch target injection]" -ForegroundColor Cyan

            if ($manufacturer -eq "AuthenticAMD") {

                Write-Host "AMD CPU detected: mitigations for branch target injection on AMD CPUs have additional registry settings for this mitigation, please refer to FAQ #15 at https://portal.msrc.microsoft.com/en-us/security-guidance/advisory/ADV180002" -ForegroundColor Cyan

            }

            Write-Host

        }

        $btiHardwarePresent = $false

        $btiWindowsSupportPresent = $false

        $btiWindowsSupportEnabled = $false

        $btiDisabledBySystemPolicy = $false

        $btiDisabledByNoHardwareSupport = $false

        $ssbdAvailable = $false

        $ssbdHardwarePresent = $false

        $ssbdSystemWide = $false

        $ssbdRequired = $null

        [System.UInt32]$systemInformationClass = 201

        [System.UInt32]$systemInformationLength = 4

        $retval = $ntdll::NtQuerySystemInformation($systemInformationClass, $systemInformationPtr, $systemInformationLength, $returnLengthPtr)

        if ($retval -eq 0xc0000003 -or $retval -eq 0xc0000002) {

            # fallthrough

        }

        elseif ($retval -ne 0) {

            throw (("Querying branch target injection information failed with error {0:X8}" -f $retval))

        }

        else {

            [System.UInt32]$scfBpbEnabled = 0x01

            [System.UInt32]$scfBpbDisabledSystemPolicy = 0x02

            [System.UInt32]$scfBpbDisabledNoHardwareSupport = 0x04

            [System.UInt32]$scfHwReg1Enumerated = 0x08

            [System.UInt32]$scfHwReg2Enumerated = 0x10

            [System.UInt32]$scfHwMode1Present = 0x20

            [System.UInt32]$scfHwMode2Present = 0x40

            [System.UInt32]$scfSmepPresent = 0x80

            [System.UInt32]$scfSsbdAvailable = 0x100

            [System.UInt32]$scfSsbdSupported = 0x200

            [System.UInt32]$scfSsbdSystemWide = 0x400

            [System.UInt32]$scfSsbdRequired = 0x1000

            [System.UInt32]$flags = [System.UInt32][System.Runtime.InteropServices.Marshal]::ReadInt32($systemInformationPtr)

            $btiHardwarePresent = ((($flags -band $scfHwReg1Enumerated) -ne 0) -or (($flags -band $scfHwReg2Enumerated)))

            $btiWindowsSupportPresent = $true

            $btiWindowsSupportEnabled = (($flags -band $scfBpbEnabled) -ne 0)

            if ($btiWindowsSupportEnabled -eq $false) {

                $btiDisabledBySystemPolicy = (($flags -band $scfBpbDisabledSystemPolicy) -ne 0)

                $btiDisabledByNoHardwareSupport = (($flags -band $scfBpbDisabledNoHardwareSupport) -ne 0)

            }

            $ssbdAvailable = (($flags -band $scfSsbdAvailable) -ne 0)

            if ($ssbdAvailable -eq $true) {

                $ssbdHardwarePresent = (($flags -band $scfSsbdSupported) -ne 0)

                $ssbdSystemWide = (($flags -band $scfSsbdSystemWide) -ne 0)

                $ssbdRequired = (($flags -band $scfSsbdRequired) -ne 0)

            }

            if ($Quiet -ne $true -and $PSBoundParameters['Verbose']) {

                Write-Host "BpbEnabled                   :" (($flags -band $scfBpbEnabled) -ne 0)

                Write-Host "BpbDisabledSystemPolicy      :" (($flags -band $scfBpbDisabledSystemPolicy) -ne 0)

                Write-Host "BpbDisabledNoHardwareSupport :" (($flags -band $scfBpbDisabledNoHardwareSupport) -ne 0)

                Write-Host "HwReg1Enumerated             :" (($flags -band $scfHwReg1Enumerated) -ne 0)

                Write-Host "HwReg2Enumerated             :" (($flags -band $scfHwReg2Enumerated) -ne 0)

                Write-Host "HwMode1Present               :" (($flags -band $scfHwMode1Present) -ne 0)

                Write-Host "HwMode2Present               :" (($flags -band $scfHwMode2Present) -ne 0)

                Write-Host "SmepPresent                  :" (($flags -band $scfSmepPresent) -ne 0)

                Write-Host "SsbdAvailable                :" (($flags -band $scfSsbdAvailable) -ne 0)

                Write-Host "SsbdSupported                :" (($flags -band $scfSsbdSupported) -ne 0)

                Write-Host "SsbdSystemWide               :" (($flags -band $scfSsbdSystemWide) -ne 0)

                Write-Host "SsbdRequired                 :" (($flags -band $scfSsbdRequired) -ne 0)

            }

        }

        if ($Quiet -ne $true) {

            Write-Host "Hardware support for branch target injection mitigation is present:"($btiHardwarePresent)

            Write-Host "Windows OS support for branch target injection mitigation is present:"($btiWindowsSupportPresent)

            Write-Host "Windows OS support for branch target injection mitigation is enabled:"($btiWindowsSupportEnabled)

            if ($btiWindowsSupportPresent -eq $true -and $btiWindowsSupportEnabled -eq $false) {

                Write-Host -ForegroundColor Red "Windows OS support for branch target injection mitigation is disabled by system policy:"($btiDisabledBySystemPolicy)

                Write-Host -ForegroundColor Red "Windows OS support for branch target injection mitigation is disabled by absence of hardware support:"($btiDisabledByNoHardwareSupport)

            }

        }

        $object | Add-Member -MemberType NoteProperty -Name BTIHardwarePresent -Value $btiHardwarePresent

        $object | Add-Member -MemberType NoteProperty -Name BTIWindowsSupportPresent -Value $btiWindowsSupportPresent

        $object | Add-Member -MemberType NoteProperty -Name BTIWindowsSupportEnabled -Value $btiWindowsSupportEnabled

        $object | Add-Member -MemberType NoteProperty -Name BTIDisabledBySystemPolicy -Value $btiDisabledBySystemPolicy

        $object | Add-Member -MemberType NoteProperty -Name BTIDisabledByNoHardwareSupport -Value $btiDisabledByNoHardwareSupport

        #

        # Query kernel VA shadow information.

        #

        if ($Quiet -ne $true) {

            Write-Host

            Write-Host "Speculation control settings for CVE-2017-5754 [rogue data cache load]" -ForegroundColor Cyan

            Write-Host    

        }

        $kvaShadowRequired = $true

        $kvaShadowPresent = $false

        $kvaShadowEnabled = $false

        $kvaShadowPcidEnabled = $false

        $l1tfRequired = $true

        $l1tfMitigationPresent = $false

        $l1tfMitigationEnabled = $false

        $l1tfFlushSupported = $false

        $l1tfInvalidPteBit = $null

        [System.UInt32]$systemInformationClass = 196

        [System.UInt32]$systemInformationLength = 4

        $retval = $ntdll::NtQuerySystemInformation($systemInformationClass, $systemInformationPtr, $systemInformationLength, $returnLengthPtr)

        if ($retval -eq 0xc0000003 -or $retval -eq 0xc0000002) {

        }

        elseif ($retval -ne 0) {

            throw (("Querying kernel VA shadow information failed with error {0:X8}" -f $retval))

        }

        else {

            [System.UInt32]$kvaShadowEnabledFlag = 0x01

            [System.UInt32]$kvaShadowUserGlobalFlag = 0x02

            [System.UInt32]$kvaShadowPcidFlag = 0x04

            [System.UInt32]$kvaShadowInvpcidFlag = 0x08

            [System.UInt32]$kvaShadowRequiredFlag = 0x10

            [System.UInt32]$kvaShadowRequiredAvailableFlag = 0x20

            [System.UInt32]$l1tfInvalidPteBitMask = 0xfc0

            [System.UInt32]$l1tfInvalidPteBitShift = 6

            [System.UInt32]$l1tfFlushSupportedFlag = 0x1000

            [System.UInt32]$l1tfMitigationPresentFlag = 0x2000

            [System.UInt32]$flags = [System.UInt32][System.Runtime.InteropServices.Marshal]::ReadInt32($systemInformationPtr)

            $kvaShadowPresent = $true

            $kvaShadowEnabled = (($flags -band $kvaShadowEnabledFlag) -ne 0)

            $kvaShadowPcidEnabled = ((($flags -band $kvaShadowPcidFlag) -ne 0) -and (($flags -band $kvaShadowInvpcidFlag) -ne 0))

            if (($flags -band $kvaShadowRequiredAvailableFlag) -ne 0) {

                $kvaShadowRequired = (($flags -band $kvaShadowRequiredFlag) -ne 0)

            }

            else {

                if ($manufacturer -eq "AuthenticAMD") {

                    $kvaShadowRequired = $false

                }

                elseif ($manufacturer -eq "GenuineIntel") {

                    $regex = [regex]'Family (\d+) Model (\d+) Stepping (\d+)'

                    $result = $regex.Match($cpu.Description)

                    if ($result.Success) {

                        $family = [System.UInt32]$result.Groups[1].Value

                        $model = [System.UInt32]$result.Groups[2].Value

                        $stepping = [System.UInt32]$result.Groups[3].Value

                        if (($family -eq 0x6) -and 

                            (($model -eq 0x1c) -or

                             ($model -eq 0x26) -or

                             ($model -eq 0x27) -or

                             ($model -eq 0x36) -or

                             ($model -eq 0x35))) {

                            $kvaShadowRequired = $false

                        }

                    }

                }

                else {

                    throw ("Unsupported processor manufacturer: {0}" -f $manufacturer)

                }

            }

            $l1tfRequired = $kvaShadowRequired

            $l1tfInvalidPteBit = ($flags -band $l1tfInvalidPteBitMask) -shr $l1tfInvalidPteBitShift

            $l1tfMitigationEnabled = ($l1tfInvalidPteBit -ne 0)

            $l1tfFlushSupported = (($flags -band $l1tfFlushSupportedFlag) -ne 0)

            if (($flags -band $l1tfMitigationPresentFlag) -or

                ($l1tfMitigationEnabled -eq $true) -or 

                ($l1tfFlushSupported -eq $true)) {

                $l1tfMitigationPresent = $true

            }

            if ($Quiet -ne $true -and $PSBoundParameters['Verbose']) {

                Write-Host "KvaShadowEnabled             :" (($flags -band $kvaShadowEnabledFlag) -ne 0)

                Write-Host "KvaShadowUserGlobal          :" (($flags -band $kvaShadowUserGlobalFlag) -ne 0)

                Write-Host "KvaShadowPcid                :" (($flags -band $kvaShadowPcidFlag) -ne 0)

                Write-Host "KvaShadowInvpcid             :" (($flags -band $kvaShadowInvpcidFlag) -ne 0)

                Write-Host "KvaShadowRequired            :" $kvaShadowRequired

                Write-Host "KvaShadowRequiredAvailable   :" (($flags -band $kvaShadowRequiredAvailableFlag) -ne 0)

                Write-Host "L1tfRequired                 :" $l1tfRequired

                Write-Host "L1tfInvalidPteBit            :" $l1tfInvalidPteBit

                Write-Host "L1tfFlushSupported           :" $l1tfFlushSupported

            }

        }

        if ($Quiet -ne $true) {

            Write-Host "Hardware requires kernel VA shadowing:"$kvaShadowRequired

            if ($kvaShadowRequired) {

                Write-Host "Windows OS support for kernel VA shadow is present:"$kvaShadowPresent

                Write-Host "Windows OS support for kernel VA shadow is enabled:"$kvaShadowEnabled

                if ($kvaShadowEnabled) {

                    Write-Host "Windows OS support for PCID performance optimization is enabled: $kvaShadowPcidEnabled [not required for security]"

                }

            }

        }

        $object | Add-Member -MemberType NoteProperty -Name KVAShadowRequired -Value $kvaShadowRequired

        $object | Add-Member -MemberType NoteProperty -Name KVAShadowWindowsSupportPresent -Value $kvaShadowPresent

        $object | Add-Member -MemberType NoteProperty -Name KVAShadowWindowsSupportEnabled -Value $kvaShadowEnabled

        $object | Add-Member -MemberType NoteProperty -Name KVAShadowPcidEnabled -Value $kvaShadowPcidEnabled

        #

        # Speculation Control Settings for CVE-2018-3639 (Speculative Store Bypass)

        #

        if ($Quiet -ne $true) {

            Write-Host

            Write-Host "Speculation control settings for CVE-2018-3639 [speculative store bypass]" -ForegroundColor Cyan

            Write-Host    

        }

        if ($Quiet -ne $true) {

            if (($ssbdAvailable -eq $true)) {

                Write-Host "Hardware is vulnerable to speculative store bypass:"$ssbdRequired

                if ($ssbdRequired -eq $true) {

                    Write-Host "Hardware support for speculative store bypass disable is present:"$ssbdHardwarePresent

                    Write-Host "Windows OS support for speculative store bypass disable is present:"$ssbdAvailable

                    Write-Host "Windows OS support for speculative store bypass disable is enabled system-wide:"$ssbdSystemWide

                }

            }

            else {

                Write-Host "Windows OS support for speculative store bypass disable is present:"$ssbdAvailable

            }

        }

        $object | Add-Member -MemberType NoteProperty -Name SSBDWindowsSupportPresent -Value $ssbdAvailable

        $object | Add-Member -MemberType NoteProperty -Name SSBDHardwareVulnerable -Value $ssbdRequired

        $object | Add-Member -MemberType NoteProperty -Name SSBDHardwarePresent -Value $ssbdHardwarePresent

        $object | Add-Member -MemberType NoteProperty -Name SSBDWindowsSupportEnabledSystemWide -Value $ssbdSystemWide

        #

        # Speculation Control Settings for CVE-2018-3620 (L1 Terminal Fault)

        #

        if ($Quiet -ne $true) {

            Write-Host

            Write-Host "Speculation control settings for CVE-2018-3620 [L1 terminal fault]" -ForegroundColor Cyan

            Write-Host    

        }

        if ($Quiet -ne $true) {

            Write-Host "Hardware is vulnerable to L1 terminal fault:"$l1tfRequired

            if ($l1tfRequired -eq $true) {

                Write-Host "Windows OS support for L1 terminal fault mitigation is present:"$l1tfMitigationPresent

                Write-Host "Windows OS support for L1 terminal fault mitigation is enabled:"$l1tfMitigationEnabled

            }

        }

        $object | Add-Member -MemberType NoteProperty -Name L1TFHardwareVulnerable -Value $l1tfRequired

        $object | Add-Member -MemberType NoteProperty -Name L1TFWindowsSupportPresent -Value $l1tfMitigationPresent

        $object | Add-Member -MemberType NoteProperty -Name L1TFWindowsSupportEnabled -Value $l1tfMitigationEnabled

        $object | Add-Member -MemberType NoteProperty -Name L1TFInvalidPteBit -Value $l1tfInvalidPteBit

        $object | Add-Member -MemberType NoteProperty -Name L1DFlushSupported -Value $l1tfFlushSupported

        #

        # Provide guidance as appropriate.

        #

        $actions = @()

        if ($btiHardwarePresent -eq $false) {

            $actions += "Install BIOS/firmware update provided by your device OEM that enables hardware support for the branch target injection mitigation."

        }

        if (($btiWindowsSupportPresent -eq $false) -or 

            ($kvaShadowPresent -eq $false) -or

            ($ssbdAvailable -eq $false) -or

            ($l1tfMitigationPresent -eq $false)) {

            $actions += "Install the latest available updates for Windows with support for speculation control mitigations."

        }

        if (($btiHardwarePresent -eq $true -and $btiWindowsSupportEnabled -eq $false) -or 

            ($kvaShadowRequired -eq $true -and $kvaShadowEnabled -eq $false) -or

            ($l1tfRequired -eq $true -and $l1tfMitigationEnabled -eq $false)) {

            $guidanceUri = ""

            $guidanceType = ""

            $os = Get-CimInstance Win32_OperatingSystem

            if ($os.ProductType -eq 1) {

                # Workstation

                $guidanceUri = "https://support.microsoft.com/help/4073119"

                $guidanceType = "Client"

            }

            else {

                # Server/DC

                $guidanceUri = "https://support.microsoft.com/help/4072698"

                $guidanceType = "Server"

            }

            $actions += "Follow the guidance for enabling Windows $guidanceType support for speculation control mitigations described in $guidanceUri"

        }

        if ($Quiet -ne $true -and $actions.Length -gt 0) {

            Write-Host

            Write-Host "Suggested actions" -ForegroundColor Cyan

            Write-Host 

            foreach ($action in $actions) {

                Write-Host " *" $action

            }

        }

        return $object

    }

    finally

    {

        if ($systemInformationPtr -ne [System.IntPtr]::Zero) {

            [System.Runtime.InteropServices.Marshal]::FreeHGlobal($systemInformationPtr)

        }

        if ($returnLengthPtr -ne [System.IntPtr]::Zero) {

            [System.Runtime.InteropServices.Marshal]::FreeHGlobal($returnLengthPtr)

        }

    }    

  }

}

# SIG # Begin signature block

# MIIdhQYJKoZIhvcNAQcCoIIddjCCHXICAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUY4g8OGRbQRd9YHIqMupziFen

# 0kCgghhTMIIEwzCCA6ugAwIBAgITMwAAAMvZUgZTvz4qWQAAAAAAyzANBgkqhkiG

# 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G

# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw

# HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTYwOTA3MTc1ODU1

# WhcNMTgwOTA3MTc1ODU1WjCBszELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjENMAsGA1UECxMETU9QUjEnMCUGA1UECxMebkNpcGhlciBEU0UgRVNO

# OjU4NDctRjc2MS00RjcwMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT

# ZXJ2aWNlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAum1PI6z8Uk7O

# jh+jHA7qkPtqGl+g9Ol0qKYBPtGxZ7SgIuZrXcfSVifUjgXwk+0q9TQFSiD+/b5L

# akoaE7Onwvh5GKjFrZH4Ymu8lwmIQBFCa5liePRTnVQybA/c18S/8AhhXn7t3/QL

# gh27vP7FnFy3lDYiVoEhxM40kv6vM0OuiBlFTxwWfBWzwHDem0cAw99IgtE4Ufac

# ftfmmIVMazRTlX1M1SLYTHo0u5yaOiU1ac1i2q/K30PewG+997QJHkpC6umA9XwH

# r4emFX3hqAChAO/fHrd3bRM0OMNH2sAFYTz41jH0D7ojyeRiRgMi+wAUtL1u+WTa

# 3RQ3NOF7VQIDAQABo4IBCTCCAQUwHQYDVR0OBBYEFJjHnFnzwMDY0qoqcv3dfXL2

# PD/mMB8GA1UdIwQYMBaAFCM0+NlSRnAK7UD7dvuzK7DDNbMPMFQGA1UdHwRNMEsw

# SaBHoEWGQ2h0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3Rz

# L01pY3Jvc29mdFRpbWVTdGFtcFBDQS5jcmwwWAYIKwYBBQUHAQEETDBKMEgGCCsG

# AQUFBzAChjxodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jv

# c29mdFRpbWVTdGFtcFBDQS5jcnQwEwYDVR0lBAwwCgYIKwYBBQUHAwgwDQYJKoZI

# hvcNAQEFBQADggEBAEsgBVRD0msYysh0uEFNws3dDP5riqpVsamGJpWCMlJGNl4+

# LX4JIv283MTsCU37LaNIbGjhTuSi4ifVyvs73xsicr4tPiGK7IYBRthKL/3tEjeM

# /mGWSfY2rZRgSwUKbPIGVz1IgHaOm089sb6Q6yC4EkEOAxTrhBS/4SZeTM2RuT0o

# 8rFtffWR4sW8SrpgvRQuz28WAu2wDZ3XTTvAmiF+cjumrx6fA8UaLhYG6LWvJZT6

# zrlsZ8DcTZMwZLnw6tKSiqvb6gvIcyDTcVj25GRul3yzLfgsmLWGTRN7woCSGzfd

# gykqBndYo4OS6E0ssxjPR8zJw0DbhJjvUMtJ/egwggX/MIID56ADAgECAhMzAAAB

# A14lHJkfox64AAAAAAEDMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTEwHhcNMTgwNzEyMjAwODQ4WhcNMTkwNzI2MjAwODQ4WjB0

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK

# AoIBAQDRlHY25oarNv5p+UZ8i4hQy5Bwf7BVqSQdfjnnBZ8PrHuXss5zCvvUmyRc

# FrU53Rt+M2wR/Dsm85iqXVNrqsPsE7jS789Xf8xly69NLjKxVitONAeJ/mkhvT5E

# +94SnYW/fHaGfXKxdpth5opkTEbOttU6jHeTd2chnLZaBl5HhvU80QnKDT3Nsumh

# UHjRhIjiATwi/K+WCMxdmcDt66VamJL1yEBOanOv3uN0etNfRpe84mcod5mswQ4x

# Fo8ADwH+S15UD8rEZT8K46NG2/YsAzoZvmgFFpzmfzS/p4eNZTkmyWPU78XdvSX+

# /Sj0NIZ5rCrVXzCRO+QUauuxygQjAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgor

# BgEEAYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUR77Ay+GmP/1l1jjyA123r3f3

# QP8wUAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25z

# IFB1ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDM3OTY1MB8GA1UdIwQYMBaA

# FEhuZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93

# d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAx

# MS0wNy0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFf

# MjAxMS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEA

# n/XJUw0/DSbsokTYDdGfY5YGSz8eXMUzo6TDbK8fwAG662XsnjMQD6esW9S9kGEX

# 5zHnwya0rPUn00iThoj+EjWRZCLRay07qCwVlCnSN5bmNf8MzsgGFhaeJLHiOflu

# DnjYDBu2KWAndjQkm925l3XLATutghIWIoCJFYS7mFAgsBcmhkmvzn1FFUM0ls+B

# XBgs1JPyZ6vic8g9o838Mh5gHOmwGzD7LLsHLpaEk0UoVFzNlv2g24HYtjDKQ7Hz

# SMCyRhxdXnYqWJ/U7vL0+khMtWGLsIxB6aq4nZD0/2pCD7k+6Q7slPyNgLt44yOn

# eFuybR/5WcF9ttE5yXnggxxgCto9sNHtNr9FB+kbNm7lPTsFA6fUpyUSj+Z2oxOz

# RVpDMYLa2ISuubAfdfX2HX1RETcn6LU1hHH3V6qu+olxyZjSnlpkdr6Mw30VapHx

# FPTy2TUxuNty+rR1yIibar+YRcdmstf/zpKQdeTr5obSyBvbJ8BblW9Jb1hdaSre

# U0v46Mp79mwV+QMZDxGFqk+av6pX3WDG9XEg9FGomsrp0es0Rz11+iLsVT9qGTlr

# EOlaP470I3gwsvKmOMs1jaqYWSRAuDpnpAdfoP7YO0kT+wzh7Qttg1DO8H8+4NkI

# 6IwhSkHC3uuOW+4Dwx1ubuZUNWZncnwa6lL2IsRyP64wggYHMIID76ADAgECAgph

# Fmg0AAAAAAAcMA0GCSqGSIb3DQEBBQUAMF8xEzARBgoJkiaJk/IsZAEZFgNjb20x

# GTAXBgoJkiaJk/IsZAEZFgltaWNyb3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eTAeFw0wNzA0MDMxMjUzMDlaFw0yMTA0

# MDMxMzAzMDlaMHcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# ITAfBgNVBAMTGE1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQTCCASIwDQYJKoZIhvcN

# AQEBBQADggEPADCCAQoCggEBAJ+hbLHf20iSKnxrLhnhveLjxZlRI1Ctzt0YTiQP

# 7tGn0UytdDAgEesH1VSVFUmUG0KSrphcMCbaAGvoe73siQcP9w4EmPCJzB/LMySH

# nfL0Zxws/HvniB3q506jocEjU8qN+kXPCdBer9CwQgSi+aZsk2fXKNxGU7CG0OUo

# Ri4nrIZPVVIM5AMs+2qQkDBuh/NZMJ36ftaXs+ghl3740hPzCLdTbVK0RZCfSABK

# R2YRJylmqJfk0waBSqL5hKcRRxQJgp+E7VV4/gGaHVAIhQAQMEbtt94jRrvELVSf

# rx54QTF3zJvfO4OToWECtR0Nsfz3m7IBziJLVP/5BcPCIAsCAwEAAaOCAaswggGn

# MA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFCM0+NlSRnAK7UD7dvuzK7DDNbMP

# MAsGA1UdDwQEAwIBhjAQBgkrBgEEAYI3FQEEAwIBADCBmAYDVR0jBIGQMIGNgBQO

# rIJgQFYnl+UlE/wq4QpTlVnkpKFjpGEwXzETMBEGCgmSJomT8ixkARkWA2NvbTEZ

# MBcGCgmSJomT8ixkARkWCW1pY3Jvc29mdDEtMCsGA1UEAxMkTWljcm9zb2Z0IFJv

# b3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5ghB5rRahSqClrUxzWPQHEy5lMFAGA1Ud

# HwRJMEcwRaBDoEGGP2h0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3By

# b2R1Y3RzL21pY3Jvc29mdHJvb3RjZXJ0LmNybDBUBggrBgEFBQcBAQRIMEYwRAYI

# KwYBBQUHMAKGOGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWlj

# cm9zb2Z0Um9vdENlcnQuY3J0MBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3

# DQEBBQUAA4ICAQAQl4rDXANENt3ptK132855UU0BsS50cVttDBOrzr57j7gu1BKi

# jG1iuFcCy04gE1CZ3XpA4le7r1iaHOEdAYasu3jyi9DsOwHu4r6PCgXIjUji8FMV

# 3U+rkuTnjWrVgMHmlPIGL4UD6ZEqJCJw+/b85HiZLg33B+JwvBhOnY5rCnKVuKE5

# nGctxVEO6mJcPxaYiyA/4gcaMvnMMUp2MT0rcgvI6nA9/4UKE9/CCmGO8Ne4F+tO

# i3/FNSteo7/rvH0LQnvUU3Ih7jDKu3hlXFsBFwoUDtLaFJj1PLlmWLMtL+f5hYbM

# UVbonXCUbKw5TNT2eb+qGHpiKe+imyk0BncaYsk9Hm0fgvALxyy7z0Oz5fnsfbXj

# pKh0NbhOxXEjEiZ2CzxSjHFaRkMUvLOzsE1nyJ9C/4B5IYCeFTBm6EISXhrIniIh

# 0EPpK+m79EjMLNTYMoBMJipIJF9a6lbvpt6Znco6b72BJ3QGEe52Ib+bgsEnVLax

# aj2JoXZhtG6hE6a/qkfwEm/9ijJssv7fUciMI8lmvZ0dhxJkAj0tr1mPuOQh5bWw

# ymO0eFQF1EEuUKyUsKV4q7OglnUa2ZKHE3UiLzKoCG6gW4wlv6DvhMoh1useT8ma

# 7kng9wFlb4kLfchpyOZu6qeXzjEp/w7FW1zYTRuh2Povnj8uVRZryROj/TCCB3ow

# ggVioAMCAQICCmEOkNIAAAAAAAMwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTExMDcwODIwNTkwOVoX

# DTI2MDcwODIxMDkwOVowfjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0

# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh

# dGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMTCC

# AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKvw+nIQHC6t2G6qghBNNLry

# tlghn0IbKmvpWlCquAY4GgRJun/DDB7dN2vGEtgL8DjCmQawyDnVARQxQtOJDXlk

# h36UYCRsr55JnOloXtLfm1OyCizDr9mpK656Ca/XllnKYBoF6WZ26DJSJhIv56sI

# UM+zRLdd2MQuA3WraPPLbfM6XKEW9Ea64DhkrG5kNXimoGMPLdNAk/jj3gcN1Vx5

# pUkp5w2+oBN3vpQ97/vjK1oQH01WKKJ6cuASOrdJXtjt7UORg9l7snuGG9k+sYxd

# 6IlPhBryoS9Z5JA7La4zWMW3Pv4y07MDPbGyr5I4ftKdgCz1TlaRITUlwzluZH9T

# upwPrRkjhMv0ugOGjfdf8NBSv4yUh7zAIXQlXxgotswnKDglmDlKNs98sZKuHCOn

# qWbsYR9q4ShJnV+I4iVd0yFLPlLEtVc/JAPw0XpbL9Uj43BdD1FGd7P4AOG8rAKC

# X9vAFbO9G9RVS+c5oQ/pI0m8GLhEfEXkwcNyeuBy5yTfv0aZxe/CHFfbg43sTUkw

# p6uO3+xbn6/83bBm4sGXgXvt1u1L50kppxMopqd9Z4DmimJ4X7IvhNdXnFy/dygo

# 8e1twyiPLI9AN0/B4YVEicQJTMXUpUMvdJX3bvh4IFgsE11glZo+TzOE2rCIF96e

# TvSWsLxGoGyY0uDWiIwLAgMBAAGjggHtMIIB6TAQBgkrBgEEAYI3FQEEAwIBADAd

# BgNVHQ4EFgQUSG5k5VAF04KqFzc3IrVtqMp1ApUwGQYJKwYBBAGCNxQCBAweCgBT

# AHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgw

# FoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDov

# L2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0

# MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKG

# Qmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0

# MjAxMV8yMDExXzAzXzIyLmNydDCBnwYDVR0gBIGXMIGUMIGRBgkrBgEEAYI3LgMw

# gYMwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# ZG9jcy9wcmltYXJ5Y3BzLmh0bTBABggrBgEFBQcCAjA0HjIgHQBMAGUAZwBhAGwA

# XwBwAG8AbABpAGMAeQBfAHMAdABhAHQAZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0B

# AQsFAAOCAgEAZ/KGpZjgVHkaLtPYdGcimwuWEeFjkplCln3SeQyQwWVfLiw++MNy

# 0W2D/r4/6ArKO79HqaPzadtjvyI1pZddZYSQfYtGUFXYDJJ80hpLHPM8QotS0LD9

# a+M+By4pm+Y9G6XUtR13lDni6WTJRD14eiPzE32mkHSDjfTLJgJGKsKKELukqQUM

# m+1o+mgulaAqPyprWEljHwlpblqYluSD9MCP80Yr3vw70L01724lruWvJ+3Q3fMO

# r5kol5hNDj0L8giJ1h/DMhji8MUtzluetEk5CsYKwsatruWy2dsViFFFWDgycSca

# f7H0J/jeLDogaZiyWYlobm+nt3TDQAUGpgEqKD6CPxNNZgvAs0314Y9/HG8VfUWn

# duVAKmWjw11SYobDHWM2l4bf2vP48hahmifhzaWX0O5dY0HjWwechz4GdwbRBrF1

# HxS+YWG18NzGGwS+30HHDiju3mUv7Jf2oVyW2ADWoUa9WfOXpQlLSBCZgB/QACnF

# sZulP0V3HjXG0qKin3p6IvpIlR+r+0cjgPWe+L9rt0uX4ut1eBrs6jeZeRhL/9az

# I2h15q/6/IvrC4DqaTuv/DDtBEyO3991bWORPdGdVk5Pv4BXIqF4ETIheu9BCrE/

# +6jMpF3BoYibV3FWTkhFwELJm3ZbCoBIa/15n8G9bW1qyVJzEw16UM0xggScMIIE

# mAIBATCBlTB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G

# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgw

# JgYDVQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExAhMzAAABA14l

# HJkfox64AAAAAAEDMAkGBSsOAwIaBQCggbAwGQYJKoZIhvcNAQkDMQwGCisGAQQB

# gjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkE

# MRYEFBa9ziRJCHcuhkpDM2GTNFsXqcJ5MFAGCisGAQQBgjcCAQwxQjBAoBaAFABQ

# AG8AdwBlAHIAUwBoAGUAbABsoSaAJGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9Q

# b3dlclNoZWxsIDANBgkqhkiG9w0BAQEFAASCAQCVgHQgt4fPrLqcN56FXaOTp2X4

# KwQPD3wrXXacx7OyRNpcVEkth5XGw8NVNtdnHpRRLVi4+QVLxEx0lPDGcbfMnuHn

# w7Y+q3WwwksRtmjoA4V5vZN6P5vEuOj17wZtsENGU2Kg4FUuScn+ty1FeeOVsfv5

# Wsktny4ppZE8GLvYh01zyNWNGyLvAztX7oZ/edj91CR64IRSyeW3v4NchKynbImx

# vNywMuuz8+XrLVgq5eFv1Wmt5sWwuQUaxmTidLNDZUHgFt58K0uCJPabGZlU9kQZ

# 66QkBMdY0jYZfNjiHTdPdaEkruDNgkzrrg2m7Lg4w9qaREgAWE0zb7juIvYQoYIC

# KDCCAiQGCSqGSIb3DQEJBjGCAhUwggIRAgEBMIGOMHcxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFBDQQITMwAAAMvZUgZTvz4qWQAAAAAAyzAJBgUrDgMCGgUAoF0wGAYJKoZI

# hvcNAQkDMQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUxDxcNMTgwODE2MTYyNTQy

# WjAjBgkqhkiG9w0BCQQxFgQUrm6sNFP+1cfvX1pPyOxvA+RFt5owDQYJKoZIhvcN

# AQEFBQAEggEATLdN8ZbXH1F+huoHo5YujK1cV5ZNKZhUMt8zfizvDv8mbvZv9j+1

# UrKkfSvPjUyaQWm+lMuuFox4FcGauAqbER09+ZxtmK3c/UaAFuwUrVH92Etxrgbn

# Vv3uNAOa47fcfMSGM1Fg1PVai1bCScvfbNCVwDwHekbKSolQ49EPzsRRPFxtErc7

# 0Z99+Azeyrmkwx3yTAM1ipdrANSNhGbLM3splIUIkjCr7KxiXDttBzQOtzsBld7b

# iIgRqRsxUIvv5OHTLBStTnFdYrrutGD3UQ8jtlBZmlUAuS1Pnc0lcDHZrBtaTT/U

# ECsW3Psc2NRit0awDwd8OsSWfVnQO4/cwA==

# SIG # End signature block