AzSKStaging.ADO

1.9.8

Framework/Helpers/RemoteReportHelper.ps1

                                Set-StrictMode -Version Latest

class RemoteReportHelper

{

    hidden static [string[]] $IgnoreScanParamList = "DoNotOpenOutputFolder";

    hidden static [string[]] $AllowedServiceScanParamList = "organizationName", "ResourceGroupNames";

    hidden static [string[]] $AllowedOrganizationScanParamList = "organizationName";

    hidden static [int] $MaxServiceParamCount = [RemoteReportHelper]::IgnoreScanParamList.Count + [RemoteReportHelper]::AllowedServiceScanParamList.Count;

    hidden static [int] $MaxOrganizationParamCount = [RemoteReportHelper]::IgnoreScanParamList.Count + [RemoteReportHelper]::AllowedOrganizationScanParamList.Count;

    hidden static [System.Security.Cryptography.SHA256Managed] $sha256AlgForMasking = [System.Security.Cryptography.SHA256Managed]::new();

    hidden static [AIOrgTelemetryStatus] $AIOrgTelemetryState = [AIOrgTelemetryStatus]::Undefined;

    hidden static [string] $TelemetryKey = "";

    static [FeatureGroup] GetFeatureGroup([SVTEventContext[]] $SVTEventContexts)

    {

        if(($SVTEventContexts | Measure-Object).Count -eq 0 -or $null -eq $SVTEventContexts[0].FeatureName) {

            return [FeatureGroup]::Unknown

        }

        $feature = $SVTEventContexts[0].FeatureName.ToLower()

        if($feature.Contains("organization")){

            return [FeatureGroup]::Organization

        } else{

            return [FeatureGroup]::Service

        }

    }

    static [ServiceScanKind] GetServiceScanKind([string] $command, [hashtable] $parameters)

    {

        $parameterNames = [array] $parameters.Keys

        if($parameterNames.Count -gt [RemoteReportHelper]::MaxServiceParamCount)

        {

            return [ServiceScanKind]::Partial;

        }

        $validParamCounter = 0;

        foreach($parameterName in $parameterNames)

        {

            if ([RemoteReportHelper]::AllowedServiceScanParamList.Contains($parameterName))

            {

                $validParamCounter += 1

            }

            elseif ([RemoteReportHelper]::IgnoreScanParamList.Contains($parameterName))

            {

                # Ignoring

            }

            else

            {

                return [ServiceScanKind]::Partial;

            }

        }

        if ($validParamCounter -eq 1)

        {

            return [ServiceScanKind]::Organization;

        }

        elseif ($validParamCounter -eq 2)

        {

            return [ServiceScanKind]::ResourceGroup;

        }

        else

        {

            return [ServiceScanKind]::Partial;

        }

    }

    static [OrganizationScanKind] GetOrganizationScanKind([string] $command, [hashtable] $parameters)

    {

        $parameterNames = [array] $parameters.Keys

        if($parameterNames.Count -gt [RemoteReportHelper]::MaxOrganizationParamCount)

        {

            return [OrganizationScanKind]::Partial;

        }

        $validParamCounter = 0;

        foreach($parameterName in $parameterNames)

        {

            if ([RemoteReportHelper]::AllowedOrganizationScanParamList.Contains($parameterName))

            {

                $validParamCounter += 1

            }

            elseif ([RemoteReportHelper]::IgnoreScanParamList.Contains($parameterName))

            {

                # Ignoring

            }

            else

            {

                return [OrganizationScanKind]::Partial;

            }

        }

        if ($validParamCounter -eq 1)

        {

            return [OrganizationScanKind]::Complete;

        }

        else

        {

            return [OrganizationScanKind]::Partial;

        }

    }

    static [OrganizationControlResult] BuildOrganizationControlResult([ControlResult] $controlResult, [ControlItem] $control)

    {

        $result = [OrganizationControlResult]::new()

        $result.ControlId = $control.ControlId

        $result.ControlIntId = $control.Id

        $result.ControlSeverity = $control.ControlSeverity

        $result.ActualVerificationResult = $controlResult.ActualVerificationResult

        $result.AttestationStatus = $controlResult.AttestationStatus

        $result.VerificationResult = $controlResult.VerificationResult

        $result.HasRequiredAccess = $controlResult.CurrentSessionContext.Permissions.HasRequiredAccess

        $result.IsBaselineControl = $control.IsBaselineControl

        #add PreviewBaselineFlag

        $result.IsPreviewBaselineControl = $control.IsPreviewBaselineControl

        $result.MaximumAllowedGraceDays = $controlResult.MaximumAllowedGraceDays

        if($control.Tags.Contains("OwnerAccess")  -or $control.Tags.Contains("GraphRead"))

        {

            $result.HasOwnerAccessTag = $true

        }

        $result.UserComments = $controlResult.UserComments

        if($null -ne $controlResult.StateManagement -and $null -ne $controlResult.StateManagement.AttestedStateData) {

            $result.AttestedBy = $controlResult.StateManagement.AttestedStateData.AttestedBy

            $result.Justification = $controlResult.StateManagement.AttestedStateData.Justification

            $result.AttestedState = [JsonHelper]::ConvertToJsonCustomCompressed($controlResult.StateManagement.AttestedStateData.DataObject)

            $result.AttestedDate = $controlResult.StateManagement.AttestedStateData.AttestedDate

            $result.AttestationExpiryDate = $controlResult.StateManagement.AttestedStateData.ExpiryDate

        }

        if($null -ne $controlResult.StateManagement -and $null -ne $controlResult.StateManagement.CurrentStateData) {

            $result.CurrentState = [JsonHelper]::ConvertToJsonCustomCompressed($controlResult.StateManagement.CurrentStateData.DataObject)

        }

        return $result;

    }

    static [ServiceControlResult] BuildServiceControlResult([ControlResult] $controlResult, [bool] $isNestedResource, [ControlItem] $control)

    {

        $result = [ServiceControlResult]::new()

        $result.IsNestedResource = $isNestedResource

        if ($isNestedResource)

        {

            $result.NestedResourceName = $controlResult.ChildResourceName

        }

        else

        {

            $result.NestedResourceName = $null

        }

        $result.ControlId = $control.ControlID

        $result.ControlIntId = $control.Id

        $result.ControlSeverity = $control.ControlSeverity

        $result.ActualVerificationResult = $controlResult.ActualVerificationResult

        $result.AttestationStatus = $controlResult.AttestationStatus

        $result.VerificationResult = $controlResult.VerificationResult

        $result.HasRequiredAccess = $controlResult.CurrentSessionContext.Permissions.HasRequiredAccess

        $result.IsBaselineControl = $control.IsBaselineControl

        #add PreviewBaselineFlag

        $result.IsPreviewBaselineControl = $control.IsPreviewBaselineControl

        $result.UserComments = $controlResult.UserComments

        $result.MaximumAllowedGraceDays = $controlResult.MaximumAllowedGraceDays

        if($control.Tags.Contains("OwnerAccess")  -or $control.Tags.Contains("GraphRead"))

        {

            $result.HasOwnerAccessTag = $true

        }

        if($null -ne $controlResult.StateManagement -and $null -ne $controlResult.StateManagement.AttestedStateData) {

            $result.AttestedBy = $controlResult.StateManagement.AttestedStateData.AttestedBy

            $result.Justification = $controlResult.StateManagement.AttestedStateData.Justification

            $result.AttestedState = [JsonHelper]::ConvertToJsonCustomCompressed($controlResult.StateManagement.AttestedStateData.DataObject)

            $result.AttestedDate = $controlResult.StateManagement.AttestedStateData.AttestedDate

            $result.AttestationExpiryDate = $controlResult.StateManagement.AttestedStateData.ExpiryDate

        }

        if($null -ne $controlResult.StateManagement -and $null -ne $controlResult.StateManagement.CurrentStateData) {

            $result.CurrentState = [JsonHelper]::ConvertToJsonCustomCompressed($controlResult.StateManagement.CurrentStateData.DataObject)

        }

        return $result;

    }

    static [ScanSource] GetScanSource()

    {        

        $settings = [ConfigurationManager]::GetAzSKSettings();

        [string] $laSource = $settings.LASource;

        if([string]::IsNullOrWhiteSpace($laSource)){

            return [ScanSource]::SpotCheck

        }

        if($laSource.Equals("CICD", [System.StringComparison]::OrdinalIgnoreCase)){

            return [ScanSource]::VSO

        }

        if($laSource.Equals("CA", [System.StringComparison]::OrdinalIgnoreCase)){

            return [ScanSource]::Runbook

        }

        return [ScanSource]::SpotCheck

    }

    static [string] GetAIOrgTelemetryKey()

    {

        if(-not [string]::IsNullOrEmpty([RemoteReportHelper]::TelemetryKey))

        {

            return [RemoteReportHelper]::TelemetryKey

        }

        $settings = [ConfigurationManager]::GetAzSKConfigData();

        [RemoteReportHelper]::TelemetryKey = $settings.ControlTelemetryKey

        [guid]$key = [guid]::Empty

        # Trying to parse [RemoteReportHelper]::TelemetryKey into  $key and then checking that it is not empty

        if([guid]::TryParse([RemoteReportHelper]::TelemetryKey, [ref] $key) -and ![guid]::Empty.Equals($key))

        {

            return [RemoteReportHelper]::TelemetryKey;

        }

        [RemoteReportHelper]::TelemetryKey = [ConfigurationManager]::GetAzSKSettings().LocalControlTelemetryKey

        return [RemoteReportHelper]::TelemetryKey;

    }

    static [bool] IsAIOrgTelemetryEnabled()

    {

        if([RemoteReportHelper]::AIOrgTelemetryState -eq [AIOrgTelemetryStatus]::Enabled)

        {

            return $true

        }

        elseif([RemoteReportHelper]::AIOrgTelemetryState -eq [AIOrgTelemetryStatus]::Disabled)

        {

            return $false

        }

        #If AIOrgTelemetryState is Undefined then evaluate

        $settings = [ConfigurationManager]::GetAzSKConfigData();

        $orgTelemetryKey = $settings.ControlTelemetryKey

        [guid]$key = [guid]::Empty

        # Trying to parse [RemoteReportHelper]::TelemetryKey into  $key and then checking that it is not empty

        if([guid]::TryParse($orgTelemetryKey, [ref] $key) -and ![guid]::Empty.Equals($key))

        {

            if($settings.EnableControlTelemetry)

            {

                [RemoteReportHelper]::AIOrgTelemetryState = [AIOrgTelemetryStatus]::Enabled

                return $true

            }

            else 

            {

                [RemoteReportHelper]::AIOrgTelemetryState = [AIOrgTelemetryStatus]::Disabled

                return $false

            }

        }

        if([ConfigurationManager]::GetAzSKSettings().LocalEnableControlTelemetry)

        {

            [RemoteReportHelper]::AIOrgTelemetryState = [AIOrgTelemetryStatus]::Enabled

            return $true

        }

        else 

        {

            [RemoteReportHelper]::AIOrgTelemetryState = [AIOrgTelemetryStatus]::Disabled

            return $false

        }

    }

    static [string] Mask([psobject] $toMask)

    {

        $maskBytes = [System.Text.Encoding]::UTF8.GetBytes($toMask.ToString().ToLower())

        $maskBytes = ([RemoteReportHelper]::sha256AlgForMasking).ComputeHash($maskBytes)

        $take = 16

        $sb = [System.Text.StringBuilder]::new($take)

        for($i = 0; $i -lt ($take/2); $i++){

            $x = $sb.Append($maskBytes[$i].ToString("x2"))

        }

        return $sb.ToString();

    }

}

# SIG # Begin signature block

# MIIjhwYJKoZIhvcNAQcCoIIjeDCCI3QCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCqVeKkA9mxosAS

# gw6sBZWxLeP+3Svl4Qo27dqq5dmZhqCCDYEwggX/MIID56ADAgECAhMzAAAB32vw

# LpKnSrTQAAAAAAHfMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjAxMjE1MjEzMTQ1WhcNMjExMjAyMjEzMTQ1WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQC2uxlZEACjqfHkuFyoCwfL25ofI9DZWKt4wEj3JBQ48GPt1UsDv834CcoUUPMn

# s/6CtPoaQ4Thy/kbOOg/zJAnrJeiMQqRe2Lsdb/NSI2gXXX9lad1/yPUDOXo4GNw

# PjXq1JZi+HZV91bUr6ZjzePj1g+bepsqd/HC1XScj0fT3aAxLRykJSzExEBmU9eS

# yuOwUuq+CriudQtWGMdJU650v/KmzfM46Y6lo/MCnnpvz3zEL7PMdUdwqj/nYhGG

# 3UVILxX7tAdMbz7LN+6WOIpT1A41rwaoOVnv+8Ua94HwhjZmu1S73yeV7RZZNxoh

# EegJi9YYssXa7UZUUkCCA+KnAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUOPbML8IdkNGtCfMmVPtvI6VZ8+Mw

# UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1

# ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDYzMDA5MB8GA1UdIwQYMBaAFEhu

# ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w

# Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx

# MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAnnqH

# tDyYUFaVAkvAK0eqq6nhoL95SZQu3RnpZ7tdQ89QR3++7A+4hrr7V4xxmkB5BObS

# 0YK+MALE02atjwWgPdpYQ68WdLGroJZHkbZdgERG+7tETFl3aKF4KpoSaGOskZXp

# TPnCaMo2PXoAMVMGpsQEQswimZq3IQ3nRQfBlJ0PoMMcN/+Pks8ZTL1BoPYsJpok

# t6cql59q6CypZYIwgyJ892HpttybHKg1ZtQLUlSXccRMlugPgEcNZJagPEgPYni4

# b11snjRAgf0dyQ0zI9aLXqTxWUU5pCIFiPT0b2wsxzRqCtyGqpkGM8P9GazO8eao

# mVItCYBcJSByBx/pS0cSYwBBHAZxJODUqxSXoSGDvmTfqUJXntnWkL4okok1FiCD

# Z4jpyXOQunb6egIXvkgQ7jb2uO26Ow0m8RwleDvhOMrnHsupiOPbozKroSa6paFt

# VSh89abUSooR8QdZciemmoFhcWkEwFg4spzvYNP4nIs193261WyTaRMZoceGun7G

# CT2Rl653uUj+F+g94c63AhzSq4khdL4HlFIP2ePv29smfUnHtGq6yYFDLnT0q/Y+

# Di3jwloF8EWkkHRtSuXlFUbTmwr/lDDgbpZiKhLS7CBTDj32I0L5i532+uHczw82

# oZDmYmYmIUSMbZOgS65h797rj5JJ6OkeEUJoAVwwggd6MIIFYqADAgECAgphDpDS

# AAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0

# ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5MDlaFw0yNjA3MDgyMTA5MDla

# MH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMT

# H01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQTTS68rZYIZ9CGypr6VpQqrgG

# OBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULTiQ15ZId+lGAkbK+eSZzpaF7S

# 35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYSL+erCFDPs0S3XdjELgN1q2jz

# y23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494HDdVceaVJKecNvqATd76UPe/7

# 4ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZPrGMXeiJT4Qa8qEvWeSQOy2u

# M1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5bmR/U7qcD60ZI4TL9LoDho33

# X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGSrhwjp6lm7GEfauEoSZ1fiOIl

# XdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADhvKwCgl/bwBWzvRvUVUvnOaEP

# 6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON7E1JMKerjt/sW5+v/N2wZuLB

# l4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xcv3coKPHtbcMojyyPQDdPweGF

# RInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqwiBfenk70lrC8RqBsmNLg1oiM

# CwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFEhuZOVQ

# BdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud

# DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFHItOgIxkEO5FAVO

# 4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwubWljcm9zb2Z0

# LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUFBzAChkJodHRwOi8vd3d3Lm1p

# Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGCNy4DMIGDMD8GCCsGAQUFBwIB

# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2RvY3MvcHJpbWFyeWNw

# cy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AcABvAGwAaQBjAHkA

# XwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAGfyhqWY

# 4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4sPvjDctFtg/6+P+gKyju/R6mj

# 82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKLUtCw/WvjPgcuKZvmPRul1LUd

# d5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7pKkFDJvtaPpoLpWgKj8qa1hJ

# Yx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft0N3zDq+ZKJeYTQ49C/IIidYf

# wzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4MnEnGn+x9Cf43iw6IGmYslmJ

# aG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxvFX1Fp3blQCplo8NdUmKGwx1j

# NpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG0QaxdR8UvmFhtfDcxhsEvt9B

# xw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf0AApxbGbpT9Fdx41xtKiop96

# eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkYS//WsyNodeav+vyL6wuA6mk7

# r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrvQQqxP/uozKRdwaGIm1dxVk5I

# RcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIVXDCCFVgCAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAd9r8C6Sp0q00AAAAAAB3zAN

# BglghkgBZQMEAgEFAKCBsDAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgeU/HXkqB

# wlrSx97KrusIDw+jWX22GV50o0/nyd97QOcwRAYKKwYBBAGCNwIBDDE2MDSgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRyAGmh0dHBzOi8vd3d3Lm1pY3Jvc29mdC5jb20g

# MA0GCSqGSIb3DQEBAQUABIIBAD54rlw4zFUifEiOeWQ/tnmuX7awcEmzgiysJrDO

# 4FVeprMmOTFmbZJc8kO71DlNh/BvItQF1vVwhf8di1W62taCuIe9drz6uQUPKDNO

# GK6CslReD/hf34vy8WjqTvppMLjRR8DApVvmdh97mJ9+EznELr38NsWTEbfASPiX

# AO3kkn+BLXn43OT5wiH53NHgeCt9GGd7gNPsbyKiHMrhSky3o3b0ajOKYwwJc0ll

# bGy2B2nCPtK+BYiwDpWfR1gnvFF7PpemP68KZfR3tB19MiK93mrcPHotRWeMv1Cs

# XRbNzJ3DG6lRPMUcQJIIXxj2sRTe0tSyh7efkEzfPyaTiPChghLkMIIS4AYKKwYB

# BAGCNwMDATGCEtAwghLMBgkqhkiG9w0BBwKgghK9MIISuQIBAzEPMA0GCWCGSAFl

# AwQCAQUAMIIBUAYLKoZIhvcNAQkQAQSgggE/BIIBOzCCATcCAQEGCisGAQQBhFkK

# AwEwMTANBglghkgBZQMEAgEFAAQgo3WyyOUydlRkDMG2DOAzN/ANRNknXezq3N9B

# xm/zD2cCBmDTZDIW2RgSMjAyMTA3MTMwNzM4MDcuOTVaMASAAgH0oIHQpIHNMIHK

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxN

# aWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMSYwJAYDVQQLEx1UaGFsZXMgVFNT

# IEVTTjpERDhDLUUzMzctMkZBRTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3Rh

# bXAgU2VydmljZaCCDjwwggTxMIID2aADAgECAhMzAAABToyx6+3XsuMAAAAAAAFO

# MA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n

# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y

# YXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4X

# DTIwMTExMjE4MjYwMVoXDTIyMDIxMTE4MjYwMVowgcoxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNh

# IE9wZXJhdGlvbnMxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOkREOEMtRTMzNy0y

# RkFFMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIBIjAN

# BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAhvub6PVK/ZO5whOmpVPZNQL/w+Rt

# G0SzkkES35e+v7IicA1b5SbPa7J8Zl6Ktlbv+QQlZwIuvW9J1CKyTV0ET68QW8tZ

# C9llo4AMuDljZYU82FjfEmCwNTqsI7wTZ3K9VXo3hyNNfBtXucPGMKsAYbivyGoS

# AjP7fFKEwSISj7GxtzQiJ3M1ORoB3qxtDMqe7oPfvBLOo6AJdqbvPBnnx4OPETpw

# hgL5m98T6aXYVB86UsD4Yy7zBz54pUADdiI0HJwK8XQUNyOpZThCFsCXaIp9hhvx

# YlTMryvdm1jgsGUo+NqXAVzTbKG9EqPcsUSV3x0rslP3zIH610zqtIaNqQIDAQAB

# o4IBGzCCARcwHQYDVR0OBBYEFKI1URMmQuP2suvn5sJpatqmYBnhMB8GA1UdIwQY

# MBaAFNVjOlyKMZDzQ3t8RhvFM2hahW1VMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6

# Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1RpbVN0YVBD

# QV8yMDEwLTA3LTAxLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljVGltU3RhUENBXzIw

# MTAtMDctMDEuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYIKwYBBQUHAwgw

# DQYJKoZIhvcNAQELBQADggEBAKOJnMitkq+BZReVYE5EXdTznlXmxFgryY4bNSKm

# 1X0iXnzVly+YmC8XNnybHDXu4vOsq2wX7E4Y/Lr0Fe5cdCRBrfzU+p5VJ2MciQdm

# SjdaTwAnCjJhy3l1C+gTK4GhPVZecyUMq+YRn2uhi0Hl3q7f/FsSuOX7rADVxasx

# DgfKYMMnZYcWha/ke2B/HnPvhCZvsiCBerQtZ+WL1suJkDSgZBbpOdhcQyqCEkNN

# rrccy1Zit8ERN0lW2hkNDosReuXMplTlpiyBBZsotJhpCOZLykAaW4JfH6Dija8N

# BfPkOVLOgH6Cdda2yuR1Jt1Lave+UisHAFcwCQnjOmGVuZcwggZxMIIEWaADAgEC

# AgphCYEqAAAAAAACMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEG

# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj

# cm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0

# aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0xMDA3MDEyMTM2NTVaFw0yNTA3MDEy

# MTQ2NTVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD

# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAk

# BgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIIBIjANBgkqhkiG

# 9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqR0NvHcRijog7PwTl/X6f2mUa3RUENWlCgCC

# hfvtfGhLLF/Fw+Vhwna3PmYrW/AVUycEMR9BGxqVHc4JE458YTBZsTBED/FgiIRU

# QwzXTbg4CLNC3ZOs1nMwVyaCo0UN0Or1R4HNvyRgMlhgRvJYR4YyhB50YWeRX4FU

# sc+TTJLBxKZd0WETbijGGvmGgLvfYfxGwScdJGcSchohiq9LZIlQYrFd/XcfPfBX

# day9ikJNQFHRD5wGPmd/9WbAA5ZEfu/QS/1u5ZrKsajyeioKMfDaTgaRtogINeh4

# HLDpmc085y9Euqf03GS9pAHBIAmTeM38vMDJRF1eFpwBBU8iTQIDAQABo4IB5jCC

# AeIwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFNVjOlyKMZDzQ3t8RhvFM2ha

# hW1VMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAPBgNV

# HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fOmhjEMFYG

# A1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3Js

# L3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBaBggrBgEFBQcB

# AQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kv

# Y2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MIGgBgNVHSABAf8EgZUw

# gZIwgY8GCSsGAQQBgjcuAzCBgTA9BggrBgEFBQcCARYxaHR0cDovL3d3dy5taWNy

# b3NvZnQuY29tL1BLSS9kb2NzL0NQUy9kZWZhdWx0Lmh0bTBABggrBgEFBQcCAjA0

# HjIgHQBMAGUAZwBhAGwAXwBQAG8AbABpAGMAeQBfAFMAdABhAHQAZQBtAGUAbgB0

# AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEAB+aIUQ3ixuCYP4FxAz2do6Ehb7Prpsz1

# Mb7PBeKp/vpXbRkws8LFZslq3/Xn8Hi9x6ieJeP5vO1rVFcIK1GCRBL7uVOMzPRg

# Eop2zEBAQZvcXBf/XPleFzWYJFZLdO9CEMivv3/Gf/I3fVo/HPKZeUqRUgCvOA8X

# 9S95gWXZqbVr5MfO9sp6AG9LMEQkIjzP7QOllo9ZKby2/QThcJ8ySif9Va8v/rbl

# jjO7Yl+a21dA6fHOmWaQjP9qYn/dxUoLkSbiOewZSnFjnXshbcOco6I8+n99lmqQ

# eKZt0uGc+R38ONiU9MalCpaGpL2eGq4EQoO4tYCbIjggtSXlZOz39L9+Y1klD3ou

# OVd2onGqBooPiRa6YacRy5rYDkeagMXQzafQ732D8OE7cQnfXXSYIghh2rBQHm+9

# 8eEA3+cxB6STOvdlR3jo+KhIq/fecn5ha293qYHLpwmsObvsxsvYgrRyzR30uIUB

# HoD7G4kqVDmyW9rIDVWZeodzOwjmmC3qjeAzLhIp9cAvVCch98isTtoouLGp25ay

# p0Kiyc8ZQU3ghvkqmqMRZjDTu3QyS99je/WZii8bxyGvWbWu3EQ8l1Bx16HSxVXj

# ad5XwdHeMMD9zOZN+w2/XU/pnR4ZOC+8z1gFLu8NoFA12u8JJxzVs341Hgi62jbb

# 01+P3nSISRKhggLOMIICNwIBATCB+KGB0KSBzTCByjELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2Eg

# T3BlcmF0aW9uczEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046REQ4Qy1FMzM3LTJG

# QUUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoBATAH

# BgUrDgMCGgMVAIPLj8S9P/rDvjTvcVg8eVEvEH4CoIGDMIGApH4wfDELMAkGA1UE

# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc

# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEFBQACBQDkl5dIMCIYDzIw

# MjEwNzEzMTIzODMyWhgPMjAyMTA3MTQxMjM4MzJaMHcwPQYKKwYBBAGEWQoEATEv

# MC0wCgIFAOSXl0gCAQAwCgIBAAICHqgCAf8wBwIBAAICEcwwCgIFAOSY6MgCAQAw

# NgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgC

# AQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQDGvsR1uaG6s3SQ/KSGh4/UXnYNDUGv

# zCFaEseqDLuOJzB1ajQ7OrFGL3uLZCaXHJn2xGMxCYDplYGGQy8XGKbT2S47gmrY

# R3nZ1BbRkDDVuNxGI+1SKYlB76sKcyXPkfVwGoE91uGRiYCSGPFNx5+Go1Cs7/YJ

# mC9BSK0KuNFvPTGCAw0wggMJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBD

# QSAyMDEwAhMzAAABToyx6+3XsuMAAAAAAAFOMA0GCWCGSAFlAwQCAQUAoIIBSjAa

# BgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIDNsxUc3

# ki+wbUV+ahZeW43u+06lXaoIg5a3ptJnKq0FMIH6BgsqhkiG9w0BCRACLzGB6jCB

# 5zCB5DCBvQQgCP4N4phLi4HnMP66HUIKRN3vMjEriAKO/up948olL5IwgZgwgYCk

# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD

# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAU6Msevt17LjAAAA

# AAABTjAiBCBiZsQWO12Uzy225EhZkmvC+Xh8927HMtqSEeHaAyRX5TANBgkqhkiG

# 9w0BAQsFAASCAQAyRAI5vYTyphTBdVSM1dYEB2FeX06rh0kpJBPhC2kqcaLbK0Xo

# H/0L0aCs1GF4jzk9mRjXAyKc8FvspjNCsbTKAmX5yPTRkqfgaUlBLvSQpuXAs7vb

# 8phYkuLJ6wyZS/pdos6s3V30mdcLf2JxxXsGZZSoQZ0p1hVex3/FsFhJD/MWmxja

# 9rif87isbBwRjpc9v23VNEEn7Lt7XXuIww7ZWvfj1K8xB1rPbIWMPNtchwwYj6/z

# P+nVyy5Br61ZHxRk0m2HgrsaRcd44p39y2IF7SYiWLQu0OBpU9dDZqMzocrlDQDv

# wumrFkcCQ3juXBDyy2zthnenGpV/BaBsiXPt

# SIG # End signature block