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 # MIInwgYJKoZIhvcNAQcCoIInszCCJ68CAQExDzANBglghkgBZQMEAgEFADB5Bgor # 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 # /Xmfwb1tbWrJUnMTDXpQzTGCGaIwghmeAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIKTmW5fBbjaIi8OqGC1G0w2w # OYWhLi3uKL5LB2ng9oiVMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAqPnK5WbN+CGdF7ldHAXTiSAZMKVPfSqAETF6q6abHfOW5TpU5LNCpttE # /n6ep1smHtWYBARU94/b5JQLaf7aqzc5NoUCjWlmAKxnWGsPIaUC3DsPq8WC5VUG # fUdv2P9G7G9eWz+M8/1Qu0aPCstWlCLfa3lG8l0fh2shyHuhaQAUEY0RWj8HIk7M # LZvIlaFxd6QeYhxYsSjEoartCatScokMCm+wYg36BCFwWZDo4Uaaoay4hUZ2oRgi # quvhtEmvdOQmn+aQPtjHjG5k22akeQ/UQ5AdMhqPxj+1E/LqhBVl8jPL0QqtG+cS # OkiGCCugLGrVg2CMHwLQC7WTgL5H9aGCFywwghcoBgorBgEEAYI3AwMBMYIXGDCC # FxQGCSqGSIb3DQEHAqCCFwUwghcBAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsq # hkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCDI9a6MaohsTxm7/wSXjGKDtcpvl55YPty2/diVtQC9rQIGZMmJekan # GBMyMDIzMDgwMzA4MjEyMS4zNzhaMASAAgH0oIHYpIHVMIHSMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl # bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO # OjJBRDQtNEI5Mi1GQTAxMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT # ZXJ2aWNloIIRezCCBycwggUPoAMCAQICEzMAAAGxypBD7gvwA6sAAQAAAbEwDQYJ # KoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjIw # OTIwMjAyMTU5WhcNMjMxMjE0MjAyMTU5WjCB0jELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3Bl # cmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjoyQUQ0LTRC # OTItRkEwMTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC # AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIaiqz7V7BvH7IOMPEeDM2Uw # CpM8LxAUPeJ7Uvu9q0RiDBdBgshC/SDre3/YJBqGpn27a7XWOMviiBUfMNff51Nx # KFoSX62Gpq36YLRZk2hN1wigrCO656z5pVTjJp3Q8jdYAJX3ruJea3ccfTgxAgT3 # Uv/sP4w0+yZAYa2JZalV3MBgIFi3VwKFA4ClQcr+V4SpGzqz8faqabmYypuJ35Zn # 8G/201pAN2jDEOu7QaDC0rGyDdwSTVmXcHM46EFV6N2F69nwfj2DZh74gnA1DB7N # FcZn+4v1kqQWn7AzBJ+lmOxvKrURlV/u19Mw1YP+zVQyzKn5/4r/vuYSRj/thZr+ # FmZAUtTAacLzouBENuaSBuOY1k330eMp8nndSNUsUjj/nn7gcdFqzdQNudJb+Xxm # Rwi9LwjA0/8PlOsKTZ8Xw6EEWPVLfNojSuWpZMTaMzz/wzSPp5J02kpYmkdl50lw # yGRLO5X7iWINKmoXySdQmRdiGMTkvRStXKxIoEm/EJxCaI+k4S3+BWKWC07EV5T3 # UG7wbFb4LfvgbbaKM58HytAyjDnO9fEi0vrp8JFTtGhdtwhEEkraMtGVt+CvnG0Z # lH4mvpPRPuJbqE509e6CqmHwzTuUZPFMFWvJn4fPv0d32Ws9jv2YYmE/0WR1fULs # +TxxpWgn1z0PAOsxSZRPAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQU9Jtnke8NrYSK # 9fFnoVE0pr0OOZMwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYD # VR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9j # cmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwG # CCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIw # MjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcD # CDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBANjnN5JqpeVShIrQ # IaAQnNVOv1cDEmCkD6oQufX9NGOX28Jw/gdkGtMJyagA0lVbumwQla5LPhBm5LjI # UW/5aYhzSlZ7lxeDykw57wp2AqoMAJm7bXcXtJt/HyaRlN35hAhBV+DmGnBIRcE5 # C2bSFFY3asD50KUSCPmKl/0NFadPeoNqbj5ZUna8VAfMSDsdxeyxjs8r/9Vpqy8l # gIVBqRrXtFt6n1+GFpJ+2AjPspfPO7Y+Y/ozv5dTEYum5eDLDdD1thQmHkW8s0BB # DbIOT3d+dWdPETkf50fM/nALkMEdvYo2gyiJrOSG0a9Z2S/6mbJBUrgrkgPp2HjL # kycR4Nhwl67ehAhWxJGKD2gRk88T2KKXLiRHAoYTZVpHbgkYLspBLJs9C77ZkuxX # uvIOGaId7EJCBOVRMJygtx8FXpoSu3jWEdau0WBMXxhVAzEHTu7UKW3Dw+KGgW7R # Rlhrt589SK8lrPSvPM6PPnqEFf6PUsTVO0bOkzKnC3TOgui4JhlWliigtEtg1SlP # MxcdMuc9uYdWSe1/2YWmr9ZrV1RuvpSSKvJLSYDlOf6aJrpnX7YKLMRoyKdzTkcv # Xw1JZfikJeGJjfRs2cT2JIbiNEGK4i5srQbVCvgCvdYVEVZXVW1Iz/LJLK9XbIkM # MjmECJEsa07oadKcO4ed9vY6YYBGMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJ # 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 # tB1VM1izoXBm8qGCAtcwggJAAgEBMIIBAKGB2KSB1TCB0jELMAkGA1UEBhMCVVMx # EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT # FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxh # bmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjoy # QUQ0LTRCOTItRkEwMTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy # dmljZaIjCgEBMAcGBSsOAwIaAxUA7WSxvqQDbA7vyy69Tn0wP5BGxyuggYMwgYCk # fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD # Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF # AOh1WVgwIhgPMjAyMzA4MDMwNjM4MTZaGA8yMDIzMDgwNDA2MzgxNlowdzA9Bgor # BgEEAYRZCgQBMS8wLTAKAgUA6HVZWAIBADAKAgEAAgICAAIB/zAHAgEAAgIUgzAK # AgUA6Haq2AIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB # AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAGcXgXW302MhVOay # aiGH+r324MvYMuBI1aPvSuKS/jajyJBITyUykpiklbspPzfzDjbmL1WdRbOlNYmI # UNdZyigqzOtxgwozcMTAzY4oRmvVw18+YvSjn3h6RfpTtHdUF3CQM+N/fFhL7KzH # pHiI/j8KtZTvZhyhM6ECpGX5eatsMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTACEzMAAAGxypBD7gvwA6sAAQAAAbEwDQYJYIZIAWUD # BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B # CQQxIgQgzNLGPn0aK2qeKgXhOicOW/aVJYzKSSWHLaTSx+idXIQwgfoGCyqGSIb3 # DQEJEAIvMYHqMIHnMIHkMIG9BCCD7Q2LFFvfqeDoy9gpu35t6dYerrDO0cMTlOIo # mzTPbDCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u # MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp # b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB # scqQQ+4L8AOrAAEAAAGxMCIEIGX1ph5ViWF8/JYiY4ZGgxxhjfmvwkkkVnC1JI7N # Su/OMA0GCSqGSIb3DQEBCwUABIICADIe5nQ69c5TGlQE/M26MsZpADfV+fJcn2gH # qGyTQzYMQSJ1EgDLWrB4FyQhunL+Tg0LZgfINDPP+tWakWcxYt89oGpszfdysHTe # JVd5gTlMEfmdEyozeq6NNehMpq0EGRZqE3qh6DVnR7jxk4awI3hRsyY/AR1oOs1V # W6SEo4FuZ6bkctnmZle5JJusDtXpBhaR2rTJiI1NphyRxM+6+US37j+lg5tYuyXH # n/VBMZ36OJzGGeOPSCaY6KDavULHfJMLZgUDODJPPVVg0HAh3xBsWwvqQRk3uqxu # onUdotNQvgFPbI9beEEKduQT+AUe44WxCokFU9PyD1lsEzVgkWuGRLZghND4XfQ/ # HO1sCd90gD8zXOT61Ct8ui2+UENCzOqr1iZK54pqOOh2kinKHDogW0/pT+KxGvRM # ehBgW6wUo/Hi4VAo9x+n672/jxXdjqPLqdOhlEYf2h5B1p8QAjuwV8SPi6IgM/nb # wDcXxoKZ4IzxT5bfULfl4QwQjOfxtjwjGiWz+ENp41FDSrefwR4Ajrg8/AhAxrUh # bqC9CHDng4QzDJ7ysHsCYa68S77V41QmwIm/widqxGFzKmr8k6aM0hNSN2ZYOce1 # ykFzCzIKDLMhDo17f8rENxSZfGGQd0WRQzXck5tabFsSZg+Espg01GdNagaB/wDK # kprDrIwq # SIG # End signature block |