# Transfert universel de journaux

## Guide Netacea Universal Offline POV

Pour envoyer des données de logs à Netacea à des fins d'analyse lorsque le streaming en temps réel ou les intégrations de plateforme ne sont pas viables, vous pouvez utiliser l'**AWS Command Line Interface (CLI)** pour effectuer un téléversement ponctuel vers un bucket Amazon S3 sécurisé hébergé par Netacea. Vous trouverez ci-dessous les étapes documentées requises pour installer et utiliser l'AWS CLI afin d'effectuer un transfert sécurisé.

### Prérequis

Pour réussir un transfert de logs hors ligne vers Netacea, veuillez vous assurer des points suivants :

* L'**AWS CLI** est installée et fonctionne correctement sur votre machine.
* Vous avez reçu les informations nécessaires du bucket S3 (nom du bucket et ARN) de la part de Netacea. Celles-ci sont disponibles [ici](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* Vous avez créé un **fichier de test** pouvant être utilisé pour valider la connexion avant de transférer les données réelles.
* Vous utilisez une machine qui :
  * Permet l'**accès en ligne de commande**
  * Dispose des **permissions pour installer et exécuter des outils CLI**
  * A **accès au(x) fichier(s) de logs** destiné(s) au téléversement

{% hint style="info" %}
Vous n'avez pas besoin de provisionner l'infrastructure du bucket S3 ni les identifiants associés, car ceux-ci vous seront fournis.
{% endhint %}

#### Étape 1 : Installer l'AWS CLI

Téléchargez l'AWS CLI depuis la source officielle en fonction de votre système d'exploitation :

* **Windows (64 bits)**
* **macOS (Installeur PKG)**
* **Linux (Installeur)**
* **Amazon Linux (AMI)**

👉 [Lien de téléchargement AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)

Après le téléchargement, exécutez l'installeur et suivez les instructions à l'écran.

Pour confirmer que l'installation s'est déroulée avec succès, exécutez la commande suivante dans votre terminal ou invite de commandes :

```
aws --version
```

#### **Étape 2 : Configurer l'AWS CLI**

Utilisez les identifiants fournis pour configurer votre environnement :

```
aws configure
```

Il vous sera ensuite demandé de saisir quelques informations supplémentaires. Le tableau ci-dessous explique quelles informations doivent être fournies et où les trouver :

<table><thead><tr><th width="245">Nom</th><th>Valeur</th></tr></thead><tbody><tr><td>AWS_ACCESS_KEY_ID</td><td>Obtenu depuis le <a href="https://portal.netacea.com/">portail d'administration Netacea</a></td></tr><tr><td>AWS_SECRET_ACCESS_KEY</td><td>Obtenu depuis le <a href="https://portal.netacea.com/">portail d'administration Netacea</a></td></tr><tr><td>AWS_DEFAULT_REGION</td><td>eu-west-1</td></tr></tbody></table>

#### **Étape 3 : Tester l'accès avec un fichier exemple**

Assurez-vous d'avoir créé un petit fichier de test (celui-ci peut être vide) pour vérifier l'accès :

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

* Remplacez `/full/path/to/testfile.txt` par le chemin réel vers votre fichier de test
* Remplacez `<bucket-name>` par le nom du bucket S3 fourni par Netacea

Une fois le téléversement effectué, contactez l'**équipe Netacea Solutions Engineering** pour confirmer que le fichier a été reçu avec succès.

#### **Étape 4 : Téléverser les données de logs**

Après confirmation de Netacea, vous pouvez procéder au téléversement de votre fichier de logs complet en utilisant la même commande :

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

Assurez-vous de :

* Remplacer `/full/path/to/logfile.log` par le chemin réel vers votre fichier de logs
* Utiliser le même nom de bucket que celui fourni
* Vérifier que le téléversement se termine sans erreurs.

### Jeu de données minimum Netacea

Pour réaliser une Preuve de Valeur (PoV) réussie, le ou les fichiers de logs que vous téléversez doivent inclure les champs suivants :

<table><thead><tr><th width="215">Champs requis</th><th>Description</th></tr></thead><tbody><tr><td>Timestamp</td><td>Le moment auquel la requête a été reçue</td></tr><tr><td>Adresse IP</td><td>L'adresse IP à partir de laquelle la requête a été effectuée</td></tr><tr><td>User Agent</td><td>La chaîne user agent envoyée dans l'en-tête par le client</td></tr><tr><td>Méthode</td><td>La méthode HTTP de la requête</td></tr><tr><td>Chemin</td><td>Le chemin de la ressource demandée</td></tr><tr><td>Requête</td><td>La chaîne de requête de la demande (query string)</td></tr><tr><td>Statut</td><td>Le code de statut HTTP retourné par le serveur</td></tr><tr><td>Référent</td><td>La page web depuis laquelle l'utilisateur a suivi un lien</td></tr><tr><td>Octets envoyés</td><td>Les octets envoyés dans le cadre de la réponse du serveur</td></tr><tr><td>Client JA3</td><td>Empreinte JA3 du client (si disponible)</td></tr><tr><td>X-Forwarded-For*</td><td>Adresse IP de connexion [tableau] d'une requête client, si proxifiée</td></tr><tr><td>True Client IP*</td><td>La source fiable de l'IP client d'origine</td></tr><tr><td>Hôte</td><td>L'hôte de destination de la requête</td></tr><tr><td>Protocole</td><td>Le protocole de la requête</td></tr><tr><td>Temps de requête</td><td>Le temps total nécessaire pour traiter la requête</td></tr></tbody></table>

\* Utile lorsque des proxies se trouvent dans la chaîne de trafic entre le client et l'origine.

### Étapes finales

Une fois la livraison des logs active, **informez votre Solutions Engineer Netacea**. Cela nous permet de :

* Confirmer la réception des données
* Valider le format et l'exhaustivité du jeu de données
* Commencer l'analyse une fois qu'un volume suffisant de données a été collecté

Si vous avez besoin d'assistance lors de la configuration, l'équipe SE de Netacea est là pour vous aider — n'hésitez pas à nous contacter.