# Trasferimento log universale

## Guida Netacea Universal Offline POV

Per inviare i dati di log a Netacea per l'analisi quando lo streaming in tempo reale o le integrazioni di piattaforma non sono praticabili, è possibile utilizzare l'**AWS Command Line Interface (CLI)** per completare un caricamento una tantum su un bucket Amazon S3 sicuro, ospitato da Netacea. Di seguito sono riportati i passaggi documentati necessari per installare e utilizzare AWS CLI per eseguire un trasferimento sicuro.

### Prerequisiti

Per completare con successo un trasferimento di log offline a Netacea, assicurarsi di soddisfare i seguenti requisiti:

* L'**AWS CLI** è installata e confermata funzionante sulla propria macchina.
* Sono stati ricevuti i dettagli necessari del bucket S3 (nome del bucket e ARN) da Netacea. Questi sono disponibili [qui](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* È stato creato un **file di test** che può essere utilizzato per validare la connessione prima di trasferire i dati effettivi.
* Si sta utilizzando una macchina che:
  * Consente l'**accesso da riga di comando**
  * Dispone dell'**autorizzazione per installare ed eseguire strumenti CLI**
  * Ha **accesso ai file di log** destinati al caricamento

{% hint style="info" %}
Non è necessario predisporre alcuna infrastruttura del bucket S3 o le credenziali associate, poiché queste verranno fornite.
{% endhint %}

#### Passaggio 1: Installare AWS CLI

Scaricare AWS CLI dalla fonte ufficiale in base al proprio sistema operativo:

* **Windows (64-bit)**
* **macOS (PKG Installer)**
* **Linux (Installer)**
* **Amazon Linux (AMI)**

👉 [Link per il download di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)

Dopo il download, eseguire il programma di installazione e seguire le istruzioni visualizzate sullo schermo.

Per confermare l'avvenuta installazione, eseguire il seguente comando nel terminale o nel prompt dei comandi:

```
aws --version
```

#### **Passaggio 2: Configurare AWS CLI**

Utilizzare le credenziali fornite per configurare l'ambiente:

```
aws configure
```

Verrà quindi richiesto di inserire alcuni dettagli aggiuntivi. La tabella seguente illustra quali informazioni devono essere fornite e dove reperirle:

<table><thead><tr><th width="245">Nome</th><th>Valore</th></tr></thead><tbody><tr><td>AWS_ACCESS_KEY_ID</td><td>Ottenuto dal <a href="https://portal.netacea.com/">portale admin di Netacea</a></td></tr><tr><td>AWS_SECRET_ACCESS_KEY</td><td>Ottenuto dal <a href="https://portal.netacea.com/">portale admin di Netacea</a></td></tr><tr><td>AWS_DEFAULT_REGION</td><td>eu-west-1</td></tr></tbody></table>

#### **Passaggio 3: Testare l'accesso con un file di esempio**

Assicurarsi di aver creato un piccolo file di test (può essere vuoto) per verificare l'accesso:

```
aws s3 cp localtestfile.txt s3://name-of-bucket 
```

* Sostituire `/full/path/to/testfile.txt` con il percorso effettivo del file di test
* Sostituire `<bucket-name>` con il nome del bucket S3 fornito da Netacea

Una volta caricato, contattare il **team Netacea Solutions Engineering** per confermare che il file sia stato ricevuto correttamente.

#### **Passaggio 4: Caricare i dati di log**

Dopo la conferma da parte di Netacea, è possibile procedere con il caricamento del file di log completo utilizzando lo stesso comando:

```
aws s3 cp localtestfile.txt s3://name-of-bucket 
```

Assicurarsi di:

* Sostituire `/full/path/to/logfile.log` con il percorso effettivo del file di log
* Utilizzare lo stesso nome del bucket fornito
* Verificare che il caricamento venga completato senza errori.

### Dataset minimo Netacea

Per eseguire con successo una Proof of Value (PoV), i file di log caricati devono includere i seguenti campi:

<table><thead><tr><th width="215">Campi obbligatori</th><th>Descrizione</th></tr></thead><tbody><tr><td>Timestamp</td><td>Il momento in cui è stata ricevuta la richiesta</td></tr><tr><td>IP Address</td><td>L'indirizzo IP da cui è stata effettuata la richiesta</td></tr><tr><td>User Agent</td><td>La stringa user agent inviata nell'header dal client</td></tr><tr><td>Method</td><td>Il metodo HTTP della richiesta</td></tr><tr><td>Path</td><td>Il percorso della risorsa richiesta</td></tr><tr><td>Query</td><td>La stringa di query della richiesta</td></tr><tr><td>Status</td><td>Il codice di stato HTTP restituito dal server</td></tr><tr><td>Referrer</td><td>La pagina web da cui l'utente ha seguito un link</td></tr><tr><td>Bytes Sent</td><td>I byte inviati come parte della risposta del server</td></tr><tr><td>Client JA3</td><td>Fingerprint JA3 del client (se disponibile)</td></tr><tr><td>X-Forwarded-For*</td><td>Indirizzo IP di connessione [array] di una richiesta client, se proxied</td></tr><tr><td>True Client IP*</td><td>La fonte attendibile dell'IP originale del client</td></tr><tr><td>Host</td><td>L'host di destinazione della richiesta</td></tr><tr><td>Protocol</td><td>Il protocollo della richiesta</td></tr><tr><td>Request Time</td><td>Il tempo totale impiegato per elaborare la richiesta</td></tr></tbody></table>

\* Utile quando sono presenti proxy nel percorso del traffico dal client all'origin.

### Passaggi finali

Una volta attiva la consegna dei log, **notificare il proprio Netacea Solutions Engineer**. Questo ci consente di:

* Confermare la ricezione dei dati
* Validare il formato e la completezza del dataset
* Avviare l'analisi una volta raccolta una quantità sufficiente di dati

In caso di necessità di supporto durante la configurazione, il team Netacea SE è a disposizione — non esitate a contattarci.