Nectar10

4.33

Functions/Private/Helpers.ps1

                                # Internal helper functions used by other module functions

Function New-DynamicParam {

    [cmdletbinding()]

    Param (

        [Parameter(Mandatory=$True)]

        [string]$ParamName,

        [Parameter(Mandatory=$True)]

        [string]$Prefix,

        [Parameter(Mandatory=$True)]

        [bool]$ParamRequired,

        [Parameter(Mandatory=$True)]

        [int]$Position        

    )

    Process {

        # Set the dynamic parameters' name

        New-Variable -Name "ParamName_$Prefix" -Value $ParamName -Scope Script -Force

        # Create the collection of attributes

        $AttribColl_XXX = New-Object System.Collections.ObjectModel.Collection[System.Attribute]

        # Create and set the parameters' attributes

        $ParamAttrib_XXX = New-Object System.Management.Automation.ParameterAttribute

        $ParamAttrib_XXX.Mandatory = $ParamRequired

        $ParamAttrib_XXX.Position = $Position

        # Add the attributes to the attributes collection

        $AttribColl_XXX.Add($ParamAttrib_XXX)

        New-Variable -Name "AttribColl_$Prefix" -Value $AttribColl_XXX -Scope Script -Force

    }

}

Function ConvertFrom-XMLElement {

    <#

    .Synopsis

        Converts named nodes of an element to properties of a PSObject, recursively.

    .Parameter Element

        The element to convert to a PSObject.

    .Parameter SelectXmlInfo

        Output from the Select-Xml cmdlet.

    .Inputs

        Microsoft.PowerShell.Commands.SelectXmlInfo output from Select-Xml.

    .Outputs

        System.Management.Automation.PSCustomObject object created from selected XML.

    .Link

        Select-Xml

    .Example

        Select-Xml /configuration/appSettings/add web.config |ConvertFrom-XmlElement

        key              value

        ---              -----

        webPages:Enabled false

    #>

    #Requires -Version 3

    [CmdletBinding()][OutputType([psobject])] Param(

    [Parameter(ParameterSetName='Element',Position=0,Mandatory=$true,ValueFromPipeline=$true)][Xml.XmlElement] $Element,

    [Parameter(ParameterSetName='SelectXmlInfo',Position=0,Mandatory=$true,ValueFromPipeline=$true)]

    [Microsoft.PowerShell.Commands.SelectXmlInfo]$SelectXmlInfo

    )

    Process

    {

        switch($PSCmdlet.ParameterSetName)

        {

            SelectXmlInfo { @($SelectXmlInfo | ForEach-Object { [Xml.XmlElement]$_.Node } | ConvertFrom-XmlElement) }

            Element

            {

                If(($Element.SelectNodes('*') | Group-Object Name | Measure-Object).Count -eq 1)

                {

                    @($Element.SelectNodes('*') |ConvertFrom-XmlElement)

                }

                Else

                {

                    $properties = @{}

                    $Element.Attributes | ForEach-Object { [void]$properties.Add($_.Name,$_.Value) }

                    foreach ($node in $Element.ChildNodes | Where-Object { $_.Name -and $_.Name -ne '#whitespace' } )

                    {

                        $subelements = $node.SelectNodes('*') | Group-Object Name

                        $value =

                            If($node.InnerText -and !$subelements)

                            {

                                $node.InnerText

                            }

                            ElseIf(($subelements | Measure-Object).Count -eq 1)

                            {

                                @($node.SelectNodes('*') | ConvertFrom-XmlElement)

                            }

                            Else

                            {

                                ConvertFrom-XmlElement $node

                            }

                        If(!$properties.Contains($node.Name))

                        { # new property

                            [void]$properties.Add($node.Name,$value)

                        }

                        Else

                        { # property name collision!

                            If($properties[$node.Name] -isnot [Collections.Generic.List[object]])

                            { $properties[$node.Name] = ([Collections.Generic.List[object]]@($properties[$node.Name],$value)) }

                            Else

                            { $properties[$node.Name].Add($value) }

                        }

                    }

                    New-Object PSObject -Property $properties

                }

            }

        }

    }    

}

Function New-EPCTestPointXML {

    [cmdletbinding()]

    Param (

        [Parameter(Mandatory=$True)]

        $Data        

    )

    $xmlData = '<testPointList>'

    ForEach ($Obj in $Data) {    

        $Properties = $Obj |  Get-Member -MemberType NoteProperty | Select-Object -ExpandProperty Name

        $xmlData += '<testPoint>'

        foreach ($Property in $Properties) {

            $xmlData += "<$Property>$($Obj.$Property)</$Property>"

        }

        $xmlData += '</testPoint>'

    }

    $xmlData += '</testPointList>'

    Return $xmlData    

}

Function Get-JSONErrorStream {

    <#

        .SYNOPSIS

        Returns the error text of a JSON stream

        .DESCRIPTION

        Returns the error text of a JSON stream

        .PARAMETER JSONResponse

        The error response 

        .EXAMPLE

        Get-JSONErrorStream $_

        Returns the error message from a JSON stream that errored out.

        .NOTES

        Version 1.0

    #>

    Param(

        [Parameter(Mandatory=$true, ValueFromPipeline=$true)]

        $JSONResponse

    )

    $ResponseStream = $JSONResponse.Exception.Response.GetResponseStream()

    $Reader = New-Object System.IO.StreamReader($ResponseStream)

    $ResponseBody = $Reader.ReadToEnd() | ConvertFrom-Json

    Write-Host -ForegroundColor Red -BackgroundColor Black $ResponseBody.errorMessage

    Write-Host

    Write-Host

}

Function New-SAMLInteractive {

    [CmdletBinding()]

    Param(

        [Parameter(Mandatory=$true)]

        [string] $LoginIDP

    )

    Begin{

        $RegEx = '(?i)name="SAMLResponse"(?: type="hidden")? value=\"(.*?)\"(?:.*)?\/>'

        Add-Type -AssemblyName System.Windows.Forms 

        Add-Type -AssemblyName System.Web

    }

    Process{

        # create window for embedded browser

        $form = New-Object Windows.Forms.Form

        $form.StartPosition = [System.Windows.Forms.FormStartPosition]::CenterScreen;

        $form.Width = 640

        $form.Height = 700

        $form.showIcon = $false

        $form.TopMost = $true

        $web = New-Object Windows.Forms.WebBrowser

        $web.Size = $form.ClientSize

        $web.Anchor = "Left,Top,Right,Bottom"

        $web.ScriptErrorsSuppressed = $true

        $form.Controls.Add($web)

        $web.Navigate($LoginIDP)

        $web.add_Navigating({

            If ($web.DocumentText -match "SAMLResponse"){

                $_.cancel = $true

                If ($web.DocumentText -match $RegEx){

                    $form.Close()

                    $Script:SAMLResponse = $(($Matches[1] -replace '&#x2b;', '+') -replace '&#x3d;', '=')

                }

            }

        })

        # show browser window, waits for window to close

        If ([system.windows.forms.application]::run($form) -ne "OK") {

            If ($null -ne $Script:SAMLResponse){

                Write-Output $Script:SAMLResponse

                $form.Close()

                Remove-Variable -Name SAMLResponse -Scope Script -ErrorAction SilentlyContinue

            }

            Else {

                throw "SAMLResponse not matched"

            }

        }

    }

    End{

        $form.Dispose()

    }

}

Function ParseBool {

    [CmdletBinding()]

    param(

        [Parameter(Position=0)]

        [System.String]$inputVal

    )

    switch -regex ($inputVal.Trim()) {

        "^(1|true|yes|on|enabled)$" { Return $True }

        default { Return $False }

    }

}

Function Invoke-RestMethod_ErrorHandling {

    <#

        .SYNOPSIS

        Invoke-RestMethod but with better handling of 4xx errors

        .DESCRIPTION

        The default error output for 4xx errors is a very unhelpful and generic error. This modification returns better error messages

    #>

    [CmdletBinding()]

    Param(

        [Parameter(Mandatory=$true)]

        $Method,

        [Parameter(Mandatory=$true)]

        $URI,

        [Parameter(Mandatory=$true)]

        $Headers,

        [Parameter(Mandatory=$false)]

        $Body,

        [Parameter(Mandatory=$false)]

        $ContentType

    )

    Try {

        $Response = Invoke-RestMethod @PSBoundParameters -ErrorAction Stop

        Return $Response

    } 

    Catch [System.Net.WebException] { 

        # This is the only way to return the content of the response

        $RespStream = $_.Exception.Response.GetResponseStream()

        $Reader = New-Object System.IO.StreamReader($RespStream)

        $RawBody = $Reader.ReadToEnd()

        $StatusCode = [int]$_.Exception.Response.StatusCode

        Try { $RespBody = $RawBody | ConvertFrom-Json } Catch { $RespBody = $Null }

        # Prefer the API's errorMessage. Fall back to the status code and raw body so a failure is never reported as a bare 'ScriptHalted'

        If ($RespBody.errorMessage) {

            Throw $RespBody.errorMessage

        }

        ElseIf ($RespBody.message) {

            Throw "HTTP $StatusCode`: $($RespBody.message)"

        }

        Else {

            Throw "HTTP $StatusCode`: $RawBody"

        }

    }

}

Function Set-NectarAlertEnabledState {

    <#

        .SYNOPSIS

        Enables or disables an alert configuration via its dedicated endpoint

        .DESCRIPTION

        Private helper used by New-NectarAlertConfig and Set-NectarAlertConfig. The alert create/update payloads

        do not reliably carry the enabled state, so it is set through the dedicated enabled endpoint instead.

        .PARAMETER ID

        The ID of the alert configuration

        .PARAMETER AlertType

        The type of alert. Location and user NectarScore alerts (including realtime variants) are supported.

        .PARAMETER Enabled

        $True to enable the alert, $False to disable it

        .PARAMETER TenantName

        The name of the Nectar DXP tenant. Used in multi-tenant configurations.

    #>

    [CmdletBinding()]

    Param (

        [Parameter(Mandatory=$True)]

        [int]$ID,

        [Parameter(Mandatory=$True)]

        [string]$AlertType,

        [Parameter(Mandatory=$True)]

        [bool]$Enabled,

        [Parameter(Mandatory=$False)]

        [string]$TenantName

    )

    $EnabledValue = $Enabled.ToString().ToLower()

    Switch ($AlertType) {

        {$_ -In 'NECTAR_SCORE_ALERT_BY_LOCATION','REALTIME_NECTAR_SCORE_ALERT_BY_LOCATION'} {

            $URI = "https://$Global:NectarCloud/aapi/client/notification/configuration/$ID/enabled?enabled=$EnabledValue&tenant=$TenantName"

        }

        {$_ -In 'NECTAR_SCORE_ALERT_BY_USER','REALTIME_NECTAR_SCORE_ALERT_BY_USER'} {

            $URI = "https://$Global:NectarCloud/aapi/client/notification/uhs/configuration/$ID/enabled?enabled=$EnabledValue&tenant=$TenantName"

        }

        Default {

            Throw "Enabling or disabling alerts of type $AlertType is not supported."

        }

    }

    Write-Verbose $URI

    $Null = Invoke-RestMethod_ErrorHandling -Method PUT -URI $URI -Headers $Global:NectarAuthHeader

}

Function Get-NCXOrgID {

    <#

        .SYNOPSIS

        Resolves a Nectar CX tenant name to its organisation ID

        .DESCRIPTION

        Resolves a Nectar CX tenant name to the numeric organisation ID used throughout the Nectar CX API paths.

        When no tenant name is supplied, the organisation ID selected by Connect-NCXCloud is returned, so commands

        keep working against the currently connected tenant.

        .PARAMETER TenantName

        The name of the Nectar CX tenant to resolve. Defaults to the currently connected tenant.

        .EXAMPLE

        Get-NCXOrgID

        Returns the organisation ID of the currently connected tenant

        .EXAMPLE

        Get-NCXOrgID -TenantName Contoso

        Returns the organisation ID belonging to the Contoso tenant

        .NOTES

        Version 1.0

    #>

    [cmdletbinding()]

    Param (

        [Parameter(Mandatory=$False)]

        [string]$TenantName

    )

    # Fall back to the tenant chosen at connection time when no override was supplied

    If (!$TenantName) {

        If (!$Global:NCXOrgID) {

            Throw "No Nectar CX tenant is selected. Run Connect-NCXCloud -TenantName <name>, or pass -TenantName to this command."

        }

        Return $Global:NCXOrgID

    }

    $TenantList = Get-NCXTenantNames

    $Org = $TenantList | Where-Object {$_.name -eq $TenantName}

    If (!$Org) {

        $TList = ($TenantList.name | Sort-Object) -Join ', '

        Throw "Could not find a tenant with the name $TenantName on https://$Global:NCXCloud. Select one of $TList"

    }

    Write-Verbose "Resolved tenant $TenantName to organisation ID $($Org.id)"

    Return $Org.id

}

# SIG # Begin signature block

# MIIlcwYJKoZIhvcNAQcCoIIlZDCCJWACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAphWL7ZbYmOmGB

# y3KhacW1DNzbOrMnXKCAXRFq2co0PaCCEvMwggXdMIIDxaADAgECAgh7LJvTFoAy

# mTANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx

# EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8G

# A1UEAwwoU1NMLmNvbSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTAe

# Fw0xNjAyMTIxNzM5MzlaFw00MTAyMTIxNzM5MzlaMHwxCzAJBgNVBAYTAlVTMQ4w

# DAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENv

# cnBvcmF0aW9uMTEwLwYDVQQDDChTU0wuY29tIFJvb3QgQ2VydGlmaWNhdGlvbiBB

# dXRob3JpdHkgUlNBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA+Q/d

# oyt9y9Aq/uxnhabnLhu6d+Hj9a+k7PpKXZHEV0drGHdrdvL9k+Q9D8IWngtmw1aU

# nheDhc5W7/IW/QBi9SIJVOhlF05BueBPRpeqG8i4bmJeabFf2yoCfvxsyvNB2O3Q

# 6Pw/YUjtsAMUHRAOSxngu07shmX/NvNeZwILnYZVYf16OO3+4hkAt2+hUGJ1dDyg

# +sglkrRueiLH+B6h47LdkTGrKx0E/6VKBDfphaQzK/3i1lU0fBmkSmjHsqjTt8qh

# k4jrwZe8jPkd2SKEJHTHBD1qqSmTzOu4W+H+XyWqNFjIwSNUnRuYEcM4nH49hmyl

# D0CGfAL0XAJPKMuucZ8POsgz/hElNer8usVgPdl8GNWyqdN1eANyIso6wx/vLOUu

# qfqeLLZRRv2vA9bqYGjqhRY2a4XpHsCz3cQk3IAqgUFtlD7I4MmBQQCeXr9/xQiY

# ohgsQkCz+W84J0tOgPQ9gUfgiHzqHM61dVxRLhwrfxpyKOcAtdF0xtfkn60Hk7ZT

# NTX8N+TD9l0WviFz3pIK+KBjaryWkmo++LxlVZve9Q2JJgT8JRqmJWnLwm3KfOJZ

# X5es6+8uyLzXG1k8K8zyGciTaydjGc/86Sb4ynGbf5P+NGeETpnr/LN4CTNwumam

# du0bc+sapQ3EIhMglFYKTixsTrH9z5wJuqIz7YcCAwEAAaNjMGEwHQYDVR0OBBYE

# FN0ECQei9Xp9UlMSkpXuOIAlDaZZMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgw

# FoAU3QQJB6L1en1SUxKSle44gCUNplkwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3

# DQEBCwUAA4ICAQAgGBGUKfsmnRweHnBh8ZVyk3EkrWiTWI4yrxuzcAP8JSt0hZA9

# eGr0uYullzu1GJG7Hqf5QFuR+VWZrx4R0Fwdp2bjsZQHDDI5puobsHnYHZxwROOK

# 3cT5lR+KOEM/AYWlR6c9RrK85SJo93uc2Cw+CiHILTOsv8WBmTF0wXVxxb6x8CNF

# 9J1r/BljnaO8BMYYCyW7U4kPs4BQ3kXuRH+rlHhkmNP2KN2H2HBldPsOuRPrpw9h

# qTKWzN677WNMGLupQPegVG4giHF1GOp6tDRy4CMnd1y2kOqGJUCr7zMPy5+CvqIg

# +/a1LRrmwoWxdA/7yGUCpFIBR91JIsG/2OtrrH7e7GMzFbcjCI/GD41BWt2OxbmP

# 5UU/eNu60htAsf5xTT/ggaK6XrTsFeCT3QgffuFVmQsh3pOeCvvmo0m9NjD+53ey

# oHWXtS2BiBdlIPfakACfyVLMMso1fPU9D9gr1/UmbMkGNJYW6nBZGjJ5eQu2iH8P

# Ukg9v2zYokQu0U63cljTiROV/kSr+NeLG26cvCygW9VqAK9fN+HV+hALmJyG5yaP

# zvDsbopXC4DjTrLAoGNhkLpVaDd0araS25+hhiK2ZScO7LafQmDkZ8K12kELxNOL

# YRu8+h+RK9dEB166KazZxenvU0ha64DxKFghzbAGVfsnP1OQcKkEHlcnuTCCBnIw

# ggRaoAMCAQICCGQzUdPHOJ8IMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVT

# MQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NM

# IENvcnBvcmF0aW9uMTEwLwYDVQQDDChTU0wuY29tIFJvb3QgQ2VydGlmaWNhdGlv

# biBBdXRob3JpdHkgUlNBMB4XDTE2MDYyNDIwNDQzMFoXDTMxMDYyNDIwNDQzMFow

# eDELMAkGA1UEBhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9u

# MREwDwYDVQQKDAhTU0wgQ29ycDE0MDIGA1UEAwwrU1NMLmNvbSBDb2RlIFNpZ25p

# bmcgSW50ZXJtZWRpYXRlIENBIFJTQSBSMTCCAiIwDQYJKoZIhvcNAQEBBQADggIP

# ADCCAgoCggIBAJ+DE3OqsMZtIcvbi3qHdNBx3I6Xcprku4g0tN2AA8YvRaR0mr8e

# D1Dqnm1485/6USapPZ3RspRXPvs5iRuRK1bvZ8vmC+MOOYzGNfSMPd0l6QGsF0J9

# WBZA3PnVKEQdlWQwYTpk8pfXc0x9eyMCbfN161U9b6otxK++dKxd/mq2/OpceekP

# Q5y1UgUP7z6xsY/QSa2m40IZVD/zLw6hy3z+E/kjOdolHLg+AEo6bzIwN2Qex651

# B9hV0hjJDoq8o1zwfAqnhYHCDq+PmVzTYCW8g1ppHCUTzXL165yAm9wsZ8TdyQmY

# 1XPrxCGj5TKOPi9SmMZgN2SMsm9KVHIYzCeH+s11omMhTLU9ZP0rpptVryZMYLS5

# XP6rQ72t0BNmUB8L0omm/9eABvHDEQIzM2EX91Yfji87aOcV8XdWSimeA9rCKyZh

# MlugVuVJKY02p/XHUqJWAyAvOHiAvfYGrkE0y5RFvZvHiRgfC7r/qa5qQJkT3e9Q

# 3wG68gTW0DHfNDheV1vIOB5W1KxIpu3/+bjBO+3CJL5EYKd3zdU9mFm0Q+qqYH3N

# wuUv8ev11CDVlzRuXQRrBRHS05KMCSdE7U81MUZ+dBkFYuyJ4+ojcJjk0S/UihMY

# RpNl5Vhz00w9J3oiP8P4o1W3+eaHguxFHsVuOnyxTrmraPebY9WRQbypAgMBAAGj

# gfswgfgwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTdBAkHovV6fVJTEpKV

# 7jiAJQ2mWTAwBggrBgEFBQcBAQQkMCIwIAYIKwYBBQUHMAGGFGh0dHA6Ly9vY3Nw

# cy5zc2wuY29tMBEGA1UdIAQKMAgwBgYEVR0gADATBgNVHSUEDDAKBggrBgEFBQcD

# AzA7BgNVHR8ENDAyMDCgLqAshipodHRwOi8vY3Jscy5zc2wuY29tL3NzbC5jb20t

# cnNhLVJvb3RDQS5jcmwwHQYDVR0OBBYEFFTC/hCVAJPNavXnwNfZsku4jwzjMA4G

# A1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEA9Q8mh3CvmaLK9dbJ8I1m

# PTmC04gj2IK/j1SEJ7bTgwfXnieJTYSOVNEg7mBD21dCPMewlfa+zOqjPY5PBsYr

# WYZ/63MbyuVAJuA9b8z2vXHGzX0OIEA51gXSr5QIv3/CUbcrtXuDIfBj2uWc4Wku

# dR1Oy2Ee9aUz3wKdFdntaZNXukZFLoC8Zb7nEj7eR/+QnBCt9laypNT61vwuvJch

# s3aD0pH6BlDRsYAogP7brQ9n7fh93NlwW3q6aLWzSmYXj+fw51fdaf68XuHVjJ8T

# u5WaFft5K4XVbT5nR24bB1z7VEUPFhEuEcOwvLVuHDNXlB7+QjRGjjFQTtszV5X6

# OOTmEturWC5Ft9kiyvRaR0ksKOhPjEI8ZGjp5kOsGZGpxxOCX/xxCje3nVB7PF33

# olKCNeS159MKb2v+jfmk19UdS+d9Ygj42desmUnbtYRBFC72LmCXU0ua/vGIenS6

# nnXp4NqnycwsO3tMCnjPlPc2YLaDPIpUy04NaCqUEXUmFOogN8zreRd2VXhxbeJJ

# ODM32+RsWccjYua8zi5US/1eAyrI3R5LcUTQdT4xYmWLKabtJOF6HYQ0f6QXfLSs

# fT81WMvDvxrdn1RWbUXlU/OIiisxo8o+UNEANOwnCMNnxlzoaL/PLhZluDxm/zuy

# lauajZ3MlPDteFB/7GRHo50wggaYMIIEgKADAgECAhBHaHS/7B9x7N3XWwMIISW7

# MA0GCSqGSIb3DQEBCwUAMHgxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQ

# MA4GA1UEBwwHSG91c3RvbjERMA8GA1UECgwIU1NMIENvcnAxNDAyBgNVBAMMK1NT

# TC5jb20gQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBDQSBSU0EgUjEwHhcNMjYw

# NzA5MTQzMTE4WhcNMjcxMDEwMTQzMTE4WjB/MQswCQYDVQQGEwJVUzERMA8GA1UE

# CAwITmV3IFlvcmsxEDAOBgNVBAcMB0plcmljaG8xHjAcBgNVBAoMFU5lY3RhciBT

# ZXJ2aWNlcyBDb3JwLjELMAkGA1UECwwCSVQxHjAcBgNVBAMMFU5lY3RhciBTZXJ2

# aWNlcyBDb3JwLjCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBAJmOMPRo

# al1bEwe/HPHB533mkxLFf2LGg8R3yZQfDMkVWS0ME52aHJT33z61eMLqFamuvqY7

# qeb6jcOjqenYUhNmFcnl1Oq2hFWWE7McdgYAc0boWHemqxHWrUXN53sCp1DFVTh3

# NFwTo2PaY/KLdIjsXXvmA9qQBytzxEmeaF5HyCmmTlQ/N4eDeqpMOAbQn1n7lLi7

# xiHq1UAll3uvB+y7Vq/3V/dCO33/aiQif1t6h2R+N2JhoW0vtvd+yMyY58klGfN6

# O9WHto+MAiGoyP8rs9XWAzhIRZ2JjwFjfTqQOxVv0lUH+ZolhJ9uQHvybL3wHwLN

# Qu8szoII3tqksiosdPc4Xk1nSyzrBfETafVVpey19HD6RhSIHrnPPHwWOzrdsT9j

# O9szScE3i+cfJcKiL98lJkhFq/ZGOIwAPgxPvZZQZqbzEcsR0iddA+KNLxKqzkv9

# 1GtETHdFoU07xY7+2NsY1xhs9jFFNhoeCVh+dk3lIBvpWkuMwM8mZKziUQIDAQAB

# o4IBlTCCAZEwDAYDVR0TAQH/BAIwADAfBgNVHSMEGDAWgBRUwv4QlQCTzWr158DX

# 2bJLuI8M4zB6BggrBgEFBQcBAQRuMGwwSAYIKwYBBQUHMAKGPGh0dHA6Ly9jZXJ0

# LnNzbC5jb20vU1NMY29tLVN1YkNBLUNvZGVTaWduaW5nLVJTQS00MDk2LVIxLmNl

# cjAgBggrBgEFBQcwAYYUaHR0cDovL29jc3BzLnNzbC5jb20wUQYDVR0gBEowSDAI

# BgZngQwBBAEwPAYMKwYBBAGCqTABAwMBMCwwKgYIKwYBBQUHAgEWHmh0dHBzOi8v

# d3d3LnNzbC5jb20vcmVwb3NpdG9yeTATBgNVHSUEDDAKBggrBgEFBQcDAzBNBgNV

# HR8ERjBEMEKgQKA+hjxodHRwOi8vY3Jscy5zc2wuY29tL1NTTGNvbS1TdWJDQS1D

# b2RlU2lnbmluZy1SU0EtNDA5Ni1SMS5jcmwwHQYDVR0OBBYEFB7iZgW8t2SQ3I8n

# dKd+fgqBvDYxMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAhCFC

# ydfNbwEfqJhrp612HM4Qh7JUphMm5ZLNomSEsonhjz1ltmMpB/0nGVH9Ond23hac

# 12+xzfnDAB2HsNhA9vVWYbgbxcH1duQbdRatjrtWKd1+YOfsvAS+O652yRQf26OL

# +2efdAnzaqsTYFoEJwFcgl1M5Uo+uSht961Jm7McHouRm/zYOnC+NjvGOgIL40KN

# P1pLQTxK5zc54+yFQANjiCPNI07AnkYCSgHDJCoKZbJTcUk26kQNqNE9AvjsIlpY

# uY8sTXHSIkN3WNuSPYr66GHaYj9m0AGUKGt/ZZePKmOsLu+nON5hwqXx+QX75yc2

# AIlKw/ItfZvBLeRuejoKnbOh6QiyDxn0lfAH8f/upDPCUfvBVADF56itElnCo+fC

# 36rzFnfBaVPbLVzqlAGSs7e6Yn669snsTHkKQm1fALEiZyt3dqOvppr8AO1f+oCc

# r/0jVezz0VyNUemChoAMBosREctn/fOYfL5NClq/mnI5m+tAHOajVk8LI6h7mlNv

# tIFKwfHCIH2EJM4ze+ZrSXWt8bfY+6pQwd4xCB9UmCw2DBBMQ11rvu1rLD+u3kIL

# NBAXHQGEnCoP+sY6h17wc/2Jb8BPg+yAvPXevqXmAdAKJrhvMmgsbttRxOQuVjrq

# 42h1me0i3Jy0obhODmpXsrVPm02ZBIYgiRcK/q8xghHWMIIR0gIBATCBjDB4MQsw

# CQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0b24xETAP

# BgNVBAoMCFNTTCBDb3JwMTQwMgYDVQQDDCtTU0wuY29tIENvZGUgU2lnbmluZyBJ

# bnRlcm1lZGlhdGUgQ0EgUlNBIFIxAhBHaHS/7B9x7N3XWwMIISW7MA0GCWCGSAFl

# AwQCAQUAoHwwEAYKKwYBBAGCNwIBDDECMAAwGQYJKoZIhvcNAQkDMQwGCisGAQQB

# gjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkE

# MSIEIEyyGG+xlmwaFJiBcywMnFgcaG5CngAv8C/zPeTBoBIHMA0GCSqGSIb3DQEB

# CwUABIIBgIk6ivNVbnsiWe7ToL+BsdMnL8w6/NZQD1C9tYKpaw2cYsAqVAFUHT6D

# j7nZ1/yBk1js5k0hlz3TTxq2hqc+0fI9u8V5flnCeK4PRPE8VLAVy/bNHhnGZP7y

# 0vNFaRSJVAXiArTqpDRdaKlrnvOZRV/uRXquGA+0/DzLaYIZF86OtX1eW3UZmpwt

# 8sjVSK8cIrK1zKaOyQeFN387e9jn5CVvHdyL1o/9T4V7QoVerkvOd8MkKnKxItBh

# Y6pcN0jkT0FhEuD57SQ4PbXGKWjmXHRFa0aTN887b2HD5HHhvZ8QvpiudHgEkehk

# detlcaUroX9AipqoLnNwDEZvGzSBQvs4in4IjDOeTCKhW41639k4QQLRAtG/JOLJ

# VfOX9EzuZDhWuccJUgjx7o8A6xxYgyJvwLpgvIE5yKxx4xCrc5iVa5BifdjMtoFn

# fY62VfYIO8fF0AF3VfdDw4dmaXUdhSwLVupu4Q0EMRF1m2hrUZRwdq1krdWDUTQu

# ZvPbPWgP2qGCDxwwgg8YBgorBgEEAYI3AwMBMYIPCDCCDwQGCSqGSIb3DQEHAqCC

# DvUwgg7xAgEDMQ0wCwYJYIZIAWUDBAIBMH0GCyqGSIb3DQEJEAEEoG4EbDBqAgEB

# BgwrBgEEAYKpMAEDBgEwLzALBglghkgBZQMEAgEEIJYCksdfmn03ojRAiQArRTFw

# yQFztPYxROzC4GKCuptOAggW+SaDf6KYChgPMjAyNjA5MTUxNzI3MzhaMAMCAQEC

# BgGgphwnaaCCDAAwggT8MIIC5KADAgECAhAfaxZi0i4bbF3xwMGgYA44MA0GCSqG

# SIb3DQEBCwUAMHMxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UE

# BwwHSG91c3RvbjERMA8GA1UECgwIU1NMIENvcnAxLzAtBgNVBAMMJlNTTC5jb20g

# VGltZXN0YW1waW5nIElzc3VpbmcgUlNBIENBIFIxMB4XDTI1MDIxODE2MzIwMloX

# DTM0MTExMjE4NTAwNVowbjELMAkGA1UEBhMCVVMxDjAMBgNVBAgMBVRleGFzMRAw

# DgYDVQQHDAdIb3VzdG9uMREwDwYDVQQKDAhTU0wgQ29ycDEqMCgGA1UEAwwhU1NM

# LmNvbSBUaW1lc3RhbXBpbmcgVW5pdCAyMDI1IEUxMFkwEwYHKoZIzj0CAQYIKoZI

# zj0DAQcDQgAEG/tRUcdv5lWW7E9eV8Tczq2DReerx2Jz47e884JGlqVQzW870D4Z

# HNJVWPLKAeFisHDrZcsWHWS/t77JF39pNqOCAVowggFWMB8GA1UdIwQYMBaAFAyd

# ECWOmqcbmYdDzwh+4b2BkPTPMFEGCCsGAQUFBwEBBEUwQzBBBggrBgEFBQcwAoY1

# aHR0cDovL2NlcnQuc3NsLmNvbS9TU0wuY29tLXRpbWVTdGFtcGluZy1JLVJTQS1S

# MS5jZXIwUQYDVR0gBEowSDA8BgwrBgEEAYKpMAEDBgEwLDAqBggrBgEFBQcCARYe

# aHR0cHM6Ly93d3cuc3NsLmNvbS9yZXBvc2l0b3J5MAgGBmeBDAEEAjAWBgNVHSUB

# Af8EDDAKBggrBgEFBQcDCDBGBgNVHR8EPzA9MDugOaA3hjVodHRwOi8vY3Jscy5z

# c2wuY29tL1NTTC5jb20tdGltZVN0YW1waW5nLUktUlNBLVIxLmNybDAdBgNVHQ4E

# FgQUznzZwASAxSQQagnqHKslPRH9qNIwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3

# DQEBCwUAA4ICAQCAc3Ukhb1mU2KnTsV9j2vUsnAspOXWH/L2vUGMOAcwTPtTsnuY

# DLfYnEDUovKMIImo2S5F+EMcYUR9m2NM6u7sBAwNIOJQO8IJzeNrPmnL2Ma/Ah7m

# emQttepeED5KoLMbvX1RKKDCEeRivu/w2JehpjRe7TenQGJlmt5mWmeCYYH37zo3

# 3gWogXHYjlnmK67t3iPtoA5kE3F9T2MUMggYO1Z9Z4KkXRDyssT/cMcOXMkqzkiX

# eL9Wg6XutNT3fyhKvEzDDDoYMGUpfysYfG+SOAhv0xeRWCUlIMew0BkN4JL+KdrE

# ocD4KG4Hwrg7EjFrqTV754cHKlqQBjfC43vDs+U+aE3qTkh2pmfcdkezZWOhHzjV

# n3CZU8V0YN2QFntc6Zvk5lRoq5+y+0RHRVtjYOTNqoBoi23WRz4j4VTPs+JXPY9T

# Ol6CR+1FHG+s/IgvTxuUlOdsxDReuoM3SsR+5Mu/heGGcrIlpeHEJR2M79xG6YzN

# nflBNQwi0FbLXEanSLKgVWcDJrak+xUy4Aj6zLXPGU5L2XmJLG8onyCmek6COphN

# ru7V7Jmj7gmVwaiKJHXsu2ExOsXWrra07nE6kjy3FRnqC0oa2QlXrB2P69ktzApn

# Yz3capWk6jpQGUaPHWwqxVnsAhTMlmWLg0nQzYphyt82eV5uRgqkOdKpbDCCBvww

# ggTkoAMCAQICEG1SGHCH6CNNhWAA0ICPk1YwDQYJKoZIhvcNAQELBQAwfDELMAkG

# A1UEBhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYD

# VQQKDA9TU0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0

# aWZpY2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTkxMTEzMTg1MDA1WhcNMzQxMTEy

# MTg1MDA1WjBzMQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcM

# B0hvdXN0b24xETAPBgNVBAoMCFNTTCBDb3JwMS8wLQYDVQQDDCZTU0wuY29tIFRp

# bWVzdGFtcGluZyBJc3N1aW5nIFJTQSBDQSBSMTCCAiIwDQYJKoZIhvcNAQEBBQAD

# ggIPADCCAgoCggIBAK5REBPS+TwgoCCF3slQHGTJ4f3F6TT/Cn8xSOhyWsVeqGH9

# 8Yf3UVz7t+bQwcITsD7CY6KoGP04OskBgareubfeMKcdKwIE1YBBjKhq4urwiOqx

# LUmVcvb2oM0wx3BnxQ3NBLu9ZkwMnjQlIY2mEwZMgDaqfZuiEa2BFzinXf3kRLKl

# Q5oa8ne3QU0vcG4qZvphy0xxBQXayqigzN3z2HQTq6N28EOjpnA2dajGPtiZ9aNJ

# eDfcDka5j3KbhBkzk4RWCjx5vP8H6DKHIIs02GHgxv/jG8JMIxWY1isG+IaB09li

# vKbxlvzhNAKZK5fQmUstrpYrVo7qqXAhJtv1tUaHzrp6QpuUL9dE/bSAC7UKO9xh

# yJSA1OsYWDx/wAmBA84JzX8IJ1olJjCEmlJ2F4o6dCARKA2Zhk+EU4LogpowBReT

# lTW2NNwUKAW+8Cte0rhrMBZQ47Vjd92V0gEvouOTMtQJgk2QVeqGwFVw8y4HSdQN

# a8sl8+Kay2MnyUXhLoQLFaeVaLs4SVXBOe3Ua1Gp5j3J2+8Yue1T4V5wrsNuocNR

# 3frpSt4yRIG3N68Bz1qqhk+eNUyO8WpXWlg6POZOJUdm0BzzRsB8V7kst8nM8joO

# e03KqhunBN69Ckeo8M32qo07zeveRrDwD2P4dmJLDYBflwZ1A/SQbS+HN+AHAgMB

# AAGjggGBMIIBfTASBgNVHRMBAf8ECDAGAQH/AgEAMB8GA1UdIwQYMBaAFN0ECQei

# 9Xp9UlMSkpXuOIAlDaZZMIGDBggrBgEFBQcBAQR3MHUwUQYIKwYBBQUHMAKGRWh0

# dHA6Ly93d3cuc3NsLmNvbS9yZXBvc2l0b3J5L1NTTGNvbVJvb3RDZXJ0aWZpY2F0

# aW9uQXV0aG9yaXR5UlNBLmNydDAgBggrBgEFBQcwAYYUaHR0cDovL29jc3BzLnNz

# bC5jb20wPwYDVR0gBDgwNjA0BgRVHSAAMCwwKgYIKwYBBQUHAgEWHmh0dHBzOi8v

# d3d3LnNzbC5jb20vcmVwb3NpdG9yeTATBgNVHSUEDDAKBggrBgEFBQcDCDA7BgNV

# HR8ENDAyMDCgLqAshipodHRwOi8vY3Jscy5zc2wuY29tL3NzbC5jb20tcnNhLVJv

# b3RDQS5jcmwwHQYDVR0OBBYEFAydECWOmqcbmYdDzwh+4b2BkPTPMA4GA1UdDwEB

# /wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAkhl1DaZaQs8ZB9ny/JT6wJvwFelE

# llovcTPdUOUTe5mTdw/E+3JtV8u6ppyLRbpIHbYlMy20KJAychU6xdaci4BsP9oV

# NxSRMsEjfHKz7ARqPNdpclhYAINLjsFGMO1iUNbXiAsnF/xboNCgfeMcMYbLyQYk

# U6UMobv9isrtQZ8e0EAQNV7qXJn4W0KyuTt0P8iIv/5DdDpIUBIktDZcjz2KEW6B

# 1gvvsKIM1esjYwWylAazBcQAake5pANMdSn8t1HdPKsiwuWfOguyRQazAX8oXz6S

# lZSIok0Lis9a02vGVtdhEaB0R3HxIyNRMMKWV1yuSeUXFuoexWav3GRPZC0WYb50

# SrW/l+wgrS8doetaMwyZon2L7ioYlIPSy1h9Dq/Q911PsSkbEZ3zrsB1roVnIfBu

# 5BJp0xvQrQ/Q4LavuvCoFR7QFoypNrotbNYi2AGMZw5td4zGZtCqUTPZi0BwSuRm

# +HRYAEMMThTwbJX/fYV1oC8mBN970yIvadIGKhh7+DmYdRJYBrL8inVFCZAK+YX2

# w1+qWEnCSPL/VTWJtSRMhQFfceDKbJC+pBNksvKzqkva0J1ZyMj1i4vDfSuBmbz4

# rfzsvvJxS+quZDdkmW6MeXevWGBXvqzdbAw+AqTVsAQUyP6tFeKZIL4S/fSFdl2r

# Ix2X+KXkqx3S+EYxggJYMIICVAIBATCBhzBzMQswCQYDVQQGEwJVUzEOMAwGA1UE

# CAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0b24xETAPBgNVBAoMCFNTTCBDb3JwMS8w

# LQYDVQQDDCZTU0wuY29tIFRpbWVzdGFtcGluZyBJc3N1aW5nIFJTQSBDQSBSMQIQ

# H2sWYtIuG2xd8cDBoGAOODALBglghkgBZQMEAgGgggFhMBoGCSqGSIb3DQEJAzEN

# BgsqhkiG9w0BCRABBDAcBgkqhkiG9w0BCQUxDxcNMjYwOTE1MTcyNzM4WjAoBgkq

# hkiG9w0BCTQxGzAZMAsGCWCGSAFlAwQCAaEKBggqhkjOPQQDAjAvBgkqhkiG9w0B

# CQQxIgQgVs6banHuDRCj77bHQJZPxjRixJga8yVedmdEU8vMoMMwgckGCyqGSIb3

# DQEJEAIvMYG5MIG2MIGzMIGwBCBUKvmhao1yLmYRSXiK6ZTBipqu5aZcs0SiVJr5

# bHnHizCBizB3pHUwczELMAkGA1UEBhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYD

# VQQHDAdIb3VzdG9uMREwDwYDVQQKDAhTU0wgQ29ycDEvMC0GA1UEAwwmU1NMLmNv

# bSBUaW1lc3RhbXBpbmcgSXNzdWluZyBSU0EgQ0EgUjECEB9rFmLSLhtsXfHAwaBg

# DjgwCgYIKoZIzj0EAwIERzBFAiBf4UMbrOBOuEMU8SMEuUVUmh+W8L982YvCC7CA

# FWSvlwIhAN5/7es2wqoWSyg7+35CIxmu6XAvZsPQ0U4aj+u+TyUT

# SIG # End signature block