Citrix Gateway

Personnalisation du portail de passerelle à l’aide de plug-ins personnalisés

Citrix Gateway RFWebUI Framework offre la possibilité d’ajouter des plug-ins personnalisés pour personnaliser leur portail de passerelle. Ces plug-ins personnalisés peuvent être utilisés pour ajouter des fonctionnalités importantes à la passerelle, par exemple si vous souhaitez ajouter une nouvelle page entière dans le flux de la passerelle. Pour d’autres cas d’utilisation, le code peut être ajouté au fichier de script personnalisé fourni pour les thèmes de passerelle à l’emplacement /var/netscaler/logon/themes/<custom_theme>/script.js.

  1. Pour ajouter un plug-in personnalisé, créez le fichier JavaScript à l’emplacement correspondant /var/netscaler/logon/LogonPoint/plugins/ns-gateway/. Par exemple, vous trouverez les plug-ins suivants dans /var/netscaler/logon/LogonPoint/plugins/ns-gateway/.

    • ns-nfactor.js

    • nsg-epa.js

    • nsg-setclient.js

    Il est recommandé d’entrer le nom du plug-in au format <plugin_name>.js.

    Tous ces fichiers de plug-in sont récupérés par le framework RFWebUI requis par la fonctionnalité.

  2. Après avoir créé le fichier de plug-in, utilisez le code suivant comme exemple pour enregistrer le plug-in dans le framework RFWebUI.

            (function ($) {
                        CTXS.ExtensionAPI.addPlugin( {
                                    Name : “plugin name”,
                                    initialize: function() {}
                        });
                })(jQuery);
    <!--NeedCopy-->
    

    où,

    name est le nom donné au plug-in. Il est utilisé comme identifiant du plug-in.

    initialize prend la fonction comme paramètre utilisé pour initialiser le plug-in.

  3. Entrez le nom du plug-in et la fonction d’initialisation dans la CTXS.ExtensionAPI.addPlugin() fonction d’enregistrement du plug-in. Le nom et l’emplacement du plug-in ajoutés doivent être enregistrés dans le fichier plugins.xml à cet emplacement /var/netscaler/logon/themes/<custom_theme>/plugins.xml.

  4. Après avoir écrit le code du plug-in, le nom et l’emplacement du plug-in nouvellement ajouté doivent être enregistrés avec le plugins.xml fichier à cet emplacement /var/netscaler/logon/themes/<custom_theme>/plugins.xml. Le plug-in doit être enregistré avec la plug-in balise.

    <plugins>
    <plugin name="nsg-epa" src="plugins/ns-gateway/nsg-epa.js"/>
    <plugin name="nsg-setclient" src="plugins/ns-gateway/nsg-setclient.js"/>
    <plugin name="ns-nfactorn" src="plugins/ns-gateway/ns-nfactor.js"/>
    </plugins>
    <!--NeedCopy-->
    
  5. Entrez un nom et un src pour le plug-in afin que RFWebUI puisse identifier et récupérer le plug-in.

Exemple de configuration

Les exemples de configuration suivants peuvent être utilisés pour ajouter un plug-in personnalisé afin d’ajouter un pied de page à la page d’ouverture de session Citrix Gateway.

  1. Créez le fichier de plug-in JavaScript à l’emplacement, /var/netscaler/logon/LogonPoint/plugins/ns-gateway/.
  2. Nommez le plug-in en tant que ns-footer.js /var/netscaler/logon/LogonPoint/plugins/ns-gateway/ns-footer.js
  3. Ajoutez le code suivant au plug-in enregistré à la RFWebUI et dans la fonction d’initialisation, ajoutez le pied de page à la passerelle.

    (function ($) {
    CTXS.ExtensionAPI.addPlugin({
        name: "ns-footer", // Name of plugin - must match name sent in configuration
        initialize: function () {
            CTXS.Extensions.beforeLogon = function (callback) {
                $("#customExplicitAuthBottom").append("<div style='text-align:center;color:white;font-size:15px;'><br>Disclaimer<BR><BR>"+
                    " Access to this website is restricted to employees of Login Consultants<BR></div>");
                callback();
            };
        }
    });
    })(jQuery);
    <!--NeedCopy-->
    
  4. Enregistrez le fichier.
  5. Ajoutez le nom et le src dans le fichier plugins.xml à l’emplacement var/netscaler/logon/themes/<custom_theme>/plugins.xml.

    <plugins>
    <plugin name="nsg-epa" src="plugins/ns-gateway/nsg-epa.js" />
    <plugin name="nsg-setclient" src="plugins/ns-gateway/nsg-setclient.js" />
    <plugin name="ns-nfactor" src="plugins/ns-gateway/ns-nfactor.js" />
    <plugin name="ns-footer" src="plugins/ns-gateway/ns-footer.js" />
    </plugins>
    <!--NeedCopy-->
    
  6. Configurez le thème personnalisé pour lequel le plug-in est ajouté.
  7. Videz le cache à l’aide de la commande flush cache contentgroup loginstaticobjects.
  8. Rechargez l’écran du portail. Le pied de page est ajouté à la page de connexion Citrix Gateway. Code de portail personnalisé
Personnalisation du portail de passerelle à l’aide de plug-ins personnalisés