Citrix Windows Virtual Delivery Agent must only allow the use of DoD PKI established certificate authorities for verification of the establishment of protected sessions.
Untrusted Certificate Authorities (CA) can issue certificates, but they may be issued by organizations or individuals that seek to compromise DoD systems or by organizations with insufficient security controls. If the CA used for verifying the certificate is not a DoD-approved CA, trust of this CA has not been established. The DoD will only accept PKI certificates obtained from a DoD-approved internal or external certificate authority. Reliance on CAs for the establishment of secure sessions includes, for example, the use of SSL/TLS certificates. This requirement focuses on communications protection for the application session rather than for the network packet. This requirement applies to applications that utilize communications sessions. This includes, but is not limited to, web-based applications and Service-Oriented Architectures (SOA).
Configure TLS on a VDA using the PowerShell script: 1. Install the TLS Certificate in the Local Computer >> Personal >> Certificates area of the certificate store. 2. If more than one certificate resides in that location, supply the thumbprint of the certificate to the PowerShell script. The Enable-VdaSSL.ps1 script enables or disables the TLS listener on a VDA. This script is available in the Support >> Tools >> SslSupport folder on the installation media. When you enable TLS, the script disables all existing Windows Firewall rules for the specified TCP port. It then adds a new rule that allows the ICA Service to accept incoming connections only on the TLS TCP and UDP ports. It also disables the Windows Firewall rules for: - Citrix ICA (default: 1494) - Citrix CGP (default: 2598) - Citrix WebSocket (default: 8008) The effect is that users can only connect using TLS or DTLS. They cannot use ICA/HDX, ICA/HDX with Session Reliability, or HDX over WebSocket, without TLS or DTLS. The PowerShell script configures TLS on static VDAs; it does not configure TLS on pooled VDAs that are provisioned by Machine Creation Services or Provisioning Services, where the machine image resets on each restart. Manually configure TLS on a VDA: When configuring TLS on a VDA manually, you grant generic read access to the TLS certificate's private key for the appropriate service on each VDA: NT SERVICE\PorticaService for a VDA for Windows Desktop OS, or NT SERVICE\TermService for a VDA for Windows Server OS. On the machine where the VDA is installed: 1. Launch the Microsoft Management Console (MMC): Start >> Run >> mmc.exe. 2. Add the Certificates snap-in to the MMC: a) Select File >> Add/Remove Snap-in. b) Select "Certificates" and then click "Add". c) When prompted with "This snap-in will always manage certificates for:", choose "Computer account" and then click "Next". d) When prompted with "Select the computer you want this snap-in to manage", choose "Local computer" and then click "Finish". 3. Under Certificates (Local Computer) >> Personal >> Certificates, right-click the certificate and then select All Tasks >> Manage Private Keys. 4. The Access Control List Editor displays "Permissions for (FriendlyName) private keys" where (FriendlyName) is the name of your TLS certificate. Add one of the following services and give it Read access: - For a VDA for Windows Desktop OS, "PORTICASERVICE" - For a VDA for Windows Server OS, "TERMSERVICE" 5. Double-click the installed TLS certificate. In the certificate dialog, select the Details tab and then scroll to the bottom. Click "Thumbprint". 6. Run regedit and go to HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd. a) Edit the SSL Thumbprint key and copy the value of the TLS certificate's thumbprint into this binary value. You can safely ignore unknown items in the Edit Binary Value dialog box (such as "0000" and special characters). b) Edit the SSLEnabled key and change the DWORD value to "1". (To disable SSL later, change the DWORD value to "0".) c) To change the default settings (optional), use the following in the same registry path: SSLPort DWORD – SSL port number. Default: 443. SSLMinVersion DWORD – 1 = SSL 3.0, 2 = TLS 1.0, 3 = TLS 1.1, 4 = TLS 1.2. Default: 2 (TLS 1.0). SSLCipherSuite DWORD – 1 = GOV, 2 = COM, 3 = ALL. Default: 3 (ALL). 7. Ensure the TLS TCP port is open in the Windows Firewall if it is not the default "443". (When you create the inbound rule in Windows Firewall, make sure its properties have the "Allow the connection" and "Enabled" entries selected.) 8. Ensure that no other applications or services (such as IIS) are using the TLS TCP port. 9. For VDAs for Windows Server OS, restart the machine for the changes to take effect. (You do not need to restart machines containing VDAs for Windows Desktop OS.) Configure TLS on Delivery Groups: Complete this procedure for each Delivery Group that contains VDAs that have been configured for TLS connections. 1. From Studio, open the PowerShell console. 2. Run asnp Citrix.* to load the Citrix product cmdlets. 3. Run Get-BrokerAccessPolicyRule -DesktopGroupName '<delivery-group-name>' | Set-BrokerAccessPolicyRule -HdxSslEnabled $true. 4. Run Set-BrokerSite -DnsResolutionEnabled $true.
Verify TLS Certificate is installed in the Local Computer >> Personal >> Certificates area of the certificate store. 1. Launch the Microsoft Management Console (MMC): Start >> Run >> mmc.exe. 2. Add the Certificates snap-in to the MMC: - Select File >> Add/Remove Snap-in. - Select "Certificates" and then click "Add". 3. When prompted with "This snap-in will always manage certificates for:", choose "Computer account" and then click "Next". 4. When prompted with "Select the computer you want this snap-in to manage", choose "Local computer" and then click "Finish". 5. Under Certificates (Local Computer) >> Personal >> Certificates, right–click the certificate and then select All Tasks >> Manage Private Keys. 6. The Access Control List Editor displays "Permissions for (FriendlyName) private keys" where (FriendlyName) is the name of the SSL certificate. Verify one of the following services is listed with Read access: - For a VDA for Windows Desktop OS, "PORTICASERVICE" - For a VDA for Windows Server OS, "TERMSERVICE" 7. Ensure the SSL TCP port is open in the Windows Firewall if it is not the default "443". If one of the associated services is not listed with Read access, this is a finding. If the SSL TCP port is not open in the Windows Firewall if it is not the default "443", this is a finding.