Gateway

Personalización del portal de puerta de enlace mediante plug-ins personalizados

El marco RfWebUI de NetScaler Gateway ofrece la posibilidad de agregar los plug-ins personalizados para personalizar su portal de puerta de enlace. Estos plug-ins personalizados se pueden utilizar para agregar una gran funcionalidad a la puerta de enlace, por ejemplo, si quiere agregar una página completamente nueva en el flujo de la puerta de enlace. Para otros casos de uso, el código se puede agregar al archivo de script personalizado proporcionado para los temas de puerta de enlace en la ubicación /var/netscaler/logon/themes/<custom_theme>/script.js.

Nota:

NetScaler Gateway solo admite la creación y el uso de plug-ins personalizados para la personalización del portal. NetScaler Gateway no crea ni proporciona ningún plug-in personalizado en función de los requisitos del cliente.

  1. Para agregar un plug-in personalizado, cree el archivo JavaScript en la ubicación /var/netscaler/logon/LogonPoint/plugins/ns-gateway/. Por ejemplo, puede encontrar los siguientes plug-ins en /var/netscaler/logon/LogonPoint/plugins/ns-gateway/.

    • ns-nfactor.js

    • nsg-epa.js

    • nsg-setclient.js

    Se recomienda introducir el nombre del plug-in con el formato <plugin_name>.js.

    Todos estos archivos de plug-ins se obtienen mediante el marco RfWebUI requerido por la funcionalidad.

  2. Después de crear el archivo de plug-in, utilice el siguiente código como ejemplo para registrar el plug-in con el marco RfWebUI.

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

    donde,

    name es el nombre que se le da al plug-in. Se utiliza como identificador del plug-in.

    initialize toma la función como parámetro que se utiliza para inicializar el plug-in.

  3. Introduzca el nombre del plug-in y la función de inicialización en la función CTXS.ExtensionAPI.addPlugin() para registrar el plug-in. El nombre y la ubicación del plug-in agregado deben estar registrados en el archivo plugins.xml de la ubicación /var/netscaler/logon/themes/<custom_theme>/plugins.xml.

  4. Después de escribir el código del plug-in, el nombre y la ubicación del plug-in recién agregado deben registrarse con el archivo plugins.xml en la ubicación /var/netscaler/logon/themes/<custom_theme>/plugins.xml. El plug-in debe estar registrado con la etiqueta plug-in.

    <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. Introduzca un nombre y src para el plug-in para que rfWebUI pueda identificar y recuperar el plug-in.

Ejemplo de configuración

Las configuraciones de ejemplo siguientes se pueden utilizar para agregar un plug-in personalizado para agregar un pie de página a la página de inicio de sesión de NetScaler Gateway.

  1. Cree el archivo de plug-in de JavaScript en la ubicación, /var/netscaler/logon/LogonPoint/plugins/ns-gateway/.
  2. Asigne al plug-in el nombre ns-footer.js /var/netscaler/logon/LogonPoint/plugins/ns-gateway/ns-footer.js
  3. Agregue el siguiente código al plug-in registrado en la RfWebUI y en la función de inicialización agregue el pie de página a la puerta de enlace.

    (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. Guarde el archivo.
  5. Agregue el nombre y src en el archivo plugins.xml de la ubicación 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. Configure el tema personalizado para el que se agrega el plug-in.
  7. Limpia la caché con el comando flush cache contentgroup loginstaticobjects.
  8. Vuelva a cargar la pantalla del portal. El pie de página se agrega a la página de inicio de sesión de NetScaler Gateway. Código de portal personalizado
Personalización del portal de puerta de enlace mediante plug-ins personalizados