Public/SC_Rules.ps1

<#
.SYNOPSIS
    Read existing SEPPMAIL.cloud transport rules in the exchange online environment.
.DESCRIPTION
    Use this to figure out if there are already SEPPMAIL.cloud rules implemented in Exchange online.
    It is only emitting installed rules which come with the seppmail365cloud PowerShell Module.
    If you want to be informed about all installed transport rules, use New-SC365ExoReport.
.EXAMPLE
    Get-SC365Rules
     
    Displays all SEPPMAIL.cloud transport rules in the tenant.
    Shows rule name, priority, state, and included domains.
    Only returns rules matching the [SEPPMAIL.cloud]* pattern.
.EXAMPLE
    Get-SC365Rules | Format-Table Identity, Priority, State
     
    Displays SEPPMAIL.cloud rules in a table format.
    Shows only Identity, Priority, and State columns.
    Useful for quick overview of rule configuration.
.EXAMPLE
    Get-SC365Rules | Where-Object {$_.State -eq 'Enabled'}
     
    Filters and displays only enabled SEPPMAIL.cloud rules.
    Helps identify which rules are currently active.
    Useful for troubleshooting mail flow issues.
.EXAMPLE
    Get-SC365Rules | Export-Csv -Path "C:\Temp\SEPPMAIL-Rules.csv" -NoTypeInformation
     
    Exports all SEPPMAIL.cloud rules to a CSV file.
    Useful for documentation and backup purposes.
    Allows comparison of configurations before and after changes.
#>

function Get-SC365Rules {
    [CmdletBinding(
        # HelpURI = 'https://github.com/seppmail/SEPPMAIL365cloud/blob/main/README.md#setup-the-integration'
    )]
    param
    (

    )

    begin {
        if (!(Test-SC365ExoConnStatus))
        { 
            throw [System.Exception] "You're not connected to Exchange Online - please connect prior to using this CmdLet" 
        }
        else 
        {
            Write-Verbose "Connected to Exchange Organization `"$Script:ExODefaultDomain`"" -InformationAction Continue
        }
        #if ($routing -eq 'p') {$routing = 'parallel'}
        #if ($routing -eq 'i') {$routing = 'inline'}
        #$transportRuleFiles = Get-Childitem "$psscriptroot\..\ExOConfig\Rules\"
    }
    process {
        #foreach ($file in $transportRuleFiles) {
        $allSEPPMAILCloudRules = Get-TransportRule -Identity '[SEPPMAIL*'
             if ($allSEPPMAILCloudRules) {
                Foreach ($rule in $allSEPPMAILCloudRules) {
                    if ($rule) {
                        $rule.PSObject.TypeNames.Insert(0, "SEPPMAIL.cloud.Rules")
                        if ($rule.Identity -like '*100*') {
                            $rule | Add-Member -MemberType NoteProperty -Name IncludedDomains -Value $rule.RecipientDomainIs
                            #$rule|Select-Object Identity,Priority,State,@{Name = 'IncludedDomains'; Expression={$_.RecipientDomainIs}}
                        }
                        if ($rule.Identity -like '*200*') {
                            $rule | Add-Member -MemberType NoteProperty -Name IncludedDomains -Value $rule.SenderDomainDomainIs
                            #$rule|Select-Object Identity,Priority,State,@{Name = 'IncludedDomains'; Expression={$_.SenderDomainIs}}
                        }
                        $rule | Add-Member -MemberType NoteProperty -Name 'SC365ModuleVersion' -Value (Get-SC365moduleVersion $($rule.comments))
                        $rule
                    }
                }
            }
            else {
                Write-Warning "No transport rules found matching [SEPPMAIL.Cloud]* in your tenant."
            }
    }
    end {

    }
}

<#
.SYNOPSIS
    Create SEPPMAIL.cloud transport rules for inline or parallel routing.
.DESCRIPTION
    Creates all necessary transport rules in Exchange Online to send e-mails through seppmail.cloud for cryptographic processing.
.PARAMETER PlacementPriority
    Place the rule group before (Top) or after (Bottom) existing non-SEPPMAIL rules.
    Default: Bottom. The relative order within the cloud rule group is preserved.
.PARAMETER routing
    Required routing mode: parallel (p) when MX records point to Microsoft,
    or inline (i) when MX records point to SEPPMAIL.cloud.
.PARAMETER SEPPMAILCloudDomain
    Required array of accepted domains booked for SEPPMAIL.cloud. These domains are
    applied to the inbound recipient and outbound sender domain conditions.
    onmicrosoft.com domains are filtered out before rule creation.
.PARAMETER SCLInboundValue
    Spam Confidence Level exception for the main inbound rule (ExceptIfSCLOver).
    Default: 5 from the rule template. Accepted values: -1, 0, 5, 6, 8, 9.
    Other routing rules may have their own conditions; this is not a global spam threshold.
.PARAMETER CryptoContentOnly
    Boolean, default $true. Adds content-type and PGP detection conditions to the
    corresponding inbound rules. With $false, these extra conditions are not added;
    other template conditions and exceptions still apply.
.PARAMETER Disabled
    Create the rules disabled so an administrator can review them before enabling.
    Rule creation normally requires an existing, enabled SEPPMAIL.cloud outbound connector.
.PARAMETER WhatIf
    Preview guarded rule removals and creation without performing them. Connection,
    domain and configuration checks still run; custom interactive prompts may still appear.
.PARAMETER Confirm
    Request confirmation for guarded operations. -Confirm:$false suppresses these
    confirmations, but not custom prompts about replacing existing rules.
.EXAMPLE
    New-SC365Rules -SEPPMAILCloudDomain 'contoso.eu','contoso.com' -routing inline
     
    Creates transport rules for multiple domains in inline routing mode.
    Only emails for specified domains are processed by SEPPMAIL.cloud.
    MX records must point to SEPPMAIL.cloud for this configuration.
.EXAMPLE
    New-SC365Rules -SEPPMAILCloudDomain 'contoso.eu' -PlacementPriority Top -routing parallel
     
    Creates rules with highest priority (before all other rules).
    Useful when SEPPMAIL.cloud rules must execute before other transport rules.
    Not recommended unless required by specific mail flow scenarios.
.EXAMPLE
    New-SC365Rules -SEPPMAILCloudDomain 'contoso.eu' -routing parallel -disabled
     
    Creates transport rules in disabled state for testing.
    Allows review and validation before activating mail flow.
    Rules must be manually enabled after creation.
.EXAMPLE
    New-SC365Rules -SEPPMAILCloudDomain 'contoso.eu' -routing parallel -CryptoContentOnly:$false
     
    Omits the extra cryptographic content conditions on the corresponding inbound rules.
    Other conditions and exceptions in the rule templates still apply.
.EXAMPLE
    New-SC365Rules -SEPPMAILCloudDomain 'contoso.com' -routing inline -SCLInboundValue 6
     
    Creates rules with custom Spam Confidence Level (SCL) threshold.
    Sets ExceptIfSCLOver to 6 on the main inbound routing rule.
    Other routing rules are not changed by this parameter.
.EXAMPLE
    New-SC365Rules -SEPPMAILCloudDomain 'contoso.de' -routing parallel -PlacementPriority Bottom
     
    Places SEPPMAIL.cloud rules after all existing transport rules.
    Recommended default to avoid conflicts with existing mail flow.
    Ensures other rules execute first.
.EXAMPLE
    New-SC365Rules -SEPPMAILCloudDomain 'contoso.eu' -routing parallel -WhatIf
 
    Previews guarded rule operations while still reading tenant configuration.
.EXAMPLE
    New-SC365Rules -SEPPMAILCloudDomain 'contoso.eu' -routing parallel -Confirm
 
    Requests confirmation for guarded operations. Existing-rule prompts can also appear.
.INPUTS
    none
.OUTPUTS
    transport rules
.NOTES
     
#>

function New-SC365Rules
{
    [CmdletBinding(
        SupportsShouldProcess = $true,
        ConfirmImpact = 'Medium'
        # HelpURI = 'https://github.com/seppmail/SEPPMAIL365cloud/blob/main/README.md#setup-the-integration'
        )
    ]
    param
    (
        [Parameter(Mandatory = $false,
            HelpMessage = 'Should the new rules be placed before or after existing ones (if any)')]
        [ValidateSet('Top', 'Bottom')]
        [String] $PlacementPriority = 'Bottom',

        [Parameter(
            Mandatory = $true,
            HelpMessage = 'MX record->SEPPMAIL means routingtype inline, MX->Microsoft means routingtype parallel'
        )]
        [ValidateSet('parallel', 'inline', 'p', 'i')]
        [String]$routing,

        [Parameter(Mandatory = $true,
            HelpMessage = 'e-mail domains you have registered in the SEPPMAIL.Cloud')]
        [String[]]$SEPPMAILCloudDomain,

        [Parameter(Mandatory = $false,
            HelpMessage = 'SCL Value for inbound Mails which should NOT be processed by SEPPMAIL.Cloud. Default is 5')]
        [ValidateSet('-1', '0', '5', '6', '8', '9')]
        [int]$SCLInboundValue = 5,

        [Parameter(
              Mandatory = $false,
            HelpMessage = 'Rule 100 will only send e-mails to SEPPMAIL.cloud which requires cryptographic processing'
        )]
        [bool]$CryptoContentOnly = $true,

        [Parameter(
            Mandatory = $false,
            HelpMessage = 'Add rules if you provisioned internal e-mail signature in the SEPPMAIL.cloud Service'
        )]
        [switch]$Disabled
    )

    begin
    {
        if (!(Test-SC365ExoConnStatus)) { 
            throw [System.Exception] "You're not connected to Exchange Online - please connect prior to using this CmdLet" 
        } else {
            Write-Verbose "Connected to Exchange Organization `"$Script:ExODefaultDomain`" " 
        }

        if ($routing -eq 'p') {$routing = 'parallel'}
        if ($routing -eq 'i') {$routing = 'inline'}

        foreach ($validationDomain in $SEPPMAILCloudDomain) {
            if ((Confirm-SC365TenantDefaultDomain -ValidationDomain $validationDomain) -eq $true) {
                Write-verbose "Domain is part of the tenant and the Default Domain"
            } else {
                if ((Confirm-SC365TenantDefaultDomain -ValidationDomain $validationDomain) -eq $false) {
                    Write-verbose "Domain is part of the tenant"
                } else {
                    Write-Error "Domain is NOT Part of the tenant"
                    break
                }
            }
        }
 
        # Filter onmicrosoft domains and define Domain List for TransportRule Rule-Config
        try {
            $FilteredCloudDomain = Remove-SC365OnMicrosoftDomain -DomainList $SEPPMAILCloudDomain
        } catch {
            Write-Warning "Could not remove onMicrosoft.com domains from DomainList for further processing"
            $FilteredCloudDomain = $SEPPMAILCloudDomain
        }

        $outboundConnectors = Get-OutboundConnector -IncludeTestModeConnectors $true | Where-Object { $_.Name -match "^\[SEPPMAIL.cloud\]" }
        if ($PSCmdlet.ShouldProcess('Exchange Online', "Check existence of Outbound Connector")) {
            if(!($outboundConnectors))
            {
                throw [System.Exception] "No SEPPMAIL.cloud outbound connector found. InBoundOnly Mode ? Run `"New-SC365Connectors`" to add the proper SEPPMAIL.cloud connectors"
            }
            if ($($outboundConnectors.Enabled) -ne $true) {
                throw [System.Exception] "SEPPMAIL.cloud outbound-connector is disabled, cannot create rules. Create connectors without -Disable switch, or enable them in the admin portal."
            }    
        }
    }

    process
    {
        try
        {
            Write-Verbose "Read all `"non-[SEPPMAIL`" transport rules"
            $existingTransportRules = Get-TransportRule | Where-Object Name -NotMatch '\[SEPPMAIL*'
            [int] $placementPrio = @(0, $existingTransportRules.Count)[!($PlacementPriority -eq "Top")] #Poor man's ternary operator
            Write-Verbose "Placement priority is $placementPrio"

            Write-Verbose "Read existing [SEPPMAIL.cloud] transport rules"
            $existingSMCTransportRules = Get-TransportRule | Where-Object Name -Match '\[SEPPMAIL*'
            [bool] $createRules = $true
            if ($existingSMCTransportRules)
            {
                if($InteractiveSession)
                {
                    Write-Warning 'Found existing [SEPPMAIL* transport rules.'
                    Write-Warning '--------------------------------------------'
                    foreach ($eSMCtpr in $existingSMCTransportRules) {
                        Write-Warning "Rule name `"$($eSMCtpr.Name)`" with state `"$($eSMCtpr.State)`" has priority `"$($eSMCtpr.Priority)`""
                    }
                    Write-Warning '--------------------------------------------'
                    Do {
                        try {
                            [ValidateSet('y', 'Y', 'n', 'N')]$recreateSMRules = Read-Host -Prompt "Shall we delete and recreate them ? (Y/N)"
                        }
                        catch {}
                    }
                    until ($?)
                    if ($recreateSMRules -like 'y') {
                        $existingSMCTransportRules|ForEach-Object {
                            if ($PSCmdlet.ShouldProcess($_.Name, "Removing transport rule")) {
                                Remove-TransportRule -Identity $_.Identity -Confirm:$false
                            }
                        }
                    }
                    else {
                        $createRules = $false
                    }
                }
                else
                {
                    throw [System.Exception] "SEPPMAIL* transport rules already exist"
                }
            }

            if($createRules){
               
                $transportRuleFiles = Get-ChildItem -Path "$psScriptRoot\..\ExOConfig\SC_Rules\"

                $moduleVersion = $myInvocation.MyCommand.Version
                # Calculated SMPriority for the transport rules - removes requirement of coding this into JSON Files
                [int]$countedSMPrio = -1
                foreach($file in $transportRuleFiles) {
                    $setting = Get-SC365TransportRuleSettings -File $file -Routing $routing
                    if ($setting.Values) {
                        $countedSMPrio++
                        Write-Verbose "Calculating TR-priority by adding placement prio $placementPrio and ordered prio from SEPPMAIL $($setting.SMPriority)"
                        $setting.Priority = $placementPrio + $countedSMPrio
                        Write-Verbose "Transport Rule priority will be: $($setting.Priority)"
                        if ($Disabled -eq $true) {$setting.Enabled = $false}

                        $Now = Get-Date
                        Write-Verbose "Adding Timestamp $now to Comment"
                        $setting.Comments += "`nCreated with SEPPMAIL365cloud PowerShell Module version $moduleVersion on $now"

                        if ($PSCmdlet.ShouldProcess($setting.Name, "Create transport rule"))
                        {
                            switch ($setting.Name)
                            {
                                "[SEPPMAIL.cloud] - 060 Add header X-SM-ruleversion" {
                                    Write-Verbose "Add rule version $moduleVersion"
                                    $Setting.SetHeaderValue = $moduleVersion.ToString()
                                    New-TransportRule @setting #|Out-Null
                                }
                                "[SEPPMAIL.cloud] - 100 Route incoming e-mails to SEPPMAIL" {
                                    Write-Verbose "Including all managed domains $FilteredCloudDomain"
                                    $Setting.RecipientDomainIs = $FilteredCloudDomain
                                    if ($SCLInboundValue -ne 5) {
                                        Write-Verbose "Setting Value $SCLInboundValue to Inbound flowing to SEPPMAIL.cloud"
                                        $Setting.ExceptIfSCLOver = $SCLInboundValue
                                    }
                                    if ($cryptoContentOnly) {
                                        Write-Verbose 'Adding Setting to send only cryptographic needed e-mails to SEPPMAIL.cloud'
                                        $Setting.HeaderContainsMessageHeader = 'content-type'
                                        $Setting.HeaderContainsWords = "application/x-pkcs7-mime","application/pkcs7-mime","application/x-pkcs7-signature","application/pkcs7-signature","multipart/signed","application/pgp-signature","multipart/encrypted","application/pgp-encrypted","application/octet-stream"
                                    }
                                    New-TransportRule @setting #|Out-Null
                                }
                                "[SEPPMAIL.cloud] - 110 Route incoming PGP e-mails to SEPPMAIL" {
                                    Write-Verbose "Including all managed domains $FilteredCloudDomain"
                                    $Setting.RecipientDomainIs = $FilteredCloudDomain
                                    if ($cryptoContentOnly) {
                                        $setting.SubjectOrBodyContainsWords += '-----BEGIN PGP'
                                    }
                                    New-TransportRule @setting #|Out-Null
                                }
                                "[SEPPMAIL.cloud] - 120 Route incoming tagged e-mails to SEPPMAIL" {
                                    Write-Verbose "Including all managed domains $FilteredCloudDomain"
                                    $Setting.RecipientDomainIs = $FilteredCloudDomain
                                    New-TransportRule @setting #|Out-Null
                                }                                
                                "[SEPPMAIL.cloud] - 200 Route outgoing e-mails to SEPPMAIL" {
                                    Write-Verbose "Including only Outbound e-mails from domains $FilteredCloudDomain"
                                    $Setting.SenderDomainIs = $FilteredCloudDomain
                                    New-TransportRule @setting #|Out-Null
                                }
                                Default {
                                    New-TransportRule @setting #|Out-Null
                                }
                            }                        
                        }    
                    }
                # Get-TransportRule -Identity $Setting.Name|Select-Object Identity,Priority,State ## Unfinished
                }
            }
        }
        catch {
            throw [System.Exception] "Error: $($_.Exception.Message)"
        }
    }
    end
    {

    }
}

<#
.SYNOPSIS
    Removes the SEPPMAIL.cloud transport rules
.DESCRIPTION
    Convenience function to remove the SEPPMAIL.cloud rules in one CmdLet.
    Matches only on "[SEPPMAIL.cloud]*"
.PARAMETER WhatIf
    Preview removal of all matching cloud rules without deleting them.
    Connection checks and rule discovery still run.
.PARAMETER Confirm
    Request confirmation for each rule removal. The function has High confirmation
    impact, so confirmation is normally requested with the default preference.
    Use -Confirm:$false only after reviewing the affected rules.
.EXAMPLE
    Remove-SC365Rules
     
    Removes all SEPPMAIL.cloud transport rules from Exchange Online.
    Requires confirmation due to high impact setting.
    Only removes rules matching the [SEPPMAIL.cloud]* pattern.
.EXAMPLE
    Remove-SC365Rules -Confirm:$false
     
    Removes all SEPPMAIL.cloud rules without confirmation prompt.
    Use with caution - rules are deleted immediately.
    Suitable for automation scripts with proper testing.
.EXAMPLE
    Remove-SC365Rules -WhatIf
     
    Shows what rules would be removed without actually deleting them.
    Useful for verification before actual removal.
    Displays all SEPPMAIL.cloud rules that would be affected.
.EXAMPLE
    Remove-SC365Rules -Confirm
     
    Explicitly requests confirmation for each matching rule.
    This function does not accept pipeline input; it discovers all matching rules itself.
.INPUTS
    None.
#>

function Remove-SC365Rules {
    [CmdletBinding(SupportsShouldProcess = $true,
                   ConfirmImpact = 'High'
                   # HelpURI = 'https://github.com/seppmail/SEPPMAIL365cloud/blob/main/README.md#setup-the-integration'
                  )]
    param
    (
    )

    begin {
        if (!(Test-SC365ExoConnStatus))
        { 
            throw [System.Exception] "You're not connected to Exchange Online - please connect prior to using this CmdLet" 
        } else {
            Write-Verbose "Connected to Exchange Organization `"$Script:ExODefaultDomain`" " 
        }
    }
    process {
        Write-Verbose "Removing current version module rules"
        $allSEPPMAILCloudRules = Get-TransportRule -Identity '[SEPPMAIL.cloud]*' -ErrorAction 0
        if ($allSEPPMAILCloudRules.count -ge 1) {
            foreach ($rule in $allSEPPMAILCloudRules) {
                if($PSCmdlet.ShouldProcess($rule.Name, "Remove transport rule")) {
                    Remove-TransportRule -Identity $rule -confirm:$false
                }
            }
        } 
    }
    end {

    }
}

if (!(Get-Alias 'Set-SC365rules' -ErrorAction SilentlyContinue)) {
    New-Alias -Name Set-SC365Rules -Value New-SC365Rules
}

Register-ArgumentCompleter -CommandName New-SC365Rules -ParameterName SEPPMAILCloudDomain -ScriptBlock $paramDomSB

# SIG # Begin signature block
# MIIQVQYJKoZIhvcNAQcCoIIQRjCCEEICAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDGESJ7JP9w/nnS
# C5ERV+PWEIAkX1xaL7rpDOc5+fBFRaCCDJEwggYaMIIEAqADAgECAhBiHW0MUgGe
# O5B5FSCJIRwKMA0GCSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYDVQQK
# Ew9TZWN0aWdvIExpbWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENvZGUg
# U2lnbmluZyBSb290IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5NTla
# MFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzApBgNV
# BAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwggGiMA0GCSqG
# SIb3DQEBAQUAA4IBjwAwggGKAoIBgQCbK51T+jU/jmAGQ2rAz/V/9shTUxjIztNs
# fvxYB5UXeWUzCxEeAEZGbEN4QMgCsJLZUKhWThj/yPqy0iSZhXkZ6Pg2A2NVDgFi
# gOMYzB2OKhdqfWGVoYW3haT29PSTahYkwmMv0b/83nbeECbiMXhSOtbam+/36F09
# fy1tsB8je/RV0mIk8XL/tfCK6cPuYHE215wzrK0h1SWHTxPbPuYkRdkP05ZwmRmT
# nAO5/arnY83jeNzhP06ShdnRqtZlV59+8yv+KIhE5ILMqgOZYAENHNX9SJDm+qxp
# 4VqpB3MV/h53yl41aHU5pledi9lCBbH9JeIkNFICiVHNkRmq4TpxtwfvjsUedyz8
# rNyfQJy/aOs5b4s+ac7IH60B+Ja7TVM+EKv1WuTGwcLmoU3FpOFMbmPj8pz44MPZ
# 1f9+YEQIQty/NQd/2yGgW+ufflcZ/ZE9o1M7a5Jnqf2i2/uMSWymR8r2oQBMdlyh
# 2n5HirY4jKnFH/9gRvd+QOfdRrJZb1sCAwEAAaOCAWQwggFgMB8GA1UdIwQYMBaA
# FDLrkpr/NZZILyhAQnAgNpFcF4XmMB0GA1UdDgQWBBQPKssghyi47G9IritUpimq
# F6TNDDAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADATBgNVHSUE
# DDAKBggrBgEFBQcDAzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEsGA1Ud
# HwREMEIwQKA+oDyGOmh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1Ymxp
# Y0NvZGVTaWduaW5nUm9vdFI0Ni5jcmwwewYIKwYBBQUHAQEEbzBtMEYGCCsGAQUF
# BzAChjpodHRwOi8vY3J0LnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2RlU2ln
# bmluZ1Jvb3RSNDYucDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0aWdv
# LmNvbTANBgkqhkiG9w0BAQwFAAOCAgEABv+C4XdjNm57oRUgmxP/BP6YdURhw1aV
# cdGRP4Wh60BAscjW4HL9hcpkOTz5jUug2oeunbYAowbFC2AKK+cMcXIBD0ZdOaWT
# syNyBBsMLHqafvIhrCymlaS98+QpoBCyKppP0OcxYEdU0hpsaqBBIZOtBajjcw5+
# w/KeFvPYfLF/ldYpmlG+vd0xqlqd099iChnyIMvY5HexjO2AmtsbpVn0OhNcWbWD
# RF/3sBp6fWXhz7DcML4iTAWS+MVXeNLj1lJziVKEoroGs9Mlizg0bUMbOalOhOfC
# ipnx8CaLZeVme5yELg09Jlo8BMe80jO37PU8ejfkP9/uPak7VLwELKxAMcJszkye
# iaerlphwoKx1uHRzNyE6bxuSKcutisqmKL5OTunAvtONEoteSiabkPVSZ2z76mKn
# zAfZxCl/3dq3dUNw4rg3sTCggkHSRqTqlLMS7gjrhTqBmzu1L90Y1KWN/Y5JKdGv
# spbOrTfOXyXvmPL6E52z1NZJ6ctuMFBQZH3pwWvqURR8AgQdULUvrxjUYbHHj95E
# jza63zdrEcxWLDX6xWls/GDnVNueKjWUH3fTv1Y8Wdho698YADR7TNx8X8z2Bev6
# SivBBOHY+uqiirZtg0y9ShQoPzmCcn63Syatatvx157YK9hlcPmVoa1oDE5/L9Uo
# 2bC5a4CH2RwwggZvMIIE16ADAgECAhBIqMP3CCLHOHtOKuaWNyeFMA0GCSqGSIb3
# DQEBDAUAMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQx
# KzApBgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwHhcN
# MjYwNDE1MDAwMDAwWhcNMjcwNzE0MjM1OTU5WjBmMQswCQYDVQQGEwJERTEPMA0G
# A1UECAwGQmF5ZXJuMSIwIAYDVQQKDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJI
# MSIwIAYDVQQDDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJIMIICIjANBgkqhkiG
# 9w0BAQEFAAOCAg8AMIICCgKCAgEAvAFzE8MbJpvQt+IdIh1M+bKYsJBFDk4b9ySe
# 25IrCi00B9o5XmQtIw42MqyIKbUq1tDARtp9KTQedEP9W+rflAF2l+0Z046Jkiqu
# mU9/enbqWLDyln1aS/p7HOgwZFMhnsR9zH0MfFckiklUmkzJO+vmzYAK7ZmDxajN
# LJs0gkGRU2/BecAx/TSvLXMaKONsKZCyMKQCnwo1mCY/tFl5EgUz7YQFrPORBQGf
# Qke/hkdBfQDqNRsi/J6+KhJWc6LvgQihdRg/INQbQsTxlow18NWvyFsjjueH7kG6
# HR4YKfbv07xgrsIh8xvq9ZJ1SBhLXmkg4SdoQGASjqR6o3keAX+bDRFf+hmlWWJp
# /FqVHR5QomF3vbK2/bbz4jAclYSPx/sPasNJ0YnKFkgmowZ7Ysa0KA0/egBgtI4g
# J+8V7zrqIVEG3rMQh9KCdMnJqP2aM9o4gUzQvE1M4x606liX9EWwdLLS+fe79o+F
# zo5oH4wBE/En6hQQkzseHHu+TXCDd6zUUZ/PlTK0gTaDIRXt6UzPNqJ4RiRCW2pN
# FcPt078qqVTuwKUXoE4ufxGgXKFrZlCYST/9eG1TnW2oq19nz8A333GCsL3gpoNI
# KvfmDyGMMNzvx2aeqn2v6e75z8kH19iGSNZ51xT+WgS9F1aIvjz08/T7XAv7iDPF
# 1/gPIp8CAwEAAaOCAakwggGlMB8GA1UdIwQYMBaAFA8qyyCHKLjsb0iuK1SmKaoX
# pM0MMB0GA1UdDgQWBBS30/Tq+alF3j2BY5up8n5zpAU23DAOBgNVHQ8BAf8EBAMC
# B4AwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcDAzBKBgNVHSAEQzBB
# MDUGDCsGAQQBsjEBAgEDAjAlMCMGCCsGAQUFBwIBFhdodHRwczovL3NlY3RpZ28u
# Y29tL0NQUzAIBgZngQwBBAEwSQYDVR0fBEIwQDA+oDygOoY4aHR0cDovL2NybC5z
# ZWN0aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdDQVIzNi5jcmwweQYI
# KwYBBQUHAQEEbTBrMEQGCCsGAQUFBzAChjhodHRwOi8vY3J0LnNlY3RpZ28uY29t
# L1NlY3RpZ29QdWJsaWNDb2RlU2lnbmluZ0NBUjM2LmNydDAjBggrBgEFBQcwAYYX
# aHR0cDovL29jc3Auc2VjdGlnby5jb20wHgYDVR0RBBcwFYETc3VwcG9ydEBzZXBw
# bWFpbC5jaDANBgkqhkiG9w0BAQwFAAOCAYEAi7fmb5UYoemWG3CC4K2UZWVrR6GO
# fi8gbJKgjPbKO4zrCrU/x6cOdyp6scKZfUEGFDf8KH6pP4pAQv1Hsbi49gU2kxoU
# WLlCiipn05qJY663DHx9hlStej/ZdEatou0wyCDiG5xD7kmG+1t6iLyyCBgEB88t
# JpzTjI61qXmBTS/FGEOAsB4SDEW1ngA7bc5FOv4IUKA43hp8M+N3GeYFzDqwJELY
# EfVVYheBW3o7q4VrCdfFEuaQihOtvfDfYpP6ANgekNn8HdsMT8rx9D1I50Rli/qQ
# Fo2BOuPyb2SIQPzJvCs5wgi5qgp1nHiN6igumu2Cz7BmGjOazGUgCSUY5QwyE8+F
# +R2tVM+2O15rfX01+e56ZfojBEiEjMwfPHs3fa3V3gokWWNwUMkton/v0R/nl2zj
# mOr2okohOINZEDh9frg21zUCN5ZD8Y4zQWuiJLCvvvBZs0JR4c9xl2k2wtw/QLPh
# GU69zM3smGpRoLE8M6zvUvSU7jXjvefazUniMYIDGjCCAxYCAQEwaDBUMQswCQYD
# VQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSswKQYDVQQDEyJTZWN0
# aWdvIFB1YmxpYyBDb2RlIFNpZ25pbmcgQ0EgUjM2AhBIqMP3CCLHOHtOKuaWNyeF
# MA0GCWCGSAFlAwQCAQUAoIGEMBgGCisGAQQBgjcCAQwxCjAIoAKAAKECgAAwGQYJ
# KoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQB
# gjcCARUwLwYJKoZIhvcNAQkEMSIEIKWFfpZxFGUM3sqLlNMKzJD1LYn3up5QxrfK
# Zaw4i7BcMA0GCSqGSIb3DQEBAQUABIICAFBLRSmeZJKEgHLXF7GySEzX2PYSmf3G
# n70Z9g81jsI0678PtDUdwSSfTWb13nptGs7zcBs4n+o9paTGnVu9qdmcN8iJxl3u
# ahoCMJC1n6rw6UbYfHEDlj1uS0Y83zgbbqgg8s8CnH3oQZx4IYj1+MYxGpNAOs2s
# dNdp6Z2arjpUpjqzDyPUsCS+C4F3VbVR+mrTEexFWKHQLjNQCq7ebsXhPPRhRdbt
# 6npaMkylyFsgMyGWYyFYcDnLSedSjpRhsYOkcQ6aHH9WN6y7CZCjLBwceJ5aMJ5S
# 3nR9OxOXHUe4B7Bo1/vVmePFvCXGyMjVjzuW3316oUbiNqN1FywzccqaDztc5eGT
# 3X6CyJUJ7tZNvh3lwYGIx7wZcoO4qkc4zDCXb9U3tHTgzhD22dVOhnEuBPDaRwTn
# LnFSbDRaRr/a7IAVRXWecOrxbwySSS/BF8jI7SpJ8H0sHzxjSop9DJKj8Ne93aac
# jFsR70dH7Cp7+t3M578ypbc1EnAZiQA9nI43pWzXRNPInz9WCwCCWkq4oCevWNR8
# AcbR8njVN/JRzs/EBoLTiXOLTdkGgGKn7ZyCuZUyNmwSePFFLHqhyCpX2+tbs6FT
# 4z4lneq3UmF4wuJjyK/D0gM4JmbA+0kPoRIlVidEgpKOSa7NNRBfXXJ0bJlNvuIo
# vr2Jmv/A4nwJ
# SIG # End signature block