App Protection per il lancio ibrido di StoreFront
Il lancio ibrido di Citrix Virtual Apps and Desktops avviene quando si accede a StoreFront per Web (digitando l’URL dello store nel browser nativo) e si avviano le app e i desktop virtuali tramite l’app Citrix Workspace nativa e il suo motore HDX. Il termine ibrido deriva dall’utilizzo della combinazione dell’app StoreFront per Web e dell’app Citrix Workspace nativa per connettere e utilizzare le risorse.
Nota:
Quando sull’endpoint non è installato nessun componente nativo dell’app Citrix Workspace, si tratta di una configurazione a installazione zero in cui sia lo store di Citrix Workspace che il motore HDX risiedono all’interno del browser. Questa è nota come app Citrix Workspace per HTML5, ospitata su Citrix Workspace o Citrix Storefront. Questo documento non affronta questo scenario.
App Protection per l’avvio ibrido per StoreFront offre la possibilità di enumerare e avviare le risorse abilitate ad App Protection dai browser.
Nota:
Se si selezionano le opzioni Use light version (Usa versione light) (che utilizza il client HTML5) o Already installed (Già installato), le sessioni abilitate ad App Protection vengono bloccate, dato che l’app Citrix Workspace non viene rilevata correttamente nel browser.
È possibile accedere alle app e ai desktop abilitati ad App Protection utilizzando un browser Web se è stata implementata la personalizzazione StoreFront e l’app Citrix Workspace nativa viene rilevata correttamente nel browser. Vedere la sezione Come distribuire.
Prerequisiti
Accertarsi di stare utilizzando l’app Citrix Workspace versione 1912 LTSR o successiva e StoreFront versione 3.12 o successiva. Per ulteriori informazioni sulle versioni richieste dei componenti Citrix per App Protection, vedere Requisiti di sistema.
Come distribuire
-
Scaricare il file .zip denominato stf-customization-AppP.zip, che contiene tutti i file necessari da distribuire sul computer server StoreFront. Scaricare il file da Citrix Downloads. Il file include quanto segue:
- DLL da copiare nella cartella Cestino dello store
- File JavaScript e altri file necessari per il funzionamento della soluzione
- Script PowerShell deploy-solution.ps1, utilizzato dall’amministratore di StoreFront per distribuire la soluzione
-
Decomprimere il file stf-customization-AppP.zip e aprire un nuovo PowerShell per amministratore in cui vengono estratti i file. Eseguire il comando
deploy-solution.ps1
, che contempla i seguenti argomenti:-
-Action
: l’azione eseguita dallo script.@@@ I valori consentiti sono i seguenti:-
L’azione
Deploy
implementa la soluzione in modo semplice. Crea un backup dei file modificati da questa soluzione, copia i file della soluzione e riavvia i servizi. La schermata seguente descrive il comando per distribuire la soluzione sul server StoreFront: -
L’azione
ApplyUICustomization
applica una personalizzazione nell’interfaccia utente dello store in modo che non vengano visualizzate le opzioni Already installed (Già installato) e Use light version (Usa versione leggera). Questa azione applica il rilevamento dell’app Citrix Workspace nativa nel browser e garantisce che vengano aggirati gli scenari bloccati o non supportati. -
L’azione
RemoveUICustomization
annulla l’azione diApplyUICustomization
e vengono nuovamente visualizzate le opzioni Already Installed (Già installato) e Use light version (Usa versione leggera).
-
-
-StoreName
: nome dello store per il quale deve essere intrapresa l’azione. Questo parametro è obbligatorio e deve essere passato insieme all’azioneDeploy
. -
-BackupDir
: parametro che può essere passato con l’azioneDeploy
per creare un backup nella directory richiesta. Se non viene passato, il backup viene creato sul desktop. Si tratta di un parametro opzionale.
-
Nota:
Se sono presenti personalizzazioni esistenti in StoreCustomization_Input.dll o StoreCustomization_Launch.dll, l’implementazione di questa soluzione le sostituisce.
Le app e i desktop abilitati per App Protection verranno enumerati solo dopo aver implementato le personalizzazioni. Senza la distribuzione, le app e i desktop non vengono enumerati.
Esperienza utente finale con lancio ibrido di risorse protette
-
Dopo l’implementazione della soluzione da parte dell’amministratore sul server StoreFront, accedere al proprio store sul lato client. Quindi accedere a StoreFront utilizzando l’URL in un browser Web.
-
Per vedere se l’app Citrix Workspace è stata rilevata correttamente nel browser, selezionare Current status in Account Settings (Impostazioni dell’account).
-
Dopo che l’app Citrix Workspace è stata rilevata correttamente, è possibile visualizzare e avviare tutte le app e i desktop virtuali abilitati per App Protection.
Abilitare il tracciamento su StoreFront
È possibile abilitare il tracciamento su StoreFront per raccogliere i registri. La funzione di tracciamento scrive informazioni dettagliate nella traccia. Questa traccia può essere utilizzata per verificare se le etichette dei criteri di sessione di NetScaler Gateway configurate vengono trasmesse correttamente allo store. La posizione predefinita per i dump di traccia sul server StoreFront è C:\Programmi\Citrix\Receiver StoreFront\Admin\trace.
Per abilitare il tracciamento e impostare il livello di traccia, utilizzare lo script PowerShell SetDSStoreCustomizationTraceLevel.ps1
. Questo script viene fornito con l’SDK di personalizzazione pubblico di StoreFront disponibile qui. Lo script accetta i seguenti parametri:
- SiteId: ID del sito IIS in cui viene distribuito lo store
- VirtualPath: percorso virtuale dello store
- TraceLevel: imposta i livelli di traccia, che sono Error, Info, Off, Verbose e Warning
Eseguire i seguenti comandi PowerShell per conoscere il SiteId e il VirtualPath dello store: cd 'c:\program files\Citrix\Receiver Storefront\Scripts'.
.\ImportModules.ps1
Get-DSStoreFeatureInstances
Utilizzare i parametri SiteId e VirtualPath recuperati dai comandi durante l’esecuzione dello script PowerShell SetDSStoreCustomizationTraceLevel.ps1.
Risoluzione dei problemi
Quando si avviano le sessioni abilitate a App Protection, a volte si incontra il seguente errore:
Le possibili cause di questo errore sono le seguenti:
-
Le app e i desktop sono configurati per l’apertura in un browser.
Questo scenario si presenta se si fa clic su Use light version (Usa versione leggera) durante il rilevamento dell’app Citrix Workspace, come illustrato nella schermata seguente:
-
Il browser non rileva l’app Citrix Workspace.
Questo scenario si presenta quando era stato selezionato Already installed (Già installato) durante il rilevamento dell’app Citrix Workspace, come illustrato nella schermata seguente:
Soluzione: per correggere gli scenari precedenti e avviare le sessioni abilitate per App Protection, fare clic su Change Citrix Workspace App (Cambia l’app Citrix Workspace) in Account Settings e attendete che l’app Citrix Workspace venga rilevata.
Ottimizzazione
Il rilevamento dell’app Citrix Workspace è obbligatorio per avviare le sessioni abilitate per App Protection. Per evitare errori durante gli avvii ibridi delle sessioni protette, gli amministratori di StoreFront possono utilizzare l’azione ApplyUICustomization
del comando deploy-solution.ps1
e nascondere le opzioni Use light version e Already installed.