<?xml version="1.0" encoding="UTF-8" ?>
<page>
  <title>Gestion des utilisateurs</title>
  <section>
    <title>Authentification</title>
    <para>Zephir permet de s'authentifier par l'intermédiaire d'une source externe à l'application.
      Par défaut, la distribution Zephir est livrée avec un annuaire LDAP local qui sert à enregistrer des utilisateurs et leurs mots de passe.</para>
    <para>
      Il est cependant possible de spécifier un annuaire distant lors de la configuration du serveur (par exemple, l'annuaire d'un serveur horus, scribe, ou encore un annuaire académique). Vous pouvez utiliser n'importe quel utilisateur de votre annuaire pour vous connecter (soit par le biais de l'application web, soit par une application tierce compatible avec Zephir). L'annuaire doit comprendre un utilisateur (admin_zephir par défaut, modifiable par gen_config) qui aura la permission de modifier les droits des autres utilisateurs.</para>
      <image src="images/login.eps" scale="0.50">
	<legend>Connexion à l'application web</legend>
      </image>
  </section>
  <section>
    <title>Préférences des utilisateurs</title>
    <para>Zephir intègre désormais une page de préférences permettant de gérer des informations liées aux utilisateurs.</para>
    <para>Ces données sont facultatives mais certaines permettent d'accéder à des fonctionnalités avancées de Zephir (réception de messages d'alerte et connexion aux serveurs avec une cle ssh).</para>
    <para> Lorsque vous êtes connecté avec un nom d'utilisateur, cliquez sur le lien 'préférences' du menu principal pour renseigner ses préférences.</para>
      <image src="images/prefs.eps" scale="0.50">
	<legend>Page de préférences utilisateur</legend>
      </image>
      <para>Les données sont les suivantes :</para>
      <para>
      </para>
      <para>
      <list>
	<item>Nom et Prenom de l'utilisateur</item>
	<item>Adresse mail de l'utilisateur</item>
	<note>Les paramètres ci-dessus sont remplis automatiquement à l'affectation des droits s'ils sont présents dans l'annuaire (champs 'sn', 'givenName', et 'mail')</note>
	<item>numero d'envoi sms (non supporté actuellement)</item>
	<item>Activation ou non des alertes par mail et sms pour cet utilisateur</item>
	<item>Enregistrement d'une cle publique de connexion ssh (permet de se connecter aux serveurs sans mot de passe)</item>
	<note>La réception d'alertes est rattachée à la notion de groupes de serveurs (voir la partie correspondante). Les cle ssh sont autorisées sur des groupes de serveurs par un utilisateur ayant accès à la gestion des droits.</note>
      </list>
    </para>
  </section>
  <section>
    <title>Affectation de Droits</title>
    <para>L'affectation des droits est accessible aux utilisateurs ayant les droits de gestion des permissions (par défaut l'utilisateur admin_zephir a ces droits). Pour changer les droits d'un utilisateur, cliquez sur le lien 'autorisations' et entrez le nom de l'utilisateur dans le champ de texte.</para>
    <para>Après avoir validé, une page va s'afficher indiquant les droits accessibles à cet utilisateur (ils correspondent à des groupes de fonctions internes que l'utilisateur pourra utiliser). Pour modifier ces droits, cocher les cases en face des groupes à autoriser et cliquez sur 'modifier'.</para>
      <image src="images/droits.eps" scale="0.5">
	<legend>Page d'affectation des droits</legend>
      </image>
  </section>
  <section>
    <title>Gestion de la connexion aux serveurs</title>
    <para>Comme cela a été indiqué auparavant, les utilisateurs peuvent déposer sur zephir une clé publique pour la connexion ssh sur les serveurs. Les utilisateurs ayant les droits de gestion des permsisssions peuvent interdire ou autoriser l'utilisation de ces clés sur les serveurs de leur choix. Pour envoyer la clé d'un utilisateur sur un (des) serveur(s), il faut sélectionner un groupe des serveurs (voir le paragraphe correspondant), entrer le login d'un utilisateur dans la case sous 'connexion par clé ssh', et cliquer sur 'autoriser' (ou interdire pour retirer la clé). La clé de l'utilisateur sera envoyée sur le serveur (fichier authorized_keys) au prochain envoi de configuration (vous pouvez la planifier immédiatement en appuyant sur 'action sur le groupe de serveurs', puis 'envoyer la configuration au serveur'.</para>
  </section>
</page>
