AzSKPreview.ADO

1.5.1

Framework/Abstracts/MetaInfoProvider.ps1

                                class MetaInfoProvider {

    hidden static [MetaInfoProvider] $metaInfoInstance = [MetaInfoProvider]::new()

    static [MetaInfoProvider] $Instance = [MetaInfoProvider]::GetInstance()

    hidden [bool] $bUseADOInfoAPI 

    hidden [string] $FuncAPI = '/api/getadoinfo'; 

    hidden [string] $code;

    hidden [string] $baseURL;

    hidden [PSObject] $ControlSettings; 

    hidden [PSObject] $buildSTDetails;

    hidden [PSObject] $releaseSTDetails;

    hidden [PSObject] $svcConnSTDetails;

    hidden [PSObject] $agtPoolSTDetails;

    hidden [PSObject] $varGroupSTDetails;

    hidden [PSObject] $serviceTreeDetails;

    #Variable to check whether ST file is present in policy, if ST file is not present then set them to false so for next resource don't call policy server to fetch this file

    hidden [bool] $checkBuildSTFileOnServer = $true;    

    hidden [bool] $checkReleaseSTFileOnServer = $true;

    hidden [bool] $checkServiceConnectionSTFileOnServer = $true;

    hidden [bool] $checkAgentPoolSTFileOnServer = $true;    

    hidden [bool] $checkVariableGroupSTFileOnServer = $true;    

    hidden [bool] $checkServiceTreeFileOnServer = $true;

    hidden MetaInfoProvider() {

        #Getting call only once and set bUseADOInfoAPI

        $this.IsADOInfoAPIEnabled();

    }

    #Return MetaInfoProvider instance

    hidden static [MetaInfoProvider] GetInstance() {

        return [MetaInfoProvider]::metaInfoInstance

    }

    #checking adoinfo api is enabled or not in org policy file

    [bool] IsADOInfoAPIEnabled()

    {

        if ($null -eq $this.ControlSettings)

        {

            $this.ControlSettings = [ConfigurationManager]::LoadServerConfigFile("ControlSettings.json");

        }

        $adoInfoAPI = $this.ControlSettings.ADOInfoAPI;

        if ($null -ne $adoInfoAPI -and $Env:AzSKADODoNotUseADOInfoAPI -ne $true)

        {

            #TODO

            #$adoInfoAPI.Enabled = $false;

            if ($adoInfoAPI.Enabled)

            {

                $this.bUseADOInfoAPI = $true;

                $this.code = $adoInfoAPI.Code;

                $this.baseURL = $adoInfoAPI.Endpoint;

            }

        }

        return $this.bUseADOInfoAPI;

    }

    #Calling adoinfo api and returning response

    [PSObject] CallADOInfoAPI($queryString )

    {

        $adoInfoInvokeURL = $this.baseURL + $this.FuncAPI + $queryString

        $Header = @{

            "x-functions-key" = $this.code;

        }

        $rsrcList = $null

        try 

        {

            $rsrcList = Invoke-RestMethod -Method 'GET' -Uri $adoInfoInvokeURL -Headers $Header

        }

        catch

        {

            Write-Host "Error calling ADO Info API. `r`nPlease contact your project's ADO security team." -ForegroundColor Red 

        }

        return $rsrcList;

    }

    #Fetching sesrvice id associated resources and internally calling adoinfo api if enabled else getting data from local org policy files

    [PSObject] FetchServiceAssociatedResources($svcId, $projectName, $resourceTypeName)

    {

        $rsrcList = $null;

        if ($this.bUseADOInfoAPI -eq $true)

        {

            #TODO: Look at cleaning up these multiple "-in" checks across the API_call-v-Policy_Repo cases...

            #TODO-PERF: For now we are erring on the side of avoiding multiple network calls...revisit based on observed pattern of -svcid <xyz> usage

            $qs = "?svcId={0}" -f $svcId

            $rsrcList = $this.CallADOInfoAPI($qs);

        }

        else 

        {

            $this.FetchMappingFiles($resourceTypeName);

            $buildList = @();

            $releaseList = @();

            $svcConnList = @();

            $varGroupList = @();

            $agentPoolList = @();

            if ($this.buildSTDetails) {

                $buildList += $this.buildSTDetails.Data | Where-Object { ($_.serviceId -eq $svcId) -and ($_.projectName -eq $projectName) }

            }

            if ($this.releaseSTDetails) {

                $releaseList += $this.releaseSTDetails.Data | Where-Object { ($_.serviceId -eq $svcId) -and ($_.projectName -eq $projectName) }

            }

            if ($this.svcConnSTDetails) {

                $svcConnList += $this.svcConnSTDetails.Data | Where-Object { ($_.serviceId -eq $svcId) -and ($_.projectName -eq $projectName) }

            }

            if ($this.agtPoolSTDetails) {

                $agentPoolList += $this.agtPoolSTDetails.Data | Where-Object { ($_.serviceId -eq $svcId) -and ($_.projectName -eq $projectName) }

            }

            if ($this.varGroupSTDetails) {

                $varGroupList += $this.varGroupSTDetails.Data | Where-Object { ($_.serviceId -eq $svcId) -and ($_.projectName -eq $projectName) }

            } 

            $rsrcList = @{

                Builds = $buildList

                Releases = $releaseList

                ServiceConnections = $svcConnList

                AgentPools = $agentPoolList

                VariableGroups = $varGroupList

            }

        }

        return $rsrcList; 

    }

    #Fetching service tree info details based on resource id and internally calling adoinfo api and loading resource file if enabled, else loading resource file from local org policy files

    [PSObject] FetchResourceMappingWithServiceData($rscId, $projectName, $resourceTypeName)

    {

        $serviceTreeInfo = $null;

        try 

        {

            #check if adoinfoapi is enabled in org-policy file 

            if ($this.bUseADOInfoAPI -eq $true)

            {

                $qs = "?ResourceType=$resourceTypeName";

                #call adoinfoapi only if STDetails files is not already loaded.

                if ( ($resourceTypeName -eq "Build" -and !$this.buildSTDetails) -or ($resourceTypeName -eq "Release" -and !$this.releaseSTDetails) -or ($resourceTypeName -eq "ServiceConnection" -and !$this.svcConnSTDetails) -or ($resourceTypeName -eq "AgentPool" -and !$this.agtPoolSTDetails)  -or ($resourceTypeName -eq "VariableGroupp" -and !$this.varGroupSTDetails) ) {

                    $rsrcList = $this.CallADOInfoAPI($qs);

                    if ($rsrcList -and ( [Helpers]::CheckMember($rsrcList, "Data") -and $rsrcList.Data) ) {

                        $this.BindADOInfoAPIResponseToSTMappingFiles($rsrcList, $resourceTypeName);

                    }

                    #If not get files from adoinfoapi, take then from local org policy files. 

                    #else {

                    #    $this.FetchMappingFiles($resourceTypeName);

                    #}

                }

            }

            else 

            {

                $this.FetchMappingFiles($resourceTypeName);

            }

            $serviceTreeInfo = $this.GetServiceDataForResource($rscId, $resourceTypeName);

        }

        catch

        {

            Write-Host "Could not fetch service mapping files. `r`nPlease contact your project's ADO security team." -ForegroundColor Red 

        }

        return $serviceTreeInfo; 

    }

    #Binding adoinfo api response to class local variable

    hidden [void] BindADOInfoAPIResponseToSTMappingFiles($resourceList, $resourceTypeName)

    {

        if ($resourceTypeName -eq "Build") {

            $this.buildSTDetails = $resourceList;

        }

        elseif ($resourceTypeName -eq "Release") {

            $this.releaseSTDetails = $resourceList;

        }

        elseif ($resourceTypeName -eq "ServiceConnection") {

            $this.svcConnSTDetails = $resourceList;

        }

        elseif ($resourceTypeName -eq "AgentPool") {

            $this.agtPoolSTDetails = $resourceList;

        }

        elseif ($resourceTypeName -eq "VariableGroup") {

            $this.varGroupSTDetails = $resourceList;

        }

        elseif ($resourceTypeName -eq "ServiceTree") {

            $this.serviceTreeDetails = $resourceList;

        }

    }

    #Loading local org policy ST files based on supplied resource type, 

    #1.Fetch ST files from policy only if ...STDetails variable is null (if not already fetch)

    #2.Do not fetch ST files again from policy, if already fetched and file is not present in policy server.

    [void] FetchMappingFiles($ResourceTypeName)

    {

        if ($ResourceTypeName -in ([ResourceTypeName]::Build, [ResourceTypeName]::All, [ResourceTypeName]::Build_Release, [ResourceTypeName]::Build_Release_SvcConn_AgentPool_User))

        {

           if (!$this.buildSTDetails -and $this.checkBuildSTFileOnServer) {

                $this.buildSTDetails = [ConfigurationManager]::LoadServerConfigFile("BuildSTData.json");

                $this.checkBuildSTFileOnServer = $false;

            }    

        }

        if ($ResourceTypeName -in ([ResourceTypeName]::Release, [ResourceTypeName]::All, [ResourceTypeName]::Build_Release, [ResourceTypeName]::Build_Release_SvcConn_AgentPool_User))

        {

            if (!$this.releaseSTDetails -and $this.checkReleaseSTFileOnServer) {

                $this.releaseSTDetails = [ConfigurationManager]::LoadServerConfigFile("ReleaseSTData.json");

                $this.checkReleaseSTFileOnServer = $false;

            }

        }

        if ($ResourceTypeName -in ([ResourceTypeName]::ServiceConnection, [ResourceTypeName]::All, [ResourceTypeName]::Build_Release_SvcConn_AgentPool_User))

        {

            if (!$this.svcConnSTDetails -and $this.checkServiceConnectionSTFileOnServer) {

                $this.svcConnSTDetails = [ConfigurationManager]::LoadServerConfigFile("ServiceConnectionSTData.json");

                $this.checkServiceConnectionSTFileOnServer = $false;

            }

        }

        if ($ResourceTypeName -in ([ResourceTypeName]::AgentPool, [ResourceTypeName]::All, [ResourceTypeName]::Build_Release_SvcConn_AgentPool_User))

        {

            if (!$this.agtPoolSTDetails -and $this.checkAgentPoolSTFileOnServer) {

                $this.agtPoolSTDetails = [ConfigurationManager]::LoadServerConfigFile("AgentPoolSTData.json");

                $this.checkAgentPoolSTFileOnServer = $false;

            }

        }

        if ($ResourceTypeName -in ([ResourceTypeName]::VariableGroup, [ResourceTypeName]::All))

        {

            if (!$this.varGroupSTDetails -and $this.checkVariableGroupSTFileOnServer) {

                $this.varGroupSTDetails = [ConfigurationManager]::LoadServerConfigFile("VariableGroupSTData.json");

                $this.checkVariableGroupSTFileOnServer = $false;

            }

        }

        if ($ResourceTypeName -eq "ServiceTree")

        {

            if (!$this.serviceTreeDetails -and $this.checkServiceTreeFileOnServer) {

                $this.serviceTreeDetails = [ConfigurationManager]::LoadServerConfigFile("ServiceTreeData.json");

                $this.checkServiceTreeFileOnServer = $false;

            }

        }

    }

    #Fetching service tree data based on resource id from ST data loaded in class variables

    hidden [PSObject] GetServiceDataForResource($rscId, $resourceTypeName)

    {

        $serviceTreeInfo = $null;

        if(($resourceTypeName -eq "Build") -and $this.buildSTDetails -and [Helpers]::CheckMember($this.buildSTDetails, "Data"))

        {

            $buildSTData = $this.buildSTDetails.Data | Where-Object { $_.buildDefinitionID -eq $rscId -and $_.projectName -eq $projectName }; 

            if ($buildSTData) 

            {

                $serviceTreeInfo = $this.GetDataFromServiceTree($buildSTData.serviceID);

            }

        }

        elseif(($resourceTypeName -eq "Release") -and $this.releaseSTDetails -and [Helpers]::CheckMember($this.releaseSTDetails, "Data"))

        {

            $releaseSTData = $this.releaseSTDetails.Data | Where-Object { $_.releaseDefinitionID -eq $rscId -and $_.projectName -eq $projectName}; 

            if ($releaseSTData) 

            {

                $serviceTreeInfo = $this.GetDataFromServiceTree($releaseSTData.serviceID);

            }

        }

        elseif(($resourceTypeName -eq "ServiceConnection") -and $this.svcConnSTDetails -and [Helpers]::CheckMember($this.svcConnSTDetails, "Data"))

        {

            $svcConnSTData = $this.svcConnSTDetails.Data | Where-Object { $_.serviceConnectionID -eq $rscId -and $_.projectName -eq $projectName}; 

            if ($svcConnSTData) 

            {

                $serviceTreeInfo = $this.GetDataFromServiceTree($svcConnSTData.serviceID);

            }

        }

        elseif(($resourceTypeName -eq "AgentPool") -and $this.agtPoolSTDetails -and [Helpers]::CheckMember($this.agtPoolSTDetails, "Data"))

        {

            $agtPoolSTData = $this.agtPoolSTDetails.Data | Where-Object { $_.agentPoolID -eq $rscId -and $_.projectName -eq $projectName}; 

            if ($agtPoolSTData) 

            {

                $serviceTreeInfo = $this.GetDataFromServiceTree($agtPoolSTData.serviceID);

            }

        }

        elseif(($resourceTypeName -eq "VariableGroup") -and $this.varGroupSTDetails -and [Helpers]::CheckMember($this.varGroupSTDetails, "Data"))

        {

            $varGroupSTData = $this.varGroupSTDetails.Data | Where-Object { $_.variableGroupID -eq $rscId -and $_.projectName -eq $projectName}; 

            if ($varGroupSTData) 

            {

                $serviceTreeInfo = $this.GetDataFromServiceTree($varGroupSTData.serviceID);

            }

        }

        return $serviceTreeInfo;

    }

    #Fetching Service tree info data based on service id from service tree mapping file

    hidden [PSObject] GetDataFromServiceTree($serviceId) 

    {

        $serviceTreeInfo = $null;        

        if (!$this.serviceTreeDetails) 

        {

            if ($this.bUseADOInfoAPI -eq $true) {

                $qs = "?ResourceType=ServiceTree";

                $rsrcList = $this.CallADOInfoAPI($qs);

                if ($rsrcList -and [Helpers]::CheckMember($rsrcList, "Data") -and $rsrcList.Data) {

                    $this.BindADOInfoAPIResponseToSTMappingFiles($rsrcList, "ServiceTree");

                }

                #If not get file from adoinso api, get it from local org policy file.

                #else {

                #    $this.FetchMappingFiles("ServiceTree");

                #}

            }

            else {

                $this.FetchMappingFiles("ServiceTree");

            }  

        }

        if ($this.serviceTreeDetails -and [Helpers]::CheckMember($this.serviceTreeDetails, "Data")) {

            $serviceTreeInfo = $this.serviceTreeDetails.Data | Where-Object { $_.serviceID -eq $serviceId };

        }

        return $serviceTreeInfo;

    }

}

# SIG # Begin signature block

# MIIjoQYJKoZIhvcNAQcCoIIjkjCCI44CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCA8LCMFn6oguX8/

# 0cdwAQyV2UD2NHHMWdBSDxFtGnE4qKCCDYEwggX/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/BvW1taslScxMNelDNMYIVdjCCFXICAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAd9r8C6Sp0q00AAAAAAB3zAN

# BglghkgBZQMEAgEFAKCBsDAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg18UxROyO

# NPIGtxdY7gMmd3yOP13S9X24q0777cSnLlcwRAYKKwYBBAGCNwIBDDE2MDSgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRyAGmh0dHBzOi8vd3d3Lm1pY3Jvc29mdC5jb20g

# MA0GCSqGSIb3DQEBAQUABIIBAHZh6SwVqP1GpPYiM2dvWQ3IO1pgMxMrk0gXn9A9

# PQ/5jgUAmAr70e99IUDMWanaW04oJUjY+e0TC6OGwVO3uyEyacvhADIAaDIlAq5s

# ZQTk44J6kGEh4UgyHZW6IaUwFh+Wl/pnop2fVyggXJOlT4xMqMmQSiPIeh0Rb8E4

# un2ym+u9rRHjlYs0BAdVOqVJurJEp1qLyhMmD42C1Aab90h/dWI6E4Trtel4qKjx

# dEOvGf30hclrm1HjnPWMtGfwPVA7QEIZXYJWupm+nS6gTzh+8lOB2oII6xw0vsKq

# T3AUkcbEx9gWA/4uMe+cvrM8oeb05KyMA5XV7O+zkwEkonahghL+MIIS+gYKKwYB

# BAGCNwMDATGCEuowghLmBgkqhkiG9w0BBwKgghLXMIIS0wIBAzEPMA0GCWCGSAFl

# AwQCAQUAMIIBWQYLKoZIhvcNAQkQAQSgggFIBIIBRDCCAUACAQEGCisGAQQBhFkK

# AwEwMTANBglghkgBZQMEAgEFAAQgOtl9MbuHYKW2utf8mWkj9PPmvVLj8fhSiooQ

# cq7WXkICBmA84EIHoxgTMjAyMTAzMTUxMDU5NDYuODc0WjAEgAIB9KCB2KSB1TCB

# 0jELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMk

# TWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1U

# aGFsZXMgVFNTIEVTTjpFMDQxLTRCRUUtRkE3RTElMCMGA1UEAxMcTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgU2VydmljZaCCDk0wggT5MIID4aADAgECAhMzAAABN0GPQ+da

# W2+nAAAAAAE3MA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBD

# QSAyMDEwMB4XDTIwMTAxNTE3MjgxNFoXDTIyMDExMjE3MjgxNFowgdIxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29m

# dCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEmMCQGA1UECxMdVGhhbGVzIFRT

# UyBFU046RTA0MS00QkVFLUZBN0UxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFNlcnZpY2UwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDEEe5p

# 0SWbcbm2KSFPONIMHT72xeZSFTINVGPRji/P2tn2zKQ2hsvn/oC3nM6R4HZuX0he

# 9V3JL9kk1lPfveSfOtDfjvPfQybDv75VT8IT7jHjD2RvlupAd9LNslC3oqZay4yY

# kvODhHkx4mzkxjlh08vGgygNFxOL/8qgwVHQrNLX/fbgPb/gqQcPVe36zTFjQMgJ

# Q4rVFuYkIoSAE/X8YNmO5lAFL0OLz3JOe8slX4uvVC2uIfgSqZGgB2ZXfMnQYmyv

# m+EY+Yp848JFKTtDyKBfuCgWcIvOlhx8cYKqhH+bD3mB9CnDKZXDFkHQ+QYytDD4

# spU9r8Uc/gLgo75BAgMBAAGjggEbMIIBFzAdBgNVHQ4EFgQUDWCwcwz652BjusSd

# 7ro7LPGUT2UwHwYDVR0jBBgwFoAU1WM6XIoxkPNDe3xGG8UzaFqFbVUwVgYDVR0f

# BE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJv

# ZHVjdHMvTWljVGltU3RhUENBXzIwMTAtMDctMDEuY3JsMFoGCCsGAQUFBwEBBE4w

# TDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0

# cy9NaWNUaW1TdGFQQ0FfMjAxMC0wNy0wMS5jcnQwDAYDVR0TAQH/BAIwADATBgNV

# HSUEDDAKBggrBgEFBQcDCDANBgkqhkiG9w0BAQsFAAOCAQEAnfZT133RFW4BRv02

# ydcEbUrjaqOFT6Me/AF1uKkhxfhaDt0fll25BmPeBaAoANnnP5N6FfsacFuLbrlU

# jvENGwV7YKORObgkiiKx0rBgEOu5L5hFEEbgHURG5aLnhcbDH6VID6JA2siLombQ

# Iv8x9Au/Cyo8lIY/r04QcLJoTGizjzr5fclO4ZXXUIGX8E7uvxQdvH+sTp9muVll

# hpsgXpp5qG9MvXgu9ktX9szNhI4OxuMcexOb1BoabWKOFqAJ1uQCqvz7scCBgRqv

# xc+XPFSFUjhKFUHlkZ32BnbIGTDF0DSgVzvjlN04+ts/v293R4+qC8kMfm2Q6FNE

# 0jnldDCCBnEwggRZoAMCAQICCmEJgSoAAAAAAAIwDQYJKoZIhvcNAQELBQAwgYgx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1p

# Y3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTEwMDcw

# MTIxMzY1NVoXDTI1MDcwMTIxNDY1NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT

# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB

# IDIwMTAwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCpHQ28dxGKOiDs

# /BOX9fp/aZRrdFQQ1aUKAIKF++18aEssX8XD5WHCdrc+Zitb8BVTJwQxH0EbGpUd

# zgkTjnxhMFmxMEQP8WCIhFRDDNdNuDgIs0Ldk6zWczBXJoKjRQ3Q6vVHgc2/JGAy

# WGBG8lhHhjKEHnRhZ5FfgVSxz5NMksHEpl3RYRNuKMYa+YaAu99h/EbBJx0kZxJy

# GiGKr0tkiVBisV39dx898Fd1rL2KQk1AUdEPnAY+Z3/1ZsADlkR+79BL/W7lmsqx

# qPJ6Kgox8NpOBpG2iAg16HgcsOmZzTznL0S6p/TcZL2kAcEgCZN4zfy8wMlEXV4W

# nAEFTyJNAgMBAAGjggHmMIIB4jAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQU

# 1WM6XIoxkPNDe3xGG8UzaFqFbVUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEw

# CwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/o

# olxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNy

# b3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYt

# MjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5t

# aWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5j

# cnQwgaAGA1UdIAEB/wSBlTCBkjCBjwYJKwYBBAGCNy4DMIGBMD0GCCsGAQUFBwIB

# FjFodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vUEtJL2RvY3MvQ1BTL2RlZmF1bHQu

# aHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAFAAbwBsAGkAYwB5AF8A

# UwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQAH5ohRDeLG

# 4Jg/gXEDPZ2joSFvs+umzPUxvs8F4qn++ldtGTCzwsVmyWrf9efweL3HqJ4l4/m8

# 7WtUVwgrUYJEEvu5U4zM9GASinbMQEBBm9xcF/9c+V4XNZgkVkt070IQyK+/f8Z/

# 8jd9Wj8c8pl5SpFSAK84Dxf1L3mBZdmptWvkx872ynoAb0swRCQiPM/tA6WWj1kp

# vLb9BOFwnzJKJ/1Vry/+tuWOM7tiX5rbV0Dp8c6ZZpCM/2pif93FSguRJuI57BlK

# cWOdeyFtw5yjojz6f32WapB4pm3S4Zz5Hfw42JT0xqUKloakvZ4argRCg7i1gJsi

# OCC1JeVk7Pf0v35jWSUPei45V3aicaoGig+JFrphpxHLmtgOR5qAxdDNp9DvfYPw

# 4TtxCd9ddJgiCGHasFAeb73x4QDf5zEHpJM692VHeOj4qEir995yfmFrb3epgcun

# Caw5u+zGy9iCtHLNHfS4hQEegPsbiSpUObJb2sgNVZl6h3M7COaYLeqN4DMuEin1

# wC9UJyH3yKxO2ii4sanblrKnQqLJzxlBTeCG+SqaoxFmMNO7dDJL32N79ZmKLxvH

# Ia9Zta7cRDyXUHHXodLFVeNp3lfB0d4wwP3M5k37Db9dT+mdHhk4L7zPWAUu7w2g

# UDXa7wknHNWzfjUeCLraNtvTX4/edIhJEqGCAtcwggJAAgEBMIIBAKGB2KSB1TCB

# 0jELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMk

# TWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1U

# aGFsZXMgVFNTIEVTTjpFMDQxLTRCRUUtRkE3RTElMCMGA1UEAxMcTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUA6ruoOTiJXPwhO5lt

# QWsAbt5zGpyggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAN

# BgkqhkiG9w0BAQUFAAIFAOP5KlYwIhgPMjAyMTAzMTUwODM1MzRaGA8yMDIxMDMx

# NjA4MzUzNFowdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA4/kqVgIBADAKAgEAAgIZ

# hAIB/zAHAgEAAgITlTAKAgUA4/p71gIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgor

# BgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUA

# A4GBAJTRswyUgqFJB8Qs00D+mS0BTZP1sggGHi3okOo4vFnUZAF8q9QzDoHjkq7r

# dHOKSdoPp0zYMi0wk2+6NcH20jPIZOB/5EFCfy58auo1m4Wq0PLc2tWcOrmzQr+R

# pyTo0Cf5tLAO4MFw7vXqJw+MkWMnCg+soUEygxBihM0kc543MYIDDTCCAwkCAQEw

# gZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAE3QY9D51pbb6cA

# AAAAATcwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0B

# CRABBDAvBgkqhkiG9w0BCQQxIgQgrWhnxAWtcTMlOlN5nrHJDMMsvLYfLpI6d2If

# JLUvGSswgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCAdWX6vwJ4EnSLJf9oZ

# kPZhtDuCT5Ts3sFCJMMoBhIcEDCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwAhMzAAABN0GPQ+daW2+nAAAAAAE3MCIEIOwu29PNqs/7mhKKddxL

# Rf1dysIuNpxvCfc9A6cCAKPOMA0GCSqGSIb3DQEBCwUABIIBAAPG+LrP/pyZCGgW

# IOEIx4R5PNCkjWQk8jIVBAksriBEZ0+pOVSlkN/UHhU8pqW02Z/IJIfd0DiHLWR2

# 81wJ8vNAlbQUrOgZqkJSoRS4ILCI4O/vg8ju8Tikv5YV5Oij9pSOnldMom72NIAR

# JliFL1iBh16cDyJSBCl+F6xhwqI+pTYxf9+h/k5Mr40uk4PQyM0y7jbtOJsM2b15

# YkRApsGY8jgcJqN0fyVG4LLen11Tbpg7Z3zRopy3RQxdAamp/47xupdMZ3YSVdZ0

# QlT4c4TSCTRjQbupNWKvywbIc5hbC7dDQHXPpM3Pm9EmPOILv037CwdQeSih3T7T

# Jc4Ee8I=

# SIG # End signature block