# Réception d’un fichier via R66

Nous allons mettre en place un second transfert: la réception d’un fichier sur Waarp Transfer depuis un serveur R66. Si vous avez suivi la mise en place du transfert d’envoie alors vous pouvez aller directement au paramétrage de la règle.

## 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 réception.

### 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 `pull` en mode `receive` pour pouvoir envoyer des fichiers

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

    $ waarp-transfer rule add --name "pull" --direction "receive"
    The rule "pull" 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 `pull` en mode `send` pour pouvoir envoyer des fichiers quand le client essaie de nous en demander avec cette règle.

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

Le sens des règles est toujours à prendre du point de vue de Waarp Transfer (si on demande un fichier à un serveur, celui ci l”envoie). Attention, le nom de la règle doit être identique à celui de la règle définie sur le client (`pull` 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 sur le serveur, puis récupérerons le avec Waarp Transfer :

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

    $ waarp-transfer transfer add --file "a-recevoir.txt" --way "receive" --partner "r66_server" --login "r66_client" --rule "pull"
    The transfer of file a-recevoir.txt was successfully added.

Après avoir établi une connexion avec Waarp Transfer, nous avons récupérer un fichier depuis le dossier `out` de l’agent `r66_server` avec la règle `pull`.

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

    $ waarp-transfer history list
    History:
    [...]
    ● Transfer 1 (receive as client) [DONE]
     Remote ID:       1862073248406044672
     Rule:            pull
     Protocol:        r66-tls
     Requester:       r66_client
     Requested:       r66_server
     Local filepath:  /var/lib/waarp-transfer/in/a-recevoir.txt
     Remote filepath: a-recevoir.txt
     File size:       13
     Block size:      0
     Block check:     false
     Hash algo:
     Start date:      2024-11-28T10:57:12.72556+01:00
     Step:            StepNone
     Progress:        13
     Task number:     0

Le fichier disponible est maintenant dans le dossier `in` de Waarp Transfer. 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-recevoir.txt
    -rw------- 1 waarp waarp 13 Nov 27 19:01 /var/lib/waarp-transfer/in/a-recevoir.txt