Microaplicaciones

Integrar Citrix DaaS

Implemente la integración de Citrix DaaS (CVADS) para agregar microaplicaciones que ayuden a los usuarios a realizar acciones de autoservicio desde Citrix Workspace. Los usuarios pueden comprobar el estado de sus máquinas y sesiones asociadas y realizar operaciones como reiniciar, desconectar y cerrar sesión. Los administradores también pueden activar el modo de mantenimiento para las máquinas con una microaplicación en modo de administrador.

Un breve vídeo de 98 segundos de Tech Insight que muestra la funcionalidad:

Para obtener más información sobre las microaplicaciones de esta integración, consulte Usar microaplicaciones de Citrix DaaS. Para obtener más información sobre cómo actualizar la versión de esta integración de Citrix DaaS, consulte Actualizar la integración.

Pasos de implementación

  1. Crear un cliente seguro que la integración utiliza para comunicarse con las API del servicio CVAD
  2. Elegir una ubicación de proxy de API adecuada para la URL del token
  3. Recopilar la información necesaria que debe rellenarse en la configuración de integración
  4. Agregar la integración de Citrix Virtual Apps and Desktops Service y configurarla
  5. Suscribir usuarios a las microaplicaciones para que puedan utilizarse

Revisar requisitos previos

Para configurar esta integración, debe tener Citrix Workspace con Microaplicaciones y Citrix DaaS habilitados en Citrix Cloud.

Esta plantilla de integración admite VDA locales y en la nube si utiliza Citrix DaaS para la intermediación con broker.

Esta integración no admite agentes VDA con intermediación con broker desde una instancia de CVAD local, porque la instancia de CVAD local no tiene API públicas disponibles y esta integración se basa en las API públicas de Citrix Virtual Apps and Desktops Service.

Estos son los valores que se introducen al configurar la integración de Citrix Virtual Apps and Desktops Service en las microaplicaciones de Citrix Workspace:

  • ID de cliente: El ID de cliente que se utiliza al llamar a las API de Citrix Virtual Apps and Desktops Service. Su ID de cliente se encuentra en Citrix Cloud, en la página Clientes seguros.
  • URL del token: De manera predeterminada, es la URL del proxy de la API en EE. UU. Consulte Proxy de API para ver otras URL de proxy de API regionales.
  • ID de cliente: El parámetro clientID creado en el sitio web de administración de acceso e identidad de Citrix Cloud. Es necesario para obtener el token de portador requerido para la autenticación en las API de Citrix Virtual Apps and Desktops Service. Consulte Generar ID de cliente y secreto del cliente.
  • Secreto del cliente: La clave secreta creada en el sitio web de administración de acceso e identidad de Citrix Cloud. Es necesario para obtener el token de portador requerido para la autenticación en las API de Citrix Virtual Apps and Desktops Service.

Permisos para el ID y el secreto de cliente (Cliente seguro)

Al crear el cliente seguro desde Administración de acceso e identidad, la cuenta con la que ha iniciado sesión al generar el cliente seguro debe tener estos permisos de Citrix DaaS:

  • Administrador de solo lectura, Todo: Para extraer datos de Citrix DaaS.
  • Administrador de sesiones, Todo: Para realizar acciones de cierre de sesión y reinicio.
  • Administrador de asistencia técnica, Todo: Para habilitar e inhabilitar el modo de mantenimiento.

Las credenciales de cliente seguro heredan los permisos del usuario conectado. Si los permisos del usuario que inició sesión cuando se creó el cliente seguro cambian, esos nuevos permisos también se aplican a la integración.

Generar ID de cliente y secreto de cliente (Cliente seguro)

Para obtener el token de portador necesario para autenticarse y utilizar las API de Citrix Virtual Apps and Desktops Service, se requiere un ID de cliente y un secreto de cliente (cliente seguro).

Cree un cliente seguro desde la página Administración de acceso e identidad de Citrix Cloud y almacene el ID de cliente y el secreto de cliente de forma segura, ya que estos son necesarios para configurar la integración.

El nombre de cliente seguro ayuda a identificar rápidamente para qué se utiliza el cliente. Para esta integración, puede ser adecuado un nombre como “microaplicaciones de integración de DaaS”. El nombre no es necesario para configurar la integración de Citrix Virtual Apps and Desktops Service.

Un ID de cliente es una serie de números y letras, separados por guiones. Por ejemplo: 91132682-26af-460c-af73-18c0d2e95121

Un secreto de cliente tiene un aspecto parecido a este: DTcs_w_akE6mKlberYMgtg==

Puede seguir un procedimiento de creación de un cliente seguro, paso a paso, en la guía de migración de CVAD aquí: Generar el ID del cliente, el ID de la máquina cliente y la clave secreta.

Elegir un proxy de API

Citrix proporciona proxys de API en diferentes regiones. Elija el proxy más cercano a la región en la que se encuentra su instancia de Citrix Cloud:

  • EE. UU.: https://api-us.cloud.com/cctrustoauth2//tokens/clients
  • UE: https://api-eu.cloud.com/cctrustoauth2//tokens/clients
  • AP-S: https://api-ap-s.cloud.com/cctrustoauth2//tokens/clients

La configuración de integración se establece de forma predeterminada en EE. UU. Si es necesario, copie y pegue la URL de otra región en el campo URL del token.

Recopilar los datos de configuración que se van a introducir

Al configurar la integración necesitará la siguiente información:

  1. El ID de cliente de la instancia de Citrix Cloud
  2. El ID de cliente y el secreto de cliente generados al crear el cliente seguro
  3. La URL del proxy de API que se debe introducir en el campo URL del token, si no es la del proxy predeterminado en EE. UU.

Agregar la integración

Agregue la integración de Citrix DaaS a las microaplicaciones de Citrix Workspace.

Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo, una vez suscritos usuarios o grupos a ellas

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  2. Elija el mosaico de Citrix DaaS.
  3. Haga clic en Agregar.
  4. En la página Configuración:

    1. Introduzca su ID de cliente en el campo ID de cliente. Para encontrar el ID de cliente, consulte Generar el ID del cliente.

      ID de cliente de DaaS

    2. Confirme que el campo URL de token es la URL de proxy de API deseada que se recopiló anteriormente. Este valor se prerrellena con el proxy de la API de EE. UU.
    3. En el campo URL del token, reemplace por su ID de cliente. Por ejemplo, si el ID de cliente era acmecorp, la URL tendría este aspecto: https://api-us.cloud.com/cctrustoauth2/acmecorp/tokens/clients
    4. Introduzca su ID de cliente, que se generó al crearse el cliente seguro.
    5. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única que se emite con el ID de cliente al crear el cliente seguro.

      Campos de Token, ID y Secreto de DaaS

  5. Seleccione Guardar para continuar.

El servicio de microaplicaciones se sincronizará ahora con las API de Citrix Virtual Apps and Desktops Service y cargará los datos. Para obtener información completa acerca de la sincronización, consulte Sincronizar datos.

Suscribir grupos o usuarios a las microaplicaciones

Después de configurar la integración, los usuarios deben estar suscritos a las microaplicaciones para poder verlas en el espacio de trabajo. Averigüe cómo asignar suscriptores

A quién suscribe a cada microaplicación depende de sus necesidades. Sin embargo, como guía general:

  1. Suscriba a todos los usuarios que usan aplicaciones o escritorios virtuales a las microaplicaciones Mis sesiones y Mis escritorios
  2. Suscriba administradores de CVAD a la microaplicación Escritorios virtuales (modo administrador)

Usar microaplicaciones de DaaS

La integración de Citrix DaaS viene con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Mis escritorios: Busque los escritorios de Citrix Virtual Desktops y lleve a cabo acciones de autoservicio, como reiniciar, desde Citrix Workspace.

Notificación o página Flujos de trabajo por caso de uso
Página Detalles del escritorio virtual Proporciona una página con detalles del escritorio y opciones para Reiniciar escritorio y Forzar reinicio del escritorio.
Página Virtual Desktops Proporciona una lista de escritorios de Citrix Virtual Desktops asociados al usuario en la que se puede buscar, con un vínculo a la página Detalles del escritorio virtual.

Mis sesiones: Busque las sesiones virtuales de Citrix con fallos y lleve a cabo acciones de autoservicio, como cerrar sesión y desconectar, desde Citrix Workspace.

Notificación o página Flujos de trabajo por caso de uso
Página Lista de sesiones Proporciona una lista de sesiones de escritorio virtual asociadas al usuario en las que se puede realizar búsquedas, con un enlace a la página Detalles de la sesión.
Página Detalles de la sesión Proporciona una página con detalles de la sesión y máquina de escritorio virtual, además de opciones para Cerrar sesión y Desconectar sesión.

Virtual Desktops (modo de administrador): Permite a los administradores de CVAD de Citrix Workspace buscar máquinas, ver sus detalles, poner las máquinas en modo de mantenimiento y reiniciar las máquinas.

Notificación o página Flujos de trabajo por caso de uso
Una máquina con notificación de estado de fallo Cuando hay un nuevo registro de una máquina que informa de un estado defectuoso, todos los suscriptores reciben una notificación que enlaza con la página Detalles del escritorio virtual.
Página Lista de escritorios virtuales Proporciona una lista de escritorios Citrix Virtual Desktops en la que se puede buscar, con un vínculo a la página Detalles del escritorio virtual. Puede buscar por máquina o usuario.
Página Detalles del escritorio virtual Proporciona una página con detalles del escritorio y opciones para Reiniciar escritorio, Forzar reinicio del escritorio, Habilitar modo de mantenimiento e Inhabilitar modo de mantenimiento.

Actualizar integración

Si ya utiliza la integración de Citrix Virtual Apps and Desktops, siga este proceso para actualizar a la última versión. Con este proceso evitará tener que volver a suscribir a todos los usuarios.

Las mejoras incluyen:

  • El ID del sitio se obtiene automáticamente.
  • Se muestran todas las máquinas, sin limitarse a las máquinas defectuosas.
  • La sincronización incremental se ejecuta más rápido. La sincronización no elimina las sesiones eliminadas. Además, la sincronización no actualiza máquinas, sino solo sesiones.
  • Se han agregado actualizaciones después de acciones que eliminan sesiones tras cerrar la sesión, se actualizan las sesiones tras la desconexión y se establece el estado de reinicio de las máquinas.
  • Se ha agregado una opción para actualizar la información y obtener detalles de máquinas y sesiones, para que los usuarios puedan asegurarse de que lo que se ve es lo mismo que en Citrix DaaS.

Siga estos pasos:

  1. Descargue y agregue este script en la ficha Scripting de su antigua integración de Citrix DaaS.
    1. En la pantalla de configuración de la integración, seleccione Scripting en la sección de navegación izquierda.
    2. Descargue este script: Upgrade Citrix-Virtual-Apps-and-Desktops-service
    3. Seleccione Cargar script. También puede introducir el script directamente en el área de texto seleccionando Modificar.
    4. Arrastre el script a la ventana emergente de importación. Seleccione Importar.
  2. Agregue la nueva integración de Citrix DaaS desde el catálogo de plantillas proporcionadas por Citrix, pero no configure la integración.
  3. Después de agregar las integraciones, exporte cada microaplicación individualmente. Para cada microaplicación, seleccione el menú situado junto a la microaplicación y, a continuación, Exportar. Siga este procedimiento con las tres microaplicaciones.
  4. En la integración antigua (es decir, la integración que utiliza actualmente), importe los archivos que exportó.
    1. Seleccione el menú situado junto a la microaplicación y, a continuación, Importar nueva versión.
    2. Arrastre (o busque en su equipo) para agregar los archivos correspondientes a cada una de las microaplicaciones.
    3. Active la opción Eliminar tarjetas de feeds existentes para reemplazar la microaplicación original.
    4. Seleccione Importar en la parte inferior de la pantalla.
  5. Elimine todos los dispositivos de punto final de datos, excepto los que tienen scripts.
    1. Seleccione Modificar junto a la integración.
    2. En la página Carga de datos, seleccione el menú situado junto a una integración que no tenga scripts y, a continuación, Eliminar. Confirme la operación.
  6. Actualice la configuración de la integración. En concreto, la URL base, el ID de cliente y el Prefijo de encabezado, conforme a las instrucciones que aparecen en Agregar la integración. Recuerde seleccionar Guardar para completar el procedimiento.

Ha actualizado la integración de Citrix Virtual Apps and Desktops.

Cómo funciona la integración

La integración de Citrix Virtual Apps and Desktops Service utiliza las API de REST de Citrix Virtual Apps and Desktops y un ID y secreto de cliente de Citrix Cloud (denominado Cliente seguro) para funcionar.

Los requisitos de actualización del token de portador de las API de Citrix Virtual Apps and Desktops Service se gestionan mediante un proxy de API que proporciona Citrix. El proxy de API utiliza el ID y el secreto de cliente para actualizar el token de portador automáticamente y utiliza el token para autenticarse en las API de Citrix Virtual Apps and Desktops Service cuando se realizan acciones de microaplicaciones o se sincronizan los datos.

Para sincronizar los datos de las API de Citrix Virtual Apps and Desktops Service, el servicio de microaplicaciones, que forma parte de Citrix Workspace, utiliza el token de portador del proxy de API.

Los datos sincronizados se presentan en Workspace a través de microaplicaciones y se permite a los usuarios de Workspace realizar acciones en las sesiones y máquinas de Citrix Virtual Apps and Desktops Service, además de mostrar información al usuario sobre sus sesiones y máquinas, todo desde Workspace.

Más información

Sesión de Citrix Tech Zone Live que trata la integración de Citrix Virtual Apps and Desktops Service: cubre los orígenes de las microaplicaciones, para qué sirven, cómo funcionan y una demostración (~16 minutos): Tools needed for users to self-service their VDI sessions

Para obtener información detallada sobre las entidades de tabla y los dispositivos de punto final de las API de CVAD Service, consulte Especificaciones del conector de Citrix DaaS.