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

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

<title
>O manual do &kdesu;</title>

<authorgroup>
<author
>&Geert.Jansen; &Geert.Jansen.mail;</author>
<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus_gama@uol.com.br</email
></address
></affiliation
><contrib
>Tradução</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
>O &kdesu; é um frontend gráfico para o comando &UNIX; <command
>su</command
>.</para
></abstract>

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

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>Bem vindo ao &kdesu;! O &kdesu; é um frontend gráfico para o comando &UNIX; <command
>su</command
> no Ambiente de Desktop K. Ele permite-lhe executar um programa como um usuário diferente fornecendo a senha deste usuário. O &kdesu; é um programa se privilégios especiais; ele usa o <command
>su</command
> do sistema.</para>

<para
>O &kdesu; possui um recurso adicional: ele pode lembrar-se da senha para você. Se você usar este recurso, você somente precisará inserir a senha uma vez para cada comando. Veja <xref linkend="sec-password-keeping"/> para mais informações sobre isto e uma análise de segurança.</para>

<para
>Este programa deve ser iniciado a partir da linha de comando ou de arquivos <filename
>.desktop</filename
>. Apesar dele solicitar pela senha do <systemitem class="username"
>root</systemitem
> usando um diálogo &GUI;, eu o considero mais como uma linha de comando &lt;-&gt; colada a uma &GUI; do que um programa puramente &GUI;.</para>

</chapter>

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

<para
>O uso do &kdesu; é fácil. A sintaxe é parecida com isto:</para>

    <cmdsynopsis
><command
>kdesu</command
> <arg
>USUÁRIO</arg
> <arg
>-n</arg
> <arg
>-t</arg
> <arg
>-q</arg
> <arg
>-d</arg
> <arg
>-f <replaceable
>ARQUIVO</replaceable
></arg
> <arg
>-c <group
> <arg
> <replaceable
>COMANDO</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
>As opções de linha de comando são explanadas abaixo.</para>

<variablelist>
<varlistentry>
<term
><option
>-c <replaceable
>PROGRAMA</replaceable
></option
></term>
<listitem
><para
>Isto especifica o programa a executar como root. Ele deve ser passado em um argumento. Logo se, por exemplo, você deseja iniciar um novo gerenciador de arquivo, você deverá inserir no console: <userinput
><command
>kdesu <option
>-c <replaceable
>kfm -sw</replaceable
></option
></command
></userinput
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-f <replaceable
>ARQUIVO</replaceable
></option
></term>
<listitem
><para
>Esta opção permite o uso eficiente do &kdesu; em arquivos <filename
>.desktop</filename
>. Ela diz ao &kdesu; para examinar o arquivo especificado por <parameter
>ARQUIVO</parameter
>. Se este arquivo é gravável pelo usuário atual, o &kdesu; executará o comando como usuário atual. Se ele não for gravável, o comando será executado como usuário <parameter
>USUÁRIO</parameter
> (o padrão para root).</para>
<para
><parameter
>ARQUIVO</parameter
> é avaliado da seguinte maneira: se <parameter
>ARQUIVO</parameter
> inicia com um <literal
>/</literal
>, ele é tomado como um nome de arquivo absoluto. Caso contrário, ele é tomado como o nome de um arquivo global de configuração do &kde;. Por exemplo: para configurar o gerenciador de tela K, <application
>kdm</application
>, você deve digitar <command
>kdesu <option
>-c kdmconfig -f kdmrc</option
></command
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-t</option
></term>
<listitem
><para
>Habilita a saída para o terminal. Isto desabilita a manutenção da senha. Isto é largamente usado para fins de depuração; se você deseja executar um aplicativo no modo console, use o <command
>su</command
> padrão de preferência.</para
> </listitem>
</varlistentry>
<varlistentry>
<term
><option
>-n</option
></term>
<listitem
><para
>Não mantém a senha. Isto desabilita a caixa de verificação <guilabel
>manter senha</guilabel
> no diálogo de senha.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-q</option
></term>
<listitem
><para
>Seja silencioso.</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
>Mostre informações de depuração.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-v</option
></term>
<listitem
><para
>Imprime informações da versão e sai.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-h</option
></term>
<listitem
><para
>Imprime alguma ajuda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>-s</option
></term>
<listitem
><para
>Para o serviço do kdesu. Veja <xref linkend="sec-password-keeping"/>.</para
></listitem>
</varlistentry>
</variablelist>

</chapter>

<chapter id="configuration">
<title
>Configuração</title>

<para
>O &kdesu; vem com um módulo de controle chamado <application
>kcmkdesu</application
>. Você pode encontrá-lo no menu <guimenu
>K</guimenu
> em <menuchoice
><guisubmenu
>Configurações</guisubmenu
> <guisubmenu
>Aplicativos</guisubmenu
> <guimenuitem
>su do KDE</guimenuitem
></menuchoice
>. Você pode mudar as seguintes coisas:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Modo de Eco</guilabel
></term>
<listitem
><para
>Este é como os caracteres que você digita são ecoados na tela. Possíveis escolhas são: um asterisco por caracter, três asteriscos ou nenhum eco. O padrão é um asterisco por caracter.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Mantendo senhas</guilabel
></term>
<listitem
><para
>Você pode instruir ao &kdesu; para se lembrar das senhas inseridas habilitando a caixa de verificação <guilabel
>manter senha</guilabel
>. Se ela estiver habilitada, você pode inserir um valor de espera no campo abaixo dela. Este é a quantidade de tempo, em minutos, que a senha será lembrada. O padrão é não lembrar senhas.</para
></listitem>
</varlistentry>
</variablelist>

</chapter>

<chapter id="Internals">
<title
>Mecanismos Internos</title>

<sect1 id="x-authentication">
<title
>Autenticação X</title>

<para
>O programa que você executa rodará com o id do usuário root e normalmente não terá permissão de acesso ao seu terminal X. O &kdesu; contorna isto adicionando um cookie de autenticação para seu terminal para um arquivo <filename
>.Xauthority</filename
> temporário. Após o comano terminar, este arquivo será removido. </para>

<para
>Se você não usa cookies X, você estará em seu próprio. O &kdesu; detectará isso e não adicionará um cookie, mas você terá que certificar-se de que o root tem permissão de acesso ao seu terminal.</para>

</sect1>

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

<para
>O &kdesu; usa o <command
>su</command
> do sistema para adquirir privilégios. Nesta seção, eu explanarei os detalhes de como o &kdesu; faz isso. </para>

<para
>Por causa de algumas implementações do <command
>su</command
> (&ie; a do &RedHat;) não permitirem a leitura de senhas a partir do <literal
>stdin</literal
>, o &kdesu; cria um par de pty/tty e executa o <command
>su</command
> com seus descritores de arquivo padrão conectados ao tty.</para>

<para
>Para executar o comando o usuário selecionado, ao contrário de um shell interativo, o &kdesu; usa o argumento <option
>-c</option
> com o <command
>su</command
>. Este argumento é entendido por todo shell que eu conheço de modo que ele deve funcionar corretamente. O <command
>su</command
> passa este argumento <option
>-c</option
> para o shell alvo do usuário, e o shell executa o programa. Comando exemplo: <command
>su <option
>root -c <replaceable
>o_programa</replaceable
></option
></command
>.</para>

<para
>Ao invés de executar o comando do usuário diretamente com o <command
>su</command
>, o &kdesu; executa um pequeno programa chamado <application
>kdesu_stub</application
>. Este programa (executado como usuário alvo), solicita algumas informações do &kdesu; através do canal pty/tty (o stdin e stdout do programa) e então executa o programa do usuário. A informação passada é: o terminal X, um cookie de autenticação X (se disponível), o <envar
>PATH</envar
> e o comando a executar. A razão pela qual este pequeno programa é usado é que o cookie X é uma informação privada e deste modo não pode ser passado através da linha de comando.</para>

</sect1>

<sect1 id="password-checking">
<title
>Verificação da Senha</title>

<para
>O &kdesu; verificará a senha que você inseriu e fornecerá uma mensagem de erro se ela não estiver correta. A verificação é feita executando um programa de teste: <filename
>/bin/true</filename
>. Se ele funcionar, a senha é assumida como correta.</para>

</sect1>

<sect1 id="sec-password-keeping">
<title
>Mantendo a Senha</title>

<para
>Para seu conforto, o &kdesu; implementou um recurso para <quote
>manter senha</quote
>. Se você está preocupado com a segurança, você deve ler este parágrafo.</para>

<para
>Permitindo ao &kdesu; lembrar-se da senha abre uma (pequena) janela na segurança de seu sistema. Obviamente, o &kdesu; não permitirá ninguém além de seu id de usuário usar as senhas, mas, se feito com cautela, isto diminuirá o nível de segurança do <systemitem class="username"
>root</systemitem
> para o de um usuário normal (você). Um hacker que quebre sua conta, poderá obter acesso de <systemitem class="username"
>root</systemitem
>. O &kdesu; tenta evitar isto. O esquema de segurança que ele usa é, em minha opinião pelo menos, razoavelmente segura e está explanado aqui.</para>

<para
>O &kdesu; usa um serviço, chamado <application
>kdesud</application
>. O serviço procura num soquete &UNIX; no <filename
>/tmp</filename
> por comandos. O modo do soquete é 0600 de modo que somente seu id de usuário pode conectar à ele. Se a manutenção de senha estiver habilitada, o &kdesu; executa comandos através deste serviço. Ele escreve o comando e a senha do <systemitem class="username"
>root</systemitem
> no soquete e o serviço executa o comando usando o <command
>su</command
>, como descrito anteriormente. Após isso, o comando e a senha não são jogados fora. Ao invés disso, eles são mantidos por um determinado período de tempo. Este é o valor do tempo de espera do módulo de controle. Se outra solicitação para o mesmo comando vier dentro deste período de tempo, o cliente não precisará fornecer a senha. Para impedir que hackers que possam quebrar sua conta roubem senhas do serviço (por exemplo, atacando um depurador), o serviço é instalado com o id de grupo nogroup. Isto deve evitar que todos os usuários normais (incluindo você) obtenha a senha a partir do processo <application
>kdesud</application
>. Além disso, o serviço configurar a variável de ambiente <envar
>DISPLAY</envar
> para o valor que ela tinha quando ele iniciou. A única coisa que o hacker pode fazer é executar um aplicativo em sua tela.</para>

<para
>Um ponto fraco neste esquema é que os programas que você executa provavelmente não foram escritos com a segurança em mente (como programas setuid <systemitem class="username"
>root</systemitem
>). Isto significa que eles podem ter sobrecargas de buffer ou outros problemas e um hacker pode explorá-los.</para>

<para
>O uso do recurso de manter a senha é um disputa entre segurança e conforto. Eu o encorajo a pensar no que foi dito acima e decidir por si mesmo se deseja usá-lo ou não.</para>

</sect1>
</chapter>

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

<para
>&kdesu;</para>

<para
>Direito de cópia 2000 &Geert.Jansen;</para>

<para
>O &kdesu; é escrito por &Geert.Jansen;. Ele foi em parte baseado no &kdesu; versão 3.0 de Pietro Iglio. Pietro e eu concordamos em manter este programa no futuro.</para>

<para
>O autor pode ser encontrado através do email em &Geert.Jansen.mail;. Por favor, relate qualquer erro que encontrar para mim de modo que eu possa concertá-lo. Se você tiver uma sugestão, sinta-se à vontade para contatar-me.</para>
&underFDL; &underArtisticLicense; </chapter>

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

