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

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

<title
>&kdesu; käsiraamat</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
>Korrigeerija</contrib>
</othercredit>
<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@online.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</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; on &UNIX; käsu <command
>su</command
> graafiline kasutajaliides.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>su</keyword>
<keyword
>parool</keyword>
<keyword
>administraator</keyword>
</keywordset>

</bookinfo>

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

<para
>Tere tulemast kasutama &kdesu;d! &kdesu; on &UNIX; käsu <command
>su</command
> graafiline kasutajaliides KDE töölaua keskkonnas.See võimaldab käivitada rakendusi teise kasutajana, andes vastava kasutaja parooli. &kdesu; on privileegideta rakendus, see kasutab süsteemi käsku <command
>su</command
>.</para>

<para
>&kdesu;l on aga üks lisavõimalus: ta võib parooli sinu eest meeles pidada. Seda võimalust kasutades tuleb parool sisestada ainult üks kord. Sellest räägib lähemalt <xref linkend="sec-password-keeping"/>, kus on ka hinnatud selle turvalisust.</para>

<para
>Rakendust saab käivitada käsurealt või <filename
>.desktop</filename
>-faile avades. Kuigi see pärib <systemitem class="username"
>adminstraator</systemitem
>i parooli &GUI; dialoogis, pean ma ise seda rohkem käsurea &lt;&gt; &GUI; seguks kui puhtaks &GUI; rakenduseks.</para>

</chapter>

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

<para
>kdesu; kasutamine on väga lihtne. Süntaks näeb välja selline:</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
>Käsurea võtmeid selgitatakse allpool.</para>

<variablelist
> <varlistentry
> <term
><option
>-c <replaceable
>RAKENDUS</replaceable
></option
></term
> <listitem
><para
>Määrab rakenduse käivatama administraatori õiguses. See tuleb anda ühe argumendina. Kui näiteks soovid käivitada uut failihaldurit, tuleb käsureale kirjutada <userinput
><command
>kdesu <option
>-c <replaceable
>kfm -sw</replaceable
></option
></command
></userinput
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><option
>-f <replaceable
>FAIL</replaceable
></option
></term
> <listitem
><para
>Võimaldab kasutada &kdesu;d tõhusalt <filename
>.desktop</filename
>-failide puhul, käskides &kdesu;l uurida faili, mille nimi on antud parameetriga <parameter
>FAIL</parameter
>. Kui käsuandjal on sellel failil kirjutamisõigus, käivitab &kdesu; faili kasutaja õigustes. Kui aga mitte, käivitatakse käsk kasutajana <parameter
>USER</parameter
> (vaikimisi administraator).</para
> <para
>Parameetrit <parameter
>FAIL</parameter
> võib hinnata järgmiselt: kui <parameter
>FAIL</parameter
> algab märgiga <literal
>/</literal
>, on see absoluutne failinimi. Muul juhul peetakse seda &kde; globaalse seadistustefaili nimeks. Näiteks K kuvahalduri <application
>kdm</application
> seadistamiseks tuleb anda käsk <command
>kdesu <option
>-c kdmconfig -f kdmrc</option
></command
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><option
>-t</option
></term
> <listitem
><para
>Võimaldab terminaliväljundi ning tühistab parooli säilitamise võimaluse. See on peamiselt mõeldud silumiseks, kui soovid käivitada konsoolirežiimis rakendust, kasuta parem tavapärast <command
>su</command
> käsku.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><option
>-n</option
></term
> <listitem
><para
>Parooli ei säilitata. See muudab märkekasti <guilabel
>Säilita parool</guilabel
> mittekasutatavaks.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><option
>-q</option
></term
> <listitem
><para
>Vaikne, kommentaarideta režiim.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><option
>-d</option
></term
> <listitem
><para
>Näitab silumisinfot.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><option
>-v</option
></term
> <listitem
><para
>Näitab versiooni infot ja väljub.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><option
>-h</option
></term
> <listitem
><para
>Näitab abi.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><option
>-s</option
></term
> <listitem
><para
>Peatab kdesu deemoni. Lähemalt räägib sellest <xref linkend="sec-password-keeping"/>.</para
></listitem
> </varlistentry
> </variablelist>

</chapter>

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

<para
>&kdesu; käib käsikäes juhtmismooduliga <application
>kcmkdesu</application
>. Selle leiab <guimenu
>K</guimenu
> menüü alammenüüst <menuchoice
><guisubmenu
>Seadistused</guisubmenu
><guisubmenu
>Rakendused</guisubmenu
><guimenuitem
>KDE su</guimenuitem
></menuchoice
>. Muuta on võimalik järgmisi asju:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Kajarežiim (echo)</guilabel
></term
> <listitem
><para
>Määrab selle, kuidas kirjutatud märgil ekraanil välja näevad. Võimalikud valikud on: üks tärn märgi kohta, kolm tärni või kaja puudumine. Vaikevalik on üks tärn märgi kohta.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Paroolide säilitamine</guilabel
></term
> <listitem
><para
>&kdesu;le saab anda korralduse pidada meeles sisestatud paroole, märkide selleks ära kasti <guilabel
>Säilita parool</guilabel
>. Kui see on märgitud, saab allasuvale tekstiväljale sisestada aegumisväärtuse. See on ajahulk minutites, mille jooksul parool meeles peetakse. Vaikimisi paroole ei säilitata.</para
></listitem
> </varlistentry
> </variablelist>

</chapter>

<chapter id="Internals">
<title
>Siseelu</title>

<sect1 id="x-authentication">
<title
>X'i autentimine</title>

<para
>Käivitatav rakendus töötab administraatori id-ga ning üldiselt ei ole sel ligipääsuõigust X'ile. &kdesu; saab sellest aga üle, lisades autentimisküpsise ajutisele <filename
>.Xauthority</filename
>-failile. Käsu lõppemisega fail kustutatakse. </para>

<para
>Kui sa X'i küpsiseid ei kasuta, ei ole midagi teha. &kdesu; avastab selle ega lisa küpsist, aga siis pead ise tagama, et administraatoril oleks ligipääs X'i seansile.</para>

</sect1>

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

<para
>&kdesu; kasutab privileegide hankimiseks süsteemi <command
>su</command
> käsku. Siin seletan lähemalt, kuidas &kdesu; seda teeb. </para>

<para
>Kuna mõned <command
>su</command
> versioonid (&ie; seesamune &RedHat; oma) ei taha parooli lugeda <literal
>stdin</literal
>-ist, loob &kdesu; pty/tty paari ning käivitab <command
>su</command
> standardsete tty-ga seotud failikirjendajatega.</para>

<para
>Kasutaja antud käsu käivitamiseks kasutab &kdesu; <command
>su</command
> juures võtit <option
>-c</option
>. Seda argumenti tunnistavad kõik shellid, mida ma vähegi tean, nii et see peaks kõikjal toimima. <command
>su</command
> edastab argumendi <option
>-c</option
> sihtshellile ning see käivitab rakenduse. Näide: <command
>su <option
>root -c<replaceable
>rakendus</replaceable
></option
></command
>.</para>

<para
>Selle asemel, et käivita kasutaja antud käsk vahetult <command
>su</command
>-ga, käivitab &kdesu; väikese tüverakenduse nimetusega <application
>kdesu_stub</application
>. See tüvi (töötab sihtkasutajana) nõuab &kdesu;lt mõningat infot pty/tty kanali kaudu (tüve stdin ja stdout) ning käivitab siis kasutaja rakenduse. Saadetavaks infoks on: X'i seanss, X'i autentimisküpsis (kui on olemas), muutuja <envar
>PATH</envar
> ja käivitatav käsk. Tüve kasutamise põhjuseks on see, et X'i küpsis kujutab endast varjatud infot, mida ei saa edastada käsureal.</para>

</sect1>

<sect1 id="password-checking">
<title
>Parooli kontroll</title>

<para
>&kdesu; kontrollib sisestatud parooli ning annab veateate, kui see pole korrektne. Kontrollimiseks käivitatakse testprogramm: <filename
>/bin/true</filename
>. Kui see õnnestub, peetakse parooli õigeks.</para>

</sect1>

<sect1 id="sec-password-keeping">
<title
>Parooli säilitamine</title>

<para
>Puhtalt kasutaja mugavuse huvides kasutab &kdesu; võimalust <quote
>Säilita parool</quote
>. Kui sulle on aga oluline turvalisus, peaksid selle osa hoolikalt läbi lugema.</para>

<para
>Luba &kdesu;l parooli säilitada avab (kuigi väikese) turvaaugu sinu süsteemis. On selge, et &kdesu; lubab paroole kasutada ainult sinu kasutaja-id-ga, kuid kui siin ettevaatlikkust ei ilmutata, võrdsustab see <systemitem class="username"
>administraator</systemitem
>i turvataseme tavakasutaja omaga. Sinu kontole sisse murdev häkekr saab sel moel muidu <systemitem class="username"
>administraator</systemitem
>ile lubatud õigused. &kdesu; püüab seda vältida. Kasutatav turvaskeem on vähemalt minu hinnangul mõistuse piires turvaline.</para>

<para
>&kdesu; kasutab deemonit nimetusega <application
>kdesud</application
>. See deemon uurib &UNIX; soklit <filename
>/tmp</filename
>-s käskude saamiseks. Sokli režiim on 0600, nii et sellega saab ühendust ainult kasutaja id-ga. Kui parooli säilitamine on lubatud, käivitab &kdesu; käsud deemoni kaudu. See kirjutab käsu ja <systemitem class="username"
>administraator</systemitem
>i parooli soklile ning deemon käivitab käsu <command
>su</command
> abil, nagu eespool kirjeldatud. Seejärel ei kustutata kohe käsku ja parooli, vaid need hoitakse teatud aeg alles. See ongi seadistusmoodulis määratav aegumisväärtus. Kui selle jooksul saabub sama käsk uuesti, ei ole kliendil vaja parooli uuesti sisestada. Häkkerite eemalhoidmiseks, kes võivad sinu kontole sisse murda ja deemonilt paroole varastada (näiteks seda silujaga ühendades), on deemon loonud set-group-id nogroup'i. See peaks takistama kõigil tavakasutajatel (ka sinul endal) hankimast paroole <application
>kdesud</application
> protsessilt. Deemon määrab ka keskkonnamuutuja <envar
>DISPLAY</envar
> väärtuseks käivitusaegse väärtuse. Sellisel juhul on ainus asi, mida häkker saab teha, rakenduse käivitamine sinu seansis.</para>

<para
>Selle skeemi nõrgaks kohaks on asjalu, et rakendused, mida sa käivitad, et ole tõenäoliselt loodud turvalisust silmas pidades (nagu setuid <systemitem class="username"
>root</systemitem
> rakendused). See tähendab, et neil võib esineda puhvri ületäide või muid probleeme, mida häkkerid saavad ära kasutada.</para>

<para
>Parooli säilitamise võimalus on kompromiss turvalisuse ja mugavuse vahel. Soovitan väga tungivalt sellele mõelda ja ise otsustada, kas seda kasutada või mitte.</para>

</sect1>
</chapter>

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

<para
>&kdesu;</para>

<para
>Copyright 2000 Geert Jansen</para>

<para
>&kdesu; kirjutas Geert Jansen. Selle aluseks on mõneti Pietro Iglio &kdesu; versioon 0.3, Me leppisime Pietroga kokku, et edaspidi olen selle hooldaja mina.</para>

<para
>Autoriga saab ühendust võtta meilitsi: <email
>g.t.jansen@stud.tue.nl</email
>. Palun anna mulle teada kõigist leitud vigadest, et saaksin need ära parandada. Aga kirjuta ka siis, kui sul on hea mõte, kuidas midagi võiks paremaks muuta.</para>

&underFDL;
&underArtisticLicense;

</chapter>

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

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

&install.intro.documentation;

</sect1>

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

&install.compile.documentation;

</sect1>
</appendix>

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

