UMN-SplunkRA

1.0.8

UMN-SplunkRA.psm1

                                ###

# Copyright 2017 University of Minnesota, Office of Information Technology

# This program is free software: you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation, either version 3 of the License, or

# (at your option) any later version.

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

# You should have received a copy of the GNU General Public License

# along with Foobar.  If not, see <http://www.gnu.org/licenses/>.

# based off http://dev.splunk.com/restapi  

#region Connect-Splunk

Function Connect-Splunk{

    <#

        .SYNOPSIS

            Connect to splunk server and header properly formatted

        .DESCRIPTION

            Connect to splunk server and header properly formatted

        .PARAMETER splunkCreds

            PS credential of user that has access

        .PARAMETER server

            FQDN for splunk server

        .PARAMETER SkipCertificateCheck

            Ignore bad SSL Certificates

        .PARAMETER port

            splunk server port to connect to, port 8089 is the default

        .EXAMPLE

            $header = Connect-Splunk -splunkCreds $cred -SkipCertificateCheck -server 'splunk.mydomain.com'

        .OUTPUTS

            System.Collections.Hashtable[]

            Header with Authentication information

        .NOTES

            # http://docs.splunk.com/Documentation/Splunk/latest/RESTUM/RESTusing#Authentication_and_authorization

            For legacy automation systems dealing with cookies - 

            -UseBasicParsing is included on the InvokeWebRequest - needed parsing for Orchestrator

    #>

    [CmdletBinding()]

    param(

        [ValidateNotNullOrEmpty()]

        [System.Management.Automation.PSCredential]$splunkCreds,

        [parameter(Mandatory)]

        [string]$server,

        [switch]$SkipCertificateCheck,

        [string]$port = "8089"

    )

    Begin

    {

        if ($SkipCertificateCheck -and $PSVersionTable.PSVersion.Major -lt 6)

        {

            [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

add-type @"

    using System.Net;

    using System.Security.Cryptography.X509Certificates;

    public class TrustAllCertsPolicy : ICertificatePolicy {

        public bool CheckValidationResult(

            ServicePoint srvPoint, X509Certificate certificate,

            WebRequest request, int certificateProblem) {

            return true;

        }

    }

"@

            [System.Net.ServicePointManager]::CertificatePolicy = New-Object TrustAllCertsPolicy

        }

}

    Process

    {    

        $uri = "https://$server`:$port/services/auth/login"

        $return = (Invoke-RestMethod -Uri $uri -UseBasicParsing -body "username=$($splunkCreds.UserName);password=$($splunkCreds.GetNetworkCredential().Password)" -Method Post -ContentType 'application/x-www-form-urlencoded').response

        $session = $return.sessionKey

        return (@{"Authorization"= "Splunk $session"})

    }

    End{}

}

#endregion

#region Invoke-SplunkBase

Function Invoke-SplunkBase{

    <#

        .SYNOPSIS

            Base function all other functions are built on

        .DESCRIPTION

            Base function all other functions are built on

        .PARAMETER header

            Header value (use Connect-splunk to get it)

        .PARAMETER server

            FQDN for splunk server

        .PARAMETER outPutmode

            csv,xml,json data return type for call

        .PARAMETER port

            splunk server port to connect to, port 8089 is the default

        .PARAMETER resourcePath

            Api resoure path.

        .PARAMETER resultSize

            Limit the number of results to return.  100 is the default.  Use zero to get all

        .EXAMPLE    

        .NOTES        

    #>

    [CmdletBinding()]

    param(

        [parameter(Mandatory)]

        [string]$server,

        [parameter(Mandatory)]

        [System.Collections.Hashtable]$header,

        [System.Collections.Hashtable]$body,

        [parameter(Mandatory)]

        [string]$resourcePath,

        ## Warning the convertfrom-json blows up a LOT, it does not like the way spunk sends back data

        [ValidateSet("json", "csv", "xml", "default")]

        [string]$outPutmode = "default",

        #[switch]$SkipCertificateCheck,

        [string]$port = "8089",

        [string]$resultSize

    )

    Begin{}

    Process

    {

        $uri = "https://$server`:$port/services/$resourcePath"

        if ($outPutmode -ne 'default'){$uri += "?output_mode=$outPutmode"}

        if ($resultSize)

        {

            if ($outPutmode -ne 'default'){$uri += "&count=$resultSize"}

            else {$uri += "?count=$resultSize"} 

        }

        if ($body){$data = (Invoke-WebRequest -Uri $uri -Headers $header -Body $body -UseBasicParsing ).Content}

        else{$data = (Invoke-WebRequest -Uri $uri -Headers $header -UseBasicParsing ).Content}

        if ($outPutmode -eq 'csv'){ return ($data | ConvertFrom-Csv)}

        elseif ($outPutmode -eq 'json'){return ($data | ConvertFrom-Json)}

        else{return $data}

    }

    End{}

}

#endregion

#region Get-SplunkSearchExport

Function Get-SplunkSearchExport{

    <#

        .SYNOPSIS

            Get results for a search

        .DESCRIPTION

            Get results for a search    

        .PARAMETER header

            Header value (use Connect-splunk to get it)

        .PARAMETER server

            FQDN for splunk server

        .PARAMETER outPutmode

            csv,xml,json data return type for call

        .PARAMETER port

            splunk server port to connect to, port 8089 is the default

        .PARAMETER search

            Realtime Search you want performed

    #>

    [CmdletBinding()]

    param(

        [parameter(Mandatory)]

        [string]$server,

        [parameter(Mandatory)]

        [System.Collections.Hashtable]$header,

        [parameter(Mandatory)]

        [string]$search,

        ## Warning the convertfrom-json blows up a LOT, it does not like the way spunk sends back data

        [ValidateSet("json", "csv", "xml", "default")]

        [string]$outPutmode = "default",

        #[switch]$SkipCertificateCheck,

        [string]$port = "8089"

    )

    Begin{}

    Process

    {

        $body = @{"search" = "search $search"}

        return (Invoke-SplunkBase -server $server -header $header -resourcePath 'search/jobs/export' -outPutmode $outPutmode -body $body -port $port)

    }

    End{}

}

#endregion

#region Get-SplunkListSavedSearches

function Get-SplunkListSavedSearches{

<#

    .SYNOPSIS

        Get list of saved searches

    .DESCRIPTION

        Get list of saved searches    

    .PARAMETER header

        Header value (use Connect-splunk to get it)

    .PARAMETER server

        FQDN for splunk server

    .PARAMETER port

        splunk server port to connect to, port 8089 is the default

    .PARAMETER complete

       The default is to return a summary of search, use this switch to get all the details the system returns

    .EXAMPLE

        Get-SplunkListSavedSearches -server $server -header $header

    .NOTES

#>

    [CmdletBinding()]

    Param

    (

        [parameter(Mandatory)]

        [string]$server,

        [parameter(Mandatory)]

        [System.Collections.Hashtable]$header,

        [string]$port = "8089",

        [switch]$complete

    )

    Begin{}

    Process

    {

        if ($complete){return ((Invoke-SplunkBase -server $server -header $header -resourcePath 'saved/searches' -outPutmode json).entry)}

        else{return ((Invoke-SplunkBase -server $server -header $header -resourcePath 'saved/searches' -outPutmode json).entry | Select name,author,updated,id)}

    }

    End{}

}

#endregion

#region Get-SplunkSearchJobs

function Get-SplunkSearchJobs{

<#

    .SYNOPSIS

        Get list of jobs or details about a specific job

    .DESCRIPTION

        Get list of jobs or details about a specific job    

    .PARAMETER header

        Header value (use Connect-splunk to get it)

    .PARAMETER server

        FQDN for splunk server

    .PARAMETER port

        splunk server port to connect to, port 8089 is the default

    .PARAMETER sid

       The default is to return a summary of jobs, this will also get the Search ID (sid) that you can feed back in to get more details about a job

    .EXAMPLE

        Get-SplunkListSavedSearches -server $server -header $header

    .NOTES

#>

    [CmdletBinding()]

    Param

    (

        [parameter(Mandatory)]

        [string]$server,

        [parameter(Mandatory)]

        [System.Collections.Hashtable]$header,

        [string]$port = "8089",

        [string]$sid

    )

    Begin{}

    Process

    {

        if ($sid){return (Invoke-SplunkBase -server $server -header $header -resourcePath "search/jobs/$sid" -outPutmode csv)}

        else{return (Invoke-SplunkBase -server $server -header $header -resourcePath 'search/jobs' -outPutmode csv | select label,user,sid | sort -Property label)}

    }

    End{}

}

#endregion

#region Get-SplunkSearchJobsResults

function Get-SplunkSearchJobsResults{

<#

    .SYNOPSIS

        Get Reults of a job

    .DESCRIPTION

        Get Reults of a job.  It can return a lot of data, consider piping through Select to narrow it down.    

    .PARAMETER header

        Header value (use Connect-splunk to get it)

    .PARAMETER server

        FQDN for splunk server

    .PARAMETER port

        splunk server port to connect to, port 8089 is the default

    .PARAMETER sid

       Search ID (sid), use Get-SplunkSearchJobs to get this

    .PARAMETER resultSize

        Limit the number of results to return.  100 is the default.  Use zero to get all

    .EXAMPLE

    .NOTES

#>

    [CmdletBinding()]

    Param

    (

        [parameter(Mandatory)]

        [string]$server,

        [parameter(Mandatory)]

        [System.Collections.Hashtable]$header,

        [string]$port = "8089",

        [parameter(Mandatory)]

        [string]$sid,

        [string]$resultSize

    )

    Begin{}

    Process

    {

        return (Invoke-SplunkBase -server $server -header $header -resourcePath "search/jobs/$sid/results" -outPutmode csv -resultSize $resultSize)

    }

    End{}

}

#endregion

# SIG # Begin signature block

# MIIfsAYJKoZIhvcNAQcCoIIfoTCCH50CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUURJ78Cndb1oAe9hT6WYvmmg/

# jbGgghmZMIIFrDCCBJSgAwIBAgIQck1eIBPVwpFAVfN8VIlUcTANBgkqhkiG9w0B

# AQsFADB8MQswCQYDVQQGEwJVUzELMAkGA1UECBMCTUkxEjAQBgNVBAcTCUFubiBB

# cmJvcjESMBAGA1UEChMJSW50ZXJuZXQyMREwDwYDVQQLEwhJbkNvbW1vbjElMCMG

# A1UEAxMcSW5Db21tb24gUlNBIENvZGUgU2lnbmluZyBDQTAeFw0xNzEyMTQwMDAw

# MDBaFw0yMDEyMTMyMzU5NTlaMIHLMQswCQYDVQQGEwJVUzEOMAwGA1UEEQwFNTU0

# NTUxEjAQBgNVBAgMCU1pbm5lc290YTEUMBIGA1UEBwwLTWlubmVhcG9saXMxGDAW

# BgNVBAkMDzEwMCBVbmlvbiBTdCBTRTEgMB4GA1UECgwXVW5pdmVyc2l0eSBvZiBN

# aW5uZXNvdGExJDAiBgNVBAsMG0NvbXB1dGVyIGFuZCBEZXZpY2UgU3VwcG9ydDEg

# MB4GA1UEAwwXVW5pdmVyc2l0eSBvZiBNaW5uZXNvdGEwggEiMA0GCSqGSIb3DQEB

# AQUAA4IBDwAwggEKAoIBAQDCTqQsT2761a/QlSQglKfmlZ9rT2DpyoUu5wJeiY2P

# 01iPy34l8+dreALose/c5ABQMc6gLkf7w3d5rupUZgiLA9EfNc4aob+1VqJTmzmE

# be8GF9FfxbX/aDj+GmB5dTOvFif/ZzlI4YbLQxTVknJRIUR2yNccRXsdcriqYUZX

# 1EnG2ItkfWpSV0KCXFyPvPDRCdR0bqgDGnBMJ5WnTnv9ZduchHxrSA+x77L+d7Dn

# 4IFQZMC+vDorYGslBWx0ghWf+r4FtxnGH0+l5l9O2yLqWCS/LRtRa2XmxKl3vn6G

# /DhKXccBpZm2hY3ss+ZsNttVE7YCu/h2iHgKGh3jAnnFAgMBAAGjggHYMIIB1DAf

# BgNVHSMEGDAWgBSuNSMX//8GPZxQ4IwkZTMecBCIojAdBgNVHQ4EFgQUXgsSESVV

# S9Pyfm3E4lI0BzOihIAwDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwEwYD

# VR0lBAwwCgYIKwYBBQUHAwMwEQYJYIZIAYb4QgEBBAQDAgQQMGYGA1UdIARfMF0w

# WwYMKwYBBAGuIwEEAwIBMEswSQYIKwYBBQUHAgEWPWh0dHBzOi8vd3d3LmluY29t

# bW9uLm9yZy9jZXJ0L3JlcG9zaXRvcnkvY3BzX2NvZGVfc2lnbmluZy5wZGYwSQYD

# VR0fBEIwQDA+oDygOoY4aHR0cDovL2NybC5pbmNvbW1vbi1yc2Eub3JnL0luQ29t

# bW9uUlNBQ29kZVNpZ25pbmdDQS5jcmwwfgYIKwYBBQUHAQEEcjBwMEQGCCsGAQUF

# BzAChjhodHRwOi8vY3J0LmluY29tbW9uLXJzYS5vcmcvSW5Db21tb25SU0FDb2Rl

# U2lnbmluZ0NBLmNydDAoBggrBgEFBQcwAYYcaHR0cDovL29jc3AuaW5jb21tb24t

# cnNhLm9yZzAZBgNVHREEEjAQgQ5vaXRtcHRAdW1uLmVkdTANBgkqhkiG9w0BAQsF

# AAOCAQEAQ1GV6wwqYFpnSDryW21gQy1o+LP4No2k6VcGzWAfrpqCEHVo/qKJElwV

# VqwYtRUWdx0bXFvDnTctOsFRzk8QIxUNUXsooJ8cDU54VX285bK91WBt7eloPLWy

# PgIAM7YPSCfFwaJmgWERmIGRO9KyPhLcZdkS+gUcnEkvDaS90ufPLSAf9v9v/JuX

# ADV8pfDiWhxSkMzqpPAztKIqCRDlbv/bzQRi7wEjpzyumImaozW1ktymzC5q8HTR

# PnZj5lmbPe0wxWAUef2kUWW1ivezdsR6TsjqlTy6chJuLJDPGqEhQpoGLyHLwuCh

# jlScaNfmMewi8g3Oaz4lfki3LTawvTCCBeswggPToAMCAQICEGXh4uPV3lBFhfMm

# JIAF4tQwDQYJKoZIhvcNAQENBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpO

# ZXcgSmVyc2V5MRQwEgYDVQQHEwtKZXJzZXkgQ2l0eTEeMBwGA1UEChMVVGhlIFVT

# RVJUUlVTVCBOZXR3b3JrMS4wLAYDVQQDEyVVU0VSVHJ1c3QgUlNBIENlcnRpZmlj

# YXRpb24gQXV0aG9yaXR5MB4XDTE0MDkxOTAwMDAwMFoXDTI0MDkxODIzNTk1OVow

# fDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAk1JMRIwEAYDVQQHEwlBbm4gQXJib3Ix

# EjAQBgNVBAoTCUludGVybmV0MjERMA8GA1UECxMISW5Db21tb24xJTAjBgNVBAMT

# HEluQ29tbW9uIFJTQSBDb2RlIFNpZ25pbmcgQ0EwggEiMA0GCSqGSIb3DQEBAQUA

# A4IBDwAwggEKAoIBAQDAoC+LHnq7anWs+D7co7o5Isrzo3bkv30wJ+a605gyViNc

# BoaXDYDo7aKBNesL9l5+qT5oc/2d1Gd5zqrqaLcZ2xx2OlmHXV6Zx6GyuKmEcwzM

# q4dGHGrH7zklvqfd2iw1cDYdIi4gO93jHA4/NJ/lff5VgFsGfIJXhFXzOPvyDDap

# uV6yxYFHI30SgaDAASg+A/k4l6OtAvICaP3VAav11VFNUNMXIkblcxjgOuQ3d1HI

# nn1Sik+A3Ca5wEzK/FH6EAkRelcqc8TgISpswlS9HD6D+FupLPH623jP2YmabaP/

# Dac/fkxWI9YJvuGlHYsHxb/j31iq76SvgssF+AoJAgMBAAGjggFaMIIBVjAfBgNV

# HSMEGDAWgBRTeb9aqitKz1SA4dibwJ3ysgNmyzAdBgNVHQ4EFgQUrjUjF///Bj2c

# UOCMJGUzHnAQiKIwDgYDVR0PAQH/BAQDAgGGMBIGA1UdEwEB/wQIMAYBAf8CAQAw

# EwYDVR0lBAwwCgYIKwYBBQUHAwMwEQYDVR0gBAowCDAGBgRVHSAAMFAGA1UdHwRJ

# MEcwRaBDoEGGP2h0dHA6Ly9jcmwudXNlcnRydXN0LmNvbS9VU0VSVHJ1c3RSU0FD

# ZXJ0aWZpY2F0aW9uQXV0aG9yaXR5LmNybDB2BggrBgEFBQcBAQRqMGgwPwYIKwYB

# BQUHMAKGM2h0dHA6Ly9jcnQudXNlcnRydXN0LmNvbS9VU0VSVHJ1c3RSU0FBZGRU

# cnVzdENBLmNydDAlBggrBgEFBQcwAYYZaHR0cDovL29jc3AudXNlcnRydXN0LmNv

# bTANBgkqhkiG9w0BAQ0FAAOCAgEARiy2f2pOJWa9nGqmqtCevQ+uTjX88Dgnwced

# BMmCNNuG4RP3wZaNMEQT0jXtefdXXJOmEldtq3mXwSZk38lcy8M2om2TI6HbqjAC

# a+q4wIXWkqJBbK4MOWXFH0wQKnrEXjCcfUxyzhZ4s6tA/L4LmRYTmCD/srpz0bVU

# 3AuSX+mj05E+WPEop4WE+D35OLcnMcjFbst3KWN99xxaK40VHnX8EkcBkipQPDcu

# yt1hbOCDjHTq2Ay84R/SchN6WkVPGpW8y0mGc59lul1dlDmjVOynF9MRU5ACynTk

# dQ0JfKHOeVUuvQlo2Qzt52CTn3OZ1NtIZ0yrxm267pXKuK86UxI9aZrLkyO/BPO4

# 2itvAG/QMv7tzJkGns1hmi74OgZ3WUVk3SNTkixAqCbf7TSmecnrtyt0XB/P/xur

# cyFOIo5YRvTgVPc5lWn6PO9oKEdYtDyBsI5GAKVpmrUfdqojsl5GRYQQSnpO/hYB

# Wyv+LsuhdTvaA5vwIDM8WrAjgTFx2vGnQjg5dsQIeUOpTixMierCUzCh+bF47i73

# jX3qoiolCX7xLKSXTpWS2oy7HzgjDdlAsfTwnwton5YNTJxzg6NjrUjsUbEIORtJ

# B/eeld5EWbQgGfwaJb5NEOTonZckUtYS1VmaFugWUEuhSWodQIq7RA6FT/4AQ6qd

# j3yPbNEwggbsMIIE1KADAgECAhAwD2+s3WaYdHypRjaneC25MA0GCSqGSIb3DQEB

# DAUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKTmV3IEplcnNleTEUMBIGA1UE

# BxMLSmVyc2V5IENpdHkxHjAcBgNVBAoTFVRoZSBVU0VSVFJVU1QgTmV0d29yazEu

# MCwGA1UEAxMlVVNFUlRydXN0IFJTQSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe

# Fw0xOTA1MDIwMDAwMDBaFw0zODAxMTgyMzU5NTlaMH0xCzAJBgNVBAYTAkdCMRsw

# GQYDVQQIExJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcTB1NhbGZvcmQxGDAW

# BgNVBAoTD1NlY3RpZ28gTGltaXRlZDElMCMGA1UEAxMcU2VjdGlnbyBSU0EgVGlt

# ZSBTdGFtcGluZyBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMgb

# Aa/ZLH6ImX0BmD8gkL2cgCFUk7nPoD5T77NawHbWGgSlzkeDtevEzEk0y/NFZbn5

# p2QWJgn71TJSeS7JY8ITm7aGPwEFkmZvIavVcRB5h/RGKs3EWsnb111JTXJWD9zJ

# 41OYOioe/M5YSdO/8zm7uaQjQqzQFcN/nqJc1zjxFrJw06PE37PFcqwuCnf8DZRS

# t/wflXMkPQEovA8NT7ORAY5unSd1VdEXOzQhe5cBlK9/gM/REQpXhMl/VuC9RpyC

# vpSdv7QgsGB+uE31DT/b0OqFjIpWcdEtlEzIjDzTFKKcvSb/01Mgx2Bpm1gKVPQF

# 5/0xrPnIhRfHuCkZpCkvRuPd25Ffnz82Pg4wZytGtzWvlr7aTGDMqLufDRTUGMQw

# mHSCIc9iVrUhcxIe/arKCFiHd6QV6xlV/9A5VC0m7kUaOm/N14Tw1/AoxU9kgwLU

# ++Le8bwCKPRt2ieKBtKWh97oaw7wW33pdmmTIBxKlyx3GSuTlZicl57rjsF4VsZE

# Jd8GEpoGLZ8DXv2DolNnyrH6jaFkyYiSWcuoRsDJ8qb/fVfbEnb6ikEk1Bv8cqUU

# otStQxykSYtBORQDHin6G6UirqXDTYLQjdprt9v3GEBXc/Bxo/tKfUU2wfeNgvq5

# yQ1TgH36tjlYMu9vGFCJ10+dM70atZ2h3pVBeqeDAgMBAAGjggFaMIIBVjAfBgNV

# HSMEGDAWgBRTeb9aqitKz1SA4dibwJ3ysgNmyzAdBgNVHQ4EFgQUGqH4YRkgD8NB

# d0UojtE1XwYSBFUwDgYDVR0PAQH/BAQDAgGGMBIGA1UdEwEB/wQIMAYBAf8CAQAw

# EwYDVR0lBAwwCgYIKwYBBQUHAwgwEQYDVR0gBAowCDAGBgRVHSAAMFAGA1UdHwRJ

# MEcwRaBDoEGGP2h0dHA6Ly9jcmwudXNlcnRydXN0LmNvbS9VU0VSVHJ1c3RSU0FD

# ZXJ0aWZpY2F0aW9uQXV0aG9yaXR5LmNybDB2BggrBgEFBQcBAQRqMGgwPwYIKwYB

# BQUHMAKGM2h0dHA6Ly9jcnQudXNlcnRydXN0LmNvbS9VU0VSVHJ1c3RSU0FBZGRU

# cnVzdENBLmNydDAlBggrBgEFBQcwAYYZaHR0cDovL29jc3AudXNlcnRydXN0LmNv

# bTANBgkqhkiG9w0BAQwFAAOCAgEAbVSBpTNdFuG1U4GRdd8DejILLSWEEbKw2yp9

# KgX1vDsn9FqguUlZkClsYcu1UNviffmfAO9Aw63T4uRW+VhBz/FC5RB9/7B0H4/G

# XAn5M17qoBwmWFzztBEP1dXD4rzVWHi/SHbhRGdtj7BDEA+N5Pk4Yr8TAcWFo0zF

# zLJTMJWk1vSWVgi4zVx/AZa+clJqO0I3fBZ4OZOTlJux3LJtQW1nzclvkD1/RXLB

# GyPWwlWEZuSzxWYG9vPWS16toytCiiGS/qhvWiVwYoFzY16gu9jc10rTPa+DBjgS

# HSSHLeT8AtY+dwS8BDa153fLnC6NIxi5o8JHHfBd1qFzVwVomqfJN2Udvuq82EKD

# QwWli6YJ/9GhlKZOqj0J9QVst9JkWtgqIsJLnfE5XkzeSD2bNJaaCV+O/fexUpHO

# P4n2HKG1qXUfcb9bQ11lPVCBbqvw0NP8srMftpmWJvQ8eYtcZMzN7iea5aDADHKH

# wW5NWtMe6vBE5jJvHOsXTpTDeGUgOw9Bqh/poUGd/rG4oGUqNODeqPk85sEwu8Cg

# Yyz8XBYAqNDEf+oRnR4GxqZtMl20OAkrSQeq/eww2vGnL8+3/frQo4TZJ577AWZ3

# uVYQ4SBuxq6x+ba6yDVdM3aO8XwgDCp3rrWiAoa6Ke60WgCxjKvj+QrJVF3UuWp0

# nr1IrpgwggcGMIIE7qADAgECAhA9GjVyMBWCYzDQE3F+gkEIMA0GCSqGSIb3DQEB

# DAUAMH0xCzAJBgNVBAYTAkdCMRswGQYDVQQIExJHcmVhdGVyIE1hbmNoZXN0ZXIx

# EDAOBgNVBAcTB1NhbGZvcmQxGDAWBgNVBAoTD1NlY3RpZ28gTGltaXRlZDElMCMG

# A1UEAxMcU2VjdGlnbyBSU0EgVGltZSBTdGFtcGluZyBDQTAeFw0xOTA1MDIwMDAw

# MDBaFw0zMDA4MDEyMzU5NTlaMIGEMQswCQYDVQQGEwJHQjEbMBkGA1UECAwSR3Jl

# YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRgwFgYDVQQKDA9TZWN0

# aWdvIExpbWl0ZWQxLDAqBgNVBAMMI1NlY3RpZ28gUlNBIFRpbWUgU3RhbXBpbmcg

# U2lnbmVyICMxMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAy1FQ/1b+

# /HhjcAGTWp4Y9DtT9gevIWz1og99HXAthHRIi5yKlQU9WYT5kYB5USzZirfBC5q6

# CorNZk8DiwG7MMqrvdvATxJe/ArM4kWwATiKu03n1BxUmO05WM9bwi9FmDEK+TU4

# uDEubbQeOXLhuCq+n4yMGqVGrgsrTJn+LEv8KLkiOmYX0KpWiiHA85YktNCFJmu6

# 8G9kmHmmrb1c2FNrKwrWcoqFRuMNGAbaxntBVjabFT7xahGg92b1GNCAVWOHaGbr

# DnlVglyj7Um4cYaekzewa6PqYmyjrpbouf2Lq8b2WVsAPFcgGC1wA6ec75LreaHH

# Xex8tI9L3+td/KMg3ZI45WpROmuFnEygmAhpWwbnKhnQlZOLO2uKBQkp2Nba2+Ny

# +lxKL3sVVoYyv38FCZ0tKs9Q4eZhINvHBoBcThRGvq5XcaKqbDCTHH53ywbpV82R

# 9dUzchzh2spu6/MP7Hlbuyee6B7+L/K7f+nl0GfruA18pCtZA4uV7SIozfosO8cW

# Ea/j1rFQZ2nFjvV50K3/h8z4f6r5ou1h+MiNadqx9FGR62dX0WQR62TLA71JVTpF

# QxgsJWzRLwwtb/VBNSSg8mNZFl/ZpOksTtu7MRLGbfhbbgPcyxWPG41y7NsPFZDW

# Ek7u4gAxJZM1b2pbpRJjQAGKuWmIOoi4DxkCAwEAAaOCAXgwggF0MB8GA1UdIwQY

# MBaAFBqh+GEZIA/DQXdFKI7RNV8GEgRVMB0GA1UdDgQWBBRvTYYH2DInniwp0tAT

# A4CB3QWDKTAOBgNVHQ8BAf8EBAMCBsAwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8E

# DDAKBggrBgEFBQcDCDBABgNVHSAEOTA3MDUGDCsGAQQBsjEBAgEDCDAlMCMGCCsG

# AQUFBwIBFhdodHRwczovL3NlY3RpZ28uY29tL0NQUzBEBgNVHR8EPTA7MDmgN6A1

# hjNodHRwOi8vY3JsLnNlY3RpZ28uY29tL1NlY3RpZ29SU0FUaW1lU3RhbXBpbmdD

# QS5jcmwwdAYIKwYBBQUHAQEEaDBmMD8GCCsGAQUFBzAChjNodHRwOi8vY3J0LnNl

# Y3RpZ28uY29tL1NlY3RpZ29SU0FUaW1lU3RhbXBpbmdDQS5jcnQwIwYIKwYBBQUH

# MAGGF2h0dHA6Ly9vY3NwLnNlY3RpZ28uY29tMA0GCSqGSIb3DQEBDAUAA4ICAQDA

# aO2z2NRQm+/TdcsPO/ck03o3RY0s7xb7UaksH7UltYqfXQvCGyB0jWYPNsuq9jYN

# D36PS0p0Q2WsDSr2Cu1rbcUJOO0AG/jl3KYKQAVH74TKCbxDZoO/n+3bjj3RQWSx

# cAItA1dbGG8cLMsesgDougkvW4EENbmpY22OCMUY0eEhrPkSChTAEtt+JZ2sHRDA

# WqWD0h8aZlX8myri7DdXjuXfljD4wJMLQxj5Am+pUa+4VwrzHAdpOY83nG3Xka6l

# LknpSt6z0Iy/OZANwIHO8CoHOgymLVHScvNTxvm97+8MaUl3nyxWxOmhCD0HrsUe

# 1oQix7x9QxtYOGJO0QUlhMVC+B8v9tv6q4xU7EWKbBJNMFpS5aQXCSLm72/1X4ZD

# 36EtvUpGkqCBlixhl39Ab9g/jDVaq9HGoDuFZlSA7x8a9fGbsKEnfbLnC8/2LZxY

# E5SphvxFUqIobX90D1KRSXrpEvipO7CS/X2RFOlbbUiU8siW7gU4s8XsMD/hByAE

# sdiLvP2zPm/yAlMG9KDtyZpyo5dfAPvLY9DozXT9dcnUNkW6exJZcu3n8npQAHj4

# Q5pG2N+/VNRescfRvBuD9CvnC+hHyFOezBqs9vqKdVNsIIWp1bhquiSOiisIkZ83

# BBz2b6LdNKqR/8YVLh5CGgkpT/TGzeKRotNADI544zGCBYEwggV9AgEBMIGQMHwx

# CzAJBgNVBAYTAlVTMQswCQYDVQQIEwJNSTESMBAGA1UEBxMJQW5uIEFyYm9yMRIw

# EAYDVQQKEwlJbnRlcm5ldDIxETAPBgNVBAsTCEluQ29tbW9uMSUwIwYDVQQDExxJ

# bkNvbW1vbiBSU0EgQ29kZSBTaWduaW5nIENBAhByTV4gE9XCkUBV83xUiVRxMAkG

# BSsOAwIaBQCgeDAYBgorBgEEAYI3AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJ

# AzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMCMG

# CSqGSIb3DQEJBDEWBBSpEMge7Q0cOM5HeKOhk1a9MZIIwzANBgkqhkiG9w0BAQEF

# AASCAQAH1IFZfhLDYUzzYafbj2jhKmAnX2YlAt5fbCisDgrsEpxkjThMQBjO3irp

# d/qtTPi1IjQNyoJ2gNHVuwt4EvriDnHRYKYQg+rwbxBwgxWXlvxV+XtyPQWtWHdk

# f3CdODumf4KrYqgn7UV6nvbWDY8ERiWEVrj4DQuViksyL3ZXMm4YrT3CN11VX2Kx

# 0OMQIkXesoha6qjY+IYj0q/AyQfEHeFL/Q7rlJMH1c+7qiKAOR+Cb4+0+MM7/UB1

# 99vU8czi2nUAHzszRfmU79WezNB5Ub0NK/HtDES2nrNpKQ3ZXp3okBgt+G4He6LP

# pANX8DQ990hYrQE7rWTrijOfNDaPoYIDSzCCA0cGCSqGSIb3DQEJBjGCAzgwggM0

# AgEBMIGRMH0xCzAJBgNVBAYTAkdCMRswGQYDVQQIExJHcmVhdGVyIE1hbmNoZXN0

# ZXIxEDAOBgNVBAcTB1NhbGZvcmQxGDAWBgNVBAoTD1NlY3RpZ28gTGltaXRlZDEl

# MCMGA1UEAxMcU2VjdGlnbyBSU0EgVGltZSBTdGFtcGluZyBDQQIQPRo1cjAVgmMw

# 0BNxfoJBCDANBglghkgBZQMEAgIFAKB5MBgGCSqGSIb3DQEJAzELBgkqhkiG9w0B

# BwEwHAYJKoZIhvcNAQkFMQ8XDTIwMDYxNTIwMDUzNlowPwYJKoZIhvcNAQkEMTIE

# MAiajy+urbNucGEjjpmKgRwpuktvkc0UafTK646GJS5sMTEbighGhLfJ5EQLEsBq

# KjANBgkqhkiG9w0BAQEFAASCAgCgcPjKp9yf0X3ScLIgXa8YzppmM+dnLu9GzFA8

# /Cpu1+Akp4Axi1pcs6GF3Y3zJLzK6DF5ZNIreLETbDvVYVIdr3w2iTBI0NlSgEY/

# elDsVOlYagcD+gns9eVVmlu/mWzY32la4SOiHO9MMbbJKJd5NFfk9a48AOrMOfjb

# v7s+aCavEL5DvjLMGS2iHNQiL9HeAZXzuooKOYpDg67UNQuk3mJlPSoqJmFqIkPd

# vg6ETi4zbGrBDg0Hptfe2hdJlr3ViaRcvWTNKw2FZyKTyV9126lnnYzPSW7TfBnp

# M9lq4J/iWpv9QCyu/Y0Y14KpbzCJVfejZ2LFgLfuXoD5Qyt4KGriu8C73oHTBHiu

# HZXB/XTyrV5NqMBW+EXt/04l8z4JwJIjMSTXy7qMfYiB7bm1lPO4wbD3GU7d1VJd

# 5fbm4piQlS9wMh5QUazaQabXwfy3PdsdjS+buf7rs4q85t45KD9YORx9KjVnzvPK

# 8V6wQbqfJgSPvv0Pp9aAWDgfTUsokJKB2gO5G0ZMgsmld4WZU/l4kKMNzlBQa0A5

# /IJ4ADr7b1S4XFeKYJTlKuaA7X1vlHKpdiJRgCxr6mq6H/Z3KxjAyzvbweWLo43w

# 8a0j1ehkSK7X82NUd8OeuCPkBS/gZoH7zd6j+oanmUC6WL6wzrXyYUFevpQR034D

# hvAZtg==

# SIG # End signature block