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 # MIInQQYJKoZIhvcNAQcCoIInMjCCJy4CAQExDzANBglghkgBZQMEAgEFADB5Bgor # 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 # 1cY2L4A7GTQG1h32HHAvfQESWP0xghndMIIZ2QIBATBuMFcxCzAJBgNVBAYTAlVT # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv # c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w # DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ # KoZIhvcNAQkEMSIEIHByLAtw6rdQiwttmdIIi5sOg2yQmrhm9BfK43t6L3RtMEIG # CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAvvtr+X0nCkWIAfcQ # zrFYp7cphbf0xIpo2ra5F1wJdhyfn9W0MnleRhFm0PyGAZ2CvCqCk+wrHG8k1CMS # NweTIr3gxxH8WmkvC9ESIqB5qSb9uZWXvTBSZZS6RepLA/YpBWUd8pUKAd3WGTJD # kmoSR44+ccPflIFde2f5CKTbvLfvsN4/tYZQe5shKs97gP+WWKY11as9GlxhRSwD # +uYcrqL2oK3fmAeyCrpqXnupUSpH26oI4uTYOXqlpAFzEG5YIYqixxCmjv+pW8Ad # F85GLsKFDNFGjpV/8hHuWGQ9LoJ6SFYw+t6bppl/ji82dv1m+AcoBhJch8sVHufb # YOD2kKGCF60wghepBgorBgEEAYI3AwMBMYIXmTCCF5UGCSqGSIb3DQEHAqCCF4Yw # gheCAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFF # MIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCD28okcqY1k2cr6 # yNEsKghtvT4cfm67yuWkpgbn9zSTbAIGaonl/YvtGBMyMDI2MDgyODE0NTYyNC40 # OTJaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2NTFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEfswggcoMIIF # EKADAgECAhMzAAACFRgD04EHJnxTAAEAAAIVMA0GCSqGSIb3DQEBCwUAMHwxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv # c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgyMFoXDTI2MTEx # MzE4NDgyMFowgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjY1MUEtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF # AAOCAg8AMIICCgKCAgEAw3HV3hVxL0lEYPV03XeNKZ517VIbgexhlDPdpXwDS0BY # txPwi4XYpZR1ld0u6cr2Xjuugdg50DUx5WHL0QhY2d9vkJSk02rE/75hcKt91m2I # h287QRxRMmFu3BF6466k8qp5uXtfe6uciq49YaS8p+dzv3uTarD4hQ8UT7La95pO # JiRqxxd0qOGLECvHLEXPXioNSx9pyhzhm6lt7ezLxJeFVYtxShkavPoZN0dOCiYe # h4KgoKoyagzMuSiLCiMUW4Ue4Qsm658FJNGTNh7V5qXYVA6k5xjw5WeWdKOz0i9A # 5jBcbY9fVOo/cA8i1bytzcDTxb3nctcly8/OYeNstkab/Isq3Cxe1vq96fIHE1+Z # GmJjka1sodwqPycVp/2tb+BjulPL5D6rgUXTPF84U82RLKHV57bB8fHRpgnjcWBQ # uXPgVeSXpERWimt0NF2lCOLzqgrvS/vYqde5Ln9YlKKhAZ/xDE0TLIIr6+I/2JTt # XP34nfjTENVqMBISWcakIxAwGb3RB5yHCxynIFNVLcfKAsEdC5U2em0fAvmVv0so # nqnv17cuaYi2eCLWhoK1Ic85Dw7s/lhcXrBpY4n/Rl5l3wHzs4vOIhu87DIy5QUa # EupEsyY0NWqgI4BWl6v1wgse+l8DWFeUXofhUuCgVTuTHN3K8idoMbn8Q3edUIEC # AwEAAaOCAUkwggFFMB0GA1UdDgQWBBSJIXfxcqAwFqGj9jdwQtdSqadj1zAfBgNV # HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU # aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG # CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV # HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIH # gDANBgkqhkiG9w0BAQsFAAOCAgEAd42HtV+kGbvxzLBTC5O7vkCIBPy/BwpjCzeL # 53hAiEOebp+VdNnwm9GVCfYq3KMfrj4UvKQTUAaS5Zkwe1gvZ3ljSSnCOyS5OwNu # 9dpg3ww+QW2eOcSLkyVAWFrLn6Iig3TC/zWMvVhqXtdFhG2KJ1lSbN222csY3E3/ # BrGluAlvET9gmxVyyxNy59/7JF5zIGcJibydxs94JL1BtPgXJOfZzQ+/3iTc6eDt # maWT6DKdnJocp8wkXKWPIsBEfkD6k1Qitwvt0mHrORah75SjecOKt4oWayVLkPTh # o12e0ongEg1cje5fxSZGthrMrWKvI4R7HEC7k8maH9ePA3ViH0CVSSOefaPTGMzI # hHCo5p3jG5SMcyO3eA9uEaYQJITJlLG3BwwGmypY7C/8/nj1SOhgx1HgJ0ywOJL9 # xfP4AOcWmCfbsqgGbCaC7WH5sINdzfMar8V7YNFqkbCGUKhc8GpIyE+MKnyVn33j # suaGAlNRg7dVRUSoYLJxvUsw9GOwyBpBwbE9sqOLm+HsO00oF23PMio7WFXcFTZA # jp3ujihBAfLrXICgGOHPdkZ042u1LZqOcnlr3XzvgMe+mPPyasW8f0rtzJj3V5E/ # EKiyQlPxj9Mfq2x9himnlXWGZCVPeEBROrNbDYBfazTyLNCOTsRtksOSV3FBtPnp # QtLN754wggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3 # DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIw # MAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAx # MDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l # LVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA # 5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/ # XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1 # hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7 # M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3K # Ni1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy # 1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF80 # 3RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQc # NIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahha # YQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkL # iWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV # 2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIG # CSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUp # zxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBT # MFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jv # c29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYI # KwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGG # MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186a # GMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br # aS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsG # AQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcN # AQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1 # OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYA # A7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbz # aN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6L # GYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3m # Sj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0 # SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxko # JLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFm # PWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC482 # 2rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7 # vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDVjCC # Aj4CAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2NTFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsO # AwIaAxUAj6eTejbuYE1Ifjbfrt6tXevCUSCggYMwgYCkfjB8MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO47pBUwIhgPMjAyNjA4 # MjgwNjA3MTdaGA8yMDI2MDgyOTA2MDcxN1owdDA6BgorBgEEAYRZCgQBMSwwKjAK # AgUA7jukFQIBADAHAgEAAgIOcjAHAgEAAgISljAKAgUA7jz1lQIBADA2BgorBgEE # AYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYag # MA0GCSqGSIb3DQEBCwUAA4IBAQAuZO5D0tzTF2mDYFo1GtgUmQ6MG+JbgE5lSGlH # BLetG+M6aQ/lFcI1Y8EQ7aTA+5tf+ovScCtCwqDUgPERHOlwWvVHZR44o7VqzkNs # LoIaxkNqeY8osuTBgDAIVWjKOsPU7/XMnruC4bBcAoBi94X+29Pi5ZSUWle/T6rw # ztSzlYJHU0Np+m04cV2WKfjQTtbcAKUfMZflUjwXhA1HUpbk+g6/GrEXtK8PtQqT # ZMJ2ZebvF4Te4PADfvnE6Q7qh0Ea2GuhDSGDhrl7nAQEhxN7CFO2xWe0iEivLsc/ # bgjyMxyn/C2iJc55qUOohJrNAEMRECn49gsDurWEojpNUveqMYIEDTCCBAkCAQEw # gZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT # B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE # AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIVGAPTgQcmfFMA # AQAAAhUwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0B # CRABBDAvBgkqhkiG9w0BCQQxIgQgdv1wn+6+MpyuXjAlrBm8NxtX+0gB0BBdEul7 # te/Eu90wgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCBwEPR2PDrTFLcrtQsK # rUi7oz5JNRCF/KRHMihSNe7sijCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwAhMzAAACFRgD04EHJnxTAAEAAAIVMCIEIOLektt40xP4m126aMCv # nL1o7p07b45+S/CVSZz6ktvnMA0GCSqGSIb3DQEBCwUABIICAItd5RwllcfhC+zb # 4sul4gefZPjCQS1+oYgLMFAdiAo8DTY9Brt/rurMsJNtkPJ0h9VZfq4wsPIswfj2 # TMcBSSXbO2eVMs2iMDA3ZIBb5OKAhhwofQlrsKPDY05yHJs2cjL2QCC0JauEq4+1 # 7wwRbPknY3C/iH+6Ce6k3buNASjiLDA3pCOwdP6hxRV0563iy3QLPexVh2+3hZdW # kprcEU7QuXnVrZrdiB5KyTnTU7TayoHfQCH7H4UCldgoSAzUMWGRYGjCIjseg/+/ # th/xXqR0fVb7dWd6uOJxcLxqUZ6NxdahhsmIk7l+unA3oSSzsBNwRln/neeIpj7b # Z7ESwBHNhNBLCV/uU5hS0HDNAW2sb6talm7xebOG0ZfkGtTnxaTXLR7JTADX/f7P # W1X/7wPBqxRvSWd9rwEPDrK8zoA+JELxDmE1ktzd2mpbig4JwL3gwlLma3AawEzx # ZItFHve6eC/qdAD7u2SsJjxPCDrcv6dyq8j0ffcNikN63uCJYusF6pfB+2O15vD9 # c03buHmhVPYjUhtmdZ8wCat8cEpZ4S7LD8RdNQ27GCD1QvCyn8PLb3ktzVSsP54o # 51Z71lV8htf82K+cn921uLm3P1LnRXRuDhmke2manA2ZO/ifJQdwQhN92IKDUnWO # i0AODfrLxPe2JHDFAqyUq2fWBrbn # SIG # End signature block |