Microsoft.PowerPlatform.EnterprisePolicies

0.5.4

Private/RESTHelpers.ps1

                                <#

SAMPLE CODE NOTICE

THIS SAMPLE CODE IS MADE AVAILABLE AS IS. MICROSOFT MAKES NO WARRANTIES, WHETHER EXPRESS OR IMPLIED,

OF FITNESS FOR A PARTICULAR PURPOSE, OF ACCURACY OR COMPLETENESS OF RESPONSES, OF RESULTS, OR CONDITIONS OF MERCHANTABILITY.

THE ENTIRE RISK OF THE USE OR THE RESULTS FROM THE USE OF THIS SAMPLE CODE REMAINS WITH THE USER.

NO TECHNICAL SUPPORT IS PROVIDED. YOU MAY NOT DISTRIBUTE THIS CODE UNLESS YOU HAVE A LICENSE AGREEMENT WITH MICROSOFT THAT ALLOWS YOU TO DO SO.

#>

<#

.SYNOPSIS

    Import this module to get functions to help handling REST calls.

.DESCRIPTION

    This script can be imported to enable cmdlets to deal with HTTP connection and JSON messages.

.NOTES

    Copyright © 2025 Microsoft. All rights reserved.

#>

<#

.SYNOPSIS

    Create new HttpRequestMessage object and set Json content and authorization header

#>

function New-JsonRequestMessage

{

    param(

        [Parameter(Mandatory=$true)]

        [string] $Uri,

        [Parameter(Mandatory=$true)]

        [System.Security.SecureString] $AccessToken,

        [Parameter(Mandatory=$false)]

        [string] $Content,

        [Parameter(Mandatory=$false)]

        [System.Net.Http.HttpMethod] $HttpMethod = [System.Net.Http.HttpMethod]::Post

    )

    Write-Verbose "Creating request for URI: $Uri"

    $request = New-Object -TypeName System.Net.Http.HttpRequestMessage -ArgumentList @($HttpMethod, $Uri)

    if ($Content)

    {

        $request.Content = New-Object -TypeName System.Net.Http.StringContent -ArgumentList @($Content, [System.Text.Encoding]::UTF8, "application/json")

    }

    $request.Headers.Authorization = "Bearer $(ConvertFrom-SecureStringInternal $AccessToken)"

    return $request

}

function New-EnvironmentRouteRequest

{

    param(

        [Parameter(Mandatory)]

        [string] $EnvironmentId,

        [Parameter(Mandatory)]

        [string] $Path,

        [Parameter(Mandatory)]

        [string] $Query,

        [Parameter(Mandatory)]

        [BAPEndpoint] $Endpoint,

        [Parameter(Mandatory=$true)]

        [System.Security.SecureString] $AccessToken,

        [Parameter(Mandatory=$false)]

        [string] $Content,

        [Parameter(Mandatory=$false)]

        [System.Net.Http.HttpMethod] $HttpMethod = [System.Net.Http.HttpMethod]::Post

    )

    $hostName = Get-EnvironmentRouteHostName -Endpoint $Endpoint -EnvironmentId $EnvironmentId

    $uriBuilder = [System.UriBuilder]::new()

    $uriBuilder.Scheme = "https"

    $uriBuilder.Host = "primary-$hostName"

    $uriBuilder.Path = $Path

    $uriBuilder.Query = $Query

    $request = New-JsonRequestMessage -Uri $uriBuilder.Uri.ToString() -AccessToken $AccessToken -Content $Content -HttpMethod $HttpMethod

    $request.Headers.Host = $hostName

    return $request

}

function New-HomeTenantRouteRequest

{

    param(

        [Parameter(Mandatory)]

        [string] $TenantId,

        [Parameter(Mandatory)]

        [string] $Path,

        [Parameter(Mandatory)]

        [string] $Query,

        [Parameter(Mandatory)]

        [BAPEndpoint] $Endpoint,

        [Parameter(Mandatory=$true)]

        [System.Security.SecureString] $AccessToken,

        [Parameter(Mandatory=$false)]

        [string] $Content,

        [Parameter(Mandatory=$false)]

        [System.Net.Http.HttpMethod] $HttpMethod = [System.Net.Http.HttpMethod]::Post

    )

    $hostName = Get-TenantRouteHostName -Endpoint $Endpoint -TenantId $TenantId

    $uriBuilder = [System.UriBuilder]::new()

    $uriBuilder.Scheme = "https"

    $uriBuilder.Host = $hostName

    $uriBuilder.Path = $Path

    $uriBuilder.Query = $Query

    $request = New-JsonRequestMessage -Uri $uriBuilder.Uri.ToString() -AccessToken $AccessToken -Content $Content -HttpMethod $HttpMethod

    $request.Headers.Host = $hostName

    return $request

}

<#

.SYNOPSIS

    Gets a singleton HttpClient object or creates a new one and clears Default Request Headers

#>

function Get-HttpClient

{

    if($null -eq $script:httpClient)

    {

        [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls13 -bor [System.Net.SecurityProtocolType]::Tls12

        $script:httpClient = New-Object -TypeName System.Net.Http.HttpClient

        $script:httpClient.DefaultRequestHeaders.Clear()

    }

    return $script:httpClient

}

<#

.SYNOPSIS

    Given an async Task, await and return its result

#>

function Get-AsyncResult

{

    param(

        [Parameter(Mandatory=$true)]

        $task

    )

    try

    {

        $result = $task.GetAwaiter().GetResult()

    }

    catch

    {

        if ($_.Exception.InnerException)

        {

            # Two levels into inner exceptions have network connection problem messages

            if ($_.Exception.InnerException.InnerException)

            {

                throw $_.Exception.InnerException.InnerException.Message

            }

            else

            {

                throw $_.Exception.InnerException.Message   

            }

        }

        else

        {

            throw $_.Exception.Message

        }

    }

    return $result

}

function Get-EnvironmentRouteHostName {

    param (

        [Parameter(Mandatory)]

        [string] $EnvironmentId,

        [Parameter(Mandatory)]

        [BAPEndpoint] $Endpoint

    )

    $baseUri = Get-APIResourceUrl -Endpoint $Endpoint

    # Separate the scheme from the base URI

    $baseUri = $baseUri.Replace("https://", "").Trim('/')

    $EnvironmentId = $EnvironmentId.Replace("-", "")

    if($Endpoint -eq [BAPEndpoint]::tip1 -or $Endpoint -eq [BAPEndpoint]::tip2) {

        $shortEnvId = $EnvironmentId.Substring($EnvironmentId.Length - 1, 1)

        $remainingEnvId = $EnvironmentId.Substring(0, $EnvironmentId.Length - 1)

    }

    else {

        $shortEnvId = $EnvironmentId.Substring($EnvironmentId.Length - 2, 2)

        $remainingEnvId = $EnvironmentId.Substring(0, $EnvironmentId.Length - 2)

    }

    return "$remainingEnvId.$shortEnvId.environment.$baseUri"

}

function Get-TenantRouteHostName {

    param (

        [Parameter(Mandatory)]

        [string] $TenantId,

        [Parameter(Mandatory)]

        [BAPEndpoint] $Endpoint

    )

    $baseUri = Get-APIResourceUrl -Endpoint $Endpoint

    # Separate the scheme from the base URI

    $baseUri = $baseUri.Replace("https://", "").Trim('/')

    $TenantId = $TenantId.Replace("-", "")

    if($Endpoint -eq [BAPEndpoint]::tip1 -or $Endpoint -eq [BAPEndpoint]::tip2) {

        $shortTenantId = $TenantId.Substring($TenantId.Length - 1, 1)

        $remainingTenantId = $TenantId.Substring(0, $TenantId.Length - 1)

    }

    else {

        $shortTenantId = $TenantId.Substring($TenantId.Length - 2, 2)

        $remainingTenantId = $TenantId.Substring(0, $TenantId.Length - 2)

    }

    return "il-$remainingTenantId.$shortTenantId.tenant.$baseUri"

}

function Get-APIResourceUrl {

    param (

        [Parameter(Mandatory)]

        [BAPEndpoint] $Endpoint

    )

    switch ($Endpoint) {

        ([BAPEndpoint]::tip1) { return "https://api.preprod.powerplatform.com/" }

        ([BAPEndpoint]::tip2) { return "https://api.test.powerplatform.com/" }

        ([BAPEndpoint]::prod) { return "https://api.powerplatform.com/" }

        ([BAPEndpoint]::usgovhigh) { return "https://api.high.powerplatform.microsoft.us/" }

        ([BAPEndpoint]::dod) { return "https://api.appsplatform.us/" }

        ([BAPEndpoint]::china) { return "https://api.powerplatform.partner.microsoftonline.cn/" }

        Default { throw "Unsupported BAP endpoint: $Endpoint" }

    }

}

function Send-RequestWithRetries {

    param (

        [Parameter(Mandatory)]

        [int] $MaxRetries,

        [Parameter(Mandatory)]

        [int] $DelaySeconds,

        [Parameter(Mandatory)]

        [scriptblock] $RequestFactory

    )

    $client = Get-HttpClient

    $attempt = 0

    while ($attempt -lt $MaxRetries) {

        try {

            $result = Get-AsyncResult -Task $client.SendAsync((& $RequestFactory))

            if(Test-Result -Result $result) {

                return $result

            }

            $attempt++

        }

        catch {

            $attempt++

            Write-Verbose "Exception on attempt $attempt : $($_.Exception.Message)"

            if($attempt -ge $MaxRetries) {

                throw "Request failed after $MaxRetries attempts. Last error: $($_.Exception.Message)"

            }

        }

        if ($attempt -ge $MaxRetries) {

            Write-Host "Request failed after $MaxRetries attempts." -ForegroundColor Red

            Assert-Result -Result $result

        }

        Write-Verbose "Request failed on attempt $attempt. Retrying in $DelaySeconds seconds..."

        Start-Sleep -Seconds $DelaySeconds

    }

}

function Test-Result {

    param (

        [Parameter(Mandatory)]

        $Result

    )

    if (-not($Result.IsSuccessStatusCode))

    {

        $contentString = Get-AsyncResult -Task $Result.Content.ReadAsStringAsync()

        if ($contentString)

        {

            $errorMessage = $contentString.Trim('.')

            Write-Verbose "API Call returned $($Result.StatusCode): $($errorMessage). Correlation ID: $($($Result.Headers.GetValues("x-ms-correlation-id") | Select-Object -First 1))"

            return $false

        }

        else

        {

            Write-Verbose "API Call returned $($Result.StatusCode): $($Result.ReasonPhrase). Correlation ID: $($($Result.Headers.GetValues("x-ms-correlation-id") | Select-Object -First 1))"

            return $false

        }

    }

    return $true

}

function Assert-Result {

    param (

        [Parameter(Mandatory)]

        $Result

    )

    if (-not($Result.IsSuccessStatusCode))

    {

        $contentString = Get-AsyncResult -Task $Result.Content.ReadAsStringAsync()

        if ($contentString)

        {

            $errorMessage = $contentString.Trim('.')

            Write-Verbose "API Call returned $($Result.StatusCode): $($errorMessage). Correlation ID: $($($Result.Headers.GetValues("x-ms-correlation-id") | Select-Object -First 1))"

            throw "API Call returned $($Result.StatusCode): $($errorMessage). Correlation ID: $($($Result.Headers.GetValues("x-ms-correlation-id") | Select-Object -First 1))"

        }

        else

        {

            Write-Verbose "API Call returned $($Result.StatusCode): $($Result.ReasonPhrase). Correlation ID: $($($Result.Headers.GetValues("x-ms-correlation-id") | Select-Object -First 1))"

            throw "API Call returned $($Result.StatusCode): $($Result.ReasonPhrase). Correlation ID: $($($Result.Headers.GetValues("x-ms-correlation-id") | Select-Object -First 1))"

        }

    }

}

function ConvertFrom-JsonToClass {

    param (

        [string]$Json,

        [Type]$ClassType

    )

    $data = $Json | ConvertFrom-Json

    # Handle array types directly

    if ($ClassType.IsArray) {

        $elementType = $ClassType.GetElementType()

        $itemList = @()

        foreach ($item in $data) {

            $itemJson = $item | ConvertTo-Json -Depth 10

            $itemList += ConvertFrom-JsonToClass -Json $itemJson -ClassType $elementType

        }

        return ,$itemList  

    }

    # Handle primitive types and strings

    if ($ClassType.IsPrimitive -or $ClassType -eq [string]) {

        return ($data -as $ClassType)

    }

    # Handle common value types explicitly

    if ($ClassType -eq [DateTime]) {

        return [DateTime]::Parse($data)

    }

    if ($ClassType.FullName -eq 'System.Guid') {

        return [Guid]::Parse($data)

    }

    if ($ClassType.FullName -eq 'System.Decimal') {

        return [Decimal]::Parse($data)

    }

    # Handle complex types

    $instance = [Activator]::CreateInstance($ClassType)

    foreach ($property in $ClassType.GetProperties()) {

        $name = $property.Name

        $type = Get-UnderlyingType $property.PropertyType

        if ($data.PSObject.Properties[$name]) {

            if ($type -eq [hashtable] -or $type.FullName -eq 'System.Collections.Hashtable') {

                $instance.$name = ConvertTo-Hashtable $data.$name

            }

            elseif ($type.IsClass -and $type -ne [string]) {

                $nestedJson = $data.$name | ConvertTo-Json -Depth 10

                $instance.$name = ConvertFrom-JsonToClass -Json $nestedJson -ClassType $type

            }

            else {

                $instance.$name = $data.$name

            }

        }

    }

    return $instance

}

function Get-UnderlyingType([type]$t) {

    if ($t.IsGenericType -and $t.GetGenericTypeDefinition().FullName -eq 'System.Nullable`1') {

        return $t.GetGenericArguments()[0]

    }

    return $t

}

function ConvertTo-Hashtable($obj) {

    if ($obj -is [hashtable]) {

        return $obj

    }

    $hash = @{}

    foreach ($property in $obj.PSObject.Properties) {

        $hash[$property.Name] = $property.Value

    }

    return $hash

}

# SIG # Begin signature block

# MIIoGwYJKoZIhvcNAQcCoIIoDDCCKAgCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCB19lq1qDQTRPys

# XX2ObVN4eZMw+a63GVcFWjYRN75566CCDYUwggYDMIID66ADAgECAhMzAAAEhJji

# EuB4ozFdAAAAAASEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjUwNjE5MTgyMTM1WhcNMjYwNjE3MTgyMTM1WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDtekqMKDnzfsyc1T1QpHfFtr+rkir8ldzLPKmMXbRDouVXAsvBfd6E82tPj4Yz

# aSluGDQoX3NpMKooKeVFjjNRq37yyT/h1QTLMB8dpmsZ/70UM+U/sYxvt1PWWxLj

# MNIXqzB8PjG6i7H2YFgk4YOhfGSekvnzW13dLAtfjD0wiwREPvCNlilRz7XoFde5

# KO01eFiWeteh48qUOqUaAkIznC4XB3sFd1LWUmupXHK05QfJSmnei9qZJBYTt8Zh

# ArGDh7nQn+Y1jOA3oBiCUJ4n1CMaWdDhrgdMuu026oWAbfC3prqkUn8LWp28H+2S

# LetNG5KQZZwvy3Zcn7+PQGl5AgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUBN/0b6Fh6nMdE4FAxYG9kWCpbYUw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwNTM2MjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AGLQps1XU4RTcoDIDLP6QG3NnRE3p/WSMp61Cs8Z+JUv3xJWGtBzYmCINmHVFv6i

# 8pYF/e79FNK6P1oKjduxqHSicBdg8Mj0k8kDFA/0eU26bPBRQUIaiWrhsDOrXWdL

# m7Zmu516oQoUWcINs4jBfjDEVV4bmgQYfe+4/MUJwQJ9h6mfE+kcCP4HlP4ChIQB

# UHoSymakcTBvZw+Qst7sbdt5KnQKkSEN01CzPG1awClCI6zLKf/vKIwnqHw/+Wvc

# Ar7gwKlWNmLwTNi807r9rWsXQep1Q8YMkIuGmZ0a1qCd3GuOkSRznz2/0ojeZVYh

# ZyohCQi1Bs+xfRkv/fy0HfV3mNyO22dFUvHzBZgqE5FbGjmUnrSr1x8lCrK+s4A+

# bOGp2IejOphWoZEPGOco/HEznZ5Lk6w6W+E2Jy3PHoFE0Y8TtkSE4/80Y2lBJhLj

# 27d8ueJ8IdQhSpL/WzTjjnuYH7Dx5o9pWdIGSaFNYuSqOYxrVW7N4AEQVRDZeqDc

# fqPG3O6r5SNsxXbd71DCIQURtUKss53ON+vrlV0rjiKBIdwvMNLQ9zK0jy77owDy

# XXoYkQxakN2uFIBO1UNAvCYXjs4rw3SRmBX9qiZ5ENxcn/pLMkiyb68QdwHUXz+1

# fI6ea3/jjpNPz6Dlc/RMcXIWeMMkhup/XEbwu73U+uz/MIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGewwghnoAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAASEmOIS4HijMV0AAAAA

# BIQwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# LwYJKoZIhvcNAQkEMSIEIEMflsnA3Zox8Gp0BD8IrBR3UocGoUgkkwbKFJYsmdTz

# MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAClLVRpy7ZA2L

# Nu9U4YKFXQoREQq+DhkKI4SaK3bvbEWhp4uJHpQjkoOw0qz1NJ8vnYESr1zoCXZN

# utQblHjd79RI7Fnqa5rn9kWER3kyUbqLe4sgdAWn1A3oGJeB5gZlgtvdTawmR6q2

# gxfNHEZzNf/4B/X1a1SzG18Y3h/vlqf4u96gDwql+9ZgPhYwo/M+/uOxKJmUbkIK

# GY4x5fEAmhnO0FZ/y+xu1y5gmpcoGqpSJVSmD6TtFOdbR+Hx++vp/Wn4vVsrBjea

# 5faXTYFt+mJMiVa9o6dcIW1E1R6wB7O2RY3EX+osDChfTrQR7aH5hh3DPTSQOPHp

# asj6QddkU6GCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCC

# F20wghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEE

# ggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCAaqK+k14XA

# vHNoTgBFEkCqnk+9WccB36cyr50zkQe+/AIGaRXGJS+VGBMyMDI1MTEyMDAwMjMy

# NS41MzFaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z

# MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046QTQwMC0wNUUwLUQ5NDcxJTAjBgNV

# BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIB

# AgITMwAAAgJ5UHQhFH24oQABAAACAjANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQg

# VGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNTAxMzAxOTQyNDRaFw0yNjA0MjIxOTQy

# NDRaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYD

# VQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hp

# ZWxkIFRTUyBFU046QTQwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC

# AQC3eSp6cucUGOkcPg4vKWKJfEQeshK2ZBsYU1tDWvQu6L9lp+dnqrajIdNeH1HN

# 3oz3iiGoJWuN2HVNZkcOt38aWGebM0gUUOtPjuLhuO5d67YpQsHBJAWhcve/MVdo

# QPj1njiAjSiOrL8xFarFLI46RH8NeDhAPXcJpWn7AIzCyIjZOaJ2DWA+6QwNzwqj

# BgIpf1hWFwqHvPEedy0notXbtWfT9vCSL9sdDK6K/HH9HsaY5wLmUUB7SfuLGo1O

# WEm6MJyG2jixqi9NyRoypdF8dRyjWxKRl2JxwvbetlDTio66XliTOckq2RgM+Zoc

# ZEb6EoOdtd0XKh3Lzx29AhHxlk+6eIwavlHYuOLZDKodPOVN6j1IJ9brolY6mZbo

# Q51Oqe5nEM5h/WJX28GLZioEkJN8qOe5P5P2Yx9HoOqLugX00qCzxq4BDm8xH85H

# KxvKCO5KikopaRGGtQlXjDyusMWlrHcySt56DhL4dcVnn7dFvL50zvQlFZMhVoeh

# WSQkkWuUlCCqIOrTe7RbmnbdJosH+7lC+n53gnKy4OoZzuUeqzCnSB1JNXPKnJoj

# P3De5xwspi5tUvQFNflfGTsjZgQAgDBdg/DO0TGgLRDKvZQCZ5qIuXpQRyg37yc5

# 1e95z8U2mysU0XnSpWeigHqkyOAtDfcIpq5Gv7HV+da2RwIDAQABo4IBSTCCAUUw

# HQYDVR0OBBYEFNoGubUPjP2f8ifkIKvwy1rlSHTZMB8GA1UdIwQYMBaAFJ+nFV0A

# XmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQ

# Q0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIw

# VGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYD

# VR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEB

# CwUAA4ICAQCD83aFQUxN37HkOoJDM1maHFZVUGcqTQcPnOD6UoYRMmDKv0GabHlE

# 82AYgLPuVlukn7HtJPF2z0jnTgAfRMn26JFLPG7O/XbKK25hrBPJ30lBuwjATVt5

# 8UA1BWo7lsmnyrur/6h8AFzrXyrXtlvzQYqaRYY9k0UFY5GM+n9YaEEK2D268e+a

# +HDmWe+tYL2H+9O4Q1MQLag+ciNwLkj/+QlxpXiWou9KvAP0tIk+fH8F3ww5VOTi

# 9aZ9+qPjszw31H4ndtivBZaH5s5boJmH2JbtMuf2y7hSdJdE0UW2B0FEZPLImeml

# KhslJNVqEO7RPgl7c81QuVSO58ffpmbwtSxhYrES3VsPglXn9ODF7DqmPMG/GysB

# 4o/QkpNUq+wS7bORTNzqHMtH+ord2YSma+1byWBr/izIKggOCdEzaZDfym12GM6a

# 4S+Iy6AUIp7/KIpAmfWfXrcMK7V7EBzxoezkLREEWI4XtPwpEBntOa1oDH3Z/+dR

# xsxL0vgya7jNfrO7oizTAln/2ZBYB9ioUeobj5AGL45m2mcKSk7HE5zUReVkILpY

# KBQ5+X/8jFO1/pZyqzQeI1/oJ/RLoic1SieLXfET9EWZIBjZMZ846mDbp1ynK9Ub

# NiCjSwmTF509Yn9M47VQsxsv1olQu51rVVHkSNm+rTrLwK1tvhv0mTCCB3EwggVZ

# oAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jv

# c29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4

# MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvX

# JHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa

# /rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AK

# OG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rbo

# YiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIck

# w+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbni

# jYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F

# 37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZ

# fD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIz

# GHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR

# /bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1

# Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUC

# AwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0O

# BBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yD

# fQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lv

# cHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkr

# BgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw

# AwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBN

# MEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0

# cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoG

# CCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01p

# Y1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9

# /Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5

# bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvf

# am++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn

# 0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlS

# dYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0

# j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5

# JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakUR

# R6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4

# O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVn

# K+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoI

# Yn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSB

# zjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UE

# CxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVs

# ZCBUU1MgRVNOOkE0MDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQBJiUhpCWA/3X/jZyIy0ye6

# RJwLzqCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqG

# SIb3DQEBCwUAAgUA7MjVfjAiGA8yMDI1MTExOTIzNDcxMFoYDzIwMjUxMTIwMjM0

# NzEwWjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDsyNV+AgEAMAcCAQACAgkfMAcC

# AQACAhNOMAoCBQDsyib+AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkK

# AwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAH3D

# 1b0zTKLI76vy1CrF4herk+FyLDa7uvD+bDI0E0o+pKUKJz+fAgwZZ1vHuzdVT7nu

# r/9kN7FpGRxQQzWsil36u75Ghh7dRWHafS7JAsvE5rffJ+2Kq+YhEJnnckL113S7

# OmKTrfOdF7BUOLp+q7hvQT1VaNgrKY8icvkYkq3alOoSkAvwQVK5iWDPT9Ts8B/Q

# YjGLGw+2YIuMFmuM6dIWPzAW13xDkI/w1zk2H0mZ0Yzvd5l/bXoKC+RANjACDqRR

# 2iAcpnRclriuAGkJtoqRJZX0e/OyhBSSQAxzM8toAG0FxBHdIIA0lDg8cBB+UcHz

# UpLSLouK8JLJanzkOkkxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEG

# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj

# cm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFt

# cCBQQ0EgMjAxMAITMwAAAgJ5UHQhFH24oQABAAACAjANBglghkgBZQMEAgEFAKCC

# AUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCBW

# jSn7OwK9dK264n35OBdkhZ3uRRdEmFDl09uOOG3H5DCB+gYLKoZIhvcNAQkQAi8x

# geowgecwgeQwgb0EIPON6gEYB5bLzXLWuUmL8Zd8xXAsqXksedFyolfMlF/sMIGY

# MIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAICeVB0IRR9

# uKEAAQAAAgIwIgQgAL6XnPGms3QL5v14lRGnGhnljmJxIaqI3nXjUCe8LIswDQYJ

# KoZIhvcNAQELBQAEggIAlwG0eAMGvrUfZHWPVtP1XAhY9cOQv9SdY/KCHOeQJhdh

# IjyhiIkEvyULqfKMsP4rUYa7zX77J5Zepu6gAkjyDhqutKBgb6dQnxE/vuc3ajRG

# l5hmVQj4XsEzc8nmsK8jUQFN7+vJUzx38SWZfu35xyD/+IXjUEQ5v6XQRy5eKZBu

# nQO7UP17QOeuO+rR9bRvJh8vHsMVr4Q3/5KJ4A4Qe5jH1GW8N5PhYp1RY/i6AiqD

# UdoOqpMl4W1veD7o1doellcc3e5/hljIZchdUOJWCAdtSqZjRK/u9xZmKetMsfdQ

# ltUuPSELbveBFEdcyvMu05HEidswEMX6dTfZB8OL+AxyCZGM97DL98Jcy4x9Xo1N

# tQqmgnPPWl/uDgLxeuTBFnXAk21GbfDAu4NQ8PuTLD5WUkaKn2GFqEZJ5Qu9GAtu

# FfEsYHw2z+TAOcgiZOCj2zX7uUtb3juuMHg4UJrpK744HYVmFJNGRFukY0Zh5Dbx

# QWhu8iOT432jcRPCJRp7V8HB+opsiD4VwA5mqj5hwjxspe6MeC/MUM2DLmn513IJ

# /lvohfWlIzaEEIYOCUiX32j5oEm+IEGwiwIM/RefQbL4nGhW9x6TcuQh6SMea/7z

# +HblkMKgZeajo3WqKhMUrsQn4SytS7kOT6z91xJUD3j5FccGjuq/EZHGFjZlDvE=

# SIG # End signature block