Obs/bin/ObsDep/content/Powershell/Roles/Common/JustEnoughAdministrationDSC.psm1
<###################################################
# # # Copyright (c) Microsoft. All rights reserved. # # # ##################################################> Import-Module -Name "$PSScriptRoot\..\..\Common\Helpers.psm1" Import-Module -Name "$PSScriptRoot\..\..\Common\StorageHelpers.psm1" -Force Import-Module -Name "$PSScriptRoot\DscHelper.psm1" Import-Module -Name "$PSScriptRoot\JeaHelper.psm1" <# .Synopsis Generates DSC configuration document(s) for the target node(s), as specified by the Role configuration. Returns the list of the JEA endpoints captured in the configuration. #> function New-JustEnoughAdministrationConfiguration { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [CloudEngine.Configurations.EceInterfaceParameters] $Parameters, [Parameter(Mandatory=$true)] [IO.DirectoryInfo] $ModulesRootPath, [Parameter(Mandatory=$false)] [IO.DirectoryInfo] $MofOutputPath=$null, [Parameter(Mandatory=$false)] [string] $TargetComputerName = 'localhost', [string[]] $TargetImageRole = $Parameters.Configuration.Role.Id, [string[]] $SourceImageRole ) $ErrorActionPreference = 'Stop' if ($MofOutputPath -eq $null) { $MofOutputPath = Join-Path $ModulesRootPath "DSCConfigs\ConfigureJustEnoughAdministration" } Trace-Execution "$($MyInvocation.InvocationName) : BEGIN on $($env:COMPUTERNAME) as $($env:USERDOMAIN)\$($env:USERNAME)" $cloudRole = $Parameters.Roles["Cloud"].PublicConfiguration $securityInfo = $cloudRole.PublicInfo.SecurityInfo $domainRole = $Parameters.Roles["Domain"].PublicConfiguration $domainName = $domainRole.PublicInfo.DomainConfiguration.DomainName # Get all the roles that have JEA information $RolesToConfigure = $Parameters.Roles.GetEnumerator() | Where-Object { $Parameters.Roles[$_.Name].PublicConfiguration.PublicInfo.JEA } | Foreach-Object { $_.Name } if ($SourceImageRole) { Trace-Execution "Getting list of JEA endpoints defined under the following roles: $($SourceImageRole -join ', ')." $RolesToConfigure = $RolesToConfigure | where { $_ -in $SourceImageRole } } $endpoints = @() foreach($role in $RolesToConfigure) { $configuration = $Parameters.Roles[$role].PublicConfiguration.PublicInfo.JEA.Endpoints.Endpoint # Loop through all the endpoints defined foreach($endpoint in $configuration) { if (!$endpoint.TargetRoles) { if (-not ($TargetImageRole -contains $role)) { continue } } else { $applicable = $endpoint.TargetRoles.TargetRole | Where-Object { $TargetImageRole -contains $_.Id } if (!$applicable) { continue } } $runAsGmsa = $endpoint.RunAsGmsa -and ($endpoint.RunAsGmsa -eq "True") $runAsVirtualAccount = $endpoint.RunAsVirtualAccount -and ($endpoint.RunAsVirtualAccount -eq "True") if ( -not ($runAsGmsa -or $runAsVirtualAccount) ) { Trace-Error "Can not create JEA endpoint '$($endpoint.Name)' since it was marked in configuration as non-GMSA and non-virtual account. This is not currently supported." return } Trace-Execution "Creating JEA Endpoint $($endpoint.Name) for Role $($TargetImageRole -join ', ')" # Define transportation options $transportOption = $null if ($endpoint.TransportOptions) { $transportOption = @{} $endpoint.TransportOptions.GetEnumerator() | foreach { if ([Microsoft.PowerShell.Commands.WSManConfigurationOption].GetProperties().Name.Contains($_.Name)) { $transportOption[$_.Name] = $_.Value } else { throw "Transport Option '$($_.Name)' for JEA endpoint not valid for WSManConfigurationOption" } } $endpoint | Add-Member -MemberType NoteProperty -Name "TransportOption" -Value $transportOption -Force } # Path to the Powershell Modules folder $modulePath = Join-Path $ModulesRootPath "Program Files\WindowsPowerShell\Modules\" # Path where the psrc file will be stored $rcPath = Join-Path $modulePath "JEA\RoleCapabilities" # Create the folder where the RC files will be stored New-Item -Path $rcPath -ItemType Directory -Force | Out-Null $deployLatestVersion = -not($endpoint.AllVersions -and $endpoint.AllVersions -eq "True") # This flag checks if the endpoint gathers its rolecapability configuration from a nuget. # If there is no rc nuget dependency, then conduct the custom configuration $psrcFromNuget = $false $endpointVersion = "" $sourceVersionExtensionList = @() # If the endpoint has nuget defined, copy the contents inside the nuget to the right location. if($endpoint.Nugets) { $clusterName = Get-ManagementClusterName $Parameters $nugets = $endpoint.Nugets.Nuget foreach($nuget in $nugets) { $nugetName = $nuget.Name Trace-Execution "EndpointName: $($endpoint.Name) , NugetName: $nugetName" # Get nuget store location on the library share $virtualMachinesRole = $Parameters.Roles["VirtualMachines"].PublicConfiguration $libraryShareNugetStorePath = Get-SharePath $Parameters $virtualMachinesRole.PublicInfo.LibraryShareNugetStoreFolder.Path $clusterName $buildLocally = $Parameters.Context.ExecutionContext.BuildVhdLocally -and [bool]::Parse($Parameters.Context.ExecutionContext.BuildVhdLocally) # Use the NuGet store on the file share, unless explicitly told not to (BuildVhdLocally) or the file share is not reachable. $useLibrarySharePath = -not $buildLocally -and (Test-Path $libraryShareNugetStorePath) Trace-Execution "useLibrarySharePath: $useLibrarySharePath" # Collect all versions of the JEA endpoint nugets to support upgrading from an unknown stamp version $getNugetVersionsParams = @{ NugetName = $NugetName MostRecent = $deployLatestVersion } if($useLibrarySharePath) { $getNugetVersionsParams.NugetStorePath = $libraryShareNugetStorePath } $versionList = Get-NugetVersions @getNugetVersionsParams # If version is required, but none are found, throw if ($endpoint.RequiresVersion -and ($versionList.Count -eq 0)) { Trace-Error "Requires version was specified, but no versions were found for endpoint '$($endpoint.Name)'" } # Loop through the list of versions and copy the content and PSRC(if applicable) to the right location foreach($nugetVersion in $versionList) { if ($nuget.PackagedModules -and $nuget.PackagedModules.Path) { # Temporary location where the JEA module source code will be extracted $tempPath = Join-Path -Path ([System.IO.Path]::GetTempPath()) -ChildPath ([System.IO.Path]::GetRandomFileName()) New-Item -Path $tempPath -ItemType Directory -Force | Out-Null try { # Unpack the scripts for the JEA endpoint at a temporary location Trace-Execution "Expand nuget: $nugetName with content from: $($nuget.PackagedModules.Path) to : $tempPath " $expandNugetContentParams = @{ NugetName = $NugetName SourcePath = $nuget.PackagedModules.Path DestinationPath = $tempPath Version = $nugetVersion } if($useLibrarySharePath) { $expandNugetContentParams.NugetStorePath = $libraryShareNugetStorePath } Expand-NugetContent @expandNugetContentParams # Define what the module path will look like and if the path does not exist, create it $targetModulePath = $modulePath if($nuget.PackagedModules.Destination) { $targetModulePath = Join-Path $modulePath $nuget.PackagedModules.Destination if ((Test-Path -Path $targetModulePath) -eq $false) { $null = New-Item -Path $targetModulePath -ItemType Directory -Force } } # Copy content from the temporary path to the target path $copy = @{ Path = "$tempPath\*"; Destination = "$targetModulePath\"; Recurse = $true; Force = $true} if ($nuget.PackagedModules.Filter) { $copy["Filter"] = $nuget.PackagedModules.Filter } Trace-Execution "Copying content from $tempPath to $targetModulePath" try { Copy-Item @copy } catch [System.IO.IOException] { Trace-Execution "I/O exception ignored during copying of existing JEA modules, potentially due to module already being loaded" } } catch { # Printing error message here as Remove-Item occasionally throws errors that mask the original issue. Trace-Execution ($_ | Format-List *) throw } finally { Remove-Item -Recurse $tempPath -Force -ErrorAction SilentlyContinue if (Test-Path $tempPath) { Remove-Item -Recurse $tempPath -Force -ErrorAction Stop } } } # If the RoleCapability is present and has a path value, psrc files will be picked up from the nuget if ($nuget.RoleCapability -and $nuget.RoleCapability.Path) { Trace-Execution "Role Capability for the endpoint is defined in the nuget with path: $($nuget.RoleCapability.Path)" # Recurse over all available versions of the target package # There may be multiple RC files within the nuget, each representing a versioned endpoint. # The customer config will only define one broad endpoint, so need to expand the endpoints # to register by the versioned names. $tempPath = Join-Path -Path ([System.IO.Path]::GetTempPath()) -ChildPath ([System.IO.Path]::GetRandomFileName()) New-Item -Path $tempPath -ItemType Directory -Force | Out-Null $psrcFromNuget = $true try { $expandNugetContentParams = @{ NugetName = $NugetName SourcePath = $nuget.RoleCapability.Path DestinationPath = $tempPath Version = $nugetVersion } if($useLibrarySharePath) { $expandNugetContentParams.NugetStorePath = $libraryShareNugetStorePath } Expand-NugetContent @expandNugetContentParams # Copy each RC file for each whitelist foreach($whiteList in $endpoint.WhiteList) { $copy = @{ Path = "$tempPath\*"; Filter = "$($whiteList.Name)*"; Destination = $rcPath; Recurse = $true; Force = $true } Trace-Execution "Copying content from: $tempPath to: $rcPath with whitelist name: $($whiteList.Name)" Copy-Item @copy Trace-Execution "Get version for the endpoint:$($endpoint.Name)" # If the version is not set yet, pick up the RC file with the name as (endpointName + Version) if ($whiteList.Name -like "$($endpoint.Name)*") { $rcFile = Get-ChildItem -Path $rcPath -Filter "$($whiteList.Name)*" foreach ($whitelistFile in $rcFile) { $roleCapabilityName = [System.IO.Path]::GetFileNameWithoutExtension($whitelistFile.FullName) $endpointVersion = $roleCapabilityName.Substring($whitelist.Name.Length, $roleCapabilityName.Length - $whitelist.Name.Length) if (-not($sourceVersionExtensionList -contains $endpointVersion)) { $sourceVersionExtensionList += $endpointVersion } } } } } catch { # Printing error message here as Remove-Item occasionally throws errors that mask the original issue. Trace-Execution ($_ | Format-List *) throw } finally { Remove-Item -Recurse $tempPath -Force -ErrorAction SilentlyContinue if (Test-Path $tempPath) { Remove-Item -Recurse $tempPath -Force -ErrorAction Stop } } } } } } # Nuget expansion completed # No versions were found, so ensure that at least the non-versioned endpoint is created if([string]::IsNullOrEmpty($endpointVersion)) { $sourceVersionExtensionList = @("") } # As we are done with Nuget expansion, if the PSRC file was not picked up from the nuget, create it. if(-not $psrcFromNuget) { # Simple endpoint from configuration definition, with no versions # Loop through all the whitelists and generate the PSRC files at the desired location. foreach($whiteList in $endpoint.Whitelist) { $RCParams = Get-RoleCapabilityParams($whitelist) Trace-Execution "Role Capabilities for endpoint '$($endpoint.Name)': " Trace-Execution ($RCParams | ConvertTo-Json -depth 3) New-Item -Path $rcPath -ItemType Directory -Force | Out-Null New-PSRoleCapabilityFile -Path "$rcPath\$($whitelist.Name).psrc" @RCParams } } foreach ($endpointVersion in $sourceVersionExtensionList) { # Gather information needed to create the PSSC file and also for registration of JEA endpoint. # Clone the endpoint $e = $endpoint.Clone() # Session configuration $sessionConfigurationArgs = @{ SessionConfig = $endpoint.SessionConfiguration; Endpointname = $endpoint.Name; } # If version was found add it to the name of the endpoint as it will be a versioned endpoint if([string]::IsNullOrEmpty($endpointVersion) -eq $false) { $e.Name = $endpoint.Name + $endpointVersion $sessionConfigurationArgs["Endpointname"] = $e.Name $sessionConfigurationArgs["VersionExtension"] = $endpointVersion } # RunAs accounts if ($runAsGmsa) { $RunAsAccountUser = "$domainName\$($endpoint.RunAsAccountID)" $sessionConfigurationArgs["RunAsAccountUser"] = $RunAsAccountUser $sessionConfigurationArgs["RunAsGmsa"] = $true $e | Add-Member -MemberType NoteProperty -Name "RunAsAccountUser" -Value $RunAsAccountUser -Force } elseif($runAsVirtualAccount) { Trace-Execution "[$($endpoint.Name)] will run under virtual admin account" $e | Add-Member -MemberType NoteProperty -Name "RunAsVirtualAccount" -Value $true -Force $sessionConfigurationArgs["RunAsVirtualAccount"] = $true } else { Trace-Warning "Endpoint $($endpoint.Name) still using non-GMSA credential." $RunAsAccountUser = $securityInfo.DomainUsers.User | ? Role -EQ $endpoint.RunAsAccountID $RunAsAccountCredential = $Parameters.GetCredential($RunAsAccountUser.Credential) Trace-Execution "'Run-As' AccountUser when invoking commands in JEA: $($RunAsAccountCredential.UserName)" # Adding the NoteProperty. This won't get included if endpoint.Clone() is called $e | Add-Member -MemberType NoteProperty -Name "RunAsCredential" -Value $RunAsAccountCredential -Force } $scParams = Get-SessionConfigurationParams @sessionConfigurationArgs $e | Add-Member -MemberType NoteProperty -Name "RoleDefinitions" -Value $scParams.RoleDefinitions -Force if($scParams.TranscriptDirectory) { $e | Add-Member -MemberType NoteProperty -Name "TranscriptDirectory" -Value $scParams.TranscriptDirectory -Force } if($scParams.SessionType) { $e | Add-Member -MemberType NoteProperty -Name "SessionType" -Value $scParams.SessionType -Force } if($scParams.LanguageMode) { $e | Add-Member -MemberType NoteProperty -Name "LanguageMode" -Value $scParams.LanguageMode -Force } $endpoints += $e } } } # If no endpoints are defined, move on. if ($endpoints.Count -eq 0) { Trace-Execution "No endpoints to deploy for role [$TargetImageRole]" return; } # DSC is slow to import at module parse time. Defer import of all DSC configurations until runtime. Import-Module "$PSScriptRoot\JustEnoughAdministrationDSCconfig.psm1" -DisableNameChecking $dscEncryptionCert = GetDscEncryptionCert $ConfigData= @{ AllNodes = @( @{ NodeName = $TargetComputerName CertificateFile = "$env:temp\DscEncryptionPublicKey.cer" ThumbPrint = $dscEncryptionCert.ThumbPrint }; ); } Remove-Item "$MofOutputPath\$TargetComputerName.mof" -Force -ErrorAction SilentlyContinue Trace-Execution "Generating JustEnoughAdministration endpoint MOFs" ConfigureJustEnoughAdministration -ConfigurationData $ConfigData -Endpoints $endpoints -OutputPath $MofOutputPath | Out-Null Trace-Execution "$($MyInvocation.InvocationName) : END on $($env:COMPUTERNAME) as $($env:USERDOMAIN)\$($env:USERNAME)" Trace-Execution "Created configuration for the following endpoints:$([System.Environment]::NewLine)$($endpoints.Name -join [System.Environment]::NewLine)" return $endpoints.Name } Export-ModuleMember New-JustEnoughAdministrationConfiguration # SIG # Begin signature block # MIIoKgYJKoZIhvcNAQcCoIIoGzCCKBcCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAgTLD9qWhZhYai # w6RQfdfB1A6Taqh++u2bnWhpsriAO6CCDXYwggX0MIID3KADAgECAhMzAAADTrU8 # esGEb+srAAAAAANOMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjMwMzE2MTg0MzI5WhcNMjQwMzE0MTg0MzI5WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDdCKiNI6IBFWuvJUmf6WdOJqZmIwYs5G7AJD5UbcL6tsC+EBPDbr36pFGo1bsU # p53nRyFYnncoMg8FK0d8jLlw0lgexDDr7gicf2zOBFWqfv/nSLwzJFNP5W03DF/1 # 1oZ12rSFqGlm+O46cRjTDFBpMRCZZGddZlRBjivby0eI1VgTD1TvAdfBYQe82fhm # WQkYR/lWmAK+vW/1+bO7jHaxXTNCxLIBW07F8PBjUcwFxxyfbe2mHB4h1L4U0Ofa # +HX/aREQ7SqYZz59sXM2ySOfvYyIjnqSO80NGBaz5DvzIG88J0+BNhOu2jl6Dfcq # jYQs1H/PMSQIK6E7lXDXSpXzAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUnMc7Zn/ukKBsBiWkwdNfsN5pdwAw # RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW # MBQGA1UEBRMNMjMwMDEyKzUwMDUxNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci # tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG # CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0 # MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAD21v9pHoLdBSNlFAjmk # mx4XxOZAPsVxxXbDyQv1+kGDe9XpgBnT1lXnx7JDpFMKBwAyIwdInmvhK9pGBa31 # TyeL3p7R2s0L8SABPPRJHAEk4NHpBXxHjm4TKjezAbSqqbgsy10Y7KApy+9UrKa2 # kGmsuASsk95PVm5vem7OmTs42vm0BJUU+JPQLg8Y/sdj3TtSfLYYZAaJwTAIgi7d # hzn5hatLo7Dhz+4T+MrFd+6LUa2U3zr97QwzDthx+RP9/RZnur4inzSQsG5DCVIM # pA1l2NWEA3KAca0tI2l6hQNYsaKL1kefdfHCrPxEry8onJjyGGv9YKoLv6AOO7Oh # JEmbQlz/xksYG2N/JSOJ+QqYpGTEuYFYVWain7He6jgb41JbpOGKDdE/b+V2q/gX # UgFe2gdwTpCDsvh8SMRoq1/BNXcr7iTAU38Vgr83iVtPYmFhZOVM0ULp/kKTVoir # IpP2KCxT4OekOctt8grYnhJ16QMjmMv5o53hjNFXOxigkQWYzUO+6w50g0FAeFa8 # 5ugCCB6lXEk21FFB1FdIHpjSQf+LP/W2OV/HfhC3uTPgKbRtXo83TZYEudooyZ/A # Vu08sibZ3MkGOJORLERNwKm2G7oqdOv4Qj8Z0JrGgMzj46NFKAxkLSpE5oHQYP1H # tPx1lPfD7iNSbJsP6LiUHXH1MIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq # hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 # IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG # EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG # A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg # Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC # CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03 # a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr # rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg # OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy # 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9 # sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh # dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k # A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB # w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn # Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90 # lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w # ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o # ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD # VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa # BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny # bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG # AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV # HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG # AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl # AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb # C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l # hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6 # I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0 # wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560 # STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam # ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa # J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah # XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA # 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt # Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr # /Xmfwb1tbWrJUnMTDXpQzTGCGgowghoGAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIKTmW5fBbjaIi8OqGC1G0w2w # OYWhLi3uKL5LB2ng9oiVMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAqPnK5WbN+CGdF7ldHAXTiSAZMKVPfSqAETF6q6abHfOW5TpU5LNCpttE # /n6ep1smHtWYBARU94/b5JQLaf7aqzc5NoUCjWlmAKxnWGsPIaUC3DsPq8WC5VUG # fUdv2P9G7G9eWz+M8/1Qu0aPCstWlCLfa3lG8l0fh2shyHuhaQAUEY0RWj8HIk7M # LZvIlaFxd6QeYhxYsSjEoartCatScokMCm+wYg36BCFwWZDo4Uaaoay4hUZ2oRgi # quvhtEmvdOQmn+aQPtjHjG5k22akeQ/UQ5AdMhqPxj+1E/LqhBVl8jPL0QqtG+cS # OkiGCCugLGrVg2CMHwLQC7WTgL5H9aGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCC # F3wGCSqGSIb3DQEHAqCCF20wghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsq # hkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCDI9a6MaohsTxm7/wSXjGKDtcpvl55YPty2/diVtQC9rQIGZMvn1BdN # GBMyMDIzMDgwNzIxMzMzOS4yOTdaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l # cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046ODkwMC0w # NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Wg # ghHqMIIHIDCCBQigAwIBAgITMwAAAdMdMpoXO0AwcwABAAAB0zANBgkqhkiG9w0B # AQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yMzA1MjUxOTEy # MjRaFw0yNDAyMDExOTEyMjRaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z # MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046ODkwMC0wNUUwLUQ5NDcxJTAjBgNV # BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB # AQUAA4ICDwAwggIKAoICAQC0jquTN4g1xbhXCc8MV+dOu8Uqc3KbbaWti5vdsAWM # 1D4fVSi+4NWgGtP/BVRYrVj2oVnnMy0eazidQOJ4uUscBMbPHaMxaNpgbRG9FEQR # FncAUptWnI+VPl53PD6MPL0yz8cHC2ZD3weF4w+uMDAGnL36Bkm0srONXvnM9eNv # nG5djopEqiHodWSauRye4uftBR2sTwGHVmxKu0GS4fO87NgbJ4VGzICRyZXw9+Rv # vXMG/jhM11H8AWKzKpn0oMGm1MSMeNvLUWb31HSZekx/NBEtXvmdo75OV030NHgI # XihxYEeSgUIxfbI5OmgMq/VDCQp2r/fy/5NVa3KjCQoNqmmEM6orAJ2XKjYhEJzo # p4nWCcJ970U6rXpBPK4XGNKBFhhLa74TM/ysTFIrEXOJG1fUuXfcdWb0Ex0FAeTT # r6gmmCqreJNejNHffG/VEeF7LNvUquYFRndiCUhgy624rW6ptcnQTiRfE0QL/gLF # 41kA2vZMYzcc16EiYXQQBaF3XAtMduh1dpXqTPPQEO3Ms5/5B/KtjhSspMcPUvRv # b35IWN+q+L+zEwiphmnCGFTuyOMqc5QE0ruGN3Mx0Vv6x/hcOmaXxrHQGpNKI5Pn # 79Yk89AclqU2mXHz1ZHWp+KBc3D6VP7L32JlwxhJx3asa085xv0XPD58MRW1WaGv # aQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFNLHIIa4FAD494z35hvzCmm0415iMB8G # A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG # Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy # MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w # XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy # dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG # A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD # AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQBAYlhYoUQ+4aaQ54MFNfE6Ey8v4rWv+LtD # RSjMM2X9g4uanA9cU7VitdpIPV/zE6v4AEhe/Vng2UAR5qj2SV3sz+fDqN6VLWUZ # sKR0QR2JYXKnFPRVj16ezZyP7zd5H8IsvscEconeX+aRHF0xGGM4tDLrS84vj6Rm # 0bgoWLXWnMTZ5kP4ownGmm0LsmInuu0GKrDZnkeTVmfk8gTTy8d1y3P2IYc2UI4i # JYXCuSaKCuFeO0wqyscpvhGQSno1XAFK3oaybuD1mSoQxT9q77+LAGGQbiSoGlgT # jQQayYsQaPcG1Q4QNwONGqkASCZTbzJlnmkHgkWlKSLTulOailWIY4hS1EZ+w+sX # 0BJ9LcM142h51OlXLMoPLpzHAb6x22ipaAJ5Kf3uyFaOKWw4hnu0zWs+PKPd192n # deK2ogWfaFdfnEvkWDDH2doL+ZA5QBd8Xngs/md3Brnll2BkZ/giZE/fKyolriR3 # aTAWCxFCXKIl/Clu2bbnj9qfVYLpAVQEcPaCfTAf7OZBlXmluETvq1Y/SNhxC6MJ # 1QLCnkXSI//iXYpmRKT783QKRgmo/4ztj3uL9Z7xbbGxISg+P0HTRX15y4TReBbO # 2RFNyCj88gOORk+swT1kaKXUfGB4zjg5XulxSby3uLNxQebE6TE3cAK0+fnY5UpH # aEdlw4e7ijCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI # hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy # MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC # AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg # M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF # dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6 # GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp # Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu # yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E # XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0 # lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q # GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ # +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA # PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw # EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG # NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV # MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj # cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK # BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG # 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x # M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC # VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449 # xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM # nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS # PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d # Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn # GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs # QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL # jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL # 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNN # MIICNQIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjg5MDAtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQBS # x23cMcNB1IQws/LYkRXa7I5JsKCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6HusGTAiGA8yMDIzMDgwNzE3NDQ1 # N1oYDzIwMjMwODA4MTc0NDU3WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDoe6wZ # AgEAMAcCAQACAiAmMAcCAQACAhSaMAoCBQDofP2ZAgEAMDYGCisGAQQBhFkKBAIx # KDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZI # hvcNAQELBQADggEBAAjfnu1VVAudMDvxTGGE0Vvh1LwMGHReM/nDCNlEX1KnfUrE # gC1r2apl0kalT2xROY897F4/9K4JmClgVBbn0/Kujk6wGDdcv7T6DzbaCcQs6Rl6 # ge051iCqOTUwMouDpGkg/yC/zDK/6vZySUxa73C5rBzDhplADNGp77qDwHIslU1t # BOvpGoPln9MAjzFSTQ6/m3frsfwxHKckGdBIHER9bl/Dd0yuZmC7KiCjXnguiLk1 # 54xOKudlrEEijGgbazgClgkv1Fm0zcVvHFuZ5iSmjhwATKPGU60gs0cVAak8AnMD # hQxnXFHDZgTfhhyMuVeAHpYdSRe4Mv4GG3Rje2kxggQNMIIECQIBATCBkzB8MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy # b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAdMdMpoXO0AwcwABAAAB0zAN # BglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8G # CSqGSIb3DQEJBDEiBCCWF4b+RkUolis66wY9Zhfe0KS6szeLDVYS87uiNcCJwDCB # +gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIJJm9OrE4O5PWA1KaFaztr9uP96r # QgEn+tgGtY3xOqr1MIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh # c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD # b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw # MTACEzMAAAHTHTKaFztAMHMAAQAAAdMwIgQg0juBLHqPCLP2Wzofz6133VYfneZx # mTQFzbnWP5m7yN4wDQYJKoZIhvcNAQELBQAEggIApaFWbYXQ2SAa8msordNLpig7 # lPiwpR191SRW5Dv8rt8r3mCsY691rpYLC+tEsAjs+qY4cOQKkhmbabHvCzi+g25Y # 9lt7jlFyO2fcyRNZMBa+5udZauod6jWrTJvF39Ld2iIXUj6RnXhRTl+jFW9YYJzl # AUadYM8tvL1gFQD0m2VRgvijQ/Hmi7H4ywk4KnRdu45sKTO4BiIX4c6BGBhe6gQ/ # VB6ycc/n1S5Mlf7a5CNFXhazaTp84Ty9rMVlUUIXiB0+kynGT0wdcdXLISDAOIr/ # NzCIFshNiW9XmQvzVkGypLP73+2IC1rywiBih+ipEotUJSQ+40nNxtbqzSgQOIfv # lke8J0XN33soYGY2p7131jDV3/5KCsUcwVdPIscBXu79mOjlLrfsLRH2b2bSAcBw # BU/MKhqjg2KtHbrJZNPJMB7CjFxTDx2nvhLipsIXs1wT3U1cjegNgwRiUcSGPXNV # YffeYs5rKhkC03NUD8sbvLG6H+RHUggr+Y600ENqValHrisMhEfdB3EtryfG0YoQ # jiUNlO2arr83H+qSVdfotTuAOO9E3JhsMHIiF3vx7B+aucN/NawmbyDkiJoZw9SF # QQPOMH7DmYboc5UVTZR0chgNqQtRa/s87Ukc9g24tWMbiyYqrMM66bKe1EkKpUkm # 2VmyPuLL0DMiGRujhKA= # SIG # End signature block |