Private/AzStackHci.Constants.ps1
|
# //////////////////////////////////////////////////////////////////////////// # Strict Mode v1 (PS 5.1 safe) - surfaces reads of uninitialised variables at runtime. Set-StrictMode -Version 1.0 # Module Constants # Centralized configuration values for the AzStackHci.DiagnosticSettings module. # All constant numbers and hardcoded values are defined here for easy maintenance. # //////////////////////////////////////////////////////////////////////////// # --- Memory Dump Settings --- # Default dedicated dump file size for systems with less than the large memory threshold [uint32]$script:DUMP_FILE_SIZE_DEFAULT_MIB = 65536 # 64 GiB # Dedicated dump file size for large memory systems (>= $LARGE_MEMORY_THRESHOLD_BYTES) [uint32]$script:DUMP_FILE_SIZE_LARGE_MIB = 131072 # 128 GiB # RAM threshold (in bytes) above which the large dump file size is used [uint64]$script:LARGE_MEMORY_THRESHOLD_BYTES = 768GB # Disk space reserve percentage for dedicated dump file validation [double]$script:DUMP_DISK_RESERVE_PERCENT = 0.1 # 10% # --- Page File Settings --- # Minimum fixed page file size in MiB [uint32]$script:PAGE_FILE_MINIMUM_SIZE_MIB = 4096 # 4 GiB # --- Cluster Performance Log Collection --- # Minimum free disk space (in MiB) required before starting log collection [uint32]$script:LOG_COLLECTION_MIN_DISK_MIB = 10240 # 10 GiB # Disk space reserve percentage for log collection [double]$script:LOG_COLLECTION_DISK_RESERVE_PERCENT = 0.05 # 5% # --- DNS Settings --- # Maximum number of DNS resolution retry attempts [int]$script:DNS_MAX_RETRIES = 3 # Base delay in seconds for exponential backoff between DNS retries [int]$script:DNS_RETRY_BASE_DELAY_SEC = 1 # --- HTTP / Layer 7 Settings --- # Maximum number of HTTP redirect hops before giving up [int]$script:HTTP_MAX_REDIRECTS = 10 # Initial timeout in seconds for Invoke-WebRequest connectivity tests. Picked to # accommodate slow links and proxy paths where some Azure data-plane endpoints # (notably guestnotificationservice.azure.com/urls/allowlist) take longer than # 60 s to assemble a response. [int]$script:HTTP_TIMEOUT_INITIAL_SEC = 90 # Extended timeout (seconds) used for a single retry when an endpoint returns # 'The operation has timed out.' on the first attempt. Each endpoint gets at # most one retry; there is no per-run budget cap, so a customer with a slow # link will still get every endpoint retried fairly. [int]$script:HTTP_TIMEOUT_RETRY_SEC = 120 # Maximum total Invoke-WebRequest attempts for a single endpoint when the first # attempt fails with a DNS-resolution error ('NameResolutionFailure' / # 'The remote name could not be resolved'). The DNS pre-check loop already # probes name resolution up to $script:DNS_MAX_RETRIES times before # Invoke-WebRequest is called, so a transient WebException-side DNS failure # usually clears within a second or two (caching / TTL warm-up, proxy # resolver, IPv6/IPv4 race). Three total attempts (initial + 2 retries) keeps # the worst-case overhead bounded while recovering nearly all real flakes. [int]$script:HTTP_DNS_RETRY_MAX_ATTEMPTS = 3 # Delay in seconds between Invoke-WebRequest DNS-failure retries. Kept small # (no exponential backoff) because the DNS pre-check loop has already done # the slower retries; this is just a brief pause to let the resolver / proxy # settle before re-issuing the HTTP request. [int]$script:HTTP_DNS_RETRY_DELAY_SEC = 1 # Maximum total Invoke-WebRequest attempts for transient send failures. These # failures commonly surface when a connection is closed while the request is # being sent. Match the DNS retry policy: initial attempt plus two retries. [int]$script:HTTP_SEND_RETRY_MAX_ATTEMPTS = 3 # Brief pause between transient send-failure retries. [int]$script:HTTP_SEND_RETRY_DELAY_SEC = 1 # Maximum total Invoke-WebRequest attempts for connection-establishment failures. # ConnectFailure can consume significant time before returning, so retry only once. [int]$script:HTTP_CONNECT_RETRY_MAX_ATTEMPTS = 2 # Brief pause before the single connection-failure retry. [int]$script:HTTP_CONNECT_RETRY_DELAY_SEC = 1 # Certificate-capture timeout in ticks (15 seconds = 150,000,000 ticks) # Intentionally shorter than the connectivity timeout (90 seconds) to limit impact of unresponsive backend pool servers [long]$script:CERT_CAPTURE_TIMEOUT_TICKS = 150000000 # --- Network Ports --- # Well-known ports used for protocol inference [int]$script:PORT_HTTP = 80 [int]$script:PORT_HTTPS = 443 [int]$script:PORT_HTTPS_ALT1 = 8084 [int]$script:PORT_HTTPS_ALT2 = 8443 [int]$script:PORT_NTP = 123 # --- Default Export Path --- # Canonical on-disk location every diagnostic run writes to. Test-AzureLocalConnectivity # ALWAYS writes its artifacts here; if a caller supplies a different -ExportPath the run # folder is additionally copied there (never instead). Single source of truth for the default. [string]$script:DEFAULT_DIAG_EXPORT_PATH = 'C:\ProgramData\AzStackHci.DiagnosticSettings' # --- Diagnostic Artifact Layout / Retention --- [int]$script:DIAG_REPORT_RETENTION_DAYS = 180 [int]$script:DIAG_BACKUP_RETENTION_DAYS = 730 [int]$script:DIAG_BACKUP_MINIMUM_RETAIN = 5 $script:DIAG_ARTIFACT_RELATIVE_PATHS = @{ Connectivity = 'Reports\Connectivity' OsConfig = 'Reports\OsConfig' VMCheckpointHealth = 'Reports\VMCheckpointHealth' PageFile = 'Backups\PageFile' MemoryDump = 'Backups\MemoryDump' UserModeCrashDump = 'Backups\UserModeCrashDump' } # --- Animation / UI --- # Spinner animation frame interval in milliseconds [int]$script:ANIMATION_FRAME_MS = 125 # Maximum time (in seconds) to wait for a background job before giving up [int]$script:JOB_ANIMATION_TIMEOUT_SEC = 600 # 10 minutes # Overall deadline for production fan-out and background collection coordinators. # Kept conservative for slow but healthy clusters while preventing indefinite waits. [int]$script:OPERATION_DEADLINE_SEC = 1800 # 30 minutes # Polling interval used by bounded job coordinators. [int]$script:JOB_POLL_INTERVAL_SEC = 2 # --- SSL Inspection Detection --- # Known trusted root CA thumbprints for Microsoft services. # Used by Test-AzStackHciSSLInspection to verify the certificate chain # is not being intercepted by an SSL inspection appliance. # These are the root CAs that Microsoft and its CDN partners use. [string[]]$script:TRUSTED_ROOT_CA_THUMBPRINTS = @( # DigiCert Global Root G2 'DF3C24F9BFD666761B268073FE06D1CC8D4F82A4', # DigiCert Global Root CA 'A8985D3A65E5E5C4B2D7D66D40C6DD2FB19C5436', # Baltimore CyberTrust Root 'D4DE20D05E66FC53FE1A50882C78DB2852CAE474', # Microsoft RSA Root Certificate Authority 2017 '73A5E64A3BFF8316FF0EDCCC618A906E4EAE4D74', # Microsoft ECC Root Certificate Authority 2017 '999A64C37FF47D9FAB95F14769891460EEC4C3C5' ) # Expected certificate issuer organization strings (for string-based fallback check) [string[]]$script:EXPECTED_CERT_ISSUERS = @( 'O=Microsoft Corporation', 'O=DigiCert Inc' ) # --- CRL / OCSP Revocation Check Classification --- # X509Chain / Test-Certificate status tokens that indicate the chain is TRUSTED but the # revocation check (CRL / OCSP) could not be completed because the relevant endpoint is # unreachable from this host. These cases are NOT SSL inspection — they indicate an # egress/firewall issue to the CA's revocation infrastructure. [string[]]$script:CERT_CHAIN_STATUS_REVOCATION_OFFLINE = @( 'RevocationStatusUnknown', 'OfflineRevocation', 'CERT_TRUST_REVOCATION_STATUS_UNKNOWN', 'CERT_TRUST_IS_OFFLINE_REVOCATION' ) # X.509 extension OIDs used to extract CRL Distribution Points and OCSP responder URLs. [string]$script:CRL_DP_OID = '2.5.29.31' # CRL Distribution Points [string]$script:AIA_OID = '1.3.6.1.5.5.7.1.1' # Authority Information Access (OCSP) # Cap how many revocation-dependency rows we append per leaf certificate. # 1 CRL + 1 OCSP is sufficient to catch real-world path-based proxy blocking without # bloating the result table for certs that list 4+ distribution points. [int]$script:CRL_MAX_DP_PER_CERT = 1 [int]$script:CRL_MAX_OCSP_PER_CERT = 1 # --- Critical Arc Service Private Link Endpoints --- # Endpoints that MUST NOT resolve to RFC1918 addresses (Arc Private Link Scopes not supported for Azure Local) # Reference: https://learn.microsoft.com/en-us/azure/azure-local/concepts/firewall-requirements [string[]]$script:PRIVATE_LINK_CRITICAL_ENDPOINTS = @( 'gbl.his.arc.azure.com', '*.his.arc.azure.com', '*.guestconfiguration.azure.com', '*.dp.kubernetesconfiguration.azure.com' ) # --- PaaS Services Supporting Private Link --- # Endpoints that CAN use Private Link but must be added to proxy bypass/exception list when a proxy is in use. # Traffic to these must route via ExpressRoute or Site-to-Site VPN to reach private endpoints. [string[]]$script:PRIVATE_LINK_PROXY_BYPASS_ENDPOINTS = @( '*.vault.azure.net', '*.vaultcore.azure.net', '*.blob.core.windows.net', '*.azurecr.io', '*.database.windows.net', '*.siterecovery.windowsazure.com', '*.backup.windowsazure.com', '*.servicebus.windows.net' ) # --- Azure Region Endpoint URLs --- # GitHub raw URLs for downloading region-specific required endpoint lists. # Used by Test-AzureLocalConnectivity to fetch the latest endpoint definitions. [hashtable]$script:REGION_ENDPOINT_URLS = @{ "EastUS" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/master/HCI/EastUSendpoints/eastus-hci-endpoints.md" "WestEurope" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/master/HCI/WestEuropeendpoints/westeurope-hci-endpoints.md" "AustraliaEast" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/master/HCI/AustraliaEastendpoints/AustraliaEast-hci-endpoints.md" "CanadaCentral" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/master/HCI/CanadaCentralEndpoints/canadacentral-hci-endpoints.md" "CentralIndia" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/IndiaCentralEndpoints/IndiaCentral-hci-endpoints.md" "JapanEast" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/JapanEastEndpoints/japaneast-hci-endpoints.md" "SouthCentral" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/SouthCentralUSEndpoints/southcentralus-hci-endpoints.md" "SouthEastAsia" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/SouthEastAsiaEndpoints/southeastasia-hci-endpoints.md" "USGovVirginia" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/usgovvirginia-hci-endpoints/usgovvirginia-hci-endpoints.md" } # --- OEM SBE Endpoint URLs --- # GitHub raw URLs for hardware OEM Solution Builder Extension (SBE) endpoint lists. # Used by Get-HardwareOEMUrlContent to fetch OEM-specific required endpoints. [hashtable]$script:OEM_ENDPOINT_URLS = @{ "DataOn" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/OEMEndpoints/DataOn/DataOnAzureLocalEndpoints.md" "Dell" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/OEMEndpoints/Dell/DellAzureLocalEndpoints.md" "HPE" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/OEMEndpoints/HPE/HPEAzureLocalEndpoints.md" "Hitachi" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/OEMEndpoints/Hitachi/HitachiAzureLocalEndpoints.md" "Lenovo" = "https://raw.githubusercontent.com/Azure/AzureStack-Tools/refs/heads/master/HCI/OEMEndpoints/Lenovo/LenovoAzureLocalEndpoints.md" } # --- Manually Defined Wildcard Subdomains --- # Static list of known subdomains used to validate connectivity for wildcard endpoints. # Defined here so the total count is available before the main testing loop for unified progress tracking. $script:MANUAL_SUBDOMAINS = @( @{ Wildcard = "*.blob.core.windows.net"; Subdomains = @("mystorageaccount.blob.core.windows.net","eus2azreplstore214.blob.core.windows.net") }, @{ Wildcard = "*.download.windowsupdate.com"; Subdomains = @("1a.au.download.windowsupdate.com") }, @{ Wildcard = "*.update.microsoft.com"; Subdomains = @("fe2.update.microsoft.com") }, @{ Wildcard = "*.windowsupdate.com"; Subdomains = @("ctldl.windowsupdate.com") }, @{ Wildcard = "*.endpoint.security.microsoft.com"; Subdomains = @("edr-neu3.eu.endpoint.security.microsoft.com") }, @{ Wildcard = "*.prod.hot.ingest.monitor.core.windows.net"; Subdomains = @("prod5.prod.hot.ingest.monitor.core.windows.net") }, @{ Wildcard = "*.servicebus.windows.net"; Subdomains = @("azgn-southcentralus-public-1p-sn-vazr0002.servicebus.windows.net") } ) # Pre-calculated total subdomain count for progress tracking [int]$script:MANUAL_SUBDOMAIN_COUNT = ($script:MANUAL_SUBDOMAINS | ForEach-Object { $_.Subdomains.Count } | Measure-Object -Sum).Sum # --- Module State Initialization --- # Central initialization of all module-scoped state variables. # This makes the shared surface explicit and enables clean reset between runs. function Initialize-ModuleState { <# .SYNOPSIS Resets all module-scoped state variables to their default values. .DESCRIPTION Called during module load and can be called between test runs to ensure clean state. All $script: variables used for cross-function communication are initialized here. #> $script:SilentMode = $false $script:Proxy = $null # Set by Invoke-Layer7BucketWorker (Private/AzStackHci.ParallelLayer7.Helpers.ps1) # to '[bucket-N] ' so every Write-HostAzS line emitted from inside a parallel # worker is tagged with its bucket index. Stays empty in the parent process and # in -Parallelism 1 / -Scope Node runs. $script:WorkerLogPrefix = '' [System.Collections.ArrayList]$script:Results = @() [System.Collections.ArrayList]$script:RedirectedResults = @() $script:SSLInspectionDetected = $false [System.Collections.ArrayList]$script:SSLInspectedURLs = @() # Endpoints whose certificate chain is TRUSTED but whose CRL/OCSP revocation check # could not be completed (CRL/OCSP endpoint unreachable). Tracked separately from # SSLInspectedURLs so the summary output differentiates the two failure modes. [System.Collections.ArrayList]$script:CRLOfflineURLs = @() $script:PrivateLinkDetected = $false $script:PrivateLinkDetectedArray = @() $script:PrivateLinkCriticalArray = @() $script:PrivateLinkProxyBypassArray = @() # v0.6.8: RFC1918/Private-Link endpoints VERIFIED against the proxy bypass sources. $script:PrivateLinkBypassConfirmedArray = @() $script:PrivateLinkBypassMissingArray = @() $script:PrivateLinkCriticalEndpoints = $script:PRIVATE_LINK_CRITICAL_ENDPOINTS $script:PrivateLinkProxyBypassEndpoints = $script:PRIVATE_LINK_PROXY_BYPASS_ENDPOINTS $script:DedicatedDumpFileSize = 0 $script:MinimumRequiredDiskSpace = 0 $script:PageFileAutoManaged = $false $script:PageFileConfiguration = $null $script:PageFileAllocatedBaseSize = 0 $script:PageFileCurrentUsage = 0 $script:PageFilePeakUsage = 0 $script:CurrentDumpFile = $null $script:CurrentSettings = $null $script:DateFormatted = $null $script:OutputFolderPath = $null $script:OutputFile = $null $script:OutputFileExtension = $null $script:CsvFile = $null $script:TranscriptFile = $null $script:UpdatedKeyVaultURL = $null $script:UpdatedArcGatewayURL = $null $script:HardwareOEM = $null $script:PreArcGatewayRemoval = $null $script:job = $null } # Initialize state on module load Initialize-ModuleState # SIG # Begin signature block # MIInKAYJKoZIhvcNAQcCoIInGTCCJxUCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBOYZcZa0XP0AOW # QQrBX8su7Q6ouVoifPUjW2+qoWQAE6CCDLowggX1MIID3aADAgECAhMzAAACHU0Z # yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD # b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1 # OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD # VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB # DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8 # o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg # 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4 # Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R # X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk # ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B # Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O # BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw # HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg # UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0 # JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh # MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv # Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy # dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9 # s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H # VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3 # w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n # 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs # A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo # Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb # SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6 # 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z # V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v # 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs # /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA # AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl # IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow # VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo # MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ # KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh # emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h # KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd # M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp # yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t # Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5 # REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs # 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK # Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5 # pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW # eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ # 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC # NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB # gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU # ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny # bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx # MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0 # dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx # MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI # MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4 # NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh # ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q # hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU # nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb # H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z # uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u # vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW # 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV # DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10 # 1cY2L4A7GTQG1h32HHAvfQESWP0xghnEMIIZwAIBATBuMFcxCzAJBgNVBAYTAlVT # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv # c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w # DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ # KoZIhvcNAQkEMSIEIHByLAtw6rdQiwttmdIIi5sOg2yQmrhm9BfK43t6L3RtMEIG # CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAvvtr+X0nCkWIAfcQ # zrFYp7cphbf0xIpo2ra5F1wJdhyfn9W0MnleRhFm0PyGAZ2CvCqCk+wrHG8k1CMS # NweTIr3gxxH8WmkvC9ESIqB5qSb9uZWXvTBSZZS6RepLA/YpBWUd8pUKAd3WGTJD # kmoSR44+ccPflIFde2f5CKTbvLfvsN4/tYZQe5shKs97gP+WWKY11as9GlxhRSwD # +uYcrqL2oK3fmAeyCrpqXnupUSpH26oI4uTYOXqlpAFzEG5YIYqixxCmjv+pW8Ad # F85GLsKFDNFGjpV/8hHuWGQ9LoJ6SFYw+t6bppl/ji82dv1m+AcoBhJch8sVHufb # YOD2kKGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCCF20w # ghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9 # MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCD28okcqY1k2cr6 # yNEsKghtvT4cfm67yuWkpgbn9zSTbAIGaqnPuURaGBMyMDI2MDkyOTIwNDQ0OS41 # NzJaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScw # JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046REMwMC0wNUUwLUQ5NDcxJTAjBgNVBAMT # HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIBAgIT # MwAAAiQ7hCGwLKxkIgABAAACJDANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjAyMTkxOTM5NTlaFw0yNzA1MTcxOTM5NTla # MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL # ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk # IFRTUyBFU046REMwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l # LVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCj # 6W3UaQ2Zr4hNvSy7j7UMPFVys7aExGB+JFwykzzXg3jayYm9gOLXJ7tNhU2emhrL # QCOZcgLvz6FkqmghzQxzmkgKtLYiKaEzhogO/ce0lThdLNdVtMwQOYgo+XtXAZcV # iBX4LcHk38RusZiF7wxSa5t/Lxic04+Z/hly1gJQpIeFDqp4a9PuLt8rsfH05vW9 # pU9uriGdDxfJXn/lc49CxbXqA3EX17L24bc6t+mFuPDAJKKpai3XXqF2nJlpTPfd # rA29sWTSNKig9CtBC5tzQj0flbsa/4wqO9u+RkuwpZb3b7qnW5FdFrDR1vQmXfjl # yUP9ZO38839NwSuiHtvsFCNkTNIX8OL5XVq1nsKyu//GeIZ9YuxsfLBedqG024PD # ERyrAs0pvfUWOLapVQajHPoCnuNSKvbEh7s5IQ0YgupGji+H7rIDx2/mIEI+6Q8W # wBtk3Yxyhjj0GXw909i0EkTkVyy+1yADjwSC8bw2qM4+Mc4hyytlZzSc0IPUBq1Y # GnYwCjIwa5/lMW0pFn/HpJdB6XeMuTtYTOpaPoo64FjQryLXWjd4ovpw5lOw7X+v # 3E9kwN9VBC+wJESBECC1gZMCS5TaVwfE1w4pnXXb1qT9bjgRsPg4dklruUTdon/3 # SNt0a0Q5Nc2Ul+rMlQxXoP9isXwMNnKO5JJkqRDRVQIDAQABo4IBSTCCAUUwHQYD # VR0OBBYEFHMfkX1u/zJLCMe0gqYitx1tAHeoMB8GA1UdIwQYMBaAFJ+nFV0AXmJd # g/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9z # b2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El # MjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6 # Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGlt # ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0l # AQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUA # A4ICAQA+wHSbmhIpM8CRVZ4tk624hQ+LdZXE4qoeQui77CeNa3jq1FOzi7MRKkko # 6diEDHXPNWvAagxastCewPzm5TCNh1s4qCHh4R2G/r48wU/Mpc68/WDmJy5CIQn/ # Fwps1sbNUEu7Bzg004qULIVJ963jo/am4xwKgwh+vSVL7/dhsfT7dvhpRddbYLQT # HZgwuNB6QhcEEsgogLVwNRj37VEWZDiwoMdxyC7YYrQu6MCVtizHnOtkSX7FqIoi # 6jlcfqfo619uDH9r8k2qAOHCeEAqKXKymIXDMcGGlEdDFbYiDZgPCBM0IHgAeilU # Son07wjHu0e0ssBmtBafPb4Gd+5FuRnWG3XGe91NCpLKqmFa/4GkVz9OMzZUg8oc # zxC/4JT3Hf45JEtszToXwNskV3JNCcu2IItr6SJHmi3EDVADDRSNhdzFRpYmplGE # lPl5GRoPtJiDEvRIbv5MFKIw2x9gnehf5IvBjC4ZkBg+4GTpqGE3mmnzF3nIekOk # X4ug0/0mN2CSarhuSi9NmHIOpUN2eQHUtgTb/+Gmq7gktCMwIq/JOCYIiTYqpv1o # bjAGKdWMPCrlSyNAs0jZYzkha535158NMx+wBGvsfFoVsCMG5Ocp6vW6CXyuWRbU # VqMU1OrQbHfdyzJpbhJC1PbAZIyJCbN+VBgDTAzTKY8w4ISSwTCCB3EwggVZoAMC # AQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV # BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w # HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m # dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIy # NVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw # ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9 # DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2 # Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N # 7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXc # ag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJ # j361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjk # lqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37Zy # L9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M # 269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLX # pyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLU # HMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode # 2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEA # ATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYE # FJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEB # MEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv # RG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEE # AYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB # /zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEug # SaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9N # aWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsG # AQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jv # b0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt # 4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsP # MeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++ # Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9 # QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2 # wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aR # AfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5z # bcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nx # t67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3 # Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+AN # uOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/Z # cGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSBzjCB # yzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMc # TWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBU # U1MgRVNOOkRDMDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1T # dGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQCmCPHbmseASfe//bGtX9eQG+0+ # 46CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3 # DQEBCwUAAgUA7mYYYjAiGA8yMDI2MDkyOTEwNTg0MloYDzIwMjYwOTMwMTA1ODQy # WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDuZhhiAgEAMAcCAQACAgDXMAcCAQAC # AhMuMAoCBQDuZ2niAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKg # CjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAIED0r+r # KDQniavYVhGCHcVBCIhyttv1GpNBwSZhG9FtgbxGWmYLF4aJYDmrTX+Jwkx/LIUc # uu0vc/WHV8t+10X7yS6Bl0lyZ1WFXZYczT7GX8wVPPSlNTvJBtWekekGsZLWK7wf # MfAmusLDDo6qD14uX90EIg7KYDGa9V84NY0ymLDSQN+mOT4v8YSabI6ekE1OQy3t # jQt8tUzTQcDji6qywEAC5RMvQ0Rho+9+IWz8FoIW0G77NSeROkVBWlmdJjge+XeZ # 2kdCdhOL1aQwtNW89XpxtPD/cZHh6Fl51tu/3i3eJMZqVY+g3RJ8Vy/Kv5F20Pzb # a2AkHtvkNj4/1LgxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UE # CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z # b2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQ # Q0EgMjAxMAITMwAAAiQ7hCGwLKxkIgABAAACJDANBglghkgBZQMEAgEFAKCCAUow # GgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCCktpg3 # FP7dUzgpKQ/iu/io/yfuGgAOI0qOMV8cQWBbmjCB+gYLKoZIhvcNAQkQAi8xgeow # gecwgeQwgb0EIEghPTdqm/dRyZ0BczXcdloVEqICdcmpVNbH9CEVzWSOMIGYMIGA # pH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT # B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE # AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIkO4QhsCysZCIA # AQAAAiQwIgQgKOJTFvVFL8rN9z5CLdhvzDJWioyUjbyS/WVhPH+vVR8wDQYJKoZI # hvcNAQELBQAEggIAbegXVs7nhDlvhv10puduY/6CmDsKM0fpM4BgjPcdRLBocDcC # bH04BIuLc5naLfFoMaFes+gHv1xUjgCF0/Thhf9OhABjadQNQmFDtgRTO3ztpRZ+ # rNUGr2Tz9kesxRZ2a8ixfE4bS515aY+uudwqEEE9T17DDRLYfTOSJMrC8388Powj # LmwcN4Z5bDRzWdsES5QvRKyBaDSp3PZjbrJTAo/LMyhqexS5Uy9yhu4E0G//hm2M # 86PWtRXqjtQH8gDIJpPcl+6lly/JEcY5nM7nb36dF4FDtpXPTP8bUneCFy4lTNTp # 2By5NR8fcsyhEBbtx7tW1vDp68oW1X0x9wFhaR2E3QJfn99xkFgfZtU6Undf9v/1 # S2CgOLeFBzpmeRLXEa4wbi36H2Gupy15SraXlo4s4bmQhBopIkHVmJef5mSLO+CI # VG8sDTLX7YCPZOtwO9BZo0UaY8etX405DalKQ4c7qYJWvCss1LgoPtjaM+iI8fj/ # KNUzDX5NoIU6F1/tvQhwlO7bC8lgkXcVN4Oarh8D7WNqMUP7pp3dUXcIgd3WSujG # JsOTkExPlEQV+1i2bQvEueg0DNykeGsoSyYGyQc/Eqv59xvVrAUmR+iWoj6tXH3L # NG8cavmRM35Tsadh2OUDwXJZtOW3mI3jbs3+6bvZ+VitZViGjBmhruvqBA0= # SIG # End signature block |