New-WSOneKerberosPrincipal

1.0

New-WSOneKerberosPrincipal.ps1


<#PSScriptInfo
 
.VERSION 1.0
 
.GUID 488749d5-d411-49bd-b313-7eb387eadad5
 
.AUTHOR es@it-pro-berlin.de
 
.COMPANYNAME metaBPA.org
 
.COPYRIGHT 2020 metaBPA.org | Evgenij Smirnov | @cj_berlin
 
.TAGS VMware WorkspaceONE Kerberos Active Directory
 
.LICENSEURI https://opensource.org/licenses/MIT
 
.PROJECTURI https://metabpa.org/projects/various-scripts/ws1-kerberos/
 
.ICONURI https://metabpa.org/wp-content/uploads/2019/11/metaBPA-150x150.ico
 
.EXTERNALMODULEDEPENDENCIES ActiveDirectory
 
.REQUIREDSCRIPTS
 
.EXTERNALSCRIPTDEPENDENCIES
 
.RELEASENOTES
Creates the Kerberos principal for a WorkspaceONE connector in single-, multi- and cross-domain scenarios.
 
.PRIVATEDATA
 
#>

#Requires -Module ActiveDirectory

<#
  
.DESCRIPTION
This script generates a correct KeyTab file for a WorkspaceONE connector.
 
For this, VMware provides a rudimentary script as described here:
https://techzone.vmware.com/deploying-premises-vmware-identity-manager-vmware-workspace-one-operational-tutorial
 
In a standard VMware scenario where the connector machine is a member of the only domain it will provide
Kerberos authentication against, this script works quite similarly to the original setupKerberos.ps1 but
with much more verbose logging and sanity checks built in.
 
In a multidomain or crossdomain scenario it will generate both correct KeyTab file and correct SPNs for the
principal in Active Directory.
 
As a small bonus, the user created by this script will have a UPN set and some descriptive features populated.
 
In order to run this script successfully, you need to complete the Kerberos configuration and deploy it to the connector.
This is needed to have the krb5.conf file which contains the information about domains beinmg served.
Run it elevated from a location of your choice on the connector machine. The log goes in %TEMP%, as does the
backup of krb5.conf and krb5.keytab
 
#> 
[CmdletBinding()]
Param(
    [Parameter(Mandatory=$false)][switch]$LogToConsole,
    [Parameter(Mandatory=$false)][switch]$AddEncryptionToConfig,
    [Parameter(Mandatory=$false)][switch]$BackupConfig,
    [Parameter(Mandatory=$false)][switch]$OverwriteExisting,
    [Parameter(Mandatory=$false)][int]$ReplicationTimeout = 60
)
#region constants
$ciphers = @('RC4-HMAC-NT','AES128-SHA1','AES256-SHA1')
$tkt_enc = 'arcfour-hmac-md5'
$minpwdlen_script = 15
$adusr = $null
#endregion
#region function definitions
function Write-ScriptLog {
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true)][string]$LogMessage,
        [Parameter(Mandatory=$false)][int]$Severity = 0,
        [Parameter(Mandatory=$false)][switch]$LogToConsole = $Script:LogToConsole
    )
    $logfile = Join-Path -Path $env:TEMP -ChildPath 'New-WSOneKerberosPrincipal.log'
    switch ($Severity) {
        0 {
            $sev = 'DEBUG'
            $col = 'Gray'
        }
        1 {
            $sev = 'INFO '
            $col = 'Green'
        }
        2 {
            $sev = 'WARN '
            $col = 'Yellow'
        }
        3 {
            $sev = 'ERROR'
            $col = 'Red'
        }
        default {
            $sev = 'OTHER'
            $col = 'Cyan'
        }
    }
    $dt = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
    $msg = ('{0} {1} {2}' -f $dt, $sev, $LogMessage)
    try {
        $msg | Add-Content -Path $logfile -Force -EA Stop
    } catch {
        Write-Warning ('Could not write log to {0}: {1}' -f $logfile, $_.Exception.Message)
    }
    if ($LogToConsole) {
        Write-Host $msg -ForegroundColor $col
    } else {
        switch ($Severity) {
            2 {
                Write-Warning $msg
            }
            3 {
                Write-Error $msg
            }
            default {
                Write-Verbose $msg
            }
        }
    }
}
function Import-KRB5ConfigFile {
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true)][string]$Path
    )
    if (Test-Path -Path $Path -PathType Leaf) {
        try {
            $lines = Get-Content -Path $Path -EA Stop
        } catch {
            return
        }
        $res = @{}
        $cursection = $null
        $curblock = $null
        foreach ($line in $lines) {
            switch -Regex ($line) {
                '^\s*#' {} # comment line
                '^\s*$' {} # empty line
                '^\s*\}\s*$' {
                    $curblock = $null
                }
                '\[(?<section>.*)\]' {
                    $cursection = $Matches['section']
                    $curblock = $null
                    try {
                        $res.Add($cursection,@{})
                    } catch {
                        Write-Warning $_.Exception.Message
                    }
                }
                '^\s*(?<key>\S*)\s*=\s*(?<value>\S*.*\S)\s*$' {
                    if ($Matches['value'] -eq '{') {
                        $curblock = $Matches['key']
                        try {
                            $res[$cursection].Add($curblock,@{})
                        } catch {
                            Write-Warning $_.Exception.Message
                        }
                    } else {
                        if ($null -eq $curblock) {
                            try {
                                $res[$cursection].Add($Matches['key'],$Matches['value'])
                            } catch {}
                        } else {
                            try {
                                $res[$cursection][$curblock].Add($Matches['key'],$Matches['value'])
                            } catch {
                                Write-Warning $_.Exception.Message
                            }
                        }
                    }
                }
            }
        }
        $res
    }
}
function Export-KRB5ConfigFile {
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true)][Object]$Config,
        [Parameter(Mandatory=$true)][string]$Path
    )
    if ($Config.GetType().Name -ne 'Hashtable') {
        Write-ScriptLog ('KRB5 Export: Config argument of a wrong type [{0}]' -f $Config.GetType().Name) -Severity 2
        return $false
    }
    $lines = @('#','# KRB5 config file for WorkspaceONE Access connector','# Initially generated by vIDM setup','# Modified by New-WSOneKerberosPrincipal.ps1','# Berlin 2020, https://metabpa.org @cj_berlin','#')
    $firstsection = $true
    foreach ($section in $Config.GetEnumerator()) {
        if ($firstsection) { 
            $firstsection = $false
        } else {
            $lines += ''
        }
        $lines += ('[{0}]' -f $section.Name)
        foreach($item in $Config[$section.Name].GetEnumerator()) {
            if ($item.Value.GetType().Name -ne 'Hashtable') {
                $lines += (' {0} = {1}' -f $item.Name, $item.Value)
            } else {
                $lines += (' {0} = {{' -f $item.Name)
                foreach ($parm in $item.Value.GetEnumerator()) {
                    $lines += (' {0} = {1}' -f $parm.Name, $parm.Value)
                }
                $lines += ' }'
            }
        }
    }
    try {
        $lines | Set-Content -Path $Path -Encoding UTF8 -Force -EA Stop
    } catch {
        Write-ScriptLog ('KRB5 Export: Error writing file {0}: {1}' -f $Path, $_.Exception.Message) -Severity 2
        return $false
    }
    return $true
}
#endregion
#region verifying prereqs
Write-ScriptLog -LogMessage '*** KERBEROS PRINCIPAL GENERATOR FOR WORKSPACEONE ***' -Severity 1
Write-ScriptLog -LogMessage ('Started as {0}\{1} on computer {2} from {3}' -f $env:USERDOMAIN, $env:USERNAME, $env:COMPUTERNAME, $PSScriptRoot) -Severity 1
Write-ScriptLog -LogMessage 'Verifying prerequisites for execution' -Severity 1
Write-ScriptLog -LogMessage 'Checking for elevated privileges...'
if (-not ([Security.Principal.WindowsPrincipal]([Security.Principal.WindowsIdentity]::GetCurrent())).IsInRole([Security.Principal.WindowsBuiltInRole]"Administrator")) {
    Write-ScriptLog -LogMessage 'This script needs to run elevated. Please open an elevated shell and re-run script.' -Severity 2
    return
}
Write-Verbose 'Looking up the service path of the IDM connector...'
$idmsvc = Get-CimInstance -ClassName 'Win32_Service' -Filter "Name='VMwareIDMConnector'"
if ($null -ne $idmsvc) {
    $svcexe = $idmsvc.PathName
    $idmpath = ($svcexe -split "\\oss\\")[0]
    if ($idmpath -eq $svcexe) {
        Write-ScriptLog -LogMessage ('Something is wrong with the installation path, it doesn''t seem to contain \oss\: {0}' -f $svcexe) -Severity 2
        return
    }
    Write-ScriptLog -LogMessage ('Service found, installed in {0}' -f $idmpath)
} else {
    Write-ScriptLog -LogMessage 'IDM connector service is not installed on this machine!' -Severity 2
    return
}
$confpath = Join-Path $idmpath -ChildPath 'usr\local\horizon\conf'
if (Test-Path $confpath -PathType Container) {
    Write-ScriptLog ('Configuration path found: {0}' -f $confpath)
} else {
    Write-ScriptLog ('Configuration path not found: {0}' -f $confpath) -Severity 2
    return
}
$conffile = Join-Path $confpath -ChildPath 'krb5.conf'
if (Test-Path $conffile -PathType Leaf) {
    Write-ScriptLog ('KRB5 Configuration file found: {0}' -f $conffile)
} else {
    Write-ScriptLog ('KRB5 Configuration file not found: {0}' -f $conffile) -Severity 2
    return
}
$keytabfile = Join-Path $confpath -ChildPath 'krb5.keytab'
if (Test-Path $keytabfile -PathType Leaf) {
    if ($OverwriteExisting) {
        Write-ScriptLog ('KRB5 Keytab file found and will be overwritten: {0}' -f $keytabfile)
    } else {
        Write-ScriptLog ('KRB5 Keytab file found: {0}' -f $keytabfile) -Severity 2
        return
    }
} else {
    Write-ScriptLog ('KRB5 Keytab file not found: {0}' -f $keytabfile)
}
if ((Get-Module ActiveDirectory -ListAvailable).Count -gt 0) {
    Write-ScriptLog 'ActiveDirectory module present'
} else {
    Write-ScriptLog 'ActiveDirectory module not present!' -Severity 2
    return
}
$ktpass = Join-Path -Path $ENV:SystemRoot -ChildPath 'System32\ktpass.exe'
if (Test-Path $ktpass -PathType Leaf) {
    Write-ScriptLog ('KTPASS.EXE found: {0}' -f $ktpass)
} else {
    Write-ScriptLog ('KTPASS.EXE not found: {0}' -f $ktpass) -Severity 2
    return
}
try {
    $swa = Add-Type -AssemblyName System.Web -EA Stop
} catch {
    Write-ScriptLog ('Could not load assembly for password generation: {0}' -f $_.Exception.Message) -Severity 2
    return
}
#endregion
#region checking AD and INI files, creating AD user
Write-ScriptLog -LogMessage 'All prerequisites met, checking for AD configuration' -Severity 1
try {
    Import-Module ActiveDirectory -EA Stop
} catch {
    Write-ScriptLog ('Error importing ActiveDirectory module: {0}' -f $_.Exception.Message) -Severity 3
    return
}
$conf_ok = $true
$krb5config = Import-KRB5ConfigFile -Path $conffile
@('libdefaults','domain_realm','realms') | ForEach-Object {
    if ($krb5config.ContainsKey($_)) {
        Write-ScriptLog ('KRB5 config contains the {0} section' -f $_)
    } else {
        Write-ScriptLog ('KRB5 config is missing the {0} section' -f $_) -Severity 2
        $conf_ok = $false
    }
}
if ($conf_ok) {
    Write-ScriptLog 'KRB5 config contains all necessary sections' -Severity 1
} else {
    return
}
$owndomain = (Get-CimInstance Win32_ComputerSystem).Domain
Write-ScriptLog ('Machine domain of the agent host: {0}' -f $owndomain)
if ($krb5config.realms.ContainsKey($owndomain)) {
    Write-ScriptLog 'Authenitcating against own domain'
} else {
    Write-ScriptLog 'Authenitcating against other domains only'
}
$ownname = $env:COMPUTERNAME
$ownfqdn = ('{0}.{1}' -f $ownname, $owndomain)
$ownupn = ('{0}@{1}' -f $ownname, $owndomain)
Write-ScriptLog ('FQDN of the agent host: {0}' -f $ownfqdn)
Write-ScriptLog ('Reading the password policy from domain: {0}' -f $ownfqdn)
try {
    $minpwdlen = ([ADSI]"LDAP://$owndomain").minPwdLength[0]
} catch {
    $minpwdlen = 7
    Write-ScriptLog ('Error reading the min password length, setting to {0}: {1}' -f $minpwdlen, $_.Exception.Message) -Severity 2
}
$minpwdlen = [math]::Max($minpwdlen_script,$minpwdlen)
Write-ScriptLog ('Target password length for the principal: {0}' -f $minpwdlen)
try {
    $password = [System.Web.Security.Membership]::GeneratePassword($minpwdlen,1)
} catch {
    Write-ScriptLog ('Error generating password: {0}' -f $_.Exception.Message) -Severity 2
    return
}
$adusr = Get-ADUser -Filter {sAMAccountName -eq $ownname}
if ($null -eq $adusr) {
    $newAccount = @{
        'sAMAccountName' = $ownname
        'UserPrincipalName' = $ownupn
        'name' = $ownname
        'AccountPassword' = ($password | ConvertTo-SecureString -AsPlainText -Force)
        'CannotChangePassword' = $true
        'PasswordNeverExpires' = $true
        'PasswordNotRequired' = $true
        'Enabled' = $true
        'DisplayName' = ('WorkspaceONE Kerberos Principal ({0})' -f $ownname)
        'Description' = ('Created by New-WSOneKerberosPrincipal run as {0}\{1}' -f $env:USERDOMAIN, $env:USERNAME)
    }
    try {
        $adusr = New-ADUser @newAccount -PassThru -EA Stop
    } catch {
        Write-ScriptLog ('Error creating new AD User {0} in default container: {1}' -f $ownname, $_.Exception.Message)  -Severity 2
        return
    }
    # wait for replica
    $adusr = $null
    $timer = New-Object System.Diagnostics.Stopwatch
    $timer.Start()
    do {
        $adusr = Get-ADUser -Filter {sAMAccountName -eq $ownname}
        if ($null -eq $adusr) { Start-Sleep -Seconds 5 }
    } until (($null -ne $adusr) -or ($timer.Elapsed.TotalSeconds -gt $ReplicationTimeout))
    if ($null -eq $adusr) { 
        Write-ScriptLog ('AD User not found after {0} seconds' -f $ReplicationTimeout)  -Severity 2
        return
    }
    $timer.Stop()
} else {
    if ($OverwriteExisting) {
        Write-ScriptLog ('AD User found and will be modified: {0}' -f $adusr.DistinguishedName)  -Severity 1
        try {
            $adusr | Set-ADUser -UserPrincipalName $ownupn -Description ('Modified by New-WSOneKerberosPrincipal run as {0}\{1}' -f $env:USERDOMAIN, $env:USERNAME) -DisplayName ('WorkspaceONE Kerberos Principal ({0})' -f $ownname) -EA Stop
        } catch {
            Write-ScriptLog ('Error writing description of existing AD User {0}: {1}' -f $adusr.DistinguishedName, $_.Exception.Message)  -Severity 2
            return
        }
        Write-ScriptLog 'User properties modified'
        try {
            $adusr | Set-ADAccountPassword -NewPassword ($password | ConvertTo-SecureString -AsPlainText -Force) -EA Stop
        } catch {
            Write-ScriptLog ('Error resetting password of existing AD User {0}: {1}' -f $adusr.DistinguishedName, $_.Exception.Message)  -Severity 2
            return
        }
        Write-ScriptLog 'User password reset'
    } else {
        Write-ScriptLog ('AD User found and will not be modified: {0}' -f $adusr.DistinguishedName)  -Severity 2
        return
    }
}
if ($null -ne $adusr) {
    try {
        $adusr | Set-ADAccountControl -DoesNotRequirePreAuth:$true -EA Stop
    } catch {
        Write-ScriptLog ('Error disabling pre-auth for AD User {0}: {1}' -f $adusr.DistinguishedName, $_.Exception.Message)  -Severity 2
        return
    }
    Write-ScriptLog 'User pre-authentication disabled'
}
#endregion
#region writing KRB principal
$spns = @(
    ('HTTP/{0}' -f $ownname)
    ('HTTP/{0}' -f $ownfqdn)
)
$realms = $krb5config['domain_realm'].Keys
if ($realms -notcontains $owndomain) {
    $realms += $owndomain
}
$principals = New-Object System.Collections.ArrayList
foreach ($realm in $realms) {
    $null = $principals.Add(('HTTP/{0}@{1}' -f $ownname, $realm))
    $null = $principals.Add(('HTTP/{0}@{1}' -f $ownfqdn, $realm))
}
Write-ScriptLog ('The following principals will be created: {0}{1}' -f [Environment]::NewLine, ($principals -join [Environment]::NewLine))
$cmds = New-Object System.Collections.ArrayList
$veryfirst = $true
foreach ($cipher in $ciphers) {
    $first = $true
    foreach ($princ in $principals) {
        if ($first) {
            if ($veryfirst) {
                $cmd = ('{0} -princ {1} -mapuser {2} -crypto {3} -ptype KRB5_NT_PRINCIPAL -pass "{4}" -out "{5}" -setupn -setpass 2>&1' -f $ktpass, $princ, $ownupn, $cipher, $password, $keytabfile)
                $veryfirst = $false
            } else {
                $cmd = ('{0} -princ {1} -mapuser {2} -crypto {3} -ptype KRB5_NT_PRINCIPAL -pass "{4}" -in "{5}" -out "{5}" -setupn -setpass 2>&1' -f $ktpass, $princ, $ownupn, $cipher, $password, $keytabfile)
            }
            $first = $false
        } else {
            $cmd = ('{0} -princ {1} -crypto {3} -ptype KRB5_NT_PRINCIPAL -pass "{4}" -in "{5}" -out "{5}" -setupn -setpass 2>&1' -f $ktpass, $princ, $ownupn, $cipher, $password, $keytabfile)
        }
        $null = $cmds.Add($cmd)
    }
}
Write-ScriptLog 'Running KTPASS commands' -Severity 1
$allkt_ok = $true
foreach ($cmd in $cmds) {
    $cmd.Replace( $password, '*****')
    $cmd_ok = $true
    try {
        $res = Invoke-Expression -Command $cmd -EA Stop
    } catch {
        Write-ScriptLog ('Error code {0} writing KEYTAB: {1}' -f $lastexitcode, $_.Exception.Message)
        $cmd_ok = $false
        $allkt_ok = $false
    }
    if ($cmd_ok) {
        if ($lastexitcode -eq 0) {
            Write-ScriptLog 'KEYTAB updated successfully' -Severity 1
        } else {
            Write-ScriptLog ('KEYTAB updated with exit code {0}, please review result:{1}{2}' -f $lastexitcode, [Environment]::NewLine, ($res -join '')) -Severity 2
            $allkt_ok = $false
        }
    }
}
if ($allkt_ok) {
    Write-ScriptLog 'All KTPASS commands successful, assigning SPNs to user...'
    #generate SPNs
    $adusr = Get-ADUser -Filter {sAMAccountName -eq $ownname} -Properties ServicePrincipalName
    foreach ($spn in ($spns + $principals)) {
        if ($adusr.SevicePrincipalName -notcontains $spn) {
            Write-ScriptLog ('Adding {0} to the SPNs...' -f $spn)
            try {
                $adusr | Set-ADUser -ServicePrincipalNames @{Add=$spn} -EA Stop
            } catch {
        
            }
        }
    }
} else {
    Write-ScriptLog 'There were problems running KTPASS commands, please review results and rerun script' -Severity 2
    return
}
#endregion
#region backup config
if ($BackupConfig) {
    $backupFolder = Join-Path -Path $ENV:TEMP -ChildPath "KRB5_Backup_$(Get-Date -Format 'yyyyMMdd_HHmmss')"
    try {
        $null = New-Item -Path $backupFolder -ItemType Directory -Force -EA Stop
    } catch {
        Write-ScriptLog ('Could not create backup folder {0}: {1}' -f $backupFolder, $_.Exception.Message) -Severity 2
        return
    }
    Write-ScriptLog ('Backup folder created: {0}' -f $backupFolder)
    if (Test-Path $keytabfile -PathType Leaf) {
        Copy-Item -Path $keytabfile -Destination $backupFolder
    }
    if (Test-Path $conffile -PathType Leaf) {
        Copy-Item -Path $conffile -Destination $backupFolder
    }
}
#endregion
#region modifying krb5.conf
if ($AddEncryptionToConfig) {
    if ($krb5config.libdefaults.Keys -notcontains 'default_tkt_enctypes') {
        $krb5config.libdefaults.Add('default_tkt_enctypes',$tkt_enc)
        Export-KRB5ConfigFile -Config $krb5config -Path $conffile
    } else {
        Write-ScriptLog 'Current config contains default_tkt_enctypes already, will skip rewriting KRB5.conf'
    }
}
#endregion

# SIG # Begin signature block
# MIIefQYJKoZIhvcNAQcCoIIebjCCHmoCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB
# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR
# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUDMsvwke8/Msp2KhgmxvBQKfd
# DzGgghnAMIIFQTCCAymgAwIBAgITXwAAAAIjZCsPuYSflAAAAAAAAjANBgkqhkiG
# 9w0BAQsFADBcMQswCQYDVQQGEwJERTEPMA0GA1UEBxMGQmVybGluMRQwEgYDVQQK
# EwttZXRhQlBBLm9yZzEMMAoGA1UECxMDRGV2MRgwFgYDVQQDEw9tZXRhQlBBIFJv
# b3QgQ0EwHhcNMTkxMTA4MjEwNzI4WhcNMjAxMTA4MjExNzI4WjBcMQswCQYDVQQG
# EwJERTEPMA0GA1UEBxMGQmVybGluMRQwEgYDVQQKEwttZXRhQlBBLm9yZzEMMAoG
# A1UECxMDRGV2MRgwFgYDVQQDEw9FdmdlbmlqIFNtaXJub3YwggEiMA0GCSqGSIb3
# DQEBAQUAA4IBDwAwggEKAoIBAQDBL4oFbzMU7zkuwMFsG8Ckbk73VtcvE/gz5CFd
# Rf3f/WVMe27r6VQLUfeaLYwjavfe9MaSHngXhC0Ivsbf6IlKtY1oXJFKXuEnNvzC
# s3njl5LXVoWf29wGmOOAbPWBlI7+nBwvcNRHYnZ4ZaLSO9cdhre9gARTvMptUUL9
# 3Njf3jw9iwdLRg7wMk1TB3yB7nlHHd0G8YiPzlltOV9sesfpnFuorR2IPwkfaEfu
# Z6t/nHsuWtvliaT++PbDv9d0tnKiQVJ+h9cwMoTO8kIbg7Q52pT+paMrcEn7hyN+
# XjyG/oJUb6IyDOMgv2Fa+MJ9SWnT9z4Ueap4/JJhkiv8qaf5AgMBAAGjgfswgfgw
# DgYDVR0PAQH/BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMB0GA1UdDgQWBBRm
# y7quPiRE14SnwXiztcO0WxBDYzAfBgNVHSMEGDAWgBT5ujnudnaVxT34rTRrGEb0
# f87i+DA7BgNVHR8ENDAyMDCgLqAshipodHRwOi8vcGtpLm1ldGFicGEub3JnL21l
# dGFCUEFfUm9vdF9DQS5jcmwwRgYIKwYBBQUHAQEEOjA4MDYGCCsGAQUFBzAChipo
# dHRwOi8vcGtpLm1ldGFicGEub3JnL21ldGFCUEFfUm9vdF9DQS5jcnQwDAYDVR0T
# AQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAc05mB0AuoLmHwh5aPGw+VYSlXzDg
# ugs1HwjI3iNe6FQZ1a+E1yupvdLHFrjs+7nBtRzQNdbf6Gs2ulQgaxKzC+qtrgiu
# vkiO7q9mPza1WkkXCDtVatyMnRt6i9aK/Qy0B+lQxVL3gZhHKNiBlZd9lZbps699
# SHuT2lyytJEIQdXWKEm137+3FHFKIso9cQ820Lzh+251VukxuqRHR2A5BhiHRPww
# phRzMyfxGwUZWx1WSqgefEyHcqft562LnYluDXPxfEUNRPtTzAMbR8MH6zuom6QE
# pA3UzrJvwgYGnKkGyfj7SQijvvukfwHbcTRbbq73Jv6YKnFlwG8A6BKDYWYpQdgT
# 7ENlXhJ1TEZe+8O4XOUZokYQoFJbOn9dz2AyKJCQDYev3+uDqNhlVavcMG8YXBjv
# W/Y6NbUb1W2W+kDFtdCG74sXgTZyvqsDsEb57UniGxo0+/uYqxRnFexruJ/Il3OO
# kLv2Up4aov018yowmSYriJY2u9B7NyzPqNTh8KYo/RCm9INUn/SA3JNJ0g9udssR
# tkdbPCpq+e1j9Xjf6V5qkXQcNMuuZLf6RswS/tsuaqlhqRrHDdk4I+EcDj5o0n+C
# ur9horiACMCK5fjpgogRaqkuzCshtO1qc20F9tk0tUr3iD8N63MSbQBmxeyP16Et
# 7ZEHLtu+fmM06ckwggZqMIIFUqADAgECAhADAZoCOv9YsWvW1ermF/BmMA0GCSqG
# SIb3DQEBBQUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMx
# GTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IEFz
# c3VyZWQgSUQgQ0EtMTAeFw0xNDEwMjIwMDAwMDBaFw0yNDEwMjIwMDAwMDBaMEcx
# CzAJBgNVBAYTAlVTMREwDwYDVQQKEwhEaWdpQ2VydDElMCMGA1UEAxMcRGlnaUNl
# cnQgVGltZXN0YW1wIFJlc3BvbmRlcjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCC
# AQoCggEBAKNkXfx8s+CCNeDg9sYq5kl1O8xu4FOpnx9kWeZ8a39rjJ1V+JLjntVa
# Y1sCSVDZg85vZu7dy4XpX6X51Id0iEQ7Gcnl9ZGfxhQ5rCTqqEsskYnMXij0ZLZQ
# t/USs3OWCmejvmGfrvP9Enh1DqZbFP1FI46GRFV9GIYFjFWHeUhG98oOjafeTl/i
# qLYtWQJhiGFyGGi5uHzu5uc0LzF3gTAfuzYBje8n4/ea8EwxZI3j6/oZh6h+z+yM
# DDZbesF6uHjHyQYuRhDIjegEYNu8c3T6Ttj+qkDxss5wRoPp2kChWTrZFQlXmVYw
# k/PJYczQCMxr7GJCkawCwO+k8IkRj3cCAwEAAaOCAzUwggMxMA4GA1UdDwEB/wQE
# AwIHgDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMIIBvwYD
# VR0gBIIBtjCCAbIwggGhBglghkgBhv1sBwEwggGSMCgGCCsGAQUFBwIBFhxodHRw
# czovL3d3dy5kaWdpY2VydC5jb20vQ1BTMIIBZAYIKwYBBQUHAgIwggFWHoIBUgBB
# AG4AeQAgAHUAcwBlACAAbwBmACAAdABoAGkAcwAgAEMAZQByAHQAaQBmAGkAYwBh
# AHQAZQAgAGMAbwBuAHMAdABpAHQAdQB0AGUAcwAgAGEAYwBjAGUAcAB0AGEAbgBj
# AGUAIABvAGYAIAB0AGgAZQAgAEQAaQBnAGkAQwBlAHIAdAAgAEMAUAAvAEMAUABT
# ACAAYQBuAGQAIAB0AGgAZQAgAFIAZQBsAHkAaQBuAGcAIABQAGEAcgB0AHkAIABB
# AGcAcgBlAGUAbQBlAG4AdAAgAHcAaABpAGMAaAAgAGwAaQBtAGkAdAAgAGwAaQBh
# AGIAaQBsAGkAdAB5ACAAYQBuAGQAIABhAHIAZQAgAGkAbgBjAG8AcgBwAG8AcgBh
# AHQAZQBkACAAaABlAHIAZQBpAG4AIABiAHkAIAByAGUAZgBlAHIAZQBuAGMAZQAu
# MAsGCWCGSAGG/WwDFTAfBgNVHSMEGDAWgBQVABIrE5iymQftHt+ivlcNK2cCzTAd
# BgNVHQ4EFgQUYVpNJLZJMp1KKnkag0v0HonByn0wfQYDVR0fBHYwdDA4oDagNIYy
# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEQ0EtMS5j
# cmwwOKA2oDSGMmh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3Vy
# ZWRJRENBLTEuY3JsMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0cDov
# L29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0cy5k
# aWdpY2VydC5jb20vRGlnaUNlcnRBc3N1cmVkSURDQS0xLmNydDANBgkqhkiG9w0B
# AQUFAAOCAQEAnSV+GzNNsiaBXJuGziMgD4CH5Yj//7HUaiwx7ToXGXEXzakbvFoW
# OQCd42yE5FpA+94GAYw3+puxnSR+/iCkV61bt5qwYCbqaVchXTQvH3Gwg5QZBWs1
# kBCge5fH9j/n4hFBpr1i2fAnPTgdKG86Ugnw7HBi02JLsOBzppLA044x2C/jbRcT
# Bu7kA7YUq/OPQ6dxnSHdFMoVXZJB2vkPgdGZdA0mxA5/G7X1oPHGdwYoFenYk+VV
# FvC7Cqsc21xIJ2bIo4sKHOWV2q7ELlmgYd3a822iYemKC23sEhi991VUQAOSK2vC
# UcIKSK+w1G7g9BQKOhvjjz3Kr2qNe9zYRDCCBs0wggW1oAMCAQICEAb9+QOWA63q
# AArrPye7uhswDQYJKoZIhvcNAQEFBQAwZTELMAkGA1UEBhMCVVMxFTATBgNVBAoT
# DERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEkMCIGA1UE
# AxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4XDTA2MTExMDAwMDAwMFoX
# DTIxMTExMDAwMDAwMFowYjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0
# IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMYRGlnaUNl
# cnQgQXNzdXJlZCBJRCBDQS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
# AQEA6IItmfnKwkKVpYBzQHDSnlZUXKnE0kEGj8kz/E1FkVyBn+0snPgWWd+etSQV
# wpi5tHdJ3InECtqvy15r7a2wcTHrzzpADEZNk+yLejYIA6sMNP4YSYL+x8cxSIB8
# HqIPkg5QycaH6zY/2DDD/6b3+6LNb3Mj/qxWBZDwMiEWicZwiPkFl32jx0PdAug7
# Pe2xQaPtP77blUjE7h6z8rwMK5nQxl0SQoHhg26Ccz8mSxSQrllmCsSNvtLOBq6t
# hG9IhJtPQLnxTPKvmPv2zkBdXPao8S+v7Iki8msYZbHBc63X8djPHgp0XEK4aH63
# 1XcKJ1Z8D2KkPzIUYJX9BwSiCQIDAQABo4IDejCCA3YwDgYDVR0PAQH/BAQDAgGG
# MDsGA1UdJQQ0MDIGCCsGAQUFBwMBBggrBgEFBQcDAgYIKwYBBQUHAwMGCCsGAQUF
# BwMEBggrBgEFBQcDCDCCAdIGA1UdIASCAckwggHFMIIBtAYKYIZIAYb9bAABBDCC
# AaQwOgYIKwYBBQUHAgEWLmh0dHA6Ly93d3cuZGlnaWNlcnQuY29tL3NzbC1jcHMt
# cmVwb3NpdG9yeS5odG0wggFkBggrBgEFBQcCAjCCAVYeggFSAEEAbgB5ACAAdQBz
# AGUAIABvAGYAIAB0AGgAaQBzACAAQwBlAHIAdABpAGYAaQBjAGEAdABlACAAYwBv
# AG4AcwB0AGkAdAB1AHQAZQBzACAAYQBjAGMAZQBwAHQAYQBuAGMAZQAgAG8AZgAg
# AHQAaABlACAARABpAGcAaQBDAGUAcgB0ACAAQwBQAC8AQwBQAFMAIABhAG4AZAAg
# AHQAaABlACAAUgBlAGwAeQBpAG4AZwAgAFAAYQByAHQAeQAgAEEAZwByAGUAZQBt
# AGUAbgB0ACAAdwBoAGkAYwBoACAAbABpAG0AaQB0ACAAbABpAGEAYgBpAGwAaQB0
# AHkAIABhAG4AZAAgAGEAcgBlACAAaQBuAGMAbwByAHAAbwByAGEAdABlAGQAIABo
# AGUAcgBlAGkAbgAgAGIAeQAgAHIAZQBmAGUAcgBlAG4AYwBlAC4wCwYJYIZIAYb9
# bAMVMBIGA1UdEwEB/wQIMAYBAf8CAQAweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUF
# BzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6
# Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5j
# cnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9E
# aWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwOqA4oDaGNGh0dHA6Ly9jcmw0LmRp
# Z2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwHQYDVR0OBBYE
# FBUAEisTmLKZB+0e36K+Vw0rZwLNMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6en
# IZ3zbcgPMA0GCSqGSIb3DQEBBQUAA4IBAQBGUD7Jtygkpzgdtlspr1LPUukxR6tW
# XHvVDQtBs+/sdR90OPKyXGGinJXDUOSCuSPRujqGcq04eKx1XRcXNHJHhZRW0eu7
# NoR3zCSl8wQZVann4+erYs37iy2QwsDStZS9Xk+xBdIOPRqpFFumhjFiqKgz5Js5
# p8T1zh14dpQlc+Qqq8+cdkvtX8JLFuRLcEwAiR78xXm8TBJX/l/hHrwCXaj++wc4
# Tw3GXZG5D2dFzdaD7eeSDY2xaYxP+1ngIw/Sqq4AfO6cQg7PkdcntxbuD8O9fAqg
# 7iwIVYUiuOsYGk38KiGtSTGDR5V3cdyxG0tLHBCcdxTBnU8vWpUIKRAmMIIHODCC
# BSCgAwIBAgIQEw12KjF18pBAJDt0qQwq6jANBgkqhkiG9w0BAQsFADBcMQswCQYD
# VQQGEwJERTEPMA0GA1UEBxMGQmVybGluMRQwEgYDVQQKEwttZXRhQlBBLm9yZzEM
# MAoGA1UECxMDRGV2MRgwFgYDVQQDEw9tZXRhQlBBIFJvb3QgQ0EwHhcNMTkxMTA4
# MjAwMDU5WhcNMzkxMTA4MjAxMDU0WjBcMQswCQYDVQQGEwJERTEPMA0GA1UEBxMG
# QmVybGluMRQwEgYDVQQKEwttZXRhQlBBLm9yZzEMMAoGA1UECxMDRGV2MRgwFgYD
# VQQDEw9tZXRhQlBBIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
# AoICAQCw2DkS2wXYAPJTQVkEccotAn/ba+ZxjYqvZOnOO1QbHk8XDSZCFrTADHjU
# BvYZPVZDg/OPg082TOmln7uVfipsHt29WSWCVco6WTGbb2gHfTFpAoltfdRnsTWt
# +J0l69tdPWVVxMpvsNv1S/FrfkEVLBW6k9glHSjmvz6uJNvF/UKtkkkElpPtbLsS
# jNCwIqXJ7maZTNEEUGnmDYHhj2Bi7Ex5w2fKw5k5IvCr4BO6LLIim9HialiT0pMK
# JMkWSQmQqDlC/WUjh5cmOD4fRq2cL8QiiJjz1mpbALd9zz7F9KO/7F9WZXQaiEK/
# vgBsB8LnjWlE/qh9eoWSw1ib+Pp2Nxs2Wmk433Di4pgkad4eZHC0ENF8/8VU/Via
# a2PQJdwoK/ouAvUJz+JQ/q7hNClpoNa7dbgrtw63W0DeC7NbSHE7469ftrkkHsfy
# S7y2YM68Nw/0s1kgQSneeqbOAMYIW1d634QJniOqzn1kb2wSHj+f/g90HTa+8vmh
# wBC/AGWPZB28qxVz7CjQ6uRfNpQnP3WvEXaJbmKldhvzyTzAWxfhXRzNlRx8Ije1
# BsditmsB1W3V93AU+EH/FXs4r4toQCyAQL4ldXCEmcVxHO2qk3ZDjVIrDddk3wP3
# 9VZP9UTm/laSs/zhWIDYHdZe6Kh7kX95pt10hZqS73O4gcfWmQIDAQABo4IB9DCC
# AfAwCwYDVR0PBAQDAgGGMBIGA1UdEwEB/wQIMAYBAf8CAQEwHQYDVR0OBBYEFPm6
# Oe52dpXFPfitNGsYRvR/zuL4MBAGCSsGAQQBgjcVAQQDAgEAMIIBmgYDVR0gBIIB
# kTCCAY0wggGJBgwrBgEEAYOHcQEBAQEwggF3MIIBRgYIKwYBBQUHAgIwggE4HoIB
# NABUAGgAaQBzACAAUABLAEkAIABpAHMAIABpAG4AdABlAG4AZABlAGQAIABmAG8A
# cgAgAGMAZQByAHQAaQBmAGkAYwBhAHQAaQBvAG4AIABiAHkAIABtAGUAdABhAEIA
# UABBAC4AbwByAGcALAAgAEUAdgBnAGUAbgBpAGoAIABTAG0AaQByAG4AbwB2ACwA
# IABCAGUAcgBsAGkAbgAgAG8AbgBsAHkALgAgAEYAbwByACAAZABlAHQAYQBpAGwA
# cwAsACAAYwBvAG4AcwB1AGwAdAAgAHQAaABlACAAQwBlAHIAdABpAGYAaQBjAGEA
# dABpAG8AbgAgAFAAbwBsAGkAYwB5ACAAUwB0AGEAdABlAG0AZQBuAHQAIABsAGkA
# bgBrAGUAZAAgAGIAZQBsAG8AdwAuMCsGCCsGAQUFBwIBFh9odHRwOi8vcGtpLm1l
# dGFicGEub3JnL2Nwcy5odG1sMA0GCSqGSIb3DQEBCwUAA4ICAQBuwVs984+DElFQ
# BzO7r96a2/QZosjcZst3/KLCJQXRNjfrtHzGNDFRCj5MSqet9jXfC0Q0XQnus28S
# NG75qpzdkdKFruAjffOP1qOWEjnsljK+KkNafHXywlNUDI4Y3LzO44jF33gpTPjM
# 0KjWUGPRmwkOyapyEh629S7AlXikuYJLFDddsEVmzf9jVMjEQi37BzyaERwokkwg
# bW4hxIVycoPyfPhiAVChPj/IHFVaUDYb6vvL5/LD6fS9qd7VbJgOtkrpZhBzV3n4
# Gi7cOHVvGylta/gp4sdpB62QBNTjUS8JOkU1ECLDpO+QfKdKn1jYqpv9vIVYvj52
# 4yPx92T/dp2zZqJd9/3/M35b9pk0J3ACf77Lb2sM98/G4HK5NI8LqdM8iEKQkPQ4
# 9gkujnnQrmm1CMYRND498GfcgxQo2h+TFrxEWfZRHrPmoPtp90E9lW/vgwsgvtGN
# iBR6+wcEeBGm3TnwDUZsXhSUO0wyWSGhPWzxnM+ADC0iMpeBeTn22v+NA2S2mNOF
# f0K83O+r6LhjcnoD6kehQ30hHdvplxUs/D+IiOVkwyhznAmEpLP0Wv3e+ggN0qDP
# zYbKRjgJYcJBFU0us1+UADDg2mxxuJbNWmT7QXnh6eOlFPrYnwIdjmhJwkeaY7/N
# bSbexF0k2hTNI6d526AFcHAVSjJqBDGCBCcwggQjAgEBMHMwXDELMAkGA1UEBhMC
# REUxDzANBgNVBAcTBkJlcmxpbjEUMBIGA1UEChMLbWV0YUJQQS5vcmcxDDAKBgNV
# BAsTA0RldjEYMBYGA1UEAxMPbWV0YUJQQSBSb290IENBAhNfAAAAAiNkKw+5hJ+U
# AAAAAAACMAkGBSsOAwIaBQCgeDAYBgorBgEEAYI3AgEMMQowCKACgAChAoAAMBkG
# CSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEE
# AYI3AgEVMCMGCSqGSIb3DQEJBDEWBBTwS+5opwzSjby9dpIFdtWW3g/mVTANBgkq
# hkiG9w0BAQEFAASCAQAkUSSzuoJxiOHm1jh8P8n/VEA0LJyKt/jqqctCi4IqNj2Q
# RXnEDbkklPlTLAWjFH+wiaxwAlvU6orn7Tvo6XI5iDzTBok/QMmQDWgfF+k44hyh
# S5QKD3tSxvXwFX3+nHF8kfhFjMSf8q1gzZwu4V5rBw4VVikw1Mg0+KBCKJ41egZm
# YNrTpo7+HrQ7lnyTwZ4AA6uajbAP/1QnbSBSYhL2p3n6ikbRzNenJJQqVsULpRpk
# LO+CkaWvFbBdNAQkph3QdwxCBwSQeu1hII2BywC34Qmn6vnM/TN0tnHElyJpZToa
# UaDmTL1zIjHeiviAJXhEJEpv21gCoEby/WrsQcfKoYICDzCCAgsGCSqGSIb3DQEJ
# BjGCAfwwggH4AgEBMHYwYjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0
# IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMYRGlnaUNl
# cnQgQXNzdXJlZCBJRCBDQS0xAhADAZoCOv9YsWvW1ermF/BmMAkGBSsOAwIaBQCg
# XTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0yMDA3
# MTUxNzQ3NTZaMCMGCSqGSIb3DQEJBDEWBBRwQbunfg3p76agu/dKilEqBYcZqzAN
# BgkqhkiG9w0BAQEFAASCAQBMuBW3uohqXV9egCcPmiPquL9O+Bwh+psTE2nmcSCV
# DwqnI54nGVjP8FtPj5hN98Tz8Xn9XeKuwl+10+NttuBmOb852+i0HpzD3vN4I2vs
# c2JGP7ZWi7pk2YxN9u3bpUOIHArZW1nl+4kw1VBSTw41xDS+7kphXIhWpeLMyn9x
# BzmUce8bvZ+8efOmmRjEEWVXyaDYaPWESZb9a6fx/QdsO4pjir45Ea+8/SHyhOOL
# gbF125T/XM9yX3OsoDdOsGqVm1Ws6ESiEX9z31iEpSi1oDJcbtulsENbr5L2GFvF
# qYfIcHTciqxANYeTx6+WryII23aYl25iggpjGweZxSl3
# SIG # End signature block