Citrix Gateway

Personnalisation du portail utilisateur pour les utilisateurs VPN

Les installations Citrix Gateway qui servent le portail aux utilisateurs VPN incluent une option permettant de sélectionner un thème de portail afin de créer une apparence personnalisée pour les pages du portail. Vous pouvez choisir parmi un ensemble de thèmes fourni ou utiliser un thème comme modèle pour créer un portail personnalisé ou de marque. À l’aide de l’utilitaire de configuration, vous pouvez modifier un thème en ajoutant de nouveaux logos, images d’arrière-plan, étiquettes de zone de saisie personnalisées et divers autres attributs de la conception du portail basé sur CSS. Les thèmes du portail intégrés incluent du contenu en cinq langues : anglais, français, espagnol, allemand et japonais. Les différents utilisateurs sont servis dans différentes langues, en fonction des paramètres régionaux signalés par leur navigateur Web.

Vous pouvez créer un CLUF personnalisé qui sera présenté aux utilisateurs du VPN avant qu’ils ne soient autorisés à se connecter. La fonctionnalité CLUF prend en charge les versions locales d’un CLUF, qui sont présentées aux utilisateurs en fonction des paramètres régionaux signalés par leur navigateur Web.

Les thèmes du portail et les configurations de CLUF peuvent être liés indépendamment au niveau du serveur virtuel VPN et du VPN global.

Important :

Citrix ne prend pas en charge la personnalisation nécessitant des modifications de code et n’offre pas de prise en charge pour résoudre les problèmes au-delà du retour à un thème par défaut.

Appliquer un thème de portail

À partir de la version 13.0 build 67.43, le portail VPN est configuré pour utiliser le thème RFWebUI, par défaut. Auparavant, Caxton theme c’était le thème par défaut. Vous pouvez également appliquer les thèmes Green Bubble et X1.

Thème RFWebui

Thème Caxton

! [Caxton Thème] (/en-us/citrix-gateway/media/caxton-theme.png)

Thème Green Bubble

Thème Green Bubble

Thème X1

Thème X1

Vous pouvez appliquer n’importe lequel des thèmes fournis directement à un serveur virtuel VPN ou en tant que liaison VPN globale.

Liaison d’un thème de portail à un serveur virtuel VPN

Vous pouvez lier un thème de portail sur un serveur virtuel existant ou lors de la création d’un nouveau serveur virtuel.

Liez un thème de portail à un serveur virtuel VPN à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez ;

bind vpn vserver <name> - portaltheme <name>
<!--NeedCopy-->

Liez un thème de portail à un serveur virtuel VPN à l’aide de l’interface graphique

  1. Dans l’onglet Configuration, accédez à Citrix Gateway et cliquez sur Serveurs virtuels.
  2. Sélectionnez un serveur virtuel, puis cliquez sur Modifier.
  3. Si un thème de portail n’a pas encore été lié au serveur virtuel, cliquez sur Thème du portail sous Paramètres avancés dans le volet d’informations. Sinon, l’option Thème du portailest déjà développée dans le volet d’informations.
  4. Dans le volet d’informations, sous Thèmes du portail, cliquez sur Aucun thème de portailpour développer la fenêtre de liaison du thème du portail.
  5. Click Cliquez pour sélectionner.
  6. Dans la fenêtre Thèmes du portail, cliquez sur le nom d’un thème, puis sur Sélectionner.
  7. Cliquez sur Bind.
  8. Cliquez sur Terminé.

Si vous créez un serveur virtuel VPN, vous pouvez suivre les étapes de la procédure précédente en commençant par l’étape 3 dans le volet d’ édition du serveur virtuel VPN pour lier un thème de portail.

Liez un thème de portail à VPN global

Liez un thème de portail à VPN global à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

bind vpn global portaltheme <name>
<!--NeedCopy-->

Liez un thème de portail à VPN global à l’aide de l’interface graphique

  1. Dans l’onglet Configuration, accédez à Citrix Gateway.
  2. Dans le volet de détails principal, cliquez sur Citrix Gateway Policy Manager.
  3. Cliquez sur l’icône « + ».
  4. Dans la liste des points de liaison, sélectionnez Ressources.
  5. Dans la listeType de connexion, sélectionnezThème du portail.
  6. Cliquez sur Continuer.
  7. Dans l’écran Point de liaison, cliquez sur Ajouter une liaison.
  8. Cliquez sur Cliquez pour sélectionner.
  9. Dans la fenêtre Thèmes du portail, cliquez sur le nom d’un thème, puis sur Sélectionner.
  10. Cliquez sur Bind.
  11. Cliquez sur Fermer.
  12. Cliquez sur Terminé.

Conseil :

Après avoir effectué les modifications, utilisez la commande « save ns config’ sur la ligne de commande ou cliquez sur l’icône Enregistrer dans l’utilitaire de configuration pour vous assurer que vos modifications sont enregistrées dans le fichier de configuration Citrix ADC.

Créer un thème de portail

Pour créer une conception de portail personnalisée, vous utilisez l’un des thèmes de portail fournis comme modèle. Le système crée une copie du thème de modèle sélectionné avec un nom que vous spécifiez.

Utiliser un thème de portail boursier comme modèle pour un thème de portail personnalisé

Pour créer un thème de portail, vous pouvez utiliser l’utilitaire de configuration ou la ligne de commande pour créer l’entité de thème. Toutefois, les contrôles de personnalisation détaillés ne sont disponibles que dans l’utilitaire de configuration.

Créer un thème de portail à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

add portaltheme <name> basetheme <name>
<!--NeedCopy-->

Créer un thème de portail à l’aide de l’interface graphique

  1. Dans l’onglet Configuration, accédez à Citrix Gateway et cliquez sur Thèmes du portail.
  2. Dans le volet de détails principal, cliquez sur Ajouter.
  3. Entrez le nom du thème et sélectionnez un modèle dans la liste des modèles, puis cliquez sur OK.
  4. À ce stade, la première vue de la fenêtre d’édition du thème du portail s’affiche. Cliquez sur OK pour quitter.

Vous pouvez procéder à la personnalisation du nouveau thème du portail avec la première vue.

Une fois qu’un nouveau thème est créé, vous pouvez le lier à un serveur virtuel VPN ou à un VPN global. Vous pouvez lier un nouveau thème immédiatement après sa création ou après avoir terminé vos personnalisations.

Personnalisation du thème du portail

Pour personnaliser un thème de portail, utilisez l’interface du thème du portail dans l’utilitaire de configuration. Pour obtenir les meilleurs résultats, vous devez comprendre les différents éléments de cette interface avant de l’utiliser.

À propos de l’interface du thème du portail

Pour ouvrir l’ interface du thème du portail dans l’utilitaire de configuration Citrix Gateway, sous l’onglet Configuration, accédez à Citrix Gateway et cliquez sur Thèmes du portail. Vous pouvez créer un thème comme décrit dans la section Création d’un thème de portail ou sélectionner un thème existant dans le volet de détails principal et cliquer sur Modifier.

La page de personnalisation du thème du portail comporte quatre volets de composants principaux permettant de modifier la conception d’un portail : le volet Thème du portail, le volet Apparence, le volet Paramètres avancés et le volet Langue .

Interface du thème du portail

Le volet Thème du portail en haut de la page indique le thème chargé en vue de la modification et le thème de modèle sur lesquels il est basé. L’option d’affichage ici vous permet de visualiser vos personnalisations sans accéder au VPN avec une connexion utilisateur. L’utilisation de l’option de visualisation nécessite de lier le thème à un serveur virtuel VPN et la liaison reste en vigueur après la fermeture de la fenêtre de visualisation.

Avec le volet Look & Feel au centre de la page, vous configurez les propriétés générales d’un thème, telles que les en-têtes, les couleurs et images d’arrière-plan, les propriétés de police et les logos. Lorsque ce volet est en mode de modification, les légendes d’attributs sont disponibles pour vous aider à savoir où les attributs Look & Feel sont utilisés sur les pages du portail.

Le volet Paramètres avancés contient les contrôles de contenu à l’écran pour les pages individuelles du portail. Pour charger le contenu d’une page à modifier, cliquez sur l’une des pages répertoriées. Les contrôles de page s’ouvrent ensuite sous les autres volets centraux. Une page reste réduite dans le volet Paramètres avancés lors des modifications du thème du portail tant qu’elle n’a pas été modifiée.

Dans le volet Langue, vous pouvez sélectionner la langue qui sera chargée lorsqu’une page est sélectionnée pour modification dans le volet Paramètres avancés . Les pages de langue anglaise sont chargées par défaut.

Types d’attributs de page personnalisables

Lorsque vous personnalisez un thème de portail, vous pouvez modifier une série d’attributs dans l’interface du thème du portail. Outre le texte et les langues prises en charge qui peuvent être modifiés, les éléments graphiques de la mise en page du portail peuvent être adaptés à vos besoins. Chaque type d’élément de page comporte des paramètres ou des recommandations à prendre en compte avant de les modifier.

Couleurs

La conception du portail spécifie les couleurs des attributs tels que les arrière-plans de page, les surlignements, le texte des titres et du contenu du corps, les contrôles des boutons et les réponses au survol. Pour personnaliser un attribut de couleur, vous pouvez entrer une valeur de couleur directement pour un élément sélectionné, ou vous pouvez utiliser le sélecteur de couleurs fourni pour générer une valeur de couleur. L’interface prend en charge la saisie de valeurs de couleur HTML valides au format RGBA, au format triolet hexadécimal HTML et aux noms de couleurs X11. Le sélecteur de couleurs est accessible pour n’importe quel attribut de couleur applicable en cliquant sur la zone de couleur en regard du champ de saisie de l’attribut.

Sélecteur de couleurs

Polices

En plus des couleurs de police, vous pouvez modifier les tailles de police de certains attributs de page. Pour chacun de ces attributs, un menu propose les tailles disponibles pour chaque attribut, telles que déterminées par la conception du portail.

Images

Pour les images, une description contextuelle disponible pour chaque contrôle fournit des recommandations de taille et d’autres exigences. Les descriptions varient en fonction de l’emplacement d’un attribut sur la page et de sa fonction. Vous pouvez utiliser les formats de fichier image PNG ou JPEG. Vous pouvez sélectionner une image à télécharger en cochant la case située sous le nom de fichier d’un élément, puis en accédant à l’emplacement de l’image sur le lecteur de votre ordinateur local.

Étiquettes

Dans la section Paramètres avancés, vous pouvez sélectionner le texte d’une page de portail spécifique à modifier. Si vous modifiez le texte anglais par défaut d’une page, le texte des autres langues n’est pas retraduit. Le contenu de la page dans une autre langue est fourni à titre de commodité, mais nécessite des mises à jour manuelles pour toute personnalisation. Pour modifier une autre version linguistique d’une page, commencez par réduire la fenêtre, si elle est ouverte, en cliquant sur l’icône X de la page de portail ouverte. Sélectionnez ensuite la langue dans le volet Langue, puis cliquez sur OK. Toutes les pages du portail ouvertes à partir du volet Paramètres avancés sont dans cette langue jusqu’à ce que vous en sélectionniez une autre.

Important

Dans les déploiements haute disponibilité ou en cluster, les thèmes de portail sont distribués dans la configuration partagée uniquement lorsque les paramètres du thème du portail sont définis sur les entités Citrix ADC principale ou du coordinateur de configuration, respectivement.

Personnalisations de portail plus anciennes

Pour les installations avec une conception de portail personnalisé modifiée manuellement créée dans Citrix Gateway ou Access Gateway versions antérieures à la version 11.0, Citrix recommande vivement de commencer par un nouveau thème de portail dans l’interface de personnalisation. Si vous ne pouvez pas le faire, vous pouvez appliquer une personnalisation manuellement, mais aucune prise en charge directe n’est fournie.

Lorsque vous utilisez un portail personnalisé manuellement, vous devez définir le portail personnalisé en tant que configuration globale du portail. Cela signifie cependant qu’une configuration de portail global appliquée ne peut pas être remplacée par des liaisons de thème de portail au niveau du serveur virtuel VPN. La tentative de création d’une liaison de serveur virtuel VPN dans ce cas avec l’utilitaire de configuration ou la ligne de commande renvoie une erreur.

En outre, dans le cas de configurations de haute disponibilité et de cluster, toutes les personnalisations manuelles doivent être effectuées sur chaque nœud du déploiement, car les fichiers sous-jacents sur le système de fichiers Citrix ADC ne sont pas distribués dans la configuration partagée automatiquement.

Création manuelle d’une configuration de portail personnalisée

Pour appliquer manuellement une ancienne configuration de portail personnalisé après la mise à niveau vers Citrix Gateway 11.0, vous devez modifier une copie d’une page de portail existante, placer les fichiers de portail personnalisés dans le système de fichiers Citrix ADC et sélectionner CUSTOM comme paramètre UITHEME .

Vous pouvez utiliser WinSCP ou tout autre programme de copie sécurisée pour transférer des fichiers vers le système de fichiers Citrix ADC.

  1. Ouvrez une session sur la ligne de commande Citrix Gateway.
  2. À l’invite de commandes, tapezshell
  3. À l’invite de commandes, tapez mkdir /var/ns_gui_custom ; cd /netscaler ; tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*.
  4. À l’invite de commandes, tapez cd /var/netscaler/logon/themes/
    • Si vous souhaitez personnaliser le thème de la bulle verte, entrezcp -r Greenbubble Custom pour créer une copie du thème Green Bubble.
    • Si vous souhaitez personnaliser le thème par défaut (Caxton), tapez cp -r Default Custom.
    • Pour personnaliser le thème X1, tapezcp -r X1 Custom.
  5. Apportez les modifications nécessaires aux fichiers copiés sous**/var/NetScaler/logon/themes/Custom** pour personnaliser le thème manuellement.
    • Apportez les modifications nécessaires au fichier css/base.css.
    • Copiez les images personnalisées dans le répertoire /var/ns_gui_custom/ns_gui/vpn/media .
    • Apportez des modifications aux étiquettes des fichiers présents dans le répertoire resources/ . Ces fichiers correspondent aux paramètres régionaux pris en charge par le portail.
    • Si des modifications de pages HTML ou de fichiers javascript sont également nécessaires, vous pouvez rendre les fichiers pertinents dans /var/ns_gui_custom/ns_gui/.
  6. Une fois toutes les modifications de personnalisation terminées, à l’invite, entrez : tar —cvzf /var/ns_gui_custom/customtheme.tar.gz /var/ns_gui_custom/ns_gui/*

Important

Lors de la copie d’un répertoire de thème au cours des étapes précédentes, le nom du dossier copié doit être entré exactement comme « Personnalisé », car les noms de répertoire sont sensibles à la casse dans l’interface de l’interpréteur de commandes Citrix ADC. Si le nom du répertoire n’est pas entré avec précision, le dossier n’est pas reconnu lorsque le paramètre UITHEME est configuré sur CUSTOM.

Sélectionnez le thème personnalisé en tant que paramètre global VPN

Une fois que la configuration du portail personnalisé manuellement est terminée et copiée dans le système de fichiers Citrix ADC, elle doit être appliquée à la configuration Citrix Gateway. Cela se fait en définissant le paramètre UITHEME sur CUSTOM et peut être complété à l’aide de la ligne de commande ou de l’utilitaire de configuration.

Pour utiliser la ligne de commande, entrez la commande suivante pour définir le paramètre UITHEME .

set vpn parameter UITHEME CUSTOM
<!--NeedCopy-->

Pour définir le paramètre UITHEME à l’aide de l’utilitaire de configuration, procédez comme suit.

  1. Dans l’onglet Configuration, accédez à Citrix Gateway > Paramètres globaux.
  2. Cliquez sur Modifier les paramètres globaux.
  3. Cliquez sur l’onglet Expérience client .
  4. Faites défiler l’écran jusqu’au bas de l’écran, puis sélectionnez PERSONNALISÉ dans le menu de la liste Thème de l’interface utilisateur .
  5. Cliquez sur OK.

Votre portail personnalisé manuellement est désormais la conception du portail présentée aux utilisateurs de VPN.

Créer un CLUF

Le système de portail VPN offre la possibilité d’appliquer un CLUF à une configuration de portail. Une fois qu’un CLUF est lié à la configuration de Citrix Gateway, soit au niveau global du VPN, soit à un serveur virtuel VPN pertinent, les utilisateurs VPN doivent accepter le CLUF en tant que conditions générales avant d’être autorisés à s’authentifier auprès du VPN.

Comme pour les thèmes du portail, les utilisateurs bénéficient d’un CLUF spécifique à la langue en fonction des paramètres régionaux signalés par leur navigateur Web. Dans le cas d’un paramètre régional qui ne correspond à aucune des langues prises en charge, la langue utilisée par défaut est l’anglais. Pour chaque CLUF, vous pouvez entrer un message personnalisé dans chacune des langues prises en charge. Le contenu pré-traduit n’est pas fourni pour les configurations de CLUF, comme c’est le cas pour les thèmes du portail. Si les paramètres régionaux signalés par un utilisateur correspondent à une langue dans laquelle aucun contenu CLUF n’est entré, une page vide est renvoyée à l’utilisateur lorsqu’il clique sur le lien « Conditions générales » sur la page de connexion VPN.

Pour créer un CLUF, vous pouvez utiliser l’un des contrôles de l’utilitaire de configuration sous l’onglet Configuration sous Citrix Gateway > Paramètres globaux > CLUF ou Citrix Gateway > Ressources > CLUF. Les contrôles du volet Paramètres globaux sont utilisés pour gérer les liaisons de CLUF globales VPN tandis que le contrôle du nœud Ressources > CLUF est destiné aux opérations générales sur les configurations de CLUF. Vous pouvez gérer les liaisons de CLUF de serveur virtuel VPN en modifiant un serveur virtuel VPN dans Citrix Gateway > Serveurs virtuels. Certaines commandes sont également disponibles avec la ligne de commande pour gérer les entités CLUF. Toutefois, les contrôles complets de gestion du CLUF sont disponibles uniquement dans l’utilitaire de configuration.

Créer une entité CLUF à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez ;

add vpn eula <name>
<!--NeedCopy-->

Créer une entité CLUF à l’aide de l’interface graphique

  1. Accédez à Citrix Gateway > Ressources > CLUF.
  2. Cliquez sur Ajouter pour créer une entité.
  3. Entrez le nom de l’entité.
  4. Pour chacune des langues, collez le contenu sous les onglets correspondants. Vous pouvez utiliser du texte brut ou des balises HTML pour mettre en forme le contenu, y compris une <br> balise pour ajouter des sauts de ligne.
  5. Cliquez sur Créer.

Une fois qu’une entité CLUF a été créée, elle peut être globalement liée à la configuration VPN ou à un serveur virtuel VPN.

Liez un CLUF à VPN global à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

bind vpn global eula <name>
<!--NeedCopy-->

Liez un CLUF à VPN global à l’aide de l’interface graphique

  1. Dans l’onglet Configuration, accédez à Citrix Gateway > Paramètres globaux.
  2. Dans le volet de détails principal, cliquez sur Configurer un contrat de licence d’utilisateur final.
  3. Cliquez sur Ajouter une liaison.
  4. Cliquez sur Cliquez pour sélectionner.
  5. Sélectionnez une entité CLUF, puis cliquez sur Sélectionner.
  6. Cliquez sur Bind.
  7. Cliquez sur Fermer.

Liez un CLUF à un serveur virtuel VPN à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

bind vpn vserver <name> eula <name>
<!--NeedCopy-->

Liez un CLUF à un serveur virtuel VPN à l’aide de l’interface graphique

  1. Dans l’onglet Configuration, accédez à Citrix Gateway > Virtual Servers.
  2. Dans le volet de détails principal, sélectionnez un serveur virtuel VPN et cliquez sur Modifier.
  3. Dans le volet Paramètres avancés sur le côté droit de la page, cliquez sur CLUF.
  4. Dans le volet CLUF récemment ajouté, cliquez sur Aucun CLUF.
  5. Click Cliquez pour sélectionner.
  6. Sélectionnez une entité CLUF, puis cliquez sur Sélectionner.
  7. Cliquez sur Bind.
  8. Cliquez sur Terminé.