AzSKStaging.ADO

1.4.3

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

# MIIjhAYJKoZIhvcNAQcCoIIjdTCCI3ECAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCA8LCMFn6oguX8/

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

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAYdyF3IVWUDHCQAAAAABhzAN

# BglghkgBZQMEAgEFAKCBsDAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg18UxROyO

# NPIGtxdY7gMmd3yOP13S9X24q0777cSnLlcwRAYKKwYBBAGCNwIBDDE2MDSgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRyAGmh0dHBzOi8vd3d3Lm1pY3Jvc29mdC5jb20g

# MA0GCSqGSIb3DQEBAQUABIIBAJrqX9/eOo4A+zbshU2cFySbN16zKmJu+Ymgmnjp

# 1PiIl51XYVsoYl8v0BKY6VrbZTo97jYvKAQduDGr/wWTBG8ra+mTWCb2oXptEzl4

# C9o49yB0hfiyJGHgnvnKLTJbIBmNDm2Gy+2MfhNvjXHvtZb618zg9yH6fwJg+lnY

# VEm2+hZyOQ1njxZT9doCjd9EernGK+s9rUSI+wMWXjs+u9cxW8y1Th7apPtZ2DWv

# HYiTTeycdbXcXl/aKrmV0CBniHZOaX26rdyXglmCBDS412Dk6I/twjjaaHwRqqbw

# /kgfeGxyWtovpPqFIOR+aBKuckWQ66gE69RAppBvkDwquNahghLhMIIS3QYKKwYB

# BAGCNwMDATGCEs0wghLJBgkqhkiG9w0BBwKgghK6MIIStgIBAzEPMA0GCWCGSAFl

# AwQCAQUAMIIBUQYLKoZIhvcNAQkQAQSgggFABIIBPDCCATgCAQEGCisGAQQBhFkK

# AwEwMTANBglghkgBZQMEAgEFAAQgk/Wf/3TOIk/v/Kqt2whmz3u0FYiD2npyGHok

# LxhV8roCBmAliKiYQhgTMjAyMTAyMTIwNjM2MzYuMTM0WjAEgAIB9KCB0KSBzTCB

# yjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMc

# TWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEmMCQGA1UECxMdVGhhbGVzIFRT

# UyBFU046QUUyQy1FMzJCLTFBRkMxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFNlcnZpY2Wggg44MIIE8TCCA9mgAwIBAgITMwAAAUiiiEVWvC+AvwAAAAAB

# SDANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAe

# Fw0yMDExMTIxODI1NTZaFw0yMjAyMTExODI1NTZaMIHKMQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmlj

# YSBPcGVyYXRpb25zMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjpBRTJDLUUzMkIt

# MUFGQzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCASIw

# DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAPf/eK8VhIrR0a1xdpnyk0sQBFut

# ol7CvKL8mBtoqWruGEUhTUSRjQcyIVGbb9ay6S3raTbnO8PFbXp+mGDnzvr6XXBi

# cKWB7+sWWtHZS7VbC0WZzXEanLj67GhsIQx4gUMaEvkM1Nts6KwusFRhvJevt8/P

# FtWQTAkM/kUbafSujWo6N6AiQsiNdTqpqF25DFN+w84SnyOCowqf75+kfp+9cqV7

# BbN2x++GJngfgirUJM6f5+TGpwPBMdiRhliCqb7VfXHvjnyunr2qMV5U/cZsC8lt

# jdsWWrm7LGuI9xnENmsHp/XAAtes7b8h19UR3BNaokgNkEmNPJxCGHFLeLUCAwEA

# AaOCARswggEXMB0GA1UdDgQWBBSHMvBpnw4EtEkfSz0TrekhxYmiRzAfBgNVHSME

# GDAWgBTVYzpcijGQ80N7fEYbxTNoWoVtVTBWBgNVHR8ETzBNMEugSaBHhkVodHRw

# Oi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNUaW1TdGFQ

# Q0FfMjAxMC0wNy0wMS5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5o

# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1RpbVN0YVBDQV8y

# MDEwLTA3LTAxLmNydDAMBgNVHRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsGAQUFBwMI

# MA0GCSqGSIb3DQEBCwUAA4IBAQBmEpbBsycL1DLByuWCzSpf1uHGJka977wkQPbu

# E6LIZrxH2erMeDj6ro0p9hd9Lra4xQmna74nu0g1RN//W6Av4rhHCw9V6ENqxIkm

# P7tugjFk/wBT/FB1VjuqCZAaZ3gX5zmGQkm2Xo1F5gT3TxDr3yqPWYOmvQzH7guE

# /+1OovoelkRRGWEU512fItK1UIV180jXIYc/2fTI3Up+EYRXezswHOkUlfA5+XCD

# IT1zBDyOM5NWk1F0Kov8/lWIICjZ1yIeN3W7WLVDhBnrFvT4HUd1kVEQs6IXB/Sy

# HdnXE55IVweDSssT6ux4fPhCG+gSPuH1sPxU3v8ecIPBakElMIIGcTCCBFmgAwIB

# AgIKYQmBKgAAAAAAAjANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2Vy

# dGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMTAwNzAxMjEzNjU1WhcNMjUwNzAx

# MjE0NjU1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G

# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYw

# JAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCASIwDQYJKoZI

# hvcNAQEBBQADggEPADCCAQoCggEBAKkdDbx3EYo6IOz8E5f1+n9plGt0VBDVpQoA

# goX77XxoSyxfxcPlYcJ2tz5mK1vwFVMnBDEfQRsalR3OCROOfGEwWbEwRA/xYIiE

# VEMM1024OAizQt2TrNZzMFcmgqNFDdDq9UeBzb8kYDJYYEbyWEeGMoQedGFnkV+B

# VLHPk0ySwcSmXdFhE24oxhr5hoC732H8RsEnHSRnEnIaIYqvS2SJUGKxXf13Hz3w

# V3WsvYpCTUBR0Q+cBj5nf/VmwAOWRH7v0Ev9buWayrGo8noqCjHw2k4GkbaICDXo

# eByw6ZnNPOcvRLqn9NxkvaQBwSAJk3jN/LzAyURdXhacAQVPIk0CAwEAAaOCAeYw

# ggHiMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBTVYzpcijGQ80N7fEYbxTNo

# WoVtVTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD

# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBW

# BgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny

# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUH

# AQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtp

# L2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDCBoAYDVR0gAQH/BIGV

# MIGSMIGPBgkrBgEEAYI3LgMwgYEwPQYIKwYBBQUHAgEWMWh0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9QS0kvZG9jcy9DUFMvZGVmYXVsdC5odG0wQAYIKwYBBQUHAgIw

# NB4yIB0ATABlAGcAYQBsAF8AUABvAGwAaQBjAHkAXwBTAHQAYQB0AGUAbQBlAG4A

# dAAuIB0wDQYJKoZIhvcNAQELBQADggIBAAfmiFEN4sbgmD+BcQM9naOhIW+z66bM

# 9TG+zwXiqf76V20ZMLPCxWbJat/15/B4vceoniXj+bzta1RXCCtRgkQS+7lTjMz0

# YBKKdsxAQEGb3FwX/1z5Xhc1mCRWS3TvQhDIr79/xn/yN31aPxzymXlKkVIArzgP

# F/UveYFl2am1a+THzvbKegBvSzBEJCI8z+0DpZaPWSm8tv0E4XCfMkon/VWvL/62

# 5Y4zu2JfmttXQOnxzplmkIz/amJ/3cVKC5Em4jnsGUpxY517IW3DnKOiPPp/fZZq

# kHimbdLhnPkd/DjYlPTGpQqWhqS9nhquBEKDuLWAmyI4ILUl5WTs9/S/fmNZJQ96

# LjlXdqJxqgaKD4kWumGnEcua2A5HmoDF0M2n0O99g/DhO3EJ3110mCIIYdqwUB5v

# vfHhAN/nMQekkzr3ZUd46PioSKv33nJ+YWtvd6mBy6cJrDm77MbL2IK0cs0d9LiF

# AR6A+xuJKlQ5slvayA1VmXqHczsI5pgt6o3gMy4SKfXAL1QnIffIrE7aKLixqduW

# sqdCosnPGUFN4Ib5KpqjEWYw07t0MkvfY3v1mYovG8chr1m1rtxEPJdQcdeh0sVV

# 42neV8HR3jDA/czmTfsNv11P6Z0eGTgvvM9YBS7vDaBQNdrvCScc1bN+NR4Iuto2

# 29Nfj950iEkSoYICyjCCAjMCAQEwgfihgdCkgc0wgcoxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNh

# IE9wZXJhdGlvbnMxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOkFFMkMtRTMyQi0x

# QUZDMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEw

# BwYFKw4DAhoDFQCHK4KWuhxZ/hIhxFp8ARfVGGzrOaCBgzCBgKR+MHwxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m

# dCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBBQUAAgUA49AHFzAiGA8y

# MDIxMDIxMjAzNDIxNVoYDzIwMjEwMjEzMDM0MjE1WjBzMDkGCisGAQQBhFkKBAEx

# KzApMAoCBQDj0AcXAgEAMAYCAQACAQIwBwIBAAICEUkwCgIFAOPRWJcCAQAwNgYK

# KwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgCAQAC

# AwGGoDANBgkqhkiG9w0BAQUFAAOBgQCGlriNXLXfyjTNtHOTwHHvU6s6Wnc6D70e

# M1HyhUVwU6419Z8n+PfhB902gwaSfFB0uP3FRRfghM22xt+5diyoKGy2Zjb3fUqz

# Br7jduP7Iwd0By/HL4dUo8sR7FExabYy+VhuTYMvVLwXdhc0xWUb9wqTorxtEmwB

# X576RUy4kDGCAw0wggMJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAy

# MDEwAhMzAAABSKKIRVa8L4C/AAAAAAFIMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkq

# hkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIImQXxVwavwu

# gItweplM8VbJ/civ/MBswYtBbOXmdRqDMIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB

# 5DCBvQQgqZAa6ox5ob8mH+bU3E7w+WOGvle/U8FVek9WgMHbaNgwgZgwgYCkfjB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAUiiiEVWvC+AvwAAAAAB

# SDAiBCCAEvjNP5Auxb1CVcEAIJl8GNwjoV7ue1kxcaleSKpkHjANBgkqhkiG9w0B

# AQsFAASCAQDOFzSN4aPUjI0yN/x/hwfRgjAoCzE/KjKDVwMeswT4b8wJbh8l+Fij

# Bo16M3/ykpiNrQ1s6kWh6bj43p3QiVZ6Ds+T7FwxTCkDyNKjHqj0tRehU4kuUfqS

# T6Of4iEZ1TKFNhNgPlkZunRZ2gPMGdeJn4NAGZvMsU2vGhXW09XmEHRCqM1AKlaJ

# WERR1cDxZbHHbuDUdVMCWS0IoaBGKLapffpdJ2No+NseHBIMmfUy2iu+McJQ8V7y

# Fd+fRApSc0NqM3PlmUlJikp4FZBqmvwIhXqHmE072sttmAUCPQ/kxSnFAfBIzGeA

# ERw0kr0uaH2nYoTLodn/vQUOLGQnox28

# SIG # End signature block