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 # MIInvwYJKoZIhvcNAQcCoIInsDCCJ6wCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAgTLD9qWhZhYai # w6RQfdfB1A6Taqh++u2bnWhpsriAO6CCDXYwggX0MIID3KADAgECAhMzAAADrzBA # DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA # hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG # 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN # xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL # go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB # tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw # RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW # MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci # tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG # CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0 # MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd # mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ # 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY # 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp # XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn # TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT # e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG # OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O # PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk # ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx # HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt # CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq # 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 # /Xmfwb1tbWrJUnMTDXpQzTGCGZ8wghmbAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIKTmW5fBbjaIi8OqGC1G0w2w # OYWhLi3uKL5LB2ng9oiVMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAuG6nAn08fjWuEc/GKsffeTd3QVIBqB+cM3x99w6XAvCR11z4/0hLfoP4 # hUke9icE54+MTkbNLZ4iRksypPqBavt3ZyJfAaQ8A9nkeKiXs937A+QdyrI+sQEY # lIFp9sJY9hupPR5LITuUuXhKhdPPYtZFxM8lapGE8YMFQjw2agBQR5jsVXFDH9FQ # E35mPs6LshLYlFGWhbOpzshIdyMNqZbIcwQT6BEtuQ/Ob5LJb6PtWAKQcHlxQYsC # Pt4zRkgoZq0SXvKJpG26Zi1q6v1iipMvdhatpGDcQSee5sgKLgDuanYLTX21NuRR # kXYOCLMfPVlZD3bqzTRo5/PEOPowj6GCFykwghclBgorBgEEAYI3AwMBMYIXFTCC # FxEGCSqGSIb3DQEHAqCCFwIwghb+AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsq # hkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCA9jjZC5NO417O4o6ozsnz3NkJMvtIFTR0lqiIIE9i3UAIGZbqk0RXn # GBMyMDI0MDIxMjE0MDUzMC4yNTJaMASAAgH0oIHYpIHVMIHSMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl # bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO # OkZDNDEtNEJENC1EMjIwMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT # ZXJ2aWNloIIReDCCBycwggUPoAMCAQICEzMAAAHimZmV8dzjIOsAAQAAAeIwDQYJ # KoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjMx # MDEyMTkwNzI1WhcNMjUwMTEwMTkwNzI1WjCB0jELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3Bl # cmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjpGQzQxLTRC # RDQtRDIyMDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC # AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALVjtZhV+kFmb8cKQpg2mzis # DlRI978Gb2amGvbAmCd04JVGeTe/QGzM8KbQrMDol7DC7jS03JkcrPsWi9WpVwsI # ckRQ8AkX1idBG9HhyCspAavfuvz55khl7brPQx7H99UJbsE3wMmpmJasPWpgF05z # ZlvpWQDULDcIYyl5lXI4HVZ5N6MSxWO8zwWr4r9xkMmUXs7ICxDJr5a39SSePAJR # IyznaIc0WzZ6MFcTRzLLNyPBE4KrVv1LFd96FNxAzwnetSePg88EmRezr2T3HTFE # lneJXyQYd6YQ7eCIc7yllWoY03CEg9ghorp9qUKcBUfFcS4XElf3GSERnlzJsK7s # /ZGPU4daHT2jWGoYha2QCOmkgjOmBFCqQFFwFmsPrZj4eQszYxq4c4HqPnUu4hT4 # aqpvUZ3qIOXbdyU42pNL93cn0rPTTleOUsOQbgvlRdthFCBepxfb6nbsp3fcZaPB # fTbtXVa8nLQuMCBqyfsebuqnbwj+lHQfqKpivpyd7KCWACoj78XUwYqy1HyYnStT # me4T9vK6u2O/KThfROeJHiSg44ymFj+34IcFEhPogaKvNNsTVm4QbqphCyknrwBy # qorBCLH6bllRtJMJwmu7GRdTQsIx2HMKqphEtpSm1z3ufASdPrgPhsQIRFkHZGui # hL1Jjj4Lu3CbAmha0lOrAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQURIQOEdq+7Qds # lptJiCRNpXgJ2gUwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYD # VR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9j # cmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwG # CCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIw # MjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcD # CDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAORURDGrVRTbnulf # sg2cTsyyh7YXvhVU7NZMkITAQYsFEPVgvSviCylr5ap3ka76Yz0t/6lxuczI6w7t # Xq8n4WxUUgcj5wAhnNorhnD8ljYqbck37fggYK3+wEwLhP1PGC5tvXK0xYomU1nU # +lXOy9ZRnShI/HZdFrw2srgtsbWow9OMuADS5lg7okrXa2daCOGnxuaD1IO+65E7 # qv2O0W0sGj7AWdOjNdpexPrspL2KEcOMeJVmkk/O0ganhFzzHAnWjtNWneU11WQ6 # Bxv8OpN1fY9wzQoiycgvOOJM93od55EGeXxfF8bofLVlUE3zIikoSed+8s61NDP+ # x9RMya2mwK/Ys1xdvDlZTHndIKssfmu3vu/a+BFf2uIoycVTvBQpv/drRJD68eo4 # 01mkCRFkmy/+BmQlRrx2rapqAu5k0Nev+iUdBUKmX/iOaKZ75vuQg7hCiBA5xIm5 # ZIXDSlX47wwFar3/BgTwntMq9ra6QRAeS/o/uYWkmvqvE8Aq38QmKgTiBnWSS/uV # PcaHEyArnyFh5G+qeCGmL44MfEnFEhxc3saPmXhe6MhSgCIGJUZDA7336nQD8fn4 # y6534Lel+LuT5F5bFt0mLwd+H5GxGzObZmm/c3pEWtHv1ug7dS/Dfrcd1sn2E4gk # 4W1L1jdRBbK9xwkMmwY+CHZeMSvBMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJ # mQAAAAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNh # dGUgQXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1 # WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD # Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEB # BQADggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjK # NVf2AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhg # fWpSg0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJp # rx2rrPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/d # vI2k45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka9 # 7aSueik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKR # Hh09/SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9itu # qBJR6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyO # ArxCaC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItb # oKaDIV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6 # bMURHXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6t # AgMBAAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQW # BBQqp1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacb # UzUZ6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYz # aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnku # aHRtMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIA # QwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2 # VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwu # bWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEw # LTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93 # d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYt # MjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/q # XBS2Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6 # U03dmLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVt # I1TkeFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis # 9/kpicO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTp # kbKpW99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0 # sHrYUP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138e # W0QBjloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJ # sWkBRH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7 # Fx0ViY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0 # dFtq0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQ # tB1VM1izoXBm8qGCAtQwggI9AgEBMIIBAKGB2KSB1TCB0jELMAkGA1UEBhMCVVMx # EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT # FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxh # bmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjpG # QzQxLTRCRDQtRDIyMDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy # dmljZaIjCgEBMAcGBSsOAwIaAxUAFpuZafp0bnpJdIhfiB1d8pTohm+ggYMwgYCk # fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD # Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF # AOl0S1kwIhgPMjAyNDAyMTIxNTQ2MzNaGA8yMDI0MDIxMzE1NDYzM1owdDA6Bgor # BgEEAYRZCgQBMSwwKjAKAgUA6XRLWQIBADAHAgEAAgIVwzAHAgEAAgIUTzAKAgUA # 6XWc2QIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAID # B6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAKSvdq5/OwSqLipXDPR/ # fz5CiLbm0lCxv+PjDUqfK5ccPWEVkKsD9zmiB4N1ZQarjww5WUro+QdoUzSzV/Ly # OaxhyB8c2JwDLLMQK8JyHWefD6cG4cvgYDg5iEzioerBrjSnrGxsb3qVV0n31Fhc # Z9Hh71O9RocFcjpVHRSVEF7MMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMx # EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT # FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt # U3RhbXAgUENBIDIwMTACEzMAAAHimZmV8dzjIOsAAQAAAeIwDQYJYIZIAWUDBAIB # BQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQx # IgQgWnc8K3gCgGcUfyvmO+Rek1afwJtm/ac73nbLH6b10F0wgfoGCyqGSIb3DQEJ # EAIvMYHqMIHnMIHkMIG9BCAriSpKEP0muMbBUETODoL4d5LU6I/bjucIZkOJCI9/ # /zCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB4pmZ # lfHc4yDrAAEAAAHiMCIEII1oQoIqDDF/dls2LazpjkRTP0GoZvbNELQJtb8XKdao # MA0GCSqGSIb3DQEBCwUABIICAKXPIGYIE6qQVxsUfLpOe1Pt1yb37jK5esSg0I2g # gbdFUMxoxGFzX0iez68oLoh+c7tCOuNB2bq8uJPmOSkjKojTjLvTVJcxd7yyM0tJ # XBZgCt0IhcHPe6uLVtnRjLzzqPV2BxaL3BM9qrOfZlL2xbG1orI8EcUBt2QTF3an # sd1COUjGwkN1zGRbPodJgcSi1KM4tDJjwyQBXp/FZboyadjqgqIsxIpmzBotjXnO # b8NqE3UzKVNUHifAlJMmYn9+63XNzY/uwplM3IUA6ZM1WrPh/Dah38lnHlh1hrCl # pjXPVnuGRHInq9tKN3CSqIuFlpOVA7MKRc5urKB9Fmcr532iUGouCZf18xNMLnfD # EbOEnuhV1JGSrUGB/gR58EYJAbUCa2Lw2iOung3lRv5rHnr5WjBURRBnkO7aeC5I # P10lOrQg5+nKURetQ4+6bT4tchFvQCUXbiUJ669KVFIhqv/pK1Gd323q4lHi3Eeg # KQLs79cxRejy5LnRFk3sMgXkWcj3N19OT0VpwjXqoBHTYUHidu/xwPGSY/0YMd05 # 6mFmaN/UHKsH1Dy+h0+t6e0JQNLmIxrWzX9PQnqKQoCgGCpTxwfUuykQ45V9KqXJ # Lanu+mWtSuxrw6bAXComhsJzwftBoZumO/Lesq4AlUi8M7HMxUlMcBS7a6uiBjYl # R9wf # SIG # End signature block |