<note important>Tuto en cours de rédaction en même temps que je fais l'install, c'est loin d'être finis. Je part de cette doc : [[http://docs.services.mozilla.com/howtos/run-fxa.html]]</note>

====== Installer sur serveur Firefox Account ======

===== Firefox quoi ? pour faire quoi ? =====

Firefox vous permet de synchroniser les données de votre navigateur (historique, marques pages, cookies, extensions ...) avec Firefox pour Android ou tout simplement un autre ordinateur.

<note>Compléter avec les fonctionnalité d'envoie d'onglets entre périphériques</note>

===== L'arrivée de FirefoxOS chamboule tout =====

Au début il y avait Sync, on pouvait facilement héberger son propre serveur soit en se basant sur la doc fournie par Mozilla soit en utilisant une extension owncloud qui implémentait le protocole Sync.

Bref on pouvait s'en sortir facilement.

Mais depuis la sortie de FirefoxOS Mozilla a tout changé, enfin presque, Sync existe toujours mais ils ont ajouté une genre de surcouche on ne peut plus paramétrer Sync depuis la version 29 il faut maintenant avoir (en plus du serveur Sync) un serveur Firefox Account, les Firefox Account sont également utilisé pour s'indentifier sur son tel Firefox OS, Mozilla a voulu unifier les choses.

On peut aussi choisir d'installer un serveur Firefox Account couplé avec un "content-server", d'après la doc de Mozilla celà prend en compte plus d'aspects probablement la synchronisation des webapp (à vérifier), pratique si on a un tel FirefoxOS.

===== Environnement =====

J'effectue l'installation sur un serveur sous Debian 7.6 (wheezy).

Vous aurez besoin de :
  * git
  * nodejs
  * libgmp (cf Prerequisites de [[ https://github.com/mozilla/fxa-auth-server/ | ff-auth-server ]])
  * g++

==== Installation de git ====

  apt-get install git

==== Installation de nodeJS ====

//(Source: [[https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager]])//

Installation du curl (s'il n'est pas déjà présent) :
  apt-get install curl
  

Ajout du dépot NodeSource :
  curl -sL https://deb.nodesource.com/setup | bash -
Installation de nodeJS :
  apt-get install nodejs
Vérifiez que vous avez bien une version 0.10.xx ou supérieure :
  $ node --version
  v0.10.29

==== Installation de libgmp ====

J'ai trouvé que le dev dans le dépots :
  apt-get install libgmp-dev
  
==== Installation de g++ ====
  apt-get install g++

===== Installation du serveur d'authentification (ff-auth-server) =====

==== Prérequis ====

Rien ne vaut un petit coup d'oeil au README.md ici :
[[https://github.com/mozilla/fxa-auth-server/]]

<note important>Le serveur d'authentification est très récent et risque de subir de nombreux changements, merci de mettre à jour ce tuto si vous remarquer des changements dans la procédure d'installation.</note>

==== Récupération des sources ====

Nous allons tout mettre dans /opt.
  cd /opt
  git clone git://github.com/mozilla/fxa-auth-server.git
  cd fxa-auth-server/
  npm install

<note important>Ne pas faire l'install en root, penser a adapter le tuto, idéalement créer un utilisateur ?. TODO</note>

==== Tester ====
Vous pouvez lancer les tests unitaires à l'aide de la commande suivante :
  cd /opt/fxa-auth-server
  npm test

==== Configuration ====

Ecoute sur toutes les interfaces :

<code>
@@ -44,7 +44,7 @@ module.exports = function (fs, path, url, convict) {
     listen: {
       host: {
         doc: "The ip address the server should bind",
-        default: '127.0.0.1',
+        default: '0.0.0.0',
         format: 'ipaddress',
         env: 'IP_ADDRESS'
       },
</code>

==== Démarrer les services ====

  cd /opt/fxa-auth-server
  npm start