>Os sistemas operativos &UNIX; são talvez mais conhecidos pelo seu papel nos servidores. Pode ser difícil, contudo, para os utilizdoress configurarem os ficheiros necessários para gerir esses serviços. Ao mesmo tempo, muitos dos distribuidores compensam essa dificuldade lançando sistemas que por omissão têm configurações demasiado permissivas.</para>
<para
>O &kwuftpd; é uma interface do &kde; para editar os ficheiros ftpaccess do <application
>wu-ftpd</application
>. O &kwuftpd; foi desenhado originalmente para o <application
>BeroFTPD</application
> 1.2.1 e foi adaptado à versão 2.6.1 do <application
>wu-ftpd</application
> encontrada na versão 7.0 do &RedHat; Linux. Se estás a usar uma versão mais recente do <application
>wu-ftpd</application
> com mais opções terás de actualizar o teu &kwuftpd; (ou editar o <filename
>ftpaccess</filename
> à mão) para tirares partido dela.</para>
<warning
><para
>O &kwuftpd; ainda é beta; deves fazer uma cópia de segurança do teu ficheiro ftpaccess antes de o editares com o &kwuftpd;.</para
></warning>
<para
>O &kwuftpd; foi criado pelo Bernhard Rosenkraenzer <email
>bero@redhat.com</email
> e é (c) 2000 &RedHat; Inc.</para>
<sect1 id="disclaimer">
<title
>Avisos</title
>
<para
>Para além dos avisos normais que vêm com o software (<quote
>Não nos responsabilizamos por algum mal que possa ocorrer.</quote
>), deve ser apontado que o &kwuftpd; controla a possibilidade dos utilizdoress se ligarem ao teu sistema e adicionarem, removerem ou modificarem ficheiros. Algumas coisas a ter em conta:</para>
<itemizedlist
> <listitem
><para
>O &kwuftpd; facilita a criação dum servidor seguro -- não garante que fique como tal. Existe uma quantidade de livros, 'sites' Web e cursos sobre segurança e os administradores devem tirar partido deles.</para
></listitem
> <listitem
><para
>Os exemplos dados nesta documentação pretendem mostrar a operação do &kwuftpd;. Não são recomendações de segurança e não devem ser tratadas como tal.</para
></listitem
> <listitem
><para
>Não te esqueças de salvaguardar o ficheiro <filename
>ftpaccess</filename
> antes de o modificares com o &kwuftpd;.</para
></listitem
> </itemizedlist>
</sect1>
</chapter>
<chapter id="basic-ftp-setup">
<title
>Configuração básica de &FTP;</title>
<para
>O &kwuftpd; só vale a pena num sistema com um servidor de &FTP; funcional. A configuração dum servidor está fora do âmbito deste documento, mas como resumo:</para>
<procedure
> <step
><para
>o <application
>wu-ftpd</application
> ou um servidor de &FTP; semelhante devem estar instalados. O pacote <application
>anonftp</application
> também pode ser útil para permitir o &FTP; anónimo.</para
>Descomenta esta linha retirando o # do início da linha. Se o teu sistema não tinha a linha comentada, aceita como um aviso e comenta os outros serviços que não quiseres. Reinicia o <filename
>/etc/inetd.conf</filename
> (através de <userinput
><command
>/etc/rc.d/init.d/inet restart</command
></userinput
> na linha de comandos do &RedHat; e sistemas semelhantes.) </para
></step
> </procedure>
</chapter>
<chapter id="using-kwuftpd">
<title
>Usar o &kwuftpd;</title>
<sect1 id="starting-kwuftpd">
<title
>Iniciar o &kwuftpd;</title>
<para
>Para lançares o &kwuftpd;, selecciona <menuchoice
><guisubmenu
>Sistema</guisubmenu
> <guisubmenu
>Mais Aplicações</guisubmenu
> <guimenuitem
>KWuFTPd</guimenuitem
></menuchoice
> do menu do &kde;. Ou escreve <userinput
><command
>kwuftpd</command
></userinput
> na linha de comandos. Estão disponíveis as opções normais do &Qt; e do &kde;, e são mostradas escrevendo <userinput
><command
>kwuftpd</command
> <option
>--all</option
></userinput
>.</para>
</sect1>
<sect1 id="about-ftp-accounts">
<title
>Acerca das contas de &FTP;</title>
<para
>O &kwuftpd; normalmente pergunta ao utilizador para distinguir entre três tipos de utilizdoress:</para>
<variablelist
> <varlistentry
> <term
>Anónimo</term
> <listitem
> <para
>Para usar por qualquer pessoa que possa ligar-se ao servidor; estes utilizdoress ligam-se como <userinput
>ftp</userinput
> ou <userinput
>anonymous</userinput
> e indicam como senha o seu endereço de email.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Convidado</term
> <listitem
> <para
>Os utilizdoress com contas de &FTP; no <filename
>/etc/ftpusers</filename
> mas que não tenham contas reais no sistema.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Real</term
> <listitem
> <para
>Utilizadores com contas (áreas) no sistema.</para
> </listitem
> </varlistentry
> </variablelist>
</sect1>
<sect1 id="menuref">
<title
>Comandos do Menu</title>
<sect2 id="file-menu">
<title
>O menu <guimenu
>Ficheiro</guimenu
></title>
<variablelist
> <varlistentry
> <term
><menuchoice
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Ler o /etc/ftpaccess</guimenuitem
> </menuchoice
></term
> <listitem
><para
>Abre o <filename
>/etc/ftpaccess</filename
>, o ficheiro normal de configuração do <application
>wu-ftpd</application
>, para o editar.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Ler Outro Ficheiro</guimenuitem
> </menuchoice
></term
> <listitem
><para
>Abre um ficheiro diferente para o editar. É útil se quiseres experimentar com um ficheiro diferente antes de tornares efectivas as alterações no <filename
>/etc/ftpaccess</filename
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Gravar o /etc/ftpaccess</guimenuitem
> </menuchoice
></term
> <listitem
><para
><action
>Grava as alterações</action
> no ficheiro <filename
>/etc/ftpaccess</filename
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Gravar Outro Ficheiro</guimenuitem
> </menuchoice
></term
> <listitem
><para
><action
>Grava as alterações noutro ficheiro a especificar.</action
>Este painel permite-te criar classes de utilizdoress para certos endereços <acronym
>IP</acronym
> ou blocos de endereços e controlar os privilégios dessas classes. Por exemplo, isto permite-te dar aos utilizdoress anónimos ou convidados mais permissões se estes se ligarem de certas máquinas.</para>
<para
>Para criares uma nova classe, carrega no botão <guibutton
>Adicionar Classe</guibutton
> e, na janela resultante disso, indica o nome da nova classe, os níveis de privilégios que podem pertencer a essa classe (mais acerca disto em baixo) e os endereços <acronym
>IP</acronym
> para essa classe. Um carácter <userinput
>*</userinput
> pode ser usado para definir um bloco de endereços. (Por exemplo <userinput
>127.0.0.*</userinput
> inclui todos os utilizdoress locais). Logo que esteja pronto, carrega em <guibutton
>OK</guibutton
>.</para>
<para
>De volta ao painel <guilabel
>Classes de Utilizadores</guilabel
>, podes seleccionar uma classe e modificar a sua descrição e comportamento. O endereço <acronym
>IP</acronym
> pode ser modificado. A classe pode ser definida para incluir os utilizdoress anónimos, convidados e/ou reais desse endereço. Carregando no botão <guilabel
>Auto-agrupar em</guilabel
> faz com que os utilizdoress na classe sejam atribuídos ao grupo seleccionado e conferidos os seus privilégios.</para>
<para
>O lado direito do painel permite atribuir às classes limites no número de ligações simultâneas em certos intervalos de tempo. Podes também especificar a mensagem a mostrar quando o limite de utilizdoress é excedido.</para>
<para
>Na imagem, os utilizdoress reais que se ligam a partir de 127.0.0.* são auto-agrupados ao <quote
>jsinger</quote
> e só é permitido um utilizador dessa classe em cada momento.</para>
>Este painel permite-te especificar a directoria de base para os utilizdoress anónimos e convidados (os utilizdoress reais vêem o sistema de ficheiros reais). Também te permite especificar a senha e os ficheiros de senhas 'shadow' a serem usados. Se não for especificado um ficheiro, será usado o ficheiro de sistema por omissão.</para>
<para
>Na imagem, os utilizdoress anónimos vêem o sistema de ficheiros com a sua base em <filename class="directory"
>/home/ftp/pub</filename
>, enquanto que os convidados têm acesso por omissão. São usados ficheiros de senhas de &FTP; especiais em vez dos ficheiros de sistema.</para>
>Este painel permite-te definir várias opções de segurança. A janela <guilabel
>Inacessíveis</guilabel
> define quais os ficheiros ou directorias que não podem ser obtidos. Carrega no botão <guibutton
>Adicionar</guibutton
> e selecciona o ficheiro a ser bloqueado. Selecciona uma entrada e carrega em <guibutton
>Remover</guibutton
> para tirares o ficheiro da lista.</para>
<para
>O <guilabel
>Número máximo de 'logins' falhados</guilabel
> quebra as ligações ao fim do número de tentativas de autenticação falhadas.</para>
<para
>Seleccionando a opção <guilabel
>Permitir o comando SITE GROUP</guilabel
> permite aos utilizdoress mudarem o grupo a que pertencem com o comando <userinput
><command
>SITE</command
> <option
>GROUP</option
></userinput
>.</para>
<para
>A permissão de usar os comandos <command
>chmod</command
>, <command
>delete</command
>, <command
>overwrite</command
>, <command
>rename</command
> e <command
>umask</command
> pode ser extendida ou negada aos utilizdoress anónimos, convidados e/ou reais.</para>
<para
>Os utilizdoress anónimos devem fornecer o seu endereço de email como a senha. O nível de obrigação pode ser controlado.</para>
<variablelist
> <varlistentry
> <term
><guilabel
>Não</guilabel
></term
> <listitem
><para
>Não há verificação da senha dada.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>trivial</guilabel
></term
> <listitem
><para
>A senha tem de conter um carácter @.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>RFC822</guilabel
></term
> <listitem
><para
>A senha tem de estar na forma de um endereço válido.</para
></listitem
> </varlistentry
> </variablelist>
<para
>Se o botão <guilabel
>Aplicar</guilabel
> estiver seleccionado, as ligações que falhem o teste serão negadas; caso contrário será dado um aviso.</para>
<para
>Na imagem, as directorias <filename class="directory"
>/bin</filename
> e <filename class="directory"
>/sbin</filename
> e o ficheiro <filename
>/etc/passwd</filename
> são proibidos de serem obtidos. As ligações são quebradas ao fim de 5 falhanços, o comando <userinput
><command
>SITE</command
> <option
>GROUP</option
></userinput
> é proibido, os comandos são proibidos aos utilizdoress anónimos e permitidos aos utilizdoress convidados e reais. Os utilizdoress que não enviem endereços de email em conformidade com o RFC822 são avisados.</para>
>Este painel permite-te especificar as mensagens a serem mostradas ao utilizador ligado.</para>
<para
>Selecciona um ficheiro para a mensagem a mostrar na ligação (antes da autenticação). Alguns clientes extremamente antigos de &FTP; podem ficar confusos com esta mensagem.</para>
<para
>O nome da máquina pode ser especificado. Isto será comunicado ao utilizador na autenticação, e pode ser inserido noutras mensagens (como <token
>%L</token
>). Se não for indicado outro nome, será usado o verdadeiro nome da máquina.</para>
<para
>De modo igual, pode ser definido o endereço de email do administrador para inserir nas mensagens (como <token
>%E</token
>).</para>
<para
>Assinala as opções para que as mensagens e os <filename
>README</filename
>s sejam mostrados ao utilizador sempre que o evento que os desencadeia ocorra (será explicado em baixo); caso contrário só serão mostrados da primeira vez.</para>
<para
>Carrega no botão <guibutton
>Adicionar Mensagem</guibutton
> para indicar o textoa ser mostrado ao utilizador. Ser-te-á perguntada a localização do ficheiro de texto, se será mostrado ao se ligar um utilizador ou na mudança para uma dada directoria e se é mostrado para todas as classes de utilizdoress ou se só para algumas.</para>
<para
>Da mesma maneira, o utilizador pode ser notificado dos ficheiros <filename
>README</filename
> ao se ligar ou ao mudar para uma directoria.</para>
<para
>Na imagem, o texto em <filename
>/home/ftp/welcome.txt</filename
> será mostrado quando um utilizador se ligar. A máquina <systemitem class="systemname"
>camelot</systemitem
> e o endereço do administrador <email
>jsinger@leeta.net</email
> será inserido nas mensagens mas ainda não se definiram as mensagens ou os <filename
>Este painel permite-te controlar quais as actividades que serão registadas (no ficheiro <filename
>/var/log/xferlog</filename
>). Os utilizdoress anónimos, convidados e reais podem ter diferentes tipos de eventos registados, incluindo os comandos introduzidos, os envios, obtenções e violações de segurança (como autenticações falhadas).</para>
<para
>Se seleccionares <guilabel
>Redireccionar o registo para o syslog</guilabel
> os registos vão para o ficheiro de registo do sistema em vez de ir para o do &FTP;.</para>
<para
>Pode ser enviado um 'email' para o administrador quando são enviados ficheiros para o servidor. O endereço <computeroutput
>From:</computeroutput
> das mensagens, o servidor de email e o endereço do administrador podem ser indicados.</para>
<para
>Na imagem, todos os comandos e transferências são registados, assim como as violações de segurança dos utilizdoress reais. Os envios são assinalados por uma mensagem ao <quote
>admin</quote
> de <quote
>Aviso de Envio</quote
> enviado através do servidor de email por omissão.</para>
>Este painel permite-te restringir a utilização dos utilizdoress anónimos e convidados. Cada uma destas restrições podem ser aplicadas aos utilizdoress anónimos ou convidados.</para>
<variablelist
> <varlistentry
> <term
><guilabel
>Rácio de upload/download</guilabel
></term
> <listitem
><para
>Por exemplo, se definires isto como 1:5 significa que os utilizdoress têm de enviar 1 megabyte por cada 5 megabytes recebidos. A definição disto para um valor óptimo é a chave para o teu sucesso como um aspirante de 'w4r3z kiddi3'.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Limite de tempo</guilabel
></term
> <listitem
><para
>Permite aos utilizdores ligarem-se por este período de tempo.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Limite de upload</guilabel
></term
> <listitem
><para
>Define o número máximo de 'bytes' que podem ser enviados por sessão.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Limite de download</guilabel
></term
> <listitem
><para
>Define o número máximo de 'bytes' que podem ser recebidos por sessão.</para
></listitem
> </varlistentry
> </variablelist>
<para
>Os ficheiros e directorias podem ser excluídos dos limites de envios e recepções.</para>
<para
>Na imagem, os rácios estão desligados, os utilizdoress anónimos podem-se ligar por 15 minutos, a 10 megabytes de 'downloads' por ligação.</para>
>Este painel permite-te controlar onde e como os utilizdoress podem deixar os seus ficheiros. Carrega em <guibutton
>Adicionar</guibutton
> para um novo conjunto de regras, <guibutton
>Editar</guibutton
> para modificar o conjunto escolhido e <guibutton
>Apagar </guibutton
> para removeres o conjunto seleccionado.</para>
<para
>Cada conjunto aplica-se aos utilizdoress com uma dada directoria de base e afecta-se a uma directoria de envio ('upload'). A directoria de envio pode ser abrangente (por exemplo, o <filename
>/home/ftp/upload/*</filename
> inclui todo o conteúdo de <filename class="directory"
>/home/ftp/upload</filename
>).</para>
<para
>Os envios podem ser permitidos ou proibidos, e as permissões dos ficheiros criados e o seu dono e grupo podem ser alterados. A capacidade criar novas directorias dentro da directoria em questão pode ser permitida ou não.</para>
>Pode ser especificado um ficheiro de senhas alternativo. Caso contrário o ficheiro de senhas do sistema será usado.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Ficheiro shadow</guilabel
></term
> <listitem
><para
>Pode ser especificado um ficheiro de senhas 'shadow' alternativo. Caso contrário o ficheiro de senhas 'shadow' do sistema será usado.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Nome do servidor</guilabel
></term
> <listitem
><para
>O nome do servidor que é mostrado ao utilizador quando se liga e é inserido como <token
>%L</token
> nos ficheiros de mensagem.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Email do administrador</guilabel
></term
> <listitem
><para
>O endereço de email a ser inserido como <token
>%E</token
> nos ficheiros de mensagem.</para
></listitem
> </varlistentry
> </variablelist>
<para
>As ligações anónimas podem ser permitidas ou não.</para>
<para
>O acesso dos utilizdoress reais pode ser permitido ou recusado no servidor virtual. Pode também ser permitido ou negado o acesso a um utilizador específico.</para>
<para
>Na imagem, o servidor virtual <systemitem class="systemname"
>211.22.55.114</systemitem
> tem o sistema de ficheiros com a raiz em <filename class="directory"
>/home/ftp/virtual</filename
> no sistema de ficheiros real. Usa ficheiros de senhas normais e 'shadow' separados em <filename class="directory"
>/home/ftp</filename
>, mostra como o nome da máquina <systemitem class="systemname"
>ganesh</systemitem
> e como endereço do administrador <quote
>root</quote
>; permite ligações anónimas assim como ligações de todos os utilizdoress reais.</para>
</sect1>
</chapter>
<chapter id="credits-and-license">
<title
>Créditos e Licenças</title>
<para
>&kwuftpd;</para>
<para
>Aplicação escrita por Bernhard Rosenkraenzer <email
>bero@redhat.com</email
>, e é copyright 2000 &RedHat;, Inc.</para>
<para
>Documentação copyright 2000 by Jonathan Singer <email
>Para obteres o &kwuftpd; em separado, ele faz parte do pacote tdeadmin e deve ser compilado e instalado tal como é indicado na directoria principal do pacote. Podem ser obtidas as novas versões do tdeadmin em <ulink url="ftp://ftp.kde.org/pub/"
