# Universele Log Overdracht

## Netacea Universele Offline POV-handleiding

Om loggegevens naar Netacea te verzenden voor analyse wanneer real-time streaming of platformintegraties niet haalbaar zijn, kunt u de **AWS Command Line Interface (CLI)** gebruiken om een eenmalige upload te voltooien naar een beveiligde, door Netacea gehoste Amazon S3-bucket. Hieronder vindt u de gedocumenteerde stappen die nodig zijn om de AWS CLI te installeren en te gebruiken voor een beveiligde overdracht.

### Vereisten

Om een offline logoverdracht naar Netacea succesvol te voltooien, dient u het volgende te waarborgen:

* De **AWS CLI** is geïnstalleerd en werkt aantoonbaar op uw machine.
* U hebt de benodigde S3-bucketgegevens (bucketnaam en ARN) van Netacea ontvangen. Deze zijn te vinden [hier](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* U hebt een **testbestand** aangemaakt dat kan worden gebruikt om de verbinding te valideren voordat daadwerkelijke gegevens worden overgedragen.
* U maakt gebruik van een machine die:
  * **Command-line toegang** toestaat
  * **Toestemming heeft om CLI-tools te installeren en uit te voeren**
  * **Toegang heeft tot de logbestand(en)** die bedoeld zijn voor upload

{% hint style="info" %}
U hoeft geen S3-bucketinfrastructuur of bijbehorende inloggegevens aan te maken, aangezien deze aan u worden verstrekt.
{% endhint %}

#### Stap 1: Installeer de AWS CLI

Download de AWS CLI van de officiële bron op basis van uw besturingssysteem:

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

👉 [AWS CLI downloadlink](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)

Na het downloaden voert u het installatieprogramma uit en volgt u de instructies op het scherm.

Om te bevestigen dat de installatie succesvol is, voert u het volgende commando uit in uw terminal of opdrachtprompt:

```
aws --version
```

#### **Stap 2: Configureer de AWS CLI**

Gebruik de verstrekte inloggegevens om uw omgeving in te stellen:

```
aws configure
```

Vervolgens wordt u gevraagd om enkele aanvullende gegevens in te voeren. De onderstaande tabel legt uit welke informatie moet worden verstrekt en waar deze te vinden is:

<table><thead><tr><th width="245">Naam</th><th>Waarde</th></tr></thead><tbody><tr><td>AWS_ACCESS_KEY_ID</td><td>Verkrijgbaar via het Netacea <a href="https://portal.netacea.com/">beheerportaal</a></td></tr><tr><td>AWS_SECRET_ACCESS_KEY</td><td>Verkrijgbaar via het Netacea <a href="https://portal.netacea.com/">beheerportaal</a></td></tr><tr><td>AWS_DEFAULT_REGION</td><td>eu-west-1</td></tr></tbody></table>

#### **Stap 3: Test toegang met een voorbeeldbestand**

Zorg ervoor dat u een klein testbestand hebt aangemaakt (dit kan leeg zijn) om de toegang te verifiëren:

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

* Vervang `/full/path/to/testfile.txt` door het daadwerkelijke pad naar uw testbestand
* Vervang `<bucket-name>` door de S3-bucketnaam die door Netacea is verstrekt

Neem na het uploaden contact op met het **Netacea Solutions Engineering-team** om te bevestigen dat het bestand succesvol is ontvangen.

#### **Stap 4: Upload de loggegevens**

Na bevestiging van Netacea kunt u doorgaan met het uploaden van uw volledige logbestand met hetzelfde commando:

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

Zorg ervoor dat u:

* `/full/path/to/logfile.log` vervangt door het daadwerkelijke pad naar uw logbestand
* Dezelfde bucketnaam gebruikt als verstrekt
* Ervoor zorgt dat de upload zonder fouten wordt voltooid.

### Netacea Minimale Dataset

Om een succesvolle Proof of Value (PoV) uit te voeren, moeten de logbestand(en) die u uploadt de volgende velden bevatten:

<table><thead><tr><th width="215">Vereiste velden</th><th>Beschrijving</th></tr></thead><tbody><tr><td>Timestamp</td><td>Het tijdstip waarop het verzoek is ontvangen</td></tr><tr><td>IP-adres</td><td>Het IP-adres van waaruit het verzoek is gedaan</td></tr><tr><td>User Agent</td><td>De user agent-string die door de client in de header is verzonden</td></tr><tr><td>Methode</td><td>De HTTP-methode van het verzoek</td></tr><tr><td>Pad</td><td>Het pad van de opgevraagde resource</td></tr><tr><td>Query</td><td>De querystring van het verzoek</td></tr><tr><td>Status</td><td>De HTTP-statuscode die door de server is geretourneerd</td></tr><tr><td>Referrer</td><td>De webpagina waarvan de gebruiker een link heeft gevolgd</td></tr><tr><td>Verzonden bytes</td><td>De bytes die als onderdeel van de serverrespons zijn verzonden</td></tr><tr><td>Client JA3</td><td>JA3-vingerafdruk van de client (indien beschikbaar)</td></tr><tr><td>X-Forwarded-For*</td><td>Verbindend IP-adres [array] van een clientverzoek, indien geproxied</td></tr><tr><td>True Client IP*</td><td>De betrouwbare bron van het oorspronkelijke client-IP</td></tr><tr><td>Host</td><td>De bestemmingshost van het verzoek</td></tr><tr><td>Protocol</td><td>Het protocol van het verzoek</td></tr><tr><td>Verwerkingstijd</td><td>De totale tijd die nodig was om het verzoek te verwerken</td></tr></tbody></table>

\* Nuttig wanneer proxy's zich in de verkeerslijn van client > origin bevinden.

### Laatste stappen

Zodra de loglevering actief is, **stelt u uw Netacea Solutions Engineer op de hoogte**. Dit stelt ons in staat om:

* De ontvangst van gegevens te bevestigen
* Het datasetformaat en de volledigheid te valideren
* Te beginnen met de analyse zodra voldoende gegevensvolume is verzameld

Als u ondersteuning nodig hebt tijdens de installatie, staat het Netacea SE-team klaar om te helpen — aarzel niet om contact op te nemen.