Documentazione.

01 · PANORAMICA

Un solo controllo, protezione vicina ai sistemi

Sentinel coordina rilevamento, policy e report da un pannello centrale, mentre l’applicazione delle difese resta sul server o dentro WordPress. Il controllo operativo rimane così visibile e il pannello non diventa l’unico confine di sicurezza.

02 · PER INIZIARE

Da un record vuoto a un server collegato

1. 1

   Crea il server

   Apri Server → Aggiungi server nel pannello e usa un nome stabile e riconoscibile.

2. 2

   Copia il comando generato

   Usa il comando prodotto per quel record. La relativa API key non deve essere riutilizzata su altre macchine.

3. 3

   Eseguilo con privilegi amministrativi

   Avvialo sul server destinatario, quindi verifica che il servizio parta e completi il controllo di connessione.

4. 4

   Conferma l’inventario

   Hostname, indirizzi, versione installata e ultimo heartbeat nel pannello devono corrispondere al server modificato.

03 · PREPARAZIONE

Requisiti e controlli preliminari

04 · AGENT LINUX

Installare Sentinel Agent

Preferisci il comando mostrato dal pannello: contiene già la credenziale dedicata e l’endpoint corrente. L’esempio seguente utilizza esclusivamente segnaposto.

curl -fsSL https://sentinel.gtechgroup.it/apt/install-agent.sh | \
  sudo bash -s -- \
  --api-key "<API_KEY_GENERATA_DAL_PANNELLO>" \
  --server sentinel.gtechgroup.it:9090 \
  --yes

05 · CONFIGURAZIONE

Configurazione, segreti e allowlist

Il file principale è /etc/sentinel/agent.yaml. Creane una copia prima di modificarlo, conserva l’indentazione YAML e non incollare mai la sua API key in ticket o log pubblici.

agent:
  server_url: "sentinel.gtechgroup.it:9090"
  api_key: "<API_KEY_GENERATA_DAL_PANNELLO>"

tls:
  enabled: true
  skip_verify: false

blocker:
  backend: "auto"
  chain: "SENTINEL"
  whitelist_entries:
    - "<IP_O_RETE_AMMINISTRATIVA>"

Dopo ogni variazione esegui sudo sentinel-agent --check prima di riavviare il servizio.

06 · APPLICAZIONE LOCALE

Interoperabilità con firewall e Fail2Ban

Sentinel conserva una catena e un insieme di blocco propri, così ogni decisione rimane riconoscibile. L’integrazione può leggere i ban Fail2Ban supportati e condividere gli indicatori Sentinel verso Fail2Ban, senza permettere a Fail2Ban di sovrascrivere la fonte dati di Sentinel.

07 · VERSIONI

Aggiornare senza perdere la configurazione locale

Il pannello può richiedere l’aggiornamento agli agent collegati che supportano i job remoti. Se il job non può essere eseguito, usa la procedura manuale direttamente sul server.

sudo apt-get update
sudo apt-get install --only-upgrade sentinel-agent \
  -o Dpkg::Options::=--force-confold
sudo systemctl restart sentinel-agent
sudo sentinel-agent --check

Dopo ogni aggiornamento controlla versione installata, servizio attivo, nuovo heartbeat e ultimi messaggi del journal.

08 · WEB APPLICATION FIREWALL

Passare da Observe a Block in modo controllato

Il WAF protegge soltanto il traffico instradato attraverso il suo listener. Abilitare un modulo non modifica automaticamente l’upstream di Nginx, Apache o del pannello hosting.

09 · WORDPRESS

Collegare e proteggere un sito WordPress

1. 1

   Registra l’URL pubblico esatto

   Protocollo, sottodominio e un’eventuale sottocartella fanno parte dell’identità del sito.

2. 2

   Genera il token monouso

   Usalo soltanto per il sito corrispondente e non inserirlo negli screenshot.

3. 3

   Installa il pacchetto del pannello

   Carica lo ZIP in WordPress, attiva Sentinel Security e completa il collegamento.

4. 4

   Controlla i valori predefiniti

   Parti in Observe, analizza dashboard ed eventi, quindi aumenta la protezione modulo per modulo.

WAF, Login Shield, antispam, scanner malware, integrità e quarantena reversibile coprono rischi differenti. Il plugin affianca aggiornamenti, backup e hardening del server: non li sostituisce.

10 · RISOLUZIONE PROBLEMI

Una sequenza diagnostica ripetibile

11 · OPERAZIONI SICURE

Condividi le prove, mai le credenziali

Una richiesta utile include hostname, distribuzione, versione di agent o plugin, orario con fuso, azione eseguita e righe di log pertinenti. Rimuovi API key, token di collegamento, cookie, dati personali e indirizzi non necessari prima dell’invio.