Citrix Virtual Apps and Desktops

Configurações de política de redirecionamento de conteúdo bidirecional

A seção Redirecionamento de Conteúdo Bidirecional possui configurações de política para habilitar ou desabilitar o redirecionamento de URL do cliente para o VDA e do VDA para o cliente.

As políticas de servidor são definidas no Web Studio. A partir da versão 2311 do aplicativo Citrix Workspace™, essa configuração substitui as três configurações legadas a seguir no Web Studio que estão obsoletas:

  • Permitir redirecionamento de conteúdo bidirecional
  • URLs permitidas para serem redirecionadas para o VDA
  • URLs permitidas para serem redirecionadas para o Cliente

Também substitui as três configurações de Objeto de Política de Grupo (GPO) locais a seguir em clientes Windows:

  • Redirecionamento de conteúdo bidirecional
  • Substituições de redirecionamento de conteúdo bidirecional
  • Redirecionamento OAuth

Se essa configuração estiver habilitada, as configurações do cliente para o VDA são enviadas ao cliente ao conectar-se a um aplicativo ou desktop publicado para configurar o redirecionamento de conteúdo bidirecional.

Configuração

Se essa configuração for definida, ela terá precedência sobre as configurações legadas no Web Studio e no cliente. A Citrix® recomenda usar apenas as novas configurações de política e excluir quaisquer configurações legadas para evitar comportamento inesperado.

As políticas de cliente não devem ser definidas se o VDA e o DDC estiverem executando a versão 2311 ou posterior. Caso contrário, as políticas de cliente são definidas a partir do modelo administrativo de Objeto de Política de Grupo do aplicativo Citrix Workspace.

A Citrix oferece redirecionamento do host para o cliente e Acesso a Aplicativos Locais para redirecionamento de URL do cliente. No entanto, a Citrix recomenda que você use o redirecionamento de conteúdo bidirecional para clientes Windows ingressados no domínio.

A Citrix recomenda usar a nova interface do usuário no Web Studio para configurar o recurso em vez do Desktop Studio.

Redirecionamento de curinga

O redirecionamento de conteúdo bidirecional oferece suporte ao uso de curingas ao definir as URLs a serem redirecionadas. Para obter mais detalhes e configurar o redirecionamento de conteúdo bidirecional, consulte as instruções de Configuração. No Web Studio, defina a URL curinga editando a string JSON como um valor na chave url no array hostToClientUrls ou no array clientToHostUrls.

Observação:

  • Não defina a mesma URL em hostToClientUrls e clientToHostUrls para evitar loops infinitos.
  • Domínios de nível superior não são suportados. Por exemplo, https://www.citrix.* ou http://www.citrix.co* não é redirecionado.

Configuração de redirecionamento de conteúdo bidirecional

Defina esta política como Enabled para começar a configurar o recurso e clique em “Gerenciar URLs”. Defina as seguintes configurações:

  • Redirecionamento do VDA para o cliente
  • Redirecionamento do cliente para o VDA

Redirecionamento do VDA para o cliente

Para redirecionar URLs do VDA para o cliente, insira uma URL por linha. Curingas são permitidos. O redirecionamento OAuth permite que você use o navegador no endpoint do cliente para realizar a autenticação e enviar o token de volta para o VDA.

Benefícios:

  • Você pode evitar armazenar essas credenciais no ambiente hospedado.
  • Você pode usar recursos biométricos que estão disponíveis no endpoint e não no VDA.

Configurações:

Para configurar o redirecionamento do VDA para o cliente para a URL, especifique o seguinte:

  • URL (Obrigatório) Adicione a URL que deve redirecionar do VDA para abrir no cliente. Para Redirecionamento OAuth, defina o esquema de autenticação e o padrão no cliente para redirecionar a sessão de volta para o host.
  • Padrão: (Opcional) Expressão regular de URL que, quando redirecionada para o cliente por meio do redirecionamento de URL do VDA para o Cliente, é rastreada como se um fluxo de autenticação OAuth tivesse começado, e quando o fluxo é concluído (detectado pelo esquema resultante ou padrão de URL de redirecionamento sendo aberto), essa URL resultante é redirecionada de volta para o VDA host que iniciou esse fluxo.
  • Esquema: (Opcional) Se o Esquema for especificado, a URL de término deve ter o formato: <scheme>://<something>. Considere que o Esquema não é especificado (vazio). Nesse caso, o padrão de URL resultante original é extraído do Padrão por meio de um grupo de captura de expressão regular (deve ser especificado no Padrão), e a URL original é reescrita para usar uma URL de redirecionamento citrix-oauth-redir://. Quando o fluxo é concluído, a URL de redirecionamento original é então redirecionada de volta para o Host (VDA). Nesse caso, qualquer servidor de Autorização OAuth deve ser configurado para permitir URLs de redirecionamento citrix-oauth-redir://byIndex/1 (2, 3, ... N).

Bidirecional

Observação:

Embora tanto o Padrão quanto o Esquema sejam opcionais, se o Padrão for especificado, você também deve especificar o Esquema.

Redirecionamento do cliente para o VDA

Para redirecionar URLs do cliente para o VDA, conclua as seguintes etapas:

  1. Configure o destino para as URLs do cliente.
  2. Selecione “Aplicativo Publicado” ou “Desktop Publicado”.
  3. Especifique o nome desse recurso.
  4. Adicione todas as URLs que devem ser redirecionadas para esse recurso. Você pode substituir esse recurso padrão adicionando um novo aplicativo ou desktop e, em seguida, especificando as URLs a serem redirecionadas para esse recurso.

Cliente para VDA

Desktop Studio

Observação:

A Citrix recomenda usar o Web Studio para configurar esse recurso a partir da versão 2402 do Citrix Virtual Apps and Desktops™ em diante.

Para configurar o redirecionamento de conteúdo bidirecional para 2311, crie uma string JSON com o seguinte formato:

{
  "version": 1,
  "hostToClientConfig": [
    {
      "hostToClientUrls": [
        {
          "url": "http://www.citrix.com/*"
        },
        {
          "url": "www.example.com"
        },
        {
          "url": "https://login.example.org/*",
          "oAuthRedirectionPattern": "https://login.example.org/oauth2?.*",
          "oAuthScheme": "idm.desktop-authentication"
        }
      ]
    }
  ],
  "clientToHostConfig": [
    {
      "publishedAppOrDesktopNameType": "Desktop",
      "publishedAppOrDesktopName": "Win11Desktop",
      "clientToHostUrls": [
        "https://www.example.net",
        "https://*.citrix.example"
      ]
    },
    {
      "publishedAppOrDesktopNameType": "Application",
      "publishedAppOrDesktopName": "Chrome",
      "clientToHostUrls": [
        "https://tibco.example"
      ]
    }
  ]
}
<!--NeedCopy-->

habilitar bcr

Os seguintes parâmetros devem ser definidos:

  • version: (Obrigatório) Defina como 1.

  • Para redirecionamento de URL do VDA para o cliente, crie uma única hostToClientConfig.

  • hostToClientUrls: (Obrigatório) Lista de URLs a serem redirecionadas do host (VDA) para o cliente. Curingas são permitidos. Se hostToClientConfig for especificado, mas o redirecionamento do VDA do cliente para o host não for necessário, então clientToHostConfig deve ser especificado com publishedAppOrDesktopNameType, um publishedAppOrDesktopName vazio e um clientToHostUrls vazio.

Editar configuração

Redirecionamento OAuth

O redirecionamento OAuth permite que você use o navegador do endpoint do cliente para autenticar e enviar o token de volta para o VDA.

Benefícios:

  • Você pode evitar armazenar essas credenciais no ambiente hospedado.
  • Você pode usar recursos biométricos que estão disponíveis no endpoint e não no VDA.

Para configurar o redirecionamento OAuth para a URL, especifique os seguintes parâmetros:

  • oAuthRedirectionPattern: (Opcional) Expressão regular de URL que, quando redirecionada para o cliente via redirecionamento de URL do VDA para o Cliente, é rastreada como se um fluxo de autenticação OAuth tivesse começado, e quando o fluxo é concluído (detectado pelo esquema resultante ou padrão de URL de redirecionamento sendo aberto), essa URL resultante é redirecionada de volta para o VDA host que iniciou esse fluxo.
  • oAuthScheme: (Opcional) Se um Esquema for especificado, a URL de término deve ter o formato: <scheme>://<something>. Considere que o Esquema não é especificado (vazio). Nesse caso, o padrão de URL resultante original é extraído do Padrão por meio de um grupo de captura de expressão regular (deve ser especificado no Padrão), e a URL original é reescrita para usar uma URL de redirecionamento citrix-oauth-redir://. Quando o fluxo é concluído, a URL de redirecionamento original é então redirecionada de volta para o Host (VDA). Nesse caso, qualquer servidor de Autorização OAuth deve ser configurado para permitir URLs de redirecionamento citrix-oauth-redir://byIndex/1 (2, 3, ... N).

Para um redirecionamento do cliente para o VDA, crie clientToHostConfig para cada recurso a ser redirecionado. Para cada recurso, inclua os seguintes parâmetros:

  • publishedAppOrDesktopNameType: (Obrigatório) Um desktop publicado (“Desktop”) ou um aplicativo publicado (“Application”) configurado no Web Studio. Se o recurso não for válido, o redirecionamento não funcionará corretamente.
  • publishedAppOrDesktopName: (Obrigatório) Nome do recurso conforme configurado no Web Studio.
  • clientToHostUrls: (Obrigatório) Lista de URLs a serem redirecionadas do cliente para o host (VDA). Curingas são permitidos.

Limitação conhecida

Ao iniciar um navegador usando o PowerShell com um esquema de URL personalizado (não HTTP ou HTTPS), as URLs personalizadas não são redirecionadas para o cliente.

Configurações de política de redirecionamento de conteúdo bidirecional