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

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

<title
>Il Manuale di &kdesu;</title>

<authorgroup>
<author
>&Geert.Jansen; &Geert.Jansen.mail;</author>
<othercredit role="translator"
><firstname
>Samuele</firstname
><surname
>Kaplun</surname
><affiliation
><address
><email
>samuele.kaplun@collegiodimilano.it</email
></address
></affiliation
><contrib
></contrib
></othercredit
> 
</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2005-06-07</date>
<releaseinfo
>1.00.00</releaseinfo>


<abstract
><para
>&kdesu; è un interfaccia grafica per il comando <command
>su</command
> di &UNIX;.</para
></abstract>

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

</bookinfo>

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

<para
>Benvenuti in &kdesu;! &kdesu; è un'interfaccia grafica per il comando <command
>su</command
> di &UNIX; per l'Ambiente Desktop KDE. Ti permette di lanciare un programma come se tu fossi un altro utente fornendo la password per quell'utente. &kdesu; è un programma senza privilegi; utilizza il comando di sistema <command
>su</command
>.</para>

<para
>&kdesu; ha una funzionalità aggiuntiva: può ricordare le password per te. Se stai usando questa funzionalità, devi solo inserire la password una volta per ogni comando. Guarda <xref linkend="sec-password-keeping"/> per maggiori informazioni al riguardo ed un'analisi sulla sicurezza.</para>

<para
>Questo programma è pensato per essere lanciato dalla linea di comando o dai file  <filename
>.desktop</filename
>. Anche se chiede la password di <systemitem class="username"
>root</systemitem
> utilizzando una finestra di dialogo &GUI;, lo considero più come un collante linea di comando &lt;&gt; &GUI; che come un puro programma &GUI;.</para>

</chapter>

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

<para
>L'utilizzo di &kdesu; è semplice. La sintassi è la seguente:</para>

<cmdsynopsis
><command
>kdesu</command
> <group choice="opt"
><option
>-c</option
></group
> <group choice="opt"
><option
>-d</option
></group
> <group choice="opt"
><option
>-f</option
> <replaceable
> file</replaceable
></group
> <group choice="opt"
><option
>-i</option
> <replaceable
> nome icona</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
> utente</replaceable
></group
> <group choice="opt"
><option
>--nonewdcop</option
></group
> <group
><arg choice="req"
><replaceable
>comando</replaceable
> <arg
><replaceable
>arg1</replaceable
></arg
> <arg
><replaceable
>arg2</replaceable
></arg
> <arg rep="repeat"
><replaceable
></replaceable
></arg
></arg
></group
> </cmdsynopsis>
<cmdsynopsis
><command
>kdesu</command
> <arg choice="opt"
>opzioni generiche di &kde;</arg
> <arg choice="opt"
>opzioni generiche di Qt</arg
> </cmdsynopsis>

<para
>Le opzioni della linea di comando sono spiegate sotto.</para>

<variablelist>
<varlistentry>
<term
><option
>-c <replaceable
>programma</replaceable
></option
></term>
<listitem
><para
>Specifica il programma da lanciare come root. Deve essere passato come unico argomento. Così se, per esempio, vuoi lanciare un nuovo file manager, dovresti inserire alla riga di comando: <userinput
><command
>kdesu <option
>-c <replaceable
>kfm -sw</replaceable
></option
></command
></userinput
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-d</option
></term>
<listitem
><para
>Visualizza le informazioni di debug.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-f <replaceable
>file</replaceable
></option
></term>
<listitem
><para
>Questa opzione permette un uso efficiente di &kdesu; nei file <filename
>.desktop</filename
>. Dice a &kdesu; di esaminare il file specificato da <parameter
>file</parameter
>. Se questo file è scrivibile dall'utente corrente, &kdesu; esegue il comando con l'utente corrente. Se non è scrivibile, il comando viene eseguito con l'utente <parameter
>utente</parameter
> (valore predefinito impostato a root).</para>
<para
><parameter
>file</parameter
> è valutato in questo modo: se <parameter
>file</parameter
> comincia con una <literal
>/</literal
>, viene interpretato come un nome di file assoluto. Altrimenti, viene preso come nome di un file di configurazione globale di &kde;. Per esempio: per configurare il K display manager, <application
>kdm</application
>, puoi invocare <command
>kdesu <option
>-c kdmconfig -f kdmrc</option
></command
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-i</option
> <replaceable
>nome icona</replaceable
></term>
<listitem
><para
>Specifica l'icona da utilizzare nella finestra di dialogo della password. Puoi specificarne semplicemente il nome, senza alcuna estensione.</para>
<para
>Ad esempio per lanciare <command
>kfmclient</command
> e mostrare l'icona di &konqueror; nella finestra di dialogo della password:</para>
<screen
><userinput
><command
>kdesu</command
>  <option
>-i konqueror</option
> <command
>kfmclient</command
></userinput
></screen>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-n</option
></term>
<listitem
><para
>Non memorizzare la password. Disabilita la casella <guilabel
>ricorda password</guilabel
> nella finestra di dialogo della password.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-p</option
> <replaceable
>priorità</replaceable
></term>
<listitem>
<para
>Imposta il valore della priorità. La priorità è un numero arbitrario compreso tra 0 e 100, dove 100 significa la priorità massima e 0 la minima. L'impostazione predefinita è 50.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>-r</option
></term>
<listitem
><para
>Utilizza lo scheduling realtime.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s</option
></term>
<listitem
><para
>Ferma il demone di kdesu. Guarda <xref linkend="sec-password-keeping"/>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-t</option
></term>
<listitem
><para
>Abilita l'output del terminale. Ciò disabilita la memorizzazione della password. È principalmente per scopi di debug; se vuoi lanciare un'applicazione della modalità console, usa piuttosto lo standard <command
>su</command
>.</para
> </listitem>
</varlistentry>
<varlistentry>
<term
><option
>-u</option
> <replaceable
> utente</replaceable
></term>
<listitem
><para
>Anche se l'utilizzo principale di &kdesu; è quello di eseguire un comando come superutente, puoi fornire qualsiasi nome utente e la password appropriata.</para>
</listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="Internals">
<title
>Funzionamento interno</title>

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

<para
>Il programma che eseguirai girerà sotto l'id dell'utente root e non avrà generalmente l'autorità di accedere al tuo schermo di X. &kdesu; vi gira intorno aggiungendo un cookie di Autenticazione per il tuo schermo al file temporaneo <filename
>.Xauthority</filename
>. Dopo che il comando termina, questo file viene rimosso. </para>

<para
>Se non utilizzi i cookie di X, è lasciato a te il lavoro. &kdesu; riconoscerà questa situazione e non aggiungerà un cookie ma dovrai assicurarti che l'utente root abbia il permesso di accedere al tuo schermo.</para>

</sect1>

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

<para
>&kdesu; utilizza il comando di sistema <command
>su</command
> per acquisire privilegi. In questa sezione, spiegherò i dettagli di come &kdesu; fa ciò. </para>

<para
>Dato che alcune implementazioni di <command
>su</command
> (ad esempio quella di &RedHat;) non vogliono leggere la password da <literal
>stdin</literal
>, &kdesu; crea una coppia pty/tty ed esegue <command
>su</command
> con i suoi descrittori di file standard connessi alla tty.</para>

<para
>Per eseguire il comando che l'utente seleziona, piuttosto che in una shell interattiva, &kdesu; utilizza l'argomento <option
>-c</option
> con <command
>su</command
>. Questo argomento è compreso da ogni shell che conosco quindi dovrebbe funzionare in maniera portabile. <command
>su</command
> passa l'argomento <option
>-c</option
> alla shell dell'utente target, e la shell esegue il programma. Esempio di comando: <command
>su <option
>root -c <replaceable
>il_programma</replaceable
></option
></command
>.</para>

<para
>Invece di eseguire il comando dell'utente direttamente con <command
>su</command
>, &kdesu; esegue un piccolo programma di comodo chiamato <application
>kdesu_stub</application
>. Questo programma di comodo (che gira come utente target), richiede alcune informazioni da &kdesu; attraverso il canale pty/tty (lo stdin e stdout del programma di comodo) e poi esegue il programma dell'utente. Le informazioni che vengono passate sono: il display X, un cookie di Autenticazione di X (se disponibile), il <envar
>PATH</envar
> ed il comando da lanciare. La ragione per cui è usato un programma di comodo è che il cookie di X è un'informazione privata e non può quindi essere passata sulla linea di comando.</para>

</sect1>

<sect1 id="password-checking">
<title
>Verifica della Password</title>

<para
>&kdesu; verificherà la password che immetti e restituirà un messaggio di errore se non è corretta. La verifica viene effettuata eseguendo un programma di test: <filename
>/bin/true</filename
>. Se ciò ha successo, la password è considerata corretta.</para>

</sect1>

<sect1 id="sec-password-keeping">
<title
>Memorizzare la Password</title>

<para
>Per comodità, &kdesu; implementa una funzionalità di <quote
>ricorda password</quote
>. Se ti interessa la sicurezza, dovresti leggere questo paragrafo.</para>

<para
>Permettere a &kdesu; di ricordare le password apre un (piccolo) buco di sicurezza nel tuo sistema. Ovviamente, &kdesu; non permette a chiunque ma solo al tuo id utente di usare le password, ma, se fatto senza cautela, ciò abbasserebbe il livello di sicurezza di <systemitem class="username"
>root</systemitem
> a quello dell'utente normale (tu). Un hacker che irrompe nel tuo account, otterrebbe l'accesso di <systemitem class="username"
>root</systemitem
>. &kdesu; cerca di prevenire ciò. Lo schema di sicurezza che utilizza, almeno secondo me, è ragionevolmente sicuro ed è qui spiegato.</para>

<para
>&kdesu; utilizza un demone, chiamato <application
>kdesud</application
>. Il demone sta in ascolto di comandi ad un socket &UNIX; in <filename
>/tmp</filename
>. I permessi del socket sono 0600 così che solo il tuo id utente può connettervisi. Se è attivata la memorizzazione delle password, &kdesu; esegue il comando attraverso questo demone. Scrive il comando e la password di <systemitem class="username"
>root</systemitem
> a questo socket e il demone esegue il comando utilizzando <command
>su</command
>, come descritto sopra. Fatto questo, il comando e la password non sono gettati via. Sono, invece, memorizzati per una quantità di tempo specificata. Questo è il valore di timeout del modulo di controllo. Se un'altra richiesta per lo stesso comando arriva entro questo periodo di tempo, il client non deve fornire nuovamente la password. Per evitare che gli hacker che irrompono nel tuo account rubino le password dal demone (per esempio, connettendo un debugger), il demone è installato con l'id di gruppo nogroup. Questo previene tutti i normali utenti (inclusi tu) dall'ottenere password dal processo <application
>kdesud</application
>. Inoltre il demone imposta la variabile di ambiente <envar
>DISPLAY</envar
> al valore che aveva quando è stato lanciato. L'unica cosa che un hacker può fare è eseguire un applicazione sul tuo display.</para>

<para
>Un punto debole in questo schema è che i programmi che esegui, probabilmente, potrebbero non essere stati scritti con la sicurezza in mente (come i programmi <systemitem class="username"
>setuid</systemitem
> root). Questo significa che potrebbero avere dei buffer overrun o altri problemi ed un hacker potrebbe sfruttarli.</para>

<para
>L'utilizzo della memorizzazione delle password è un compromesso tra la sicurezza e la comodità. Ti incoraggio a pensarci e a decidere tu stesso se vuoi usarlo o no.</para>

</sect1>
</chapter>

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

<para
>&kdesu;</para>

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

<para
>&kdesu; è scritto da &Geert.Jansen;. È in qualche modo basato su &kdesu; di Pietro Iglio, versione 0.3. Io e Pietro siamo d'accordo che io manterrò il programma nel futuro.</para>

<para
>L'autore può essere raggiunto via email a&Geert.Jansen.mail;. Per favore, riferiscimi ogni bug che trovi così che li possa riparare. Se hai dei suggerimenti, sentiti libero di contattarmi.</para>
&underFDL; &underArtisticLicense; </chapter>

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

