AzSDK

2.5.2

Framework/Listeners/RemoteReports/UsageTelemetry.ps1

                                Set-StrictMode -Version Latest

class UsageTelemetry: ListenerBase {

    [Microsoft.ApplicationInsights.TelemetryClient] $TelemetryClient;

    hidden UsageTelemetry() {

        $this.TelemetryClient = [Microsoft.ApplicationInsights.TelemetryClient]::new()

        $this.TelemetryClient.InstrumentationKey = [Constants]::UsageTelemetryKey

    }

    hidden static [UsageTelemetry] $Instance = $null;

    static [UsageTelemetry] GetInstance() {

        if ( $null  -eq [UsageTelemetry]::Instance -or  $null  -eq [UsageTelemetry]::Instance.TelemetryClient) {

            [UsageTelemetry]::Instance = [UsageTelemetry]::new();

        }

        return [UsageTelemetry]::Instance

    }

    [void] RegisterEvents() {

        $this.UnregisterEvents();

        $this.RegisterEvent([AzSdkRootEvent]::GenerateRunIdentifier, {

            $currentInstance = [UsageTelemetry]::GetInstance();

            try

            {

                $runIdentifier = [AzSdkRootEventArgument] ($Event.SourceArgs | Select-Object -First 1)

                $currentInstance.SetRunIdentifier($runIdentifier);

            }

            catch

            {

                $currentInstance.PublishException($_);

            }

        });

        $this.RegisterEvent([SVTEvent]::EvaluationCompleted, {

            $azsdkSettings = [ConfigurationManager]::GetAzSdkSettings();

            if($azsdkSettings.UsageTelemetryLevel -ne "Anonymous") { return; }

            $currentInstance = [UsageTelemetry]::GetInstance();

            try

            {

                $invocationContext = [System.Management.Automation.InvocationInfo] $currentInstance.InvocationContext

                $featureGroup = [RemoteReportHelper]::GetFeatureGroup($invocationContext.MyCommand.Name)

                $SVTEventContexts = [SVTEventContext[]] $Event.SourceArgs

                if($featureGroup -eq [FeatureGroup]::Subscription){

                    [UsageTelemetry]::PushSubscriptionScanResults($currentInstance, $SVTEventContexts)

                }elseif($featureGroup -eq [FeatureGroup]::Service){

                    [UsageTelemetry]::PushServiceScanResults($currentInstance, $SVTEventContexts)

                }else{

                }

            }

            catch

            {

                $currentInstance.PublishException($_);

            }

            $currentInstance.TelemetryClient.Flush()

        });

        $this.RegisterEvent([AzSdkGenericEvent]::Exception, {

            $currentInstance = [UsageTelemetry]::GetInstance();

            try

            {

                [System.Management.Automation.ErrorRecord] $er = ($Event.SourceArgs | Select-Object -First 1)

                [UsageTelemetry]::PushException($currentInstance, @{}, @{}, $er);

            }

            catch

            {

            }

        });

        $this.RegisterEvent([AzSdkRootEvent]::CommandError, {

            $currentInstance = [UsageTelemetry]::GetInstance();

            try

            {

                [System.Management.Automation.ErrorRecord] $er = $Event.SourceArgs.ExceptionMessage

                [UsageTelemetry]::PushException($currentInstance, @{}, @{}, $er);

            }

            catch

            {

            }

        });

        $this.RegisterEvent([SVTEvent]::CommandError, {

            $currentInstance = [UsageTelemetry]::GetInstance();

            try

            {

                [System.Management.Automation.ErrorRecord] $er = $Event.SourceArgs.ExceptionMessage

                [UsageTelemetry]::PushException($currentInstance, @{}, @{}, $er);

            }

            catch

            {

            }

        });

        $this.RegisterEvent([SVTEvent]::EvaluationError, {

            $currentInstance = [UsageTelemetry]::GetInstance();

            try

            {

                [System.Management.Automation.ErrorRecord] $er = $Event.SourceArgs.ExceptionMessage

                [UsageTelemetry]::PushException($currentInstance, @{}, @{}, $er);

            }

            catch

            {

            }

        });

        $this.RegisterEvent([SVTEvent]::ControlError, {

            $currentInstance = [UsageTelemetry]::GetInstance();

            try

            {

                [System.Management.Automation.ErrorRecord] $er = $Event.SourceArgs.ExceptionMessage

                [UsageTelemetry]::PushException($currentInstance, @{}, @{}, $er);

            }

            catch

            {

            }

        });

    }

    static [void] PushSubscriptionScanResults(

        [UsageTelemetry] $Publisher, `

        [SVTEventContext[]] $SVTEventContexts)

    {

        $eventData = @{

            [TelemetryKeys]::FeatureGroup = [FeatureGroup]::Subscription;

            "ScanKind" = [RemoteReportHelper]::GetSubscriptionScanKind(

                $Publisher.InvocationContext.MyCommand.Name,

                $Publisher.InvocationContext.BoundParameters);

        }

        $SVTEventContexts | ForEach-Object {

            $context = $_

            [hashtable] $eventDataClone = $eventData.Clone();

            $eventDataClone.Add("ControlIntId", $context.ControlItem.Id);

            $eventDataClone.Add("ControlId", $context.ControlItem.ControlID);

            $eventDataClone.Add("ControlSeverity", $context.ControlItem.ControlSeverity);

            if ($context.ControlItem.Enabled) {

                $eventDataClone.Add("ActualVerificationResult", $context.ControlResults[0].ActualVerificationResult)

                $eventDataClone.Add("AttestationStatus", $context.ControlResults[0].AttestationStatus)

                $eventDataClone.Add("VerificationResult", $context.ControlResults[0].VerificationResult)

            }

            else {

                $eventDataClone.Add("ActualVerificationResult", [VerificationResult]::Disabled)

                $eventDataClone.Add("AttestationStatus", [AttestationStatus]::None)

                $eventDataClone.Add("VerificationResult", [VerificationResult]::Disabled)

            }

            [UsageTelemetry]::PushEvent($Publisher, $eventDataClone, @{})

        }

    }

    static [void] PushServiceScanResults(

        [UsageTelemetry] $Publisher, `

        [SVTEventContext[]] $SVTEventContexts)

    {

        $NA = "NA"

        $SVTEventContextFirst = $SVTEventContexts[0]

        $eventData = @{

            [TelemetryKeys]::FeatureGroup = [FeatureGroup]::Service;

            "ScanKind" = [RemoteReportHelper]::GetServiceScanKind(

                $Publisher.InvocationContext.MyCommand.Name,

                $Publisher.InvocationContext.BoundParameters);

            "Feature" = $SVTEventContextFirst.FeatureName;

            "ResourceGroup" = [RemoteReportHelper]::Mask($SVTEventContextFirst.ResourceContext.ResourceGroupName);

            "ResourceName" = [RemoteReportHelper]::Mask($SVTEventContextFirst.ResourceContext.ResourceName);

            "ResourceId" = [RemoteReportHelper]::Mask($SVTEventContextFirst.ResourceContext.ResourceId);

        }

        $SVTEventContexts | ForEach-Object {

            $SVTEventContext = $_

            [hashtable] $eventDataClone = $eventData.Clone()

            $eventDataClone.Add("ControlIntId", $SVTEventContext.ControlItem.Id);

            $eventDataClone.Add("ControlId", $SVTEventContext.ControlItem.ControlID);

            $eventDataClone.Add("ControlSeverity", $SVTEventContext.ControlItem.ControlSeverity);

            if (!$SVTEventContext.ControlItem.Enabled) {

                $eventDataClone.Add("ActualVerificationResult", [VerificationResult]::Disabled)

                $eventDataClone.Add("AttestationStatus", [AttestationStatus]::None)

                $eventDataClone.Add("VerificationResult", [VerificationResult]::Disabled)

                [UsageTelemetry]::PushEvent($Publisher, $eventDataClone, @{})

            }

            elseif ($SVTEventContext.ControlResults.Count -eq 1 -and `

                ($SVTEventContextFirst.ResourceContext.ResourceName -eq $SVTEventContext.ControlResults[0].ChildResourceName -or `

                    [string]::IsNullOrWhiteSpace($SVTEventContext.ControlResults[0].ChildResourceName)))

            {

                $eventDataClone.Add("ActualVerificationResult", $SVTEventContext.ControlResults[0].ActualVerificationResult)

                $eventDataClone.Add("AttestationStatus", $SVTEventContext.ControlResults[0].AttestationStatus)

                $eventDataClone.Add("VerificationResult", $SVTEventContext.ControlResults[0].VerificationResult)

                $eventDataClone.Add("IsNestedResource", 'No')

                $eventDataClone.Add("NestedResourceName", $NA)

                [UsageTelemetry]::PushEvent($Publisher, $eventDataClone, @{})

            }

            elseif ($SVTEventContext.ControlResults.Count -eq 1 -and `

                $SVTEventContextFirst.ResourceContext.ResourceName -ne $SVTEventContext.ControlResults[0].ChildResourceName)

            {

                $eventDataClone.Add("ActualVerificationResult", $SVTEventContext.ControlResults[0].ActualVerificationResult)

                $eventDataClone.Add("AttestationStatus", $SVTEventContext.ControlResults[0].AttestationStatus)

                $eventDataClone.Add("VerificationResult", $SVTEventContext.ControlResults[0].VerificationResult)

                $eventDataClone.Add("IsNestedResource", 'Yes')

                $eventDataClone.Add("NestedResourceName", [RemoteReportHelper]::Mask($SVTEventContext.ControlResults[0].ChildResourceName))

                [UsageTelemetry]::PushEvent($Publisher, $eventDataClone, @{})

            }

            elseif ($SVTEventContext.ControlResults.Count -gt 1)

            {

                $eventDataClone.Add("IsNestedResource", 'Yes')

                $SVTEventContext.ControlResults | Foreach-Object {

                    [hashtable] $eventDataCloneL2 = $eventDataClone.Clone()

                    $eventDataCloneL2.Add("ActualVerificationResult", $_.ActualVerificationResult)

                    $eventDataCloneL2.Add("AttestationStatus", $_.AttestationStatus)

                    $eventDataCloneL2.Add("VerificationResult", $_.VerificationResult)

                    $eventDataCloneL2.Add("NestedResourceName", [RemoteReportHelper]::Mask($_.ChildResourceName))

                    [UsageTelemetry]::PushEvent($Publisher, $eventDataCloneL2, @{})

                }

            }

        }

    }

    static [void] PushEvent([UsageTelemetry] $Publisher, `

                            [hashtable] $Properties, [hashtable] $Metrics)

    {

        try{

            [UsageTelemetry]::SetCommonProperties($Publisher, $Properties);

            $event = [Microsoft.ApplicationInsights.DataContracts.EventTelemetry]::new()

            $event.Name = "Control Scanned"

            $Properties.Keys | ForEach-Object {

                try{

                    $event.Properties.Add($_, $Properties[$_].ToString());

                }

                catch{

                }

            }

            $Metrics.Keys | ForEach-Object {

                try{

                    $event.Metrics.Add($_, $Metrics[$_]);

                }

                catch{

                }

            }

            $Publisher.TelemetryClient.TrackEvent($event);

        }

        catch{

        }

    }

    static [void] PushException([UsageTelemetry] $Publisher, `

                            [hashtable] $Properties, [hashtable] $Metrics, `

                            [System.Management.Automation.ErrorRecord] $ErrorRecord)

    {

        try{

            [UsageTelemetry]::SetCommonProperties($Publisher, $Properties);

            $ex = [Microsoft.ApplicationInsights.DataContracts.ExceptionTelemetry]::new()

            $ex.Exception = $ErrorRecord.Exception

            try{

                $ex.Properties.Add("ScriptStackTrace", [UsageTelemetry]::AnonScriptStackTrace($ErrorRecord.ScriptStackTrace))

            }catch{}

            $Properties.Keys | ForEach-Object {

                try{

                    $ex.Properties.Add($_, $Properties[$_].ToString());

                }

                catch{

                }

            }

            $Metrics.Keys | ForEach-Object {

                try{

                    $ex.Metrics.Add($_, $Metrics[$_]);

                }

                catch{

                }

            }

            $Publisher.TelemetryClient.TrackException($ex)

            $Publisher.TelemetryClient.Flush()

        }

        catch{

        }

    }

    hidden static [void] SetCommonProperties([UsageTelemetry] $Publisher, [hashtable] $Properties)

    {

        try{

            $NA = "NA";

            $Properties.Add("InfoVersion", "V1");

            try{

                $Properties.Add("ScanSource", [RemoteReportHelper]::GetScanSource());

            }catch{}

            try{

                $Properties.Add("ScannerVersion", $Publisher.GetCurrentModuleVersion());

            }catch{}

            try{

                $Properties.Add("ControlVersion", $Publisher.GetCurrentModuleVersion());

            }catch{}

            try{

                $azureContext = Get-AzureRmContext

                try{

                    $Properties.Add([TelemetryKeys]::SubscriptionId, [RemoteReportHelper]::Mask($azureContext.Subscription.Id))

                }catch{}

                try{

                    $Properties.Add([TelemetryKeys]::SubscriptionName, [RemoteReportHelper]::Mask($azureContext.Subscription.Name))

                }catch{}

                try{

                    $Properties.Add("AzureEnv", $azureContext.Environment.Name)

                }catch{}

                try{

                    $Properties.Add("TenantId", [RemoteReportHelper]::Mask($azureContext.Tenant.Id))

                }catch{}

                try{

                    $Properties.Add("AccountId", [RemoteReportHelper]::Mask($azureContext.Account.Id))

                }catch{}

                try{

                    $Properties.Add("RunIdentifier",  [RemoteReportHelper]::Mask($azureContext.Account.Id + '##' + $Publisher.RunIdentifier));

                }catch{

                    $Properties.Add("RunIdentifier",  $Publisher.RunIdentifier);

                }

                try{

                    $Properties.Add("AccountType", $azureContext.Account.Type)

                }catch{}

            }catch{

            }

        }

        catch{

        }

    }

    hidden static [string] AnonScriptStackTrace([string] $ScriptStackTrace)

    {

        try{

            $ScriptStackTrace = $ScriptStackTrace.Replace($env:USERNAME, "USERNAME")

            $lines = $ScriptStackTrace.Split([System.Environment]::NewLine, [System.StringSplitOptions]::RemoveEmptyEntries)

            $newLines = $lines | ForEach-Object {

                $line = $_

                $lineSplit = $line.Split(@(", "), [System.StringSplitOptions]::RemoveEmptyEntries);

                if($lineSplit.Count -eq 2){

                    $filePath = $lineSplit[1];

                    $startMarker = $filePath.IndexOf("AzSDK")

                    if($startMarker -gt 0){

                        $anonFilePath = $filePath.Substring($startMarker, $filePath.Length - $startMarker)

                        $newLine = $lineSplit[0] + ", " + $anonFilePath

                        $newLine

                    }

                    else{

                        $line

                    }

                }

                else{

                    $line

                }

            }

            return ($newLines | Out-String)

        }

        catch{

            return $ScriptStackTrace

        }

    }

}

# SIG # Begin signature block

# MIIj/wYJKoZIhvcNAQcCoIIj8DCCI+wCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAQP51KXGY3ktvT

# plb/nRy0VCBOaX5Rzd12lWe/FlTqIaCCDZMwggYRMIID+aADAgECAhMzAAAAjoeR

# pFcaX8o+AAAAAACOMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMTYxMTE3MjIwOTIxWhcNMTgwMjE3MjIwOTIxWjCBgzEL

# MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v

# bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjENMAsGA1UECxMETU9Q

# UjEeMBwGA1UEAxMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMIIBIjANBgkqhkiG9w0B

# AQEFAAOCAQ8AMIIBCgKCAQEA0IfUQit+ndnGetSiw+MVktJTnZUXyVI2+lS/qxCv

# 6cnnzCZTw8Jzv23WAOUA3OlqZzQw9hYXtAGllXyLuaQs5os7efYjDHmP81LfQAEc

# wsYDnetZz3Pp2HE5m/DOJVkt0slbCu9+1jIOXXQSBOyeBFOmawJn+E1Zi3fgKyHg

# 78CkRRLPA3sDxjnD1CLcVVx3Qv+csuVVZ2i6LXZqf2ZTR9VHCsw43o17lxl9gtAm

# +KWO5aHwXmQQ5PnrJ8by4AjQDfJnwNjyL/uJ2hX5rg8+AJcH0Qs+cNR3q3J4QZgH

# uBfMorFf7L3zUGej15Tw0otVj1OmlZPmsmbPyTdo5GPHzwIDAQABo4IBgDCCAXww

# HwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0OBBYEFKvI1u2y

# FdKqjvHM7Ww490VK0Iq7MFIGA1UdEQRLMEmkRzBFMQ0wCwYDVQQLEwRNT1BSMTQw

# MgYDVQQFEysyMzAwMTIrYjA1MGM2ZTctNzY0MS00NDFmLWJjNGEtNDM0ODFlNDE1

# ZDA4MB8GA1UdIwQYMBaAFEhuZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEsw

# SaBHoEWGQ2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0Nv

# ZFNpZ1BDQTIwMTFfMjAxMS0wNy0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsG

# AQUFBzAChkVodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01p

# Y0NvZFNpZ1BDQTIwMTFfMjAxMS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkq

# hkiG9w0BAQsFAAOCAgEARIkCrGlT88S2u9SMYFPnymyoSWlmvqWaQZk62J3SVwJR

# avq/m5bbpiZ9CVbo3O0ldXqlR1KoHksWU/PuD5rDBJUpwYKEpFYx/KCKkZW1v1rO

# qQEfZEah5srx13R7v5IIUV58MwJeUTub5dguXwJMCZwaQ9px7eTZ56LadCwXreUM

# tRj1VAnUvhxzzSB7pPrI29jbOq76kMWjvZVlrkYtVylY1pLwbNpj8Y8zon44dl7d

# 8zXtrJo7YoHQThl8SHywC484zC281TllqZXBA+KSybmr0lcKqtxSCy5WJ6PimJdX

# jrypWW4kko6C4glzgtk1g8yff9EEjoi44pqDWLDUmuYx+pRHjn2m4k5589jTajMW

# UHDxQruYCen/zJVVWwi/klKoCMTx6PH/QNf5mjad/bqQhdJVPlCtRh/vJQy4njpI

# BGPveJiiXQMNAtjcIKvmVrXe7xZmw9dVgh5PgnjJnlQaEGC3F6tAE5GusBnBmjOd

# 7jJyzWXMT0aYLQ9RYB58+/7b6Ad5B/ehMzj+CZrbj3u2Or2FhrjMvH0BMLd7Hald

# G73MTRf3bkcz1UDfasouUbi1uc/DBNM75ePpEIzrp7repC4zaikvFErqHsEiODUF

# he/CBAANa8HYlhRIFa9+UrC4YMRStUqCt4UqAEkqJoMnWkHevdVmSbwLnHhwCbww

# ggd6MIIFYqADAgECAgphDpDSAAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3Nv

# ZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5

# MDlaFw0yNjA3MDgyMTA5MDlaMH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIw

# MTEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQ

# TTS68rZYIZ9CGypr6VpQqrgGOBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULT

# iQ15ZId+lGAkbK+eSZzpaF7S35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYS

# L+erCFDPs0S3XdjELgN1q2jzy23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494H

# DdVceaVJKecNvqATd76UPe/74ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZ

# PrGMXeiJT4Qa8qEvWeSQOy2uM1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5

# bmR/U7qcD60ZI4TL9LoDho33X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGS

# rhwjp6lm7GEfauEoSZ1fiOIlXdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADh

# vKwCgl/bwBWzvRvUVUvnOaEP6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON

# 7E1JMKerjt/sW5+v/N2wZuLBl4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xc

# v3coKPHtbcMojyyPQDdPweGFRInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqw

# iBfenk70lrC8RqBsmNLg1oiMCwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMC

# AQAwHQYDVR0OBBYEFEhuZOVQBdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQM

# HgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1Ud

# IwQYMBaAFHItOgIxkEO5FAVO4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0

# dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0Nl

# ckF1dDIwMTFfMjAxMV8wM18yMi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUF

# BzAChkJodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0Nl

# ckF1dDIwMTFfMjAxMV8wM18yMi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGC

# Ny4DMIGDMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtp

# b3BzL2RvY3MvcHJpbWFyeWNwcy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcA

# YQBsAF8AcABvAGwAaQBjAHkAXwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZI

# hvcNAQELBQADggIBAGfyhqWY4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4s

# PvjDctFtg/6+P+gKyju/R6mj82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKL

# UtCw/WvjPgcuKZvmPRul1LUdd5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7

# pKkFDJvtaPpoLpWgKj8qa1hJYx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft

# 0N3zDq+ZKJeYTQ49C/IIidYfwzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4

# MnEnGn+x9Cf43iw6IGmYslmJaG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxv

# FX1Fp3blQCplo8NdUmKGwx1jNpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG

# 0QaxdR8UvmFhtfDcxhsEvt9Bxw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf

# 0AApxbGbpT9Fdx41xtKiop96eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkY

# S//WsyNodeav+vyL6wuA6mk7r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrv

# QQqxP/uozKRdwaGIm1dxVk5IRcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIV

# wjCCFb4CAQEwgZUwfjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAA

# AI6HkaRXGl/KPgAAAAAAjjANBglghkgBZQMEAgEFAKCBsDAZBgkqhkiG9w0BCQMx

# DAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkq

# hkiG9w0BCQQxIgQgIuV/u6zR5sni70KOhTD2e2QJGSuiYUT5F0IcBAL8EqAwRAYK

# KwYBBAGCNwIBDDE2MDSgEoAQAEEAegBTAEQASwAyADUAMqEegBxodHRwczovL2Fr

# YS5tcy9henNka29zc2RvY3MgMA0GCSqGSIb3DQEBAQUABIIBAL1igy/v3dn1ZlA/

# UuXQ2ms8wfRfb3zooaVWBRwxzkbcm4un2iGMWXrOynyYIFJigXJQfoAPNNPgZewA

# mKwnzabOLRmrTRMRIdgDeCemXfqXd6IV5f3+TzM7nS14Pln0mhgcFVPvOqGPn/AJ

# tezQy6eG4KAxqg8GD52/w3g+mq+9ko5AeV1Fq1EvUyudSbYCfM1WhJ2yOINX0yDZ

# /vMFzHGNz8LEdDlDWYx9kWveG4Xa4SBLTxXVfHLRAudKa4ze2isInTmcSJ98eVAt

# ey4q6C7zLSsZw5X8XsRKhriZe+zYsYobZbP3AESdwIKA5rgya73jzmRMJW7dfcZd

# tzpCxcihghNKMIITRgYKKwYBBAGCNwMDATGCEzYwghMyBgkqhkiG9w0BBwKgghMj

# MIITHwIBAzEPMA0GCWCGSAFlAwQCAQUAMIIBOgYLKoZIhvcNAQkQAQSgggEpBIIB

# JTCCASECAQEGCisGAQQBhFkKAwEwMTANBglghkgBZQMEAgEFAAQgyKbZgc5phRC0

# g8pXrbW6ZQQGM/7Dg/tjjL1sjbnHFzYCBlmSITMX0hgTMjAxNzA5MDUwOTM3MjQu

# MTUzWjAEgAIB9KCBuaSBtjCBszELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjENMAsGA1UECxMETU9QUjEnMCUGA1UECxMebkNpcGhlciBEU0UgRVNO

# OjE0OEMtQzRCOS0yMDY2MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT

# ZXJ2aWNloIIO0DCCBnEwggRZoAMCAQICCmEJgSoAAAAAAAIwDQYJKoZIhvcNAQEL

# BQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNV

# BAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4X

# DTEwMDcwMTIxMzY1NVoXDTI1MDcwMTIxNDY1NVowfDELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh

# bXAgUENBIDIwMTAwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCpHQ28

# dxGKOiDs/BOX9fp/aZRrdFQQ1aUKAIKF++18aEssX8XD5WHCdrc+Zitb8BVTJwQx

# H0EbGpUdzgkTjnxhMFmxMEQP8WCIhFRDDNdNuDgIs0Ldk6zWczBXJoKjRQ3Q6vVH

# gc2/JGAyWGBG8lhHhjKEHnRhZ5FfgVSxz5NMksHEpl3RYRNuKMYa+YaAu99h/EbB

# Jx0kZxJyGiGKr0tkiVBisV39dx898Fd1rL2KQk1AUdEPnAY+Z3/1ZsADlkR+79BL

# /W7lmsqxqPJ6Kgox8NpOBpG2iAg16HgcsOmZzTznL0S6p/TcZL2kAcEgCZN4zfy8

# wMlEXV4WnAEFTyJNAgMBAAGjggHmMIIB4jAQBgkrBgEEAYI3FQEEAwIBADAdBgNV

# HQ4EFgQU1WM6XIoxkPNDe3xGG8UzaFqFbVUwGQYJKwYBBAGCNxQCBAweCgBTAHUA

# YgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU

# 1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2Ny

# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIw

# MTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0w

# Ni0yMy5jcnQwgaAGA1UdIAEB/wSBlTCBkjCBjwYJKwYBBAGCNy4DMIGBMD0GCCsG

# AQUFBwIBFjFodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vUEtJL2RvY3MvQ1BTL2Rl

# ZmF1bHQuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAFAAbwBsAGkA

# YwB5AF8AUwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQAH

# 5ohRDeLG4Jg/gXEDPZ2joSFvs+umzPUxvs8F4qn++ldtGTCzwsVmyWrf9efweL3H

# qJ4l4/m87WtUVwgrUYJEEvu5U4zM9GASinbMQEBBm9xcF/9c+V4XNZgkVkt070IQ

# yK+/f8Z/8jd9Wj8c8pl5SpFSAK84Dxf1L3mBZdmptWvkx872ynoAb0swRCQiPM/t

# A6WWj1kpvLb9BOFwnzJKJ/1Vry/+tuWOM7tiX5rbV0Dp8c6ZZpCM/2pif93FSguR

# JuI57BlKcWOdeyFtw5yjojz6f32WapB4pm3S4Zz5Hfw42JT0xqUKloakvZ4argRC

# g7i1gJsiOCC1JeVk7Pf0v35jWSUPei45V3aicaoGig+JFrphpxHLmtgOR5qAxdDN

# p9DvfYPw4TtxCd9ddJgiCGHasFAeb73x4QDf5zEHpJM692VHeOj4qEir995yfmFr

# b3epgcunCaw5u+zGy9iCtHLNHfS4hQEegPsbiSpUObJb2sgNVZl6h3M7COaYLeqN

# 4DMuEin1wC9UJyH3yKxO2ii4sanblrKnQqLJzxlBTeCG+SqaoxFmMNO7dDJL32N7

# 9ZmKLxvHIa9Zta7cRDyXUHHXodLFVeNp3lfB0d4wwP3M5k37Db9dT+mdHhk4L7zP

# WAUu7w2gUDXa7wknHNWzfjUeCLraNtvTX4/edIhJEjCCBNowggPCoAMCAQICEzMA

# AAC0Qzoc/ra6UokAAAAAALQwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt

# U3RhbXAgUENBIDIwMTAwHhcNMTYwOTA3MTc1NjU4WhcNMTgwOTA3MTc1NjU4WjCB

# szELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjENMAsGA1UECxME

# TU9QUjEnMCUGA1UECxMebkNpcGhlciBEU0UgRVNOOjE0OEMtQzRCOS0yMDY2MSUw

# IwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIBIjANBgkqhkiG

# 9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4IFPu7XRMDo/gwC3zFaf95usurNdZBEegtZ6

# 1+4g+7PRCAFjl1enwuJMVqi1V9ugxt+z0RixHn6RrBkZUW1z/p4tbSRCIMTI70Zp

# 0G8cTGFqlDMPlD7bom8lKr8Z0s4DOlIVgEVlG/3Ptf83smhmmWWt7v++gU1Dngt4

# CdYqjz2KtAcz2bBQJFHvf/Uk1BUMj3YY2Fa8tW2jKXTYdQdIQBmOZhiRAgJwG0Hb

# +SehGXXGlqj6QS+7esU0pjCgl5PHGmwAWoK2jABnksvMTdJsqePEXnkLAZWuqKS5

# Iv75RV4/fRkbYZw3dNmjUcXuSNlUMxSDX7LnD3uwH8mXvpmFcQIDAQABo4IBGzCC

# ARcwHQYDVR0OBBYEFAyTq0XUbAt3L/MrV/PpJMSHB/RfMB8GA1UdIwQYMBaAFNVj

# OlyKMZDzQ3t8RhvFM2hahW1VMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwu

# bWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1RpbVN0YVBDQV8yMDEw

# LTA3LTAxLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93

# d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljVGltU3RhUENBXzIwMTAtMDct

# MDEuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYIKwYBBQUHAwgwDQYJKoZI

# hvcNAQELBQADggEBAAK1YVugp9JqrCYvtsI0o3T7qHuQsYItqIkSXaT2ggtZPSfn

# eh15LPjLcs9Ha+9v3uuSbe6v+16hkYR4419Re8SXMeBQje26mfeIKr9RauIj5DdH

# 3WbixYUI7P51cet6bUmJJSEdnY4W5Fik5qiVtZu0k6GKLLicITq8AVEfmOCf8+3q

# UMy7N4QpavAibKVPrhMReWZkcCejDPq03ky7UH7En3/pgVEE3q4UX+YODBCBukas

# O2IS57XRCjDw0yns+tNwMW4KeiRRwiLmDiK3Q1GqU1Ui9SS159N1eCmhOltpCuCt

# fJnPn7SSKAd+qnDEMoZbSg7YRLb1PmcfecPyK1OhggN5MIICYQIBATCB46GBuaSB

# tjCBszELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjENMAsGA1UE

# CxMETU9QUjEnMCUGA1UECxMebkNpcGhlciBEU0UgRVNOOjE0OEMtQzRCOS0yMDY2

# MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiUKAQEwCQYF

# Kw4DAhoFAAMVAAfAlZeuLk5uydN19tmJUZiLIG06oIHCMIG/pIG8MIG5MQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMQ0wCwYDVQQLEwRNT1BSMScw

# JQYDVQQLEx5uQ2lwaGVyIE5UUyBFU046NERFOS0wQzVFLTNFMDkxKzApBgNVBAMT

# Ik1pY3Jvc29mdCBUaW1lIFNvdXJjZSBNYXN0ZXIgQ2xvY2swDQYJKoZIhvcNAQEF

# BQACBQDdWK0EMCIYDzIwMTcwOTA1MDQ1NjM2WhgPMjAxNzA5MDYwNDU2MzZaMHcw

# PQYKKwYBBAGEWQoEATEvMC0wCgIFAN1YrQQCAQAwCgIBAAICBzoCAf8wBwIBAAIC

# HBgwCgIFAN1Z/oQCAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAaAK

# MAgCAQACAwehIKEKMAgCAQACAwehIDANBgkqhkiG9w0BAQUFAAOCAQEALwY679N2

# 1lyYyv02M9hqGtWKqwzo5L9jFJwzVISPiB11A44qmS2N0VG0NjLrpoSYeVBQcopx

# 8q6MpEScwoBLY9jn5KBEjTfWxOyMEXoVPP01zMJ1PqXqVDNQeeHrwtBi5ewEB+sH

# vFeniiQLLavuRZOLLi+MJ7SI2aIifcxk2gzSyzj0NwWpFUZH8uKBhWN9qXM0IJoj

# PSw8YeJqcjaHA8M2lWiDzoLFuhvoppkXU5jQA+i7PpjSU7GR9c125iaw9G+yScBB

# /WVbMAbhm29cYwNG4AJ0cWhJP9T+cdJdFqav9Of91V7wy2ExAM5+hTyO9oB+8rjk

# pi8eGCYOTwO5wjGCAvUwggLxAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBD

# QSAyMDEwAhMzAAAAtEM6HP62ulKJAAAAAAC0MA0GCWCGSAFlAwQCAQUAoIIBMjAa

# BgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIGE7r+tL

# qSxf9BBybKAgBeIYhHQEiOoRCr7bcmfwiCQZMIHiBgsqhkiG9w0BCRACDDGB0jCB

# zzCBzDCBsQQUB8CVl64uTm7J03X22YlRmIsgbTowgZgwgYCkfjB8MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQg

# VGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAALRDOhz+trpSiQAAAAAAtDAWBBRvckTu

# xLqEMp+p73tMOlL/8PMB4DANBgkqhkiG9w0BAQsFAASCAQBvcVAgDyI/IcLDoJT1

# EgPfi0y891lGsPcican8Ap3Lr2ErY3hjDFuEbCSTh9KaE6ra8H/W0mJDsX0bwKxV

# CvT5vh3AKASLnuVvtkBoPxG/Cj74ddJTzAiJFOKHKTtybKDxHWP1NBN7wi0/YoJi

# N55U0jWouh+JmSWeP59HCkDKdc6+KwGgQWhtm1g9VE5sKwpka98ZVvieENLEkiZH

# h7BZMiAS1gvkmOqa6UsAi2/oLhIpVSrZ2JQfuUBK3VwHf4aYuv77tVwngri2EdX1

# byfFCZ4VPKiGD75kxn0MUdoy+ny7CG6IKSfq4XGzNCzJFDYKnn6TogJ5uSX6+uND

# kkRK

# SIG # End signature block