VNC#

Uso do VNC#

VNC (Virtual Network Computing) é uma tecnologia de área de trabalho remota. Permite visualizar a tela do computador do robô e controlá-lo com o mouse e o teclado pelo navegador.

Como funciona#

Navegador do usuário
    │ WebSocket (porta 6080-6100)
    ▼
orchestrator-vnc-proxy (websockify)
    │ TCP (porta VNC, geralmente 5900)
    ▼
Servidor VNC no computador do robô

O usuário clica no botão → o Orchestrator cria uma conexão proxy via websockify → o navegador se conecta à tela do robô.

Preparação#

1. Cada robô deve ter um servidor VNC#

Instale um servidor VNC no computador do robô.

• A configuração de senha e porta é feita nas configurações do Assistente, na aba "Execução/Servidor VNC"

Campos para preencher no Assistente:

• Porta VNC do Robô
• Senha VNC
• Caixa de seleção "Iniciar servidor VNC ao iniciar o robô"
• Caixa de seleção "Iniciar automaticamente o servidor VNC ao iniciar o robô Unattended"

Certifique-se de que o servidor VNC esteja em execução, sua porta real esteja aberta no firewall do computador do robô e a senha VNC esteja definida.

2. Preencha os dados de VNC na ficha do robô#

No Orchestrator, abra a ficha do robô (edição) e preencha os campos:

Onde obter a senha: A senha é definida durante a instalação do servidor VNC no computador do robô. É uma senha VNC separada, NÃO a senha do usuário do Windows e NÃO a senha da conta no Orchestrator.

A senha VNC deve ter no máximo 128 caracteres e 255 bytes em UTF-8, sem espaços nem outros caracteres de espaço em branco.

Onde obter a impressão digital: Copie-a das configurações VNC do Sherpa RPA executado com a mesma conta do Windows que o ProcessAgent. Confirme-a com o administrador do robô por um canal confiável antes de salvar a ficha. Atualize-a se a chave do servidor VNC mudar.

3. Permissões de acesso dos usuários#

A função do usuário deve ter a permissão VNC (access_vnc) com direitos de Leitura e Atualização:

1. Acesse a seção Funções
2. Selecione a função desejada
3. Localize o campo access_vnc e marque as caixas de Leitura e Atualização
4. Salve

(Se você não tiver direitos para editar funções, entre em contato com o administrador)

Uso do VNC#

Método 1: Conectar-se ao robô a partir da tabela#

1. Acesse a seção Robôs
2. Na linha do robô desejado, clique no ícone do monitor (coluna mais à direita)
3. Uma nova aba será aberta com a tela do robô

Se a ficha do robô contiver endereço, senha e impressão digital confiável da chave do servidor, a conexão começará automaticamente. Se faltar a impressão digital, o formulário será aberto, mas não será possível conectar sem ela. O navegador verifica a chave do servidor antes de enviar as credenciais.

Método 2: Conectar-se manualmente via VNC Viewer#

1. Abra no navegador: https://SEU_ORCHESTRATOR/main/vnc-viewer

2. Preencha o formulário:

   Campo	O que inserir
   VNC Server (host:port)	Endereço IP do robô e porta VNC (ex.: 192.168.1.100:5900)
   Senha	Senha VNC
   Impressão digital SHA-256 da chave do servidor	Valor confiável das configurações VNC do robô: 32 pares hexadecimais separados por dois-pontos
   Login (opcional)	Login, se exigido pelo servidor VNC

Se a impressão digital estiver ausente, inválida ou diferente da chave do servidor, a conexão será interrompida. Não ignore a verificação: confirme o valor correto com o administrador do robô.

Desconexão#

• Clique no botão vermelho "Desconectar" no canto superior esquerdo
• Ou simplesmente feche a aba do navegador

O serviço proxy será interrompido automaticamente e liberará a porta.

Variáveis de ambiente VNC (.env)#

Lista de portas#

Possíveis problemas#