<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.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
> <firstname
>Geert</firstname
> <surname
>Jansen</surname
> <affiliation
> <address
><email
>g.t.jansen@stud.tue.nl</email
></address
> </affiliation
> </author>

<othercredit role="reviewer">
<firstname
>Lauri</firstname>
<surname
>Watts</surname>
<affiliation>
<address
><email
>lauri@kde.org</email
></address>
</affiliation>
<contrib
>Korrektur</contrib>
</othercredit>
<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. Dies 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 nach dem Passwort des Systemverwalters (<systemitem class="username"
>root</systemitem
>) mit Hilfe eines &GUI;-Dialoges 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
>USER</arg>
      <arg
>-n</arg>
      <arg
>-t</arg>
      <arg
>-q</arg>
      <arg
>-d</arg>
      <arg
>-f <replaceable
>FILE</replaceable
></arg>
      <arg
>-c <group>
	  <arg>
	  <replaceable
>COMMAND</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 unterhalb 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. Wenn Sie z.B. einen KDE-Web-Browser starten wollen, geben Sie auf der Befehlszeile <userinput
> <command
>kdesu <option
>-c <replaceable
>konqueror</replaceable
></option
> </command
></userinput
> ein.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><option
>-f <replaceable
>FILE</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
>FILE</parameter
> angegeben wurde, zu untersuchen. Wenn der aktuelle Benutzer Schreibrechte auf die Datei hat, wird die Datei unter seinem Namen ausgeführt. Wenn er keine Schreibrechte hat, wird die Datei unter dem Benutzernamen <parameter
>USER</parameter
> (Voreinstellung: Systemverwalter) ausgeführt.</para
> <para
><parameter
>FILE</parameter
> wird folgendermaßen ausgewertet: Wenn <parameter
>FILE</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
> </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
>passwords</application
> ausgeliefert. Sie finden dieses Modul im <guimenu
>K</guimenu
>-Menü unter <menuchoice
><guisubmenu
>Einstellungen</guisubmenu
> <guisubmenu
>Persönliche Einstellungen</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 Einstellungsfeld <guilabel
>Passwörter speichern</guilabel
> ankreuzen. In dem Textfeld darunter können Sie angeben, wieviele Minuten lang das Passwort gespeichert werden soll. Standardmäßig werden keine Passwörter 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 ausführen, 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
>Weil manche <command
>su</command
>-Implementierungen (&zb; die von &RedHat;) keine Passwörter von <literal
>StdIn</literal
> lesen, erstellt &kdesu; ein pty/tty-Paar und führt <command
>su</command
> mit den Standard-Dateibeschreibungen aus, die durch das tty übergeben werden.</para>

<para
>Um anstelle einer interaktiven Shell einen Befehl auszuführen, den der Benutzer auswählt, benutzt &kdesu; den Parameter <option
>-c</option
> mit dem Befehl <command
>su</command
>. 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 desjenigen 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 kleine Unterprogramm <application
>kdesu_stub</application
> aus. Dieses Unterprogramm, das unter der ID des Zielbenutzers läuft, fordert einige Informationen von &kdesu; über über den pty/tty Kanal an (stdin und stdout des Unterprogramms). 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 Unterprogramms ist der X-Cookie. Dieser beinhaltet sensible Informationen und kann deshalb nicht über die 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 niemandem außer Ihnen mit Ihrer Benutzer-ID, diese Passwörter zu benutzen. Wenn Sie allerdings nicht aufpassen, kann das Sicherheitslevel des Systemverwalters (<systemitem class="username"
>root</systemitem
>) auf das 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. Wenn <quote
>Passwort beibehalten</quote
> aktiviert wurde, 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 dann mit Hilfe von <command
>su</command
> den Befehl, wie oben beschrieben, aus. Danach werden Befehl und Passwort nicht gelöscht, sondern für eine bestimmte Zeit zwischengespeichert. Diese Zeit wird dem Kontrollmodul entnommen. Wenn jetzt eine andere Anfrage für den Befehl in der angegebenen Zeit kommt, muss der Benutzer das Passwort nicht nochmals 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 diese Programme Puffer-Überläufe oder andere Probleme enthalten 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 ein wenig 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: <email
>g.t.jansen@stud.tue.nl</email
>. 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>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="downloading">
<title
>Herunterladen</title>

&install.intro.documentation;

</sect1>

<sect1 id="compiling">
<title
>Kompilieren</title>

&install.compile.documentation;

</sect1>
</appendix>

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

