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

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

<title
>Das Handbuch zu &kdesu;</title>

<authorgroup>
<author
>&Geert.Jansen; &Geert.Jansen.mail;</author>
<othercredit role="translator"
><firstname
>Philipp</firstname
><surname
>Siegert</surname
><affiliation
><address
><email
>siegert@pp-services.de</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> 
</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; ist eine graphische Oberfläche für den &UNIX;-Befehl <command
>su</command
>.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>su</keyword>
<keyword
>Passwort</keyword>
<keyword
>Systemverwalter</keyword>
</keywordset>

</bookinfo>

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

<para
>Willkommen bei &kdesu;! &kdesu; ist eine graphische Oberfläche für den &UNIX;-Befehl <command
>su</command
> in KDE. Es ermöglicht Ihnen, ein Programm mit einer anderen Benutzerkennung auszuführen, indem Sie das Passwort dieses Benutzers angeben. &kdesu; hat keine speziellen Systemrechte; es benutzt den Befehl <command
>su</command
>.</para>

<para
>&kdesu; hat eine zusätzliche Funktion: Es kann Passwörter speichern. Wenn Sie diese Funktion benutzen, müssen Sie das Passwort für jeden Befehl nur einmal eingeben. Weitere Informationen und eine Sicherheitsanalyse finden Sie unter <xref linkend="sec-password-keeping"/>.</para>

<para
>Dieses Programm sollte von der Befehlszeile oder durch <filename
>.desktop</filename
>-Dateien gestartet werden. Obwohl es über einen Dialog nach dem Passwort des Systemverwalters (<systemitem class="username"
>root</systemitem
>) fragt, ist es trotzdem eher ein Befehlszeilen- als ein reines &GUI;-Programm.</para>

</chapter>

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

<para
>Die Benutzung von &kdesu; ist einfach. Der Syntax ist folgendermaßen:</para>

    <cmdsynopsis
><command
>kdesu</command
> <arg
>Benutzer</arg
> <arg
>-n</arg
> <arg
>-t</arg
> <arg
>-q</arg
> <arg
>-d</arg
> <arg
>-f<replaceable
>Datei</replaceable
></arg
> <arg
>-c <group
> <arg
> <replaceable
>Befehl</replaceable
> <arg
><replaceable
>ARG1</replaceable
></arg
> <arg
><replaceable
>ARG2</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
>Die Befehlszeilen-Parameter sind weiter unten erklärt.</para>

<variablelist>
<varlistentry>
<term
><option
>-c <replaceable
>PROGRAMM</replaceable
></option
></term>
<listitem
><para
>Dieser Parameter gibt an, dass das Programm mit den Rechten des Systemverwalters ausgeführt wird. Der Parameter muss einzeln angegeben werden. Wollen Sie z.B. einen KDE-Dateimanager starten, geben Sie auf der Befehlszeile <userinput
> <command
>kdesu <option
>-c <replaceable
>kfm -sw</replaceable
></option
> </command
></userinput
> ein.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-f <replaceable
>Datei</replaceable
></option
></term>
<listitem
><para
>Dieser Parameter erlaubt den leistungsfähigen Einsatz von &kdesu; bei <filename
>.desktop</filename
> Dateien. Er weist &kdesu; an, die Datei, die mit <parameter
>Datei</parameter
> angegeben wurde, zu untersuchen. Besitzt der aktuelle Benutzer Schreibrechte auf die Datei, wird die Datei unter seinem Namen ausgeführt. Besitzt er keine Schreibrechte, wird die Datei unter dem Benutzernamen <parameter
>BENUTZER</parameter
> (Voreinstellung: Systemverwalter) ausgeführt.</para>
<para
><parameter
>DATEI</parameter
> wird folgendermaßen ausgewertet: Wenn <parameter
>DATEI</parameter
> mit <literal
>/</literal
> beginnt, wird es als absoluter Dateiname behandelt. Andernfalls wird es als Name einer globalen &kde;-Konfigurationsdatei behandelt. Um beispielsweise den KDE-Anmeldungsmanager <application
>kdm</application
> einzurichten, könnten Sie <command
>kdesu <option
>-c kdmconfig -f kdmrc</option
></command
> eingeben.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-t</option
></term>
<listitem
><para
>Terminal-Ausgabe einschalten. Dieser Parameter schaltet das Speichern von Passwörtern aus. Dies ist hauptsächlich für Debugging-Zwecke interessant. Wenn Sie eine Anwendung benutzen wollen, die im Konsolen-Modus läuft, sollten Sie stattdessen den Standardbefehl <command
>su</command
> verwenden.</para
> </listitem>
</varlistentry>
<varlistentry>
<term
><option
>-n</option
></term>
<listitem
><para
>Das Passwort nicht speichern. Dieser Parameter schaltet das Ankreuzfeld <guilabel
>Passwort beibehalten</guilabel
> im Passwort-Dialog aus.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-q</option
></term>
<listitem
><para
>Keine Ausgabe. (<emphasis
>Anmerkung des Übersetzers: Diese Option funktioniert nicht mit der in &kde; 3.0 enthaltenen Version von &kdesu;.</emphasis
>)</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
>Debug-Informationen anzeigen. (<emphasis
>Anmerkung des Übersetzers: Diese Option funktioniert nicht mit der in &kde; 3.0 enthaltenen Version von &kdesu;.</emphasis
>)</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-v</option
></term>
<listitem
><para
>Versionsinformationen anzeigen und Programm beenden.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>--help</option
></term>
<listitem
><para
>Hilfe anzeigen.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-s</option
></term>
<listitem
><para
>Den kdesu-Dämon anhalten. Weitere Details finden Sie unter <xref linkend="sec-password-keeping"/>.</para
></listitem>
</varlistentry>
</variablelist>

</chapter>

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

<para
>&kdesu; wird mit dem Kontrollmodul <application
>kcmkdesu</application
> ausgeliefert. Sie finden dieses Modul im <guimenu
>K</guimenu
>-Menü unter <menuchoice
><guisubmenu
>Einstellungen</guisubmenu
> <guisubmenu
>Sicherheit und Privatsphäre</guisubmenu
> <guimenuitem
> Passwörter</guimenuitem
></menuchoice
>.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Anzeigemodus</guilabel
></term>
<listitem
><para
>Hier lässt sich festlegen, wie Ihre eingegebenen Zeichen auf dem Bildschirm erscheinen. Mögliche Einstellungen sind: ein Stern pro Zeichen, drei Sterne pro Zeichen oder keine Rückmeldung auf dem Bildschirm. Die Voreinstellung ist "ein Stern pro Zeichen".</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Passwörter speichern</guilabel
></term>
<listitem
><para
>Sie können Passwörter in &kdesu; speichern, indem Sie das Ankreuzfeld <guilabel
>Passwörter speichern</guilabel
> markieren. In dem Textfeld darunter können Sie angeben, wieviele Minuten das Passwort gespeichert werden soll. Standardmäßig werden Passwörter nicht gespeichert.</para
></listitem>
</varlistentry>
</variablelist>

</chapter>

<chapter id="Internals">
<title
>Interne Funktionsweise</title>

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

<para
>Das Programm, das Sie aufrufen, wird unter der Benutzer-Kennung (User ID) des Systemverwalters ausgeführt und hat grundsätzlich keinen Zugriff auf Ihre X-Anzeige. &kdesu; umgeht dies, indem es Ihrer Anzeige ein Cookie zur Authentifizierung hinzufügt. Dazu wird eine zeitlich befristete <filename
>.Xauthority</filename
>-Datei angelegt. Nach Beendigung des Befehls wird die Datei wieder gelöscht. </para>

<para
>Wenn Sie keine X-Cookies benutzen, sind Sie auf sich alleine gestellt. &kdesu; wird dies erkennen und kein Cookie hinzufügen. Sie müssen sich vergewissern, dass der Systemverwalter berechtigt ist, auf die Anzeige zuzugreifen.</para>

</sect1>

<sect1 id="interface-to-su">
<title
>Schnittstelle zu <command
>su</command
></title>

<para
>&kdesu; benutzt das Systemkommando <command
>su</command
>, um Rechte zu erhalten. In diesem Abschnitt wird erklärt, wie &kdesu; dabei vorgeht. </para>

<para
>Da manche Implementierungen von <command
>su</command
> (&zb; die von &RedHat;) keine Passwörter von <literal
>stdin</literal
> lesen, erstellt &kdesu; ein pty/tty-Paar und führt <command
>su</command
> so aus, dass die Standard-Dateideskriptoren mit dem tty verbunden sind.</para>

<para
>Um anstelle einer interaktiven Shell einen vom Benutzer angegebenen Befehl auszuführen, benutzt &kdesu; den Befehl <command
>su</command
> mit dem Parameter <option
>-c</option
>. Dieser Parameter wird von jeder bekannten Shell verstanden, sodass er portabel einsetzbar sein sollte. <command
>su</command
> übergibt den Parameter <option
>-c</option
> an die Shell des Benutzers, unter dessen ID der Befehl ausgeführt werden soll. Diese Shell führt dann das Programm aus. Beispiel: <command
>su <option
>root -c <replaceable
>das_programm</replaceable
></option
></command
>.</para>

<para
>Statt den Befehl des Benutzers direkt mit <command
>su</command
> auszuführen, führt &kdesu; das Hilfsprogramm <application
>kdesu_stub</application
> aus. Dieses Hilfsprogramm, das unter der ID des Zielbenutzers läuft, fordert über den pty/tty-Kanal (stdin und stdout des Hilfsprogramms) einige Informationen von &kdesu; an. Danach wird das Programm des Benutzers ausgeführt. Folgende Informationen werden übergeben: die X-Anzeige, ein X-Authentifizierungs-Cookie (wenn verfügbar), die Variable <envar
>PATH</envar
> und der auszuführende Befehl. Der Grund für die Benutzung eines Hilfsprogramms ist der X-Cookie. Dieser beinhaltet sensible Informationen und kann deshalb nicht auf der Befehlszeile übergeben werden.</para>

</sect1>

<sect1 id="password-checking">
<title
>Passwort-Überprüfung</title>

<para
>&kdesu; überprüft die Passwörter, die Sie eingeben und gibt bei Falscheingabe eine Fehlermeldung zurück. Die Überprüfung erfolgt durch ein Testprogramm (<filename
>/bin/true</filename
>). Wenn die Ausführung dieses Programms erfolgreich ist, wird angenommen, dass das Passwort richtig ist.</para>

</sect1>

<sect1 id="sec-password-keeping">
<title
>Passwörter speichern</title>

<para
>Um es Ihnen so einfach wie möglich zu machen, enthält &kdesu; eine Funktion <quote
>Passwort beibehalten</quote
>. Falls Sie sich für die Sicherheit dieser Funktion interessieren, sollten Sie diesen Absatz lesen.</para>

<para
>Indem Sie &kdesu; erlauben, die Passwörter zu speichern, entsteht eine (kleine) Sicherheitslücke in Ihrem System. &kdesu; erlaubt offensichtlich nur Ihrer User-ID die Verwendung der Passwörter. Wenn Sie allerdings nicht aufpassen, kann hierdurch die Sicherheitsstufe des Systemverwalters (<systemitem class="username"
>root</systemitem
>) auf die eines normalen Benutzers (Ihre Benutzer-ID) herabgesetzt werden. Ein Hacker, der versucht, in Ihren Zugang einzubrechen, würde dann Zugang zu den Funktionen von <systemitem class="username"
>root</systemitem
> erhalten. &kdesu; versucht dies zu verhindern. Das Sicherheitskonzept, das benutzt wird, ist angemessen sicher, zumindest nach bestem Wissen des Autors. Das Konzept wird hier weiter erklärt.</para>

<para
>&kdesu; benutzt den Dämon <application
>kdesud</application
>. Der Dämon nimmt auf einem &UNIX;-Socket in <filename
>/tmp</filename
> Befehle entgegen. Die Zugriffsrechte des Sockets sind auf 0600 eingestellt, sodass nur Ihre Benutzer-ID Verbindungen zu dem Socket aufbauen kann. Wurde <quote
>Passwort beibehalten</quote
> aktiviert, führt &kdesu; Befehle durch diesen Dämon aus. &kdesu; schreibt dann den Befehl und das Passwort des Systemverwalters auf den Socket. Der Dämon führt daraufhin, wie oben beschrieben, mit Hilfe von <command
>su</command
> den Befehl aus. Danach werden Befehl und Passwort nicht gelöscht, sondern für eine bestimmte Zeit zwischengespeichert. Diese Zeit wird dem Kontrollmodul entnommen. Erfolgt innerhalb dieser Zeitspanne eine andere Anfrage für den Befehl, muss der Benutzer das Passwort nicht erneut eingeben. Um zu verhindern, dass Hacker, die in Ihren Zugang eingedrungen sind, Passwörter stehlen, wird der Dämon mit den Parametern <quote
>set-group-id nogroup</quote
> eingerichtet. Dies sollte alle normalen Benutzer (Sie eingeschlossen) daran hindern, Passwörter von dem Prozess <application
>kdesud</application
> zu bekommen. Der Dämon setzt außerdem die Umgebungsvariable <envar
>DISPLAY</envar
> auf den Wert, den der Dämon hatte, als er gestartet wurde. Das Einzige, was ein Hacker demnach tun könnte, wäre Anwendungen auf Ihrer Anzeige auszuführen.</para>

<para
>Ein Schwachpunkt in diesem Sicherheitskonzept ist die Tatsache, dass die auszuführenden Programme wahrscheinlich nicht nach Sicherheitsgesichtpunkten geschrieben wurden (z.B. setuid <systemitem class="username"
>root</systemitem
> Programme). Dies bedeutet, dass in diesen Programme Puffer-Überläufe oder andere Probleme auftreten könnten, die ein Hacker ausnützen könnte.</para>

<para
>Die Benutzung der Funktion zum Speichern der Passwörter ist ein Kompromiss zwischen Sicherheitsansprüchen und Komfort. Überdenken Sie dies bitte und entscheiden Sie selbst ob Sie diese Funktion benutzen wollen oder nicht.</para>

</sect1>
</chapter>

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

<para
>&kdesu;</para>

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

<para
>&kdesu; wurde von &Geert.Jansen; geschrieben. Es basiert irgendwie auf Pietro Iglios &kdesu;, Version 0.3. Pietro und Geert Jansen sind übereingekommen, dass Geert Jansen das Programm in Zukunft pflegen wird.</para>

<para
>Der Autor ist unter folgender Adresse zu erreichen: &Geert.Jansen.mail;. Bitte schicken Sie ihm alle Fehler die Sie finden, sodass er Sie entfernen kann. Wenn Sie Vorschläge zu diesem Programm haben, können Sie Geert Jansen gerne anschreiben.</para>
&underFDL; &underArtisticLicense; </chapter>

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

