<?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 % Dutch "INCLUDE"
> <!-- change language only here -->
]>

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

<title
>Het &kdesu;-handboek</title>

<authorgroup>
<author
>&Geert.Jansen; &Geert.Jansen.mail;</author>
&Niels.Reedijk;&Rinse.Devries; 
</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-01-18</date>
<releaseinfo
>1.00.00</releaseinfo>


<abstract
><para
>&kdesu; is een grafische schil voor het &UNIX;-commando  <command
>su</command
>.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>su</keyword>
<keyword
>wachtwoord</keyword>
<keyword
>root</keyword>
</keywordset>

</bookinfo>

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

<para
>Welkom bij &kdesu;! &kdesu; is een grafische schil voor het UNIX-commando <command
>su</command
> voor de K Desktop Environment. Hiermee kunt u een programma als een andere gebruiker draaien door het wachtwoord voor die gebruiker in te voeren. &kdesu; doet zelf niets; het gebruikt het commando <command
>su</command
> van het systeem.</para>

<para
>&kdesu; heeft één bijkomstige mogelijkheid: het kan wachtwoorden voor u onthouden. Als u deze mogelijkheid gebruikt, hoeft u het wachtwoord slechts één keer voor elk commando in te typen. Zie <xref linkend="sec-password-keeping"/> voor meer informatie hierover en een beveiligingsanalyse.</para>

<para
>Dit programma dient te worden gestart vanaf de commandoregel of vanuit <filename
>.desktop</filename
>-bestanden. Hoewel het <systemitem class="username"
>root</systemitem
>-wachtwoord via een &GUI; dialoogvenster wordt gevraagd, wordt het meer als commandoregel &lt;-&gt; &GUI;-lijm, in plaats van een puur &GUI;-programma, gezien.</para>

</chapter>

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

<para
>Het gebruik van &kdesu; is makkelijk. De syntaxis is als volgt:</para>

    <cmdsynopsis
><command
>kdesu</command
> <arg
>GEBRUIKERNAAM</arg
> <arg
>-n</arg
> <arg
>-t</arg
> <arg
>-q</arg
> <arg
>-d</arg
> <arg
>-f <replaceable
>BESTAND</replaceable
></arg
> <arg
>-c <group
> <arg
> <replaceable
>COMMANDO</replaceable
> <arg
><replaceable
>ARGUMENT1</replaceable
></arg
> <arg
><replaceable
>ARGUMENT2</replaceable
></arg
> <arg rep="repeat"
><replaceable
></replaceable
></arg
> </arg
> </group
> </arg
> </cmdsynopsis>

    <cmdsynopsis
><command
>kdesu</command
> <group
> <arg
>-v</arg
> <arg
>-h</arg
> <arg
>-s</arg
> </group
> </cmdsynopsis>

<para
>De commandoregelopties zijn hieronder uitgelegd.</para>

<variablelist>
<varlistentry>
<term
><option
>-c <replaceable
>PROGRAMMA</replaceable
></option
></term>
<listitem
><para
>Dit specificeert het programma dat gedraaid zal worden als root. Er moet één argument in. Dus, als u, bijvoorbeeld, een nieuwe bestandsbeheerder wilt starten, kunt u op de prompt het volgende invoeren: <userinput
><command
>kdesu <option
>-c <replaceable
>konqueror</replaceable
></option
></command
></userinput
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-f <replaceable
>FILE</replaceable
></option
></term>
<listitem
><para
>Met deze optie kunt u &kdesu; efficiënt gebruiken in <filename
>.desktop</filename
> bestanden. Het vertelt &kdesu; om het bestand gespecificeerd door de <parameter
>FILE</parameter
> te lezen. Als dit bestand schrijfbaar is door de huidige gebruiker, zal &kdesu; het commando als de huidige gebruiker uitvoeren. Als het niet schrijfbaar is, zal het commando uitgevoerd worden door de gebruiker <parameter
>USER</parameter
> (standaard is dat root).</para>
<para
><parameter
>FILE</parameter
> wordt op de volgende manier bekeken: als <parameter
>FILE</parameter
> met een "/" begint, wordt het gezien als een bestandsnaam. Anders wordt het gezien als de naam van een globaal &kde;-configuratiebestand. Bijvoorbeeld: om de K Display Manager, <application
>kdm</application
>,  in te stellen voert u het volgende commando in: <command
>kdesu <option
>-c kdmconfig -f kdmrc</option
></command
> </para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-t</option
></term>
<listitem
><para
>Schakelt terminaluitvoer in. Dit schakelt het bewaren van wachtwoorden uit. Dit is vooral voor debugdoeleinden; als u een consolemode programma wilt draaien, gebruik dan het standaardcommando <command
>su</command
>.</para
> </listitem>
</varlistentry>
<varlistentry>
<term
><option
>-n</option
></term>
<listitem
><para
>Sla het wachtwoord niet op. Dit schakelt het keuzevakje  <guilabel
>Wachtwoord onthouden</guilabel
> in het dialoogvenster uit.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-q</option
></term>
<listitem
><para
>Wees stil.</para
></listitem>
<!-- Lauri: This could do with a little expansion.  quiet as in no screen -->
<!-- output, quiet as in no gui prompt for the password, or quiet as in no -->
<!-- beeping? -->
</varlistentry>

<varlistentry>
<term
><option
>-d</option
></term>
<listitem
><para
>Geef debuginformatie weer.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-v</option
></term>
<listitem
><para
>Debuginformatie weergeven en daarna stoppen.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-h</option
></term>
<listitem
><para
>Print wat hulp.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-s</option
></term>
<listitem
><para
>Stop de kdesu daemon. zie <xref linkend="sec-password-keeping"/>.</para
></listitem>
</varlistentry>
</variablelist>

</chapter>

<chapter id="configuration">
<title
>Configuratie</title>

<para
>&kdesu; komt met een configuratiemodule genaamd <application
>kcmkdesu</application
>. U kunt deze vinden in &kcontrol; onder <menuchoice
><guisubmenu
>Privacy en beveiliging</guisubmenu
><guisubmenu
>Wachtwoorden</guisubmenu
> </menuchoice
>. U kunt de volgende zaken instellen:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Tekens tonen als</guilabel
></term>
<listitem
><para
>Dit is hoeveel karakters er op het scherm getoond worden in het invoerveld als u een wachtwoord intypt. Mogelijke keuzes zijn: één ster per karakter, drie sterren per karakter of niets tonen. De standaardkeuze is één ster per karakter.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Wachtwoorden onthouden</guilabel
></term>
<listitem
><para
>U kunt &kdesu; wachtwoorden die u invoert voor u laten onthouden. U schakelt dit in door de <guilabel
>wachtwoorden onthouden</guilabel
> te selecteren.Als dit geselecteerd is kunt u een tijdslimietwaarde in het tekstveld daaronder invoeren. Dit is de hoeveelheid tijd in minuten, dat het wachtwoord onthouden wordt. De standaardinstelling is dat er geen wachtwoorden onthouden worden.</para
></listitem>
</varlistentry>
</variablelist>

</chapter>

<chapter id="Internals">
<title
>Onder de motorkap</title>

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

<para
>Het programma dat u uitvoert zal gedraaid worden onder de gebruikers-id root en zal in het algemeen geen toegang hebben tot uw grafische interface (X-display). &kdesu; werkt hier omheen door een authenticatie cookie voor uw scherm toe te voegen aan een tijdelijk <filename
>.Xauthority</filename
> bestand. Nadat het commando is beëindigd zal het bestand verwijderd worden. </para>

<para
>Als u geen gebruik maakt van X-cookies, dan staat u er alleen voor. &kdesu; zal dit opmerken en geen cokie toevoegen. U dient er dan zelf voor te zorgen dat root toegang hefet tot uw grafische omgeving.</para>

</sect1>

<sect1 id="interface-to-su">
<title
>Interface voor <command
>su</command
></title>

<para
>&kdesu; gebruikt het commando <command
>su</command
> van het systeem om de privileges te verkrijgen. In deze sectie wordt uitgelegd hoe &kdesu; dit doet. </para>

<para
>Omdat sommige <command
>su</command
>-implementaties (zoals die van &RedHat;) het wachtwoord niet van de <literal
>stdin</literal
> willen lezen, zal &kdesu; een pty/tty-paar aanmaken en zal het <command
>su</command
> met zijn standaard bestandsdescriptors van daaruit oproepen.</para>

<para
>Om een door de gebruiker geselecteerd commando uit te voeren in plaats van een interactieve shell, gebruikt &kdesu; het <option
>-c</option
> argument met <command
>su</command
>. Dit argument wordt ondersteund door elke shell die bestaat en is dus platformonafhankelijk. <command
>su</command
> geeft dit <option
>-c</option
> argument aan de shell van de doelgebruiker door en de shell zal het programma uitvoeren. Bijvoorbeeld: <command
>su <option
>root -c <replaceable
>het_programma</replaceable
></option
></command
>.</para>

<para
>In plaats van het gebruikerscommando direct uit te voeren met <command
>su</command
>, draait &kdesu; een klein stub-programmaatje genaamd <application
>kdesu_stub</application
>. Deze stub (draaiend als de doelgebruiker), vraagt wat informatie van &kdesu; over het pty/tty-kanaal (de stdin en de stdout van de stub) en draait dan het gebruikersprogramma. De informatie die overgebracht wordt is: de X-display, een X-authenticatie-cookie (als deze beschikbaar is), de <envar
>PATH</envar
> en het uit te voeren commando. De reden waarom een stub -programma wordt gebruikt is dat het cookie geheime informatie bevat en daarom niet over de commandoregel mag doorgegeven worden.</para>

</sect1>

<sect1 id="password-checking">
<title
>Wachtwoordcontrole</title>

<para
>&kdesu; zal het wachtwoord dat u ingevoerd hebt controleren en geeft een foutmelding als het niet correct is. De controle wordt uitgevoerd door een testprogramma: <filename
>/bin/true</filename
>. Als deze succesvol is, is het wachtwoord correct.</para>

</sect1>

<sect1 id="sec-password-keeping">
<title
>Wachtwoord onthouden</title>

<para
>Voor uw gemak implementeert &kdesu; de functie <quote
>wachtwoord onthouden</quote
> functie. Als u geïnteresseerd bent in beveiliging, lees dan deze alinea.</para>

<para
>Als u &kdesu; wachtwoorden laat onthouden opent u een (klein) beveiligingsgat in uw systeem. Het is duidelijk dat &kdesu; niet iemand anders dan uw eigen gebruikers-id toestaat om de wachtwoorden te gebruiken, maar, als het zonder voorzichtigheid gedaan is, zal dit de beveiliging van <systemitem class="username"
>root</systemitem
> verlagen tot het niveau van een normale gebruiker (u). Een cracker die in uw account breekt zal dan  <systemitem class="username"
>root</systemitem
>-toegang kunnen krijgen. &kdesu; probeert dit te voorkomen. Het beveiligingsschema dat wordt gebruikt, is in onze ogen vrij veilig en wordt hieronder uitgelegd.</para>

<para
>&kdesu; gebruikt een daemon, genaamd <application
>kdesud</application
>. De daemon luistert voor commando's naar een &UNIX;-socket in <filename
>/tmp</filename
>. De mode van de socket is 0600, zodat alleen uw gebruikers-id ermee kan verbinden. Als wachtwoorden onthouden is ingeschakeld zal &kdesu; commando's uitvoeren door deze daemon. Het schrijft het commando en het <systemitem class="username"
>root</systemitem
>-wachtwoord naar de socket en de daemon voert het commando uit met behulp van <command
>su</command
>, zoals hierboven is omschreven. Hierna worden het commando en het wachtwoord niet weggegooid. Ze worden voor een bepaalde tijd bewaard. Dit is de tijdslimietwaarde in de configuratiemodule. Als een andere oproep voor hetzelfde commando in deze periode gedaan wordt zal de client het wachtwoord niet hoeven te geven. Om crackers die in uw account gebroken hebben niet de wachtwoorden van de daemon te laten stelen (bijvoorbeeld, door middel van een debugger), is de daemon geïnstalleerd in set-group-id nogroup. Dit zal ervoor zorgen dat alle normale gebruikers (inclusief u) geen wachtwoorden uit het <application
>kdesud</application
> -roces  kunnen halen. De daemon zet ook de <envar
>DISPLAY</envar
> omgevingsvariabele gelijk aan de waarde die het had toen het gestart werd. Het enige dat een cracker kan doen is een programma in het huidige scherm uitvoeren.</para>

<para
>Een zwakke plek in dit schema is dat programma's die u uitvoert waarschijnlijk niet geschreven zijn met beveiliging in gedachte (zoals bij setuid <systemitem class="username"
>root</systemitem
> programma's). Dit betekent dat ze buffer overruns of andere problemen zouden kunnen hebben waarvan een cracker gebruik kan maken.</para>

<para
>Het gebruik van de functie wachtwoord onthouden is een afweging van comfort tegen beveiliging.Wij adviseren u om er goed over na te denken en om zelf te besluiten of u het al dan niet wilt gebruiken.</para>

</sect1>
</chapter>

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

<para
>&kdesu;</para>

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

<para
>&kdesu; is geschreven door &Geert.Jansen;. Het is min of meer gebaseerd op Pietro Iglio's &kdesu;, versie 0.3. Pietro en ik besloten dat ik dit programma in de toekomst zal onderhouden.</para>

<para
>De auteur kan bereikt worden via e-mail op &Geert.Jansen.mail;. Rapporteer alstublieft fouten zodat ik ze kan repareren. als u een suggestie heeft, neem dan alstublieft contact met mij op.</para>
&underFDL; &underArtisticLicense; </chapter>

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

