# Envoi d’un fichier en R66

Nous allons maintenant mettre en place un premier transfert: l’envoi d’un fichier depuis Waarp Transfer vers un serveur R66.

## Login et mot de passe

L’authentification R66 étant bidirectionnelle (le client s’authentifie au serveur et le serveur s’authentifie au client), le client utilisera le login `r66_client` et le mot de passe `client_password`, le serveur utilisera le login `r66_server` et le mot de passe `server_password`.

## Configuration client

Pour pouvoir envoyer des fichiers, nous allons devoir ajouter un partenaire R66 à Waarp Transfer, un utilisateur associé à ce partenaire, et une règle de transfert en émission.

### Création d’un partenaire R66

Commençons par ajouter un partenaire R66 :

    $ waarp-transfer partner add --name "r66_server" --address "localhost:6666" --config "serverLogin:r66_server" --config "serverPassword:server_password" --protocol "r66"
    The partner "r66_server" was successfully added.

Pour créer un partenaire, nous devons préciser son nom, ainsi que des informations additionnelles pour contacter le serveur (ici l’adresse de connection, le port, ainsi que les informations d’authentification du serveur).

Voir aussi

Plus d’options de configuration sont disponibles pour les partenaires R66.

Le détail des options est disponible ici

### (Optionnel) Activation de TLS

Optionnellement, si vous souhaitez sécuriser vos transfert vers ce partenaire avec TLS, il faut altérer la configuration du partenaire en activant l’option `isTLS` ainsi :

    $ waarp-transfer partner update "r66_server" --config "serverLogin:r66_server" --config "serverPassword:server_password" --config "isTLS:true"
    The partner "r66_server" was successfully updated.

Note

Il est nécessaire de re-entrer la configuration en entier pour que les valeurs de `serverLogin` et `serverPassword` ne soient pas perdues.

Attention, Waarp Transfer refuse les certificats TLS auto-signés. Si votre partenaire R66 utilise un certificat auto-signé, il faudra l’ajouter à la liste des certificats de confiance du partenaire comme ceci :

    $ waarp-transfer partner credential "r66_server" add --name "r66_server_cert" --type "trusted_tls_certificate" --value "r66.pem"
    The "r66_server_cert" credential was successfully added.

Il vous faudra également activer TLS dans la configuration du serveur.

### Création d’un utilisateur

Pour pouvoir s’authentifier auprès du partenaire, nous devons maintenant créer un utilisateur. Cela se fait en créant un « compte distant » dans Waarp Transfer. Cet utilisateur aura `r66_client` comme login et `client_password` comme mot de passe:

    $ waarp-transfer account remote "r66_server" add --login "r66_client" --password "client_password"
    The account "r66_client" was successfully added.

L’utilisateur est maintenant créé. Pour pouvoir faire un transfert, nous devons maintenant créer une règle de transfert

### Ajout d’une règle

Enfin créons la règle `push` en mode `send` pour pouvoir envoyer des fichiers

Voici donc la commande pour créer la règle :

    $ waarp-transfer rule add --name "push" --direction "send"
    The rule "push" was successfully added.

## Configuration du serveur

Dans cette partie nous allons paramétrer le serveur r66 sur la même instance de Waarp Transfer que celle portant le client. Cependant vous êtes libres d’utiliser une autre instance de Waarp Transfer ou une autre solution utilisant le protocol R66.

### Paramétrage du serveur

Mettons d’abord à jour le paramétrage du serveur et démarrons ce dernier. Les informations doivent correspondrent à celle définies lors de la création du partenaire pendant la configuration du client.

    $ waarp-transfer server update "r66" --address "localhost:6666" --config "serverLogin:r66_server" --config "serverPassword:server_password"
      The server "r66" was successfully updated.
    $ waarp-transfer server start "r66"
      The server "r66" was successfully started.

Optionnellement, si vous souhaitez sécuriser vos transfert vers ce partenaire avec TLS, il faut à la place démarrer le serveur `r66-tls` et lui ajouter des certificats

    $ waarp-transfer server update "r66-tls" --address "localhost:6667" --config "serverLogin:r66_server" --config "serverPassword:server_password"
    The server "r66-tls" was successfully updated.
    $ waarp-transfer server credential "r66-tls" add --name "r66_tls_cert" --type "tls_certificate" --value "r66.crt" --secondary-value "r66.key"
    The "r66_tls_cert" credential was successfully added.
    $ waarp-transfer server restart "r66-tls"
    The server "r66-tls" was successfully restarted.

Attention si vous utilisez le serveur r66-tls de Waarp Transfer pensez à modifier le port du partenaire sur le client car ce serveur utilise le port 6667 par défaut.

### Ajout de l’utilisateur

Nous ajoutons ensuite les informations d’authentification de l’utilisateur afin de l’authoriser à ce connecter:

    $ waarp-transfer account local "r66" add --login "r66_client" --password "client_password"
    The account "r66_client" was successfully added.

Attention si vous utilisez le serveur r66-tls de Waarp Transfer pensez à ajouter l’utilisateur au serveur `r66-tls` plutôt que `r66`:

    $ waarp-transfer account local "r66-tls" add --login "r66_client" --password "client_password"
    The account "r66_client" was successfully added.

### Ajout de la règle de transfert

Enfin créons la règle `push` en mode `receive` pour pouvoir recevoir des fichiers quand le client essaie de nous en envoyer avec cette règle.

    $ waarp-transfer rule add --name "push" --direction "receive"
     The rule "push" was successfully added.

Le sens des règles est toujours à prendre du point de vue de Waarp Transfer (si on envoie un fichier à un serveur, celui ci le reçoit). Attention, le nom de la règle doit être identique à celui de la règle définie sur le client (`push` dans notre exemple).

## Lancer le transfert

Maintenant que nous avons un client et un serveur configurés, nous pouvons effectuer un transfert. Créons d’abord un fichier à transférer, puis envoyons le avec Waarp Transfer :

    # echo "hello world\!" > /var/lib/waarp-transfer/out/a-envoyer.txt

    $ waarp-transfer transfer add --file "a-envoyer.txt" --way "send" --partner "r66_server" --login "r66_client" --rule "push"
    The transfer of file "a-envoyer.txt" was successfully added under the ID: 1

Après avoir établi une connexion avec Waarp Transfer, nous avons déposé un fichier dans le dossier `in` de l’agent `r66_server` avec la règle `push`.

Nous pouvons vérifier que le transfert s’est bien passé dans l’historique des transferts :

    $ waarp-transfer history list
    History:
    [...]
    ● Transfer 1 (send as client) [DONE]
     Remote ID:       1861832829562781696
     Rule:            push
     Protocol:        r66
     Requester:       r66_client
     Requested:       r66_server
     Local filepath:  /var/lib/waarp-transfer/out/a-envoyer.txt
     Remote filepath: a-envoyer.txt
     File size:       13
     Block size:      0
     Block check:     false
     Hash algo:
     Start date:      2024-11-27T19:01:52.406147+01:00
     Step:            StepNone
     Progress:        13
     Task number:     0

Le fichier disponible est maintenant dans le dossier `in` du serveur. Comme nous n’avons pas spécifié de dossier spécifique dans la règle, c’est le dossier par défaut de l’instance qui est utilisé :

    ls -l /var/lib/waarp-transfer/in/a-envoyer.txt
    -rw------- 1 waarp waarp 13 Nov 27 19:01 /var/lib/waarp-transfer/in/a-envoyer.txt