<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="fr">
<bookinfo>
<title>Le manuel de KDE su</title>
<authorgroup>
<author>
<firstname>Geert</firstname>
<surname>Jansen</surname>
<affiliation>
<address><email><ulink url="mailto:g.t.jansen@stud.tue.nl">g.t.jansen@stud.tue.nl</ulink></email></address>
</affiliation>
</author>
</authorgroup>
<date>??/??/??</date>
<releaseinfo>Version ??.??.??</releaseinfo>
<abstract>
<para>Ceci est la documentation officielle de KDE su.</para>
<para>(Traduction française&nbsp;: Christophe Dioux).</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>su</keyword>
<keyword>password</keyword>
<keyword>root</keyword>
</keywordset>
</bookinfo>

<chapter id="Introduction">
<title>Introduction</title>

<para>Bienvenue sur KDE su !</para>

<para>KDE su est une interface graphique dans l'environnement de bureau KDE
pour la commande Unix "su". Il vous permet de lancer un programme au
nom d'un autre utilisateur, dès lors que vous pouvez fournir le mot de
passe de cet utilisateur. KDE su ne dispose d'aucun privilège
particulier, il utilise la commande "su" du système.</para>

<para>KDE su dispose d'une fonction additionnelle&nbsp;: il peut se
souvenir des mots de passe pour vous. Si vous utilisez cette fonction,
il vous suffit d'entrer le mot de passe une seule fois pour chaque
commande. Consultez la <xref linkend="conservation-du-mot-de-passe">
pour de plus amples informations et pour une analyse des questions de
sécurité afférentes.</para>

<para>Ce programme est prévu pour être lancé depuis la ligne de
commande ou depuis un fichier .desktop. Bien qu'il demande le mot de
passe superutilisateur à travers une boîte de dialogue graphique, je
le considère plus comme une ligne de commande connectée à une
interface graphique que comme un véritable programme graphique.</para>

</chapter>

<chapter id="Installation">
<title>Installation</title>

<sect1 id="telechargement">
<title>Téléchargement</title>

<para>KDE su fait maintenant partie du CVS KDE, dans kdebase. Il
devrait faire partie de toutes les distributions KDE (2.x). Vous
pouvez aussi télécharger une version pour KDE 1.x sur ma page web
<literal
remap="tt">ftp://skynet.stack.nl/pub/users/geertj/</literal>.</para>

</sect1>

<sect1 id="compilation">
<title>Compilation</title>

<para>KDE su faisant partie de kdebase, soit vous l'avez déjà, soit
vous l'aurez en installant kdebase.</para>

<para>Pour compiler la version pour KDE 1.x, utilisez&nbsp;:</para>

<para><programlisting>$ ./configure
$ make
$ make install 
 </programlisting>
</para>

<para>Vous devrez exécuter la dernière étape avec les droits de
superutilisateur. Le processus d'installation nécessite en effet
d'être autorisé à écrire dans les répertoires système de KDE.</para>

</sect1>
</chapter>

<chapter id="UtiliserKDEsu">
<title>Utiliser KDE su</title>

<para>L'utilisation de KDE su est simple. La syntaxe est la
suivante&nbsp;:</para>

<para><programlisting>$ kdesu [USER] [-ntqd] [-f FILE] -c COMMAND [ARG1 [ARG2 [...]]]
$ kdesu -v|-h|-s
 </programlisting>
</para>

<para>Les options de la ligne de commande sont expliquées ci-dessous.</para>

<para><variablelist>
<varlistentry>
<term>-c PROGRAM</term>
<listitem>

<para>Ceci spécifie le programme à lancer en tant que
superutilisateur. Il doit être passé comme un seul argument. Ainsi,
par exemple, si vous voulez lancer un nouveau gestionnaire de
fichiers, vous entrerez la commande&nbsp;:
<programlisting>$ kdesu -c "kfm -sw"
  </programlisting>
</para>


</listitem>
</varlistentry>
<varlistentry>
<term>-f FICHIER</term>
<listitem>

<para>Cette option permet une utilisation efficace de KDE su dans les
fichiers .desktop. Elle dit à KDE su d'examiner le fichier spécifié
par l'argument FICHIER. Si ce fichier est accessible en écriture par
l'utilisateur courant, KDE su exécutera la commande pour le compte de
l'utilisateur courant. Si ce n'est pas le cas, la commande sera
exécutée pour le compte de l'utilisateur USER (par défaut
root).</para>

<para>FICHIER est évalué comme suit&nbsp;: si FICHIER commence par un
"/", il est considéré comme un nom de fichier absolu. Autrement, il
est considéré comme étant le nom d'un fichier de configuration global
de KDE. Par exemple&nbsp;: Pour configurer le gestionnaire d'affichage
kdm, vous pouvez utiliser&nbsp;:</para>

<para><programlisting>$ kdesu -c kdmconfig -f kdmrc
  </programlisting>
</para>

</listitem>
</varlistentry>
<varlistentry>
<term>-t</term>
<listitem>

<para>Active la sortie sur le terminal. Ceci désactive la conservation
des mots de passe. Cette option sert principalement pour le débogage;
si vous voulez lancer une application en mode console, utilisez plutôt
le "su" standard.</para>

</listitem>
</varlistentry>
<varlistentry>
<term>-n</term>
<listitem>

<para>Ne conserve pas le mot de passe. Ceci désactive la case à cocher
"conserver le mot de passe" dans la boîte de dialogue
correspondante.</para>

</listitem>
</varlistentry>
<varlistentry>
<term>-q</term>
<listitem>

<para>Rester silencieux ("quiet")</para>

</listitem>
</varlistentry>
<varlistentry>
<term>-d</term>
<listitem>

<para>Affiche les informations de débogage.</para>

</listitem>
</varlistentry>
<varlistentry>
<term>-v</term>
<listitem>

<para>Affiche l'information sur la version et sort.</para>

</listitem>
</varlistentry>
<varlistentry>
<term>-h</term>
<listitem>

<para>Affiche un peu d'aide.</para>

</listitem>
</varlistentry>
<varlistentry>
<term>-s</term>
<listitem>
<para>Arrête le démon (daemon) kdesu. Consulter la <xref linkend="conservation-du-mot-de-passe">.</para>
</listitem>
</varlistentry>
</variablelist>
</para>

</chapter>

<chapter id="Configuration">
<title>Configuration</title>

<para>KDE su est fourni avec un module de contrôle nommé
kcmkdesu. Vous pouvez le trouver dans le menu K, sous
"Configuration"-&gt;"Applications"-&gt;"KDE su". Vous pouvez modifier les
choses suivantes&nbsp;:</para>

<para><itemizedlist>
<listitem>

<para>Mode écho. Ceci modifie la manière dont les caractères que vous
frappez sont affichés à l'écran. Les possibilités sont&nbsp;: une
étoile par caractère, trois étoiles, ou pas d'écho du tout. La valeur
par défaut est une étoile par caractère.</para>

</listitem>
<listitem>

<para>Conservation des mots de passe. Vous pouvez demander à KDE su de
se souvenir des mots de passe en cochant la case "conserver les mots
de passe". Si c'est le cas, vous pouvez entrer une limite de temps
dans le champ texte qui suit. C'est la durée, en minutes, pendant
laquelle le mot de passe restera en mémoire. Par défaut, KDE su ne
mémorise pas les mots de passe.</para>

</listitem>
</itemizedlist>
</para>

</chapter>

<chapter id="Internes">
<title>Fonctionnement interne</title>

<sect1 id="x-authentication">
<title>Authentification X</title>

<para>Le programme que vous exécutez va fonctionner sous l'identité du
superutilisateur et n'aura généralement pas accès à votre affichage
Xwindow. KDE su contourne ce problème en ajoutant un cookie
d'authentification pour votre affichage dans une fichier temporaire
nommé <literal remap="tt">.Xauthority</literal>. Après la fin de la
commande, ce fichier sera supprimé.</para>

<para>Si vous ne voulez pas utiliser de cookies X, vous devrez vous
débrouiller par vos propres moyens. KDE su le détectera et n'ajoutera
pas de cookie, mais il vous faudra vous assurer que le
superutilisateur est autorisé à accéder à votre affichage
Xwindow.</para>

</sect1>

<sect1 id="interface-avec-su">
<title>Interface avec su</title>

<para>KDE su utilise le "su" du système pour acquérir ses
privilèges. Dans ce paragraphe, j'explique en détail ce
fonctionnement.</para>

<para>Parceque certaines implantations (comme celle de RedHat) ne
veulent pas lire le mot de passe depuis stdin, KDE su crée une paire
pty/tty et exécute "su" avec ses entrées-sorties standards connectées
à tty.</para>

<para>Pour exécuter la commande choisie par l'utilisateur, au lieu
d'un shell interactif, KDE su utilise l'argument "-c" avec su. Cet
argument est compris par tous les shells que je connais, donc le
programme devrait être portable. Su passe cet argument "-c" au shell
de l'utilisateur, et le shell exécute le programme. Exemple de
commande: "su root -c le_programme".</para>

<para>Plutôt que d'exécuter directement la commande avec su, KDE su
exécute un petit morceau de programme nommé <literal
remap="tt">kdesu_stub</literal>. Exécuté pour le compte de
l'utilisateur cible, il demande quelques informations à KDE su à
travers le canal pty/tty (qui correspond à son stdin et à son stdout)
et exécute le programme de l'utilisateur. L'information qui est
transmise comprend: l'affichage X, le cookie d'authentification X (le
cas échéant), le PATH et la commande à lancer. La raison pour laquelle
un petit programme intermédiaire est utilisé, c'est que le cookie X
est une information privée et que, pour cette raison, il ne peut pas
être passé sur la ligne de commande.</para>

</sect1>

<sect1 id="verification-du-mot-de-passe">
<title>Vérification du mot de passe</title>

<para>KDE su vérifie le mot de passe que vous donnez et envoie un
message d'erreur s'il n'est pas correct. La vérification passe par un
programme de test&nbsp;: <literal remap="tt">/bin/true</literal>. Si
le test réussi, le mot de passe est considéré comme étant
correct.</para>

</sect1>

<sect1 id="conservation-du-mot-de-passe">
<title>Conservation du mot de passe</title>

<para>Pour votre confort, KDE su comprend une fonction de
"conservation du mot de passe". Si vous vous intéressez aux questions
de sécurité, vous devriez lire ce paragraphe.</para>

<para>Le fait de permettre à KDE su de se souvenir des mots de passe
ouvre une (petite) brèche de sécurité dans votre système. Evidemment,
KDE su n'autorise personne d'autre que vous-même (votre user id) à
utiliser ces mots de passe, mais, si on n'y prend pas garde, ceci
descend le niveau de sécurité du superutilisateur à celui d'un
utilisateur normal (vous). Un hacker qui prendrait possession de votre
compte pourrait ainsi obtenir l'accès root. KDE su essaye d'éviter
cela. La technique qu'il utilise pour cela est, au moins de mon point
de vue, raisonnablement sûre et elle est exposée ci-dessous.</para>

<para>KDE su utilise un daemon, nommé kdesud. Ce daemon attend des
commandes dans une socket UNIX placée dans /tmp. Le mode de cette
socket est 600, ainsi seul votre utilisateur peut s'y connecter. Si la
conservation des mots de passe est activée, KDE su exécute les
commandes par l'intermédiaire de ce daemon. Il écrit la commande et le
mot de passe root dans cette socket, puis le daemon exécute la command
"su" comme décrit précédemment. Ensuite, la commande et le mot de
passe ne sont pas détruits. Au lieu de cela, ils sont conservés pour
une durée déterminée. Il s'agit de la durée spécifiée dans le module
de contrôle. Si une autre requête pour la même commande intervient
pendant cette période, le client ne vous demandera pas de fournir de
nouveau le mot de passe. Pour empêcher les hackers qui prendraient le
contrôle de votre compte de voler les mots de passe au daemon (par
exemple en lui attachant un débogueur), le daemon est installé
set-group-id nogroup. Ceci devrait interdire à tous les utilisateurs
normaux (y compris vous) de récupérer les mots de passe dans le
processus kdesud. Par ailleurs, le daemon fixe la variable
d'environnement DISPLAY à la valeur qu'elle avait quand il a été
lancé. Ainsi, la seule chose que puisse faire un hacker est d'éxécuter
une application sur votre écran.</para>

<para>Un point faible dans ce schéma est que le programme que vous
exécutez n'a peut être pas été écrit avec un grand souci de sécurité
(comme c'est le cas pour les programmes setuid root). Ceci signifie
que ce programme pourrait avoir des débordements de tampons ("buffer
overruns") ou d'autres faiblesses qu'un hacker pourrait
utiliser.</para>

<para>La conservation des mots de passe est donc le fruit d'un
compromis entre confort et sécurité. Je vous incite à y réfléchir et à
décider par vous-même si vous souhaitez vous en servir ou pas.</para>

</sect1>
</chapter>

<chapter id="Auteur">
<title>Auteur</title>

<para>KDE su est écrit par Geert Jansen. Il est par certains aspects
basé sur le KDE su de Pietro Iglio, version 0.3. Pietro et moi nous
sommes mis d'accord pour que je me charge de la maintenance de ce
programme à l'avenir.</para>

<para>L'auteur peut être joint par email à &lt;g.t.jansen@stud.tue.nl&gt;.
Merci de me signaler tous les bugs que vous pourriez rencontrer afin que je les résolve. Si vous avez une suggestion, n'hésitez pas à m'en faire part.
</para>


</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
