AzSKStaging.ADO

1.9.2

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

# MIIjkwYJKoZIhvcNAQcCoIIjhDCCI4ACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# 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/BvW1taslScxMNelDNMYIVaDCCFWQCAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAd9r8C6Sp0q00AAAAAAB3zAN

# BglghkgBZQMEAgEFAKCBsDAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgeU/HXkqB

# wlrSx97KrusIDw+jWX22GV50o0/nyd97QOcwRAYKKwYBBAGCNwIBDDE2MDSgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRyAGmh0dHBzOi8vd3d3Lm1pY3Jvc29mdC5jb20g

# MA0GCSqGSIb3DQEBAQUABIIBAD54rlw4zFUifEiOeWQ/tnmuX7awcEmzgiysJrDO

# 4FVeprMmOTFmbZJc8kO71DlNh/BvItQF1vVwhf8di1W62taCuIe9drz6uQUPKDNO

# GK6CslReD/hf34vy8WjqTvppMLjRR8DApVvmdh97mJ9+EznELr38NsWTEbfASPiX

# AO3kkn+BLXn43OT5wiH53NHgeCt9GGd7gNPsbyKiHMrhSky3o3b0ajOKYwwJc0ll

# bGy2B2nCPtK+BYiwDpWfR1gnvFF7PpemP68KZfR3tB19MiK93mrcPHotRWeMv1Cs

# XRbNzJ3DG6lRPMUcQJIIXxj2sRTe0tSyh7efkEzfPyaTiPChghLwMIIS7AYKKwYB

# BAGCNwMDATGCEtwwghLYBgkqhkiG9w0BBwKgghLJMIISxQIBAzEPMA0GCWCGSAFl

# AwQCAQUAMIIBVAYLKoZIhvcNAQkQAQSgggFDBIIBPzCCATsCAQEGCisGAQQBhFkK

# AwEwMTANBglghkgBZQMEAgEFAAQgo3WyyOUydlRkDMG2DOAzN/ANRNknXezq3N9B

# xm/zD2cCBmDTj7b60BgSMjAyMTA3MDcxMzA0MTQuMjJaMASAAgH0oIHUpIHRMIHO

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBN

# aWNyb3NvZnQgT3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVz

# IFRTUyBFU046RDlERS1FMzlBLTQzRkUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2Wggg5EMIIE9TCCA92gAwIBAgITMwAAAWH1ojNeoCokaQAA

# AAABYTANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MDAeFw0yMTAxMTQxOTAyMjFaFw0yMjA0MTExOTAyMjFaMIHOMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBNaWNyb3NvZnQgT3Bl

# cmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046RDlE

# RS1FMzlBLTQzRkUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp

# Y2UwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCXiJ2oQa1P/xs06ocV

# MgAvFF3LelCQpG9sRGSld4I4IJiwIXga8SZO7R/j8NrU3Mmqy0X5ldsaOaAZOaVv

# znA3P5/03E3kFOiSDeT5U3J9AvUZSkOrfTrlP1gMgMRk4yhOBDZ1I17cYjZQ/ytm

# RjC746UTgSoe07ZFCSumRlsP7k0WmzQcUYNd0745Bh1xFBAyfIpmnMPQQnkfS+rp

# 3a99rY+HbjhSBw/JtXrN0jTffGauCAwT9wnG/h0IMaW3hyFJStMus5syJL3ze92c

# cHxrxb9PzGse/ViWNHA/KaAp2RYo3Ilq39Hg9U9v/ux4HsM63cT3UhaHJFEPEKLy

# AyGJAgMBAAGjggEbMIIBFzAdBgNVHQ4EFgQUVh6andYb+9UlY+SwHT3zROz4Sy8w

# HwYDVR0jBBgwFoAU1WM6XIoxkPNDe3xGG8UzaFqFbVUwVgYDVR0fBE8wTTBLoEmg

# R4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWlj

# VGltU3RhUENBXzIwMTAtMDctMDEuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEF

# BQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNUaW1T

# dGFQQ0FfMjAxMC0wNy0wMS5jcnQwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggr

# BgEFBQcDCDANBgkqhkiG9w0BAQsFAAOCAQEAEEwPW6lQZseU0zIc4/kPM1pD0F4A

# nEkIqstmGFhdIVq+RhIjdi7QPhFnbtcvKMrGWruAj+0szPFU0qt9QiyYjst/WeEb

# xKtpq9BH7Rb5l9gsUO2cs65IVjGWmUC5GGx+aGmyBcJ3Vt+J4ffNATmN/ebX5zUv

# 2OjdH/o13aBZ+3yNnON0xWLFKiD1ozhyZaDHpLZQ+v7kumZ+MbHv5SLRZvn1jnAd

# gMclxAd2URHkoPY+/hqBJdcU/4iblf0qO05VncMmnELuJb9zAbL8c0SGyoWcKw2K

# IJqMifq8IEAfJikuPzNUg0bSKbWpqExSeek5Og7lF8dSbnU6HpYIxGT2uTCCBnEw

# ggRZoAMCAQICCmEJgSoAAAAAAAIwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTEwMDcwMTIxMzY1NVoX

# DTI1MDcwMTIxNDY1NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0

# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh

# dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggEi

# MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCpHQ28dxGKOiDs/BOX9fp/aZRr

# dFQQ1aUKAIKF++18aEssX8XD5WHCdrc+Zitb8BVTJwQxH0EbGpUdzgkTjnxhMFmx

# MEQP8WCIhFRDDNdNuDgIs0Ldk6zWczBXJoKjRQ3Q6vVHgc2/JGAyWGBG8lhHhjKE

# HnRhZ5FfgVSxz5NMksHEpl3RYRNuKMYa+YaAu99h/EbBJx0kZxJyGiGKr0tkiVBi

# sV39dx898Fd1rL2KQk1AUdEPnAY+Z3/1ZsADlkR+79BL/W7lmsqxqPJ6Kgox8NpO

# BpG2iAg16HgcsOmZzTznL0S6p/TcZL2kAcEgCZN4zfy8wMlEXV4WnAEFTyJNAgMB

# AAGjggHmMIIB4jAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQU1WM6XIoxkPND

# e3xGG8UzaFqFbVUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQD

# AgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb

# 186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29t

# L3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoG

# CCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwgaAGA1Ud

# IAEB/wSBlTCBkjCBjwYJKwYBBAGCNy4DMIGBMD0GCCsGAQUFBwIBFjFodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vUEtJL2RvY3MvQ1BTL2RlZmF1bHQuaHRtMEAGCCsG

# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAFAAbwBsAGkAYwB5AF8AUwB0AGEAdABl

# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQAH5ohRDeLG4Jg/gXEDPZ2j

# oSFvs+umzPUxvs8F4qn++ldtGTCzwsVmyWrf9efweL3HqJ4l4/m87WtUVwgrUYJE

# Evu5U4zM9GASinbMQEBBm9xcF/9c+V4XNZgkVkt070IQyK+/f8Z/8jd9Wj8c8pl5

# SpFSAK84Dxf1L3mBZdmptWvkx872ynoAb0swRCQiPM/tA6WWj1kpvLb9BOFwnzJK

# J/1Vry/+tuWOM7tiX5rbV0Dp8c6ZZpCM/2pif93FSguRJuI57BlKcWOdeyFtw5yj

# ojz6f32WapB4pm3S4Zz5Hfw42JT0xqUKloakvZ4argRCg7i1gJsiOCC1JeVk7Pf0

# v35jWSUPei45V3aicaoGig+JFrphpxHLmtgOR5qAxdDNp9DvfYPw4TtxCd9ddJgi

# CGHasFAeb73x4QDf5zEHpJM692VHeOj4qEir995yfmFrb3epgcunCaw5u+zGy9iC

# tHLNHfS4hQEegPsbiSpUObJb2sgNVZl6h3M7COaYLeqN4DMuEin1wC9UJyH3yKxO

# 2ii4sanblrKnQqLJzxlBTeCG+SqaoxFmMNO7dDJL32N79ZmKLxvHIa9Zta7cRDyX

# UHHXodLFVeNp3lfB0d4wwP3M5k37Db9dT+mdHhk4L7zPWAUu7w2gUDXa7wknHNWz

# fjUeCLraNtvTX4/edIhJEqGCAtIwggI7AgEBMIH8oYHUpIHRMIHOMQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBNaWNyb3NvZnQg

# T3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046

# RDlERS1FMzlBLTQzRkUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNl

# cnZpY2WiIwoBATAHBgUrDgMCGgMVABVuUoQMOXpExF7y/+FdbNK2w895oIGDMIGA

# pH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEFBQAC

# BQDkj9oRMCIYDzIwMjEwNzA3MTE0NTIxWhgPMjAyMTA3MDgxMTQ1MjFaMHcwPQYK

# KwYBBAGEWQoEATEvMC0wCgIFAOSP2hECAQAwCgIBAAICFOkCAf8wBwIBAAICEQ4w

# CgIFAOSRK5ECAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgC

# AQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQCHomvqiKpbOE5l

# kjM62RyPlbM6jo9cSgZq18lBerJ2wOInYypaXaL0fe/+EMPkYJ57uGXTGRiIWDTz

# B1xQDq0/71sHWXAF/RlMtJdIPyWGYnUztfl7X4HaWK40iGWjm4bJckZUecN6zLF6

# qfmjp168mYmflNNKtrbiqGkcqP8slTGCAw0wggMJAgEBMIGTMHwxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABYfWiM16gKiRpAAAAAAFhMA0GCWCGSAFl

# AwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcN

# AQkEMSIEIFHJay0q6wzpD3uk0/5QIbJ22XFCqHOugmJ5PRvyQDdtMIH6BgsqhkiG

# 9w0BCRACLzGB6jCB5zCB5DCBvQQgYc+Lp+ppEi3f8wPtDeWCwxqeL1v1QbTVv5aZ

# obQJOG8wgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA

# AWH1ojNeoCokaQAAAAABYTAiBCAM2pY5G6t86oMUvQ3V7xt7AZ2FHYd+kfPUaM6k

# LRXcZDANBgkqhkiG9w0BAQsFAASCAQB3BZCHOBd8Jmtp6J+e7U4IZvj0L7JmeBWm

# nGcfMv4j9/2XkQlO/tRl0uQ3GKsEq1U6R4tgJPI/5L1vVrlwE6BGSusMtO1wtI8z

# 0Mxj9Z+NNfM+5h6XXuaobK7mb2iNMKA41K9vMnI+pDhWnJqHSCFt4DNAFnVWgI0o

# zxLoY1Z7UP3+ubKSXJXaqSxlD/SBqUo4dxh0PIT9aZbxU92jkmE9ohCXhm6c0eQb

# PRTT8PqNCmMg5FIbH3nkN6rb3MhVEzAriL7zSzMGmGZtTA92pvjcBQg3dP0yy25R

# oeLY/ZlwF0XvExj5BnvLm++hwUQ1wDYCk4lWPh/45Ok9VmcPdj1o

# SIG # End signature block