Framework/Managers/BatchScanManager.ps1
Set-StrictMode -Version Latest class BatchScanManager { hidden [string] $OrgName = $null; hidden [string] $ProjectName = $null; [PSObject] $ControlSettings; hidden [string] $BatchScanTrackerFileName=$null; hidden [string] $AzSKTempStatePath = (Join-Path $([Constants]::AzSKAppFolderPath) "TempState" | Join-Path -ChildPath "BatchScanData"); hidden [string] $MasterFilePath; hidden [PSObject] $BatchScanTrackerObj = $null; hidden [PSObject] $ScanPendingForBatch = $null; hidden static [BatchScanManager] $Instance =$null; hidden [int] $BatchSize = 0; hidden [bool] $isUpdated = $false; static [BatchScanManager] GetInstance( [string] $OrganizationName,[string] $ProjectName) { if ( $null -eq [BatchScanManager]::Instance) { [BatchScanManager]::Instance = [BatchScanManager]::new($OrganizationName,$ProjectName); } [BatchScanManager]::Instance.OrgName = $OrganizationName; [BatchScanManager]::Instance.ProjectName = $ProjectName; return [BatchScanManager]::Instance } static [BatchScanManager] GetInstance() { if ( $null -eq [BatchScanManager]::Instance) { [BatchScanManager]::Instance = [BatchScanManager]::new(); } return [BatchScanManager]::Instance } static [void] ClearInstance() { [BatchScanManager]::Instance = $null } BatchScanManager([string] $OrganizationName,[string] $ProjectName){ $this.ControlSettings = [ConfigurationManager]::LoadServerConfigFile("ControlSettings.json"); $this.OrgName = $OrganizationName; $this.ProjectName=$ProjectName; if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("BatchSize")){ $this.BatchSize = $PSCmdlet.MyInvocation.BoundParameters["BatchSize"] } else { $this.BatchSize = $this.ControlSettings.BatchScan.BatchTrackerUpdateFrequency } #need to make batch size half as both builds and releases will be scanned if($PSCmdlet.MyInvocation.BoundParameters.ResourceTypeName -eq "Build_Release"){ if($this.BatchSize%2 -eq 0){ $this.BatchSize=$this.BatchSize/2; } else { $this.BatchSize=($this.BatchSize-1)/2; } } if ([string]::isnullorwhitespace($this.BatchScanTrackerFileName)) { $this.BatchScanTrackerFileName = [Constants]::BatchScanTrackerBlobName } $this.GetBatchScanTrackerObject(); } BatchScanManager() { $this.ControlSettings = [ConfigurationManager]::LoadServerConfigFile("ControlSettings.json"); if ([string]::isnullorwhitespace($this.BatchScanTrackerFileName)) { $this.BatchScanTrackerFileName = [Constants]::BatchScanTrackerBlobName } $this.GetBatchScanTrackerObject(); } [int] GetBatchSize() { return $this.BatchSize } hidden [void] GetBatchScanTrackerObject(){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(-not (Test-Path (Join-Path (Join-Path $this.AzSKTempStatePath $this.OrgName) $this.ProjectName))) { New-Item -ItemType Directory -Path (Join-Path (Join-Path $this.AzSKTempStatePath $this.OrgName) $this.ProjectName) -ErrorAction Stop | Out-Null } } else{ if(-not (Test-Path "$this.AzSKTempStatePath")) { New-Item -ItemType Directory -Path "$this.AzSKTempStatePath" -ErrorAction Stop | Out-Null } } if($null -ne $this.MasterFilePath){ $this.BatchScanTrackerObj = Get-content $this.MasterFilePath | ConvertFrom-Json } else { $this.BatchScanTrackerObj=$null; } } [PSObject] GetBatchStatus(){ return Get-content $this.MasterFilePath | ConvertFrom-Json; } hidden [void] GetBatchTrackerFile($OrgName,$ProjectName){ $this.OrgName=$OrgName; $this.ProjectName=$ProjectName; if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(Test-Path (Join-Path (Join-Path $this.AzSKTempStatePath $this.OrgName) $this.BatchScanTrackerFileName)) { $this.ScanPendingForBatch = Get-Content (Join-Path (Join-Path $this.AzSKTempStatePath (Join-Path $this.OrgName $this.ProjectName)) $this.BatchScanTrackerFileName) -Raw } $this.MasterFilePath = (Join-Path (Join-Path $this.AzSKTempStatePath (Join-Path $this.OrgName $this.ProjectName)) $this.BatchScanTrackerFileName) } else { $this.MasterFilePath = (Join-Path $this.AzSKTempStatePath $this.BatchScanTrackerFileName) } } [void] RemoveBatchScanData(){ if($null -ne $this.BatchScanTrackerObj){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(Test-Path (Join-Path $this.AzSKTempStatePath (Join-Path $this.OrgName $this.ProjectName))) { Remove-Item -Path (Join-Path (Join-Path $this.AzSKTempStatePath (Join-Path $this.OrgName $this.ProjectName)) $this.BatchScanTrackerFileName) } } $this.BatchScanTrackerObj=$null; } } hidden[bool] IsBatchScanInProgress($OrgName,$ProjectName){ $this.GetBatchTrackerFile($OrgName,$ProjectName); if($null -ne $this.ControlSettings.BatchScan){ $batchTrackerFileValidForDays = [Int32]::Parse($this.ControlSettings.BatchScan.BatchTrackerValidforDays); $this.GetBatchScanTrackerObject(); if($null -eq $this.BatchScanTrackerObj){ return $false; } if( (Get-Item $this.MasterFilePath).creationtime.AddDays($batchTrackerFileValidforDays) -lt [DateTime]::UtcNow) { $this.RemoveBatchScanData(); $this.ScanPendingForBatch = $null; return $false; } return $true; } else { $this.ScanPendingForBatch=$null; return $false; } return $true; } [void] CreateBatchMasterList(){ $batchStatus = [BatchScanResourceMap]@{ Skip = 0; Top = $this.GetBatchSize(); BuildCurrentContinuationToken=$null; BuildNextContinuationToken=$null; ReleaseCurrentContinuationToken=$null; ReleaseNextContinuationToken=$null; BatchScanState= [BatchScanState]::INIT; TokenLastModifiedTime = [DateTime]:: UtcNow; ResourceCount=0; SkipMarker = 'False' } if($PSCmdlet.MyInvocation.BoundParameters.ResourceTypeName -eq "Build"){ $batchStatus = $batchStatus | Select-Object -Property * -ExcludeProperty ReleaseCurrentContinuationToken $batchStatus = $batchStatus | Select-Object -Property * -ExcludeProperty ReleaseNextContinuationToken $batchStatus = $batchStatus | Select-Object -Property * -ExcludeProperty SkipMarker } if($PSCmdlet.MyInvocation.BoundParameters.ResourceTypeName -eq "Release"){ $batchStatus = $batchStatus | Select-Object -Property * -ExcludeProperty BuildCurrentContinuationToken $batchStatus = $batchStatus | Select-Object -Property * -ExcludeProperty BuildNextContinuationToken $batchStatus = $batchStatus | Select-Object -Property * -ExcludeProperty SkipMarker } $this.BatchScanTrackerObj=$batchStatus; $this.WriteToBatchTrackerFile() } [void] WriteToBatchTrackerFile() { if($null -ne $this.BatchScanTrackerObj){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(-not (Test-Path (Join-Path $this.AzSKTempStatePath (Join-Path $this.OrgName $this.ProjectName)))) { New-Item -ItemType Directory -Path (Join-Path $this.AzSKTempStatePath (Join-Path $this.OrgName $this.ProjectName)) -ErrorAction Stop | Out-Null } } else{ if(-not (Test-Path "$this.AzSKTempStatePath")) { New-Item -ItemType Directory -Path "$this.AzSKTempStatePath" -ErrorAction Stop | Out-Null } } Write-Host "Updating batch tracker file" -ForegroundColor Green [JsonHelper]::ConvertToJsonCustom( $this.BatchScanTrackerObj) | Out-File $this.MasterFilePath -Force Write-Host "Batch tracker file updated" -ForegroundColor Green } } #to check if anyone either builds or releases have been scanned and other resource is still left, is useful only when build_release is resource type [bool] isPreviousScanPartiallyComplete(){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if( ($null -ne $this.MasterFilePath) -and (Test-Path $this.MasterFilePath)){ $batchStatus = Get-Content $this.MasterFilePath | ConvertFrom-Json if($batchStatus.Skip -gt 0 -and [string]::IsNullOrEmpty($batchStatus.ReleaseNextContinuationToken) -and $batchStatus.BatchScanState -eq [BatchScanState]::COMP) { return $true; } if($batchStatus.Skip -gt 0 -and [string]::IsNullOrEmpty($batchStatus.BuildNextContinuationToken) -and $batchStatus.BatchScanState -eq [BatchScanState]::COMP) { return $true; } if($batchStatus.Skip -gt 0 -and [string]::IsNullOrEmpty($batchStatus.ReleaseNextContinuationToken) -and [string]::IsNullOrEmpty($batchStatus.ReleaseCurrentContinuationToken)) { return $true; } if($batchStatus.Skip -gt 0 -and [string]::IsNullOrEmpty($batchStatus.BuildNextContinuationToken) -and [string]::IsNullOrEmpty($batchStatus.BuildCurrentContinuationToken)) { return $true; } } } return $false; } hidden static [PSObject] GetBaseFrameworkPath() { $moduleName = $([Constants]::AzSKModuleName) #Remove Staging from module name before forming config base path $moduleName = $moduleName -replace "Staging", "" #Irrespective of whether Dev-Test mode is on or off, base framework path will now remain same as the new source code repo doesn't have AzSK.Framework folder. $basePath = (Get-Item $PSScriptRoot).Parent.FullName return $basePath } hidden static [PSObject] LoadFrameworkConfigFile([string] $fileName, [bool] $parseJson) { #Load file from AzSK App folder" $fileName = $fileName.Split('\')[-1] $extension = [System.IO.Path]::GetExtension($fileName); $basePath = [BatchScanManager]::GetBaseFrameworkPath() $rootConfigPath = $basePath | Join-Path -ChildPath "Configurations"; $filePath = (Get-ChildItem $rootConfigPath -Name -Recurse -Include $fileName) | Select-Object -First 1 if ($filePath) { if ($parseJson) { if ($extension -eq ".json" -or $extension -eq ".lawsview") { $fileContent = (Get-Content -Raw -Path (Join-Path $rootConfigPath $filePath)) | ConvertFrom-Json } else { $fileContent = (Get-Content -Raw -Path (Join-Path $rootConfigPath $filePath)) } } else { $fileContent = (Get-Content -Raw -Path (Join-Path $rootConfigPath $filePath)) } } else { throw "Unable to find the specified file '$fileName'" } if (-not $fileContent) { throw "The specified file '$fileName' is empty" } return $fileContent; } [void] UpdateBatchMasterList(){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(Test-Path $this.MasterFilePath){ $batchStatus = Get-Content $this.MasterFilePath | ConvertFrom-Json $isReleaseScan=$false; $isBuildScan=$false; if($batchStatus.PSobject.Properties.name -match "ReleaseCurrentContinuationToken") { $isReleaseScan=$true; } if($batchStatus.PSobject.Properties.name -match "BuildCurrentContinuationToken") { $isBuildScan=$true; } if($batchStatus.BatchScanState -eq [BatchScanState]:: INIT ){ if($batchStatus.Skip -eq 0){ if($isReleaseScan) { $batchStatus.ReleaseCurrentContinuationToken=$null; } if($isBuildScan) { $batchStatus.BuildCurrentContinuationToken=$null; } Write-Host "Found a previous batch scan with no scanned resources. Continuing the scan from start `n " -ForegroundColor Green } else { #anyone of the resource has been completely scanned need to make batch size double again if($PSCmdlet.MyInvocation.BoundParameters.ResourceTypeName -eq 'Build_Release' -and $this.isPreviousScanPartiallyComplete() ){ if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("BatchSize")){ $this.BatchSize = $PSCmdlet.MyInvocation.BoundParameters["BatchSize"] } else { $this.BatchSize = $this.ControlSettings.BatchScan.BatchTrackerUpdateFrequency } if($this.BatchSize%2 -ne 0){ $this.BatchSize=$this.BatchSize-1 } } Write-Host "Found a previous batch scan in progress with $($batchStatus.ResourceCount) resources scanned. Resuming the scan from last batch. `n " -ForegroundColor Green if($this.CheckContTokenValidity($batchStatus.TokenLastModifiedTime)){ return; } else { #find the updated token if($isBuildScan -and $batchStatus.Skip -ne 0 -and (-not [string]::IsNullOrEmpty($batchStatus.BuildCurrentContinuationToken))){ $batchStatus.BuildCurrentContinuationToken=$this.GetUpdatedContToken($batchStatus.Skip,$batchStatus.Top,'Build'); } if($isReleaseScan -and $batchStatus.Skip -ne 0 -and (-not [string]::IsNullOrEmpty($batchStatus.ReleaseCurrentContinuationToken))){ $batchStatus.ReleaseCurrentContinuationToken=$this.GetUpdatedContToken($batchStatus.Skip,$batchStatus.Top,'Release'); } $batchStatus.TokenLastModifiedTime=[DateTime]::UtcNow; } } } else { #anyone of the resource has been completely scanned need to make batch size double again if($PSCmdlet.MyInvocation.BoundParameters.ResourceTypeName -eq 'Build_Release' -and $this.isPreviousScanPartiallyComplete() ){ if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("BatchSize")){ $this.BatchSize = $PSCmdlet.MyInvocation.BoundParameters["BatchSize"] } else { $this.BatchSize = $this.ControlSettings.BatchScan.BatchTrackerUpdateFrequency } if($this.BatchSize%2 -ne 0){ $this.BatchSize=$this.BatchSize-1 } } Write-Host "Found a previous batch scan with $($batchStatus.ResourceCount) resources scanned. Starting fresh scan for the next batch. `n " -ForegroundColor Green #anyone of the resource has been completely scanned need to update skip by original batch size. However for the first time skip should only be updated by half if($PSCmdlet.MyInvocation.BoundParameters.ResourceTypeName -eq 'Build_Release' -and $batchStatus.SkipMarker -eq "False" -and $this.isPreviousScanPartiallyComplete() ){ $batchStatus.Skip=$batchStatus.Skip + ($this.GetBatchSize()/2); $batchStatus.SkipMarker = "True" } else { $batchStatus.Skip+=$this.GetBatchSize(); } $batchStatus.BatchScanState=[BatchScanState]::INIT if($this.CheckContTokenValidity($batchStatus.TokenLastModifiedTime)){ if($isReleaseScan) { $batchStatus.ReleaseCurrentContinuationToken=$batchStatus.ReleaseNextContinuationToken } if($isBuildScan){ $batchStatus.BuildCurrentContinuationToken=$batchStatus.BuildNextContinuationToken } } else { #find the updated token if($isBuildScan -and $batchStatus.Skip -ne 0 -and (-not [string]::IsNullOrEmpty($batchStatus.BuildNextContinuationToken))){ $batchStatus.BuildCurrentContinuationToken=$this.GetUpdatedContToken($batchStatus.Skip,$batchStatus.Top,'Build'); } if($isReleaseScan -and $batchStatus.Skip -ne 0 -and (-not [string]::IsNullOrEmpty($batchStatus.ReleaseNextContinuationToken))){ $batchStatus.ReleaseCurrentContinuationToken=$this.GetUpdatedContToken($batchStatus.Skip,$batchStatus.Top,'Release'); } #in case builds have been completely scanned, i.e end of builds if($isBuildScan -and $batchStatus.Skip -ne 0 -and [string]::IsNullOrEmpty($batchStatus.BuildNextContinuationToken)){ $batchStatus.BuildCurrentContinuationToken=$batchStatus.BuildNextContinuationToken } #in case releases have been completely scanned, i.e end of releases if($isReleaseScan -and $batchStatus.Skip -ne 0 -and [string]::IsNullOrEmpty($batchStatus.ReleaseNextContinuationToken)){ $batchStatus.ReleaseCurrentContinuationToken=$batchStatus.ReleaseNextContinuationToken } $batchStatus.TokenLastModifiedTime=[DateTime]::UtcNow; } } $this.BatchScanTrackerObj=$batchStatus; $this.WriteToBatchTrackerFile(); } } } hidden [bool] CheckContTokenValidity([DateTime] $lastModifiedTime){ if($lastModifiedTime.AddHours([INT32]::Parse(15)) -lt [DateTime]::UtcNow){ return $false } return $true; } [string] GetSkip(){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(Test-Path $this.MasterFilePath){ $batchStatus = Get-Content $this.MasterFilePath | ConvertFrom-Json return $batchStatus.Skip; } } return $null; } [string] GetTop(){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(Test-Path $this.MasterFilePath){ $batchStatus = Get-Content $this.MasterFilePath | ConvertFrom-Json return $batchStatus.Top; } } return $null; } [string] GetBuildContinuationToken(){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(Test-Path $this.MasterFilePath){ $batchStatus = Get-Content $this.MasterFilePath | ConvertFrom-Json return $batchStatus.BuildNextContinuationToken; } } return $null; } [string] GetReleaseContinuationToken(){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(Test-Path $this.MasterFilePath){ $batchStatus = Get-Content $this.MasterFilePath | ConvertFrom-Json return $batchStatus.ReleaseNextContinuationToken; } } return $null; } [BatchScanState] GetBatchScanState(){ if(![string]::isnullorwhitespace($this.OrgName) -and ![string]::isnullorwhitespace($this.ProjectName)){ if(Test-Path $this.MasterFilePath){ $batchStatus = Get-Content $this.MasterFilePath | ConvertFrom-Json return $batchStatus.BatchScanState; } } return $null; } [string] GetUpdatedContToken([int] $skip, [string] $top, [string] $resourceType){ $tempSkip=0; if($PSCmdlet.MyInvocation.BoundParameters.ResourceTypeName -eq 'Build_Release' -and $this.isPreviousScanPartiallyComplete() ){ $topNQueryString = '&$top={0}' -f ($this.GetBatchSize()/2); } else { $topNQueryString = '&$top={0}' -f $this.GetBatchSize(); } if($resourceType -eq 'Build'){ $resourceDefnURL = ("https://dev.azure.com/{0}/{1}/_apis/build/definitions?queryOrder=lastModifiedDescending&api-version=6.0" +$topNQueryString) -f $this.OrgName, $this.ProjectName; } else { $resourceDefnURL = ("https://vsrm.dev.azure.com/{0}/{1}/_apis/release/definitions?api-version=6.0" +$topNQueryString) -f $this.OrgName, $this.ProjectName; } $continuationToken=$null; $originalUri=$resourceDefnURL; $validationUrl=$null; while($tempSkip -lt $skip){ $validationUrl=$originalUri; $originalUri=$resourceDefnURL; if($PSCmdlet.MyInvocation.BoundParameters.ResourceTypeName -eq 'Build_Release' -and $this.isPreviousScanPartiallyComplete() ){ $tempSkip+=($this.GetBatchSize()/2); } else { $tempSkip+=$this.GetBatchSize(); } $updatedUriAndContToken=[WebRequestHelper]:: InvokeWebRequestForContinuationToken($validationUrl,$originalUri,$tempSkip,$resourceType); $continuationToken=$updatedUriAndContToken[0]; $originalUri=$updatedUriAndContToken[1]; } return $continuationToken; } } # SIG # Begin signature block # MIIjlAYJKoZIhvcNAQcCoIIjhTCCI4ECAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCA48+I1BaqU55ZT # 6UqOZguWwejivC3Dj0pZy2CNgvl/fqCCDYEwggX/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/BvW1taslScxMNelDNMYIVaTCCFWUCAQEwgZUwfjELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z # b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAd9r8C6Sp0q00AAAAAAB3zAN # BglghkgBZQMEAgEFAKCBsDAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor # BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgPmzWbKDf # VZOBUbFBwYbyj/5e1WB8LV0wFwAz335DAKcwRAYKKwYBBAGCNwIBDDE2MDSgFIAS # AE0AaQBjAHIAbwBzAG8AZgB0oRyAGmh0dHBzOi8vd3d3Lm1pY3Jvc29mdC5jb20g # MA0GCSqGSIb3DQEBAQUABIIBAKCXIReEnC43fr0VlwwP0kgT/2ezaygHDKoXnuoT # 93au04OBddNUXr8LyRvPMKmiV0u9dW0wCf2s2fhsmQYau5ampswLZ4UWc7eVmZ0/ # 6cNkNJuBl3T20OpW4M+9pVVnjrIVtt+1hO7JODtNeyG9itzJFS6+3fJ5nPo0k3Wx # SvOO3vYhDKJaec1k0fyFqRVETdDwXKWiffPnaiIZF1WS84km96GAfT8uNvMSwzzx # hVVBHhp4uyvcT4fF02jz8zRfqVd+MOrfRDXW14SHDvz1ZmXiGFXOvM0ka5pMOyuz # E/hN+X7K8W9JUTZ/2DrwczY+bi3u7pVPefJvvXuNZQDNwa2hghLxMIIS7QYKKwYB # BAGCNwMDATGCEt0wghLZBgkqhkiG9w0BBwKgghLKMIISxgIBAzEPMA0GCWCGSAFl # AwQCAQUAMIIBVQYLKoZIhvcNAQkQAQSgggFEBIIBQDCCATwCAQEGCisGAQQBhFkK # AwEwMTANBglghkgBZQMEAgEFAAQggQrkab6hcHvviotf0ncbUFr5h4uy9OZZpUMc # 1162YSUCBmD69peBMRgTMjAyMTA4MTMwOTA4MjIuNTY0WjAEgAIB9KCB1KSB0TCB # zjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEpMCcGA1UECxMg # TWljcm9zb2Z0IE9wZXJhdGlvbnMgUHVlcnRvIFJpY28xJjAkBgNVBAsTHVRoYWxl # cyBUU1MgRVNOOjREMkYtRTNERC1CRUVGMSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt # ZS1TdGFtcCBTZXJ2aWNloIIORDCCBPUwggPdoAMCAQICEzMAAAFfw65lVuVTWOwA # AAAAAV8wDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh # c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD # b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw # MTAwHhcNMjEwMTE0MTkwMjE5WhcNMjIwNDExMTkwMjE5WjCBzjELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEpMCcGA1UECxMgTWljcm9zb2Z0IE9w # ZXJhdGlvbnMgUHVlcnRvIFJpY28xJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOjRE # MkYtRTNERC1CRUVGMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2 # aWNlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvD15+YLZZD25prDu # TiDEdJIISgkuTbYVMBoXyNhsAyRALoNAXRY+ciF4szURFO5D0VZuCV/SZdsN3YqN # 7NE2XPnfJwkhF6IZRA6fDm93hOCMtTEvXuDcrQw/ac2Fj8vI/3wyX/jRf3Tl6ANu # Iid1l20eINvXF9jXtru/WP2jea5z4wKAW31875TgIM1SkwwxAkWv/1CVThh0lrCN # vIp8rcu2+p+reW+ArT8emGIO1flyHdt4Y0EqjApJNeF+3ynC5dA+ui61aAHk9mYA # 3xdmEAKjiNaL9rTOAAklwGqhe9LoietZwf8SqL+pVqPxWznr9n/qRphlm7/WZLMu # fkQAswIDAQABo4IBGzCCARcwHQYDVR0OBBYEFCXs6dOVzSuBnsV3uqUMWC5hNTj1 # MB8GA1UdIwQYMBaAFNVjOlyKMZDzQ3t8RhvFM2hahW1VMFYGA1UdHwRPME0wS6BJ # oEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01p # Y1RpbVN0YVBDQV8yMDEwLTA3LTAxLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYB # BQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljVGlt # U3RhUENBXzIwMTAtMDctMDEuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYI # KwYBBQUHAwgwDQYJKoZIhvcNAQELBQADggEBAA6C19kslhJuwTdbved3SEuepCod # IWXaykfHN5fEzi4lPa4BWT9ItXPOO9l6ZQMF4550p5cbyFy2mumhAylTeBuw1SdR # oN6wNyZH54QsLBhr5UGRQKqwgYmZCUPC4PA1rruTIIQ/I9bn1i7bD92M2vA1ZKO2 # 5HB9QWgOSNjIOOdcPSOiyLrurEmBbytGqOX1rraEbOXOAT5pUtNPkiErnPZfrYum # HyP1/heO0I+fJ4UoWaAFYc9jUdtuNQd+D3VK0IvG54fYuNmhARNY4n6nESWJxfBU # /kHTCVaSJq7C6DetMqcNvlYpRvaWWydCBp6BX4xCMwjsrq/6ym+wyBGM+WEwggZx # MIIEWaADAgECAgphCYEqAAAAAAACMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQG # EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG # A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQg # Um9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0xMDA3MDEyMTM2NTVa # Fw0yNTA3MDEyMTQ2NTVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n # dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y # YXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIIB # IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqR0NvHcRijog7PwTl/X6f2mU # a3RUENWlCgCChfvtfGhLLF/Fw+Vhwna3PmYrW/AVUycEMR9BGxqVHc4JE458YTBZ # sTBED/FgiIRUQwzXTbg4CLNC3ZOs1nMwVyaCo0UN0Or1R4HNvyRgMlhgRvJYR4Yy # hB50YWeRX4FUsc+TTJLBxKZd0WETbijGGvmGgLvfYfxGwScdJGcSchohiq9LZIlQ # YrFd/XcfPfBXday9ikJNQFHRD5wGPmd/9WbAA5ZEfu/QS/1u5ZrKsajyeioKMfDa # TgaRtogINeh4HLDpmc085y9Euqf03GS9pAHBIAmTeM38vMDJRF1eFpwBBU8iTQID # AQABo4IB5jCCAeIwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFNVjOlyKMZDz # Q3t8RhvFM2hahW1VMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQE # AwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQ # W9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNv # bS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBa # BggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0 # LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MIGgBgNV # HSABAf8EgZUwgZIwgY8GCSsGAQQBgjcuAzCBgTA9BggrBgEFBQcCARYxaHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL1BLSS9kb2NzL0NQUy9kZWZhdWx0Lmh0bTBABggr # BgEFBQcCAjA0HjIgHQBMAGUAZwBhAGwAXwBQAG8AbABpAGMAeQBfAFMAdABhAHQA # ZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEAB+aIUQ3ixuCYP4FxAz2d # o6Ehb7Prpsz1Mb7PBeKp/vpXbRkws8LFZslq3/Xn8Hi9x6ieJeP5vO1rVFcIK1GC # RBL7uVOMzPRgEop2zEBAQZvcXBf/XPleFzWYJFZLdO9CEMivv3/Gf/I3fVo/HPKZ # eUqRUgCvOA8X9S95gWXZqbVr5MfO9sp6AG9LMEQkIjzP7QOllo9ZKby2/QThcJ8y # Sif9Va8v/rbljjO7Yl+a21dA6fHOmWaQjP9qYn/dxUoLkSbiOewZSnFjnXshbcOc # o6I8+n99lmqQeKZt0uGc+R38ONiU9MalCpaGpL2eGq4EQoO4tYCbIjggtSXlZOz3 # 9L9+Y1klD3ouOVd2onGqBooPiRa6YacRy5rYDkeagMXQzafQ732D8OE7cQnfXXSY # Ighh2rBQHm+98eEA3+cxB6STOvdlR3jo+KhIq/fecn5ha293qYHLpwmsObvsxsvY # grRyzR30uIUBHoD7G4kqVDmyW9rIDVWZeodzOwjmmC3qjeAzLhIp9cAvVCch98is # TtoouLGp25ayp0Kiyc8ZQU3ghvkqmqMRZjDTu3QyS99je/WZii8bxyGvWbWu3EQ8 # l1Bx16HSxVXjad5XwdHeMMD9zOZN+w2/XU/pnR4ZOC+8z1gFLu8NoFA12u8JJxzV # s341Hgi62jbb01+P3nSISRKhggLSMIICOwIBATCB/KGB1KSB0TCBzjELMAkGA1UE # BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc # BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEpMCcGA1UECxMgTWljcm9zb2Z0 # IE9wZXJhdGlvbnMgUHVlcnRvIFJpY28xJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO # OjREMkYtRTNERC1CRUVGMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT # ZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQD6B9KqN0Cd04URpc5DIEJ26mZCh6CBgzCB # gKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH # EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV # BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBBQUA # AgUA5MB7BDAiGA8yMDIxMDgxMzA5MDA1MloYDzIwMjEwODE0MDkwMDUyWjB3MD0G # CisGAQQBhFkKBAExLzAtMAoCBQDkwHsEAgEAMAoCAQACAiJgAgH/MAcCAQACAhFi # MAoCBQDkwcyEAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAI # AgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQEFBQADgYEAcPhVBpNVxcFG # HmpvWiaMj+ZlDEk0SpcCU8LMiGB3ATx1Vc0GoucPzKv7lvXhWUuuEknH2LPTNEvI # lY08rsJ/Q2BC3+gFx1bhvslil3FNv4zJGU2mNpnsqhElEp3fbAXFL+83RuDV5dS4 # lQ/boc5X+pplmLgPj66obaB9Doxn+IkxggMNMIIDCQIBATCBkzB8MQswCQYDVQQG # EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG # A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQg # VGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAV/DrmVW5VNY7AAAAAABXzANBglghkgB # ZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3 # DQEJBDEiBCDt+VTjhOOK+IETE/svdM8K+cCud1QmCalJLcSuDBY1YTCB+gYLKoZI # hvcNAQkQAi8xgeowgecwgeQwgb0EINDNerUrEawu6PSzOS2ueWEhGqZvCnltUZzo # G7qGCUxcMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0 # b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh # dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMA # AAFfw65lVuVTWOwAAAAAAV8wIgQgU1bnMiWaI/hNt3n6P4qRfu48R3mIW6BcwyzB # NbyD1mwwDQYJKoZIhvcNAQELBQAEggEAMLIjudgwdxM9DHafboOtJNlmyMyv26nK # rxyu+3qZnmI9L6OJ+NBgo+/G/TguFznlWoh1Gl9n+lJq2hSBk4Jmu1WstfAKEtEJ # grXh0SpJc/HSvA208I8FHTo2ysikM3BDGrhnFNlj6RnpkgI1bxVzZEWAokkeT8Ep # 616BDj6B2kGXWeaGPZ95uk71a4jxhOwbhwccTUQkcYN6fdtjErHDVabjgUPZMxVo # 4Qng2ssrL5vzpnqSxJ6cDRhLhPmdCa0d1Df0aprMYg+UjbKWDYPjy0Ur1CX3+dfa # 66S0MLZtdQXa+k4OWUVBorGrRGXRxP2sN9k2NId08DomkCZ2D+8DAg== # SIG # End signature block |