WhatsUpGoldPS

0.1.21

helpers/geolocation/Setup-GeolocationConfig.ps1

                                <#

.SYNOPSIS

    One-time setup script that configures WhatsUp Gold geolocation map generation.

.DESCRIPTION

    Interactive setup script that prompts the administrator for their WhatsUp Gold

    server connection details, validates the connection, and saves the configuration

    to the DPAPI vault for use by the scheduled map generation script

    (Update-GeolocationMap.ps1).

    The saved config includes the server URI, protocol, port, tile provider API

    keys, and a refresh token, all encrypted with DPAPI and stored in the vault

    at %LOCALAPPDATA%\WhatsUpGoldPS\DiscoveryHelpers\Vault. Only the same user on the same

    machine can decrypt them. No plaintext passwords are stored.

.PARAMETER WugServer

    The hostname or IP of the WhatsUp Gold server. If omitted, prompts interactively.

.PARAMETER Protocol

    http or https (default: https).

.PARAMETER Port

    The WUG API port (default: 9644).

.PARAMETER WugConsoleUrl

    The base URL of the WhatsUp Gold web console for clickable markers.

    Example: https://wug.example.com:443

    If omitted, prompts interactively.

.PARAMETER DefaultLat

    Default map centre latitude (default: 39.8283 - U.S. centre).

.PARAMETER DefaultLng

    Default map centre longitude (default: -98.5795 - U.S. centre).

.PARAMETER DefaultZoom

    Default map zoom level (default: 5).

.PARAMETER GroupName

    Optional device group name to filter devices. Default: "All".

.PARAMETER UseBuiltinCoords

    Use separate "Latitude"/"Longitude" attributes instead of a single "LatLong" attribute.

.PARAMETER IncludeDevices

    Show devices on the map (default: $true).

.PARAMETER IncludeGroups

    Show groups on the map (default: $true).

.PARAMETER IgnoreSSLErrors

    Bypass SSL certificate validation when connecting to WUG.

.EXAMPLE

    .\Setup-GeolocationConfig.ps1

    Prompts interactively for all required values.

.EXAMPLE

    .\Setup-GeolocationConfig.ps1 -WugServer "192.168.1.100" -WugConsoleUrl "https://192.168.1.100"

    Provides server details on the command line; prompts only for credentials.

.NOTES

    Author  : jason@wug.ninja

    Version : 1.0.0

    Date    : 2025-07-15

    Requires: PowerShell 5.1+, network access to WUG REST API

#>

param(

    [string]$WugServer,

    [ValidateSet("http","https")][string]$Protocol = "https",

    [ValidateRange(1,65535)][int]$Port = 9644,

    [string]$WugConsoleUrl,

    [double]$DefaultLat   = 39.8283,

    [double]$DefaultLng   = -98.5795,

    [int]$DefaultZoom     = 5,

    [string]$GroupName    = 'All',

    [switch]$UseBuiltinCoords,

    [bool]$IncludeDevices = $true,

    [bool]$IncludeGroups  = $true,

    [switch]$IgnoreSSLErrors

)

# ----- Resolve paths -----

$scriptDir = Split-Path $MyInvocation.MyCommand.Path -Parent

# Dot-source the helpers

$helpersPath = Join-Path $scriptDir 'GeolocationHelpers.ps1'

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

    throw "GeolocationHelpers.ps1 not found at: $helpersPath"

}

. $helpersPath

# Load vault functions

$discoveryHelpersPath = Join-Path (Split-Path $scriptDir -Parent) 'discovery\DiscoveryHelpers.ps1'

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

    throw "DiscoveryHelpers.ps1 not found at: $discoveryHelpersPath"

}

. $discoveryHelpersPath

# ----- Interactive prompts -----

Write-Host "`n=== WhatsUp Gold Geolocation Map - Setup ===" -ForegroundColor Cyan

if (-not $WugServer) {

    $WugServer = Read-Host "Enter the WhatsUp Gold server hostname or IP"

    if ([string]::IsNullOrWhiteSpace($WugServer)) { throw "Server address is required." }

}

$cred = Get-Credential -Message "Enter WhatsUp Gold credentials (used to obtain API token)"

$username = $cred.GetNetworkCredential().UserName

$password = $cred.GetNetworkCredential().Password

if (-not $WugConsoleUrl) {

    $WugConsoleUrl = Read-Host "Enter the WUG web console base URL (e.g. https://wug.example.com:443) [press Enter to skip]"

}

# ----- Connect & validate -----

Write-Host "`nConnecting to ${Protocol}://${WugServer}:${Port}..." -ForegroundColor Yellow

$connectParams = @{

    ServerUri      = $WugServer

    Username       = $username

    Password       = $password

    Protocol       = $Protocol

    Port           = $Port

}

if ($IgnoreSSLErrors) { $connectParams.IgnoreSSLErrors = $true }

$config = Connect-GeoWUGServer @connectParams

$password = $null

# Quick API validation - fetch product info

try {

    $apiInfo = Invoke-GeoAPI -Config $config -Endpoint "/api/v1/product/api"

    Write-Host "API version: $($apiInfo.data.apiVersion) - WhatsUp Gold $($apiInfo.data.productVersion)" -ForegroundColor Green

}

catch {

    Write-Warning "Connected but could not verify API version: $($_.Exception.Message)"

}

# ----- Build vault config fields -----

$configFields = @{}

foreach ($item in @(

    @('ServerUri',        $WugServer),

    @('Protocol',         $Protocol),

    @('Port',             [string]$Port),

    @('IgnoreSSL',        [string][bool]$IgnoreSSLErrors),

    @('WugConsoleUrl',    $(if ($WugConsoleUrl) { $WugConsoleUrl } else { '' })),

    @('DefaultLat',       [string]$DefaultLat),

    @('DefaultLng',       [string]$DefaultLng),

    @('DefaultZoom',      [string]$DefaultZoom),

    @('GroupName',        $GroupName),

    @('UseBuiltinCoords', [string][bool]$UseBuiltinCoords),

    @('IncludeDevices',   [string]$IncludeDevices),

    @('IncludeGroups',    [string]$IncludeGroups)

)) {

    $configFields[$item[0]] = ConvertTo-SecureString -String $item[1] -AsPlainText -Force

}

# ----- Optional tile provider API keys (DPAPI encrypted) -----

Write-Host "`n=== Tile Provider API Keys (optional) ===" -ForegroundColor Cyan

Write-Host "Add API keys for premium map layers. Press Enter to skip any provider." -ForegroundColor DarkGray

Write-Host ""

Write-Host "  Thunderforest    : https://manage.thunderforest.com/dashboard        (free: 150k tiles/month)" -ForegroundColor DarkGray

Write-Host "  Stadia Maps      : https://client.stadiamaps.com/                    (free: 200k tiles/month)" -ForegroundColor DarkGray

Write-Host "  MapTiler         : https://cloud.maptiler.com/account/keys           (free: 100k tiles/month)" -ForegroundColor DarkGray

Write-Host "  HERE             : https://developer.here.com/                       (free: 250k tiles/month)" -ForegroundColor DarkGray

Write-Host "  Mapbox           : https://account.mapbox.com/                       (free: 200k tiles/month)" -ForegroundColor DarkGray

Write-Host "  Jawg             : https://www.jawg.io/lab/                          (free: 50k tiles/month)" -ForegroundColor DarkGray

Write-Host "  TomTom           : https://developer.tomtom.com/user/register        (free: 2500 tx/day)" -ForegroundColor DarkGray

Write-Host "  OpenWeatherMap   : https://openweathermap.org/                       (free: 1k calls/day, overlays)" -ForegroundColor DarkGray

$tileKeys = @{}

$tfKey = Read-Host "`n  Thunderforest API key [Enter to skip]"

if ($tfKey) { $tileKeys.thunderforest = $tfKey }

$sdKey = Read-Host "  Stadia Maps API key [Enter to skip]"

if ($sdKey) { $tileKeys.stadia = $sdKey }

$mtKey = Read-Host "  MapTiler API key [Enter to skip]"

if ($mtKey) { $tileKeys.maptiler = $mtKey }

$hereKey = Read-Host "  HERE API key [Enter to skip]"

if ($hereKey) { $tileKeys.here = $hereKey }

$mbKey = Read-Host "  Mapbox access token [Enter to skip]"

if ($mbKey) { $tileKeys.mapbox = $mbKey }

$jawgKey = Read-Host "  Jawg access token [Enter to skip]"

if ($jawgKey) { $tileKeys.jawg = $jawgKey }

$ttKey = Read-Host "  TomTom API key [Enter to skip]"

if ($ttKey) { $tileKeys.tomtom = $ttKey }

$owmKey = Read-Host "  OpenWeatherMap API key [Enter to skip]"

if ($owmKey) { $tileKeys.openweathermap = $owmKey }

if ($tileKeys.Count -gt 0) {

    foreach ($provider in $tileKeys.Keys) {

        $configFields["TileApiKey.$provider"] = ConvertTo-SecureString -String $tileKeys[$provider] -AsPlainText -Force

    }

    Write-Host "  $($tileKeys.Count) API key(s) will be saved to the vault." -ForegroundColor Green

    $tileKeys.Clear()

}

else {

    Write-Host "  No API keys configured. Only free tile layers will be available." -ForegroundColor DarkGray

}

# ----- Save to DPAPI vault -----

Save-DiscoveryCredential -Name 'Geolocation.Config' -Fields $configFields -Force `

    -Description 'Geolocation map config and API keys'

$ssRefresh = ConvertTo-SecureString -String $config._RefreshToken -AsPlainText -Force

Save-DiscoveryCredential -Name 'Geolocation.RefreshToken' -SecureSecret $ssRefresh -Force `

    -Description 'WUG refresh token for geolocation scripts'

$vaultPath = Join-Path $env:LOCALAPPDATA 'WhatsUpGoldPS\DiscoveryHelpers\Vault'

Write-Host "`nConfiguration saved to DPAPI vault: $vaultPath" -ForegroundColor Green

Write-Host "Encrypted with DPAPI - only $($env:USERNAME) on $($env:COMPUTERNAME) can decrypt it.`n" -ForegroundColor DarkGray

# ----- Print next steps -----

Write-Host "=== Next Steps ===" -ForegroundColor Cyan

Write-Host "1. Test map generation:"

Write-Host "   .\Update-GeolocationMap.ps1" -ForegroundColor White

Write-Host "2. Schedule via Windows Task Scheduler:"

Write-Host "   Action  : Start a program" -ForegroundColor White

Write-Host "   Program : powershell.exe" -ForegroundColor White

Write-Host "   Args    : -NoProfile -ExecutionPolicy Bypass -File `"$(Join-Path $scriptDir 'Update-GeolocationMap.ps1')`"" -ForegroundColor White

Write-Host "   Trigger : Every 5 minutes (or as needed)`n" -ForegroundColor White

# SIG # Begin signature block

# MIIr+wYJKoZIhvcNAQcCoIIr7DCCK+gCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCC1AwgANZi1mTCc

# 7ec3KPGtTdRO5xltDLsr4FYYqsTR5aCCJQ0wggVvMIIEV6ADAgECAhBI/JO0YFWU

# jTanyYqJ1pQWMA0GCSqGSIb3DQEBDAUAMHsxCzAJBgNVBAYTAkdCMRswGQYDVQQI

# DBJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcMB1NhbGZvcmQxGjAYBgNVBAoM

# EUNvbW9kbyBDQSBMaW1pdGVkMSEwHwYDVQQDDBhBQUEgQ2VydGlmaWNhdGUgU2Vy

# dmljZXMwHhcNMjEwNTI1MDAwMDAwWhcNMjgxMjMxMjM1OTU5WjBWMQswCQYDVQQG

# EwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMS0wKwYDVQQDEyRTZWN0aWdv

# IFB1YmxpYyBDb2RlIFNpZ25pbmcgUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEBAQUA

# A4ICDwAwggIKAoICAQCN55QSIgQkdC7/FiMCkoq2rjaFrEfUI5ErPtx94jGgUW+s

# hJHjUoq14pbe0IdjJImK/+8Skzt9u7aKvb0Ffyeba2XTpQxpsbxJOZrxbW6q5KCD

# J9qaDStQ6Utbs7hkNqR+Sj2pcaths3OzPAsM79szV+W+NDfjlxtd/R8SPYIDdub7

# P2bSlDFp+m2zNKzBenjcklDyZMeqLQSrw2rq4C+np9xu1+j/2iGrQL+57g2extme

# me/G3h+pDHazJyCh1rr9gOcB0u/rgimVcI3/uxXP/tEPNqIuTzKQdEZrRzUTdwUz

# T2MuuC3hv2WnBGsY2HH6zAjybYmZELGt2z4s5KoYsMYHAXVn3m3pY2MeNn9pib6q

# RT5uWl+PoVvLnTCGMOgDs0DGDQ84zWeoU4j6uDBl+m/H5x2xg3RpPqzEaDux5mcz

# mrYI4IAFSEDu9oJkRqj1c7AGlfJsZZ+/VVscnFcax3hGfHCqlBuCF6yH6bbJDoEc

# QNYWFyn8XJwYK+pF9e+91WdPKF4F7pBMeufG9ND8+s0+MkYTIDaKBOq3qgdGnA2T

# OglmmVhcKaO5DKYwODzQRjY1fJy67sPV+Qp2+n4FG0DKkjXp1XrRtX8ArqmQqsV/

# AZwQsRb8zG4Y3G9i/qZQp7h7uJ0VP/4gDHXIIloTlRmQAOka1cKG8eOO7F/05QID

# AQABo4IBEjCCAQ4wHwYDVR0jBBgwFoAUoBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYD

# VR0OBBYEFDLrkpr/NZZILyhAQnAgNpFcF4XmMA4GA1UdDwEB/wQEAwIBhjAPBgNV

# HRMBAf8EBTADAQH/MBMGA1UdJQQMMAoGCCsGAQUFBwMDMBsGA1UdIAQUMBIwBgYE

# VR0gADAIBgZngQwBBAEwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybC5jb21v

# ZG9jYS5jb20vQUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNAYIKwYBBQUHAQEE

# KDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5jb21vZG9jYS5jb20wDQYJKoZI

# hvcNAQEMBQADggEBABK/oe+LdJqYRLhpRrWrJAoMpIpnuDqBv0WKfVIHqI0fTiGF

# OaNrXi0ghr8QuK55O1PNtPvYRL4G2VxjZ9RAFodEhnIq1jIV9RKDwvnhXRFAZ/ZC

# J3LFI+ICOBpMIOLbAffNRk8monxmwFE2tokCVMf8WPtsAO7+mKYulaEMUykfb9gZ

# pk+e96wJ6l2CxouvgKe9gUhShDHaMuwV5KZMPWw5c9QLhTkg4IUaaOGnSDip0TYl

# d8GNGRbFiExmfS9jzpjoad+sPKhdnckcW67Y8y90z7h+9teDnRGWYpquRRPaf9xH

# +9/DUp/mBlXpnYzyOmJRvOwkDynUWICE5EV7WtgwggWNMIIEdaADAgECAhAOmxiO

# +dAt5+/bUOIIQBhaMA0GCSqGSIb3DQEBDAUAMGUxCzAJBgNVBAYTAlVTMRUwEwYD

# VQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAi

# BgNVBAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0yMjA4MDEwMDAw

# MDBaFw0zMTExMDkyMzU5NTlaMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdp

# Q2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERp

# Z2lDZXJ0IFRydXN0ZWQgUm9vdCBHNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCC

# AgoCggIBAL/mkHNo3rvkXUo8MCIwaTPswqclLskhPfKK2FnC4SmnPVirdprNrnsb

# hA3EMB/zG6Q4FutWxpdtHauyefLKEdLkX9YFPFIPUh/GnhWlfr6fqVcWWVVyr2iT

# cMKyunWZanMylNEQRBAu34LzB4TmdDttceItDBvuINXJIB1jKS3O7F5OyJP4IWGb

# NOsFxl7sWxq868nPzaw0QF+xembud8hIqGZXV59UWI4MK7dPpzDZVu7Ke13jrclP

# XuU15zHL2pNe3I6PgNq2kZhAkHnDeMe2scS1ahg4AxCN2NQ3pC4FfYj1gj4QkXCr

# VYJBMtfbBHMqbpEBfCFM1LyuGwN1XXhm2ToxRJozQL8I11pJpMLmqaBn3aQnvKFP

# ObURWBf3JFxGj2T3wWmIdph2PVldQnaHiZdpekjw4KISG2aadMreSx7nDmOu5tTv

# kpI6nj3cAORFJYm2mkQZK37AlLTSYW3rM9nF30sEAMx9HJXDj/chsrIRt7t/8tWM

# cCxBYKqxYxhElRp2Yn72gLD76GSmM9GJB+G9t+ZDpBi4pncB4Q+UDCEdslQpJYls

# 5Q5SUUd0viastkF13nqsX40/ybzTQRESW+UQUOsxxcpyFiIJ33xMdT9j7CFfxCBR

# a2+xq4aLT8LWRV+dIPyhHsXAj6KxfgommfXkaS+YHS312amyHeUbAgMBAAGjggE6

# MIIBNjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTs1+OC0nFdZEzfLmc/57qY

# rhwPTzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzAOBgNVHQ8BAf8E

# BAMCAYYweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5k

# aWdpY2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0

# LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwRQYDVR0fBD4wPDA6oDig

# NoY0aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9v

# dENBLmNybDARBgNVHSAECjAIMAYGBFUdIAAwDQYJKoZIhvcNAQEMBQADggEBAHCg

# v0NcVec4X6CjdBs9thbX979XB72arKGHLOyFXqkauyL4hxppVCLtpIh3bb0aFPQT

# SnovLbc47/T/gLn4offyct4kvFIDyE7QKt76LVbP+fT3rDB6mouyXtTP0UNEm0Mh

# 65ZyoUi0mcudT6cGAxN3J0TU53/oWajwvy8LpunyNDzs9wPHh6jSTEAZNUZqaVSw

# uKFWjuyk1T3osdz9HNj0d1pcVIxv76FQPfx2CWiEn2/K2yCNNWAcAgPLILCsWKAO

# QGPFmCLBsln1VWvPJ6tsds5vIy30fnFqI2si/xK4VC0nftg62fC2h5b9W9FcrBjD

# TZ9ztwGpn1eqXijiuZQwggYaMIIEAqADAgECAhBiHW0MUgGeO5B5FSCJIRwKMA0G

# CSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExp

# bWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBSb290

# IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5NTlaMFQxCzAJBgNVBAYT

# AkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzApBgNVBAMTIlNlY3RpZ28g

# UHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwggGiMA0GCSqGSIb3DQEBAQUAA4IB

# jwAwggGKAoIBgQCbK51T+jU/jmAGQ2rAz/V/9shTUxjIztNsfvxYB5UXeWUzCxEe

# AEZGbEN4QMgCsJLZUKhWThj/yPqy0iSZhXkZ6Pg2A2NVDgFigOMYzB2OKhdqfWGV

# oYW3haT29PSTahYkwmMv0b/83nbeECbiMXhSOtbam+/36F09fy1tsB8je/RV0mIk

# 8XL/tfCK6cPuYHE215wzrK0h1SWHTxPbPuYkRdkP05ZwmRmTnAO5/arnY83jeNzh

# P06ShdnRqtZlV59+8yv+KIhE5ILMqgOZYAENHNX9SJDm+qxp4VqpB3MV/h53yl41

# aHU5pledi9lCBbH9JeIkNFICiVHNkRmq4TpxtwfvjsUedyz8rNyfQJy/aOs5b4s+

# ac7IH60B+Ja7TVM+EKv1WuTGwcLmoU3FpOFMbmPj8pz44MPZ1f9+YEQIQty/NQd/

# 2yGgW+ufflcZ/ZE9o1M7a5Jnqf2i2/uMSWymR8r2oQBMdlyh2n5HirY4jKnFH/9g

# Rvd+QOfdRrJZb1sCAwEAAaOCAWQwggFgMB8GA1UdIwQYMBaAFDLrkpr/NZZILyhA

# QnAgNpFcF4XmMB0GA1UdDgQWBBQPKssghyi47G9IritUpimqF6TNDDAOBgNVHQ8B

# Af8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADATBgNVHSUEDDAKBggrBgEFBQcD

# AzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEsGA1UdHwREMEIwQKA+oDyG

# Omh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1YmxpY0NvZGVTaWduaW5n

# Um9vdFI0Ni5jcmwwewYIKwYBBQUHAQEEbzBtMEYGCCsGAQUFBzAChjpodHRwOi8v

# Y3J0LnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2RlU2lnbmluZ1Jvb3RSNDYu

# cDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0aWdvLmNvbTANBgkqhkiG

# 9w0BAQwFAAOCAgEABv+C4XdjNm57oRUgmxP/BP6YdURhw1aVcdGRP4Wh60BAscjW

# 4HL9hcpkOTz5jUug2oeunbYAowbFC2AKK+cMcXIBD0ZdOaWTsyNyBBsMLHqafvIh

# rCymlaS98+QpoBCyKppP0OcxYEdU0hpsaqBBIZOtBajjcw5+w/KeFvPYfLF/ldYp

# mlG+vd0xqlqd099iChnyIMvY5HexjO2AmtsbpVn0OhNcWbWDRF/3sBp6fWXhz7Dc

# ML4iTAWS+MVXeNLj1lJziVKEoroGs9Mlizg0bUMbOalOhOfCipnx8CaLZeVme5yE

# Lg09Jlo8BMe80jO37PU8ejfkP9/uPak7VLwELKxAMcJszkyeiaerlphwoKx1uHRz

# NyE6bxuSKcutisqmKL5OTunAvtONEoteSiabkPVSZ2z76mKnzAfZxCl/3dq3dUNw

# 4rg3sTCggkHSRqTqlLMS7gjrhTqBmzu1L90Y1KWN/Y5JKdGvspbOrTfOXyXvmPL6

# E52z1NZJ6ctuMFBQZH3pwWvqURR8AgQdULUvrxjUYbHHj95Ejza63zdrEcxWLDX6

# xWls/GDnVNueKjWUH3fTv1Y8Wdho698YADR7TNx8X8z2Bev6SivBBOHY+uqiirZt

# g0y9ShQoPzmCcn63Syatatvx157YK9hlcPmVoa1oDE5/L9Uo2bC5a4CH2RwwggY+

# MIIEpqADAgECAhAHnODk0RR/hc05c892LTfrMA0GCSqGSIb3DQEBDAUAMFQxCzAJ

# BgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzApBgNVBAMTIlNl

# Y3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwHhcNMjYwMjA5MDAwMDAw

# WhcNMjkwNDIxMjM1OTU5WjBVMQswCQYDVQQGEwJVUzEUMBIGA1UECAwLQ29ubmVj

# dGljdXQxFzAVBgNVBAoMDkphc29uIEFsYmVyaW5vMRcwFQYDVQQDDA5KYXNvbiBB

# bGJlcmlubzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAPN6aN4B1yYW

# kI5b5TBj3I0VV/peETrHb6EY4BHGxt8Ap+eT+WpEpJyEtRYPxEmNJL3A38Bkg7mw

# zPE3/1NK570ZBCuBjSAn4mSDIgIuXZnvyBO9W1OQs5d67MlJLUAEufl18tOr3ST1

# DeO9gSjQSAE5Nql0QDxPnm93OZBon+Fz3CmE+z3MwAe2h4KdtRAnCqwM+/V7iBdb

# w+JOxolpx+7RVjGyProTENIG3pe/hKvPb501lf8uBAADLdjZr5ip8vIWbf857Yw1

# Bu10nVI7HW3eE8Cl5//d1ribHlzTzQLfttW+k+DaFsKZBBL56l4YAlIVRsrOiE1k

# dHYYx6IGrEA809R7+TZA9DzGqyFiv9qmJAbL4fDwetDeyIq+Oztz1LvEdy8Rcd0J

# BY+J4S0eDEFIA3X0N8VcLeAwabKb9AjulKXwUeqCJLvN79CJ90UTZb2+I+tamj0d

# n+IKMEsJ4v4Ggx72sxFr9+6XziodtTg5Luf2xd6+PhhamOxF2px9LObhBLLEMyRs

# CHZIzVZOFKu9BpHQH7ufGB+Sa80Tli0/6LEyn9+bMYWi2ttn6lLOPThXMiQaooRU

# q6q2u3+F4SaPlxVFLI7OJVMhar6nW6joBvELTJPmANSMjDSRFDfHRCdGbZsL/keE

# LJNy+jZctF6VvxQEjFM8/bazu6qYhrA7AgMBAAGjggGJMIIBhTAfBgNVHSMEGDAW

# gBQPKssghyi47G9IritUpimqF6TNDDAdBgNVHQ4EFgQU6YF0o0D5AVhKHbVocr8G

# aSIBibAwDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYI

# KwYBBQUHAwMwSgYDVR0gBEMwQTA1BgwrBgEEAbIxAQIBAwIwJTAjBggrBgEFBQcC

# ARYXaHR0cHM6Ly9zZWN0aWdvLmNvbS9DUFMwCAYGZ4EMAQQBMEkGA1UdHwRCMEAw

# PqA8oDqGOGh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1YmxpY0NvZGVT

# aWduaW5nQ0FSMzYuY3JsMHkGCCsGAQUFBwEBBG0wazBEBggrBgEFBQcwAoY4aHR0

# cDovL2NydC5zZWN0aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdDQVIz

# Ni5jcnQwIwYIKwYBBQUHMAGGF2h0dHA6Ly9vY3NwLnNlY3RpZ28uY29tMA0GCSqG

# SIb3DQEBDAUAA4IBgQAEIsm4xnOd/tZMVrKwi3doAXvCwOA/RYQnFJD7R/bSQRu3

# wXEK4o9SIefye18B/q4fhBkhNAJuEvTQAGfqbbpxow03J5PrDTp1WPCWbXKX8Oz9

# vGWJFyJxRGftkdzZ57JE00synEMS8XCwLO9P32MyR9Z9URrpiLPJ9rQjfHMb1BUd

# vaNayomm7aWLAnD+X7jm6o8sNT5An1cwEAob7obWDM6sX93wphwJNBJAstH9Ozs6

# LwISOX6sKS7CKm9N3Kp8hOUue0ZHAtZdFl6o5u12wy+zzieGEI50fKnN77FfNKFO

# WKlS6OJwlArcbFegB5K89LcE5iNSmaM3VMB2ADV1FEcjGSHw4lTg1Wx+WMAMdl/7

# nbvfFxJ9uu5tNiT54B0s+lZO/HztwXYQUczdsFon3pjsNrsk9ZlalBi5SHkIu+F6

# g7tWiEv3rtVApmJRnLkUr2Xq2a4nbslUCt4jKs5UX4V1nSX8OM++AXoyVGO+iTj7

# z+pl6XE9Gw/Td6WKKKswgga0MIIEnKADAgECAhANx6xXBf8hmS5AQyIMOkmGMA0G

# CSqGSIb3DQEBCwUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJ

# bmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0

# IFRydXN0ZWQgUm9vdCBHNDAeFw0yNTA1MDcwMDAwMDBaFw0zODAxMTQyMzU5NTla

# MGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UE

# AxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEy

# NTYgMjAyNSBDQTEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0eDHT

# CphBcr48RsAcrHXbo0ZodLRRF51NrY0NlLWZloMsVO1DahGPNRcybEKq+RuwOnPh

# of6pvF4uGjwjqNjfEvUi6wuim5bap+0lgloM2zX4kftn5B1IpYzTqpyFQ/4Bt0mA

# xAHeHYNnQxqXmRinvuNgxVBdJkf77S2uPoCj7GH8BLuxBG5AvftBdsOECS1UkxBv

# MgEdgkFiDNYiOTx4OtiFcMSkqTtF2hfQz3zQSku2Ws3IfDReb6e3mmdglTcaarps

# 0wjUjsZvkgFkriK9tUKJm/s80FiocSk1VYLZlDwFt+cVFBURJg6zMUjZa/zbCclF

# 83bRVFLeGkuAhHiGPMvSGmhgaTzVyhYn4p0+8y9oHRaQT/aofEnS5xLrfxnGpTXi

# UOeSLsJygoLPp66bkDX1ZlAeSpQl92QOMeRxykvq6gbylsXQskBBBnGy3tW/AMOM

# CZIVNSaz7BX8VtYGqLt9MmeOreGPRdtBx3yGOP+rx3rKWDEJlIqLXvJWnY0v5ydP

# pOjL6s36czwzsucuoKs7Yk/ehb//Wx+5kMqIMRvUBDx6z1ev+7psNOdgJMoiwOrU

# G2ZdSoQbU2rMkpLiQ6bGRinZbI4OLu9BMIFm1UUl9VnePs6BaaeEWvjJSjNm2qA+

# sdFUeEY0qVjPKOWug/G6X5uAiynM7Bu2ayBjUwIDAQABo4IBXTCCAVkwEgYDVR0T

# AQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQU729TSunkBnx6yuKQVvYv1Ensy04wHwYD

# VR0jBBgwFoAU7NfjgtJxXWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMG

# A1UdJQQMMAoGCCsGAQUFBwMIMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYY

# aHR0cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2Fj

# ZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNV

# HR8EPDA6MDigNqA0hjJodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRU

# cnVzdGVkUm9vdEc0LmNybDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1s

# BwEwDQYJKoZIhvcNAQELBQADggIBABfO+xaAHP4HPRF2cTC9vgvItTSmf83Qh8WI

# GjB/T8ObXAZz8OjuhUxjaaFdleMM0lBryPTQM2qEJPe36zwbSI/mS83afsl3YTj+

# IQhQE7jU/kXjjytJgnn0hvrV6hqWGd3rLAUt6vJy9lMDPjTLxLgXf9r5nWMQwr8M

# yb9rEVKChHyfpzee5kH0F8HABBgr0UdqirZ7bowe9Vj2AIMD8liyrukZ2iA/wdG2

# th9y1IsA0QF8dTXqvcnTmpfeQh35k5zOCPmSNq1UH410ANVko43+Cdmu4y81hjaj

# V/gxdEkMx1NKU4uHQcKfZxAvBAKqMVuqte69M9J6A47OvgRaPs+2ykgcGV00TYr2

# Lr3ty9qIijanrUR3anzEwlvzZiiyfTPjLbnFRsjsYg39OlV8cipDoq7+qNNjqFze

# GxcytL5TTLL4ZaoBdqbhOhZ3ZRDUphPvSRmMThi0vw9vODRzW6AxnJll38F0cuJG

# 7uEBYTptMSbhdhGQDpOXgpIUsWTjd6xpR6oaQf/DJbg3s6KCLPAlZ66RzIg9sC+N

# Jpud/v4+7RWsWCiKi9EOLLHfMR2ZyJ/+xhCx9yHbxtl5TPau1j/1MIDpMPx0LckT

# etiSuEtQvLsNz3Qbp7wGWqbIiOWCnb5WqxL3/BAPvIXKUjPSxyZsq8WhbaM2tszW

# kPZPubdcMIIG7TCCBNWgAwIBAgIQCoDvGEuN8QWC0cR2p5V0aDANBgkqhkiG9w0B

# AQsFADBpMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/

# BgNVBAMTOERpZ2lDZXJ0IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYg

# U0hBMjU2IDIwMjUgQ0ExMB4XDTI1MDYwNDAwMDAwMFoXDTM2MDkwMzIzNTk1OVow

# YzELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQD

# EzJEaWdpQ2VydCBTSEEyNTYgUlNBNDA5NiBUaW1lc3RhbXAgUmVzcG9uZGVyIDIw

# MjUgMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANBGrC0Sxp7Q6q5g

# VrMrV7pvUf+GcAoB38o3zBlCMGMyqJnfFNZx+wvA69HFTBdwbHwBSOeLpvPnZ8ZN

# +vo8dE2/pPvOx/Vj8TchTySA2R4QKpVD7dvNZh6wW2R6kSu9RJt/4QhguSssp3qo

# me7MrxVyfQO9sMx6ZAWjFDYOzDi8SOhPUWlLnh00Cll8pjrUcCV3K3E0zz09ldQ/

# /nBZZREr4h/GI6Dxb2UoyrN0ijtUDVHRXdmncOOMA3CoB/iUSROUINDT98oksouT

# MYFOnHoRh6+86Ltc5zjPKHW5KqCvpSduSwhwUmotuQhcg9tw2YD3w6ySSSu+3qU8

# DD+nigNJFmt6LAHvH3KSuNLoZLc1Hf2JNMVL4Q1OpbybpMe46YceNA0LfNsnqcnp

# JeItK/DhKbPxTTuGoX7wJNdoRORVbPR1VVnDuSeHVZlc4seAO+6d2sC26/PQPdP5

# 1ho1zBp+xUIZkpSFA8vWdoUoHLWnqWU3dCCyFG1roSrgHjSHlq8xymLnjCbSLZ49

# kPmk8iyyizNDIXj//cOgrY7rlRyTlaCCfw7aSUROwnu7zER6EaJ+AliL7ojTdS5P

# WPsWeupWs7NpChUk555K096V1hE0yZIXe+giAwW00aHzrDchIc2bQhpp0IoKRR7Y

# ufAkprxMiXAJQ1XCmnCfgPf8+3mnAgMBAAGjggGVMIIBkTAMBgNVHRMBAf8EAjAA

# MB0GA1UdDgQWBBTkO/zyMe39/dfzkXFjGVBDz2GM6DAfBgNVHSMEGDAWgBTvb1NK

# 6eQGfHrK4pBW9i/USezLTjAOBgNVHQ8BAf8EBAMCB4AwFgYDVR0lAQH/BAwwCgYI

# KwYBBQUHAwgwgZUGCCsGAQUFBwEBBIGIMIGFMCQGCCsGAQUFBzABhhhodHRwOi8v

# b2NzcC5kaWdpY2VydC5jb20wXQYIKwYBBQUHMAKGUWh0dHA6Ly9jYWNlcnRzLmRp

# Z2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNFRpbWVTdGFtcGluZ1JTQTQwOTZT

# SEEyNTYyMDI1Q0ExLmNydDBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vY3JsMy5k

# aWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRUaW1lU3RhbXBpbmdSU0E0MDk2

# U0hBMjU2MjAyNUNBMS5jcmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9

# bAcBMA0GCSqGSIb3DQEBCwUAA4ICAQBlKq3xHCcEua5gQezRCESeY0ByIfjk9iJP

# 2zWLpQq1b4URGnwWBdEZD9gBq9fNaNmFj6Eh8/YmRDfxT7C0k8FUFqNh+tshgb4O

# 6Lgjg8K8elC4+oWCqnU/ML9lFfim8/9yJmZSe2F8AQ/UdKFOtj7YMTmqPO9mzskg

# iC3QYIUP2S3HQvHG1FDu+WUqW4daIqToXFE/JQ/EABgfZXLWU0ziTN6R3ygQBHMU

# BaB5bdrPbF6MRYs03h4obEMnxYOX8VBRKe1uNnzQVTeLni2nHkX/QqvXnNb+YkDF

# kxUGtMTaiLR9wjxUxu2hECZpqyU1d0IbX6Wq8/gVutDojBIFeRlqAcuEVT0cKsb+

# zJNEsuEB7O7/cuvTQasnM9AWcIQfVjnzrvwiCZ85EE8LUkqRhoS3Y50OHgaY7T/l

# wd6UArb+BOVAkg2oOvol/DJgddJ35XTxfUlQ+8Hggt8l2Yv7roancJIFcbojBcxl

# RcGG0LIhp6GvReQGgMgYxQbV1S3CrWqZzBt1R9xJgKf47CdxVRd/ndUlQ05oxYy2

# zRWVFjF7mcr4C34Mj3ocCVccAvlKV9jEnstrniLvUxxVZE/rptb7IRE2lskKPIJg

# baP5t2nGj/ULLi49xTcBZU8atufk+EMF/cWuiC7POGT75qaL6vdCvHlshtjdNXOC

# IUjsarfNZzGCBkQwggZAAgEBMGgwVDELMAkGA1UEBhMCR0IxGDAWBgNVBAoTD1Nl

# Y3RpZ28gTGltaXRlZDErMCkGA1UEAxMiU2VjdGlnbyBQdWJsaWMgQ29kZSBTaWdu

# aW5nIENBIFIzNgIQB5zg5NEUf4XNOXPPdi036zANBglghkgBZQMEAgEFAKCBhDAY

# BgorBgEEAYI3AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3

# AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEi

# BCC5XlD/95co0tryMUPmRsAy62O9h/VdhzOa0TlDnYpvwjANBgkqhkiG9w0BAQEF

# AASCAgBaG2HJE0EQok9YCDYS0aAGUiEIJJ2ZAgmArwh9+aYFcqn6iQrlFV1qM/+X

# Dwf5NicRlJJ6g10qQJopWhZp8EnqHm+ZiA2PAguerAlCWg0q2d6vnnQNVs/pBCMe

# aPPAE6UOkc8AcOmg+kDE9FotBFp3VKcJ1NG7W5xd56ScG91Y3d0OKC5j0ePsd/xW

# 4gehYfNNGdagbM2CZStlfEeKqn+vZN5kFD+bWZJINJTYh4KInl6mPJKXQCwL2D/U

# 7B48ucDdLHc6su6MlX8pxdMZ9p+idLKcVR/dXWSOe51qzSGuPo405eigXf61Yb8K

# 4SQJGrhPggv6hFcxWecKDJ9L+GnBi+mcfnnZMvBqEyp+mZtFbhwPrh/Xo0LCYfMN

# KYRClREklh24KlHdNe21mGxFzZfj0Fv+eMwSk4BUwEHY4ROf3zBQ5ByMKzEScHkt

# Di1whjBMtC0FzJr75SNE21lkVBZzLgCuq2lxvWlbGh2RY/1z6flIkOd1V7Nbhtm0

# GN5T9nRW/FiQGE7AS0SbGmYKRoFumpk60IH9c95i8965TVrJb/ttIyp5QOMbV6rY

# GyWkWTB1iALCV/CYE01i8rEGaGzvIu5UpU+pDn/b85aujArtdlM8LUai2PHxjWV3

# 2RGPECVsFX7huwDanIdMpP9whBaGhbMTT1WdI6Cs9JX0IT6utKGCAyYwggMiBgkq

# hkiG9w0BCQYxggMTMIIDDwIBATB9MGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5E

# aWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBUaW1l

# U3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYgMjAyNSBDQTECEAqA7xhLjfEFgtHEdqeV

# dGgwDQYJYIZIAWUDBAIBBQCgaTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwG

# CSqGSIb3DQEJBTEPFw0yNjA0MjAwMDE2NDZaMC8GCSqGSIb3DQEJBDEiBCAINNYj

# uR2D/DLyeAzAHjgYaOu5oVvnz1FpGyNTMqc+RTANBgkqhkiG9w0BAQEFAASCAgBM

# gAgebPXX/oOUx5XPwRBtpIPrbWOPZ4UUd8oERHcb7IHMWZT0Co8u9/YPzHd+TTqZ

# T8eYYhYUZN5KJDYLQE6sBMkOSmcoPIlApDjuVYk7DwDokFuugTCN1yO+zKP7S8dG

# CD1prbRG2rJl4Qv84J8ERUWMZ15Me/Y6O6pX28V79NQGeHo9a9L/6qXFunLTY0FL

# WaCifcuB22a2Oogzyf7nPQI6yiIchofehLL6nH/MBS3RMH7yHlQqX9TnKpO+vEas

# t9QXBwrJVupO3vbvIx8SfdXNN+zz//0vUJP8jKGlsH7Q3HNBmhXtznO/t2cTkiYu

# 1lqIsiQVU/Qn32BV1VuqYnWSPtjvcAUGYHEUUZyq91wx/uISniXgjo48L5AfKs1b

# ZWEJwwR7P2I8hw4rtvTDtzshmuBpTGoe/LldTRjS2RPmY707z+LiQhvpTIXlU0ED

# qW1UiDJEmRng8J9DGLCj7uud1qTpR8QW9doMPbreXiDcARHrROj75e3pOrsXs/NT

# LD4B7fxkhzFMTMq64GAnBVaDD/2F5MocfSUqVD11iQaT4Mt+cU2ibGLkczGjb+BR

# 5WFOAT98HdW4dzVr1MRgDgJJFincNI6LPTZNX0Cjhi8QuAptr3uCUY7kN2O4hPGM

# mhqPBFEavn7pioaBEUwuTdCfQ+ogHlUOoS4rYc/PVA==

# SIG # End signature block