EPM/Approval.ps1

$script:StatusApproved = ([KeeperSecurity.Plugins.EPM.EpmApprovalStatus]::Approved).ToString().ToUpperInvariant()
$script:StatusDenied   = ([KeeperSecurity.Plugins.EPM.EpmApprovalStatus]::Denied).ToString().ToUpperInvariant()
$script:StatusExpired  = ([KeeperSecurity.Plugins.EPM.EpmApprovalStatus]::Expired).ToString().ToUpperInvariant()

function script:ConvertFrom-KeeperEpmApprovalField {
    Param ([byte[]] $FieldData)
    if ($null -eq $FieldData -or $FieldData.Length -eq 0) { return '' }
    try {
        $text = [System.Text.Encoding]::UTF8.GetString($FieldData)
        $nonPrintable = 0
        foreach ($ch in $text.ToCharArray()) {
            if ([char]::IsControl($ch) -and $ch -ne "`n" -and $ch -ne "`r" -and $ch -ne "`t") { $nonPrintable++ }
        }
        $ratio = if ($text.Length -gt 0) { ($nonPrintable * 100.0 / $text.Length) } else { 100 }
        if ($ratio -lt 10) {
            try {
                $json = $text | ConvertFrom-Json -ErrorAction Stop
                if ($null -ne $json) {
                    $properties = @($json.PSObject.Properties)
                    if ($properties.Count -gt 0) {
                        $take = [Math]::Min(3, $properties.Count)
                        $parts = [System.Collections.Generic.List[string]]::new()
                        for ($i = 0; $i -lt $take; $i++) {
                            $property = $properties[$i]
                            $parts.Add("$($property.Name): $($property.Value)")
                        }
                        $result = $parts -join ', '
                        if ($properties.Count -gt 3) { $result += '...' }
                        return $result
                    }
                }
            }
            catch { }
            if ($text.Length -gt 50) { return $text.Substring(0, 47) + '...' }
            return $text
        }
    }
    catch { }
    return "(encrypted, $($FieldData.Length) bytes)"
}

function script:ConvertFrom-KeeperEpmTimestamp {
    Param ([long] $Timestamp)
    if ($Timestamp -le 0) { return [DateTimeOffset]::MinValue }
    return [DateTimeOffset]::FromUnixTimeMilliseconds($Timestamp)
}

function script:Get-KeeperEpmApprovalStatusInt {
    Param (
        [Parameter(Mandatory = $true)] $Plugin,
        [string] $ApprovalUid
    )
    if ([string]::IsNullOrEmpty($ApprovalUid)) { return 0 }
    try {
        $s = $Plugin.GetApprovalStatus($ApprovalUid)
        if ($null -eq $s) { return 0 }
        return [int]$s
    }
    catch {
        return 0
    }
}

function script:Get-KeeperEpmApprovalStatusDisplay {
    Param (
        [Parameter(Mandatory = $true)] $Plugin,
        [string] $ApprovalUid
    )
    $statusInt = Get-KeeperEpmApprovalStatusInt -Plugin $Plugin -ApprovalUid $ApprovalUid
    $enumType = [KeeperSecurity.Plugins.EPM.EpmApprovalStatus]
    if ([System.Enum]::IsDefined($enumType, $statusInt)) {
        return ([KeeperSecurity.Plugins.EPM.EpmApprovalStatus]$statusInt).ToString().ToUpperInvariant()
    }
    return 'UNKNOWN'
}

function script:Get-KeeperEpmApprovalTypeName {
    Param ([int] $ApprovalType)
    $enumType = [KeeperSecurity.Plugins.EPM.EpmApprovalType]
    if ([System.Enum]::IsDefined($enumType, $ApprovalType)) {
        return ([KeeperSecurity.Plugins.EPM.EpmApprovalType]$ApprovalType).ToString()
    }
    return 'Other'
}

function Get-KeeperEpmApprovalList {
    <#
    .Synopsis
        List EPM/PEDM approval requests.
    .Parameter Type
        Filter by approval status: approved, denied, pending, expired, escalated. If omitted, lists all approvals.
    #>

    [CmdletBinding()]
    Param (
        [Parameter()]
        [ValidateSet('approved', 'denied', 'pending', 'expired', 'escalated')]
        [string] $Type
    )

    $plugin = ensureEpmPlugin
    if (-not $plugin) {
        Write-Error -Message "EPM plugin is not available. Enterprise admin access is required." -ErrorAction Stop
    }

    $approvals = @($plugin.Approvals.GetAll())

    $rows = foreach ($appr in ($approvals | Sort-Object -Property ApprovalUid)) {
        $status = Get-KeeperEpmApprovalStatusDisplay -Plugin $plugin -ApprovalUid $appr.ApprovalUid
        [PSCustomObject]@{
            'Approval UID'     = $appr.ApprovalUid
            'Approval Type'    = Get-KeeperEpmApprovalTypeName -ApprovalType $appr.ApprovalType
            'Status'           = $status
            'Agent UID'        = if ($appr.AgentUid) { $appr.AgentUid } else { '' }
            'Account Info'     = ConvertFrom-KeeperEpmApprovalField -FieldData $appr.AccountInfo
            'Application Info' = ConvertFrom-KeeperEpmApprovalField -FieldData $appr.ApplicationInfo
            'Justification'    = ConvertFrom-KeeperEpmApprovalField -FieldData $appr.Justification
            'Expire In'        = if ($appr.ExpireIn -gt 0) { $appr.ExpireIn } else { '' }
            'Created'          = (ConvertFrom-KeeperEpmTimestamp -Timestamp $appr.Created).ToString('yyyy-MM-dd HH:mm:ss')
        }
    }

    if (-not [string]::IsNullOrEmpty($Type)) {
        $filterType = $Type.ToUpperInvariant()
        $rows = @($rows | Where-Object { $_.'Status' -eq $filterType })
    }

    if ($rows.Count -eq 0) {
        if (-not [string]::IsNullOrEmpty($Type)) { Write-Output "No $Type approvals found." }
        else { Write-Output 'No approvals found.' }
        return
    }

     $rows | Format-Table -AutoSize
}

function Get-KeeperEpmApproval {
    <#
    .Synopsis
        View a single EPM approval by UID.
    .Parameter ApprovalUid
        The approval record UID.
    #>

    [CmdletBinding()]
    Param (
        [Parameter(Mandatory = $true, Position = 0)]
        [string] $ApprovalUid
    )

    $plugin = ensureEpmPlugin
    if (-not $plugin) {
        Write-Error -Message "EPM plugin is not available. Enterprise admin access is required." -ErrorAction Stop
    }

    $approval = $plugin.Approvals.GetEntity($ApprovalUid)
    if (-not $approval) {
        Write-Error -Message "Approval '$ApprovalUid' not found." -ErrorAction Stop
    }

    $status = Get-KeeperEpmApprovalStatusDisplay -Plugin $plugin -ApprovalUid $ApprovalUid
    $typeName = Get-KeeperEpmApprovalTypeName -ApprovalType $approval.ApprovalType
    Write-Output "Approval: $ApprovalUid"
    Write-Output " Type: $typeName"
    Write-Output " Status: $status"
    Write-Output " Agent UID: $(if ($approval.AgentUid) { $approval.AgentUid } else { '' })"
    Write-Output " Account Info: $(ConvertFrom-KeeperEpmApprovalField -FieldData $approval.AccountInfo)"
    Write-Output " Application Info: $(ConvertFrom-KeeperEpmApprovalField -FieldData $approval.ApplicationInfo)"
    Write-Output " Justification: $(ConvertFrom-KeeperEpmApprovalField -FieldData $approval.Justification)"
    if ($approval.ExpireIn -gt 0) { Write-Output " Expire In: $($approval.ExpireIn)" }
    else { Write-Output ' Expire In: N/A' }
    Write-Output " Created: $((ConvertFrom-KeeperEpmTimestamp -Timestamp $approval.Created).ToString('yyyy-MM-dd HH:mm:ss'))"
}

function Approve-KeeperEpmApproval {
    <#
    .Synopsis
        Approve a pending EPM approval.
    .Parameter ApprovalUid
        The approval record UID.
    #>

    [CmdletBinding()]
    Param (
        [Parameter(Mandatory = $true, Position = 0)]
        [string] $ApprovalUid
    )

    $plugin = ensureEpmPlugin
    if (-not $plugin) {
        Write-Error -Message "EPM plugin is not available. Enterprise admin access is required." -ErrorAction Stop
    }

    $approval = $plugin.Approvals.GetEntity($ApprovalUid)
    if (-not $approval) {
        Write-Error -Message "Approval '$ApprovalUid' not found." -ErrorAction Stop
    }

    $currentStatus = Get-KeeperEpmApprovalStatusDisplay -Plugin $plugin -ApprovalUid $ApprovalUid
    if ($currentStatus -eq $script:StatusApproved) {
        Write-Error -Message "Approval '$ApprovalUid' is already $($script:StatusApproved). Cannot approve again." -ErrorAction Stop
    }
    if ($currentStatus -eq $script:StatusDenied) {
        Write-Error -Message "Approval '$ApprovalUid' is already $($script:StatusDenied). Cannot approve a denied request." -ErrorAction Stop
    }
    if ($currentStatus -eq $script:StatusExpired) {
        Write-Error -Message "Approval '$ApprovalUid' is $($script:StatusExpired). Cannot approve an expired request." -ErrorAction Stop
    }

    try {
        $approveStatus = $plugin.ModifyApprovals([string[]]@($ApprovalUid), $null, $null).GetAwaiter().GetResult()

        if ($approveStatus.AddErrors -and $approveStatus.AddErrors.Count -gt 0) {
            $err = $approveStatus.AddErrors[0]
            Write-Error -Message "Failed to approve `"$($err.EntityUid)`": $($err.Message)" -ErrorAction Stop
        }
        if ($approveStatus.UpdateErrors -and $approveStatus.UpdateErrors.Count -gt 0) {
            $err = $approveStatus.UpdateErrors[0]
            Write-Error -Message "Failed to approve `"$($err.EntityUid)`": $($err.Message)" -ErrorAction Stop
        }
        Write-Output "Approval '$ApprovalUid' approved."
        writeEpmModifyStatus -Status $approveStatus
        $plugin.SyncDown($false).GetAwaiter().GetResult() | Out-Null
    } catch {
        Write-Error -Message "Error approving approval: $($_.Exception.Message)" -ErrorAction Stop
    }
}

function Deny-KeeperEpmApproval {
    <#
    .Synopsis
        Deny a pending EPM approval.
    .Parameter ApprovalUid
        The approval record UID.
    #>

    [CmdletBinding()]
    Param (
        [Parameter(Mandatory = $true, Position = 0)]
        [string] $ApprovalUid
    )

    $plugin = ensureEpmPlugin
    if (-not $plugin) {
        Write-Error -Message "EPM plugin is not available. Enterprise admin access is required." -ErrorAction Stop
    }

    $approval = $plugin.Approvals.GetEntity($ApprovalUid)
    if (-not $approval) {
        Write-Error -Message "Approval '$ApprovalUid' not found." -ErrorAction Stop
    }

    $currentStatus = Get-KeeperEpmApprovalStatusDisplay -Plugin $plugin -ApprovalUid $ApprovalUid
    if ($currentStatus -eq $script:StatusDenied) {
        Write-Error -Message "Approval '$ApprovalUid' is already $($script:StatusDenied). Cannot deny again." -ErrorAction Stop
    }
    if ($currentStatus -eq $script:StatusApproved) {
        Write-Error -Message "Approval '$ApprovalUid' is already $($script:StatusApproved). Cannot deny an approved request." -ErrorAction Stop
    }
    if ($currentStatus -eq $script:StatusExpired) {
        Write-Error -Message "Approval '$ApprovalUid' is $($script:StatusExpired). Cannot deny an expired request." -ErrorAction Stop
    }

    try {
        $denyStatus = $plugin.ModifyApprovals($null, [string[]]@($ApprovalUid), $null).GetAwaiter().GetResult()

        if ($denyStatus.AddErrors -and $denyStatus.AddErrors.Count -gt 0) {
            $err = $denyStatus.AddErrors[0]
            Write-Error -Message "Failed to deny `"$($err.EntityUid)`": $($err.Message)" -ErrorAction Stop
        }
        if ($denyStatus.UpdateErrors -and $denyStatus.UpdateErrors.Count -gt 0) {
            $err = $denyStatus.UpdateErrors[0]
            Write-Error -Message "Failed to deny `"$($err.EntityUid)`": $($err.Message)" -ErrorAction Stop
        }
        Write-Output "Approval '$ApprovalUid' denied."
        writeEpmModifyStatus -Status $denyStatus
        $plugin.SyncDown($false).GetAwaiter().GetResult() | Out-Null
    } catch {
        Write-Error -Message "Error denying approval: $($_.Exception.Message)" -ErrorAction Stop
    }
}

function Remove-KeeperEpmApproval {
    <#
    .Synopsis
        Remove an EPM approval record.
    .Parameter ApprovalUid
        The approval record UID.
    .Parameter Force
        If set, skip confirmation prompt before delete.
    #>

    [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')]
    Param (
        [Parameter(Mandatory = $true, Position = 0)]
        [string] $ApprovalUid,
        [Parameter()]
        [switch] $Force
    )

    $plugin = ensureEpmPlugin
    if (-not $plugin) {
        Write-Error -Message "EPM plugin is not available. Enterprise admin access is required." -ErrorAction Stop
    }

    $approval = $plugin.Approvals.GetEntity($ApprovalUid)
    if (-not $approval) {
        Write-Error -Message "Approval '$ApprovalUid' not found." -ErrorAction Stop
    }

    if (-not $Force -and -not $PSCmdlet.ShouldProcess("approval '$ApprovalUid'", "Remove")) {
        return
    }

    try {
        $removeStatus = $plugin.ModifyApprovals($null, $null, [string[]]@($ApprovalUid)).GetAwaiter().GetResult()

        if ($removeStatus.RemoveErrors -and $removeStatus.RemoveErrors.Count -gt 0) {
            $err = $removeStatus.RemoveErrors[0]
            Write-Error -Message "Failed to remove approval `"$($err.EntityUid)`": $($err.Message)" -ErrorAction Stop
        }
        if ($removeStatus.Remove -and $removeStatus.Remove.Count -gt 0) {
            Write-Output "Approval '$ApprovalUid' removed."
        } else {
            Write-Warning "Approval '$ApprovalUid' may not have been removed. Check server response."
        }
        writeEpmModifyStatus -Status $removeStatus
        $plugin.SyncDown($false).GetAwaiter().GetResult() | Out-Null
    } catch {
        Write-Error -Message "Error removing approval: $($_.Exception.Message)" -ErrorAction Stop
    }
}

New-Alias -Name kepm-approval-list   -Value Get-KeeperEpmApprovalList   -ErrorAction SilentlyContinue
New-Alias -Name kepm-approval-view    -Value Get-KeeperEpmApproval       -ErrorAction SilentlyContinue
New-Alias -Name kepm-approval-approve -Value Approve-KeeperEpmApproval -ErrorAction SilentlyContinue
New-Alias -Name kepm-approval-deny    -Value Deny-KeeperEpmApproval    -ErrorAction SilentlyContinue
New-Alias -Name kepm-approval-remove  -Value Remove-KeeperEpmApproval  -ErrorAction SilentlyContinue

# SIG # Begin signature block
# MIInvgYJKoZIhvcNAQcCoIInrzCCJ6sCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAUb3j5ZbvB2og1
# 5ppz03MRa1V8/hoZU4JHPo1B7dWvh6CCITswggWNMIIEdaADAgECAhAOmxiO+dAt
# 5+/bUOIIQBhaMA0GCSqGSIb3DQEBDAUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQK
# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNV
# BAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0yMjA4MDEwMDAwMDBa
# Fw0zMTExMDkyMzU5NTlaMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2Vy
# dCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lD
# ZXJ0IFRydXN0ZWQgUm9vdCBHNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC
# ggIBAL/mkHNo3rvkXUo8MCIwaTPswqclLskhPfKK2FnC4SmnPVirdprNrnsbhA3E
# MB/zG6Q4FutWxpdtHauyefLKEdLkX9YFPFIPUh/GnhWlfr6fqVcWWVVyr2iTcMKy
# unWZanMylNEQRBAu34LzB4TmdDttceItDBvuINXJIB1jKS3O7F5OyJP4IWGbNOsF
# xl7sWxq868nPzaw0QF+xembud8hIqGZXV59UWI4MK7dPpzDZVu7Ke13jrclPXuU1
# 5zHL2pNe3I6PgNq2kZhAkHnDeMe2scS1ahg4AxCN2NQ3pC4FfYj1gj4QkXCrVYJB
# MtfbBHMqbpEBfCFM1LyuGwN1XXhm2ToxRJozQL8I11pJpMLmqaBn3aQnvKFPObUR
# WBf3JFxGj2T3wWmIdph2PVldQnaHiZdpekjw4KISG2aadMreSx7nDmOu5tTvkpI6
# nj3cAORFJYm2mkQZK37AlLTSYW3rM9nF30sEAMx9HJXDj/chsrIRt7t/8tWMcCxB
# YKqxYxhElRp2Yn72gLD76GSmM9GJB+G9t+ZDpBi4pncB4Q+UDCEdslQpJYls5Q5S
# UUd0viastkF13nqsX40/ybzTQRESW+UQUOsxxcpyFiIJ33xMdT9j7CFfxCBRa2+x
# q4aLT8LWRV+dIPyhHsXAj6KxfgommfXkaS+YHS312amyHeUbAgMBAAGjggE6MIIB
# NjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTs1+OC0nFdZEzfLmc/57qYrhwP
# TzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzAOBgNVHQ8BAf8EBAMC
# AYYweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdp
# Y2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNv
# bS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwRQYDVR0fBD4wPDA6oDigNoY0
# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENB
# LmNybDARBgNVHSAECjAIMAYGBFUdIAAwDQYJKoZIhvcNAQEMBQADggEBAHCgv0Nc
# Vec4X6CjdBs9thbX979XB72arKGHLOyFXqkauyL4hxppVCLtpIh3bb0aFPQTSnov
# Lbc47/T/gLn4offyct4kvFIDyE7QKt76LVbP+fT3rDB6mouyXtTP0UNEm0Mh65Zy
# oUi0mcudT6cGAxN3J0TU53/oWajwvy8LpunyNDzs9wPHh6jSTEAZNUZqaVSwuKFW
# juyk1T3osdz9HNj0d1pcVIxv76FQPfx2CWiEn2/K2yCNNWAcAgPLILCsWKAOQGPF
# mCLBsln1VWvPJ6tsds5vIy30fnFqI2si/xK4VC0nftg62fC2h5b9W9FcrBjDTZ9z
# twGpn1eqXijiuZQwggawMIIEmKADAgECAhAIrUCyYNKcTJ9ezam9k67ZMA0GCSqG
# SIb3DQEBDAUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMx
# GTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRy
# dXN0ZWQgUm9vdCBHNDAeFw0yMTA0MjkwMDAwMDBaFw0zNjA0MjgyMzU5NTlaMGkx
# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4
# RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcgUlNBNDA5NiBTSEEzODQg
# MjAyMSBDQTEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDVtC9C0Cit
# eLdd1TlZG7GIQvUzjOs9gZdwxbvEhSYwn6SOaNhc9es0JAfhS0/TeEP0F9ce2vnS
# 1WcaUk8OoVf8iJnBkcyBAz5NcCRks43iCH00fUyAVxJrQ5qZ8sU7H/Lvy0daE6ZM
# swEgJfMQ04uy+wjwiuCdCcBlp/qYgEk1hz1RGeiQIXhFLqGfLOEYwhrMxe6TSXBC
# Mo/7xuoc82VokaJNTIIRSFJo3hC9FFdd6BgTZcV/sk+FLEikVoQ11vkunKoAFdE3
# /hoGlMJ8yOobMubKwvSnowMOdKWvObarYBLj6Na59zHh3K3kGKDYwSNHR7OhD26j
# q22YBoMbt2pnLdK9RBqSEIGPsDsJ18ebMlrC/2pgVItJwZPt4bRc4G/rJvmM1bL5
# OBDm6s6R9b7T+2+TYTRcvJNFKIM2KmYoX7BzzosmJQayg9Rc9hUZTO1i4F4z8ujo
# 7AqnsAMrkbI2eb73rQgedaZlzLvjSFDzd5Ea/ttQokbIYViY9XwCFjyDKK05huzU
# tw1T0PhH5nUwjewwk3YUpltLXXRhTT8SkXbev1jLchApQfDVxW0mdmgRQRNYmtwm
# KwH0iU1Z23jPgUo+QEdfyYFQc4UQIyFZYIpkVMHMIRroOBl8ZhzNeDhFMJlP/2NP
# TLuqDQhTQXxYPUez+rbsjDIJAsxsPAxWEQIDAQABo4IBWTCCAVUwEgYDVR0TAQH/
# BAgwBgEB/wIBADAdBgNVHQ4EFgQUaDfg67Y7+F8Rhvv+YXsIiGX0TkIwHwYDVR0j
# BBgwFoAU7NfjgtJxXWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMDMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0
# cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0
# cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8E
# PDA6MDigNqA0hjJodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVz
# dGVkUm9vdEc0LmNybDAcBgNVHSAEFTATMAcGBWeBDAEDMAgGBmeBDAEEATANBgkq
# hkiG9w0BAQwFAAOCAgEAOiNEPY0Idu6PvDqZ01bgAhql+Eg08yy25nRm95RysQDK
# r2wwJxMSnpBEn0v9nqN8JtU3vDpdSG2V1T9J9Ce7FoFFUP2cvbaF4HZ+N3HLIvda
# qpDP9ZNq4+sg0dVQeYiaiorBtr2hSBh+3NiAGhEZGM1hmYFW9snjdufE5BtfQ/g+
# lP92OT2e1JnPSt0o618moZVYSNUa/tcnP/2Q0XaG3RywYFzzDaju4ImhvTnhOE7a
# brs2nfvlIVNaw8rpavGiPttDuDPITzgUkpn13c5UbdldAhQfQDN8A+KVssIhdXNS
# y0bYxDQcoqVLjc1vdjcshT8azibpGL6QB7BDf5WIIIJw8MzK7/0pNVwfiThV9zeK
# iwmhywvpMRr/LhlcOXHhvpynCgbWJme3kuZOX956rEnPLqR0kq3bPKSchh/jwVYb
# KyP/j7XqiHtwa+aguv06P0WmxOgWkVKLQcBIhEuWTatEQOON8BUozu3xGFYHKi8Q
# xAwIZDwzj64ojDzLj4gLDb879M4ee47vtevLt/B3E+bnKD+sEq6lLyJsQfmCXBVm
# zGwOysWGw/YmMwwHS6DTBwJqakAwSEs0qFEgu60bhQjiWQ1tygVQK+pKHJ6l/aCn
# HwZ05/LWUpD9r4VIIflXO7ScA+2GRfS0YW6/aOImYIbqyK+p/pQd52MbOoZWeE4w
# gga0MIIEnKADAgECAhANx6xXBf8hmS5AQyIMOkmGMA0GCSqGSIb3DQEBCwUAMGIx
# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3
# dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRydXN0ZWQgUm9vdCBH
# NDAeFw0yNTA1MDcwMDAwMDBaFw0zODAxMTQyMzU5NTlaMGkxCzAJBgNVBAYTAlVT
# MRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1
# c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYgMjAyNSBDQTEwggIi
# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0eDHTCphBcr48RsAcrHXbo0Zo
# dLRRF51NrY0NlLWZloMsVO1DahGPNRcybEKq+RuwOnPhof6pvF4uGjwjqNjfEvUi
# 6wuim5bap+0lgloM2zX4kftn5B1IpYzTqpyFQ/4Bt0mAxAHeHYNnQxqXmRinvuNg
# xVBdJkf77S2uPoCj7GH8BLuxBG5AvftBdsOECS1UkxBvMgEdgkFiDNYiOTx4OtiF
# cMSkqTtF2hfQz3zQSku2Ws3IfDReb6e3mmdglTcaarps0wjUjsZvkgFkriK9tUKJ
# m/s80FiocSk1VYLZlDwFt+cVFBURJg6zMUjZa/zbCclF83bRVFLeGkuAhHiGPMvS
# GmhgaTzVyhYn4p0+8y9oHRaQT/aofEnS5xLrfxnGpTXiUOeSLsJygoLPp66bkDX1
# ZlAeSpQl92QOMeRxykvq6gbylsXQskBBBnGy3tW/AMOMCZIVNSaz7BX8VtYGqLt9
# MmeOreGPRdtBx3yGOP+rx3rKWDEJlIqLXvJWnY0v5ydPpOjL6s36czwzsucuoKs7
# Yk/ehb//Wx+5kMqIMRvUBDx6z1ev+7psNOdgJMoiwOrUG2ZdSoQbU2rMkpLiQ6bG
# RinZbI4OLu9BMIFm1UUl9VnePs6BaaeEWvjJSjNm2qA+sdFUeEY0qVjPKOWug/G6
# X5uAiynM7Bu2ayBjUwIDAQABo4IBXTCCAVkwEgYDVR0TAQH/BAgwBgEB/wIBADAd
# BgNVHQ4EFgQU729TSunkBnx6yuKQVvYv1Ensy04wHwYDVR0jBBgwFoAU7NfjgtJx
# XWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1UdJQQMMAoGCCsGAQUF
# BwMIMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGln
# aWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5j
# b20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8EPDA6MDigNqA0hjJo
# dHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNy
# bDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwDQYJKoZIhvcNAQEL
# BQADggIBABfO+xaAHP4HPRF2cTC9vgvItTSmf83Qh8WIGjB/T8ObXAZz8OjuhUxj
# aaFdleMM0lBryPTQM2qEJPe36zwbSI/mS83afsl3YTj+IQhQE7jU/kXjjytJgnn0
# hvrV6hqWGd3rLAUt6vJy9lMDPjTLxLgXf9r5nWMQwr8Myb9rEVKChHyfpzee5kH0
# F8HABBgr0UdqirZ7bowe9Vj2AIMD8liyrukZ2iA/wdG2th9y1IsA0QF8dTXqvcnT
# mpfeQh35k5zOCPmSNq1UH410ANVko43+Cdmu4y81hjajV/gxdEkMx1NKU4uHQcKf
# ZxAvBAKqMVuqte69M9J6A47OvgRaPs+2ykgcGV00TYr2Lr3ty9qIijanrUR3anzE
# wlvzZiiyfTPjLbnFRsjsYg39OlV8cipDoq7+qNNjqFzeGxcytL5TTLL4ZaoBdqbh
# OhZ3ZRDUphPvSRmMThi0vw9vODRzW6AxnJll38F0cuJG7uEBYTptMSbhdhGQDpOX
# gpIUsWTjd6xpR6oaQf/DJbg3s6KCLPAlZ66RzIg9sC+NJpud/v4+7RWsWCiKi9EO
# LLHfMR2ZyJ/+xhCx9yHbxtl5TPau1j/1MIDpMPx0LckTetiSuEtQvLsNz3Qbp7wG
# WqbIiOWCnb5WqxL3/BAPvIXKUjPSxyZsq8WhbaM2tszWkPZPubdcMIIG7TCCBNWg
# AwIBAgIQCoDvGEuN8QWC0cR2p5V0aDANBgkqhkiG9w0BAQsFADBpMQswCQYDVQQG
# EwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0
# IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0Ex
# MB4XDTI1MDYwNDAwMDAwMFoXDTM2MDkwMzIzNTk1OVowYzELMAkGA1UEBhMCVVMx
# FzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBTSEEy
# NTYgUlNBNDA5NiBUaW1lc3RhbXAgUmVzcG9uZGVyIDIwMjUgMTCCAiIwDQYJKoZI
# hvcNAQEBBQADggIPADCCAgoCggIBANBGrC0Sxp7Q6q5gVrMrV7pvUf+GcAoB38o3
# zBlCMGMyqJnfFNZx+wvA69HFTBdwbHwBSOeLpvPnZ8ZN+vo8dE2/pPvOx/Vj8Tch
# TySA2R4QKpVD7dvNZh6wW2R6kSu9RJt/4QhguSssp3qome7MrxVyfQO9sMx6ZAWj
# FDYOzDi8SOhPUWlLnh00Cll8pjrUcCV3K3E0zz09ldQ//nBZZREr4h/GI6Dxb2Uo
# yrN0ijtUDVHRXdmncOOMA3CoB/iUSROUINDT98oksouTMYFOnHoRh6+86Ltc5zjP
# KHW5KqCvpSduSwhwUmotuQhcg9tw2YD3w6ySSSu+3qU8DD+nigNJFmt6LAHvH3KS
# uNLoZLc1Hf2JNMVL4Q1OpbybpMe46YceNA0LfNsnqcnpJeItK/DhKbPxTTuGoX7w
# JNdoRORVbPR1VVnDuSeHVZlc4seAO+6d2sC26/PQPdP51ho1zBp+xUIZkpSFA8vW
# doUoHLWnqWU3dCCyFG1roSrgHjSHlq8xymLnjCbSLZ49kPmk8iyyizNDIXj//cOg
# rY7rlRyTlaCCfw7aSUROwnu7zER6EaJ+AliL7ojTdS5PWPsWeupWs7NpChUk555K
# 096V1hE0yZIXe+giAwW00aHzrDchIc2bQhpp0IoKRR7YufAkprxMiXAJQ1XCmnCf
# gPf8+3mnAgMBAAGjggGVMIIBkTAMBgNVHRMBAf8EAjAAMB0GA1UdDgQWBBTkO/zy
# Me39/dfzkXFjGVBDz2GM6DAfBgNVHSMEGDAWgBTvb1NK6eQGfHrK4pBW9i/USezL
# TjAOBgNVHQ8BAf8EBAMCB4AwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwgZUGCCsG
# AQUFBwEBBIGIMIGFMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5j
# b20wXQYIKwYBBQUHMAKGUWh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdp
# Q2VydFRydXN0ZWRHNFRpbWVTdGFtcGluZ1JTQTQwOTZTSEEyNTYyMDI1Q0ExLmNy
# dDBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGln
# aUNlcnRUcnVzdGVkRzRUaW1lU3RhbXBpbmdSU0E0MDk2U0hBMjU2MjAyNUNBMS5j
# cmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEB
# CwUAA4ICAQBlKq3xHCcEua5gQezRCESeY0ByIfjk9iJP2zWLpQq1b4URGnwWBdEZ
# D9gBq9fNaNmFj6Eh8/YmRDfxT7C0k8FUFqNh+tshgb4O6Lgjg8K8elC4+oWCqnU/
# ML9lFfim8/9yJmZSe2F8AQ/UdKFOtj7YMTmqPO9mzskgiC3QYIUP2S3HQvHG1FDu
# +WUqW4daIqToXFE/JQ/EABgfZXLWU0ziTN6R3ygQBHMUBaB5bdrPbF6MRYs03h4o
# bEMnxYOX8VBRKe1uNnzQVTeLni2nHkX/QqvXnNb+YkDFkxUGtMTaiLR9wjxUxu2h
# ECZpqyU1d0IbX6Wq8/gVutDojBIFeRlqAcuEVT0cKsb+zJNEsuEB7O7/cuvTQasn
# M9AWcIQfVjnzrvwiCZ85EE8LUkqRhoS3Y50OHgaY7T/lwd6UArb+BOVAkg2oOvol
# /DJgddJ35XTxfUlQ+8Hggt8l2Yv7roancJIFcbojBcxlRcGG0LIhp6GvReQGgMgY
# xQbV1S3CrWqZzBt1R9xJgKf47CdxVRd/ndUlQ05oxYy2zRWVFjF7mcr4C34Mj3oc
# CVccAvlKV9jEnstrniLvUxxVZE/rptb7IRE2lskKPIJgbaP5t2nGj/ULLi49xTcB
# ZU8atufk+EMF/cWuiC7POGT75qaL6vdCvHlshtjdNXOCIUjsarfNZzCCB0kwggUx
# oAMCAQICEAe0P3SLJmcoVNrErUyxTt0wDQYJKoZIhvcNAQELBQAwaTELMAkGA1UE
# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy
# dCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENB
# MTAeFw0yNTEyMzEwMDAwMDBaFw0yOTAxMDIyMzU5NTlaMIHRMRMwEQYLKwYBBAGC
# NzwCAQMTAlVTMRkwFwYLKwYBBAGCNzwCAQITCERlbGF3YXJlMR0wGwYDVQQPDBRQ
# cml2YXRlIE9yZ2FuaXphdGlvbjEQMA4GA1UEBRMHMzQwNzk4NTELMAkGA1UEBhMC
# VVMxETAPBgNVBAgTCElsbGlub2lzMRAwDgYDVQQHEwdDaGljYWdvMR0wGwYDVQQK
# ExRLZWVwZXIgU2VjdXJpdHkgSW5jLjEdMBsGA1UEAxMUS2VlcGVyIFNlY3VyaXR5
# IEluYy4wggGiMA0GCSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQCUcNMoSVmxAi0a
# vG+StFJMNFFTUIOo3HdBZ+0gqA1XpNgUx11vB1vCZrvFsD9m5oA58tdp4gZN3LmQ
# aMvCl2ANUT7MilI02Hf1RWlygBzon6iE0GpU3lgRrwrk1dhtLpGsR6dbMKUUHprc
# vKpXk90/VN+vhzY1uik1tCTxkDCPu/AYJg7m9+tR2KqvMuYMaMLhii66eWUAGsBC
# h/uZxjkGoJF6qZ0DgFd7rW7VYljbfYSNPeZNGTDgB0J/wOsKl0mn612DTseIvAKt
# 4vra/FLFukyEyStnfQ8lWYDcLLCMCjNVrzGipmT5E2iyx7Y1RZCIpNwVogp3Ixbk
# Gbq5A/41YNOLLd4cFewyB2F037RevBCRsUODZEt1qBf7Jbu3DiYo1G+zTj9E0R1s
# FzyijcfdsTm6X5ble+yCJeGkX5XgsyPnZpyz/FX9Fr0N9pMPGWwW2PKyHEnSytXm
# 0Dxdq2P4mA4CBUxq7YoV26L2PF6QEh9BQdXTPcnLysUv7SI/a0ECAwEAAaOCAgIw
# ggH+MB8GA1UdIwQYMBaAFGg34Ou2O/hfEYb7/mF7CIhl9E5CMB0GA1UdDgQWBBRG
# 4H6CH8pvNX632bsdnrda4MtJLDA9BgNVHSAENjA0MDIGBWeBDAEDMCkwJwYIKwYB
# BQUHAgEWG2h0dHA6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAOBgNVHQ8BAf8EBAMC
# B4AwEwYDVR0lBAwwCgYIKwYBBQUHAwMwgbUGA1UdHwSBrTCBqjBToFGgT4ZNaHR0
# cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0Q29kZVNpZ25p
# bmdSU0E0MDk2U0hBMzg0MjAyMUNBMS5jcmwwU6BRoE+GTWh0dHA6Ly9jcmw0LmRp
# Z2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNENvZGVTaWduaW5nUlNBNDA5NlNI
# QTM4NDIwMjFDQTEuY3JsMIGUBggrBgEFBQcBAQSBhzCBhDAkBggrBgEFBQcwAYYY
# aHR0cDovL29jc3AuZGlnaWNlcnQuY29tMFwGCCsGAQUFBzAChlBodHRwOi8vY2Fj
# ZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRDb2RlU2lnbmluZ1JT
# QTQwOTZTSEEzODQyMDIxQ0ExLmNydDAJBgNVHRMEAjAAMA0GCSqGSIb3DQEBCwUA
# A4ICAQA1Wlq0WzJa3N6DgjgBU7nagIJBab1prPARXZreX1MOv9VjnS5o0CrfQLr6
# z3bmWHw7xT8dt6bcSwRixqvPJtv4q8Rvo80O3eUMvMxQzqmi7z1zf+HG+/3G4F+2
# IYegvPc8Ui151XCV9rjA8tvFWRLRMX0ZRxY1zfT027HMw0iYL20z44+Cky//FAnL
# iRwoNDGiRkZiHbB9YOftPAYNMG3gm1z3zOW5RdfKPrqvMuijE+dfyLIAA6Immpzu
# FMH+Wgn8NnSlot9b4YKycaqqdjd7wXDjPub/oQ7VShuCSBWj+UNOTVh0vcZGackc
# H1DLVgwp2dcKlxJiQKtkHT/T6LloY6LTe6+8wkVkr8EAv1W+q/+M1a4Ao+ykFbIA
# 2LBEmA9qdgoLtenAYIiEg+48SjMPgyBbVPE3bhL1vIqjEIxYCfdmi6wx33oYX7HB
# +bJ7zitHw4GgtpfPV8y8QRZImKmeDOKyXjQPDmQM/Eglm/Ns0GzBkVXM8h6UI34b
# WZrHz9sbLSE20m5Svmxftvw5zju+I3WsmS/stNfWlOkwU0niUgwPHaz21kjXEA5A
# g+aqv26wodqZcnGOlChoWDvSJ8KKgdOFbeAYKAMp1NY7iWV315zpGH19RipCR1NH
# 0ND8iIubk3WGNf2rzEfqlOi3h2ywqVkU6AKXHdO5JV4otSKKEDGCBdkwggXVAgEB
# MH0waTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYD
# VQQDEzhEaWdpQ2VydCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBSU0E0MDk2IFNI
# QTM4NCAyMDIxIENBMQIQB7Q/dIsmZyhU2sStTLFO3TANBglghkgBZQMEAgEFAKCB
# hDAYBgorBgEEAYI3AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEE
# AYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJ
# BDEiBCALYZ1XRlmW4tbtcl6GRV18qCOMaMMVrDPBxkvp7XLYDDANBgkqhkiG9w0B
# AQEFAASCAYAppcZy3ohdn0Ahl2uTXaXLGiPMxzaO7K6fhNJVBJiIXUp8iJ7n+LeJ
# HtsoG0ATjU1PuaOps0O06dDz/VriWYK+hbxzi2PkZVFDfpuYOJroj2ahxfFVspGw
# GIDimM5KA0V4iBgkruRyPjAeLiCV9KzMgWc7KvCtaC+x8bsQvxRqWzVZGZDIO4HN
# Lrjlz81HdWcIDL9kAxYGQEFrEMChzNn0P6GeKC7FszyKTW7mlP+d0hg48+40Fhpj
# mYoi6sUDAJLs0HUkakrdGrlSzdbJfKnOp2j7XdhX2sQu1x+9N2EFjr7r0xYa4Vmw
# jAFBUm1GHwTGvddanqNcIaGAaB5WPQcbXj4XCugPO8Zt49U7g0nVF21EQ+uktP6p
# QDtYILeWENVIcWuCqPx2//KSpisQsn7pXHQkW5Ci3oJyLmsrrhGcuLAYhGdyIjps
# qHEsokWIl3l5nWBvcBiGjTFqk4Jnz7s4FMLQ78i57aPJl1nBEYSkd5n03VhkAy+s
# BuQxitJ031yhggMmMIIDIgYJKoZIhvcNAQkGMYIDEzCCAw8CAQEwfTBpMQswCQYD
# VQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lD
# ZXJ0IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUg
# Q0ExAhAKgO8YS43xBYLRxHanlXRoMA0GCWCGSAFlAwQCAQUAoGkwGAYJKoZIhvcN
# AQkDMQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUxDxcNMjYwNTI2MDQwNjQ2WjAv
# BgkqhkiG9w0BCQQxIgQg4dlahxpn+MJnjcT2spu8YHV2Yc1VSo2sPSQgCpKiTTgw
# DQYJKoZIhvcNAQEBBQAEggIAXErAw8HG5M5UyUwvqbwDBqbrWBVhmbnV5qTw9ZFX
# NxZtQnHKmJQZHUpoKn9rvX13VQ8mvMiYmmyLv3fjMfJRUk79JAv8IqUop1mdKXxe
# Uvqy1vX10kGRMq2UshWIfEc/25EVFkXoqJ+Z/S2kbPvR6ncsV4C+kILZwJLrMWa1
# +gVTz2gy56QB3oiCHn90KOnFa4NrtOlhivCTAkn0FZoUtNSN/3AXcRLGohBkDArz
# wVg2IhAFMa8puwPJDV2ywhFev01mD19KuH+s10S74qA1IiOndYrTqZR7dIBfprZP
# AiH4rhKfBoQjRHCT4dUlYI/e3PzfFx9B8ED2j5Rnhb6kePJ/UO62rv2THI2TuUPL
# FVBrc6JOE3Jiw4JW3nFAyMu2avTLYEgSZVIzaff4dn2yFs6Sj/YtnVkffY/r0bmj
# FqrpvOQaSHhg0uGj/7kvKvqJisDhp2FH5fsyb9aEzfSe4S1qowmCPnnYKJVOFOxp
# 8Aer+dIWV6SK/3ysVHJNlSMP4kEjj/kCLIWy/neHfnS/+yVCrFLFUwfySjzGeWTL
# TAk7m10CvwyygEV5ITV+eL3b1PmaX7KjjeUGfgEcIj20O3rnqhoVpaGzEqSurhEv
# OEMwUyVcLthwi7Vvr9VCSLNJCi+iAMC71A79M486i5VhMlE62eT4XCoJkvHwckCw
# 20Q=
# SIG # End signature block