Nexthink-Nutanix-Connector

0.0.7-beta

Private/VirtualMachines.ps1

                                function Get-VirtualMachineHash {

    param(

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorVMInfo]$VirtualMachine

    )

    # Create a deterministic string representation by sorting properties

    # This ensures consistent hashing regardless of property order in JSON

    $sortedProperties = $VirtualMachine.PSObject.Properties | Sort-Object Name

    $hashInput = ""

    foreach ($prop in $sortedProperties) {

        $hashInput += "$($prop.Name):$($prop.Value);"

    }

    $hasher = [System.Security.Cryptography.SHA256]::Create()

    try {

        $bytes = [System.Text.Encoding]::UTF8.GetBytes($hashInput)

        $hashBytes = $hasher.ComputeHash($bytes)

        return [BitConverter]::ToString($hashBytes) -replace '-', ''

    }

    finally {

        $hasher.Dispose()

    }

}

function Get-VirtualMachinesStoragePath {

    param(

        [Parameter(Mandatory = $true)]

        [NutanixConnectorConfiguration]$Config

    )

    $storageFolder = Join-Path -Path (Join-Path -Path $Config.ScriptRootPath -ChildPath $script:STORAGE_FOLDER_NAME) -ChildPath $Config.EnvironmentConfig.Name

    return Join-Path -Path $storageFolder -ChildPath 'virtual_machines.json'

}

function Read-VirtualMachinesStorage {

    param(

        [Parameter(Mandatory = $true)]

        [NutanixConnectorConfiguration]$Config

    )

    $vmStoragePath = Get-VirtualMachinesStoragePath -Config $Config

    $vmStorageData = @{}

    if (Test-Path -Path $vmStoragePath) {

        try {

            $storageContent = Get-Content -Path $vmStoragePath -Raw | ConvertFrom-Json -ErrorAction Stop

            $storageContent.PSObject.Properties | ForEach-Object {

                # Handle cases where lastUpdated might not be parsed correctly

                $lastUpdated = if($_.Value.lastUpdated -is [datetime]) { $_.Value.lastUpdated.ToUniversalTime().ToString('o') } else { [string]$_.Value.lastUpdated }

                $vmData = @{

                    hash = $_.Value.hash

                    lastUpdated = $lastUpdated

                }

                $vmStorageData[$_.Name] = $vmData

            }

            Write-CustomLog -Message "Loaded existing virtual machine storage from $vmStoragePath" -Severity 'DEBUG'

        }

        catch {

            Write-CustomLog -Message "Error reading virtual machine storage file: $($_.Exception.Message)" -Severity 'WARNING'

            throw "Error reading virtual machine storage file: $($_.Exception.Message)"

        }

    }

    return $vmStorageData

}

function Save-VirtualMachinesStorage {

    param(

        [Parameter(Mandatory = $true)]

        [hashtable]$StorageData,

        [Parameter(Mandatory = $true)]

        [NutanixConnectorConfiguration]$Config

    )

    $tempPath = $null

    try {

        $vmStoragePath = Get-VirtualMachinesStoragePath -Config $Config

        $json = $StorageData | ConvertTo-Json -Compress

        $tempPath = "$vmStoragePath.tmp-$([Guid]::NewGuid().ToString('N'))"

        Set-Content -Path $tempPath -Value $json -Encoding utf8 -ErrorAction Stop

        Move-Item -Path $tempPath -Destination $vmStoragePath -Force -ErrorAction Stop

        Write-CustomLog -Message "Virtual machines storage file saved successfully at '$vmStoragePath'" -Severity 'INFO'

        return $true

    }

    catch {

        if ($null -ne $tempPath) {

            Remove-Item -Path $tempPath -Force -ErrorAction SilentlyContinue

        }

        Write-CustomLog -Message "Error saving virtual machines storage file: $($_.Exception.Message)" -Severity 'ERROR'

        return $false

    }

}

function Test-VirtualMachineChanged {

    param(

        [Parameter(Mandatory = $true)]

        [object]$VirtualMachineHashDetails,

        [Parameter(Mandatory = $true)]

        [hashtable]$StorageData,

        [Parameter(Mandatory = $true)]

        [datetime]$VmMaxAge

    )

    $storageId = $VirtualMachineHashDetails.storageId

    $vmHash =$VirtualMachineHashDetails.hash

    if (-not $storageId) {

        Write-CustomLog -Message "Skipping VM with empty storage id" -Severity 'WARNING'

        return $false

    }

    if ($StorageData.ContainsKey($storageId)) {

        $storedVmData = $StorageData[$storageId]

        if ([string]::IsNullOrEmpty($storedVmData.lastUpdated) -or [string]::IsNullOrEmpty($storedVmData.hash)) {

            Write-CustomLog -Message "VM '$storageId' found in storage but required properties are missing or empty. Treating as new VM." -Severity 'DEBUG'

            return $true

        }

        $vmLastUpdate = ConvertFrom-RfcUtcTimestamp -Value $storedVmData.lastUpdated

        if ($vmLastUpdate -lt $vmMaxAge) {

            Write-CustomLog -Message "Update required: VM '$storageId' last update was too long ago." -Severity 'DEBUG'

            return $true

        }

        if ($storedVmData.hash -ne $vmHash) {

            Write-CustomLog -Message "Storage entry '$storageId' has changed" -Severity 'DEBUG'

            return $true

        }

        else {

            Write-CustomLog -Message "Storage entry '$storageId' unchanged" -Severity 'DEBUG'

            return $false

        }

    }

    else {

        Write-CustomLog -Message "New storage entry found: '$storageId'" -Severity 'DEBUG'

        return $true

    }

}

function New-VirtualMachinesBatchPayload {

    param(

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorPayload]$Payload

    )

    $batchPayload = [NutanixHypervisorPayload]::new()

    $batchPayload.schema_version = $Payload.schema_version

    $batchPayload.source = $Payload.source

    $batchPayload.customer_environment = $Payload.customer_environment

    $batchPayload.version = $Payload.version

    return $batchPayload

}

function New-VirtualMachinesBatchState {

    param(

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorPayload]$Payload

    )

    return [pscustomobject]@{

        Payload          = New-VirtualMachinesBatchPayload -Payload $Payload

        DataItemsByHost  = [ordered]@{}

        VmCount          = 0

        Updates          = @{}

        TotalVmCount     = 0

    }

}

function Complete-VirtualMachinesBatch {

    param(

        [Parameter(Mandatory = $true)]

        [pscustomobject]$BatchState,

        [Parameter(Mandatory = $true)]

        [AllowEmptyCollection()]

        [System.Collections.Generic.List[NutanixHypervisorPayload]]$Batches,

        [Parameter(Mandatory = $true)]

        [AllowEmptyCollection()]

        [System.Collections.Generic.List[hashtable]]$BatchVmUpdates,

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorPayload]$Payload

    )

    if ($BatchState.VmCount -eq 0) {

        return

    }

    $BatchState.Payload.data = @($BatchState.DataItemsByHost.Values)

    $Batches.Add($BatchState.Payload)

    $BatchVmUpdates.Add($BatchState.Updates)

    $BatchState.Payload = New-VirtualMachinesBatchPayload -Payload $Payload

    $BatchState.DataItemsByHost = [ordered]@{}

    $BatchState.VmCount = 0

    $BatchState.Updates = @{}

}

function Add-VirtualMachineToBatch {

    param(

        [Parameter(Mandatory = $true)]

        [object]$DataItem,

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorVMInfo]$VirtualMachine,

        [Parameter(Mandatory = $true)]

        [hashtable]$VirtualMachineHashDetails,

        [Parameter(Mandatory = $true)]

        [string]$LastUpdated,

        [Parameter(Mandatory = $true)]

        [int]$BatchSize,

        [Parameter(Mandatory = $true)]

        [pscustomobject]$BatchState,

        [Parameter(Mandatory = $true)]

        [AllowEmptyCollection()]

        [System.Collections.Generic.List[NutanixHypervisorPayload]]$Batches,

        [Parameter(Mandatory = $true)]

        [AllowEmptyCollection()]

        [System.Collections.Generic.List[hashtable]]$BatchVmUpdates,

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorPayload]$Payload

    )

    if ($BatchState.VmCount -ge $BatchSize) {

        Complete-VirtualMachinesBatch -BatchState $BatchState -Batches $Batches -BatchVmUpdates $BatchVmUpdates -Payload $Payload

        Write-CustomLog -Message "Starting new virtual machine batch" -Severity 'DEBUG'

    }

    $hostName = $DataItem.host.name

    if (-not $BatchState.DataItemsByHost.Contains($hostName)) {

        Write-CustomLog -Message "Current batch does not contain host '$hostName'. Creating new data item." -Severity 'DEBUG'

        $BatchState.DataItemsByHost[$hostName] = @{

            host = $DataItem.host

            events = @()

            virtual_machines = [System.Collections.Generic.List[NutanixHypervisorVMInfo]]::new()

        }

    }

    $BatchState.DataItemsByHost[$hostName].virtual_machines.Add($VirtualMachine)

    $BatchState.VmCount++

    $BatchState.TotalVmCount++

    $BatchState.Updates[$VirtualMachine.name] = @{

        hash        = $VirtualMachineHashDetails.hash

        lastUpdated = $LastUpdated

    }

}

function Add-ChangedVirtualMachineToBatch {

    param(

        [Parameter(Mandatory = $true)]

        [object]$DataItem,

        [Parameter(Mandatory = $false)]

        [AllowNull()]

        [NutanixHypervisorVMInfo]$VirtualMachine,

        [Parameter(Mandatory = $true)]

        [hashtable]$StorageData,

        [Parameter(Mandatory = $true)]

        [datetime]$VmMaxAge,

        [Parameter(Mandatory = $true)]

        [string]$LastUpdated,

        [Parameter(Mandatory = $true)]

        [int]$BatchSize,

        [Parameter(Mandatory = $true)]

        [pscustomobject]$BatchState,

        [Parameter(Mandatory = $true)]

        [AllowEmptyCollection()]

        [System.Collections.Generic.List[NutanixHypervisorPayload]]$Batches,

        [Parameter(Mandatory = $true)]

        [AllowEmptyCollection()]

        [System.Collections.Generic.List[hashtable]]$BatchVmUpdates,

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorPayload]$Payload

    )

    if ($null -eq $VirtualMachine -or [string]::IsNullOrWhiteSpace($VirtualMachine.name)) {

        Write-CustomLog -Message "Skipping VM with null value or missing name in host '$($DataItem.host.name)'" -Severity 'WARNING'

        return

    }

    $vmHashDetails = @{

        storageId = $VirtualMachine.name

        hash = Get-VirtualMachineHash -VirtualMachine $VirtualMachine

    }

    if (-not (Test-VirtualMachineChanged -VirtualMachineHashDetails $vmHashDetails -StorageData $StorageData -VmMaxAge $VmMaxAge)) {

        return

    }

    Add-VirtualMachineToBatch -DataItem $DataItem -VirtualMachine $VirtualMachine -VirtualMachineHashDetails $vmHashDetails -LastUpdated $LastUpdated -BatchSize $BatchSize -BatchState $BatchState -Batches $Batches -BatchVmUpdates $BatchVmUpdates -Payload $Payload

}

function Get-VirtualMachinesDiff {

    param(

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorPayload]$Payload,

        [Parameter(Mandatory = $true)]

        [NutanixConnectorConfiguration]$Config,

        [Parameter(Mandatory = $true)]

        [datetime]$Timestamp,

        [Parameter(Mandatory = $false)]

        [int]$BatchSize = $script:VM_ENRICHMENT_BATCH_SIZE

    )

    try {

        $storageData = Read-VirtualMachinesStorage -Config $Config

    }

    catch {

        Write-CustomLog -Message "Change detection for virtual machines skipped. $($_.Exception.Message)" -Severity 'ERROR'

        return

    }

    $lastUpdated = $Timestamp.ToUniversalTime().ToString('o')

    $utcTimestamp = $Timestamp.ToUniversalTime()

    $cacheExpiration = [System.Xml.XmlConvert]::ToTimeSpan($Config.NexthinkAPI.VmCacheExpiration)

    $vmMaxAge = $utcTimestamp.Add(-$cacheExpiration)

    $batches = [System.Collections.Generic.List[NutanixHypervisorPayload]]::new()

    $batchVmUpdates = [System.Collections.Generic.List[hashtable]]::new()

    $batchState = New-VirtualMachinesBatchState -Payload $Payload

    foreach ($dataItem in @($Payload.data)) {

        foreach ($vm in @($dataItem.virtual_machines)) {

            Add-ChangedVirtualMachineToBatch -DataItem $dataItem -VirtualMachine $vm -StorageData $storageData -VmMaxAge $vmMaxAge -LastUpdated $lastUpdated -BatchSize $BatchSize -BatchState $batchState -Batches $batches -BatchVmUpdates $batchVmUpdates -Payload $Payload

        }

    }

    Complete-VirtualMachinesBatch -BatchState $batchState -Batches $batches -BatchVmUpdates $batchVmUpdates -Payload $Payload

    Write-CustomLog -Message "Prepared $($batches.Count) virtual machine batches for sending" -Severity 'DEBUG'

    return [pscustomobject]@{

        Payloads    = $batches

        Storage     = $storageData

        BatchVmUpdates = $batchVmUpdates

        TotalVmCount = $batchState.TotalVmCount

    }

}

function Send-VirtualMachines {

    param(

        [Parameter(Mandatory = $true)]

        [NutanixHypervisorPayload]$Payload,

        [Parameter(Mandatory = $true)]

        [NutanixConnectorConfiguration]$Config

    )

    try {

        # We could use precisely the time at which devices were fetched,

        # but using the time at which we are preparing to send should be sufficient.

        $timestamp = Get-Date

        $diff = Get-VirtualMachinesDiff -Payload $Payload -Config $Config -Timestamp $timestamp `

            -BatchSize $Config.NexthinkAPI.RequestBatchSize

        if ($null -eq $diff -or $diff.Payloads.Count -eq 0) {

            Write-CustomLog -Message "No virtual machine changes to send" -Severity 'INFO'

            return

        }

        Write-CustomLog -Message "VMs to send after device change detection filtering: $($diff.TotalVmCount)" -Severity 'INFO'

        $requestContext = Get-HypervisorApiRequestContext -Config $Config

        $storage = $diff.Storage

        $anySent = $false

        for ($i = 0; $i -lt $diff.Payloads.Count; $i++) {

            try {

                $batchJson = ConvertTo-HypervisorPayloadJson -Payload $diff.Payloads[$i] -ExcludeHypervisorEvents

                $response = Invoke-HypervisorApi -RequestContext $requestContext -PayloadJson $batchJson

                foreach ($key in $diff.BatchVmUpdates[$i].Keys) {

                    $storage[$key] = $diff.BatchVmUpdates[$i][$key]

                }

                $anySent = $true

                Write-CustomLog -Message "Successfully sent virtual machines batch. Response code: $($response.StatusCode)" -Severity 'INFO' -NoCache

            }

            catch {

                Write-CustomLog -Message "Failed to send virtual machines batch. Error=$($_.Exception.Message)" -Severity 'ERROR' -NoCache

            }

        }

    } catch {

        Write-CustomLog -Message "Virtual machines change detection and sending failed. Details: $($_.Exception.Message)" -Severity 'ERROR'

        return

    }

    if ($anySent) {

        Save-VirtualMachinesStorage -StorageData $storage -Config $Config | Out-Null

    }

}

# SIG # Begin signature block

# MIIohQYJKoZIhvcNAQcCoIIodjCCKHICAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAECVtNZYjTMchY

# 4l1Z6dJA/s91Jw/WgXp35CBTf8XJ5qCCIZ0wggWNMIIEdaADAgECAhAOmxiO+dAt

# 5+/bUOIIQBhaMA0GCSqGSIb3DQEBDAUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQK

# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNV

# BAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0yMjA4MDEwMDAwMDBa

# Fw0zMTExMDkyMzU5NTlaMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2Vy

# dCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lD

# ZXJ0IFRydXN0ZWQgUm9vdCBHNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC

# ggIBAL/mkHNo3rvkXUo8MCIwaTPswqclLskhPfKK2FnC4SmnPVirdprNrnsbhA3E

# MB/zG6Q4FutWxpdtHauyefLKEdLkX9YFPFIPUh/GnhWlfr6fqVcWWVVyr2iTcMKy

# unWZanMylNEQRBAu34LzB4TmdDttceItDBvuINXJIB1jKS3O7F5OyJP4IWGbNOsF

# xl7sWxq868nPzaw0QF+xembud8hIqGZXV59UWI4MK7dPpzDZVu7Ke13jrclPXuU1

# 5zHL2pNe3I6PgNq2kZhAkHnDeMe2scS1ahg4AxCN2NQ3pC4FfYj1gj4QkXCrVYJB

# MtfbBHMqbpEBfCFM1LyuGwN1XXhm2ToxRJozQL8I11pJpMLmqaBn3aQnvKFPObUR

# WBf3JFxGj2T3wWmIdph2PVldQnaHiZdpekjw4KISG2aadMreSx7nDmOu5tTvkpI6

# nj3cAORFJYm2mkQZK37AlLTSYW3rM9nF30sEAMx9HJXDj/chsrIRt7t/8tWMcCxB

# YKqxYxhElRp2Yn72gLD76GSmM9GJB+G9t+ZDpBi4pncB4Q+UDCEdslQpJYls5Q5S

# UUd0viastkF13nqsX40/ybzTQRESW+UQUOsxxcpyFiIJ33xMdT9j7CFfxCBRa2+x

# q4aLT8LWRV+dIPyhHsXAj6KxfgommfXkaS+YHS312amyHeUbAgMBAAGjggE6MIIB

# NjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTs1+OC0nFdZEzfLmc/57qYrhwP

# TzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzAOBgNVHQ8BAf8EBAMC

# AYYweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdp

# Y2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNv

# bS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwRQYDVR0fBD4wPDA6oDigNoY0

# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENB

# LmNybDARBgNVHSAECjAIMAYGBFUdIAAwDQYJKoZIhvcNAQEMBQADggEBAHCgv0Nc

# Vec4X6CjdBs9thbX979XB72arKGHLOyFXqkauyL4hxppVCLtpIh3bb0aFPQTSnov

# Lbc47/T/gLn4offyct4kvFIDyE7QKt76LVbP+fT3rDB6mouyXtTP0UNEm0Mh65Zy

# oUi0mcudT6cGAxN3J0TU53/oWajwvy8LpunyNDzs9wPHh6jSTEAZNUZqaVSwuKFW

# juyk1T3osdz9HNj0d1pcVIxv76FQPfx2CWiEn2/K2yCNNWAcAgPLILCsWKAOQGPF

# mCLBsln1VWvPJ6tsds5vIy30fnFqI2si/xK4VC0nftg62fC2h5b9W9FcrBjDTZ9z

# twGpn1eqXijiuZQwggawMIIEmKADAgECAhAIrUCyYNKcTJ9ezam9k67ZMA0GCSqG

# SIb3DQEBDAUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMx

# GTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRy

# dXN0ZWQgUm9vdCBHNDAeFw0yMTA0MjkwMDAwMDBaFw0zNjA0MjgyMzU5NTlaMGkx

# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4

# RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcgUlNBNDA5NiBTSEEzODQg

# MjAyMSBDQTEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDVtC9C0Cit

# eLdd1TlZG7GIQvUzjOs9gZdwxbvEhSYwn6SOaNhc9es0JAfhS0/TeEP0F9ce2vnS

# 1WcaUk8OoVf8iJnBkcyBAz5NcCRks43iCH00fUyAVxJrQ5qZ8sU7H/Lvy0daE6ZM

# swEgJfMQ04uy+wjwiuCdCcBlp/qYgEk1hz1RGeiQIXhFLqGfLOEYwhrMxe6TSXBC

# Mo/7xuoc82VokaJNTIIRSFJo3hC9FFdd6BgTZcV/sk+FLEikVoQ11vkunKoAFdE3

# /hoGlMJ8yOobMubKwvSnowMOdKWvObarYBLj6Na59zHh3K3kGKDYwSNHR7OhD26j

# q22YBoMbt2pnLdK9RBqSEIGPsDsJ18ebMlrC/2pgVItJwZPt4bRc4G/rJvmM1bL5

# OBDm6s6R9b7T+2+TYTRcvJNFKIM2KmYoX7BzzosmJQayg9Rc9hUZTO1i4F4z8ujo

# 7AqnsAMrkbI2eb73rQgedaZlzLvjSFDzd5Ea/ttQokbIYViY9XwCFjyDKK05huzU

# tw1T0PhH5nUwjewwk3YUpltLXXRhTT8SkXbev1jLchApQfDVxW0mdmgRQRNYmtwm

# KwH0iU1Z23jPgUo+QEdfyYFQc4UQIyFZYIpkVMHMIRroOBl8ZhzNeDhFMJlP/2NP

# TLuqDQhTQXxYPUez+rbsjDIJAsxsPAxWEQIDAQABo4IBWTCCAVUwEgYDVR0TAQH/

# BAgwBgEB/wIBADAdBgNVHQ4EFgQUaDfg67Y7+F8Rhvv+YXsIiGX0TkIwHwYDVR0j

# BBgwFoAU7NfjgtJxXWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1Ud

# JQQMMAoGCCsGAQUFBwMDMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0

# cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0

# cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8E

# PDA6MDigNqA0hjJodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVz

# dGVkUm9vdEc0LmNybDAcBgNVHSAEFTATMAcGBWeBDAEDMAgGBmeBDAEEATANBgkq

# hkiG9w0BAQwFAAOCAgEAOiNEPY0Idu6PvDqZ01bgAhql+Eg08yy25nRm95RysQDK

# r2wwJxMSnpBEn0v9nqN8JtU3vDpdSG2V1T9J9Ce7FoFFUP2cvbaF4HZ+N3HLIvda

# qpDP9ZNq4+sg0dVQeYiaiorBtr2hSBh+3NiAGhEZGM1hmYFW9snjdufE5BtfQ/g+

# lP92OT2e1JnPSt0o618moZVYSNUa/tcnP/2Q0XaG3RywYFzzDaju4ImhvTnhOE7a

# brs2nfvlIVNaw8rpavGiPttDuDPITzgUkpn13c5UbdldAhQfQDN8A+KVssIhdXNS

# y0bYxDQcoqVLjc1vdjcshT8azibpGL6QB7BDf5WIIIJw8MzK7/0pNVwfiThV9zeK

# iwmhywvpMRr/LhlcOXHhvpynCgbWJme3kuZOX956rEnPLqR0kq3bPKSchh/jwVYb

# KyP/j7XqiHtwa+aguv06P0WmxOgWkVKLQcBIhEuWTatEQOON8BUozu3xGFYHKi8Q

# xAwIZDwzj64ojDzLj4gLDb879M4ee47vtevLt/B3E+bnKD+sEq6lLyJsQfmCXBVm

# zGwOysWGw/YmMwwHS6DTBwJqakAwSEs0qFEgu60bhQjiWQ1tygVQK+pKHJ6l/aCn

# HwZ05/LWUpD9r4VIIflXO7ScA+2GRfS0YW6/aOImYIbqyK+p/pQd52MbOoZWeE4w

# gga0MIIEnKADAgECAhANx6xXBf8hmS5AQyIMOkmGMA0GCSqGSIb3DQEBCwUAMGIx

# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3

# dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRydXN0ZWQgUm9vdCBH

# NDAeFw0yNTA1MDcwMDAwMDBaFw0zODAxMTQyMzU5NTlaMGkxCzAJBgNVBAYTAlVT

# MRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1

# c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYgMjAyNSBDQTEwggIi

# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0eDHTCphBcr48RsAcrHXbo0Zo

# dLRRF51NrY0NlLWZloMsVO1DahGPNRcybEKq+RuwOnPhof6pvF4uGjwjqNjfEvUi

# 6wuim5bap+0lgloM2zX4kftn5B1IpYzTqpyFQ/4Bt0mAxAHeHYNnQxqXmRinvuNg

# xVBdJkf77S2uPoCj7GH8BLuxBG5AvftBdsOECS1UkxBvMgEdgkFiDNYiOTx4OtiF

# cMSkqTtF2hfQz3zQSku2Ws3IfDReb6e3mmdglTcaarps0wjUjsZvkgFkriK9tUKJ

# m/s80FiocSk1VYLZlDwFt+cVFBURJg6zMUjZa/zbCclF83bRVFLeGkuAhHiGPMvS

# GmhgaTzVyhYn4p0+8y9oHRaQT/aofEnS5xLrfxnGpTXiUOeSLsJygoLPp66bkDX1

# ZlAeSpQl92QOMeRxykvq6gbylsXQskBBBnGy3tW/AMOMCZIVNSaz7BX8VtYGqLt9

# MmeOreGPRdtBx3yGOP+rx3rKWDEJlIqLXvJWnY0v5ydPpOjL6s36czwzsucuoKs7

# Yk/ehb//Wx+5kMqIMRvUBDx6z1ev+7psNOdgJMoiwOrUG2ZdSoQbU2rMkpLiQ6bG

# RinZbI4OLu9BMIFm1UUl9VnePs6BaaeEWvjJSjNm2qA+sdFUeEY0qVjPKOWug/G6

# X5uAiynM7Bu2ayBjUwIDAQABo4IBXTCCAVkwEgYDVR0TAQH/BAgwBgEB/wIBADAd

# BgNVHQ4EFgQU729TSunkBnx6yuKQVvYv1Ensy04wHwYDVR0jBBgwFoAU7NfjgtJx

# XWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1UdJQQMMAoGCCsGAQUF

# BwMIMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGln

# aWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5j

# b20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8EPDA6MDigNqA0hjJo

# dHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNy

# bDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwDQYJKoZIhvcNAQEL

# BQADggIBABfO+xaAHP4HPRF2cTC9vgvItTSmf83Qh8WIGjB/T8ObXAZz8OjuhUxj

# aaFdleMM0lBryPTQM2qEJPe36zwbSI/mS83afsl3YTj+IQhQE7jU/kXjjytJgnn0

# hvrV6hqWGd3rLAUt6vJy9lMDPjTLxLgXf9r5nWMQwr8Myb9rEVKChHyfpzee5kH0

# F8HABBgr0UdqirZ7bowe9Vj2AIMD8liyrukZ2iA/wdG2th9y1IsA0QF8dTXqvcnT

# mpfeQh35k5zOCPmSNq1UH410ANVko43+Cdmu4y81hjajV/gxdEkMx1NKU4uHQcKf

# ZxAvBAKqMVuqte69M9J6A47OvgRaPs+2ykgcGV00TYr2Lr3ty9qIijanrUR3anzE

# wlvzZiiyfTPjLbnFRsjsYg39OlV8cipDoq7+qNNjqFzeGxcytL5TTLL4ZaoBdqbh

# OhZ3ZRDUphPvSRmMThi0vw9vODRzW6AxnJll38F0cuJG7uEBYTptMSbhdhGQDpOX

# gpIUsWTjd6xpR6oaQf/DJbg3s6KCLPAlZ66RzIg9sC+NJpud/v4+7RWsWCiKi9EO

# LLHfMR2ZyJ/+xhCx9yHbxtl5TPau1j/1MIDpMPx0LckTetiSuEtQvLsNz3Qbp7wG

# WqbIiOWCnb5WqxL3/BAPvIXKUjPSxyZsq8WhbaM2tszWkPZPubdcMIIG7TCCBNWg

# AwIBAgIQCE/cM09+RU7bww+P+ZIYNTANBgkqhkiG9w0BAQsFADBpMQswCQYDVQQG

# EwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0

# IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0Ex

# MB4XDTI2MDgwNTAwMDAwMFoXDTM3MTEwNDIzNTk1OVowYzELMAkGA1UEBhMCVVMx

# FzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBTSEEy

# NTYgUlNBNDA5NiBUaW1lc3RhbXAgUmVzcG9uZGVyIDIwMjYgMTCCAiIwDQYJKoZI

# hvcNAQEBBQADggIPADCCAgoCggIBALZ7pvLJ/s1K+NSbTGWz/TjGMPh8CQ6RucZC

# Lv5anHzWJjF/NWJrFIhy24fcpKXlgRiky4WAawDfU3YP0BMxt9l3Dm5oCG5Z69Aq

# EN1kgHg2epx+l+lZBcmJCcN0ASURML5uFIS80sZsDwO3BSkUxDjLJhBI+qiZP3ai

# xAC/qEGLjsBNlLol9VZ7pfGEXiMlneJIC5/YKuizVzNFKZZEeoy/0B8Zm+nzKBgS

# WG52lCO1w+nCg6XpCtklTJXeIg283hw7TmmsZXR+SMbjbrEOvZ3fP2VxIgeR28Y9

# 0ZStd3F9VuA5RVynb/whITPAo9b75Zr4Ta6Mj3URm26QZYMn/FnbuTegcoRcFEZ9

# FOqM5T6MTdtr/n74lIT/ug0eeOzmZ6QTFg33otX+bFRsIolvykE1jive4PuESaT8

# zzVeFWDAMDtozNgLctkGD1ZjkEyZtJrLl5ya0m5doH/ScpaZCZVl6pNUOCybMc/k

# xC6EAmSJY24L0yYKD1Nkddsnb/ItVKi/2nXpQNMu1PT5prW83vV8d67WowuUs0Hd

# Y4H8AMLGvdL/WHEj3ZnqMqAQQP9u3Ai9t+5eQ02GDwy0ODjdzi0xlp70W+ow63/0

# ++YDEX1M0iwgUHwbrJvfpklkZQvw3+kv3vUPItdwroczk9icflf55W1zOEKAcJVA

# IXpcMCU9AgMBAAGjggGVMIIBkTAMBgNVHRMBAf8EAjAAMB0GA1UdDgQWBBQUyWOK

# MC7USvtulPPm40B+9ezN4jAfBgNVHSMEGDAWgBTvb1NK6eQGfHrK4pBW9i/USezL

# TjAOBgNVHQ8BAf8EBAMCB4AwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwgZUGCCsG

# AQUFBwEBBIGIMIGFMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5j

# b20wXQYIKwYBBQUHMAKGUWh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdp

# Q2VydFRydXN0ZWRHNFRpbWVTdGFtcGluZ1JTQTQwOTZTSEEyNTYyMDI1Q0ExLmNy

# dDBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGln

# aUNlcnRUcnVzdGVkRzRUaW1lU3RhbXBpbmdSU0E0MDk2U0hBMjU2MjAyNUNBMS5j

# cmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEB

# CwUAA4ICAQCNxTphHp1SCt+ZrAmAfn0oQLFr0mLywSLaDXQIENoyKqxrFbJblzCV

# P/pkXmwXOdrOpWygLzlT12os5ipDCy35RBCg2UMeApEtrfGhz45F4Wt4WGdNdIbR

# Wt3YTYJmpR+b7lr4d7Uwn+H600u4D7RnOGf8Wj4UNgAdZkfHhHv1mx9EVh71SJel

# cEN/oORSjXzdjfw1iZH9d8Nh/thn6hH23d+VsPAr6GAYyzSA02nXD1nYLI7Ijmiv

# +xLCiYC41DSFYL3GhTiy0PxpawPtGRyaBVGzq+UiTfM8pD7KVyF5aQyWP4KhVGUU

# Tnmm/RlYJoW3TiXA/+t0YcT2oRVBm3JETjajHug2AL+v5jhtKVnd3D0rbHXEu27o

# +Q8p4sEWPMqKDB+qbceb6T/6WcwTwXmQ9lOCLLYcsQeSWmvKqzpAec9etE14jOQA

# zLKWdE3w/TCaKtLRaRT7LCkRYVnhA2D73FLje1O5b3HR5eHs0NzU/+xX7NbEdcof

# y0W3Wdwd1XOqtlpg/JgwtKfZM5dqO94lbUveOiJBI+xZEbGRsMNbXmMREUTgu+Oc

# a7Y73MPWcslIx2VhkSKSXjDbD6rgg39H5Mh7QfieAIjWagkJNt68Yfim6cjEzVSi

# LSeZfdkr5dtFPTW6jATlWJdYeeDRGCyatf8R1hSjzSvdN8yWQPT9gzCCB6swggWT

# oAMCAQICEA20PGu9jXp4I/Dy4yL8Si8wDQYJKoZIhvcNAQELBQAwaTELMAkGA1UE

# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy

# dCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENB

# MTAeFw0yNTExMTMwMDAwMDBaFw0yODExMTQyMzU5NTlaMIGzMRMwEQYLKwYBBAGC

# NzwCAQMTAkNIMRUwEwYLKwYBBAGCNzwCAQITBFZhdWQxHTAbBgNVBA8MFFByaXZh

# dGUgT3JnYW5pemF0aW9uMRgwFgYDVQQFEw9DSEUtMTEyLjAwMC41NzkxCzAJBgNV

# BAYTAkNIMQ8wDQYDVQQHEwZQcmlsbHkxFjAUBgNVBAoTDU5FWFRoaW5rIFMuQS4x

# FjAUBgNVBAMTDU5FWFRoaW5rIFMuQS4wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw

# ggIKAoICAQDIbNJpFq6aDbvQP7zFPymmt3WRPkvbmnRL4g0imzFNbaj+U/RIGPL0

# 3l9TtYxzraPbwDdidmT5P50mK1JqjF5FzcZEC4kZfMMojY4J/gOylo8jOdLjBscL

# SYwsY+85ZRs2bvxibPXIu4AcZttxBx5XdbVyt2Bd1vtuJGj+wfU1vJu7NB3GHjPy

# 4QE1BFrgidqQTL+1HASQaWwNMetW8B1U1POZjr6uWp6Ga3DF/MAKxpbvU3iVFI8b

# YFpKiVIQ9Namj3DQ7Xj26+fSEP959+bukG8LyObHN5DDkRdpnCSVVMT6qxZ2QGri

# DFkyjOVaGkjJTI6mbKY1JPUJhYVo+7Jqhu+2EFGRy6wSj9wZBubnbwfuvgr/XlH9

# /xQQuX9i/EJvxJRQQyz9IzLtB/DBSoEQvtyCh8Po87k9x9CGYn7k1HxUg1F6oBKa

# kemv3G474RWKZwSEIbwUlygFydEpTDkRTqBDZKOQf3VaUvfUgGmBmEfq1m+cljHj

# fLDBtkDIGaZ7SvyO72q9Uj0HrIWvJDHHIYK84gqhe58vKgaQ0uH9V5BCUT5cLvau

# +1w93iq5AMCTtG96SEyjI/T9Jzh+2sM+PoUwlLNLqYFUvMI+l19X+5UtQnjU5k1c

# ooxqCebatsS642gd3X1VoeNyfJ5FB67b6KGNfrDOXBt5FXgKZAUOHwIDAQABo4IC

# AjCCAf4wHwYDVR0jBBgwFoAUaDfg67Y7+F8Rhvv+YXsIiGX0TkIwHQYDVR0OBBYE

# FICGOh06CZAfMG3M4l2zy9590p0OMD0GA1UdIAQ2MDQwMgYFZ4EMAQMwKTAnBggr

# BgEFBQcCARYbaHR0cDovL3d3dy5kaWdpY2VydC5jb20vQ1BTMA4GA1UdDwEB/wQE

# AwIHgDATBgNVHSUEDDAKBggrBgEFBQcDAzCBtQYDVR0fBIGtMIGqMFOgUaBPhk1o

# dHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRDb2RlU2ln

# bmluZ1JTQTQwOTZTSEEzODQyMDIxQ0ExLmNybDBToFGgT4ZNaHR0cDovL2NybDQu

# ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0Q29kZVNpZ25pbmdSU0E0MDk2

# U0hBMzg0MjAyMUNBMS5jcmwwgZQGCCsGAQUFBwEBBIGHMIGEMCQGCCsGAQUFBzAB

# hhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wXAYIKwYBBQUHMAKGUGh0dHA6Ly9j

# YWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNENvZGVTaWduaW5n

# UlNBNDA5NlNIQTM4NDIwMjFDQTEuY3J0MAkGA1UdEwQCMAAwDQYJKoZIhvcNAQEL

# BQADggIBALSLCU45H6xjr2Ce9mmr6WtqdnykOcc2s1iqd/UN88f4GlmzVmtA9Dts

# 9j8X77hxHYIAJwWM3NqKi8m55CB5HQBuOC3hOI8bWFdQLBsrAbBAApFh3cjRruGn

# r0mu7wlZo9HLgpM1PEy+hf90+cANYRBITrRkfVT4o2rTc8mmJyYzZM8WVwxGx+wm

# PAuvyjYKsjZNTeJ+miYqwJ/zHjc8LQP+/hYPNmP9ubYpMMkgC49vP9Uir0E4YI2C

# VTbUuhxao4Pmy2MnqhK20lDu50ZCNDNFurYhzXWBhK1cel6Ku4yuT6TlsjNye0AY

# v92FDyAaYH9VZuub7qZBNv/RwmcLUDqqh5rnEdeGMH7KFkUyN63RMEr7hLXV/Tav

# 7K0kWlXKPLIFenfqJnPYceni6PdJS/7WlxnBE0UwgoSoe4HawnEF0YvYBU3uyK+v

# TJWVau5Jptjp94uEQmW6PidWwUWNzVl4LQ7eEZe4ykZ0JLErbGnOeoUoZCeVzpx4

# uUEFiZv1KLeLEkB/8yFIrQp03sVMItqhNJ5mbDOoWW4y3Z8/jduhxVPwJMHhgglK

# 3z3sZr5xrpY3n1Qcqn1xFsI6U7rOrkzyQBw+d/yF82MW3LldZ7tPyU8LTEO89oOC

# EsGFwOfEb/wB7UJ1NulZ1R2nf5erYEnVsOsrGV0X1fYh2OoRQyxWMYIGPjCCBjoC

# AQEwfTBpMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/

# BgNVBAMTOERpZ2lDZXJ0IFRydXN0ZWQgRzQgQ29kZSBTaWduaW5nIFJTQTQwOTYg

# U0hBMzg0IDIwMjEgQ0ExAhANtDxrvY16eCPw8uMi/EovMA0GCWCGSAFlAwQCAQUA

# oGowGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwG

# CisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIB6k58C4+zn0phdx7lsDoqn4it+U

# 2NJBGxg8j0OFK8ODMA0GCSqGSIb3DQEBAQUABIICAFVfRXJbzXAoc+wo+zzzDRra

# FivNEWBGukGZChxUN1o3SmMoMvjsHPfNSK1Yzd9b/TERavZZxldcx73pEDQevIiZ

# CyZnvTys2SiJJBln+qap/bfGeIa51s/B3FUnAMHk6130cK8QWqRppwRZZj/5ib9E

# 7h8C7nOGdlPttvp9QbFcNioPMjZtKmECCCUa/Szp48eq7t8cKNmOUXTSmIA7tTy0

# MSv6FZnxX2wx4cIPOo7VbbOxW9DTSe05mle4a55vv9ZuO/pyJ9OQu4yEBJu3SfHJ

# llBEMkkt3bJx3AmDOtrEi24s5yhVMieW8A7OJq32fyWti/H58KP3MQ6+7pKqACkh

# awwmAf/9rgHcB5ZBEEaXAp0sbwUzGLajKL3pkKQXP33GBUZt/CabOXHpgF+140G9

# 2nsgUxCxCWMwtJlyzVVM5ylbg0m8pu1uWt4WIP4JsF36hINq4Wg713lK1QAPxA2H

# cf0yrra8OaskRvMJPwYwUbhL2USwzqVoLtGwP8gbXv0WdYbCYB4CEwCCuUREQEED

# jsshgL/5yTYMErMYKxNRvonl+9CSWShYHPz1H1sWwjongx7WPpFbuB+2qgaH372D

# RRxYoLeUy/Uwuyo8GAQyy3ti4+4VKFG9Ly9ssWMhn5IHk/CfbX2nxJ0iwOg2xQNf

# djS9z4BtSGprLwUL8amPoYIDJjCCAyIGCSqGSIb3DQEJBjGCAxMwggMPAgEBMH0w

# aTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQD

# EzhEaWdpQ2VydCBUcnVzdGVkIEc0IFRpbWVTdGFtcGluZyBSU0E0MDk2IFNIQTI1

# NiAyMDI1IENBMQIQCE/cM09+RU7bww+P+ZIYNTANBglghkgBZQMEAgEFAKBpMBgG

# CSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTI2MTAyMTA4

# NDUyNVowLwYJKoZIhvcNAQkEMSIEIH2uCa32Q1mR61cVJ4LHFx2OekfIajynLj9T

# iN2k7WAmMA0GCSqGSIb3DQEBAQUABIICAF0Cra7ml2HS+FpAeLFjymlr8Rnlaonc

# /21zBlVuyDaXLjgBb+OW5ybe7Q2+Pb8siG7pQepLfjB2UpRqrJWQ0+AkKd8DNUyk

# nX+HvRdYn8PoZDZl28kIKwj/zrF3XrgY417BbL30psphnh4XDNafb3bZ1ooRBEnG

# t2VmcVU5OSXe94EIkfGL0zboDp7thAUaueRueALmYi9T2DU2KahSouMTgeqP25My

# yVKj6TVmdmntTrb3+SiGCQLcVaaAVr+6Es+riDvnX4dMGUvWtvSPCeelX0RHJ6me

# KYJn0lxOxzvoyx+c4cjjEi5NQqZb1YRwOLk/XDJjxZfGrlZ1ckiGYDKxDR1dYs8g

# m5B4yi/g4xLCUCHf+eR1BY4S9nnJvNUAGw3ZT1pmgyZQLzk6HQiE2E09++dJhR5s

# QpO07435vdnF+BedaZuRnlk7kwo+MvzfxYhSqDp5SY/s9eBtjwbxZuA5QQdUpbk0

# f5CzquwoCsoteiarSC1dL2+aZCaKJC3B45wFf4lojPmTPBIuKEdu1eRkaF/yyxHT

# Cz2SQoLCV24h0XGkE7V5NcB5RMXeZDRtC8tZjVSUlFlC2AdGPdKWWtQOqiWx8eim

# HcQx0e61t+rcbmG6uDtBxNn0D0DK6yk+Pg3xTNCkfCZYWekPhP3kfxcJ9vOMm5gc

# LEnVxhjXW0dt

# SIG # End signature block