Skip to main content

Guida all'installazione di BriefCam

Distribuzione di un server di registro grigio

Ultimo aggiornamento: 6 min di lettura
Versione2024r2
LinguaItaliano

Per le implementazioni su larga scala, BriefCamconsiglia di utilizzare la piattaforma di gestione dei registri Graylog per raccogliere i vari registri in un'unica posizione e aiutare a eseguire il debug del sistema.

Per distribuire un server Graylog è necessario un server Linux dedicato.

Quando si eseguono tutti i passaggi seguenti, verranno installati i seguenti componenti interni necessari per l'esecuzione di Graylog:

  • MongoDB – Un'istanza di database separata per questo scopo.

  • ElasticSearch – Questo è uno strato intermedio attraverso il quale il database e il Graylog comunicano.

  • Registro grigio

Inoltre, come parte dell'installazione, un agente viene distribuito su ciascuno dei BriefCamserver. L'agente sarà responsabile dell'invio dei registri al server Graylog.

Graylog histogram.png

Prerequisiti

  • BriefCam già implementato nel sito.

  • Il server Linux deve essere raggiungibile da tutti i BriefCamcomputer tramite HTTP/TCP.

Requisiti della piattaforma

Il server Linux deve essere ubuntu 18.04.* LTS con le seguenti specifiche:

  • 1 x i7-10700K CPU

  • RAM da 64 GB

  • SSD 256GB

Altri requisiti

  • Tutte le operazioni devono essere eseguite da un utente con autorizzazioni sudo.

Installazione di Graylog sul server Linux

L'installazione di Graylog sul server Linux prevede i seguenti passaggi:

  1. Verificare che SSH sia installato e abilitato

  2. Installa Docker Runtime

  3. Copia i file di installazione

  4. Configurare e attivare il motore del server Graylog

  5. Configurare i raccoglitori Graylog

  6. Configurare i server BriefCam per l'invio dei registri al server di registro grigio

Fase 1: Verificare che SSH sia installato e abilitato

  1. Accedere al server Linux.

  2. Aprire una finestra del terminale.

  3. Emettere i seguenti comandi:

    sudo apt update sudo apt install openssh-server 

  4. Verificare che il daemon ssh (servizio) sia attivo e funzionante:

    sudo systemctl status ssh 

  5. Dovresti vedere un testo simile al seguente: Active: active (running) :

  6. Digitare qper tornare alla console.

  7. Consenti ssh nel firewall:

    sudo ufw allow ssh

  8. Termina la sessione della shell:

    sudo ufw allow ssh

Fase 2: Installazione del runtime Docker

Per installare Docker Runtime:

  1. Apertura della sessione SSH alla macchina server:

    ssh jjcale@tulsa-sound or jjcale@{Server IP address}

  2. Immettere la password per connettersi alla sessione SSH.

  3. Aggiornare il gestore pacchetti apt:

    sudo apt-get update

  4. Installare le dipendenze generali del docker:

    sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

  5. Installare una chiave PGP runtime docker:

    curl -fsSLhttps://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –

  6. Aggiunta di un repository di runtime docker:

    sudo add-apt-repository \ "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

  7. Installare il tempo di esecuzione dell'alloggiamento di espansione stesso e le dipendenze dirette:

    sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io

  8. Testare l'installazione dell'alloggiamento di espansione. Questo dovrebbe produrre un breve messaggio di saluto alla console senza errori:

    sudo docker run hello-world

L'output sarà simile al seguente:

Unable to find image 'hello-world:latest' locally latest: Pulling from library/hello-world 0e03bdcc26d7: Pull complete Digest: sha256:e7c70bb24b462baa86c102610182e3efcb12a04854e8c582838d92970a09f323 Status: Downloaded newer image for hello-world:latestHello from Docker! This message shows that your installation appears to be working correctly.

  1. Aggiungere l'utente 'docker' al gruppo dell'utente con cui è stato effettuato l'accesso:

    sudo usermod -aG docker jjcale

  2. Assicurati di disconnetterti o di uscire dalla sessione corrente affinché il usermodcomando abbia effetto.

  3. Installare il runtime di composizione docker:

    sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname-m)" -o /usr/local/bin/docker-compose

  4. Concedere autorizzazioni per l'esecuzione della composizione docker:

    sudo chmod +x /usr/local/bin/docker-compose

Fase 3: Copia ed estrai i file di installazione

  1. Copiare i file dalla macchina che ospita il file di installazione (di solito una macchina Windows) al server Linux.

  2. Usa opensshper Windows o winscp: https://winscp.net/download/WinSCP-5.17.9-Setup.exe

  3. Riproduci: scp path\to\package\server.zip jjcale@192.168.0.3:/home/jjcale/

  4. ssh al computer server ed estrarre i file del pacchetto:

    cd ~

    unzip server.zip

    cd server

Fase 4: Configurazione e attivazione del motore del server di registro grigio

  1. Aprire il docker-compose-graylog.ymlfile con un editor di testo e impostare:

    GRAYLOG_HTTP_EXTERNAL_URI=server_ip

  2. Lasciare la porta così com'è. Ad esempio:

    GRAYLOG_HTTP_EXTERNAL_URI=http ://{Server IP address}:9000/

  3. Creare una directory per i file di registro grigio:

    sudo mkdir-p /opt/briefcam/graylog

  4. Copiare il file di composizione del registro grigio nella directory appena creata:

    sudo cp docker-compose-graylog.yml /opt/briefcam/graylog/

  5. Creare un servizio Graylog copiando graylog-docker.servicein :/etc/systemd/system

    sudo cp graylog-docker.service /etc/systemd/system/

  6. Abilita il nuovo servizio per quando la macchina viene riavviata:

    sudo systemctl daemon-reload sudo systemctl enable graylog-docker

  7. Avviare il servizio Graylog:

    sudo systemctl start graylog-docker

Nota

Il primo avvio potrebbe richiedere un paio di minuti poiché il traino e l’avvio di nuovi contenitori docker richiede un po’ di tempo.

Fase 5: Configurazione degli agenti di raccolta dei registri grigi

  1. Accedere all'interfaccia web di Graylog.

  2. Aprire un browser e passare al seguente indirizzo: .http://{Server IP address}:9000

  3. Le credenziali sono:

    Utente :admin

    Password :admin

  4. Vai a sistema/input .

  5. Crea input TCP GELF:

    1. Selezionare la casella di controllo Globale .

    2. Aggiungere un titolo, ad esempio: "Win TCP".

    3. Impostare la porta su 12201(impostazione predefinita).

  6. Crea input UDP GELF:

    1. Selezionare la casella di controllo Globale .

    2. Aggiungere un titolo, ad esempio: "UDP Win".

    3. Impostare la porta su 12201(impostazione predefinita).

  7. Andare al sistema/sidecar .

  8. Creare un token API.

    1. Fare clic su Crea o riutilizza un token per l' graylog-sidecarutente.

    2. Aggiungere un nome di token, ad esempio: "Token Win".

    3. Fare clic su Crea token .

  9. Salvare il token o copiarlo negli Appunti.

Fase 6: Configurazione dei server BriefCam per l’invio dei registri al server di registro grigio

I seguenti passaggi devono essere eseguiti su ogni server BriefCam.

Fase a: Copiare i file del pacchetto di installazione

  • Accedere al computer in remoto (RDP) e copiare i seguenti file dai collegamenti di installazione a ciascuno dei server BriefCam:

    graylog_sidecar_installer_1.0.2-1.exe

    nxlog-ce-2.10.2150.msi

    windows_exporter-0.14.0-amd64.msi

Fase b: Installazione di Logs Collector

  1. Installare l'agente di raccolta nxlog eseguendo quanto segue in PowerShell con autorizzazioni amministrative elevate:

    ..\nxlog-ce-2.10.2150.msi/qn

  2. Il primo passaggio consente di creare servizi sulla macchina. In questo passaggio, è necessario disattivare i servizi di sistema (Graylog richiede solo i file binari) eseguendo quanto segue in PowerShell:

    cd 'C:\Program Files (x86)\nxlog\'.\nxlog.exe-u

  3. Installare il sidecar Graylog come servizio con l'IP del server Graylog e il token API salvato eseguendo quanto segue in PowerShell:

    .\graylog_sidecar_installer_1.0.0-1.exe/S-SERVERURL="http://{Server IP address }:9000/api"-APITOKEN="<api-token>"

Fase c: Configurazione del sidecar

  1. Modificare il C:\Program Files\Graylog\sidecar\sidecar.ymlfile e rimuovere i commenti alle seguenti voci:

    • cache_path

    • log_path

    • collector_configuration_directory

    • collector_binaries_whitelist e l' iscrizione che accompagna"C:\\Program Files (x86)\\nxlog\\nxlog.exe"

  2. Salvare il file.

  3. Registrare il sidecar come servizio e avviarlo emettendo i seguenti comandi dalla C:\Program Files\Graylog\sidecardirectory:

    C:\Program Files\Graylog\sidecar> .\graylog-sidecar.exe -service install

    C:\Program Files\Graylog\sidecar> .\graylog-sidecar.exe -service start

Fase d: Creazione della configurazione del registro grigio

  1. Aprire l'interfaccia utente di Graylog e navigare fino alle sidecar/di sistema .

  2. Individuare la macchina connessa e fare clic su Gestisci sidecar .

  3. Selezionare la casella di controllo nxlog .

  4. Fare clic su Configurazione .

  5. In Raccoglitori registri , fare clic su Modifica nella versione di Windows nxlog.

  6. Assegnare un nome, ad esempio "win-nxlog".

  7. Nella default templatesezione, eseguire l'aggiornamento File entrynella <Input file>sezione alla directory di registro desiderata.

  8. Nella <Output gelf>sezione, impostare Host IPl'indirizzo del computer connesso corretto (indirizzo IP del server)

  9. Fare clic su Aggiorna .