Redirecionamento de conteúdo bidirecional
O redirecionamento de conteúdo bidirecional permite que URLs HTTP ou HTTPS em navegadores da web, ou incorporadas em aplicativos, sejam encaminhadas entre a sessão do Citrix VDA e o endpoint do cliente em ambas as direções. Uma URL inserida em um navegador em execução na sessão Citrix pode ser aberta usando o navegador padrão do cliente. Por outro lado, uma URL inserida em um navegador em execução no cliente pode ser aberta em uma sessão Citrix, seja com um aplicativo ou desktop publicado. Alguns casos de uso comuns para o redirecionamento de conteúdo bidirecional incluem:
- Redirecionamento de URLs da web em casos em que o navegador inicial não tem acesso à rede da origem.
- Redirecionamento de URLs da web por motivos de compatibilidade do navegador e segurança.
- Redirecionamento de URLs da web incorporadas em aplicativos quando não se deseja executar um navegador da web na sessão Citrix ou no cliente.
Requisitos do sistema
- VDAs de SO de sessão única ou multi-sessão
- Aplicativo Citrix Workspace™ para Windows 2311 ou superior
- Aplicativo Citrix Workspace™ para Linux 2503 ou superior
- Aplicativo Citrix Workspace™ para Mac 2607 ou superior
Navegadores:
- Google Chrome com a Extensão de Redirecionamento de Navegador Citrix
- Microsoft Edge com a Extensão de Redirecionamento de Navegador Citrix
Configuração
A partir da versão 2311 do Citrix Virtual Apps and Desktops™, o redirecionamento de conteúdo bidirecional é configurado apenas através do Citrix Studio. As versões anteriores tinham configurações de política configuradas tanto no endpoint do cliente quanto no Studio. O redirecionamento de conteúdo bidirecional é desabilitado por padrão.
Para configuração do VDA, consulte Redirecionamento de conteúdo bidirecional nas configurações da política ICA.
Para que o redirecionamento do navegador funcione, as extensões do navegador devem ser registradas no navegador de origem (de onde a URL é redirecionada) usando os comandos mostrados. Execute os comandos conforme necessário no VDA e no cliente, com base no navegador em uso.
| Navegador | VDA | Cliente |
|---|---|---|
| Google Chrome | “%ProgramFiles(x86)%\Citrix\HDX\bin\vdaredirector.exe” /regChrome | “%ProgramFiles(x86)%\Citrix\ICA Client\redirector.exe” /regChrome |
| Microsoft Edge | “%ProgramFiles(x86)%\Citrix\HDX\bin\vdaredirector.exe” /regEdge | “%ProgramFiles(x86)%\Citrix\ICA Client\redirector.exe” /regEdge |
| Todos os Navegadores Disponíveis | “%ProgramFiles(x86)%\Citrix\HDX\bin\vdaredirector.exe” /regall | “%ProgramFiles(x86)%\Citrix\ICA Client\redirector.exe” /regall |
Para cancelar o registro de uma extensão de navegador:
| Navegador | VDA | Cliente |
|---|---|---|
| Google Chrome | “%ProgramFiles(x86)%\Citrix\HDX\bin\vdaredirector.exe” /unregChrome | “%ProgramFiles(x86)%\Citrix\ICA Client\redirector.exe” /unregChrome |
| Microsoft Edge | “%ProgramFiles(x86)%\Citrix\HDX\bin\vdaredirector.exe” /unregEdge | “%ProgramFiles(x86)%\Citrix\ICA Client\redirector.exe” /unregEdge |
| Todos os Navegadores Disponíveis | “%ProgramFiles(x86)%\Citrix\HDX\bin\vdaredirector.exe” /desregistrar_tudo | “%ProgramFiles(x86)%\Citrix\ICA Client\redirector.exe” /desregistrar_tudo |
Nota:
- Execute esses comandos em uma janela do Prompt de Comando (CMD) com privilégios de administrador.
- O comando de registro faz com que os navegadores Chrome e Edge solicitem aos usuários que habilitem a Extensão de Redirecionamento de Navegador Citrix durante o primeiro lançamento.
- O comando de registro também vincula a Extensão de Redirecionamento de Navegador ao host de mensagens nativas, o que permite que a extensão se comunique com o código nativo. Sem isso, o navegador bloqueia a comunicação.
- Você também pode instalar a extensão do navegador manualmente na Google Chrome Web Store. Para usar a Extensão de Redirecionamento de Navegador da loja de Complementos do Microsoft Edge, você precisa da versão 2503 ou posterior do Virtual Delivery Agent (VDA). Para versões mais antigas do VDA, instale a extensão da Google Chrome Web Store dentro do seu navegador Microsoft Edge (consulte Adicionar uma extensão ao Microsoft Edge da Chrome Web Store).
- As versões do aplicativo Citrix Workspace listadas nos requisitos do sistema são as versões mínimas necessárias para suportar o redirecionamento de conteúdo bidirecional e o redirecionamento OAuth.
- Para Mac: devido aos requisitos de segurança do macOS para aplicativos autenticados, os esquemas de URL de retorno de chamada OAuth personalizados devem ser pré-registrados com a Citrix e não podem ser alterados dinamicamente após a instalação. Apenas
citrix-oauth-rediré suportado por padrão. Entre em contato com a equipe de Produto da Citrix para registrar seu esquema de URL.
Redirecionamento curinga do Citrix VDA para o cliente
O redirecionamento de conteúdo bidirecional suporta o uso de curingas ao definir as URLs a serem redirecionadas. Para configurar o redirecionamento de conteúdo bidirecional, consulte as instruções de configuração.
Redirecionamento de protocolo personalizado do VDA para o cliente
O redirecionamento de conteúdo bidirecional suporta o redirecionamento de protocolos personalizados do Citrix VDA para o cliente. Protocolos diferentes de HTTP ou HTTPS são suportados. Para configurar o redirecionamento de conteúdo bidirecional, consulte as instruções de configuração.
No Web Studio, defina o protocolo personalizado em Redirecionamento de conteúdo bidirecional.
Nota:
Você deve ter privilégios de administrador para executar esses comandos.
- O cliente deve ter um aplicativo registrado para manipular o protocolo. Caso contrário, a URL redireciona para o cliente e falha ao iniciar.
- URLs de protocolo personalizado que você insere ou inicia nos navegadores Chrome e Edge não são suportadas e não são redirecionadas.
- Os seguintes protocolos não são suportados:
rtsp://, rtspu://, pnm://, mms://.
Outras considerações
- Os requisitos e configurações do navegador são aplicáveis apenas ao navegador que inicia o redirecionamento. O navegador de destino, onde a URL é aberta após o redirecionamento ser bem-sucedido, não é considerado para suporte. Ao redirecionar URLs do VDA para um cliente, uma configuração de navegador suportada é necessária apenas no VDA. Por outro lado, ao redirecionar URLs do cliente para um VDA, uma configuração de navegador suportada é necessária apenas no cliente. As URLs redirecionadas são entregues ao navegador padrão configurado na máquina de destino, seja o cliente ou o VDA, dependendo da direção. Não é necessário usar o mesmo tipo de navegador no VDA e no cliente.
- Verifique se as regras de redirecionamento não resultam em uma configuração de loop. Por exemplo, uma política de VDA é definida para redirecionar
https://www.citrix.com, e a política do cliente é definida para redirecionar a mesma URL, resultando em um loop infinito. - Encurtadores de URL não são suportados.
- O redirecionamento do cliente para o VDA requer que o cliente Windows seja instalado com direitos de administrador.
- Se o navegador de destino já estiver aberto, a URL redirecionada será aberta em uma nova guia. Caso contrário, a URL será aberta em uma nova janela do navegador.
- O redirecionamento bidirecional de conteúdo não funciona quando o Acesso a Aplicativos Locais (LAA) está ativado.