AzSKPreview.ADO

1.24.0

Framework/BugLog/AzSKADOAutoBugLogging.ps1

                                using namespace System.Management.Automation

Set-StrictMode -Version Latest 

class AzSKADOAutoBugLogging : CommandBase

{    

    [string] $OrgName

    [string] $BugLogProjectName

    $ScanResult = @();

    $ScanResultToCloseBug = @();

    hidden [InvocationInfo] $InvocationContext;

    hidden [bool] $IsLAFile = $false;

    $ResourceControlJson = @();

    $BugTemplate = $null;

    $STMappingFilePath = $null;

    $BugDescription = $null;

    [int] $MaxBugsToLog;

    AzSKADOAutoBugLogging([string] $organizationName, $BugLogProject, $AutoBugLog, $ResourceTypeName, $ControlIds, $scanResultData, $BugTemplate, [InvocationInfo] $invocationContext, $isLAFile, $stMappingFilePath, $BugDescription, $MaxBugLog): 

        Base($organizationName, $invocationContext) 

    { 

        $this.OrgName = $organizationName;

        $this.BugLogProjectName = $BugLogProject;

        $this.IsLAFile = $isLAFile;

        $this.BugTemplate = $BugTemplate;

        $this.STMappingFilePath = $stMappingFilePath;

        $this.BugDescription = $BugDescription;

        $this.MaxBugsToLog = $MaxBugLog

        #Can remove later if not needed.

        $resourcetypes = @()

        if($ResourceTypeName -ne [ResourceTypeName]::All)

        {

            $resourcetypes += ([SVTMapping]::AzSKADOResourceMapping |

                    Where-Object { $_.ResourceTypeName -eq $ResourceTypeName } | Select-Object JsonFileName, ResourceTypeName)

        }

        else

        {

            $resourcetypes += ([SVTMapping]::AzSKADOResourceMapping | Sort-Object ResourceTypeName | Select-Object JsonFileName, ResourceTypeName)

        }

        $resourcetypes = $resourcetypes | Sort-Object -Property JsonFileName -Unique

        foreach ($item in $resourcetypes) {

            $this.ResourceControlJson += [ConfigurationManager]::LoadServerConfigFile("$($item.JsonFileName)").Controls;

        }

        $this.GetAndFilterScanResultData($AutoBugLog, $ResourceTypeName, $ControlIds, $scanResultData, $isLAFile, $false);

    }

    AzSKADOAutoBugLogging([string] $organizationName, $BugLogProject, $ResourceTypeName, $ControlIds, $scanResultData, [InvocationInfo] $invocationContext, $isLAFile, $MaxBugLog): 

        Base($organizationName, $invocationContext) 

    { 

        $this.OrgName = $organizationName;

        $this.BugLogProjectName = $BugLogProject;

        $this.IsLAFile = $isLAFile;

        $this.MaxBugsToLog = $MaxBugLog

        #Can remove later if not needed.

        $resourcetypes = @()

        if($ResourceTypeName -ne [ResourceTypeName]::All)

        {

            $resourcetypes += ([SVTMapping]::AzSKADOResourceMapping |

                    Where-Object { $_.ResourceTypeName -eq $ResourceTypeName } | Select-Object JsonFileName, ResourceTypeName)

        }

        else

        {

            $resourcetypes += ([SVTMapping]::AzSKADOResourceMapping | Sort-Object ResourceTypeName | Select-Object JsonFileName, ResourceTypeName)

        }

        $resourcetypes = $resourcetypes | Sort-Object -Property JsonFileName -Unique

        foreach ($item in $resourcetypes) {

            $this.ResourceControlJson += [ConfigurationManager]::LoadServerConfigFile("$($item.JsonFileName)").Controls;

        }

        $this.GetAndFilterScanResultData($null, $ResourceTypeName, $ControlIds, $scanResultData, $isLAFile, $true);

    }

    [SVTEventContext[]] StartBugLogging()

    {

        return $this.InitiateBugLogging($false);

    }

    [SVTEventContext[]] ClosingLoggedBugs()

    {

        return $this.InitiateBugLogging($true);

    }

    hidden [SVTEventContext[]] InitiateBugLogging($isCloseBug) {  

        [ResourceContext] $ResourceContext = $null;

        [SVTEventContext[]] $ResourceContextControlResult = $null;

        $resourcesToLogBugs = @($this.ScanResult | Group-Object -Property ResourceId);

        if ($isCloseBug) {

            $this.PublishCustomMessage("`nNumber of resources for which bug clossing will be evaluated: $($resourcesToLogBugs.count)",[MessageType]::Info);

        }

        else {

            $this.PublishCustomMessage("`nNumber of resources for which bug logging will be evaluated: $($resourcesToLogBugs.count)",[MessageType]::Info);

        }

        foreach ($controlResult in $resourcesToLogBugs) {

            if ($this.IsLAFile) {

                $ResourceContext = [ResourceContext]@{

                    ResourceGroupName = $controlResult.Group[0].ResourceGroup;

                    ResourceName = $controlResult.Group[0].ResourceName_s;

                    ResourceType = "ADO."+$controlResult.Group[0].FeatureName_s;

                    ResourceTypeName = $controlResult.Group[0].FeatureName_s;

                    ResourceId = $controlResult.Group[0].ResourceId

                    ResourceDetails = @{ResourceLink = $controlResult.Group[0].ResourceLink_s}

                };    

            }

            else {

                $ResourceContext = [ResourceContext]@{

                    ResourceGroupName = $controlResult.Group[0].ResourceGroupName;

                    ResourceName = $controlResult.Group[0].ResourceName;

                    ResourceType = "ADO."+$controlResult.Group[0].FeatureName;

                    ResourceTypeName = $controlResult.Group[0].FeatureName;

                    ResourceId = $controlResult.Group[0].ResourceId

                    ResourceDetails = @{ResourceLink = $controlResult.Group[0].ResourceLink}

                };

            }

            $ResourceContextControlResult += $this.CreateResultContextObject($ResourceContext, $controlResult.Group);

        }

        return $this.BugLoggingEvaluation($ResourceContextControlResult, $isCloseBug);

    }

    #function to call AutoBugLog class for performing bug logging

    hidden [SVTEventContext []] BugLoggingEvaluation([SVTEventContext []] $ControlResults, $isCloseBug)

    {

        $AutoBugLog = $null;

        if (!$isCloseBug) {

            $AutoBugLog = [AutoBugLog]::AutoBugInstance

            if (!$AutoBugLog) {

                [BugLogPathManager]::checkValidPathFlag = $true;

                $BugLogParameterValue = $this.InvocationContext.BoundParameters["AutoBugLog"];

                $AutoBugLog = [AutoBugLog]::GetInstance($this.OrgName, $this.InvocationContext, $null, $BugLogParameterValue);

            }

            $resourcename = "";

            $resourceid = "";

            $assignee = "";

            #$ControlResults = $ControlResults | sort-object -property @{e={$_.ResourceContext.ResourceName}}

            foreach ($controlResult in $ControlResults) {

                #if different resource then only display message.

                if ($resourceid -ne $controlResult.ResourceContext.ResourceId ) {

                    $this.PublishCustomMessage([Constants]::DoubleDashLine, [MessageType]::Info);

                    $this.PublishCustomMessage("Running bug logging: [FeatureName: $($controlResult.FeatureName)] [ParentGroupName: $($controlResult.ResourceContext.ResourceGroupName)] [ResourceName: $($controlResult.ResourceContext.ResourceName)]", [MessageType]::Info);                

                }

                $resourcename = $controlResult.ResourceContext.ResourceName

                #if different resource then black assignee as for different resource assigneed need to evaluate again.

                if($resourceid -ne $controlResult.ResourceContext.ResourceId){

                    $assignee = "";

                }

                #if resource alredy ran bug logging for control and servicetree info is not find, then dont run bug logging for next control.

                if (($resourceid -ne $controlResult.ResourceContext.ResourceId) -or ($assignee) -or ($controlResult.FeatureName -eq "Organization" -or $controlResult.FeatureName -eq "Project")) {

                    $assignee = $AutoBugLog.LogBugsInADOFromCSV($controlResult, $this.BugLogProjectName, $this.BugTemplate, $this.STMappingFilePath, $this.BugDescription, $assignee)  

                }

                $resourceid = $controlResult.ResourceContext.ResourceId

            }

        }

        else {

            $this.PublishCustomMessage([Constants]::DoubleDashLine, [MessageType]::Info);

            $this.PublishCustomMessage("Closing bugs in bulk mode...", [MessageType]::Info);

            #$AutoClose = [AutoCloseBugManager]::new($this.OrganizationContext.OrganizationName);

            #$AutoClose.AutoCloseBugCSV($ControlResults)

        }

        $this.PublishCustomMessage([Constants]::DoubleDashLine, [MessageType]::Info);

        $this.PublishCustomMessage("Bug logging has been completed.", [MessageType]::Info);

        $this.PublishCustomMessage([Constants]::DoubleDashLine, [MessageType]::Info);

        return $ControlResults;

    }

    hidden [bool] GetAndFilterScanResultData($AutoBugLog, $ResourceTypeName, $ControlIds, $scanResultData, $isLAFile, $AutoCloseBug)

    {

        try {

            $this.PublishCustomMessage("`nFiltering scan result data.....",[MessageType]::Info);

            if (!$isLAFile) {

                if ($ResourceTypeName) {

                    $scanResultData = $scanResultData | Where { $_.FeatureName -eq $ResourceTypeName }

                }

                if ($AutoBugLog -eq "BaseLineControls" -and $scanResultData) {

                    $scanResultData = $scanResultData | Where { $_.IsBaselineControl -eq "Yes" }

                }

                if ($ControlIds -and $scanResultData) {

                    $cids = $this.ConvertToStringArray($ControlIds);

                    $scanResultData = $scanResultData | Where { $_.ControlId -In $cids }

                }

                if ($scanResultData -and $AutoBugLog -ne $null) {

                    $scanResultData = $scanResultData | Where {$_.Status -eq "Failed" -or $_.Status -eq "Varify"} 

                }

                if ($AutoCloseBug) {

                    $scanResultData = $scanResultData | Where {$_.Status -eq "Passed"} 

                }

                if ($scanResultData -and $this.MaxBugsToLog -and ($scanResultData.count -gt $this.MaxBugsToLog)) {

                    $scanResultData = $scanResultData[0..($this.MaxBugsToLog - 1)];

                }

                $this.ScanResult += $scanResultData;   

            }

            else {

                if ($ResourceTypeName) {

                    $scanResultData = $scanResultData | Where { $_.FeatureName_s -eq $ResourceTypeName }

                }

                if ($AutoBugLog -eq "BaseLineControls" -and $scanResultData) {

                    $scanResultData = $scanResultData | Where { $_.IsBaselineControl_b -eq "TRUE" }

                    Write-Host 'Can not read IsBaselineControl_b data from csv.' -ForegroundColor Yellow

                }

                if ($ControlIds -and $scanResultData) {

                    $cids = $this.ConvertToStringArray($ControlIds);

                    $scanResultData = $scanResultData | Where { $_.ControlId_s -In $cids }

                }

                if ($scanResultData -and $AutoBugLog -ne $null) {

                    $scanResultData = $scanResultData | Where {$_.ControlStatus_s -eq "Failed" -or $_.ControlStatus_s -eq "Verify"}

                }

                if ($AutoCloseBug) {

                    $scanResultData = $scanResultData | Where {$_.ControlStatus_s -eq "Passed"}

                }

                if ($scanResultData -and $this.MaxBugsToLog -and ($scanResultData.count -gt $this.MaxBugsToLog)) {

                    $scanResultData = $scanResultData[0..($this.MaxBugsToLog - 1)];

                }

                $this.ScanResult += $scanResultData;

            }

            return $true;   

        }

        catch {

            return $false;

        }

    }

    hidden [SVTEventContext[]] CreateResultContextObject($ResourceContext, $controlResult)

    {

        [SVTEventContext[]] $ResourceContextControlResult = @();

        [ControlResult[]] $controlResults = @();

        [ControlItem[]] $controlResults = @();

        foreach ($item in $controlResult) {

            $CtrlItm = [ControlItem]::new();

            if ($this.IsLAFile) 

            {

                $currentControlJson = $this.ResourceControlJson | Where {$_.ControlId -eq $item.ControlID_s}

                $CtrlItm.ID = $currentControlJson.ID

                $CtrlItm.ControlID = $item.ControlID_s

                $CtrlItm.ControlSeverity = $item.ControlSeverity_s

                #$CtrlItm.IsBaselineControl = $item.IsBaselineControl

                $CtrlItm.Description = $currentControlJson.Description 

                $CtrlItm.Recommendation = $currentControlJson.Recommendation

                $CtrlItm.Rationale = $currentControlJson.Rationale

                $CtrlResult = [ControlResult]::new();

                $CtrlResult.VerificationResult = $item.ControlStatus_s

                #$CtrlResult.ActualVerificationResult = $item.ActualVerificationResult_s

                $CtrlResult.AdditionalInfoInCSV = $item.AdditionalInfo_s

            }

            else {

                $currentControlJson = $this.ResourceControlJson | Where {$_.ControlId -eq $item.ControlID}

                $CtrlItm.ID = $currentControlJson.ID

                $CtrlItm.ControlID = $item.ControlID

                $CtrlItm.ControlSeverity = $item.ControlSeverity

                $CtrlItm.IsBaselineControl = $item.IsBaselineControl

                $CtrlItm.Description = $item.Description

                $CtrlItm.Recommendation = $item.Recommendation

                $CtrlItm.Rationale = $item.Rationale

                $CtrlResult = [ControlResult]::new();

                $CtrlResult.VerificationResult = $item.Status

                #$CtrlResult.ActualVerificationResult = $item.ActualStatus

                $CtrlResult.AdditionalInfoInCSV = $item.AdditionalInfo

            }

            $svtControlResult = [SVTEventContext]@{

                FeatureName = $ResourceContext[0].ResourceTypeName 

                Metadata = [Metadata]@{

                    Reference = "";

                };

                OrganizationContext = $this.OrganizationContext;

                ResourceContext = $ResourceContext;

                ControlResults = $CtrlResult;

                ControlItem = $CtrlItm;

            };

            $ResourceContextControlResult += $svtControlResult;

        }

        return $ResourceContextControlResult;

    }

}

# SIG # Begin signature block

# MIIoPAYJKoZIhvcNAQcCoIIoLTCCKCkCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDnkvDsQZ6nMzDl

# tf5aAOaFN6GETNjQx1YZ2gtUaxkMUaCCDYUwggYDMIID66ADAgECAhMzAAADri01

# UchTj1UdAAAAAAOuMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwODU5WhcNMjQxMTE0MTkwODU5WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQD0IPymNjfDEKg+YyE6SjDvJwKW1+pieqTjAY0CnOHZ1Nj5irGjNZPMlQ4HfxXG

# yAVCZcEWE4x2sZgam872R1s0+TAelOtbqFmoW4suJHAYoTHhkznNVKpscm5fZ899

# QnReZv5WtWwbD8HAFXbPPStW2JKCqPcZ54Y6wbuWV9bKtKPImqbkMcTejTgEAj82

# 6GQc6/Th66Koka8cUIvz59e/IP04DGrh9wkq2jIFvQ8EDegw1B4KyJTIs76+hmpV

# M5SwBZjRs3liOQrierkNVo11WuujB3kBf2CbPoP9MlOyyezqkMIbTRj4OHeKlamd

# WaSFhwHLJRIQpfc8sLwOSIBBAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhx/vdKmXhwc4WiWXbsf0I53h8T8w

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMTgzNjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AGrJYDUS7s8o0yNprGXRXuAnRcHKxSjFmW4wclcUTYsQZkhnbMwthWM6cAYb/h2W

# 5GNKtlmj/y/CThe3y/o0EH2h+jwfU/9eJ0fK1ZO/2WD0xi777qU+a7l8KjMPdwjY

# 0tk9bYEGEZfYPRHy1AGPQVuZlG4i5ymJDsMrcIcqV8pxzsw/yk/O4y/nlOjHz4oV

# APU0br5t9tgD8E08GSDi3I6H57Ftod9w26h0MlQiOr10Xqhr5iPLS7SlQwj8HW37

# ybqsmjQpKhmWul6xiXSNGGm36GarHy4Q1egYlxhlUnk3ZKSr3QtWIo1GGL03hT57

# xzjL25fKiZQX/q+II8nuG5M0Qmjvl6Egltr4hZ3e3FQRzRHfLoNPq3ELpxbWdH8t

# Nuj0j/x9Crnfwbki8n57mJKI5JVWRWTSLmbTcDDLkTZlJLg9V1BIJwXGY3i2kR9i

# 5HsADL8YlW0gMWVSlKB1eiSlK6LmFi0rVH16dde+j5T/EaQtFz6qngN7d1lvO7uk

# 6rtX+MLKG4LDRsQgBTi6sIYiKntMjoYFHMPvI/OMUip5ljtLitVbkFGfagSqmbxK

# 7rJMhC8wiTzHanBg1Rrbff1niBbnFbbV4UDmYumjs1FIpFCazk6AADXxoKCo5TsO

# zSHqr9gHgGYQC2hMyX9MGLIpowYCURx3L7kUiGbOiMwaMIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGg0wghoJAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAOuLTVRyFOPVR0AAAAA

# A64wDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEICX+

# hHwNSaQajmRj2ppSwRtGTsJ5+3AXtlSXn1wCY8W9MEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEA11+HURh5z3A80IryWf7snc85O2k9TW6wqfMX

# /ccxBuVT6MbKfELxJWO/HyNe0E6Npd/rNGtLAyNNHKugJXAuul9H/9y5byi6k2bK

# lGsxkRshxN3zIJpjVz92O/A0HYQiqTh8LE8ojw7XKDR8HbVul5jXJpv7fPepX6YV

# Y9UtAzqICZDyb5OlWJiKQVnlBlcNLIbpmA0k29jOY/kZzkxOwQuhAkZgy9fCSHL6

# OFCX1JY/J4aadSC5B0k91nIew+Rj24d9yv1KrAK8Nyn9tBqz5/J6fgYxN0Lt+JBi

# en0bsnhBQHluPhp/hv5vdX0bQCRs9dTSbojgDZILahQVE/r+kqGCF5cwgheTBgor

# BgEEAYI3AwMBMYIXgzCCF38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCAq/GHZJUt5WiyNmPVXjfL3ZiQC4mF1fYiI

# iavz5m/AdgIGZc4G2cibGBMyMDI0MDMwNTA1Mzg1Ni43OTdaMASAAgH0oIHRpIHO

# MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL

# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk

# IFRTUyBFU046QTAwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2WgghHtMIIHIDCCBQigAwIBAgITMwAAAevgGGy1tu847QAB

# AAAB6zANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MDAeFw0yMzEyMDYxODQ1MzRaFw0yNTAzMDUxODQ1MzRaMIHLMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l

# cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046QTAwMC0w

# NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Uw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDBFWgh2lbgV3eJp01oqiaF

# BuYbNc7hSKmktvJ15NrB/DBboUow8WPOTPxbn7gcmIOGmwJkd+TyFx7KOnzrxnoB

# 3huvv91fZuUugIsKTnAvg2BU/nfN7Zzn9Kk1mpuJ27S6xUDH4odFiX51ICcKl6EG

# 4cxKgcDAinihT8xroJWVATL7p8bbfnwsc1pihZmcvIuYGnb1TY9tnpdChWr9EARu

# Co3TiRGjM2Lp4piT2lD5hnd3VaGTepNqyakpkCGV0+cK8Vu/HkIZdvy+z5EL3ojT

# dFLL5vJ9IAogWf3XAu3d7SpFaaoeix0e1q55AD94ZwDP+izqLadsBR3tzjq2RfrC

# NL+Tmi/jalRto/J6bh4fPhHETnDC78T1yfXUQdGtmJ/utI/ANxi7HV8gAPzid9TY

# jMPbYqG8y5xz+gI/SFyj+aKtHHWmKzEXPttXzAcexJ1EH7wbuiVk3sErPK9MLg1X

# b6hM5HIWA0jEAZhKEyd5hH2XMibzakbp2s2EJQWasQc4DMaF1EsQ1CzgClDYIYG6

# rUhudfI7k8L9KKCEufRbK5ldRYNAqddr/ySJfuZv3PS3+vtD6X6q1H4UOmjDKdjo

# W3qs7JRMZmH9fkFkMzb6YSzr6eX1LoYm3PrO1Jea43SYzlB3Tz84OvuVSV7NcidV

# tNqiZeWWpVjfavR+Jj/JOQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFHSeBazWVcxu

# 4qT9O5jT2B+qAerhMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8G

# A1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# Y3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBs

# BggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0

# LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUy

# MDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUH

# AwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQCDdN8voPd8C+VW

# ZP3+W87c/QbdbWK0sOt9Z4kEOWng7Kmh+WD2LnPJTJKIEaxniOct9wMgJ8yQywR8

# WHgDOvbwqdqsLUaM4NrertI6FI9rhjheaKxNNnBZzHZLDwlkL9vCEDe9Rc0dGSVd

# 5Bg3CWknV3uvVau14F55ESTWIBNaQS9Cpo2Opz3cRgAYVfaLFGbArNcRvSWvSUbe

# I2IDqRxC4xBbRiNQ+1qHXDCPn0hGsXfL+ynDZncCfszNrlgZT24XghvTzYMHcXio

# LVYo/2Hkyow6dI7uULJbKxLX8wHhsiwriXIDCnjLVsG0E5bR82QgcseEhxbU2d1R

# VHcQtkUE7W9zxZqZ6/jPmaojZgXQO33XjxOHYYVa/BXcIuu8SMzPjjAAbujwTawp

# azLBv997LRB0ZObNckJYyQQpETSflN36jW+z7R/nGyJqRZ3HtZ1lXW1f6zECAeP+

# 9dy6nmcCrVcOqbQHX7Zr8WPcghHJAADlm5ExPh5xi1tNRk+i6F2a9SpTeQnZXP50

# w+JoTxISQq7vBij2nitAsSLaVeMqoPi+NXlTUNZ2NdtbFr6Iir9ZK9ufaz3FxfvD

# Zo365vLOozmQOe/Z+pu4vY5zPmtNiVIcQnFy7JZOiZVDI5bIdwQRai2quHKJ6ltU

# dsi3HjNnieuE72fT4eWhxtmnN5HYCDCCB3EwggVZoAMCAQICEzMAAAAVxedrngKb

# SZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmlj

# YXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIy

# NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXI

# yjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjo

# YH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1y

# aa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v

# 3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pG

# ve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viS

# kR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYr

# bqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlM

# jgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSL

# W6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AF

# emzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIu

# rQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIE

# FgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWn

# G1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEW

# M2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5

# Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBi

# AEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV

# 9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3Js

# Lm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAx

# MC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2

# LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv

# 6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZn

# OlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1

# bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4

# rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU

# 6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDF

# NLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/

# HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdU

# CbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKi

# excdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTm

# dHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZq

# ELQdVTNYs6FwZvKhggNQMIICOAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJp

# Y2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOkEwMDAtMDVF

# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMK

# AQEwBwYFKw4DAhoDFQCABol1u1wwwYgUtUowMnqYvbul3qCBgzCBgKR+MHwxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv

# c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6ZDnpjAi

# GA8yMDI0MDMwNTAwMzY1NFoYDzIwMjQwMzA2MDAzNjU0WjB3MD0GCisGAQQBhFkK

# BAExLzAtMAoCBQDpkOemAgEAMAoCAQACAhBuAgH/MAcCAQACAhQxMAoCBQDpkjkm

# AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSCh

# CjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBADWo6HVm1NkQgbTjw77rFYHR

# eePOwixcll/Cs0HCThyDol8h8Zty7Pz4UpKmNEiU3iSNHvd9qgUhDroKkFRdV8ov

# Fa3PiLi6JPd/89oORcXcLyr0KmPyuZhuIy2H49oq0pg8KqWYzq8DVw1ghC+nz3B/

# TTF69Poek08L3WS71jdrRSNeFvYPGZv33e12GTmT6TbZ5IsiHzjvlSeCRbPUSt8E

# YFc6S/i17mKP0HfOqc7FJBBLL/fWtACbLYzZqW+U0abjorKz/qNHdIUu+0YstzfY

# 3uDsqw+4r+nS8hWE583kC4+Y2Qjnh30akgakyRTvh12K0OT4Hs/I8oo5sWELsDIx

# ggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA

# AevgGGy1tu847QABAAAB6zANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkD

# MQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCCHiv5STTQ5qub+ssVo5WDv

# 9aFxKdnvYI8KK5iEYw0vWjCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIM63

# a75faQPhf8SBDTtk2DSUgIbdizXsz76h1JdhLCz4MIGYMIGApH4wfDELMAkGA1UE

# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc

# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAHr4BhstbbvOO0AAQAAAeswIgQgfv7x

# TBrWeIqlURCziJ1oGWkb6XEIcl+IPgHhnoXu99EwDQYJKoZIhvcNAQELBQAEggIA

# g6Icj6CXhZ5+K6misp1I7n+Z2vNJGKA4f4qwhNDHy5D/OkqozaS6pZfPWj4qUQ8x

# D0YFAwhvVs+OyqKQj6spOrPC3qiPO5T+QX9w3HWuRveh4w7DbXS4pXTKN9e0s3sN

# koDsFF1iGrRdFIs8ThBduVf16VuDYJyc16NwuB3biAzo0Wnuo/vAfaP/aqqPJGk4

# NFc1m9HHP/PsGXfRobVFixgETr85A5IfjDHf+lw9Ol3MgcKsNlJ/soUM7S9wkQt1

# o/WjaUgFEuoWRWOU4tHXww7Hqg80SpBXb06cKxNnld32M52t9xQ3kik21xMbtDi3

# fLOhqMH8A3KPxHXSqZkIPEgPnfpw2HnBaF5AzfeMnGKLFTlOdGubOFDEhtBE63CI

# mNWBajcwIHNHmcj+Xyz6AKYVZ0moCf2Q7VUzBQ73JJmGQQLp8aNa3bV+M/65eSJb

# E4JlajrGImWT6hzDhBh09H6TmSIQgozB9QxzCz3Rb1dALUr1PYTH0ClucxZPdsAj

# ommKFYsXK7AXwmvstReLcBoXu1TDzKIvHvJGrRDcMYlaDSbuOFq8LVWD5qv1cO9W

# N8+b5/QkS2B6xXdX/RjbmL3EkgR5PGJ5Wloz5I0AM/i7vS5nFvtGp3mKTmyaw8Od

# obIJ/5G1yAeetZLQBV4+gCGeKmLUh7BFfA4ZTJdDOF8=

# SIG # End signature block