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™, esta configuração substitui as três configurações legadas a seguir no Web Studio, que foram preteridas:
- Permitir redirecionamento de conteúdo bidirecional
- URLs permitidas para serem redirecionadas para o VDA
- URLs permitidas para serem redirecionadas para o Cliente
Ela 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 esta configuração estiver habilitada, as configurações de cliente para VDA são enviadas ao cliente ao conectar-se a um aplicativo ou desktop publicado para configurar o redirecionamento de conteúdo bidirecional.
Se esta 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 comportamentos inesperados.
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 de host para cliente e Acesso a Aplicativos Locais para redirecionamento de URL de 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 de usuário no Web Studio para configurar o recurso em vez do Desktop Studio.
Redirecionamento com curingas
O redirecionamento de conteúdo bidirecional suporta o uso de curingas ao definir as URLs a serem redirecionadas. Para mais detalhes e para 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.
Nota:
- Não defina a mesma URL em
hostToClientUrlseclientToHostUrlspara 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 de VDA para cliente
- Redirecionamento de cliente para VDA
Redirecionamento de VDA para 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 de VDA para cliente para a URL, especifique o seguinte:
- URL (Obrigatório) Adicione a URL que deve ser redirecionada 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 através do redirecionamento de URL de VDA para 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 através 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 redirecionamentocitrix-oauth-redir://. Quando o fluxo é concluído, a URL de redirecionamento original é então redirecionada de volta para o Host (VDA). Neste caso, qualquer servidor de Autorização OAuth deve ser configurado para permitir URLs de redirecionamentocitrix-oauth-redir://byIndex/1 (2, 3, ... N).
Nota:
Embora Padrão e Esquema sejam opcionais, se o Padrão for especificado, você também deve especificar o Esquema.
Redirecionamento de cliente para VDA
Para redirecionar URLs do cliente para o VDA, conclua as seguintes etapas:
- Configure o destino para as URLs do cliente.
- Selecione “Aplicativo Publicado” ou “Desktop Publicado”.
- Especifique o nome desse recurso.
- Adicione todas as URLs que devem ser redirecionadas para esse recurso. Você pode substituir este recurso padrão adicionando um novo aplicativo ou desktop e, em seguida, especificando as URLs a serem redirecionadas para esse recurso.
Desktop Studio
Nota:
A Citrix recomenda usar o Web Studio para configurar este 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-->
Os seguintes parâmetros devem ser definidos:
-
version: (Obrigatório) Defina como 1.
-
Para redirecionamento de URL de VDA para cliente, crie um único
hostToClientConfig. -
hostToClientUrls: (Obrigatório) Lista de URLs a serem redirecionadas do host (VDA) para o cliente. Curingas são permitidos. Se ‘*’ for especificado, então
clientToHostConfigdeve ser especificado compublishedAppOrDesktopNameType, umpublishedAppOrDesktopNamevazio e umclientToHostUrlsvazio.
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 de VDA para 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 através 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 redirecionamentocitrix-oauth-redir://. Quando o fluxo é concluído, a URL de redirecionamento original é então redirecionada de volta para o Host (VDA). Neste caso, qualquer servidor de Autorização OAuth deve ser configurado para permitir URLs de redirecionamentocitrix-oauth-redir://byIndex/1 (2, 3, ... N).
Para um redirecionamento de cliente para 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.