StoreBroker/Telemetry.ps1
|
# Copyright (C) Microsoft Corporation. All rights reserved. # Singleton. Don't directly access this though....always get it # by calling Get-BaseTelemetryEvent to ensure that it has been initialized and that you're always # getting a fresh copy. $script:SBBaseTelemetryEvent = $null Add-Type -TypeDefinition @" public enum StoreBrokerTelemetryProperty { AddPackages, AppId, AppName, AppxVersion, AutoCommit, DayOfWeek, ErrorBucket, ExistingPackageRolloutAction, FlightId, Force, HResult, IapId, IsMandatoryUpdate, Message, NumRetries, PackagePath, PackageRolloutPercentage, ProductId, ProductType, ReplacePackages, RetryStatusCode, ShowFlight, ShowSubmission, SourceFilePath, SubmissionId, UpdateAppProperties, UpdateGamingOptions, UpdateListings, UpdateNotesForCertification, UpdatePricingAndAvailability, UpdateProperties, UpdatePublishMode, UpdatePublishModeAndVisibility, UpdateTrailers, UriFragment, UserName, Web, } "@ Add-Type -TypeDefinition @" public enum StoreBrokerTelemetryMetric { Duration, NumEmailAddresses, } "@ function Initialize-TelemetryGlobalVariables { <# .SYNOPSIS Initializes the global variables that are "owned" by the Telemetry script file. .DESCRIPTION Initializes the global variables that are "owned" by the Telemetry script file. Global variables are used sparingly to enables users a way to control certain extensibility points with this module. The Git repo for this module can be found here: http://aka.ms/StoreBroker .NOTES Internal-only helper method. The only reason this exists is so that we can leverage CodeAnalysis.SuppressMessageAttribute, which can only be applied to functions. Otherwise, we would have just had the relevant initialization code directly above the function that references the variable. We call this immediately after the declaration so that the variables are available for reference in any function below. #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="We are initializing multiple variables.")] # Note, this doesn't currently work due to https://github.com/PowerShell/PSScriptAnalyzer/issues/698 [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseDeclaredVarsMoreThanAssignment", "", Justification = "These are global variables and so are used elsewhere.")] param() # We only set their values if they don't already have values defined. # We use -ErrorAction Ignore during the Get-Variable check since it throws an exception # by default if the variable we're getting doesn't exist, and we just want the bool result. # SilentlyContinue would cause it to go into the global $Error array, Ignore prevents that as well. if (!(Get-Variable -Name SBDisableTelemetry -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBDisableTelemetry = $false } if (!(Get-Variable -Name SBSuppressTelemetryReminder -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBSuppressTelemetryReminder = $false } if (!(Get-Variable -Name SBDisablePiiProtection -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBDisablePiiProtection = $false } if (!(Get-Variable -Name SBApplicationInsightsKey -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBApplicationInsightsKey = '4cdaa89f-33c5-46b4-ba5a-3befb5d8fe01' } } # We need to be sure to call this explicitly so that the global variables get initialized. Initialize-TelemetryGlobalVariables function Get-PiiSafeString { <# .SYNOPSIS If PII protection is enabled, returns back an SHA512-hashed value for the specified string, otherwise returns back the original string, untouched. .SYNOPSIS If PII protection is enabled, returns back an SHA512-hashed value for the specified string, otherwise returns back the original string, untouched. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER PlainText The plain text that contains PII that may need to be protected. .EXAMPLE Get-PiiSafeString -PlainText "Hello World" Returns back the string "B10A8DB164E0754105B7A99BE72E3FE5" which respresents the SHA512 hash of "Hello World", but only if $global:SBDisablePiiProtection is $false. If it's $true, "Hello World" will be returned. .OUTPUTS System.String - A SHA512 hash of PlainText will be returned if $global:SBDisablePiiProtection is $false, otherwise PlainText will be returned untouched. #> [CmdletBinding()] [OutputType([String])] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] param( [Parameter(Mandatory)] [AllowNull()] [AllowEmptyString()] [string] $PlainText ) if ($global:SBDisablePiiProtection) { return $PlainText } else { return (Get-SHA512Hash -PlainText $PlainText) } } function Get-BaseTelemetryEvent { <# .SYNOPSIS Returns back the base object for an Application Insights telemetry event. .DESCRIPTION Returns back the base object for an Application Insights telemetry event. The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub .EXAMPLE Get-BaseTelemetryEvent Returns back a base telemetry event, populated with the minimum properties necessary to correctly report up to this project's telemetry. Callers can then add on to the event as nececessary. .OUTPUTS [PSCustomObject] #> [CmdletBinding()] param() if ($null -eq $script:SBBaseTelemetryEvent) { if (-not $global:SBSuppressTelemetryReminder) { Write-Log -Message "Telemetry is currently enabled. It can be disabled by setting ""`$global:SBDisableTelemetry = `$true"". Refer to USAGE.md#telemetry for more information. Stop seeing this message in the future by setting `"`$global:SBSuppressTelemetryReminder=`$true`"" } $username = Get-PiiSafeString -PlainText $env:USERNAME $script:SBBaseTelemetryEvent = [PSCustomObject] @{ 'name' = 'Microsoft.ApplicationInsights.66d83c523070489b886b09860e05e78a.Event' 'time' = (Get-Date).ToUniversalTime().ToString("O") 'iKey' = $global:SBApplicationInsightsKey 'tags' = [PSCustomObject] @{ 'ai.user.id' = $username 'ai.session.id' = [System.GUID]::NewGuid().ToString() 'ai.application.ver' = $MyInvocation.MyCommand.Module.Version.ToString() 'ai.internal.sdkVersion' = '2.0.1.33027' # The version this schema was based off of. } 'data' = [PSCustomObject] @{ 'baseType' = 'EventData' 'baseData' = [PSCustomObject] @{ 'ver' = 2 'properties' = [PSCustomObject] @{ 'DayOfWeek' = (Get-Date).DayOfWeek.ToString() 'Username' = $username } } } } } return $script:SBBaseTelemetryEvent.PSObject.Copy() # Get a new instance, not a reference } function Invoke-SendTelemetryEvent { <# .SYNOPSIS Sends an event to Application Insights directly using its REST API. .DESCRIPTION Sends an event to Application Insights directly using its REST API. A very heavy wrapper around Invoke-WebRequest that understands Application Insights and how to perform its requests with and without console status updates. It also understands how to parse and handle errors from the REST calls. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER TelemetryEvent The raw object representing the event data to send to Application Insights. .OUTPUTS [PSCustomObject] - The result of the REST operation, in whatever form it comes in. .NOTES This mirrors Invoke-SBRestMethod extensively, however the error handling is slightly different. There wasn't a clear way to refactor the code to make both of these Invoke-* methods share a common base code. Leaving this as-is to make this file easier to share out with other PowerShell projects. #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] param( [Parameter(Mandatory)] [PSCustomObject] $TelemetryEvent ) $jsonConversionDepth = 20 # Seems like it should be more than sufficient $uri = 'https://dc.services.visualstudio.com/v2/track' $method = 'POST' $headers = @{'Content-Type' = 'application/json; charset=UTF-8'} $body = ConvertTo-Json -InputObject $TelemetryEvent -Depth $jsonConversionDepth -Compress $bodyAsBytes = [System.Text.Encoding]::UTF8.GetBytes($body) try { Write-Log -Message "Sending telemetry event data to $uri [Timeout = $global:SBWebRequestTimeoutSec]" -Level Verbose $params = @{} $params.Add("Uri", $uri) $params.Add("Method", $method) $params.Add("Headers", $headers) $params.Add("UseDefaultCredentials", $true) $params.Add("UseBasicParsing", $true) $params.Add("TimeoutSec", $global:SBWebRequestTimeoutSec) $params.Add("Body", $bodyAsBytes) # Disable Progress Bar in function scope during Invoke-WebRequest $ProgressPreference = 'SilentlyContinue' return Invoke-WebRequest @params } catch { $ex = $null $message = $null $statusCode = $null $statusDescription = $null $innerMessage = $null $rawContent = $null if ($_.Exception -is [System.Net.WebException]) { $ex = $_.Exception $message = $_.Exception.Message $statusCode = $ex.Response.StatusCode.value__ # Note that value__ is not a typo. $statusDescription = $ex.Response.StatusDescription $innerMessage = $_.ErrorDetails.Message try { $rawContent = Get-HttpWebResponseContent -WebResponse $ex.Response } catch { Write-Log -Message "Unable to retrieve the raw HTTP Web Response:" -Exception $_ -Level Warning } } else { Write-Log -Exception $_ -Level Error throw } $output = @() $output += $message if (-not [string]::IsNullOrEmpty($statusCode)) { $output += "$statusCode | $($statusDescription.Trim())" } if (-not [string]::IsNullOrEmpty($innerMessage)) { try { $innerMessageJson = ($innerMessage | ConvertFrom-Json) if ($innerMessageJson -is [String]) { $output += $innerMessageJson.Trim() } elseif (-not [String]::IsNullOrWhiteSpace($innerMessageJson.itemsReceived)) { $output += "Items Received: $($innerMessageJson.itemsReceived)" $output += "Items Accepted: $($innerMessageJson.itemsAccepted)" if ($innerMessageJson.errors.Count -gt 0) { $output += "Errors:" $output += ($innerMessageJson.errors | Format-Table | Out-String) } } else { # In this case, it's probably not a normal message from the API $output += ($innerMessageJson | Out-String) } } catch [System.ArgumentException] { # Will be thrown if $innerMessage isn't JSON content $output += $innerMessage.Trim() } } # It's possible that the API returned JSON content in its error response. if (-not [String]::IsNullOrWhiteSpace($rawContent)) { $output += $rawContent } $output += "Original body: $body" $newLineOutput = ($output -join [Environment]::NewLine) Write-Log -Message $newLineOutput -Level Error throw $newLineOutput } } function Set-TelemetryEvent { <# .SYNOPSIS Posts a new telemetry event for this module to the configured Applications Insights instance. .DESCRIPTION Posts a new telemetry event for this module to the configured Applications Insights instance. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER EventName The name of the event that has occurred. .PARAMETER Properties A collection of name/value pairs (string/string) that should be associated with this event. .PARAMETER Metrics A collection of name/value pair metrics (string/double) that should be associated with this event. .EXAMPLE Set-TelemetryEvent "zFooTest1" Posts a "zFooTest1" event with the default set of properties and metrics. .EXAMPLE Set-TelemetryEvent "zFooTest1" @{"Prop1" = "Value1"} Posts a "zFooTest1" event with the default set of properties and metrics along with an additional property named "Prop1" with a value of "Value1". .NOTES Because of the short-running nature of this module, we always "flush" the events as soon as they have been posted to ensure that they make it to Application Insights. #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '', Justification='Function is not state changing')] param( [Parameter(Mandatory)] [string] $EventName, [hashtable] $Properties = @{}, [hashtable] $Metrics = @{} ) if ($global:SBDisableTelemetry) { Write-Log -Message "Telemetry has been disabled via `$global:SBDisableTelemetry. Skipping reporting event." -Level Verbose return } Write-InvocationLog -ExcludeParameter @('Properties', 'Metrics') try { $telemetryEvent = Get-BaseTelemetryEvent Add-Member -InputObject $telemetryEvent.data.baseData -Name 'name' -Value $EventName -MemberType NoteProperty -Force # Properties foreach ($property in $Properties.GetEnumerator()) { Add-Member -InputObject $telemetryEvent.data.baseData.properties -Name $property.Key -Value $property.Value -MemberType NoteProperty -Force } # Measurements if ($Metrics.Count -gt 0) { $measurements = @{} foreach ($metric in $Metrics.GetEnumerator()) { $measurements[$metric.Key] = $metric.Value } Add-Member -InputObject $telemetryEvent.data.baseData -Name 'measurements' -Value ([PSCustomObject] $measurements) -MemberType NoteProperty -Force } $null = Invoke-SendTelemetryEvent -TelemetryEvent $telemetryEvent } catch { Write-Log -Level Warning -Message @( "Encountered a problem while trying to record telemetry events.", "This is non-fatal, but it would be helpful if you could report this problem", "to the StoreBroker team for further investigation:" "", $_.Exception) } } function Set-TelemetryException { <# .SYNOPSIS Posts a new telemetry event to the configured Application Insights instance indicating that an exception occurred in this this module. .DESCRIPTION Posts a new telemetry event to the configured Application Insights instance indicating that an exception occurred in this this module. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER Exception The exception that just occurred. .PARAMETER ErrorBucket A property to be added to the Exception being logged to make it easier to filter to exceptions resulting from similar scenarios. .PARAMETER Properties Additional properties that the caller may wish to be associated with this exception. .EXAMPLE Set-TelemetryException $_ Used within the context of a catch statement, this will post the exception that just occurred, along with a default set of properties. .NOTES Because of the short-running nature of this module, we always "flush" the events as soon as they have been posted to ensure that they make it to Application Insights. #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '', Justification='Function is not state changing.')] param( [Parameter(Mandatory)] [System.Exception] $Exception, [string] $ErrorBucket, [hashtable] $Properties = @{} ) if ($global:SBDisableTelemetry) { Write-Log -Message "Telemetry has been disabled via `$global:SBDisableTelemetry. Skipping reporting event." -Level Verbose return } Write-InvocationLog -ExcludeParameter @('Exception', 'Properties') try { $telemetryEvent = Get-BaseTelemetryEvent $telemetryEvent.data.baseType = 'ExceptionData' Add-Member -InputObject $telemetryEvent.data.baseData -Name 'handledAt' -Value 'UserCode' -MemberType NoteProperty -Force # Properties if (-not [String]::IsNullOrWhiteSpace($ErrorBucket)) { Add-Member -InputObject $telemetryEvent.data.baseData.properties -Name 'ErrorBucket' -Value $ErrorBucket -MemberType NoteProperty -Force } Add-Member -InputObject $telemetryEvent.data.baseData.properties -Name 'Message' -Value $Exception.Message -MemberType NoteProperty -Force Add-Member -InputObject $telemetryEvent.data.baseData.properties -Name 'HResult' -Value ("0x{0}" -f [Convert]::ToString($Exception.HResult, 16)) -MemberType NoteProperty -Force foreach ($property in $Properties.GetEnumerator()) { Add-Member -InputObject $telemetryEvent.data.baseData.properties -Name $property.Key -Value $property.Value -MemberType NoteProperty -Force } # Re-create the stack. We'll start with what's in Invocation Info since it's already # been broken down for us (although it doesn't supply the method name). $parsedStack = @( [PSCustomObject] @{ 'assembly' = $MyInvocation.MyCommand.Module.Name 'method' = '<unknown>' 'fileName' = $Exception.ErrorRecord.InvocationInfo.ScriptName 'level' = 0 'line' = $Exception.ErrorRecord.InvocationInfo.ScriptLineNumber } ) # And then we'll try to parse ErrorRecord's ScriptStackTrace and make this as useful # as possible. $stackFrames = $Exception.ErrorRecord.ScriptStackTrace -split [Environment]::NewLine for ($i = 0; $i -lt $stackFrames.Count; $i++) { $frame = $stackFrames[$i] if ($frame -match '^at (.+), (.+): line (\d+)$') { $parsedStack += [PSCustomObject] @{ 'assembly' = $MyInvocation.MyCommand.Module.Name 'method' = $Matches[1] 'fileName' = $Matches[2] 'level' = $i + 1 'line' = $Matches[3] } } } # Finally, we'll build up the Exception data object. $exceptionData = [PSCustomObject] @{ 'id' = (Get-Date).ToFileTime() 'typeName' = $Exception.GetType().FullName 'message' = $Exception.Message 'hasFullStack' = $true 'parsedStack' = $parsedStack } Add-Member -InputObject $telemetryEvent.data.baseData -Name 'exceptions' -Value @($exceptionData) -MemberType NoteProperty -Force $null = Invoke-SendTelemetryEvent -TelemetryEvent $telemetryEvent } catch { Write-Log -Level Warning -Message @( "Encountered a problem while trying to record telemetry events.", "This is non-fatal, but it would be helpful if you could report this problem", "to the StoreBroker team for further investigation:", "", $_.Exception) } } # SIG # Begin signature block # MIIjkgYJKoZIhvcNAQcCoIIjgzCCI38CAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBbVI13bmUUjVH9 # e/r7zq3CujJlEUUodB9pJWX6RsevgKCCDYEwggX/MIID56ADAgECAhMzAAABh3IX # chVZQMcJAAAAAAGHMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjAwMzA0MTgzOTQ3WhcNMjEwMzAzMTgzOTQ3WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDOt8kLc7P3T7MKIhouYHewMFmnq8Ayu7FOhZCQabVwBp2VS4WyB2Qe4TQBT8aB # znANDEPjHKNdPT8Xz5cNali6XHefS8i/WXtF0vSsP8NEv6mBHuA2p1fw2wB/F0dH # sJ3GfZ5c0sPJjklsiYqPw59xJ54kM91IOgiO2OUzjNAljPibjCWfH7UzQ1TPHc4d # weils8GEIrbBRb7IWwiObL12jWT4Yh71NQgvJ9Fn6+UhD9x2uk3dLj84vwt1NuFQ # itKJxIV0fVsRNR3abQVOLqpDugbr0SzNL6o8xzOHL5OXiGGwg6ekiXA1/2XXY7yV # Fc39tledDtZjSjNbex1zzwSXAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhov4ZyO96axkJdMjpzu2zVXOJcsw # UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1 # ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDU4Mzg1MB8GA1UdIwQYMBaAFEhu # ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu # bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w # Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx # MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAixmy # S6E6vprWD9KFNIB9G5zyMuIjZAOuUJ1EK/Vlg6Fb3ZHXjjUwATKIcXbFuFC6Wr4K # NrU4DY/sBVqmab5AC/je3bpUpjtxpEyqUqtPc30wEg/rO9vmKmqKoLPT37svc2NV # BmGNl+85qO4fV/w7Cx7J0Bbqk19KcRNdjt6eKoTnTPHBHlVHQIHZpMxacbFOAkJr # qAVkYZdz7ikNXTxV+GRb36tC4ByMNxE2DF7vFdvaiZP0CVZ5ByJ2gAhXMdK9+usx # zVk913qKde1OAuWdv+rndqkAIm8fUlRnr4saSCg7cIbUwCCf116wUJ7EuJDg0vHe # yhnCeHnBbyH3RZkHEi2ofmfgnFISJZDdMAeVZGVOh20Jp50XBzqokpPzeZ6zc1/g # yILNyiVgE+RPkjnUQshd1f1PMgn3tns2Cz7bJiVUaqEO3n9qRFgy5JuLae6UweGf # AeOo3dgLZxikKzYs3hDMaEtJq8IP71cX7QXe6lnMmXU/Hdfz2p897Zd+kU+vZvKI # 3cwLfuVQgK2RZ2z+Kc3K3dRPz2rXycK5XCuRZmvGab/WbrZiC7wJQapgBodltMI5 # GMdFrBg9IeF7/rP4EqVQXeKtevTlZXjpuNhhjuR+2DMt/dWufjXpiW91bo3aH6Ea # jOALXmoxgltCp1K7hrS6gmsvj94cLRf50QQ4U8Qwggd6MIIFYqADAgECAgphDpDS # 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/BvW1taslScxMNelDNMYIVZzCCFWMCAQEwgZUwfjELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z # b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAYdyF3IVWUDHCQAAAAABhzAN # BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor # BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgqRO74aj+ # AuTcaWPgkvFmdY/I1Wri6Ue04QQEsEGDDYwwQgYKKwYBBAGCNwIBDDE0MDKgFIAS # AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN # BgkqhkiG9w0BAQEFAASCAQBRAc9cjnqPpc/F6wgSC2MI4EHbFenkhGwQgnDghRyF # OSistoVKy3izAPLlaT1xjrzFSmk4KXn0QDIJUKWmWxIi3KAi50oF88A0oyCxg47u # 8UwGQ5EPj4KEcEYC8XO8Dh9xXsp1bE4bUTkH1Xg7oyr9T7F0DLDn+wRYhjYEld8B # Ckl0jrOJ1aiAwQvE5fMwLKpXZTMEUA9mrj24shsn2A1s32ulef46JbxqNCMjb2MZ # RGssAT9JWNMLMCKzwYUk8xtcWnVlHDFfhOTNfxPUqj1GlkT5rHGHMRrak7NzgUXl # V4XbilwY6FnWnQBTb80eJSsdywYF6Fo95zKWaAwRCSeDoYIS8TCCEu0GCisGAQQB # gjcDAwExghLdMIIS2QYJKoZIhvcNAQcCoIISyjCCEsYCAQMxDzANBglghkgBZQME # AgEFADCCAVUGCyqGSIb3DQEJEAEEoIIBRASCAUAwggE8AgEBBgorBgEEAYRZCgMB # MDEwDQYJYIZIAWUDBAIBBQAEIPzy8I6FV7sG3IZ5SL0Al2qfwJYn+3g6e8RTVpxA # aEEXAgZfu8yAgHAYEzIwMjAxMjAxMjAwNzExLjM3NlowBIACAfSggdSkgdEwgc4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1p # Y3Jvc29mdCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMg # VFNTIEVTTjpDNEJELUUzN0YtNUZGQzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt # U3RhbXAgU2VydmljZaCCDkQwggT1MIID3aADAgECAhMzAAABIziw5K3YWpCdAAAA # AAEjMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw # MB4XDTE5MTIxOTAxMTQ1NloXDTIxMDMxNzAxMTQ1Nlowgc4xCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVy # YXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjpDNEJE # LUUzN0YtNUZGQzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vydmlj # ZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJ280MmwZKXcAS7x2ZvA # 4TOOCzw+63Xs9ULGWtdZDN3Vl+aGQEsMwErIkgzQi0fTO0sOD9N3hO1HaTWHoS80 # N/Qb6oLR2WCZkv/VM4WFnThOv3yA5zSt+vuKNwrjEHFC0jlMDCJqaU7St6WJbl/k # AP5sgM0qtpEEQhxtVaf8IoV5lq8vgMJNr30O4rqLYEi/YZWQZYwQHAiVMunCYpJi # ccnNONRRdg2D3Tyu22eEJwPQP6DkeEioMy9ehMmBrkjADVOgQV+T4mir+hAJeINy # sps6wgRO5qjuV5+jvczNQa1Wm7jxsqBv04GClIp5NHvrXQmZ9mpZdj3rjxFuZbKj # d3ECAwEAAaOCARswggEXMB0GA1UdDgQWBBSB1GwUgNONG/kRwrBo3hkV+AyeHjAf # BgNVHSMEGDAWgBTVYzpcijGQ80N7fEYbxTNoWoVtVTBWBgNVHR8ETzBNMEugSaBH # hkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNU # aW1TdGFQQ0FfMjAxMC0wNy0wMS5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUF # BzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1RpbVN0 # YVBDQV8yMDEwLTA3LTAxLmNydDAMBgNVHRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsG # AQUFBwMIMA0GCSqGSIb3DQEBCwUAA4IBAQBb5QG3qlfoW6r1V4lT+kO8LUzF32S3 # fUfgn/S1QQBPzORs/6ujj09ytHWNDfOewwkSya1f8S9e+BbnXknH5l3R6nS2BkRT # ANtTmXxvMLTCyveYe/JQIfos+Z3iJ0b1qHDSnEj6Qmdf1MymrPAk5jxhxhiiXlwI # LUjvH56y7rLHxK0wnsH12EO9MnkaSNXJNCmSmfgUEkDNzu53C39l6XNRAPauz2/W # slIUZcX3NDCMgv5hZi2nhd99HxyaJJscn1f8hZXA++f1HNbq8bdkh3OYgRnNr7Qd # nO+Guvtu3dyGqYdQMMGPnAt4L7Ew9ykjy0Uoz64/r0SbQIRYty5eM9M3MIIGcTCC # BFmgAwIBAgIKYQmBKgAAAAAAAjANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJv # b3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMTAwNzAxMjEzNjU1WhcN # MjUwNzAxMjE0NjU1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv # bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0 # aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCASIw # DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKkdDbx3EYo6IOz8E5f1+n9plGt0 # VBDVpQoAgoX77XxoSyxfxcPlYcJ2tz5mK1vwFVMnBDEfQRsalR3OCROOfGEwWbEw # RA/xYIiEVEMM1024OAizQt2TrNZzMFcmgqNFDdDq9UeBzb8kYDJYYEbyWEeGMoQe # dGFnkV+BVLHPk0ySwcSmXdFhE24oxhr5hoC732H8RsEnHSRnEnIaIYqvS2SJUGKx # Xf13Hz3wV3WsvYpCTUBR0Q+cBj5nf/VmwAOWRH7v0Ev9buWayrGo8noqCjHw2k4G # kbaICDXoeByw6ZnNPOcvRLqn9NxkvaQBwSAJk3jN/LzAyURdXhacAQVPIk0CAwEA # AaOCAeYwggHiMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBTVYzpcijGQ80N7 # fEYbxTNoWoVtVTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDCBoAYDVR0g # AQH/BIGVMIGSMIGPBgkrBgEEAYI3LgMwgYEwPQYIKwYBBQUHAgEWMWh0dHA6Ly93 # d3cubWljcm9zb2Z0LmNvbS9QS0kvZG9jcy9DUFMvZGVmYXVsdC5odG0wQAYIKwYB # BQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AUABvAGwAaQBjAHkAXwBTAHQAYQB0AGUA # bQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAAfmiFEN4sbgmD+BcQM9naOh # IW+z66bM9TG+zwXiqf76V20ZMLPCxWbJat/15/B4vceoniXj+bzta1RXCCtRgkQS # +7lTjMz0YBKKdsxAQEGb3FwX/1z5Xhc1mCRWS3TvQhDIr79/xn/yN31aPxzymXlK # kVIArzgPF/UveYFl2am1a+THzvbKegBvSzBEJCI8z+0DpZaPWSm8tv0E4XCfMkon # /VWvL/625Y4zu2JfmttXQOnxzplmkIz/amJ/3cVKC5Em4jnsGUpxY517IW3DnKOi # PPp/fZZqkHimbdLhnPkd/DjYlPTGpQqWhqS9nhquBEKDuLWAmyI4ILUl5WTs9/S/ # fmNZJQ96LjlXdqJxqgaKD4kWumGnEcua2A5HmoDF0M2n0O99g/DhO3EJ3110mCII # YdqwUB5vvfHhAN/nMQekkzr3ZUd46PioSKv33nJ+YWtvd6mBy6cJrDm77MbL2IK0 # cs0d9LiFAR6A+xuJKlQ5slvayA1VmXqHczsI5pgt6o3gMy4SKfXAL1QnIffIrE7a # KLixqduWsqdCosnPGUFN4Ib5KpqjEWYw07t0MkvfY3v1mYovG8chr1m1rtxEPJdQ # cdeh0sVV42neV8HR3jDA/czmTfsNv11P6Z0eGTgvvM9YBS7vDaBQNdrvCScc1bN+ # NR4Iuto229Nfj950iEkSoYIC0jCCAjsCAQEwgfyhgdSkgdEwgc4xCzAJBgNVBAYT # AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBP # cGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjpD # NEJELUUzN0YtNUZGQzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy # dmljZaIjCgEBMAcGBSsOAwIaAxUAuhdmjeDinhfC7gw1KBCeM/v7V4GggYMwgYCk # fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD # Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF # AONw1lwwIhgPMjAyMDEyMDExODQ5MDBaGA8yMDIwMTIwMjE4NDkwMFowdzA9Bgor # BgEEAYRZCgQBMS8wLTAKAgUA43DWXAIBADAKAgEAAgIEWAIB/zAHAgEAAgIR3TAK # AgUA43In3AIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB # AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAD2Db2petJ/EeQd1 # qndrmEzdmfe1uV+p63YNa+RwGHd8TaahhqoxKY+dMfEg1M5oAaIiveP4AvogSXJ+ # 4keoVe+/K7AcvX38gfjtFmpqtSDeMv6bMczW3h5qH/yA4sMI6pH3gl2Kr1PpQceH # lv2fm7E/1xj7cdUy09ufruNUugVIMYIDDTCCAwkCAQEwgZMwfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTACEzMAAAEjOLDkrdhakJ0AAAAAASMwDQYJYIZIAWUD # BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B # CQQxIgQg7YXRPY36JM3/JUPpS++16SjaLPFa7TdZd3qrQVEffiAwgfoGCyqGSIb3 # DQEJEAIvMYHqMIHnMIHkMIG9BCARmjODP/tEzMQNo6OsxKQADL8pwKJkM5YnXKrq # +xWBszCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u # MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp # b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB # Iziw5K3YWpCdAAAAAAEjMCIEINlVYIjbQCJGeEAF7SPP/wlSL/KSutPFWGPEzcvT # POOgMA0GCSqGSIb3DQEBCwUABIIBAI1r0lHwiBMZZl22BB1SeW0wDZSxc92/WSN1 # eKBmK/q4xq9Be6mW3lZAR+TxqgGphBxuXyg6osMt/q2CE3ZDYiVtjd3iaRwr6QtI # MKSYsw59ge51m3mO4gAAf51uExBUQrCXepODbn6ZbhAy41JTjZKMCqLXbQBR9vGI # GgtWOCJQGcmHrpTBQGJsxI1AQXpZce99fM/U4nNiEQcE/KEcUm0lba1oAsKxTcFA # 7EGrTPahqGKcU2Wubgqi02X+ghDZlyOK/4Jgw4YZMzoAA+7mUTMokwYTzmaIHelA # 6GcjFJRuthtv6O9bbvy3+TBD3OK0qK2EEZCuB49qeptcGt3maIw= # SIG # End signature block |