Avm.Authoring

0.42.0

Private/Tests/Invoke-AvmBicepAuthorizationRead.ps1

                                function Invoke-AvmBicepAuthorizationRead {

    [CmdletBinding()]

    [OutputType([object[]])]

    param(

        [Parameter(Mandatory)] [scriptblock] $Read,

        [ValidateScript({ $_.Kind -eq [System.DateTimeKind]::Utc })] [datetime] $DeadlineUtc,

        [System.Collections.IDictionary] $Policy,

        [string] $Activity,

        [string] $DiagnosticTarget

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    if (-not $PSBoundParameters.ContainsKey('Policy')) { $Policy = Get-AvmBicepRetryPolicy }

    $propagation = $Policy['authorizationPropagation']

    $started = Get-Date -AsUTC

    $deadline = $started.AddSeconds($propagation['timeoutSeconds'])

    if ($PSBoundParameters.ContainsKey('DeadlineUtc') -and $DeadlineUtc -lt $deadline) { $deadline = $DeadlineUtc }

    $safeActivity = if ($Activity -ceq 'Read cleanup operation page') { 'cleanup operation page' } else { 'Azure read' }

    $target = 'unavailable'

    if (-not [string]::IsNullOrWhiteSpace($DiagnosticTarget)) {

        $targetText = $DiagnosticTarget.Split('?')[0].Split('#')[0].ToLowerInvariant()

        $target = [Convert]::ToHexString([System.Security.Cryptography.SHA256]::HashData(

                [System.Text.Encoding]::UTF8.GetBytes($targetText)))

    }

    $attempt = 0

    $reads = 0

    $matched = 0

    $unclassified = $false

    $outcome = 'interrupted'

    $lastStatus = 'unavailable'

    $lastRequestId = 'unavailable'

    try {

        for ($attempt = 1; $attempt -le $propagation['attempts']; $attempt++) {

            if ((Get-Date -AsUTC) -ge $deadline) {

                $outcome = 'deadline exceeded'

                throw [System.TimeoutException]::new('Authorization propagation read exceeded its deadline.')

            }

            $failure = $null

            $response = $null

            $lastStatus = 'unavailable'

            $lastRequestId = 'unavailable'

            try {

                $reads++

                $result = @(& $Read)

                if ($result.Count -eq 1) { $response = $result[0] }

                $retryable = $result.Count -eq 1 -and (Test-AvmBicepAuthorizationFailed -Response $response -Policy $Policy)

                if (-not $retryable) {

                    $status = Get-AvmPropertyValue -InputObject $response -Name 'StatusCode' -NoEnumerate

                    if (($status -is [int] -or $status -is [System.Net.HttpStatusCode]) -and

                        [int]$status -eq $propagation['statusCode']) { $unclassified = $true }

                    $outcome = if ($unclassified) { 'not retryable' } else { 'returned' }

                }

            }

            catch {

                $failure = $_

                if (-not (Test-AvmBicepAuthorizationFailed -ErrorRecord $failure -Policy $Policy)) {

                    $outcome = 'exception'

                    throw

                }

                $response = Get-AvmPropertyValue -InputObject $failure.Exception -Name 'Response' -NoEnumerate

                $retryable = $true

            }

            if ($retryable -or $matched -gt 0 -or $unclassified) {

                $status = Get-AvmPropertyValue -InputObject $response -Name 'StatusCode' -NoEnumerate

                if (($status -is [int] -or $status -is [System.Net.HttpStatusCode]) -and

                    [int]$status -ge 100 -and [int]$status -le 599) { $lastStatus = [string][int]$status }

                try {

                    $requestId = Get-AvmBicepResponseRequestId -Response $response

                    if ($requestId) { $lastRequestId = $requestId }

                }

                catch { $lastRequestId = 'unavailable' }

            }

            if (-not $retryable) {

                return $result

            }

            $matched++

            if ($matched -eq 1) {

                Write-AvmLog -Level Warning -WarningAction Continue -Message (

                    "Authorization read retry started: activity=$safeActivity; target-sha256=$target; " +

                    "HTTP $lastStatus; code=$($propagation['errorCode']); request-id=$lastRequestId.")

            }

            $remaining = ($deadline - (Get-Date -AsUTC)).TotalSeconds

            if ($attempt -eq $propagation['attempts'] -or $remaining -le 0) {

                $outcome = 'exhausted'

                if ($null -ne $failure) { throw $failure }

                return $result

            }

            Start-Sleep -Seconds ([math]::Min($propagation['pollIntervalSeconds'], $remaining))

            if ((Get-Date -AsUTC) -ge $deadline) {

                $outcome = 'exhausted'

                if ($null -ne $failure) { throw $failure }

                return $result

            }

        }

    }

    finally {

        if ($matched -gt 0 -or $unclassified) {

            $elapsed = [math]::Round(((Get-Date -AsUTC) - $started).TotalSeconds, 1)

            Write-AvmLog -Level Warning -WarningAction Continue -Message (

                "Authorization read finished: activity=$safeActivity; target-sha256=$target; " +

                "attempts=$reads; matched=$matched; elapsed-seconds=$elapsed; outcome=$outcome; " +

                "HTTP $lastStatus; request-id=$lastRequestId.")

        }

    }

}

# SIG # Begin signature block

# MIInUgYJKoZIhvcNAQcCoIInQzCCJz8CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAW1IJjRFTv6947

# g7qgX32tmPqNDCkefdHLTgovF24gI6CCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1

# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP

# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC

# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf

# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j

# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT

# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT

# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw

# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w

# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl

# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC

# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN

# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK

# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK

# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY

# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu

# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE

# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz

# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6

# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO

# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD

# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC

# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX

# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ

# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq

# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo

# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv

# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a

# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1

# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO

# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7

# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ

# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS

# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm

# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3

# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E

# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX

# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP

# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw

# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC

# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D

# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY

# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI

# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6

# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w

# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7

# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK

# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK

# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw

# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT

# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghnfMIIZ2wIBATBu

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEILrsInnrtkPcMZ33mYCw7NMP9opm

# VWgA8cnw+TQhSGwjMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv

# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE

# ggEAXkr7Tkg28qKLqFQRR/bWQAjWF61McgUKcPqD3Rk7kMvJpP23EziCWqHG4bBq

# MB43EUld3DpmbSzdRbWvyUp4JtxLq2X4FFy2AQ4OMUXZVwAJ6/7SPHC3y4xp0S6G

# yCavEDHH68XLtfh3Ssy87nlL9Q0RWnUSgJhYkqBmkawtPUohTvx0U6v0xbfsU6wL

# 6arqSQNUWq3j1Gha4RmTOEo1PTDTYMEKsMWebf1GeKgKl94JjevTlpg6ZytFkJ8F

# roPgC3YZLJvoKksPJlurnFsqCHDlMsUARIu0pK6YAoPEmL37ysvXFvzVBjKhhp/8

# w9AdKqExKGb2TFIx9pWhk3EGOqGCF68wgherBgorBgEEAYI3AwMBMYIXmzCCF5cG

# CSqGSIb3DQEHAqCCF4gwgheEAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsqhkiG

# 9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC

# AQUABCCE1hTsq1pinIGND2PsGJPDRd9foVF0GqJWbuuK/YCnZAIGavNrKZ/MGBIy

# MDI2MTExMTE0MDEwNS44MVowBIACAfSggdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k

# IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjZG

# MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2

# aWNloIIR/jCCBygwggUQoAMCAQICEzMAAAIzEF+3NtqoQFIAAQAAAjMwDQYJKoZI

# hvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO

# BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm

# MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjYxMDE1

# MTgzNzQwWhcNMjgwMTExMTgzNzQwWjCB0zELMAkGA1UEBhMCVVMxEzARBgNVBAgT

# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0

# aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NkYxQS0wNUUw

# LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIi

# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC8l5hSmRcLNSX1OAtiblnbTOjV

# i3VdcPzuwTMCzmZwYGvqsze6jiLl8wB+WOSKMl/BjfKl+cG49fwhhL9IqrmTerRn

# YHOtXMwswtMDzU482BT8eykyP3B38DES7PsDTAfm+K8tBY6uJshpfkR+ng4W3e9L

# UVLZsM0vyiOG/W/7JUpFfRYCZw3WPWUYqX/uqA93Z8mdAkBsxVLo2MBbXqXuAsli

# sURP8P2CVA0C3Rmg2+02FZAfdPGg6+0eXdVUVmlul1ui1cx0tvTfX8NNcFVxXBwo

# T7Pb1nMq6X9lB/XHIFAVu+oRuyN4GmU6hjCUh+dmycTEK+nNreYYr0Xj1QiNHgWD

# 3wOQ4DLXjnGSJMb+U7UBZwGjmToiCeIp49J66zhNE4wQUOH39OsrtKHHg8W8tBhO

# w3Tzxa0gF3Wcz8BvRdY+UGmgok3a1UImz+3svu3uvRacd2GKo1wzsJ1QCBbCtwjJ

# EeE18cWhHy1mZcb4PVcNxUPzfbAupPF+ERkNl/ow5bIUz+nvmlV2lSMwrovsFG0u

# qarv7eyW0aBVO4LLbc5O8ozNnQyDPNIhDnv9chnLJSXpWloQFHy+PEiNV88KBJZQ

# hIr2M1q0sUdB5kmZDRhlsSaEE0UZtwcj6VJetNeJUlDrlT1V2krlD6IPgZa/NOg0

# 3duyOKpEZnVyfTPSBQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFDTcA1da+VN0e9H9

# +gL+81bOCZ6yMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1Ud

# HwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3Js

# L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggr

# BgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNv

# bS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIw

# MTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw

# DgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQBUF0lu8s2Eux08/MSG

# D79uQsl5EPEByxSD+em44YOrxILObuNdMKObxlMQ18DEf/aC7D+esFks57mQts+P

# eA8uBib2T0Y6wGGzAyLjyu2XpXSBvU45yRVBCQJJBfKPI6yMjMiCkh7Ge5999rA5

# 4MLm3ausyk6/HWa2pWd81kgYynKCmgaHmpsX8/vi6E25oznZQQDf5XFdR/11JQ/0

# uBjNjiQseucm6WRJDpAeLExrYiYY1iIY/t+2l7yTx2S+NsbNOi6iWOWoKoeImZiu

# M+XrzH2s+vf6SKUq56a9rDIu1DrNvRbO9IotK/ou8TwNua4B5ydtHwKMM3J4qJWq

# fJjthUqHzFwpca/bQxYVWJE2snAPrrZGYqM6uul8SL4vNNV99HsUH0hNGd+UwJuh

# GI8ibi6ce/vMoYUM/Z7tChbXt0DLRAYYF5HjRTH/MMVTZgJEwHzQ7FRgSCanqMfT

# p0hZ5Hrlv/ACbbJvaHSRrhuBJ7vsHkv95kVGLZbBjt/sEULfoen99eQwyjlDxccQ

# NB9C1QdZjfFEPWwKJFRPSD0m8D1Tb61GH9Rev6ucdb3UQhbbGqsTAsKfCtHpiqYf

# hUrgtJAnzn+a2sPMTTAo6EFxkI+ApIVjFhNcMheDmrXF4TfZjyLUFhircZ0bu5dT

# u1Oc0TdZwu0jaJ1wtN3IG1ehmjCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkA

# AAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl

# IEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVow

# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd

# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUA

# A4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX

# 9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1q

# UoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8d

# q6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byN

# pOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2k

# rnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4d

# Pf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgS

# Uei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8

# QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6Cm

# gyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzF

# ER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQID

# AQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQU

# KqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1

# GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0

# bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMA

# QTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbL

# j+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1p

# Y3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0w

# Ni0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIz

# LmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwU

# tj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN

# 3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU

# 5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5

# KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGy

# qVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB6

# 2FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltE

# AY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFp

# AUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcd

# FYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRb

# atGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQd

# VTNYs6FwZvKhggNZMIICQQIBATCCAQGhgdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k

# IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjZG

# MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2

# aWNloiMKAQEwBwYFKw4DAhoDFQBbE8osOLFy7jKCPdFImKD+e14MFKCBgzCBgKR+

# MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT

# HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA

# 7p6STjAiGA8yMDI2MTExMTA3MDU1MFoYDzIwMjYxMTEyMDcwNTUwWjB3MD0GCisG

# AQQBhFkKBAExLzAtMAoCBQDunpJOAgEAMAoCAQACAg23AgH/MAcCAQACAhJxMAoC

# BQDun+POAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEA

# AgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAES2z+Tq2G0ir4DH

# FtIS6ZNQmZuM1PicM/JOKwH+Bw1kwIds/ll3b+eKofAJDc4qn/cr7yiFHdRpq0eo

# sfXFmHoEZbeJHzf1zxciUQezCgq+HkjpU8AiO+X3Mk1Scy31dlj7NKQmgSE5ZizI

# +Qpazq3cAhD1RdRWqGbHss8O9XgGuZ1E1RAzn+J9P5wwT8VzOqr1xxxZ6wr9iCy+

# +xpc3U6fzm6J9zYiaRMraLZn7zX/eYOk5zcX39g+nDtg/I38xLSMqZXc8yVtxksv

# Bc8Qz/Faf1qF1nrs35L4C/+dOTuyMHQpHZURUueurONjI4KX/ucpNOGOf/rngBVS

# agRs7OExggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MAITMwAAAjMQX7c22qhAUgABAAACMzANBglghkgBZQMEAgEFAKCCAUowGgYJKoZI

# hvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCBiwy9mv4R8fHY/

# E5552zwf6wIG/S4GmP7y0DRPJvMH6zCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQw

# gb0EIJa57mILS0hdZpTRBP9SncxQtlRvlT173qrjREHSDjmXMIGYMIGApH4wfDEL

# MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v

# bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWlj

# cm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIzEF+3NtqoQFIAAQAAAjMw

# IgQgW5llLnIpT8dFjYjKlwpmX20Rqy7i4XT0tJrSj54LWuowDQYJKoZIhvcNAQEL

# BQAEggIAnzhm45v1iHhBZyKS+lRunr/OSeLp585TJDTv13xncsINtP9CDy5OJmDZ

# sE43eBSZ5bv5jhISM/LTwCb8fu/bZHQMTldQlc4xbsKBCDC19FbQ2BLbpOvxdjog

# XUtQi0Yrmq/JIWKemDiA+Yr+ECMpUv1yS1DyM9K4PVDtLydt4LKFPeCmEU5LBgbh

# qpefAVHfyYET+W2NImb710puogS79NavcZ65gv5Mq4Cz0WyfglJZLBiEKoghwvQS

# PIGW24sVlM+MOmjALxvLa5L/qpIB2l1lj5I4EwClRTHWR0Us2IHOinjhV1hWyld9

# 6gsh7rQyzWChW9Ur9vPpeEwJoE0WHOHFb8avzXGojZfGTmNTTxRDTk2R9sPKE24Q

# c0ElvKxR0a/4Io9w73RTYC7N/NQp08BM0zYrF1cb4xPdBF5Rn39f70ISGZZi/E5j

# pxJZUdZcV5shBeKdIeFZ7K5cMhaqIcyEDmUfN2dnwmjf/9qv9wGPcNDiNsbUga3r

# 70/8b3L/fjK/Xe2GNKtzeY2oWyjxLIK8vi5+MnayyXkUqUXQc7QX2lNCMd+x0HTr

# bgNP2wQJ3wGcqx1tj7qopBYgKb7nHYmV/WkL9TZg3TRm1lIBOU3CWv5Rp2425Avp

# hj/gqempi2wnXYsM0YPfte878tpaNlxk3BJ9Wh5siuNqz1llDno=

# SIG # End signature block