Proteção de aplicativos para lançamento híbrido do StoreFront
O início híbrido do Citrix Virtual Apps and Desktops ocorrem quando você faz login no StoreFront para Web (digitando a URL da loja no navegador nativo) e inicie os aplicativos e áreas de trabalho virtuais por meio do aplicativo Citrix Workspace nativo e de seu mecanismo HDX. O termo híbrido é o resultado do uso da combinação do aplicativo StoreFront para Web e do aplicativo Citrix Workspace nativo para conectar e usar os recursos.
Nota:
Quando nenhum componente nativo do aplicativo Citrix Workspace está instalado no ponto de extremidade, é uma configuração de instalação zero em que tanto a loja de aplicativos do Citrix Workspace quanto o mecanismo HDX residem no navegador. Isso é conhecido como o aplicativo Citrix Workspace para HTML5, hospedado no Citrix Workspace ou no Citrix Storefront. Este documento não aborda esse cenário.
O App Protection para lançamento híbrido do StoreFront fornece a capacidade de os recursos habilitados para o App Protection serem enumerados e iniciados a partir de navegadores.
Nota:
Se você selecionar as opções Usar versão light (que usa o cliente HTML5) ou Já instalado, as sessões ativadas pelo App Protection serão bloqueadas, pois o aplicativo Citrix Workspace não foi detectado com êxito no navegador.
Você pode acessar os aplicativos e desktops habilitados para o App Protection usando um navegador da Web se a personalização do StoreFront for implantada e o aplicativo nativo Citrix Workspace for detectado com êxito no navegador. Consulte a seção Como implantar .
Pré-requisitos
Verifique se você está usando o aplicativo Citrix Workspace versão 1912 LTSR ou posterior e o StoreFront versão 3.12 ou posterior. Para obter mais informações sobre as versões necessárias dos componentes Citrix para o App Protection, consulte Requisitos do sistema.
Como implantar
-
Faça o download do arquivo Zip chamado stf-customization-AppP.zip, que tem todos os arquivos necessários que você deve implantar na máquina do servidor StoreFront. Baixe o arquivo do Citrix Downloads. O arquivo inclui o seguinte:
- DLLs que você deve copiar para a pasta bin da loja
- Arquivos JavaScript e outros arquivos necessários para que a solução funcione
- Script PowerShell deploy-solution.ps1, que o administrador do StoreFront usa para implantar a solução
-
Descompacte o arquivo stf-customization-AppP.zip e abra um novo administrador PowerShell onde os arquivos são extraídos. Execute o comando
deploy-solution.ps1, que usa os seguintes argumentos:-
-Action: A ação que o script executa. Os valores permitidos são os seguintes:-
A ação
Deployimplanta a solução de maneira perfeita. Ele cria um backup dos arquivos que essa solução altera, copia os arquivos da solução e reinicia os serviços. A captura de tela a seguir descreve o comando para implantar a solução no servidor StoreFront:
-
A ação
ApplyUICustomizationaplica uma personalização na interface do usuário da loja para que você não veja as opções Já instalado e Usar versão light . Essa ação impõe a detecção do aplicativo Citrix Workspace nativo no navegador e garante que você ignore os cenários bloqueados ou não suportados.
-
A ação
RemoveUICustomizationdesfaz a ação deApplyUICustomizatione as opções Já instalada e Usar a versão light aparecem novamente.
-
-
-StoreName: Nome da loja para a qual a ação deve ser realizada. Esse parâmetro é obrigatório e deve ser transmitido junto com a açãoDeploy. -
-BackupDir: parâmetro que pode ser passado com a açãoDeploypara criar um backup no diretório necessário. Se não for passado, o backup será criado na área de trabalho. Esse é um parâmetro opcional.
-
Nota:
Se houver alguma personalização existente em StoreCustomization_Input.dll ou StoreCustomization_Launch.dll, a implantação dessa solução as substituirá.
Os aplicativos e desktops habilitados para o App Protection só serão enumerados após a implantação das personalizações. Sem a implantação, os aplicativos e desktops não são enumerados.
Experiência do usuário final com o lançamento híbrido para recursos protegidos
-
Após a implantação da solução pelo administrador no servidor StoreFront, faça login na sua loja no lado do cliente. Em seguida, acesse o StoreFront usando o URL em um navegador da web.
-
Para ver se o aplicativo Citrix Workspace foi detectado com sucesso no navegador, verifique o status atual nas configurações da sua conta.
-
Após a detecção bem-sucedida do aplicativo Citrix Workspace, você pode ver e iniciar todos os aplicativos e desktops virtuais que estão ativados para a Proteção de Aplicativos.
Ativar o rastreamento no StoreFront
Você pode ativar o rastreamento no StoreFront para coletar registros. O recurso de rastreamento grava informações detalhadas no rastreamento. Esse rastreamento pode ser usado para verificar se os rótulos de política de sessão configurados do NetScaler Gateway foram transmitidos para a loja corretamente. O local padrão para dumps de rastreamento no servidor StoreFront é C:\Program Files\ Citrix\ Receiver StoreFront\Admin\trace.
Para ativar o rastreamento e definir o nível de rastreamento, use o script do PowerShell SetDSStoreCustomizationTraceLevel.ps1. Esse script é fornecido com o SDK público de personalização do StoreFront encontrado aqui. O script usa os seguintes parâmetros:
- SiteId: ID do site do IIS em que a loja está implantada
- VirtualPath: caminho virtual para a loja
- TraceLevel: define os níveis de rastreamento, que são Error, Info, Off, Verbose e Warning
Execute os seguintes comandos do PowerShell para conhecer o SiteId e o VirtualPath da loja: cd 'c:\program files\Citrix\Receiver Storefront\Scripts'.
.\ImportModules.ps1
Get-DSStoreFeatureInstances
Use o SiteID e o VirtualPath recuperados dos comandos ao executar o script do PowerShell SetDSStoreCustomizationTraceLevel.ps1.
Solução de problemas
Ao iniciar as sessões ativadas pelo App Protection, às vezes você se depara com o seguinte erro:
Os possíveis motivos para esse erro são os seguintes:
-
Os aplicativos e desktops estão configurados para serem abertos em um navegador.
Você enfrenta esse cenário se clicar em Usar versão light durante a detecção do aplicativo Citrix Workspace, conforme mostrado na tela a seguir:
-
O navegador não detecta o aplicativo Citrix Workspace.
Você enfrenta esse cenário se clicar em Já instalado durante a detecção do aplicativo Citrix Workspace, conforme mostrado na tela a seguir:
Solução: Para corrigir os cenários anteriores e iniciar as sessões ativadas pelo App Protection, clique em Alterar o aplicativo Citrix Workspace nas Configurações da conta e aguarde a detecção do aplicativo Citrix Workspace.
Otimização
A detecção do aplicativo Citrix Workspace é obrigatória para iniciar as sessões habilitadas para o App Protection. Para evitar falhas durante lançamentos híbridos para sessões protegidas, os administradores do StoreFront podem usar a ação ApplyUICustomization do comando deploy-solution.ps1 e ocultar as opções Usar versão light e Já instalado .