Guia de início
Siga os passos para ativar WorksLink Access e alcançar seu primeiro serviço remoto com suas próprias ferramentas.
Antes de começar
| Função | Onde instalar | O que faz |
|---|---|---|
| Gateway de acesso | No servidor, PC industrial, dispositivo de borda ou computador de destino | Expõe serviços permitidos da máquina ou da mesma LAN |
| Cliente de acesso | No computador do técnico ou bastion de operações | Mapeia serviços a portas locais ou abre sessões SSH, SFTP ou de área de trabalho remota |
As duas pontas precisam apenas de saída para o WorksLink, sem IP público nem redirecionamento de portas. Se houver restrições, use Test connection no instalador do gateway Windows ou workslink doctor nas outras plataformas.
O relógio deve ter diferença inferior a 2 minutos; caso contrário, a proteção contra repetição rejeita a conexão.
Primeira conexão
- 1
Ativar
Um administrador abre Secure Remote Access no console WorksLink e ativa o serviço. A conta e as permissões atuais continuam válidas.
- 2
Adicionar gateway
Gere um token de gateway. No Linux, execute o comando do console; no Windows, informe endereço e token no instalador. O dispositivo aparecerá em Gateways.
- 3
Expor serviços
Inclua SSH, área de trabalho remota ou portas de banco na lista permitida. O destino pode ser o gateway ou outro dispositivo da LAN. Outras portas ficam inacessíveis.
- 4
Adicionar clientes
Gere tokens para os colaboradores. Cada um instala o cliente e informa endereço e token; o computador aparecerá em Connectors.
- 5
Criar regras
Defina por etiquetas quais clientes alcançam quais gateways e serviços. Verifique a prévia e salve para aplicar.
- 6
Conectar e revisar
Use workslink ssh, mapeamento de portas ou suas ferramentas. Administradores consultam sessões e eventos em Activity.
Instalar gateway
Windows
- Execute workslink-access-gateway-setup.exe e informe endereço e token do console. Test connection verifica a saída de rede.
- Inclui OpenSSH Server offline e fecha a entrada da porta 22. Use /NOSSH para não instalá-lo.
- Serviço ativo antes do login. Ícone verde: conectado; amarelo: não registrado ou desconectado; cinza: serviço parado.
- Para implantação em lote, instalação silenciosa:
Linux
- Após gerar o token, execute o comando do console. O script detecta arquitetura, verifica pacote, cria usuário workslink sem privilégios e registra o serviço systemd.
- x86_64 e ARM64; compilação estática independente das bibliotecas do sistema.
Para outros equipamentos da LAN, informe o endereço de destino, como 192.168.1.100:3306. Eles dispensam instalação, mas devem ser alcançáveis pelo gateway e estar permitidos.
Gateways instalados sem token podem ser ativados localmente em http://127.0.0.1:8586/ui/setup, sem reiniciar o serviço.
Instalar cliente
Windows
- Execute workslink-access-client-setup.exe. Por padrão fica na bandeja; abra 127.0.0.1:8585 no navegador local para gerenciar portas.
- Para manter túneis sem login, escolha o modo de serviço Windows ou use /SERVICE na instalação silenciosa.
- O atalho workslink no menu Iniciar abre um terminal pronto para comandos.
macOS
- Escolha o .pkg Apple Silicon ou Intel. Após instalar, abra o console pelo ícone da barra de menus.
- A ferramenta fica em /Applications/workslink.app/Contents/MacOS/workslink.
Linux
- workslink-conn abre túneis sob demanda e encerra ao terminar. Para mapeamentos persistentes, use o modelo systemd criado pelo instalador.
- O compartilhamento em equipe (workslink ui --mode=cloud) escuta em portas HTTPS e de encaminhamento. Em um bastion, planeje origens permitidas e certificados antes de ativar.
Formas de conexão
A interface gráfica abre em 127.0.0.1:8585 no navegador local. Comandos comuns:
| workslink list | Listar gateways autorizados, status e serviços |
| workslink connect <device-id> <service> | Mapear serviço remoto a uma porta local reutilizável |
| workslink ssh <device-id> | Abrir SSH diretamente; sftp e rdp seguem o mesmo padrão |
| workslink rdp <device-id> | Abrir o cliente de área de trabalho remota para Windows |
| workslink proxy <device-id> ssh | Usar SSH ProxyCommand sem porta de escuta local |
| workslink exec <device-id> --timeout 2m -- <command> | Executar comando remoto com saída contínua e código de retorno |
Para VS Code Remote-SSH e outras ferramentas SSH:
Perguntas frequentes
Preciso instalar em todos os dispositivos?
Não. O gateway expõe serviços próprios ou de outros dispositivos da LAN, desde que sejam alcançáveis e estejam na lista permitida.
Toda a rede fica aberta?
Não. O cliente alcança apenas serviços permitidos e autorizados por uma regra. Todo o resto é negado, sem abrir a sub-rede.
Preciso de IP público ou redirecionamento de portas?
Não. Gateway e cliente fazem conexões de saída; os serviços dispensam IP público e redirecionamento de portas.
Qual a diferença para área de trabalho remota?
Remote Desktop permite ver telas e operar programas; WorksLink Access acessa servidores, bancos e sistemas internos ou executa comandos. Ambos usam o mesmo console.
Qual a velocidade e o que ocorre sem conexão direta?
Quando possível, a conexão é entre pares; caso contrário, retransmite automaticamente com criptografia. A velocidade depende das redes, rota e políticas de saída. Use workslink doctor para diagnosticar.
Quando a revogação entra em vigor?
Novas solicitações seguem a política imediatamente. Dispositivos online recebem a mudança em segundos e fecham conexões; sem o aviso ou offline, sincronizam na próxima consulta, em cerca de dois minutos.
Acessos e comandos são registrados?
O console registra inscrições, autorizações, recusas, mudanças de tokens e regras e desconexões. Detalhes de comandos ficam na console local do gateway; não é gravação completa de sessões.
Abre portas no meu computador?
Mapeamentos escutam apenas em 127.0.0.1; SSH ProxyCommand não abre porta local. O modo de equipe Linux escuta em HTTPS e portas de encaminhamento, exigindo planejamento separado.
Diagnóstico
workslink doctor verifica estes nove itens e propõe soluções:
- Permissões do diretório de configuração
- Integridade do par de chaves local
- Configuração e função do console
- Acesso HTTPS ao console
- Diferença de relógio inferior a 2 minutos
- Autenticação de assinatura
- Sintaxe da lista permitida
- Teste de conexão direta
- Obtenção da lista de dispositivos autorizados
Ainda precisa de ajuda?