Citrix Gateway

Personalizar el portal de usuario

Las instalaciones de Citrix Gateway que sirven el portal a los usuarios de VPN incluyen una opción para seleccionar un tema de portal a fin de crear un aspecto personalizado para las páginas del portal. Puede seleccionar entre un conjunto de temas suministrado, o puede utilizar un tema como plantilla para crear un portal personalizado o de marca. Con la utilidad de configuración, puede modificar un tema agregando nuevos logotipos, imágenes de agrupación, etiquetas de cuadro de entrada personalizadas y varios otros atributos del diseño del portal basado en CSS. Los temas del portal integrados incluyen contenido para cinco idiomas: Inglés, francés, español, alemán y japonés. Los diferentes usuarios se sirven en diferentes idiomas, dependiendo de las configuraciones regionales reportadas por sus exploradores web.

Tiene la opción de crear un contrato de licencia de usuario final (CLUF) personalizado que se presenta a los usuarios de VPN antes de que se les permita iniciar sesión. La función EULA admite versiones específicas de la configuración regional de un EULA, que se presentan a los usuarios en función de las configuraciones regionales informadas de sus exploradores web.

Tanto los temas del portal como las configuraciones del CLUF se pueden vincular de forma independiente en el servidor virtual VPN y en los niveles globales de VPN.

Importante: Citrix no admite la personalización que requiera modificaciones de código y no ofrece soporte para resolver problemas más allá de volver a un tema predeterminado.

Aplicación de un tema de portal

De forma predeterminada, el portal VPN está configurado para usar el tema de Caxton. El tema de Caxton se denomina Predeterminado.

Tema Caxton

Tema Caxton

Citrix Gateway incluye dos temas adicionales que se pueden aplicar al portal: Los temas Greenbubble y X1.

Tema Greenbubble

Tema Greenbubble

Tema X1

Tema X1

Puede aplicar cualquiera de los temas suministrados directamente a un servidor virtual VPN o como enlace VPN global.

Vinculación de un tema de portal a un servidor virtual VPN

Puede enlazar un tema de portal en un servidor virtual existente o al crear un nuevo servidor virtual.

Usar la línea de comandos para enlazar un tema de portal a un servidor virtual VPN existente

En el símbolo del sistema, escriba;

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

Usar la utilidad de configuración para enlazar un tema de portal a un servidorvirtual VPN existente

  1. En la ficha Configuración, desplácese hasta Citrix Gateway y haga clic en Servidores virtuales.
  2. Seleccione un servidor virtual y, a continuación, haga clic en Modificar.
  3. Si todavía no se ha enlazado un tema del portal al servidor virtual, haga clic en Tema del portal en Configuración avanzada en el panel de detalles. De lo contrario, la opción Tema del portal ya está expandida en el panel de detalles.
  4. En el panel de detalles, en Temas del portal, haga clic en Sin tema del portalpara expandir la ventana de enlace Tema del portal.
  5. Haga clic en Haga clic para seleccionar.
  6. En la ventana Temas del portal, haga clic en un nombre de tema y, a continuación, haga clic en Seleccionar.
  7. Haga clic en Vincular.
  8. Haga clic en Listo.

Si está creando un servidor virtual VPN, puede seguir los pasos anteriores comenzando con el paso 3 mientras está en el panel de edición del servidor virtual VPN para enlazar un tema del portal.

Vinculación de un tema de portal a VPN Global

Usar la línea de comandos para enlazar un tema de portal al ámbito global de VPN

En el símbolo del sistema, escriba;

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

Usar la utilidad de configuración para enlazar un tema de portal al ámbito global de VPN

  1. En la ficha Configuración, desplácese hasta Citrix Gateway.
  2. En el panel de detalles principal, haga clic en Citrix Gateway Policy Manager.
  3. Haga clic en el icono ‘+’.
  4. En la lista Punto de enlace, seleccione Recursos.
  5. En la lista Tipo de conexión, seleccione Tema del portal.
  6. Haga clic en Continuar.
  7. En la pantalla Punto de enlace, haga clic en Agregar enlace.
  8. Haga clic en Haga clic para seleccionar.
  9. En la ventana Temas del portal, haga clic en un nombre de tema y, a continuación, haga clic en Seleccionar.
  10. Haga clic en Vincular.
  11. Haga clic en Cerrar.
  12. Haga clic en Listo.

Consejo: Cuando haya completado un conjunto de cambios, utilice el comando ‘save ns config’ en la línea de comandos o haga clic en el icono de guardar en la utilidad de configuración para asegurarse de que los cambios se guardan en el archivo de configuración de Citrix ADC.

Creación de un tema de portal

Para crear un diseño de portal personalizado, utilice uno de los temas de portal suministrados como plantilla. El sistema realiza una copia del tema de plantilla seleccionado con un nombre que especifique.

Uso de un tema de portal de stock como plantilla para un tema de portal personalizado

Para crear un tema del portal, puede utilizar la utilidad de configuración o la línea de comandos para crear la entidad del tema. Sin embargo, los controles de personalización detallados solo están disponibles en la utilidad de configuración.

Usar la línea de comandos para crear un tema de portal

En el símbolo del sistema, escriba;

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

Uso de la utilidad de configuración para crear un tema de portal

  1. En la ficha Configuración, desplácese hasta Citrix Gateway y haga clic en Temas del portal.
  2. En el panel de detalles principal, haga clic en Agregar.
  3. Escriba un nombre para el tema, seleccione una plantilla de la lista de plantillas y, a continuación, haga clic en Aceptar.
  4. En este punto, se le presenta la primera vista de la ventana de edición del tema del portal. Haga clic en Aceptar para salir.

Puede proceder a personalizar el nuevo tema del portal con la primera vista. Sin embargo, debe leer la siguiente sección Personalización del tema del portal sobre la interfaz y las descripciones emergentes de los atributos del portal personalizables dentro de la interfaz antes de continuar editando un tema del portal.

Una vez que se crea un nuevo tema, puede vincularlo como se describe en Vinculación de un tema de portal a un servidor virtual VPN o Vinculación de un tema de portal a VPN Global. Puede enlazar un nuevo tema inmediatamente después de la creación o después de completar las personalizaciones.

Personalización del tema del portal

Para personalizar un tema del portal, utilice la interfaz del tema del portal en la utilidad de configuración. Para obtener los mejores resultados, debe comprender los diversos elementos de esta interfaz antes de usarla.

Acerca de la interfaz de tema del portal

Para abrir la interfaz del tema del portal en la utilidad de configuración de Citrix Gateway, en la ficha Configuración, Vaya a Citrix Gateway y haga clic en Temas del portal. Puede crear un tema como se describe en Creación de un tema de portal o seleccionar un tema existente en el panel de detalles principal y hacer clic en Modificar.

La página de personalización del tema del portal tiene cuatro paneles de componentes principales para modificar un diseño del portal: El panel Tema del portal, el panel Aspecto y apariencia, el panel Configuración avanzada y el panel Idioma.

Interfaz de tema del portal

Interfaz de tema del portal

El panel Tema del portal en la parte superior de la página informa qué tema se carga para la edición y en qué tema de plantilla se basa. La opción de visualización aquí le permite ver sus personalizaciones sin tener acceso a la VPN con una conexión de usuario. El uso de la opción de visualización requiere vincular el tema a un servidor virtual VPN y el enlace permanece en vigor después de cerrar la ventana de visualización.

Con el panel Aspecto en el centro de la página, puede configurar las propiedades generales de un tema, como encabezados, colores de agrupación e imágenes, propiedades de fuente y logotipos. Cuando este panel está en modo de edición, las leyendas de atributos están disponibles para obtener orientación sobre dónde se utilizan los atributos Look & Feel en las páginas del portal.

El panel Configuración avanzada contiene los controles de contenido en pantalla para las páginas individuales del portal. Para cargar el contenido de una página para su edición, haga clic en una de las páginas enumeradas. A continuación, los controles de página se abren debajo de los otros paneles centrales. Una página permanece contraída en el panel Configuración avanzada en las ediciones del tema del portal siempre que no se haya modificado la página.

En el panel Idioma, puede seleccionar cuál de los idiomas se cargarán cuando se seleccione una página para su edición en el panel Configuración avanzada. Las páginas en inglés se cargan de forma predeterminada.

Tipos de atributos de página personalizables

Al personalizar un tema del portal, puede modificar un intervalo de atributos en la interfaz del tema del portal. Junto con el texto y los idiomas compatibles que se pueden modificar, todos los elementos gráficos del diseño del portal se pueden adaptar a sus necesidades. Cada uno de los tipos de elementos de página tiene parámetros o recomendaciones a tener en cuenta antes de modificarlos.

Colores

El diseño del portal especifica los colores de atributos como fondos de página, subrayados, texto para títulos y contenido del cuerpo, controles de botones y respuestas de desplazamiento. Para personalizar un atributo de color, puede introducir un valor de color directamente para un elemento seleccionado o puede utilizar el selector de color suministrado para generar un valor de color. La interfaz admite la introducción de valores de color HTML válidos en formato RGBA, formato de triplete hexadecimal HTML y nombres de color X11. Se puede acceder al selector de color para cualquier atributo de color aplicable haciendo clic en el cuadro de color situado junto al campo de entrada del atributo.

El selector de color

Selector de color

Fuentes

Junto con los colores de fuente, puede modificar los tamaños de fuente para algunos atributos de página. Para cada uno de estos atributos, un menú ofrece los tamaños disponibles para cada atributo, según lo determinado por el diseño del portal.

Imágenes

Para las imágenes, una descripción emergente disponible para cada control proporciona recomendaciones de tamaño y otros requisitos. Las descripciones varían según la ubicación de un atributo en la página y su función. Puede utilizar formatos de archivo de imagen PNG o JPEG. Para seleccionar una imagen para cargar, active la casilla de verificación situada debajo del nombre de archivo de un elemento y, a continuación, busque dónde reside la imagen en la unidad del equipo local.

Etiquetas

En la sección Configuración avanzada, puede seleccionar el texto de una página de portal específica para modificar. Si modifica el texto predeterminado en inglés de una página, el texto de otros idiomas no se vuelve a traducir. El contenido de la página de idioma alternativo se proporciona como una conveniencia, pero requiere actualizaciones manuales para cualquier personalización. Para modificar otra versión de idioma para una página, contraiga primero la ventana, si está abierta, haciendo clic en el icono X de la página del portal abierto. A continuación, seleccione el idioma en el panel Idioma y haga clic en Aceptar. Todas las páginas del portal abiertas desde el panel Configuración avanzada estarán en ese idioma hasta que seleccione otra.

Importante

En implementaciones de alta disponibilidad o agrupadas, los temas del portal se distribuyen a través de la configuración compartida solo cuando la configuración del tema del portal se realiza en las entidades de Citrix ADC principal o coordinador de configuración, respectivamente.

Una nota sobre personalizaciones del portal más antiguo

Para instalaciones con diseño de portal personalizado modificado manualmente creadas en versiones de Citrix Gateway o Access Gateway anteriores a la 11.0, Citrix recomienda encarecidamente comenzar con un nuevo tema del portal en la interfaz de personalización. Si no puede hacerlo, puede aplicar una personalización manualmente, pero no se proporciona soporte directo para ello.

Al utilizar un portal personalizado manualmente, debe establecer el portal personalizado como una configuración global de portal. Sin embargo, hacerlo significa que una configuración de portal global aplicada no se puede reemplazar con enlaces de tema de portal de nivel de servidor virtual VPN. Al intentar crear un enlace de servidor virtual VPN en este caso con la utilidad de configuración o la línea de comandos, se devuelve un error.

Además, en el caso de configuraciones de clúster y alta disponibilidad, cualquier personalización manual debe realizarse en todos los nodos de la implementación, ya que los archivos subyacentes en el sistema de archivos Citrix ADC no se distribuyen en la configuración compartida automáticamente.

Creación manual de una configuración de portal personalizada

Para aplicar manualmente una configuración de portal personalizada anterior después de actualizar a Citrix Gateway 11.0, debe modificar una copia de una página de portal existente, colocar los archivos de portal personalizados en el sistema de archivos de Citrix ADC y seleccionar CUSTOM como parámetro UITHEME.

Puede utilizar WinSCP o cualquier otro programa de copia segura para transferir archivos al sistema de archivos Citrix ADC.

  1. Inicie sesión en la línea de comandos de Citrix Gateway.
  2. En el símbolo del sistema, escriba shell
  3. En el símbolo del sistema, escriba mkdir /var/ns_gui_custom; cd /netscaler; tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*.
  4. En el símbolo del sistema, escriba cd /var/netscaler/logon/themes/
    • Si quiere personalizar el tema Greenbubble, escriba cp -r Greenbubble Custom para hacer una copia del tema Greenbubble.
    • Si quiere personalizar el tema Predeterminado (Caxton), escriba cp -r Default Custom.
    • Para personalizar el tema X1, escriba cp -r X1 Custom.
  5. Realice los cambios necesarios en los archivos copiados en **/var/netScaler/logon/themes/Custom** para personalizar el tema manualmente.
    • Realice las ediciones necesarias en css/base.css.
    • Copie las imágenes personalizadas en el directorio /var/ns_gui_custom/ns_gui/vpn/media.
    • Realice cambios en las etiquetas de los archivos presentes en el directorio resources/. Estos archivos corresponden a las configuraciones regionales admitidas por el portal.
    • Si también se necesitan cambios en páginas HTML o archivos javascript, puede hacer que lo relevante para los archivos en /var/ns_gui_custom/ns_gui/.
  6. Cuando se hayan completado todos los cambios de personalización, escriba: tar —cvzf /var/ns_gui_custom/customtheme.tar.gz /var/ns_gui_custom/ns_gui/*

Importante

Al copiar un directorio de temas en los pasos anteriores, el nombre de carpeta copiada debe escribirse exactamente como “Personalizado”, ya que los nombres de directorio distinguen entre mayúsculas y minúsculas dentro de la interfaz de shell de Citrix ADC. Si el nombre del directorio no se introduce con precisión, la carpeta no se reconoce cuando la configuración UITHEME está configurada en CUSTOM.

Seleccione el tema personalizado como parámetro global de VPN

Una vez que la configuración del portal personalizada manualmente se haya completado y se haya copiado en el sistema de archivos Citrix ADC, debe aplicarse a la configuración de Citrix Gateway. Esto se hace estableciendo el parámetro UITHEME en CUSTOM y se puede completar con la línea de comandos o la utilidad de configuración.

Para utilizar la línea de comandos, escriba el siguiente comando para establecer el parámetro UITHEME.

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

Para establecer el parámetro UITHEME mediante la utilidad de configuración, utilice el procedimiento siguiente.

  1. En la ficha Configuración, vaya a Citrix Gateway > Configuración global.
  2. Haga clic en Cambiar configuración global.
  3. Haga clic en la ficha Experiencia del cliente.
  4. Desplácese hasta la parte inferior de la pantalla y seleccione CUSTOM en el menú de la lista Tema de la interfaz de usuario.
  5. Haga clic en Aceptar.

Su portal personalizado manualmente es ahora el diseño del portal presentado a los usuarios de VPN.

Creación de un contrato de licencia de usuario final

El sistema de portal VPN ofrece la opción de aplicar un contrato de licencia de usuario final (CLUF) a una configuración de portal. Una vez que un CLUF está vinculado a la configuración de Citrix Gateway, ya sea en el ámbito global de VPN o en un servidor virtual VPN relevante, los usuarios de VPN deben aceptar el CLUF como términos y condiciones antes de poder autenticarse en la VPN.

Al igual que con los temas del portal, los usuarios reciben un CLUF específico del idioma en función de la configuración regional comunicada por su explorador web. En los casos de una configuración regional que no coincide con ninguno de los idiomas admitidos, el idioma predeterminado que se sirve es el inglés. Para cada CLUF, puede introducir un mensaje personalizado en cada uno de los idiomas admitidos. El contenido pretraducido no se proporciona para las configuraciones de EULA como para los temas del portal. Si la configuración regional de un usuario coincide con un idioma en el que no se introduce contenido de CLUF, el usuario recibe una página en blanco cuando hace clic en el enlace “Términos y condiciones” en la página de inicio de sesión de VPN.

Para crear un CLUF, puede utilizar cualquiera de los controles de la utilidad de configuración de la ficha Configurar Citrix Gateway > Configuración global > CLUF o Citrix Gateway > Recursos > CLUF. Los controles del panel Configuración global se utilizan para administrar enlaces de EULA globales de VPN, mientras que el control del nodo Recursos > EULA es para operaciones generales en configuraciones de EULA. Puede administrar enlaces de EULA de servidor virtual VPN editando un servidor virtual VPN en Citrix Gateway > Servidores virtuales. Algunos comandos también están disponibles con la línea de comandos para administrar entidades de EULA. Sin embargo, los controles completos de administración del CLUF solo están disponibles en la utilidad de configuración.

Usar la línea de comandos para crear una entidad de CLUF

En el símbolo del sistema, escriba;

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

Uso de la utilidad de configuración para crear una entidad de CLUF

  1. Vaya a Citrix Gateway > Recursos > CLUF.
  2. Haga clic en Agregar para crear una entidad.
  3. Escriba un nombre para la entidad.
  4. Para cada uno de los idiomas, pegue el contenido debajo de las fichas correspondientes. Puede utilizar etiquetas de texto sin formato o HTML para dar formato al contenido, incluida una etiqueta <br> para agregar saltos de línea.
  5. Haga clic en Crear.

Una vez creada una entidad de CLUF, puede vincularse globalmente a la configuración de VPN o puede vincularse a un servidor virtual VPN.

Uso de la línea de comandos para enlazar un CLUF a VPN Global

En el símbolo del sistema, escriba;

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

Usar la utilidad de configuración para crear un enlace global de EULA VPN

  1. En la ficha Configuración, vaya a Citrix Gateway > Configuración global.
  2. En el panel de detalles principal, haga clic en Configurar un contrato de licencia de usuario final.
  3. Haga clic en Agregar enlace.
  4. Haga clic en Haga clic para seleccionar.
  5. Seleccione una entidad de CLUF y haga clic en Seleccionar.
  6. Haga clic en Vincular.
  7. Haga clic en Cerrar.

Uso de la línea de comandos para enlazar un CLUF a un servidor virtual VPN

En el símbolo del sistema, escriba;

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

Usar la utilidad de configuración para enlazar un CLUF a un servidor virtual VPN

  1. En la ficha Configuración, vaya a Citrix Gateway > Servidores virtuales.
  2. En el panel de detalles principal, seleccione un servidor virtual VPN y haga clic en Modificar.
  3. En el panel Configuración avanzada de la parte derecha de la página, haga clic en CLUF.
  4. En el panel EULA recién agregado, haga clic en Sin EULA.
  5. Haga clic en Haga clic para seleccionar.
  6. Seleccione una entidad EULA y haga clic en Seleccionar.
  7. Haga clic en Vincular.
  8. Haga clic en Listo.