AzStackHci.EnvironmentChecker

1.2100.2790.560

AzStackHciPorts/AzStackHci.Ports.Helpers.psm1

                                Import-LocalizedData -BindingVariable lpTxt -FileName AzStackHci.Ports.Strings.psd1

class HealthModel

{

    # Attributes for Azure Monitor schema

    [string]$Name #Name of the individual test/rule/alert that was executed. Unique, not exposed to the customer.

    [string]$Title #User-facing name; one or more sentences indicating the direct issue.

    [string]$Severity #Severity of the result (Critical, Warning, Informational, Hidden) – this answers how important the result is. Critical is the only update-blocking severity.

    [string]$Description #Detailed overview of the issue and what impact the issue has on the stamp.

    [psobject]$Tags #Key-value pairs that allow grouping/filtering individual tests. For example, "Group": "ReadinessChecks", "UpdateType": "ClusterAware"

    [string]$Status #The status of the check running (i.e. Failed, Succeeded, In Progress) – this answers whether the check ran, and passed or failed.

    [string]$Remediation #Set of steps that can be taken to resolve the issue found.

    [string]$TargetResourceID #The unique identifier for the affected resource (such as a node or drive).

    [string]$TargetResourceName #The name of the affected resource.

    [string]$TargetResourceType #The type of resource being referred to (well-known set of nouns in infrastructure, aligning with Monitoring).

    [datetime]$Timestamp #The Time in which the HealthCheck was called.

    [psobject[]]$AdditionalData #Property bag of key value pairs for additional information.

    [string]$HealthCheckSource #The name of the services called for the HealthCheck (I.E. Test-AzureStack, Test-Cluster).

}

class AzStackHciPort

{

    [int[]]$PortNumber

    [string[]]$Protocol

    [string]$ProcessName

}

class AzStackHciPortTarget : HealthModel

{

    # Attribute for performing check

    [AzStackHciPort]$Port

    # Additional Attributes for end user interaction

    [string[]]$Service # short cut property to Service from tags

    [string[]]$OperationType # short cut property to Operation Type from tags

    [string[]]$Group # short cut property to group from tags

    [bool]$System # targets for system checks such as proxy traversal

}

function Get-AzStackHciPortTarget

{

    <#

        .SYNOPSIS

            Retrieve Ports from built target packs

        .DESCRIPTION

            Retrieve Ports from built target packs

        .EXAMPLE

            PS> Get-AzStackHciPortTarget

            Get all port targets

        .EXAMPLE

            Get-AzStackHciPortTarget -Service ARC | ft Name, Title, Service, OperationType -AutoSize

            Get all ARC port targets

        .EXAMPLE

            PS> Get-AzStackHciPortTarget -Service ARC -OperationType Workload | ft Name, Title, Service, OperationType -AutoSize

            Get all ARC targets for workloads

        .EXAMPLE

            PS> Get-AzStackHciPortTarget -OperationType Workload | ft Name, Title, Service, OperationType -AutoSize

            Get all targets for workloads

        .EXAMPLE

            PS> Get-AzStackHciPortTarget -OperationType ARC -OperationType Update -Additive | ft Name, Title, Service, OperationType -AutoSize

            Get all ARC targets and all targets for Update

        .INPUTS

            Service - String array

            OperationType - String array

            Additive - Switch

        .OUTPUTS

            PSObject

        .NOTES

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $false)]

        [string[]]

        $Service,

        [Parameter(Mandatory = $false)]

        [string[]]

        $OperationType,

        [Parameter(Mandatory = $false)]

        [string[]]

        $FilePath,

        [Parameter(Mandatory = $false)]

        [switch]

        $Additive,

        [Parameter(Mandatory = $false)]

        [switch]

        $IncludeSystem

    )

    try

    {

        Import-AzStackHciPortTarget -FilePath $FilePath

        $executionTargets = @()

        # Additive allows the user to "-OR" their parameter values

        if ($Additive)

        {

            Log-Info -Message $lpTxt.Additively

            if (-not [string]::IsNullOrEmpty($Service))

            {

                Log-Info -Message ($lpTxt.ByService -f ($Service -join ','))

                foreach ($svc in $Service)

                {

                    $executionTargets += $Script:AzStackHciPortTargets | Where-Object { $svc -in $_.Service }

                }

            }

            if (-not [string]::IsNullOrEmpty($OperationType))

            {

                Log-Info -Message ($lpTxt.ByOp -f ($OperationType -join ','))

                foreach ($Op in $OperationType)

                {

                    $executionTargets += $Script:AzStackHciPortTargets | Where-Object { $Op -in $_.OperationType }

                }

            }

            if ([string]::IsNullOrEmpty($OperationType) -and [string]::IsNullOrEmpty($Service))

            {

                $executionTargets += $Script:AzStackHciPortTargets

            }

        }

        else

        {

            if ([string]::IsNullOrEmpty($OperationType) -and [string]::IsNullOrEmpty($Service))

            {

                $executionTargets += $Script:AzStackHciPortTargets

            }

            elseif (-not [string]::IsNullOrEmpty($Service) -and [string]::IsNullOrEmpty($OperationType))

            {

                Log-Info -Message ($lpTxt.ByService -f ($Service -join ','))

                foreach ($svc in $Service)

                {

                    $executionTargets += $Script:AzStackHciPortTargets | Where-Object { $svc -in $_.Service }

                }

            }

            elseif (-not [string]::IsNullOrEmpty($OperationType) -and [string]::IsNullOrEmpty($Service))

            {

                Log-Info -Message ($lpTxt.ByOp -f ($OperationType -join ','))

                foreach ($Op in $OperationType)

                {

                    $executionTargets += $Script:AzStackHciPortTargets | Where-Object { $Op -in $_.OperationType }

                }

            }

            else

            {

                Log-Info -Message ($lpTxt.ByOpAndService -f ($OperationType -join ','), ($Service -join ','))

                $executionTargetsByOp = @()

                foreach ($Op in $OperationType)

                {

                    $executionTargetsByOp += $Script:AzStackHciPortTargets | Where-Object { $Op -in $_.OperationType }

                }

                foreach ($svc in $Service)

                {

                    $executionTargets += $executionTargetsByOp | Where-Object { $svc -in $_.Service }

                }

            }

        }

        if ($IncludeSystem)

        {

            return $executionTargets

        }

        else

        {

            return ($executionTargets | Where-Object Service -NotContains 'System')

        }

    }

    catch

    {

        throw "Get failed: $($_.exception)"

    }

}

function Import-AzStackHciPortTarget

{

    <#

    .SYNOPSIS

        Retrieve Ports from built target packs

    .DESCRIPTION

        Retrieve Ports from built target packs

    .EXAMPLE

        PS C:\> Import-AzStackHciPortTarget

        Explanation of what the example does

    .INPUTS

        URI

    .OUTPUTS

        PSObject

    .NOTES

    #>

    [CmdletBinding()]

    param (

        [string[]]

        $FilePath

    )

    try

    {

        $Script:AzStackHciPortTargets = @()

        if ([string]::IsNullOrEmpty($FilePath))

        {

            $FilePath = "$PSScriptRoot\Targets\*.json"

        }

        $targetFiles = Get-ChildItem -Path $FilePath | Select-Object -ExpandProperty FullName

        if (-not $targetFiles)

        {

            throw $lpTxt.NoTargets

        }

        Log-Info ("Importing {0}" -f ($targetFiles -join ','))

        ForEach ($targetFile in $targetFiles)

        {

            try

            {

                #  TO DO - Add validations:

                #  - protocol should not contain ://

                $targetPackContent = Get-Content -Path $targetFile | ConvertFrom-Json -WarningAction SilentlyContinue

                foreach ($target in $targetPackContent)

                {

                    #Set Name of the individual test/rule/alert that was executed. Unique, not exposed to the customer.

                    $target | Add-Member -MemberType NoteProperty -Name Name -Value ("AzStackHci_Port_{0}" -f $Target.TargetResourceName) -Force

                    $target | Add-Member -MemberType NoteProperty -Name HealthCheckSource -Value $ENV:EnvChkrId -Force

                    $target | Add-Member -MemberType NoteProperty -Name Service -Value $Target.Tags.Service -Force

                    $target | Add-Member -MemberType NoteProperty -Name OperationType -Value $Target.Tags.OperationType -Force

                    $target | Add-Member -MemberType NoteProperty -Name Group -Value $Target.Tags.Group -Force

                    # TO DO: Determine the proper use of TargetResourceID

                    $target.TargetResourceID = (New-Guid).Guid.ToString()

                    $Script:AzStackHciPortTargets += [AzStackHciPortTarget]$target

                }

            }

            catch

            {

                Log-Info -Type Warning -Message ($lpTxt.CannotReadTargetFile -f (Split-Path -Path $targetFile -Leaf), $_.Exception.Message)

            }

        }

    }

    catch

    {

        throw "Import failed: $($_.exception)"

    }

}

function Get-AzStackHciPortServiceName

{

    <#

    .SYNOPSIS

        Retrieve Services from built target packs

    .DESCRIPTION

        Retrieve Services from built target packs

    .EXAMPLE

        PS C:\> Get-AzStackHciPortServiceName

        Explanation of what the example does

    .INPUTS

        Service

    .OUTPUTS

        PSObject

    .NOTES

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $false)]

        [string[]]

        $Service,

        [Parameter(Mandatory = $false)]

        [switch]

        $IncludeSystem

    )

    try

    {

        Get-AzStackHciPortTarget -IncludeSystem:$IncludeSystem | Select-Object -ExpandProperty Service | Sort-Object | Get-Unique

    }

    catch

    {

        throw "Failed to get services names. Error: $($_.Exception.Message)"

    }

}

function Get-AzStackHciPortOperationName

{

    <#

    .SYNOPSIS

        Retrieve Operation Types from built target packs

    .DESCRIPTION

        Retrieve Operation Types from built target packs e.g. Deployment, Update, Secret Rotation.

    .EXAMPLE

        PS C:\> Get-AzStackHciPortOperationName

        Explanation of what the example does

    .INPUTS

        Service

    .OUTPUTS

        PSObject

    .NOTES

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $false)]

        [string]

        $OperationType

    )

    try

    {

        Get-AzStackHciPortTarget | Select-Object -ExpandProperty OperationType | Sort-Object | Get-Unique

    }

    catch

    {

        throw "Failed to get services names. Error: $($_.Exception.Message)"

    }

}

function Invoke-PortConnection

{

    <#

    .SYNOPSIS

        Get port via Get-NetTCPConnection & Get-NetUDPEndpoint

    .DESCRIPTION

        Get port via Get-NetTCPConnection & Get-NetUDPEndpoint

    .EXAMPLE

        PS C:\> Invoke-NetTCPConnectionEx -Target $Target

        Explanation of what the example does

    .INPUTS

        URI

    .OUTPUTS

        Output (if any)

    .NOTES

    #>

    [CmdletBinding()]

    param (

        [Parameter()]

        [psobject]

        $Target,

        [Parameter()]

        [System.Management.Automation.Runspaces.PSSession[]]

        $PsSession

    )

    try

    {

        $ProgressPreference = 'SilentlyContinue'

        $target.TimeStamp = [datetime]::UtcNow

        $Target.HealthCheckSource = $ENV:EnvChkrId

        # Create ScriptBlock

        $scriptBlock = {

            $Target = $args[0]

            $AdditionalData = @()

            if ( -not (Get-Command Get-NetTCPConnection, Get-NetUDPEndpoint -ea SilentlyContinue))

            {

                throw "Get-NetTCPConnection and Get-NetUDPEndpoint commands not available. Ensure NetTCPIP module is installed."

            }

            foreach ($rule in $target.Port)

            {

                foreach ($port in $rule.PortNumber)

                {

                    # Placeholder AdditionalData

                    $AddData = New-Object -TypeName PSObject -Property @{

                        Source    = $ENV:COMPUTERNAME

                        Resource  = $port

                        Status    = "In Progress"

                        TimeStamp = [datetime]::UtcNow

                        Detail    = $null

                    }

                    # Test the port

                    if ('UDP' -in $rule.protocol)

                    {

                        $udpResult = Get-NetUDPEndpoint -LocalPort $Port -ErrorAction SilentlyContinue

                    }

                    if ('TCP' -in $rule.protocol)

                    {

                        $tcpResult = Get-NetTCPConnection -LocalPort $Port -ErrorAction SilentlyContinue

                    }

                    # Make uniform output

                    if ($tcpResult)

                    {

                        $AddData.Detail += $tcpResult | Select-Object LocalAddress, RemoteAddress, RemotePort, State, OwningProcess, `

                        @{ 'Label' = 'LocalPort'; Expression = { "TCP:$($_.LocalPort)" } }, `

                        @{ 'Label' = 'Protocol'; Expression = { 'tcp' } }, `

                        @{ 'Label' = 'ProcessName'; Expression = { (Get-Process -Id $_.OwningProcess).ProcessName } },

                        @{ 'Label' = 'Status'; Expression = { if ((Get-Process -Id $_.OwningProcess).ProcessName -eq $rule.ProcessName) { 'Succeeded' } else { 'Failed' } } }

                        $tcpResult | Where-Object Status -EQ 'Failed' | ForEach-Object { Write-Verbose -Verbose "$($_.LocalPort) owned by $($_.ProcessName). Expected $($rule.ProcessName)" }

                    }

                    if ($udpResult)

                    {

                        $AddData.Detail += $udpResult | Select-Object LocalAddress, OwningProcess, `

                        @{ 'Label' = 'LocalPort'; Expression = { "UDP:$($_.LocalPort)" } }, `

                        @{ 'Label' = 'Protocol'; Expression = { 'udp' } }, `

                        @{ 'Label' = 'ProcessName'; Expression = { (Get-Process -Id $_.OwningProcess).ProcessName } },

                        @{ 'Label' = 'Status'; Expression = { if ((Get-Process -Id $_.OwningProcess).ProcessName -eq $rule.ProcessName) { 'Succeeded' } else { 'Failed' } } }

                        $udpResult | Where-Object Status -EQ 'Failed' | ForEach-Object { Write-Verbose -Verbose "$($_.LocalPort) owned by $($_.ProcessName). Expected $($rule.ProcessName)" }

                    }

                    # Determine success/failure

                    $addData.Status = if ($AddData.Detail.Status -Contains 'Failed')

                    {

                        "Failed"

                    }

                    else

                    {

                        "Succeeded"

                    }

                    $AdditionalData += $AddData

                }

            }

            if ($AdditionalData.Status -contains 'Failed')

            {

                $target.Status = 'Failed'

                Log-Info "$($target.Title) failed:"

            }

            else

            {

                $target.Status = 'Succeeded'

                Log-Info "$($target.Title) succeeded:"

            }

            $AdditionalData | ForEach-Object { Log-Info ("Port detail {0}: {1}, {2}" -f $_.Status, $_.Resource, (($_.Detail | ConvertTo-Json -Depth 5) -replace "`r`n", " " -replace "  ", "")) }

            $target.AdditionalData = $AdditionalData

            $Target.HealthCheckSource = $ENV:EnvChkrId

            return $target

        }

        # Run Invoke-Command

        $icmParam = @{

            ScriptBlock  = $scriptBlock

            ArgumentList = $Target

        }

        if ($PsSession)

        {

            $icmParam += @{

                Session = $PsSession

            }

        }

        Invoke-Command @icmParam

    }

    catch

    {

        throw $_

    }

    finally

    {

        $ProgressPreference = 'Continue'

    }

}

# SIG # Begin signature block

# MIIoLQYJKoZIhvcNAQcCoIIoHjCCKBoCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBFTdHg68nJ4YWA

# RpbQ/rGRG0bGqTtpJ9oc+wcQHRqXsKCCDXYwggX0MIID3KADAgECAhMzAAADrzBA

# DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA

# hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG

# 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN

# xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL

# go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB

# tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw

# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW

# MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci

# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG

# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0

# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd

# mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ

# 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY

# 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp

# XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn

# TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT

# e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG

# OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O

# PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk

# ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx

# HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt

# CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq

# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5

# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg

# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03

# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr

# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg

# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy

# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9

# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh

# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k

# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB

# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn

# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90

# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w

# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o

# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD

# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa

# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny

# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG

# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV

# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG

# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl

# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb

# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l

# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6

# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0

# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560

# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam

# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa

# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah

# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA

# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt

# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr

# /Xmfwb1tbWrJUnMTDXpQzTGCGg0wghoJAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB

# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIDuyu0oekbVXvc1Ohg2rrBOB

# gBiVBlYXOhl5WPegc/Q4MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A

# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB

# BQAEggEAoZY3yXfgsngfWj8CuAqNkCbskTu/5p5kR9IY93+qk9+mWmENGHNXVsQc

# xJ6kSUOdANJ7/Ioc+Z39CRmUIuz3bRXhF/oOoSSvkR1NqwOAiKDKINY4iqja4+Xo

# eHsU2uTBkAK6SQ+5RDxCmBXipF7xtoXZ6T17oQtAEk9q9ePV1Zwh0g680KIBwBrt

# A7VTfJfsrrDHN2vI2WYugZ0s2kL08uietDEMj8kbr8SryDCwnqCcDGLe0CndtVZM

# CznNPTklahPyv+0YpcQOsxiPbQkb18xWjzb50ikayjaDI+3owhAube0pgAjxjzBV

# O0bx7CezTe1/E5H6V2O7XfI6hyUXq6GCF5cwgheTBgorBgEEAYI3AwMBMYIXgzCC

# F38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsq

# hkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl

# AwQCAQUABCBv72igd7JZ63wQFeoPLLJ0XrqMo46U7om0YDrUb8REYQIGZuMREQjN

# GBMyMDI0MTAwOTAxMTUxOS4yODNaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l

# cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzcwMy0w

# NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Wg

# ghHtMIIHIDCCBQigAwIBAgITMwAAAeqaJHLVWT9hYwABAAAB6jANBgkqhkiG9w0B

# AQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD

# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yMzEyMDYxODQ1

# MzBaFw0yNTAzMDUxODQ1MzBaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z

# MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzcwMy0wNUUwLUQ5NDcxJTAjBgNV

# BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQC1C1/xSD8gB9X7Ludoo2rWb2ksqaF65QtJkbQpmsc6

# G4bg5MOv6WP/uJ4XOJvKX/c1t0ej4oWBqdGD6VbjXX4T0KfylTulrzKtgxnxZh7q

# 1uD0Dy/w5G0DJDPb6oxQrz6vMV2Z3y9ZxjfZqBnDfqGon/4VDHnZhdas22svSC5G

# HywsQ2J90MM7L4ecY8TnLI85kXXTVESb09txL2tHMYrB+KHCy08ds36an7IcOGfR

# mhHbFoPa5om9YGpVKS8xeT7EAwW7WbXL/lo5p9KRRIjAlsBBHD1TdGBucrGC3TQX

# STp9s7DjkvvNFuUa0BKsz6UiCLxJGQSZhd2iOJTEfJ1fxYk2nY6SCKsV+VmtV5ai

# PzY/sWoFY542+zzrAPr4elrvr9uB6ci/Kci//EOERZEUTBPXME/ia+t8jrT2y3ug

# 15MSCVuhOsNrmuZFwaRCrRED0yz4V9wlMTGHIJW55iNM3HPVJJ19vOSvrCP9lsEc

# EwWZIQ1FCyPOnkM1fs7880dahAa5UmPqMk5WEKxzDPVp081X5RQ6HGVUz6ZdgQ0j

# cT59EG+CKDPRD6mx8ovzIpS/r/wEHPKt5kOhYrjyQHXc9KHKTWfXpAVj1Syqt5X4

# nr+Mpeubv+N/PjQEPr0iYJDjSzJrqILhBs5pytb6vyR8HUVMp+mAA4rXjOw42vkH

# fQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFCuBRSWiUebpF0BU1MTIcosFblleMB8G

# A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG

# Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy

# MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w

# XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy

# dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG

# A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD

# AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQAog61WXj9+/nxVbX3G37KgvyoNAnuu2w3H

# oWZj3H0YCeQ3b9KSZThVThW4iFcHrKnhFMBbXJX4uQI53kOWSaWCaV3xCznpRt3c

# 4/gSn3dvO/1GP3MJkpJfgo56CgS9zLOiP31kfmpUdPqekZb4ivMR6LoPb5HNlq0W

# bBpzFbtsTjNrTyfqqcqAwc6r99Df2UQTqDa0vzwpA8CxiAg2KlbPyMwBOPcr9hJT

# 8sGpX/ZhLDh11dZcbUAzXHo1RJorSSftVa9hLWnzxGzEGafPUwLmoETihOGLqIQl

# Cpvr94Hiak0Gq0wY6lduUQjk/lxZ4EzAw/cGMek8J3QdiNS8u9ujYh1B7NLr6t3I

# glfScDV3bdVWet1itTUoKVRLIivRDwAT7dRH13Cq32j2JG5BYu/XitRE8cdzaJmD

# VBzYhlPl9QXvC+6qR8I6NIN/9914bTq/S4g6FF4f1dixUxE4qlfUPMixGr0Ft4/S

# 0P4fwmhs+WHRn62PB4j3zCHixKJCsRn9IR3ExBQKQdMi5auiqB6xQBADUf+F7hSK

# ZfbA8sFSFreLSqhvj+qUQF84NcxuaxpbJWVpsO18IL4Qbt45Cz/QMa7EmMGNn7a8

# MM3uTQOlQy0u6c/jq111i1JqMjayTceQZNMBMM5EMc5Dr5m3T4bDj9WTNLgP8SFe

# 3EqTaWVMOTCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI

# hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy

# MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC

# AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg

# M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF

# dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6

# GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp

# Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu

# yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E

# XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0

# lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q

# GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ

# +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA

# PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw

# EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG

# NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV

# MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK

# BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC

# AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX

# zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v

# cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI

# KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG

# 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x

# M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC

# VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449

# xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM

# nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS

# PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d

# Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn

# GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs

# QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL

# jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL

# 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNQ

# MIICOAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn

# MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjM3MDMtMDVFMC1EOTQ3MSUwIwYDVQQD

# ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQCJ

# 2x7cQfjpRskJ8UGIctOCkmEkj6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6q/UFTAiGA8yMDI0MTAwODE1NTM1

# N1oYDzIwMjQxMDA5MTU1MzU3WjB3MD0GCisGAQQBhFkKBAExLzAtMAoCBQDqr9QV

# AgEAMAoCAQACAgarAgH/MAcCAQACAhMVMAoCBQDqsSWVAgEAMDYGCisGAQQBhFkK

# BAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJ

# KoZIhvcNAQELBQADggEBADTq0SfLWoaIQobNWmh1yc499d01oeR+zmIlwWV+UQU9

# 3av0ywT3YFxeKOwEZh4ubmwyDDuiGQZb66/mf3hsKoVP/SCk9GeoauwpcwzeQ/XJ

# 8QRvWBFfbHQXNiqpy3nKUUvvTdPPXYbddL5K9xXlKDqtG8K2ZtjnQjVsc8kuBSpd

# a9rYbSRiDTuX27g+5Oz0carhn1S6Q8daDYfBdq1rGlnm484sMKwf4a9A3M75O9yh

# r6Q/R1/RvaKvIMbzcMLqbIkgNLkJ+O0aYzgNHj3LR+/jQD/gQZnmg5cmw41wwVIh

# R/QPT+6WwmAu7w3c53U4p+q+vuwewu/NgS5YOL69rjIxggQNMIIECQIBATCBkzB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAeqaJHLVWT9hYwABAAAB

# 6jANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEE

# MC8GCSqGSIb3DQEJBDEiBCAHpfK9f64fVQQ4qgdFGqCB/hKfJYch5ilNxMo4PGmL

# nDCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EICmPodXjZDR4iwg0ltLANXBh

# 5G1uKqKIvq8sjKekuGZ4MIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT

# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB

# IDIwMTACEzMAAAHqmiRy1Vk/YWMAAQAAAeowIgQgi57JVFUz2dugLFwj3K83GNrk

# sl0+rbqYvTsnfwx/laIwDQYJKoZIhvcNAQELBQAEggIAjNKJy0tAPtDE2Q+VDiKo

# muX4j3zvMxuFB70TMYdu/SgOaDJdjqXdKAVLzddyj5FD/wJhiNeHKJgqtxIWj4ie

# CxTekPFE9gSjw5WcREhek2PgXh+1vO8KyvK7hk+HJaGtp9xzzHZLQExmDzfO4b6K

# L7sdWPZEgTrDkIFJBaCj5+/RV6PSJb1k6M3qbeSnpNJ10q5XuYT9C4VjNXkL/ogL

# CFTnkOz5F7C9QeXAKhRHr30rJa/hMDsFzRmDHac28i4B95Eo7IraeRirl16uxwRi

# 1x1NuRNPrOFzLy1rXVmWUfuF6q8JWEIkdt0iDgYC/TKVEpfWnF1G+I0jbPmAku+x

# QF1oeNiedTTI7yg022TTcgzJTfdacqFnuRgF2zd9ArpHEqzR/qx/9CvU/H/PKtdD

# xgeevpfMlhZxb2Fz5xDheqvi0ngyfvVB/aAFMJAD+rS0Mv+aSx4uhj13ZcwvNbzT

# 6Htwe34kfbi8HZHRYXc7R4FaMcvFYgoone8D4AwReXdD+GK22fIT9pcP6haIdnF7

# zb7Np05De5VadopkLO+TuLiRqCm0LqHCb6Wn+MaDvtN2IXsfjRXIi/kYXXsfgr+T

# DR1tG4gSztivQiNnmN6y9Cy2ExREdTMaYIyAcv603KePy7D09yiTF5tsRn9KoeHc

# LUymh1ehdMW8TbFr2VEFYEc=

# SIG # End signature block