Documentação de produtos
Citrix DaaS™
Ver PDF

Redirecionamento do host para o cliente

May 4, 2026
Contribuição de: 
C

Observação:

Este artigo descreve as configurações legadas de redirecionamento do host para o cliente. Para as configurações mais recentes, consulte Configuração de redirecionamento de conteúdo bidirecional. As novas configurações de política terão precedência sobre as configurações legadas. A Citrix recomenda usar apenas as novas configurações de política e excluir quaisquer configurações legadas para evitar comportamento inesperado.

  • O redirecionamento do host para o cliente permite que URLs, incorporadas como hiperlinks em aplicativos em execução 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.

Requisitos do sistema

  • VDA de SO multissessã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 Redirecionamento do host para o cliente para habilitar esta funcionalidade. O Redirecionamento do host para o cliente está 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 de 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.

Observação:

  • Se um servidor Citrix não tiver as configurações de 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 de Identificador de Associação no arquivo ServerFTAdefaultPolicy.xml mencionado 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.

Observação:

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 própria 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 do RFC 6125. Por exemplo:

www.exmaple.com

*.example.com

Observação:

Você não pode usar a chave ValidSites em combinação 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 de navegador padrão anterior 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
May 4, 2026
Contribuição de: 
C
May 4, 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.