Documentação — ShieldLinks

Visão geral

O ShieldLinks é 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

Plataforma	Versões suportadas	Arquitecturas
Windows	Windows 10, 11, Windows Server 2012 R2 e posteriores	32 e 64 bits
Linux (DEB)	Ubuntu, Debian e derivadas	x86_64, ARM64
Linux (RPM)	Red Hat, CentOS, Rocky, AlmaLinux, Fedora, Amazon Linux, SUSE	x86_64, ARM64
macOS	Versões recentes do macOS	Intel, Apple silicon

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, macOS) para o instalar.

Portas de rede

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

Porta	Protocolo	Utilização
1514	TCP	Ligação do agente (eventos e estado)
1515	TCP	Registo do agente
8088	TCP	Transferência dos pacotes do agente
443	TCP	Painel (apenas administradores)

Instalar a partir do painel

A forma mais simples de instalar um agente é a partir do painel. Abra Agents → Deploy new agent, 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 ShieldLinks e VERSION pela versão do agente indicada no painel.

Agente Windows

Abra o PowerShell como Administrador e execute:

$SERVER = "SERVER"
$dir    = "${env:ProgramFiles(x86)}\ossec-agent"

# 1. Transferir e instalar em modo silencioso
Invoke-WebRequest -UseBasicParsing -Uri "http://${SERVER}:8088/packages/shieldlinks-agent-VERSION.exe" `
  -OutFile $env:tmp\shieldlinks-agent.exe
Start-Process -Wait -FilePath $env:tmp\shieldlinks-agent.exe -ArgumentList '/S'

# 2. Indicar o servidor ao agente
(Get-Content "$dir\ossec.conf") -replace '<address>.*</address>', "<address>$SERVER</address>" |
  Set-Content "$dir\ossec.conf"

# 3. Registar o agente e iniciá-lo
& "$dir\agent-auth.exe" -m $SERVER
NET START ShieldLinksSvc

Agente Linux

Ubuntu, Debian (DEB)

curl -so shieldlinks-agent.deb http://SERVER:8088/packages/wazuh-agent_VERSION-1_amd64.deb
sudo WAZUH_MANAGER='SERVER' dpkg -i ./shieldlinks-agent.deb
sudo systemctl daemon-reload
sudo systemctl enable --now wazuh-agent

Em máquinas ARM64, use wazuh-agent_VERSION-1_arm64.deb.

Red Hat, CentOS, Rocky, AlmaLinux, Amazon Linux, SUSE (RPM)

curl -so shieldlinks-agent.rpm http://SERVER:8088/packages/wazuh-agent-VERSION-1.x86_64.rpm
sudo WAZUH_MANAGER='SERVER' rpm -ihv ./shieldlinks-agent.rpm
sudo systemctl daemon-reload
sudo systemctl enable --now wazuh-agent

Em máquinas ARM64, use wazuh-agent-VERSION-1.aarch64.rpm.

Agente macOS

Abra o Terminal e execute:

curl -so shieldlinks-agent.pkg http://SERVER:8088/packages/wazuh-agent-VERSION-1.intel64.pkg
echo "WAZUH_MANAGER='SERVER'" > /tmp/wazuh_envs
sudo installer -pkg ./shieldlinks-agent.pkg -target /
sudo /Library/Ossec/bin/wazuh-control start

Em Mac com Apple silicon (M1 e posteriores), use wazuh-agent-VERSION-1.arm64.pkg.

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

Gerir o agente

	Windows	Linux	macOS
Iniciar	`NET START ShieldLinksSvc`	`sudo systemctl start wazuh-agent`	`sudo /Library/Ossec/bin/wazuh-control start`
Parar	`NET STOP ShieldLinksSvc`	`sudo systemctl stop wazuh-agent`	`sudo /Library/Ossec/bin/wazuh-control stop`
Estado	`Get-Service ShieldLinksSvc`	`systemctl status wazuh-agent`	`sudo /Library/Ossec/bin/wazuh-control status`
Configuração	`C:\Program Files (x86)\ossec-agent\ossec.conf`	`/var/ossec/etc/ossec.conf`	`/Library/Ossec/etc/ossec.conf`
Registo (log)	`C:\Program Files (x86)\ossec-agent\ossec.log`	`/var/ossec/logs/ossec.log`	`/Library/Ossec/logs/ossec.log`

Para desinstalar: no Windows, remova ShieldLinks Agent em Definições → Aplicações; em Debian/Ubuntu execute sudo apt-get remove wazuh-agent; em sistemas RPM execute sudo rpm -e wazuh-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/macOS: nc -zv SERVER 1514).
Verifique se o <address> no ossec.conf é o endereço do seu servidor.
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.

Documentação do ShieldLinks