README 2.56 KB
Newer Older
Daniel STAN's avatar
Daniel STAN committed
1 2 3 4
Bienvenue sur l'outil de gestion de mot de passe du Cr@ns.
Ce dépôt git contient à la fois le programme client (à utiliser sur votre
ordinateur) et le serveur.

5 6
== Nom de la commande ==
Si vous voulez appeler votre commande autrement que "cranspasswords",
7
c'est possible. Il faut pour cela changer la variable cmd_name dans le Makefile
Vincent Le gallic's avatar
Vincent Le gallic committed
8
avant de lancer make install ou make install-server.
9

Daniel STAN's avatar
Daniel STAN committed
10
== Installation et configuration du client ==
Vincent Le gallic's avatar
Vincent Le gallic committed
11
 * Copiez le dépôt git sur votre machine :
Daniel STAN's avatar
Daniel STAN committed
12
    $ git clone git://git.crans.org/git/cranspasswords.git 
Daniel STAN's avatar
Daniel STAN committed
13
 * Si ce n'est déjà fait, indiquer votre clé publique sur gest_crans
14 15
 * Pensez à changer votre username dans clientconfig.example.py si vous n'avez pas le même
   sur votre machine et sur le serveur.
16 17 18
 * Lancez make install
 * Assurez-vous d'avoir ~/bin dans votre $PATH
 * Exécutez cranspasswords test pour voir si vous arrivez à récupérer le mot de passe de test
19

20 21 22 23 24 25 26 27 28
 * Si vous voulez pouvoir importer client.py pour faire des choses dans ipython par exemple,
   comme votre sys.argv[0] ne sera pas "cranspasswords", il aura du mal à savoir où il doit
   aller cherche sa config.
   Aidez-le avec :
   export CRANSPASSWORDS_CLIENT_CONFIG_DIR=/path/to/config/dir/
   
   NB : le nom de cette variable n'est pas modifié
   même si vous renommez la commande cranspasswords.

Vincent Le gallic's avatar
Vincent Le gallic committed
29 30 31 32 33 34 35 36 37 38 39 40
== Installation et configuration du serveur ==
 * Copiez le dépôt git sur le serveur :
    $ git clone git://git.crans.org/git/cranspasswords.git
 * Lancez sudo make install-server
  * Il va installer un suoder-file, si vous voulez paramétrer
    le groupe qui aura les accès en lecture aux fichiers de mot de passe,
    changez la variable sudoer_group au début de Makefile.
    La possibilité de lire les fichiers est indépendante de la capacité
    à les déchiffrer.
 * Éditez /etc/cranspasswords/serverconfig.py pour qu'il soit conforme
   à vos désirs.

41 42 43 44 45 46 47 48 49
== Troubleshoutings ==
"""sudo: sorry, a password is required to run sudo"""
    Côté client: Vérifier le ``server_path`` et les variables en dépendant,
    dans le serverconfig.py. S'assurer qu'il n'existe pas de
    clientconfig.py[c] résiduel dans le dossier de cranspasswords.
    Côté serveur, s'assurer que le serveur est intallé au bon endroit
    (/usr/local/bin/$NAME-server) et que le fichier sudoers est bien
    installé (/etc/sudoers.d/$NAME) pour lancer le sudo sans mot de passe

50 51 52 53
== Complétion ==
 * Pour avoir la bash-complétion, dans votre .bashrc :
  * Sourcez le fichier bash_completion présent dans le dépôt
  * exécutez "complete -F _cranspasswords_completion <nom de votre commande>"