Nexthink-Nutanix-Connector

0.0.7-beta

Private/Configuration.ps1

                                <#

This is the first function called in the connector workflow.

At this stage, the logger is not initialized yet, so this function must not rely on

`Write-CustomLog` (or any logging target setup). It should fail fast with clear

exceptions when configuration is missing or invalid.

#>

function Get-Configuration {

    [CmdletBinding()]

    param(

        [Parameter(Mandatory = $true)]

        [string]$ScriptRootPath,

        [Parameter(Mandatory = $true)]

        [string]$NutanixEnvironment

    )

    $configPath = Join-Path -Path $ScriptRootPath -ChildPath (Join-Path -Path "Config" -ChildPath "config.json")

    if (-not (Test-Path -Path $configPath)) {

        # The repository uses lowercase config/, while packaged Windows bundles use Config/.

        $configPath = Join-Path -Path $ScriptRootPath -ChildPath (Join-Path -Path "config" -ChildPath "config.json")

    }

    if (-not (Test-Path -Path $configPath)) {

        throw "Configuration file not found at: $configPath"

    }

    $raw = Get-Content -Path $configPath -Raw -ErrorAction Stop

    if ([string]::IsNullOrWhiteSpace($raw)) {

        throw "Invalid configuration: configuration file is empty. Path: $configPath"

    }

    try {

        $config = $raw | ConvertFrom-Json -ErrorAction Stop

    }

    catch {

        throw "Invalid configuration: configuration file is not valid JSON. Path: $configPath. Error: $($_.Exception.Message)"

    }

    if ($null -eq $config) {

        throw "Invalid configuration: config object is null. Path: $configPath"

    }

    # Fail fast on required high-level structure so later environment selection doesn't produce misleading errors.

    if ($null -eq $config.nutanixEnvironments -or -not ($config.nutanixEnvironments -is [System.Array])) {

        throw "Invalid configuration: 'nutanixEnvironments' is required and must be an array."

    }

    if ($config.nutanixEnvironments.Count -eq 0) {

        throw "Invalid configuration: 'nutanixEnvironments' must not be empty."

    }

    $envConfig = $config.nutanixEnvironments | Where-Object { $_.Name -eq $NutanixEnvironment }

    if ($null -eq $envConfig) {

        throw "Environment '$NutanixEnvironment' not found in configuration"

    }

    Test-ConnectorConfiguration -Config $config -EnvironmentConfig $envConfig

    $typedEnvConfig = [NutanixEnvironmentConfiguration]::new()

    $typedEnvConfig.Name = $envConfig.Name

    $typedEnvConfig.PrismCentralFQDN = $envConfig.PrismCentralFQDN

    if ($null -ne $envConfig.PSObject.Properties['PrismCentralPort']) {

        $typedEnvConfig.PrismCentralPort = [int]$envConfig.PrismCentralPort

    }

    $typedEnvConfig.WindowsCredentialEntry = $envConfig.WindowsCredentialEntry

    $typedEnvConfig.SkipCertificateCheck = $false

    if ($null -ne $envConfig.PSObject.Properties['SkipCertificateCheck']) {

        $typedEnvConfig.SkipCertificateCheck = [bool]$envConfig.SkipCertificateCheck

    }

    $typedNexthinkApi = [NutanixNexthinkApiConfiguration]::new()

    $typedNexthinkApi.HostFQDN = $config.NexthinkAPI.HostFQDN

    $typedNexthinkApi.LoginFQDN = $config.NexthinkAPI.LoginFQDN

    $typedNexthinkApi.WindowsCredentialEntry = $config.NexthinkAPI.WindowsCredentialEntry

    $typedNexthinkApi.RequestBatchSize = [int]$config.NexthinkAPI.RequestBatchSize

    $typedNexthinkApi.VmCacheExpiration = $script:VM_CACHE_EXPIRATION

    if (Test-ConfigurationCacheExpiration -Value $config.NexthinkAPI.VmCacheExpiration) {

        $typedNexthinkApi.VmCacheExpiration = $config.NexthinkAPI.VmCacheExpiration

    }

    $typedLogging = $null

    if ($null -ne $config.Logging) {

        $typedLogging = [NutanixLoggingConfiguration]::new()

        $typedLogging.LogLevel = $config.Logging.LogLevel

        $typedLogging.LogRetentionDays = $config.Logging.LogRetentionDays

    }

    $cfg = [NutanixConnectorConfiguration]::new()

    $cfg.ScriptRootPath = $ScriptRootPath

    $cfg.EnvironmentConfig = $typedEnvConfig

    $cfg.NexthinkAPI = $typedNexthinkApi

    $cfg.Logging = $typedLogging

    return $cfg

}

function Stop-ConfigError {

    param([string]$Message)

    Write-Error -Message $Message

    throw $Message

}

function Assert-ConfigurationNonEmptyString {

    param(

        [string]$Value,

        [string]$FieldName

    )

    if ([string]::IsNullOrWhiteSpace($Value)) {

        Stop-ConfigError "Invalid configuration: '$FieldName' is required and must be a non-empty string."

    }

}

function Test-ConfigurationPort {

    param([object]$EnvironmentConfig)

    if ($null -eq $EnvironmentConfig.PSObject.Properties['PrismCentralPort']) {

        return

    }

    $port = 0

    if (-not [int]::TryParse([string]$EnvironmentConfig.PrismCentralPort, [ref]$port) -or $port -lt 1 -or $port -gt 65535) {

        Stop-ConfigError "Invalid configuration: 'nutanixEnvironments[].PrismCentralPort' must be between 1 and 65535."

    }

}

function Test-ConfigurationSkipCertificateCheck {

    param([object]$EnvironmentConfig)

    if ($null -ne $EnvironmentConfig.PSObject.Properties['SkipCertificateCheck'] -and

        $EnvironmentConfig.SkipCertificateCheck -isnot [bool]) {

        Stop-ConfigError "Invalid configuration: 'nutanixEnvironments[].SkipCertificateCheck' must be a JSON boolean."

    }

}

function Test-ConfigurationLogging {

    param([object]$Logging)

    if ($null -eq $Logging) {

        return

    }

    if ($null -ne $Logging.LogLevel -and -not [string]::IsNullOrWhiteSpace([string]$Logging.LogLevel)) {

        $allowed = @('DEBUG', 'INFO', 'WARNING', 'ERROR')

        if ($allowed -notcontains ([string]$Logging.LogLevel).ToUpperInvariant()) {

            Stop-ConfigError "Invalid configuration: 'Logging.LogLevel' must be one of: $($allowed -join ', '). Value: '$($Logging.LogLevel)'"

        }

    }

    if ($null -ne $Logging.LogRetentionDays -and -not [string]::IsNullOrWhiteSpace([string]$Logging.LogRetentionDays)) {

        $retention = 0

        if (-not [int]::TryParse([string]$Logging.LogRetentionDays, [ref]$retention) -or $retention -le 0) {

            Stop-ConfigError "Invalid configuration: 'Logging.LogRetentionDays' must be a positive integer. Value: '$($Logging.LogRetentionDays)'"

        }

        $Logging.LogRetentionDays = $retention

    }

}

function Test-ConfigurationNexthinkApi {

    param([object]$NexthinkApi)

    if ($null -eq $NexthinkApi) {

        Stop-ConfigError "Invalid configuration: 'NexthinkAPI' section is required."

    }

    Assert-ConfigurationNonEmptyString -Value $NexthinkApi.HostFQDN -FieldName 'NexthinkAPI.HostFQDN'

    Assert-ConfigurationNonEmptyString -Value $NexthinkApi.LoginFQDN -FieldName 'NexthinkAPI.LoginFQDN'

    Assert-ConfigurationNonEmptyString -Value $NexthinkApi.WindowsCredentialEntry -FieldName 'NexthinkAPI.WindowsCredentialEntry'

    $batchSize = 0

    if ($null -eq $NexthinkApi.RequestBatchSize -or

        -not [int]::TryParse([string]$NexthinkApi.RequestBatchSize, [ref]$batchSize) -or

        $batchSize -le 0) {

        Stop-ConfigError "Invalid configuration: 'NexthinkAPI.RequestBatchSize' must be a positive integer."

    }

    $NexthinkApi.RequestBatchSize = $batchSize

    $null = Test-ConfigurationCacheExpiration -Value $NexthinkApi.VmCacheExpiration

}

function Test-ConnectorConfiguration {

    [CmdletBinding()]

    param(

        [Parameter(Mandatory = $true)]

        [AllowNull()]

        [object]$Config,

        [Parameter(Mandatory = $true)]

        [object]$EnvironmentConfig

    )

    Write-CustomLog -Message "Validating configuration..." -Severity 'DEBUG'

    if ($null -eq $Config) {

        Stop-ConfigError "Invalid configuration: config object is null."

    }

    if ($null -eq $Config.nutanixEnvironments -or -not ($Config.nutanixEnvironments -is [System.Array])) {

        Stop-ConfigError "Invalid configuration: 'nutanixEnvironments' is required and must be an array."

    }

    if ($Config.nutanixEnvironments.Count -eq 0) {

        Stop-ConfigError "Invalid configuration: 'nutanixEnvironments' must not be empty."

    }

    # Validate selected environment config

    Assert-ConfigurationNonEmptyString -Value $EnvironmentConfig.Name -FieldName 'nutanixEnvironments[].Name'

    Assert-ConfigurationNonEmptyString -Value $EnvironmentConfig.PrismCentralFQDN -FieldName 'nutanixEnvironments[].PrismCentralFQDN'

    Assert-ConfigurationNonEmptyString -Value $EnvironmentConfig.WindowsCredentialEntry -FieldName 'nutanixEnvironments[].WindowsCredentialEntry'

    Test-ConfigurationPort -EnvironmentConfig $EnvironmentConfig

    Test-ConfigurationSkipCertificateCheck -EnvironmentConfig $EnvironmentConfig

    Test-ConfigurationNexthinkApi -NexthinkApi $Config.NexthinkAPI

    # Optional logging settings validation

    Test-ConfigurationLogging -Logging $Config.Logging

    Write-CustomLog -Message "Configuration validated successfully." -Severity 'DEBUG'

}

function Test-ConfigurationCacheExpiration {

    [CmdletBinding()]

    param(

        [Parameter(Mandatory = $true)]

        [AllowNull()]

        $Value

    )

    if ($null -eq $Value -or [string]::IsNullOrWhiteSpace([string]$Value)) {

        return $false

    }

    $valueStr = [string]$Value

    try {

        $null = [System.Xml.XmlConvert]::ToTimeSpan($valueStr)

        return $true

    }

    catch {

        throw "Invalid configuration: 'VmCacheExpiration' must be an ISO 8601 duration (e.g. 'P1D', 'PT1H', 'PT30M'). Value: '$valueStr'"

    }

}

# SIG # Begin signature block

# MIIohQYJKoZIhvcNAQcCoIIodjCCKHICAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCB1162iKWmz8U7x

# fJ5flljA15TBQpeHK4NLlBN0WxK6WKCCIZ0wggWNMIIEdaADAgECAhAOmxiO+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

# CisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIJWnDB8il09/gSjDLVYom+U5K4Qz

# oobeo+uBLdVb8xw9MA0GCSqGSIb3DQEBAQUABIICALc0HJcUzpzVtpAvf8LZD4mb

# W0DubNSfQhI/aLlpzH246Fk9gg2mw1LT5Q4IYdzWJAw2sy50OmmAumyZCg010JN5

# 47ssH/qMq2UQbK+G5NfGPIg0vtMY8spQI4SDnwdp6kSuCZBioCUc3JLnpFMVDHqG

# pgl4GtE/5wiCkJdHy/pyLTbBspj0aH7CXhxwYSZYLpcwF1xU6fCTRgCQl/pFSUG0

# 5VzkUvrvzkhfZARhVWz1kc9sYmKgAxaWd+DOPU894qdpduUmlKHT+xaZ5o/TYtUT

# F16BtCja0yCalFaatEXTxcGqSTa9DNJQ0SrDwwDmtkNe/cXIf9dK67oy96i7EoQJ

# WNJRsSMYZ7n5WY5tvWK1hDdf9MxGNzbQxNXFzIIdGi1UhfGfOJptYJA9dkTSKXaI

# 5oWdYwGltrbYORmxsXG1snuZIltvTgi68E7H9bqSxX3M/K/iHSDPLYk/nPLj045r

# wJXCibR70wMP9ocPh3cRVojHa6Yu1suMmeEi14DObmc9QFrZb2Oxh46PZa1jjWYK

# /AXpKGkPwyzmS7C+XTo7uA8Owid9X1mRFk52U1wcMJv+2FOus6uL/cbCSOyFwahj

# z6p+pMp3ObTKirGegvYOKPQtkMMWJnbBTGZOizMgue87PsSj0oMYJbnGCEpVBM2h

# S8rKYY1T5i04f/QJegdmoYIDJjCCAyIGCSqGSIb3DQEJBjGCAxMwggMPAgEBMH0w

# aTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQD

# EzhEaWdpQ2VydCBUcnVzdGVkIEc0IFRpbWVTdGFtcGluZyBSU0E0MDk2IFNIQTI1

# NiAyMDI1IENBMQIQCE/cM09+RU7bww+P+ZIYNTANBglghkgBZQMEAgEFAKBpMBgG

# CSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTI2MTAyMTA4

# NDQzM1owLwYJKoZIhvcNAQkEMSIEIARjQfi9Fo5qNX6Fps8ZI82EOUGuBrZl15f6

# 0o5aDAZHMA0GCSqGSIb3DQEBAQUABIICAJU/3t0+7RGc47MsLqNN+1Kldsbx4iJ5

# 93fqsNjvUyKTbhDKUiLSKk0aiRnJe7xRjHP+OzyMY7kwDu8Z8mnyc/yOgDS4sG55

# I09W7fBH0xBBVo/v81uun+Y/52WwN4AOzOpj2AGvuDjuPp6ESq//N+YIaqxjJwQ/

# 5aBbrK4/W8uQLKW/uH/l/bVvAoasagFf3KBtSCHEFcFXX3u4siKgLibT9SvroZTc

# V7I4v8uBzeKIqcMZ121TCSY2i6WHU4PTG2xadiwOEElK+gp8eZFE/WmCrg+KXDGH

# DJQxE5uL9X4NnFEjzRvfAUQrSS/hC5rEmvTysU9z0MK1kNBWRsg0HitfwvTe+Btt

# +xI2waqZ/kwG3UhkN4P1HcEOY/Vyq7lyrpA63q/kqg72Fzl7OqyJ9MpJy//Q+TiJ

# 1TeR85QTAiHgyEk64BBkMMKk/nLyDzbjWbzTg9m2EzaHoFuqEbiqNKj43RJiu/hg

# b1qaLjQny/sFUMolhXr0PUWzDfWyRl8dBWB7uLtoBzPyxPaMgvc6UNCdyOXiwMCx

# TweEZ4eLbOVuOyzE6d9Ch73yjcLjFpaQzBDk/5jodE4SVWgM8ODvD+qSIWqiDzMH

# Rj28I6bVkc//0i72w9nvffTsUfIs8j4UtPbavHPRTqJzCdxhpg2vKowHthw7QrIr

# 3fzQ7FlytTfb

# SIG # End signature block