Gateway

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

June 4, 2024

Contribución de:

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.

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.
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);

```
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.
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.
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>

```
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.

Cree el archivo de plug-in de JavaScript en la ubicación, /var/netscaler/logon/LogonPoint/plugins/ns-gateway/.
Asigne al plug-in el nombre ns-footer.js /var/netscaler/logon/LogonPoint/plugins/ns-gateway/ns-footer.js

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-->

Guarde el archivo.

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-->

Configure el tema personalizado para el que se agrega el plug-in.
Limpia la caché con el comando flush cache contentgroup loginstaticobjects.
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.

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Cloud Software Group solo tiene traducción automática. Cloud Software Group no puede controlar el contenido con traducción automática, que puede contener errores, imprecisiones o un lenguaje inadecuado. No se ofrece ninguna garantía, ni implícita ni explícita, en cuanto a la exactitud, la fiabilidad, la idoneidad o la precisión de las traducciones realizadas del original en inglés a cualquier otro idioma, o que su producto o servicio de Cloud Software Group se ajusten a cualquier contenido con traducción automática, y cualquier garantía provista bajo el contrato de licencia del usuario final o las condiciones de servicio, o cualquier otro contrato con Cloud Software Group, de que el producto o el servicio se ajusten a la documentación no se aplicará en cuanto dicha documentación se ha traducido automáticamente. Cloud Software Group no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

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

June 4, 2024

Contribución de:

June 4, 2024

Contribución de:

En este artículo

Ejemplo de configuración