Comunicação WebSocket entre VDA e Delivery Controller™

Last published : Nov 13, 2026
Este artigo descreve como configurar uma conexão WebSocket para comunicação entre VDAs e Delivery Controllers.
Related information
Seguro

Visão geral

O protocolo WebSocket funciona sobre o Protocolo de Brokering Citrix e facilita a comunicação estável entre Delivery Controllers e VDAs. O uso do protocolo WebSocket para comunicação oferece os seguintes benefícios:
  • Requer apenas a porta TLS 443 para comunicação do VDA para o Delivery Controller.
  • Fornece canais de comunicação contínuos e confiáveis entre VDAs e Delivery Controllers.

Como funciona

A seção a seguir descreve o fluxo de trabalho para a conexão WebSocket entre um Delivery Controller e um VDA:
  1. Os administradores do Citrix Virtual Apps and Desktops™ iniciam o processo provisionando VDAs usando o Machine Creation Service (MCS).
  2. Durante o processo de provisionamento do MCS, o MCS gera pares de chaves pública-privada para cada VDA e registra as chaves públicas com o serviço de confiança FMA no Delivery Controller. O MCS salva o par de chaves pública-privada como um arquivo no disco de identidade nos VDAs.
  3. Quando a máquina VDA inicializa, o agente MCS instalado na máquina VDA lê o par de chaves do disco de identidade e grava essas informações no local do registro do VDA.
  4. O agente de broker instalado no VDA lê os pares de chaves do registro e gera uma solicitação WebSocket habilitada para SSL para o Delivery Controller com a chave de serviço assinada pela chave privada.
  5. O Delivery Controller verifica o cabeçalho de autorização da chave de serviço assinada com a chave pública do serviço de confiança FMA.
  6. Concluída a verificação, o sistema estabelece a conexão WebSocket entre o VDA e o Delivery Controller.

Suporte WebSocket para VDAs ingressados no AD

Antes de começar

  1. Configure seu site. Para obter mais informações, consulte Criar um site.
  2. Instale certificados TLS nos Delivery Controllers. Para obter mais informações, consulte Instalar certificados de servidor TLS nos Controllers.
  3. Instale a CA raiz e a CA intermediária no VDA para confiar no Delivery Controller.

Procedimento

Siga as instruções para configurar uma conexão WebSocket:
  1. Habilite a conexão WebSocket no Delivery Controller. Execute o seguinte comando em cada Delivery Controller presente em seu site:
    New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
    Observação:
    Certifique-se de reiniciar os Delivery Controllers após habilitar o WebSocket.
  2. Crie um catálogo de máquinas para VDAs unidos ao AD com provisionamento MCS. Para obter mais informações, consulte Criar catálogo de máquinas.
  3. Crie um grupo de entrega e adicione seu VDA a ele. Para obter mais informações, consulte Criar grupos de entrega.
  4. Habilite a conexão WebSocket no VDA. Execute o seguinte comando no VDA:
    New-ItemProperty "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixBrokerAgent\WebSocket" -Name "Enabled" -PropertyType "DWord" -Value 1 -Force
    • Para verificar se o VDA está conectado ao servidor via WebSocket, verifique o seguinte valor da chave de registro.
      Chave:
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixBrokerAgent\WebSocket
      Nome: Conectado
      Tipo: REG_DWORD
      Valor: 1 ou 0
      1: VDA conectado ao servidor usando WebSocket.
      0: O VDA não consegue alcançar o servidor via WebSocket ou o WebSocket não está ativado.
    • Para verificar se o WebSocket está ativado, verifique o seguinte valor da chave de registro. O valor de Enabled deve ser 1.
      Chave:
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixBrokerAgent\WebSocket
      Nome: Habilitado
      Tipo: REG_DWORD
      Valor: 1