SVFS

Installation

Le programme, en cours de développement, n'est pas disponible dans les dépôts. Cependant, des versions packagées sont mises à disposition sur la page releases du dépôts GitHub à l'adresse suivante : https://github.com/ovh/svfs/releases

wget https://github.com/ovh/svfs/releases/download/v<version>/svfs_<version>_amd64.deb
dpkg -i svfs_<version>_amd64.deb
apt install -f

A l'heure d'écrire cette documentation, le programme est disponible en Pre-release sous la version 0.6.0. <version> sera donc remplacé par 0.6.0.

Configuration

Création d'une application

Nous allons commencer par créer une application sur notre compte hubiC. Pour y parvenir, nous nous rendons sur la page https://hubic.com/home/browser/developers/ puis cliquons le lien d'ajout d'une application après s'être connecté si nécessaire.
Nous saisirons ici un identifiant unique à notre application sur la plateforme hubiC puis définissons la redirection de la manière suivante :

http://localhost/

En cas de problème pour trouver un nom d'application accepter, nous pouvons utiliser la commande hubic-application en répondant N lors que le programme demande si nous possédons une application. Ce dernier nous fournira alors un identifiant unique que nous pouvons utiliser.

Une fois la création de l'application terminer, nous cliquerons sur le bouton détails faisant apparaître les informations de notre application dont le Client ID et le Secret Client que nous utiliserons par la suite.

Obtention des paramètres d'authentification

Sur le serveur, nous lançons la commande suivante

hubic-application

Nous répondons oui à la question demandant si nous avons une application sur notre compte en entrant y. Le programme va alors nous demander 4 éléments :

le Client ID

le Secret Client

le mail de notre compte

et le mot de passe associer

Le Client ID et le Secret Client correspondant à ceux obtenu lors de la création de l'application.
Après avoir saisi ces informations, l'application nous fournit deux éléments en retour : hubic_auth et hubic_token.

Montage du filesystem

Il nous reste maintenant à créer un point de montage si nous en avons besoin :

mkdir /sync

Et monter l'espace hubiC comme un filesystem avec la commande suivante :

mount -t svfs -o hubic_auth=<hubic_auth>,hubic_token=<hubic_token>,container=default hubic /sync

où <hubic_auth> et <hubic_token> correspondent à ceux obtenu à l'étape précédente.

Notre espace hubiC est maintenant disponible en tant que système de fichier sur notre machine. Le token d'accès se rafraîchissant automatiquement lorsque cela est nécessaire.