Personnalisation du portail utilisateur
Les installations Citrix Gateway qui servent le portail aux utilisateurs de 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 marqué. À 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 boîte de saisie personnalisées et divers autres attributs de la conception de portail basée sur CSS. Les thèmes du portail intégré incluent du contenu en cinq langues : anglais, français, espagnol, allemand et japonais. Différents utilisateurs sont servis dans différentes langues, selon les paramètres régionaux signalés par leurs navigateurs Web.
Vous avez la possibilité de créer un contrat de licence utilisateur final personnalisé (CLUF) qui est présenté aux utilisateurs 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 leurs navigateurs Web.
Les thèmes de portail et les configurations 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.
Application d’un thème de portail
Par défaut, le portail VPN est configuré pour utiliser le thème Caxton. Le thème Caxton est nommé Par défaut.
Thème Caxton
Citrix Gateway comprend deux thèmes supplémentaires qui peuvent être appliqués au portail : les thèmes Greenbubble et X1.
Thème Greenbubble
Thème X1
Vous pouvez appliquer l’un 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.
Utilisation de la ligne de commande pour lier un thème de portail à un serveur virtuel VPN existant
À l’invite de commandes, tapez ;
bind vpn vserver <name> - portaltheme <name>
<!--NeedCopy-->
Utilisation de l’utilitaire de configuration pour lier un thème de portail à un serveur virtuel VPN existant
- Sous l’onglet Configuration, accédez à Citrix Gateway et cliquez sur Serveurs virtuels.
- Sélectionnez un serveur virtuel, puis cliquez sur Modifier.
- 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 portail est déjà développée dans le volet d’informations.
- Dans le volet d’informations, sous Thèmes du portail, cliquez sur Aucun thème du portailpour développer la fenêtre de liaison du thème du portail.
- Cliquez sur Cliquez pour sélectionner.
- Dans la fenêtre Thèmes du portail, cliquez sur un nom de thème, puis cliquez sur Sélectionner.
- Cliquez sur Bind.
- Cliquez sur Terminé.
Si vous créez un serveur virtuel VPN, vous pouvez suivre les étapes ci-dessus en commençant par l’étape 3 alors que dans le volet d’édition Serveur virtuel VPN pour lier un thème de portail.
Liaison d’un thème de portail à VPN Global
Utilisation de la ligne de commande pour lier un thème de portail à l’étendue globale VPN
À l’invite de commandes, tapez ;
bind vpn global portaltheme <name>
<!--NeedCopy-->
Utilisation de l’utilitaire de configuration pour lier un thème de portail à l’étendue globale VPN
- Sous l’onglet Configuration, accédez à Citrix Gateway.
- Dans le volet d’informations principal, cliquez sur Citrix Gateway Policy Manager.
- Cliquez sur l’icône ‘+’.
- Dans la liste Point de liaison, sélectionnez Ressources .
- Dans la liste Type de connexion, sélectionnez Thème du portail.
- Cliquez sur Continue.
- Dans l’écran Point de liaison , cliquez sur Ajouter une liaison .
- Cliquez sur Cliquez pour sélectionner.
- Dans la fenêtre Thèmes du portail, cliquez sur un nom de thème, puis cliquez sur Sélectionner.
- Cliquez sur Bind.
- Cliquez sur Fermer.
- Cliquez sur Terminé.
Conseil : Lorsque vous avez terminé un ensemble de modifications, utilisez la commande ‘save ns config’ sur la ligne de commande ou cliquez sur l’icône save dans l’utilitaire de configuration pour vous assurer que vos modifications sont enregistrées dans le fichier de configuration Citrix ADC.
Création d’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 effectue une copie du thème de modèle sélectionné avec un nom que vous spécifiez.
Utilisation d’un thème Portal Stock comme modèle pour un thème Portal 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.
Utilisation de la ligne de commande pour créer un thème de portail
À l’invite de commandes, tapez ;
add portaltheme <name> basetheme <name>
<!--NeedCopy-->
Utilisation de l’utilitaire de configuration pour créer un thème de portail
- Sous l’onglet Configuration, accédez à Citrix Gateway et cliquez sur Thèmes du portail .
- Dans le volet d’informations principal, cliquez sur Ajouter.
- Entrez un nom pour le thème et sélectionnez un modèle dans la liste des modèles, puis cliquez sur OK.
- À ce stade, vous êtes présenté avec la première vue de la fenêtre d’édition du thème du portail. Cliquez sur OK pour quitter.
Vous pouvez procéder à la personnalisation du nouveau thème du portail avec la première vue. Toutefois, vous devez lire laPersonnalisation du thème du portailsection suivante sur l’interface et les descriptions contextuelles des attributs de portail personnalisables au sein de l’interface avant de continuer à modifier un thème de portail.
Une fois qu’un nouveau thème est créé, vous pouvez le lier comme décrit dansLiaison d’un thème de portail à un serveur virtuel VPNouLiaison d’un thème de portail à VPN Global. Vous pouvez lier un nouveau thème immédiatement après la 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 Thème de 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 de thème du portail
Pour ouvrir l’interface Portal Theme dans l’utilitaire de configuration Citrix Gateway, sous l’onglet Configuration, accédez à Citrix Gateway et cliquez sur Thèmes Portal . Vous pouvez créer un thème comme décrit dans Création d’un thème de portail ou sélectionner un thème existant dans le volet d’informations principal, puis cliquer sur Modifier .
La page de personnalisation du thème du portail comporte quatre volets principaux permettant de modifier une conception du portail : le volet Thème du portail, le volet Look & Feel, le volet Paramètres avancés et le volet Langue .
Interface Thème du portail
Le volet Thème du portail en haut de la page indique quel thème est chargé pour modification et quel thème de modèle 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 d’affichage 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 d’affichage.
Avec le volet Look & Feel situé 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 les images d’arrière-plan, les propriétés de police et les logos. Lorsque ce volet est en mode édition, les légendes d’attribut sont disponibles pour obtenir des conseils sur l’emplacement 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 du portail individuelles. 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 à travers les modifications apportées au thème du portail tant que la page n’a pas été modifiée.
Dans le volet Langue, vous pouvez sélectionner les langues à charger lorsqu’une page est sélectionnée pour modification dans le volet Paramètres avancés . Les pages en langue anglaise sont chargées par défaut.
Types d’attributs de page personnalisables
Lorsque vous personnalisez un thème Portal, vous pouvez modifier une plage d’attributs dans l’interface Thème Portal. Avec le texte et les langues prises en charge qui peuvent être édités, tous les éléments graphiques de la mise en page du portail peuvent être adaptés à vos besoins. Chacun des types d’éléments de page a 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 pour les titres et le contenu du corps, les contrôles de bouton et les réponses de survol. Pour personnaliser un attribut de couleur, vous pouvez entrer une valeur de couleur directement pour un élément sélectionné ou utiliser le sélecteur de couleur 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 hexadécimal triplet HTML et aux noms de couleurs X11. Vous pouvez accéder au sélecteur de couleur pour n’importe quel attribut de couleur applicable en cliquant sur la zone de couleur située à côté du champ de saisie de l’attribut.
Le sélecteur de couleurs
Polices
En plus des couleurs de police, vous pouvez modifier la taille des polices pour 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 fichiers 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 parcourant 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 de langue alternative est fourni à titre de commodité, mais nécessite des mises à jour manuelles pour toute personnalisation. Pour modifier une autre version linguistique d’une page, réduisez d’abord la fenêtre, si elle est ouverte, en cliquant sur l’icône X de la page du portail ouvert. Sélectionnez ensuite la langue dans le volet Langue et cliquez sur OK . Toutes les pages du portail ouvertes à partir du volet Paramètres avancés seront alors 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 Portal sont distribués dans la configuration partagée uniquement lorsque les paramètres de thème Portal sont définis sur les entités Citrix ADC principal ou coordonnateur de configuration respectivement.
Note sur les personnalisations de portail plus ancien
Pour les installations dont la conception de portail personnalisé modifiée manuellement est créée dans Citrix Gateway ou Access Gateway versions antérieures à 11.0, Citrix recommande fortement 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 de portail global. 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 VPN au niveau du serveur virtuel. 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 du 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ée 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.
- Connectez-vous à la ligne de commande Citrix Gateway.
- À l’invite de commandes, tapez shell
- À l’invite de commandes, tapez mkdir /var/ns_gui_custom; cd /netscaler; tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*.
- À l’invite de commandes, tapez cd /var/netscaler/logon/themes/
- Si vous souhaitez personnaliser le thème Greenbubble, entrez cp -r Greenbubble Custom pour créer une copie du thème Greenbubble.
- Si vous souhaitez personnaliser le thème Par défaut (Caxton), tapez cp -r Default Custom.
- Pour personnaliser le thème X1, tapez cp -r X1 Custom.
- Apportez les modifications nécessaires aux fichiers copiés sous **/var/netscaler/logon/themes/custom** pour personnaliser manuellement le thème.
- Effectuez les modifications nécessaires à css/base .css.
- Copiez toutes les images personnalisées dans le répertoire /var/ns_gui_custom/ns_gui/vpn/media .
- Modifiez les étiquettes dans les 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 aux pages HTML ou aux fichiers javascript sont également nécessaires, vous pouvez rendre le fichier pertinent dans /var/ns_gui_custom/ns_gui/.
- Une fois toutes les modifications de personnalisation terminées, 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 dans les é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 shell de 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 C USTOM .
Sélectionnez le thème personnalisé en tant que paramètre global VPN
Une fois la configuration du portail personnalisée manuellement terminée et copiée dans le système de fichiers Citrix ADC, elle doit être appliquée à la configuration Citrix Gateway. Ceci est fait en définissant le paramètre UITHEME sur CUSTOM et peut être complété avec la ligne de commande ou 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.
- Sous l’onglet Configuration, accédez à Citrix Gateway > Paramètres globaux.
- Cliquez sur Modifier les paramètres globaux.
- Cliquez sur l’onglet Expérience client .
- Faites défiler jusqu’au bas de l’écran, puis sélectionnez CUSTOM dans le menu de la liste Thème de l’interface utilisateur .
- Cliquez sur OK.
Votre portail personnalisé manuellement est maintenant la conception du portail présentée aux utilisateurs de VPN.
Création d’un contrat de licence utilisateur final
Le système de portail VPN offre la possibilité d’appliquer un contrat de licence utilisateur final (CLUF) à une configuration de portail. Une fois qu’un CLUF est lié à la configuration de Citrix Gateway, soit à la portée globale du VPN, soit à un serveur virtuel VPN pertinent, les utilisateurs du VPN doivent accepter le CLUF en tant que conditions générales avant d’être autorisés à s’authentifier dans le VPN.
Comme pour les thèmes du portail, les utilisateurs bénéficient d’un CLUF spécifique à la langue basée sur les paramètres régionaux signalés par leur navigateur Web. Dans le cas d’une locale qui ne correspond à aucune des langues prises en charge, la langue 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 CLUF, comme pour les thèmes du portail. Si les paramètres régionaux signalés d’un utilisateur correspondent à une langue où aucun contenu CLUF n’est entré, l’utilisateur est renvoyé une page blanche lorsqu’il clique sur le lien « Conditions générales » dans 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 de Citrix Gateway > Paramètres globaux > CLUF ou Citrix Gateway > Ressources > CLUF . Les contrôles du volet Paramètres globaux permettent de gérer les liaisons CLUF globales VPN tandis que le contrôle sur le nœud Ressources > CLUF concerne les opérations générales sur les configurations CLUF. Vous pouvez gérer les liaisons 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 la gestion des entités CLUF. Toutefois, les contrôles complets de gestion du CLUF ne sont disponibles que dans l’utilitaire de configuration.
Utilisation de la ligne de commande pour créer une entité CLUF
À l’invite de commandes, tapez ;
add vpn eula <name>
<!--NeedCopy-->
Utilisation de l’utilitaire de configuration pour créer une entité CLUF
- Accédez à Citrix Gateway > Ressources > CLUF.
- Cliquez sur Ajouter pour créer une entité.
- Entrez un nom pour l’entité.
- Pour chacune des langues, collez le contenu sous les onglets correspondants. Vous pouvez utiliser du texte brut ou des balises HTML pour formater le contenu, y compris une
<br>balise pour ajouter des sauts de ligne. - Cliquez sur Créer.
Une fois qu’une entité CLUF a été créée, elle peut être globalement liée à la configuration VPN ou peut être liée à un serveur virtuel VPN.
Utilisation de la ligne de commande pour lier un CLUF à VPN Global
À l’invite de commandes, tapez ;
bind vpn global eula <name>
<!--NeedCopy-->
Utilisation de l’utilitaire de configuration pour créer une liaison VPN CLUF globale
- Sous l’onglet Configuration, accédez à Citrix Gateway > Paramètres globaux.
- Dans le volet d’informations principal, cliquez sur Configurer un contrat de licence utilisateur final.
- Cliquez sur Ajouter une liaison.
- Cliquez sur Cliquez pour sélectionner.
- Sélectionnez une entité CLUF, puis cliquez sur Sélectionner.
- Cliquez sur Bind.
- Cliquez sur Fermer.
Utilisation de la ligne de commande pour lier un CLUF à un serveur virtuel VPN
À l’invite de commandes, tapez ;
bind vpn vserver <name> eula <name>
<!--NeedCopy-->
Utilisation de l’utilitaire de configuration pour lier un CLUF à un serveur virtuel VPN
- Dans l’onglet Configuration, accédez à Citrix Gateway > Serveurs virtuels.
- Dans le volet d’informations principal, sélectionnez un serveur virtuel VPN et cliquez sur Modifier.
- Dans le volet Paramètres avancés situé à droite de la page, cliquez sur CLUF .
- Dans le volet CLUF nouvellement ajouté, cliquez sur Aucun CLUF.
- Cliquez sur Cliquez pour sélectionner.
- Sélectionnez une entité CLUF et cliquez sur Sélectionner.
- Cliquez sur Bind.
- Cliquez sur Terminé.
Dans cet article
- Application d’un thème de portail
- Liaison d’un thème de portail à un serveur virtuel VPN
- Liaison d’un thème de portail à VPN Global
- Création d’un thème de portail
- Utilisation d’un thème Portal Stock comme modèle pour un thème Portal personnalisé
- Personnalisation du thème du portail
- À propos de l’interface de thème du portail
- Note sur les personnalisations de portail plus ancien
- Création d’un contrat de licence utilisateur final