API
Las API de Citrix Provisioning están disponibles en el sitio de la documentación de Citrix Developer:
Archivos del SDK de PowerShell después de la actualización
Faltan los archivos ubicados en C:\Program Files\Citrix\PowerShell SDK después de la actualización. Este problema se produce porque la versión CDF que utiliza Citrix Provisioning no coincide con la versión que utilizan otros componentes asociados a Citrix Virtual Apps and Desktops. Por eso, los archivos CDF más recientes tienen un número de versión inferior a los anteriores. Este problema no afecta a la funcionalidad de importar colecciones de dispositivos CPV a catálogos de máquinas de Citrix Virtual Apps and Desktops. Para solucionar este problema:
- Cierre Citrix Studio.
- Monte la nueva ISO de Citrix Virtual Apps and Desktops.
- En la ISO montada, vaya a \x64\DesktopStudio.
- Haga clic con el botón secundario en PVS PowerShell SDK x64 para ver un menú contextual.
- Seleccione Reparar.
- Ejecute la opción de reparación. La instalación agrega los dos archivos CDF según sea necesario.
Método de enumeración de grupos de Active Directory
La consola de Citrix Provisioning contiene el asistente Citrix Virtual Apps and Desktops Setup Wizard. Este asistente proporciona tareas de integración entre Citrix Provisioning, Citrix Virtual Apps and Desktops y Windows Active Directory. El asistente crea las máquinas virtuales y todos los objetos necesarios en Citrix Provisioning, Citrix Virtual Apps and Desktops y Windows Active Directory.
Nota:
Esta implementación estaba limitada en versiones anteriores debido a la ausencia de una API expuesta. Sin ella, los usuarios de Citrix Provisioning no pueden ejecutar varios paradigmas de pruebas automatizadas en sus entornos.
En el servidor de Provisioning, un servicio expone la funcionalidad de Citrix Virtual Apps and Desktops y Streamed VM Setup Wizard a través de una API de PowerShell. Esta API proporciona un front-end de PowerShell. Este front-end se puede utilizar para automatizar la funcionalidad que ofrecen Citrix Virtual Apps and Desktops Setup Wizard y Streamed VM Setup Wizard.
Sugerencia:
El servicio API de Citrix Provisioning utiliza una conexión SSL que requiere la configuración de un certificado X.509 en el servidor de Provisioning.
Configurar el certificado X.509
El servicio API de Citrix Provisioning utiliza una conexión SSL que requiere un certificado X.509 en el servidor de aprovisionamiento. El certificado de la entidad de certificación (CA) también debe estar presente en el servidor y en la máquina de la consola.
Para crear un certificado autofirmado para API de Citrix Provisioning:
- Descargue e instale el Windows SDK para el sistema operativo del servidor de aprovisionamiento que tenga.
- Abra un símbolo del sistema y vaya a la carpeta “bin” del SDK. De forma predeterminada:
C:\Program Files (x86)\Windows Kits\SDK_Version\bin\x64>y ejecute estos comandos. - Cree un certificado que actúe como su entidad de certificación raíz:
makecert -n "CN= PVSRoot CA" -r -sv PVSRoot CA.pvk PVSRoot CA.cer. - Cree el certificado del servicio e instálelo:
makecert -sk PVSAP I -iv PVSRoot CA.pvk -n "CN= FQDN of the PVS Server" -ic PVSRoot CA.cer -sr localmachine -ss my -sky exchange -pe. - Instale el certificado de CA raíz en la ubicación
Trusted Root Certification Authoritiesdel servidor y las máquinas de la consola:cert mgr -add "PVSRoot CA.cer" -s -r localMachine Root. - Ejecute el asistente Configuration Wizard. En la página Soap SSL Configuration, seleccione el certificado creado.
Nota:
Cuando ejecute los comandos de PowerShell, use el FQDN del servidor de aprovisionamiento en
PvsServerAddressy 54324 (predeterminado) enPvsServerPort.
API de Citrix Provisioning
Para utilizar la API de Provisioning con Citrix Virtual Apps and Desktops Service, debe proporcionar credenciales para autenticarse en Citrix Cloud.
Usar la API de Provisioning con Citrix Virtual Apps and Desktops Service
Al utilizar Citrix Virtual Apps and Desktops Service, el servicio de la API de Provisioning que se ejecuta en cada servidor de aprovisionamiento requiere credenciales para autenticarse en Citrix Cloud. Una vez proporcionadas estas credenciales, cualquier proceso que se ejecute con el nombre de usuario especificado utiliza las credenciales de cliente seguro para autenticarse en Citrix Cloud.
Para proporcionar estas credenciales:
- Inicie sesión en la página IAM del portal de Citrix Cloud como usuario administrador.
- Cree un cliente seguro desde la página IAM de Citrix Cloud. En esta página, registre también su ID de cliente.
- Descargue el cliente seguro en un archivo CSV en el servidor de PVS.
Importante: El archivo CSV contiene un secreto que se puede usar para autenticarse en Citrix Cloud como el usuario que creó el cliente seguro. Guarde y proteja este archivo.
- En cada servidor que ejecute llamadas a la API de Provisioning:
- Ejecute una ventana de PowerShell con el nombre de usuario de Provisioning Services.
- Descargue el archivo CSV.
-
Ejecute el comando:
Set-XDCredentials -CustomerId "<customerIDFromPortal>" -SecureClientFile "<CSVPath>" -ProfileType CloudAPI –StoreAs "default" <!--NeedCopy--> - Elimine la copia descargada del archivo CSV.
Usar la API de Citrix Provisioning
Después de instalar el servidor de Citrix Provisioning más reciente:
- Ejecute el asistente Configuration Wizard.
- Abra la ventana Services en el servidor de aprovisionamiento y compruebe que la API de Citrix Provisioning está instalada y configurada para ejecutarse como administrador.
Sugerencia:
El servicio API de Citrix Provisioning utiliza una conexión SSL que requiere la configuración de un certificado X.509 en el servidor de aprovisionamiento.
Abra una ventana de PowerShell en el servidor de aprovisionamiento e importe el módulo de comandos:
-
Import-Module "C:\Program Files\Citrix\Provisioning Services\Citrix.ProvisioningServices.dll". -
Get-Command-Module Citrix.ProvisioningServices. - Haga ping al servicio de la API de Citrix Provisioning API: Get-PvsApiServiceStatus -PvsServerAddress FQDN del servidor de aprovisionamiento -PvsServerPort Puerto de Provisioning donde está configurada la escucha de la API
Sugerencia:
El número de puerto del servidor de aprovisionamiento es el utilizado para la comunicación del servidor SOAP.
Inicie sesión en la API de Citrix Provisioning (use alguno de los siguientes comandos):
Use los parámetros Domain, Username o Password:
Get-PvsConnection -PvsServerAddress FQDN del servidor de aprovisionamiento -PvsServerPort Puerto SOAP +1 puerto donde la API de Provisioning se ha configurado para escuchar -Domain Dominio del administrador de Provisioning -Username Nombre de usuario del administrador de Provisioning -Password Contraseña del administrador de Provisioning
Use el objeto Pass-in PSCredential:
Get-PvsConnection -PvsServerAddress Dirección del servidor de aprovisionamiento PvsServerPort-Credentials Objeto PSCredential que devuelve Get-Credential
Se incluyen los siguientes cmdlets con la implementación de la API de Citrix Provisioning:
- Get-PvsApiServiceStatus. Hace ping al servicio para determinar si este funciona en una dirección o puerto concretos.
- Get-PvsConnection. Inicia sesión en la API de Citrix Provisioning.
- Clear-PvsConnection. Cierra la sesión de la API de Citrix Provisioning. Este cmdlet agrega el token de autenticación a la lista de bloqueados.
- Start-PvsProvisionXdMachines. Se utiliza para automatizar el asistente Citrix Virtual Apps and Desktops Setup Wizard.
- Start-PvsProvisionMachines. Se usa para automatizar el asistente Streamed VM Setup Wizard.
- Get-PvsProvisioningStatus. Usa el ID que devuelve alguno de los dos comandos anteriores para obtener el estado de la sesión actual de aprovisionamiento.
- Stop-PvsProvisionMachines. Usa el ID que devuelve alguno de los dos comandos anteriores para cancelar la sesión actual de aprovisionamiento.
Puede acceder a ejemplos de estos cmdlets de PowerShell con Get-Help CommandName – Examples:
Sugerencia:
El resto de los cmdlets de PowerShell forman parte de la capa de acceso a la base de datos.
Al conectarse a la API mediante el comando Set -PvsConnection de PowerShell, se devuelve un objeto de conexión
similar a:
Dentro de Citrix Provisioning, el método de control de acceso de los usuarios se basa en las credenciales de inicio de sesión de Active Directory y la configuración del grupo administrativo. Como resultado de este método, la enumeración repetida de grupos de AD desencadena eventos asociados a las operaciones del asistente Configuration Wizard y la consola. En entornos de AD complejos donde pueden producirse inicios de sesión falsos, el sistema puede volverse lento, con respuestas lentas que resultan en tiempos de espera agotados en las conexiones a la consola de Citrix Provisioning. Con esta función, se resuelven estos problemas porque se mejora el método responsable de la enumeración de grupos de AD.
Antes de esta función, la enumeración de grupos de AD se producía al analizar las pertenencias de miembros asociadas al inicio de sesión del usuario en su dominio y en la totalidad de los dominios de confianza. Este proceso continuaba hasta que se determinen todas las pertenencias a grupos del usuario o si no hay dominios adicionales en los que buscar. Los grupos identificados se cotejaban con los grupos administrativos definidos en la base de datos para determinar los derechos de acceso del usuario.
Con esta funcionalidad, la enumeración de grupos de AD se ha mejorado y ahora la pertenencia a grupos de un usuario se busca en los dominios preferidos. Este enfoque es diferente a buscar en la totalidad de los grupos en todos los dominios. El nombre del grupo administrativo asociado a la credencial de inicio de sesión del usuario se utiliza para obtener la lista de dominios preferidos. Primero, se busca en la lista de dominios del usuario. Luego, se busca en la lista de dominios preferidos. Durante esta búsqueda, si se detecta el grupo administrativo de una comunidad, la búsqueda se detiene porque el usuario ya tiene derecho total de acceso a la comunidad de Citrix Provisioning. Este paradigma de búsqueda también incluye un mecanismo que usa el ID de seguridad del dominio para verificar si el dominio contiene los grupos previstos. Este enfoque modificado de búsqueda de dominios para encontrar la pertenencia a grupos de un usuario subviene a las necesidades de la mayoría de los entornos de AD, lo que resulta en operaciones más rápidas de la consola de aprovisionamiento y del asistente Configuration Wizard.