Documentação

Documentação do SenseLinks

Tudo o que precisa para instalar agentes em Windows e Linux, ligá-los ao seu servidor SenseLinks e mantê-los em funcionamento.

Visão geral

O SenseLinks é composto por três partes principais:

  • Agentes: são instalados nas máquinas que quer proteger. Recolhem registos, alterações de ficheiros, inventário de software e dados de configuração, e enviam-nos para o servidor.
  • Servidor (manager): analisa os dados com regras de detecção, gera alertas e executa respostas automáticas.
  • Painel: a interface web onde vê os alertas, investiga eventos, instala novos agentes e acompanha vulnerabilidades e conformidade.

Requisitos

PlataformaVersões suportadasArquitecturas
WindowsWindows 10, 11, Windows Server 2012 R2 e posteriores32 e 64 bits
Linux (DEB)Ubuntu, Debian e derivadasIntel/AMD de 64 bits (x86_64)
Linux (RPM)Red Hat, CentOS, Rocky, AlmaLinux, Fedora, Amazon Linux, SUSEIntel/AMD de 64 bits (x86_64)
macOSAinda não disponível

O agente usa cerca de 35 MB de RAM e muito pouco CPU em funcionamento normal. Precisa de direitos de administrador (Windows) ou de root (Linux) para o instalar.

Portas de rede

Abra estas portas no servidor SenseLinks e em qualquer firewall entre o servidor e os agentes:

PortaProtocoloUtilização
1514TCPLigação do agente (eventos e estado)
1515TCPRegisto do agente
8088TCPTransferência dos pacotes do agente
443TCPPainel (apenas administradores)

Instalar a partir do painel

A forma mais simples de instalar um agente é a partir do painel. Abra Agentes → Implementar novo agente, escolha o sistema operativo e a arquitectura, indique o endereço do servidor e copie o comando gerado. Esse comando executa os mesmos passos que os comandos manuais abaixo.

Nos comandos abaixo, substitua SERVER pelo endereço do seu servidor SenseLinks e VERSION pela versão do agente indicada no painel.

Agente Windows

Abra o PowerShell como Administrador e execute:

Invoke-WebRequest -UseBasicParsing -Uri "http://SERVER:8088/packages/senselinks-agent-VERSION.exe" `
  -OutFile $env:TEMP\senselinks-agent.exe
Start-Process -Wait -FilePath $env:TEMP\senselinks-agent.exe -ArgumentList '/S','/SERVER=SERVER'

O instalador define o endereço do servidor, regista o computador e inicia o agente. Opções: /NAME=nome (o nome mostrado no painel; por omissão, o nome do computador), /GROUP=grupo1,grupo2 e /PASSWORD=x (quando o seu servidor pede uma palavra-passe de registo).

Instalador de um só ficheiro (sem Internet no computador)

O seu servidor também gera um instalador completo com o agente e todas as protecções, já configurado para esse servidor. Transfira senselinks-agent-full-VERSION.exe ou .msi de http://SERVER:8088/packages/installers/, de Implementar novo agente no painel, ou com Get installer for other computers no Manage Agent de um computador Windows. Copie-o para o computador e execute-o como Administrador:

senselinks-agent-full-VERSION.exe /S /SERVER=SERVER
msiexec /i senselinks-agent-full-VERSION.msi /qn SERVER=SERVER

/SERVER= (no MSI SERVER=) só é preciso para mudar o servidor já gravado no instalador. Outras opções: /GROUP=nome e /PASSWORD=x (no MSI: GROUP=, PASSWORD=). Se o servidor não estiver acessível durante a instalação, o agente inscreve-se mais tarde.

Instalar em muitos computadores Windows (Active Directory)

Num domínio Windows, uma política de grupo (GPO) pode instalar o agente em todos os computadores das OUs escolhidas. Cada computador instala, regista e inicia o agente no arranque, e actualiza-o quando o servidor tiver uma versão mais recente. Transfira os três scripts de http://SERVER:8088/packages/ad/ para uma pasta num controlador de domínio (ou numa máquina com as ferramentas de política de grupo) e execute, como administrador do domínio:

# Criar a política e ligá-la a uma OU: os computadores instalam o agente no próximo reinício
.\New-SenseLinksAgentGpo.ps1 -Manager SERVER -TargetOU 'OU=Workstations,DC=corp,DC=local'

# Opcional: instalar já nos computadores que estão ligados (usa WinRM)
.\Invoke-SenseLinksAgentInstall.ps1 -Manager SERVER -SearchBase 'OU=Workstations,DC=corp,DC=local'
  • -Group NOME regista os computadores num grupo de agentes; -GroupFromOU usa o nome da OU de cada computador como grupo. Crie primeiro os grupos no painel.
  • -RegistrationPassword é necessário se o servidor exigir uma palavra-passe de registo.
  • Os computadores precisam das portas 1514, 1515 e 8088 para o servidor. Cada um regista o que fez em C:\Windows\Temp\senselinks-agent-install.log.

O README.md na mesma pasta descreve todas as opções.

Entrar com o Active Directory e encontrar máquinas desprotegidas

No painel, abra Gestão → Active Directory (só administradores):

  • Ligação: os controladores de domínio, uma conta de serviço (basta um utilizador normal do domínio) e a base de pesquisa. Testar a ligação mostra quantos utilizadores, grupos e computadores encontrou.
  • Permissões: escolha que grupos do AD têm acesso total e quais têm só leitura. Os seus membros entram depois com o nome de utilizador e a palavra-passe do AD.
  • Descoberta de máquinas: onde o SenseLinks procura computadores sem agente: a lista de computadores do AD, os registos DNS do domínio, as concessões DHCP, os relatórios de vizinhos dos agentes e, opcionalmente, um varrimento das sub-redes escolhidas.

Gestão → Máquinas desprotegidas lista o que foi encontrado, com a cobertura por sub-rede, e dá o comando de instalação para os computadores seleccionados. As novas máquinas desprotegidas também geram um alerta. Para usar as concessões DHCP, junte os agentes dos seus servidores DHCP Windows ao grupo de agentes senselinks-dhcp.

Detectar ataques ao Active Directory

Instale o agente em cada controlador de domínio e execute isto em cada um, como administrador do domínio (primeiro só mostra o estado; -Apply activa a auditoria em falta):

.\Enable-SenseLinksAdAuditing.ps1
.\Enable-SenseLinksAdAuditing.ps1 -Apply

O SenseLinks passa a alertar sobre Kerberoasting, AS-REP roasting, DCSync, pulverização de palavras-passe, vagas de bloqueios de contas, alterações a grupos de administradores, ao AdminSDHolder e às políticas de grupo. A página inicial mostra os alertas do AD das últimas 24 horas.

Agente Linux

No computador, como root ou com sudo (Debian, Ubuntu, Red Hat, CentOS, Rocky, AlmaLinux, Amazon Linux, SUSE; Intel/AMD de 64 bits):

curl -fsS http://SERVER:8088/packages/linux/senselinks-agent-install.sh | sudo SENSELINKS_SERVER='SERVER' bash

O script escolhe o pacote certo (DEB ou RPM) no seu servidor, instala-o, regista o computador e inicia o agente.

Poucos segundos depois de o agente iniciar, ele aparece como Active no painel.

Agente macOS

Ainda não disponível. O agente SenseLinks para macOS está em preparação. Esta secção terá as instruções de instalação quando for lançado. Se precisa de proteger computadores Mac, contacte-nos.

Gerir o agente

WindowsLinux
IniciarNET START SenseLinksSvcsudo systemctl start senselinks-agent
PararNET STOP SenseLinksSvcsudo systemctl stop senselinks-agent
EstadoGet-Service SenseLinksSvcsystemctl status senselinks-agent
ConfiguraçãoC:\Program Files (x86)\ossec-agent\ossec.conf/var/ossec/etc/ossec.conf
Registo (log)C:\Program Files (x86)\ossec-agent\ossec.log/var/ossec/logs/ossec.log

Para desinstalar: no Windows, remova SenseLinks Agent em Definições → Aplicações. Com a autoprotecção do agente ligada, o Windows recusa: obtenha um Código de desinstalação na página do computador, em Computadores no painel, e execute no PowerShell como Administrador & "C:\Program Files (x86)\ossec-agent\uninstall.exe" /S /TOKEN=CÓDIGO. Em Debian/Ubuntu execute sudo apt-get remove senselinks-agent; em sistemas RPM execute sudo rpm -e senselinks-agent.

Resolução de problemas

O agente não aparece no painel

  • Verifique se a máquina consegue chegar ao servidor nas portas 1514 e 1515 (Windows: Test-NetConnection SERVER -Port 1514; Linux: nc -zv SERVER 1514).
  • Verifique o endereço do servidor que indicou: executar de novo o comando de instalação com o endereço certo corrige-o.
  • Consulte o registo do agente (ver a tabela acima).

O agente aparece como «Disconnected»

Confirme que o serviço do agente está em execução e que nenhuma firewall bloqueia a porta 1514 entre o agente e o servidor. Depois, reinicie o agente.