Activer TLS sur le serveur d’impression universel
Le protocole TLS (Transport Layer Security) est pris en charge pour les connexions TCP entre le Virtual Delivery Agent (VDA) et le serveur d’impression universel.
Avertissement :
Pour les tâches qui impliquent de travailler dans le registre Windows (édition), une modification incorrecte du registre peut entraîner de graves problèmes pouvant nécessiter la réinstallation de votre système d’exploitation. Citrix® ne peut garantir que les problèmes résultant d’une utilisation incorrecte de l’Éditeur du Registre pourront être résolus. Utilisez l’Éditeur du Registre à vos propres risques. Assurez-vous de sauvegarder le registre avant de le modifier.
Types de connexions d’impression entre le VDA et le serveur d’impression universel
Connexions en texte clair
Les connexions suivantes liées à l’impression proviennent du VDA et se connectent aux ports du serveur d’impression universel. Ces connexions ne sont établies que lorsque le paramètre de stratégie SSL activé est défini sur Désactivé (valeur par défaut).
- Connexions de service web d’impression en texte clair (port TCP 8080)
- Connexions de flux de données d’impression en texte clair (CGP) (port TCP 7229)
L’article de support Microsoft Vue d’ensemble du service et exigences en matière de ports réseau pour Windows décrit les ports utilisés par le service Spouleur d’impression Microsoft Windows. Les paramètres SSL/TLS de ce document ne s’appliquent pas aux connexions NetBIOS et RPC établies par le service Spouleur d’impression Windows. Le VDA utilise le fournisseur d’impression réseau Windows (win32spl.dll) comme solution de secours si le paramètre de stratégie Activer le serveur d’impression universel est défini sur Activé avec repli vers l’impression à distance native de Windows.

Connexions chiffrées
Ces connexions SSL/TLS liées à l’impression proviennent du VDA et se connectent aux ports du serveur d’impression universel. Ces connexions ne sont établies que lorsque le paramètre de stratégie SSL activé est défini sur Activé.
- Connexions de service web d’impression chiffrées (port TCP 8443)
- Connexions de flux de données d’impression chiffrées (CGP) (port TCP 443)

Configuration du client SSL/TLS
Le VDA fonctionne comme client SSL/TLS.
Utilisez la Stratégie de groupe Microsoft et le registre pour configurer Microsoft SCHANNEL SSP pour les connexions de service web d’impression chiffrées (port TCP 8443). L’article de support Microsoft Paramètres de registre TLS décrit les paramètres de registre pour Microsoft SCHANNEL SSP.
À l’aide de l’Éditeur de stratégie de groupe sur le VDA, accédez à Configuration ordinateur > Modèles d’administration > Réseau > Paramètres de configuration SSL > Ordre des suites de chiffrement SSL. Sélectionnez l’ordre suivant lorsque TLS 1.3 est défini :
TLS_AES_256_GCM_SHA384 TLS_AES_128_GCM_SHA256
Sélectionnez l’ordre suivant lorsque TLS 1.2 est défini :
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384_P384 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384_P256 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA_P384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA_P256
Remarque :
Lorsque ce paramètre de stratégie de groupe est configuré, le VDA sélectionne une suite de chiffrement pour les connexions de service web d’impression chiffrées (port par défaut : 8443) uniquement si les connexions apparaissent dans les deux listes de suites de chiffrement SSL :
- Liste d’ordre des suites de chiffrement SSL de la Stratégie de groupe
- Liste correspondant au paramètre de stratégie de suite de chiffrement SSL sélectionné (COM, GOV ou ALL)
Cette configuration de stratégie de groupe affecte également d’autres applications et services TLS sur le VDA. Si vos applications nécessitent des suites de chiffrement spécifiques, vous devrez peut-être les ajouter à cette liste d’ordre des suites de chiffrement de la Stratégie de groupe.
Important :
Les modifications de la Stratégie de groupe pour la configuration TLS ne prennent effet qu’après un redémarrage du système d’exploitation.
Utilisez une stratégie Citrix pour configurer les paramètres SSL/TLS pour les connexions de flux de données d’impression chiffrées (CGP) (port TCP 443).
Configuration du serveur SSL/TLS
Le serveur d’impression universel fonctionne comme serveur SSL/TLS.
Utilisez le script PowerShell Enable-UpsSsl.ps1 pour configurer les paramètres SSL/TLS.
Installer un certificat TLS sur le serveur d’impression universel
Pour HTTPS, vous devez installer un certificat de serveur SSL sur le serveur d’impression universel qui est approuvé par les VDA. Utilisez les services de certificats Microsoft Active Directory ou une autre autorité de certification pour demander un certificat pour le serveur d’impression universel.
Gardez à l’esprit les considérations suivantes lors de l’inscription/la demande d’un certificat à l’aide des services de certificats Microsoft Active Directory :
- Placez le certificat dans le magasin de certificats Personnel de l’ordinateur local.
- Définissez l’attribut Nom commun du nom distinctif du sujet (Subject DN) du certificat sur le nom de domaine complet (FQDN) du serveur d’impression universel. Spécifiez ceci dans le modèle de certificat.
- Définissez le fournisseur de services cryptographiques (CSP) utilisé pour générer la demande de certificat et la clé privée sur Microsoft Enhanced RSA and AES Cryptographic Provider (Encryption). Spécifiez ceci dans le modèle de certificat.
- Définissez la taille de clé sur au moins 2048 bits. Spécifiez ceci dans le modèle de certificat.
Pour plus d’informations sur la création et l’installation de certificats, consultez Gérer les certificats.
Configuration de SSL sur le serveur d’impression universel
Le service XTE sur le serveur d’impression universel écoute les connexions entrantes. Il fonctionne comme un serveur SSL lorsque SSL est activé. Les connexions entrantes sont de deux types : les connexions de service web d’impression, qui contiennent des commandes d’impression, et les connexions de flux de données d’impression, qui contiennent des travaux d’impression. SSL peut être activé sur ces connexions. SSL protège la confidentialité et l’intégrité de ces connexions. Par défaut, SSL est désactivé.
Le script PowerShell utilisé pour configurer SSL se trouve sur le support d’installation et porte ce nom de fichier : \Support\Tools\SslSupport\Enable-UpsSsl.ps1.
Configuration des numéros de port d’écoute sur le serveur d’impression universel
Voici les ports par défaut pour le service XTE :
- Port TCP du service web d’impression en clair (HTTP) : 8080
- Port TCP du flux de données d’impression en clair (CGP) : 7229
- Port TCP du service web d’impression chiffré (HTTPS) : 8443
- Port TCP du flux de données d’impression chiffré (CGP) : 443
Pour modifier les ports utilisés par le service XTE sur le serveur d’impression universel, exécutez les commandes suivantes dans PowerShell en tant qu’administrateur (consultez la section ultérieure pour des notes sur l’utilisation du script PowerShell Enable-UpsSsl.ps1) :
Stop-Service CitrixXTEServer, UpSvc-
Enable-UpsSsl.ps1 -Enable -HTTPSPort <port> -CGPSSLPort <port>ouEnable-UpsSsl.ps1 -Disable -HTTPPort <port> -CGPPort <port> Start-Service CitrixXTEServer
Paramètres TLS sur le serveur d’impression universel
Si vous avez plusieurs serveurs d’impression universels dans une configuration équilibrée en charge, assurez-vous que les paramètres TLS sont configurés de manière cohérente sur tous les serveurs d’impression universels.
Lorsque vous configurez TLS sur le serveur d’impression universel, les autorisations sur le certificat TLS installé sont modifiées, donnant au service d’impression universel un accès en lecture à la clé privée du certificat, et informant le service d’impression universel des éléments suivants :
- Quel certificat dans le magasin de certificats utiliser pour TLS.
- Quels numéros de port TCP utiliser pour les connexions TLS.
Le pare-feu Windows (s’il est activé) doit être configuré pour autoriser les connexions entrantes sur ces ports TCP. Cette configuration est effectuée automatiquement lorsque vous utilisez le script PowerShell Enable-UpsSsl.ps1.
- Quelles versions du protocole TLS autoriser.
Universal Print Server prend en charge les versions 1.3 et 1.2 du protocole TLS. Spécifiez la version minimale autorisée.
La version par défaut du protocole TLS est 1.2.
Remarque :
TLS 1.1 et 1.0 ne sont plus pris en charge à partir de la version 2311 de Citrix Virtual Apps and Desktops.
- Quelles suites de chiffrement TLS autoriser.
Une suite de chiffrement sélectionne les algorithmes cryptographiques utilisés pour une connexion. Les VDA et Universal Print Server peuvent prendre en charge différents ensembles de suites de chiffrement. Lorsqu’un VDA se connecte et envoie une liste de suites de chiffrement TLS prises en charge, Universal Print Server fait correspondre l’une des suites de chiffrement du client avec l’une des suites de chiffrement de sa propre liste de suites de chiffrement configurées et accepte la connexion. S’il n’y a pas de suite de chiffrement correspondante, Universal Print Server rejette la connexion.
Universal Print Server prend en charge les ensembles de suites de chiffrement suivants, nommés GOV(ernment), COM(mercial) et ALL, pour les modes OPEN, FIPS et SP800-52 du kit de chiffrement natif. Les suites de chiffrement acceptables dépendent également du paramètre de stratégie Mode FIPS SSL et du mode FIPS de Windows. Consultez cet article de support Microsoft pour plus d’informations sur le mode FIPS de Windows.
| Suite de chiffrement (par ordre de priorité décroissant) | OPEN ALL | OPEN COM | OPEN GOV | FIPS ALL | FIPS COM | FIPS GOV | SP800-52 ALL | SP800-52 COM | SP800-52 GOV |
|---|---|---|---|---|---|---|---|---|---|
| TLS_ECDHE_RSA_ AES256_GCM_SHA384 | X | X | X | X | X | X | |||
| TLS_ECDHE_RSA_ AES256_CBC_SHA384 | X | X | X | X | X | X | |||
| TLS_ECDHE_RSA_ AES256_CBC_SHA | X | X | X | X | X | X |
Configurer TLS sur un serveur d’impression universel à l’aide du script PowerShell
Installez le certificat TLS dans la zone Ordinateur local > Personnel > Certificats du magasin de certificats. Si plusieurs certificats se trouvent à cet emplacement, fournissez l’empreinte numérique du certificat au script PowerShell Enable-UpsSsl.ps1.
Remarque :
Le script PowerShell trouve le certificat correct en fonction du FQDN du serveur d’impression universel. Vous n’avez pas besoin de fournir l’empreinte numérique du certificat lorsqu’un seul certificat est présent pour le FQDN du serveur d’impression universel.
Le script Enable-UpsSsl.ps1 active ou désactive les connexions TLS provenant du VDA vers le serveur d’impression universel. Ce script est disponible dans le dossier Support > Tools > SslSupport sur le support d’installation.
Lorsque vous activez TLS, le script désactive toutes les règles de pare-feu Windows existantes pour les ports TCP du serveur d’impression universel. Il ajoute ensuite de nouvelles règles qui permettent au service XTE d’accepter les connexions entrantes uniquement sur les ports TCP et UDP TLS. Il désactive également les règles du pare-feu Windows pour :
- Connexions de service Web d’impression en texte clair (par défaut : 8080)
- Connexions de flux de données d’impression en texte clair (CGP) (par défaut : 7229)
L’effet est que le VDA ne peut établir ces connexions qu’en utilisant TLS.
Remarque :
L’activation de TLS n’affecte pas les connexions RPC/SMB du spouleur d’impression Windows provenant du VDA et allant vers le serveur d’impression universel.
Important :
Spécifiez Activer ou Désactiver comme premier paramètre. Le paramètre CertificateThumbprint est facultatif si un seul certificat dans le magasin de certificats personnel de l’ordinateur local possède le FQDN du serveur d’impression universel. Les autres paramètres sont facultatifs.
Syntaxe
Enable-UpsSSL.ps1 -Enable [-HTTPPort <port>] [-CGPPort <port>] [–HTTPSPort <port>] [-CGPSSLPort <port>] [-SSLMinVersion <version>] [-SSLCipherSuite <name>] [-CertificateThumbprint <thumbprint>] [-FIPSMode <Boolean>] [-ComplianceMode <mode>]
Enable-UpsSSL.ps1 -Disable [-HTTPPort <portnum>] [-CGPPort <portnum>]
| Paramètre | Description |
|---|---|
| Activer | Active SSL/TLS sur le serveur XTE. Ce paramètre ou le paramètre Désactiver est requis. |
| Désactiver | Désactive SSL/TLS sur le serveur XTE. Ce paramètre ou le paramètre Activer est requis. |
Empreinte du certificat "<thumbprint>"
|
Empreinte du certificat TLS dans le magasin de certificats personnels de l’ordinateur local, entre guillemets. Le script utilise l’empreinte spécifiée pour sélectionner le certificat que vous souhaitez utiliser. |
Port HTTP <port>
|
Port du service web d’impression en texte clair (HTTP/SOAP). Par défaut : 8080 |
Port CGP <port>
|
Port du flux de données d’impression en texte clair (CGP). Par défaut : 7229 |
Port HTTPS <port>
|
Port du service web d’impression chiffré (HTTPS/SOAP). Par défaut : 8443 |
Port CGP SSL <port>
|
Port du flux de données d’impression chiffré (CGP). Par défaut : 443 |
Version minimale SSL "<version>"
|
Version minimale du protocole TLS, entre guillemets. Valeurs valides : “TLS_1.2” et “TLS_1.3”. Par défaut : TLS_1.2. |
Suite de chiffrement SSL "<name>"
|
Nom du package de la suite de chiffrement TLS, entre guillemets. Valeurs valides : “GOV”, “COM” et “ALL” (par défaut). |
Mode FIPS <Boolean>
|
Active ou désactive le mode FIPS 140 dans le serveur XTE. Valeurs valides : $true pour activer le mode FIPS 140, $false pour désactiver le mode FIPS 140. |
Exemples
Le script suivant active TLS. L’empreinte numérique (représentée par « 12345678987654321 » dans cet exemple) est utilisée pour sélectionner le certificat à utiliser.
Enable-UpsSsl.ps1 –Enable -CertificateThumbprint "12345678987654321"
Le script suivant désactive TLS.
Enable-UpsSsl.ps1 –Disable
Configuration du mode FIPS
L’activation du mode FIPS (US Federal Information Processing Standards) garantit que seule la cryptographie conforme à la norme FIPS 140 est utilisée pour les connexions chiffrées du serveur d’impression universel.
Configurez le mode FIPS sur le serveur avant de configurer le mode FIPS sur le client.
Consultez le site de documentation de Microsoft pour l’activation/désactivation du mode FIPS de Windows.
Activation du mode FIPS sur le client
Sur le Delivery Controller™, exécutez Web Studio et définissez le paramètre de stratégie Citrix Mode FIPS UPS sur Activé. Activez la stratégie Citrix.
Effectuez cette opération sur chaque VDA :
- Activez le mode FIPS de Windows.
- Redémarrez le VDA.
Activation du mode FIPS sur le serveur
Effectuez cette opération sur chaque Universal Print Server :
- Activez le mode FIPS de Windows.
- Exécutez cette commande PowerShell en tant qu’administrateur :
stop-service CitrixXTEServer, UpSvc - Exécutez le script
Enable-UpsSsl.ps1avec les paramètres-Enable -FIPSMode $true. - Redémarrez l’Universal Print Server.
Désactivation du mode FIPS sur le client
Dans Web Studio, définissez le paramètre de stratégie Citrix Mode FIPS UPS sur Désactivé. Activez la stratégie Citrix. Vous pouvez également supprimer le paramètre de stratégie Citrix Mode FIPS UPS.
Effectuez cette opération sur chaque VDA :
- Désactivez le mode FIPS de Windows.
- Redémarrez le VDA.
Désactivation du mode FIPS sur le serveur
Effectuez cette opération sur chaque Universal Print Server :
- Désactivez le mode FIPS de Windows.
- Exécutez cette commande PowerShell en tant qu’administrateur :
stop-service CitrixXTEServer, UpSvc - Exécutez le script
Enable-UpsSsl.ps1avec les paramètres-Enable -FIPSMode $false. - Redémarrez le serveur d’impression universel.
Remarque :
Le mode FIPS n’est pas pris en charge lorsque la version du protocole SSL est définie sur TLS 1.3.
Configuration de la version du protocole SSL/TLS
La version par défaut du protocole SSL/TLS est TLS 1.2. TLS 1.2 et TLS 1.3 sont les versions de protocole SSL/TLS recommandées pour une utilisation en production. Pour le dépannage, il peut être nécessaire de modifier temporairement la version du protocole SSL/TLS dans un environnement hors production.
SSL 2.0 et SSL 3.0 ne sont pas pris en charge sur le serveur d’impression universel.
Définition de la version du protocole SSL/TLS sur le serveur
Effectuez cette opération sur chaque serveur d’impression universel :
- Exécutez cette commande PowerShell en tant qu’administrateur :
stop-service CitrixXTEServer, UpSvc - Exécutez le script
Enable-UpsSsl.ps1avec les paramètres de version-Enable -SSLMinVersion. N’oubliez pas de le redéfinir sur TLS 1.2 ou TLS 1.3 une fois le test terminé. - Redémarrez le serveur d’impression universel.
Définition de la version du protocole SSL/TLS sur le client
Dans Studio, définissez le paramètre de stratégie Version du protocole SSL sur la version de protocole souhaitée et activez la stratégie.
Assurez-vous que le système d’exploitation du VDA prend en charge la version TLS sélectionnée. Pour les versions TLS prises en charge sur Windows, consultez Microsoft Learn - Prise en charge de la version du protocole TLS. Pour configurer le registre afin de remplacer les valeurs par défaut, consultez Microsoft Learn - Paramètres de version des protocoles TLS, DTLS et SSL.
Dépannage
Si une erreur de connexion se produit, vérifiez le fichier C:\Program Files (x86)\Citrix\XTE\logs\error.log sur le serveur d’impression universel.
Le message d’erreur SSL handshake from client failed apparaît dans ce fichier journal si l’établissement de liaison SSL/TLS échoue. De tels échecs peuvent se produire si la version du protocole SSL/TLS sur le VDA et le serveur d’impression universel ne correspondent pas.
Utilisez le FQDN du serveur d’impression universel dans les paramètres de stratégie suivants qui contiennent des noms d’hôte de serveur d’impression universel :
- Imprimantes de session
- Attributions d’imprimantes
- Serveurs d’impression universels pour l’équilibrage de charge
Assurez-vous que l’horloge système (date, heure et fuseau horaire) est correcte sur les serveurs d’impression universels et les VDA.
Dans cet article
- Types de connexions d’impression entre le VDA et le serveur d’impression universel
- Configuration de SSL sur le serveur d’impression universel
- Configuration des numéros de port d’écoute sur le serveur d’impression universel
- Paramètres TLS sur le serveur d’impression universel
- Configuration du mode FIPS
- Configuration de la version du protocole SSL/TLS
- Dépannage