<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
  <!ENTITY kappname "&kdesu;">
  <!ENTITY package "kdebase">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE"
> <!-- change language only here -->
]>

<book id="kdesu" lang="&language;">
<bookinfo>

<title
>Manuel de &kdesu;</title>

<authorgroup>
<author
>&Geert.Jansen; &Geert.Jansen.mail;</author>
&traducteurYvesDessertine; &relecteurGerardDelafond; 
</authorgroup>

<copyright>
<year
>2000</year>
<holder
>&Geert.Jansen;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>21/09/2010 </date>
<releaseinfo
>&kde; 4.5</releaseinfo>


<abstract
><para
>&kdesu; est une interface graphique pour la commande &UNIX; <command
>su</command
>.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>su</keyword>
<keyword
>password</keyword>
<keyword
>superutilisateur</keyword>
</keywordset>

</bookinfo>

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

<!-- from kdebase/runtime/kdesu/FAQ since rev 855297
kdesu is a libexec program, so does not normally reside in your PATH.
Use something like:
<command
>$(kde4-config - -path libexec)kdesu - - program_to_run
  
https://bugs.kde.org/show_bug.cgi?id=194267
"one needs to create a
~/.kde/share/config/kdesurc file to tell KDE to use sudo instead of su."
~/.kde/share/config/kdesurc
[super-user-command]
super-user-command=sudo
does this really work?
-->

<para
>Bienvenue sur &kdesu; ! &kdesu; est une interface graphique dans l'environnement de bureau KDE pour la commande &UNIX; <command
>su</command
>. 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. &kdesu; ne dispose d'aucun privilège particulier, il utilise la commande <command
>su</command
> du système.</para>

<para
>&kdesu; dispose d'une fonction supplémentaire : il peut se souvenir des mots de passe pour vous. Si vous utilisez cette fonction, il vous suffit de saisir le mot de passe une seule fois pour chaque commande. Consultez <xref linkend="sec-password-keeping"/> 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 <filename
>.desktop</filename
>. Bien qu'il demande le mot de passe <systemitem class="username"
>superutilisateur</systemitem
> à 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>

<para
>Comme <command
>kdesu</command
> n'est plus installé dans <userinput
>$(kde4-config --prefix)</userinput
>/bin mais dans <userinput
>kde4-config --path libexec</userinput
> et par conséquent pas dans votre variable <envar
>Path</envar
>, vous devez utiliser <userinput
>$(kde4-config --path libexec)<command
>kdesu</command
></userinput
> pour lancer <command
>kdesu</command
>.</para>
</chapter>

<chapter id="using-kdesu">
<title
>Utiliser &kdesu;</title>

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

<cmdsynopsis
><command
>kdesu</command
> <group choice="opt"
><option
>-c</option
><replaceable
> commande</replaceable
></group
> <group choice="opt"
><option
>-d</option
></group
> <group choice="opt"
><option
>-f</option
> <replaceable
> fichier</replaceable
></group
> <group choice="opt"
><option
>-i</option
> <replaceable
> nom de l'icône</replaceable
></group
> <group choice="opt"
><option
>-n</option
></group
> <group choice="opt"
><option
>-p</option
> <replaceable
> priorité</replaceable
></group
> <group choice="opt"
><option
>-r</option
></group
> <group choice="opt"
><option
>-s</option
></group
> <group choice="opt"
><option
>-t</option
></group
> <group choice="opt"
><option
>-u</option
> <replaceable
> user</replaceable
></group
> <group choice="opt"
><option
>--noignorebutton</option
></group
> <group choice="opt"
><option
>--attach</option
> <replaceable
> winid</replaceable
></group
> </cmdsynopsis>
<cmdsynopsis
><command
>kdesu</command
> <arg choice="opt"
>options génériques &kde;</arg
> <arg choice="opt"
>options génériques &Qt;</arg
> </cmdsynopsis>

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

<variablelist>
<varlistentry>
<term
><option
>-c <replaceable
>commande</replaceable
></option
></term>
<listitem
><para
>Ceci spécifie la commande à 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 saisirez la commande : <userinput
>$(kde4-config --path libexec)<command
>kdesu <option
>-c <replaceable
> &dolphin;</replaceable
></option
></command
></userinput
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-d</option
></term>
<listitem
><para
>Affiche les informations de déboguage.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-f <replaceable
>fichier</replaceable
></option
></term>
<listitem
><para
>Cette option permet une utilisation efficace de &kdesu; dans les fichiers <filename
>.desktop</filename
>. Elle dit à &kdesu; d'examiner le fichier spécifié par l'argument <parameter
>fichier</parameter
>. Si ce fichier est accessible en écriture par l'utilisateur courant, &kdesu; 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 <parameter
>user</parameter
> (par défaut le superutilisateur).</para>
<para
><parameter
>fichier</parameter
> est évalué comme suit : si <parameter
>fichier</parameter
> commence par un <literal
>/</literal
>, 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;.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>-f <replaceable
>nom de l'icône</replaceable
></term>
<listitem
><para
>Spécifie l'icône à utiliser dans la boîte de dialogue de mot de passe. Spécifiez juste le nom, sans l'extension.</para>
<para
>Par exemple, pour exécuter &konqueror; en mode gestionnaire de fichiers et afficher l'icône de &konqueror; dans la boîte de dialogue du mot de passe :</para>
<screen
><userinput
>$(kde4-config --path libexec)<command
>kdesu</command
> <option
>-i konqueror</option
> 
<option
>-c "konqueror --profile filemanagement"</option
></userinput
></screen>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-n</option
></term>
<listitem
><para
>Ne conserve pas le mot de passe. Ceci désactive la case à cocher <guilabel
>conserver le mot de passe</guilabel
> dans la boîte de dialogue correspondante.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-p</option
> <replaceable
>priorité</replaceable
></term>
<listitem>
<para
>Règle la valeur de la priorité. La priorité est un nombre arbitraire entre 0 et 100, où 100 signifie la priorité la plus haute, et 0 la plus basse. La valeur par défaut est 50.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>-r</option
></term>
<listitem
><para
>Utilise l'ordonnancement temps réel.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s</option
></term>
<listitem
><para
>Arrête le démon (daemon) kdesu. Consulter <xref linkend="sec-password-keeping"/>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-t</option
></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 <command
>su</command
> standard.</para
> </listitem>
</varlistentry>
<varlistentry>
<term
><option
>-u</option
> <replaceable
> user</replaceable
></term>
<listitem
><para
>Alors que l'utilisation la plus courante de &kdesu; est d'exécuter une commande en superutilisateur, vous pouvez indiquer n'importe quel nom d'utilisateur et le mot de passe approprié.</para>
</listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="Internals">
<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. &kdesu; contourne ce problème en ajoutant un cookie d'authentification pour votre affichage dans un fichier temporaire nommé <filename
>.Xauthority</filename
>. 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. &kdesu; 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-to-su">
<title
>Interface avec <command
>su</command
></title>

<para
>&kdesu; utilise la commande <command
>su</command
> du système pour acquérir ses privilèges. Dans cette section, j'explique en détail ce fonctionnement. </para>

<para
>Du fait que certaines implantations de <command
>su</command
> (comme celle de &RedHat;) ne veulent pas lire le mot de passe depuis <literal
>stdin</literal
>, &kdesu; crée une paire pty / tty et exécute <command
>su</command
> 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, &kdesu; utilise l'argument <option
>-c</option
> avec <command
>su</command
>. Cet argument est compris par tous les shells que je connais, donc le programme devrait être portable. <command
>su</command
> passe cet argument <option
>-c</option
> au shell de l'utilisateur, et le shell exécute le programme. Exemple de commande <command
>su<option
> root -c <replaceable
>le_programme</replaceable
></option
></command
>.</para>

<para
>Plutôt que d'exécuter directement la commande avec <command
>su</command
>, &kdesu; exécute un petit morceau de programme nommé <application
>kdesu_stub</application
>. Exécuté pour le compte de l'utilisateur cible, il demande quelques informations à &kdesu; à 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 <envar
>PATH</envar
> 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="password-checking">
<title
>Vérification du mot de passe</title>

<para
>&kdesu; 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 : <filename
>/bin/true</filename
>. Si le test réussit, le mot de passe est considéré comme étant correct.</para>

</sect1>

<sect1 id="sec-password-keeping">
<title
>Conservation du mot de passe</title>

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

<para
>Le fait de permettre à &kdesu; de se souvenir des mots de passe ouvre une (petite) brèche de sécurité dans votre système. Évidemment, &kdesu; 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 <systemitem class="username"
>superutilisateur</systemitem
> à celui d'un utilisateur normal (vous). Un hacker qui prendrait possession de votre compte pourrait ainsi obtenir l'accès <systemitem class="username"
>superutilisateur</systemitem
>. &kdesu; 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
>&kdesu; utilise un daemon, nommé <application
>kdesud</application
>. Ce daemon attend des commandes dans un socket &UNIX; placé dans <filename
>/tmp</filename
>. Le mode de ce socket est 0600, ainsi seul votre utilisateur peut s'y connecter. Si la conservation des mots de passe est activée, &kdesu; exécute les commandes par l'intermédiaire de ce daemon. Il écrit la commande et le mot de passe <systemitem class="username"
>superutilisateur</systemitem
> dans ce socket, puis le daemon exécute la commande <command
>su</command
> 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 configuration. 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) d'obtenir les mots de passe dans le processus <application
>kdesud</application
>. Par ailleurs, le daemon fixe la variable d'environnement <envar
>DISPLAY</envar
> à la valeur qu'elle avait quand il a été lancé. Ainsi, la seule chose que puisse faire un hacker est d'exé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 <systemitem class="username"
>root</systemitem
>). 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="Author">
<title
>Auteur</title>

<para
>&kdesu;</para>

<para
>Copyright 2000 &Geert.Jansen;</para>

<para
>&kdesu; est écrit par &Geert.Jansen;. Il est par certains aspects fondé sur le &kdesu; 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 courrier électronique à &Geert.Jansen.mail;. 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>

<para
>Traduction française par &YvesDessertine;. Relecture par &GerardDelafond;.</para
> 
&underFDL; &underArtisticLicense; </chapter>

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