Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Redirecionamento do host para o cliente

January 23, 2026
Contribuição de: 
C

O redirecionamento do host para o cliente permite que URLs, incorporadas como hiperlinks em aplicativos executados em uma sessão Citrix®, sejam abertas usando o aplicativo correspondente no dispositivo de endpoint do usuário. Alguns casos de uso comuns para o redirecionamento do host para o cliente incluem:

  • Redirecionamento de sites em casos em que o servidor Citrix não tem acesso à Internet ou à rede para a origem.
  • Redirecionamento de sites quando a execução de um navegador da web dentro da sessão Citrix não é desejada por motivos de segurança, desempenho, compatibilidade ou escalabilidade.
  • Redirecionamento de tipos de URL específicos em casos em que os aplicativos necessários para abrir a URL não estão instalados no servidor Citrix.

O redirecionamento do host para o cliente não se destina a URLs que você acessa em uma página da web ou digita na barra de endereços do navegador da web em execução na sessão Citrix. Para redirecionamento de URLs em navegadores da web, consulte Redirecionamento bidirecional de URL ou Redirecionamento de conteúdo do navegador.

Requisitos do sistema

  • VDA de SO multi-sessão
  • Clientes compatíveis:
    • Aplicativo Citrix Workspace™ para Windows
    • Aplicativo Citrix Workspace para Mac
    • Aplicativo Citrix Workspace para Linux
    • Aplicativo Citrix Workspace para HTML5
    • Aplicativo Citrix Workspace para Chrome

O dispositivo cliente deve ter um aplicativo instalado e configurado para lidar com o redirecionamento dos tipos de URL.

Configuração

Use a política Citrix de Redirecionamento do host para o cliente para habilitar essa funcionalidade. O Redirecionamento do host para o cliente é desabilitado por padrão. Depois de habilitar a política de redirecionamento do host para o cliente, o aplicativo Citrix Launcher se registra no servidor Windows para garantir que ele possa interceptar URLs e enviá-las para o dispositivo cliente.

Em seguida, você deve configurar a Política de Grupo do Windows para usar o Citrix Launcher como o aplicativo padrão para os tipos de URL necessários. No VDA do servidor Citrix, crie o arquivo ServerFTAdefaultPolicy.xml e insira o seguinte código XML.

<?xml version="1.0" encoding="UTF-8"?>

<DefaultAssociations>

<Association Identifier="http" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />

<Association Identifier="https" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />

</DefaultAssociations>
<!--NeedCopy-->

No console de gerenciamento da Política de Grupo, vá para Configuração do computador > Modelos administrativos > Componentes do Windows > Explorador de Arquivos > Definir um arquivo de configuração de associações padrão, e salve seu arquivo ServerFTAdefaultPolicy.xml.

Nota:

Se um servidor Citrix não tiver as configurações da Política de Grupo, o Windows solicitará que os usuários selecionem um aplicativo para abrir URLs.

Por padrão, oferecemos suporte ao redirecionamento dos seguintes tipos de URL:

  • HTTP
  • HTTPS
  • RTSP
  • RTSPU
  • PNM
  • MMS

Para incluir tipos de URL padrão ou personalizados adicionais na lista para redirecionamento, crie uma nova linha Association Identifier no arquivo ServerFTAdefaultPolicy.xml referenciado anteriormente. Por exemplo:

<Association Identifier="ftp" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />

<Association Identifier="mailto" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />

<Association Identifier="customtype1" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />

<Association Identifier="customtype2" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />

Adicionar tipos de URL à lista também requer configuração do cliente. Crie a seguinte chave de registro e valores no cliente Windows.

Nota:

A edição incorreta do registro pode causar problemas sérios que podem exigir a reinstalação do seu sistema operacional. A Citrix não pode garantir que os problemas resultantes do uso incorreto do Editor do Registro possam ser resolvidos. Use o Editor do Registro por sua conta e risco. Certifique-se de fazer backup do registro antes de editá-lo.

  • Chave: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Policies\Citrix\ICA Client\SFTA
  • Nome do valor: ExtraURLProtocols
  • Tipo de valor: REG_SZ
  • Dados do valor: Especifique os tipos de URL necessários separados por ponto e vírgula. Inclua tudo antes da parte da autoridade da URL. Por exemplo: ftp://;mailto:;customtype1://;custometype2://

Você pode adicionar tipos de URL apenas para clientes Windows. Clientes que não possuem as configurações de registro acima rejeitam o redirecionamento de volta para a sessão Citrix. O cliente deve ter um aplicativo instalado e configurado para lidar com os tipos de URL especificados.

Para remover tipos de URL da lista de redirecionamento padrão, crie a seguinte chave de registro e valores no VDA do servidor.

  • Chave: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA

  • Nome do valor: DisableServerFTA
  • Tipo de valor: DWORD

  • Dados do valor: 1

  • Nome do valor: NoRedirectClasses
  • Tipo de valor: REG_MULTI_SZ
  • Dados do valor: Especifique qualquer combinação dos valores: http, https, rtsp, rtspu, pnm ou mms. Digite vários valores em linhas separadas. Por exemplo:

http

https

rtsp

Para habilitar o redirecionamento do host para o cliente para um conjunto específico de sites, crie uma chave de registro e valores no VDA do servidor.

  • Chave: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA
  • Nome do valor: ValidSites
  • Tipo de valor: REG_MULTI_SZ
  • Dados do valor: Especifique qualquer combinação de nomes de domínio totalmente qualificados (FQDNs). Digite vários FQDNs em linhas separadas. Inclua apenas o FQDN, sem protocolos (http:// ou https://). Um FQDN pode incluir um asterisco (*) como caractere curinga apenas na posição mais à esquerda. Este curinga corresponde a um único nível de domínio, o que é consistente com as regras no RFC 6125. Por exemplo:

www.exmaple.com

*.example.com

Nota:

Você não pode usar a chave ValidSites com as chaves DisableServerFTA e NoRedirectClasses.

Configuração do navegador padrão do VDA do servidor

A habilitação do redirecionamento do host para o cliente, conforme referenciado nesta seção, substitui qualquer configuração anterior do navegador padrão no VDA do servidor. Se uma URL da web não for redirecionada, o Citrix Launcher passa a URL para o navegador configurado na chave de registro command_backup. A chave aponta para o Internet Explorer por padrão, mas você pode modificá-la para incluir o caminho para um navegador diferente. Para obter mais informações, consulte Configuração do navegador padrão do VDA do servidor na lista de recursos gerenciados por meio do registro.

Redirecionamento do host para o cliente
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.