<para>Para o meu escritório do autor, eu estava procurando há muito tempo uma solução de <acronym>PIM</acronym> que me permitisse compartilhar os dados, de modo que a minha secretária e eu pudéssemos compartilhar os contatos, compromissos e assim por diante. Sendo um usuário do &kde;, eu ouvi falar no projeto Kroupware e esperei pela sua finalização. Mas, quando eu vi a complexidade da arquitetura e da configuração do servidor <application>Kolab</application> 1.0 (o lado do servidor do projeto), eu desisti, ficando à espera de uma versão <application>Kolab</application> 2.0 mais simples. De qualquer maneira, os recursos do <application>Kolab</application> eram muito além do que minhas necessidades. Felizmente, no Wiki do &kde;, encontrei algumas conversas de <acronym>IRC</acronym>, onde se falava sobre o compartilhamento de dados sem a infra-estrutura do <application>Kolab</application> ... mmm muito interessante!</para>
<para>Para os pequenos escritórios e necessidades, você poderá ter o &kontact; usando dados compartilhados sem ter que instalar o servidor <application>Kolab</application> ou outra infra-estrutura de 'groupware'. Ele poderá trabalhar apenas com um servidor de <acronym>IMAP</acronym>, que poderá ser configurado facilmente.</para>
<para>O cenário em questão é um servidor com o 'Debian unstable' e o &kde; 3.4. O acesso é feito ao &kontact; e a outras aplicações do GNU/Linux a partir do Windows com o Cygwin/X, enquanto se espera que o projeto Wine seja capaz de executar os últimos programas de Windows que o autor necessita (e que não estão disponíveis no GNU/Linux). Pretende-se partilhar contatos, eventos, itens por-fazer e notas com a secretária.</para>
<para>Esta definição vem do <ulink url="http://computeruser.com">ComputerUser.com High-Tech Dictionary:</ulink> <blockquote><para>Internet Message Access Protocol (Protocolo de Acesso de Mensagens Internet). Um protocolo que permite a um usuário efetuar certas funções de correio eletrônico num servidor remoto, em vez de ser num computador local. Através do IMAP, o usuário poderá criar, remover ou renomear caixas de correio, obter mensagens novas, removê-las e efetuar funções de pesquisa no correio. É necessário um protocolo separado para o envio de correio. Também é chamado de Internet Mail Access Protocol (Protocolo de Acesso de Correio Internet).</para></blockquote> </para>
<para>Por isso, ele pode ser considerado um sistema de armazenamento de dados. Para usá-lo, você precisa ter um servidor de <acronym>IMAP</acronym>, como o <application>Cyrus</application>, o <application>Courier</application> ou o <application>UW</application>.</para>
<para>O <application>Kolab</application> traz a possibilidade de compartilhar dados entre vários clientes. Ele permite que a sua secretária use o <application>Outlook</application> e você use o &kontact;, por exemplo.</para>
<para>Você terá que ter uma interface de configuração que faça o gerenciamento dos usuários, a configuração das contas de correio, os dados de configuração do <acronym>LDAP</acronym> central e do servidor de livro de endereços, a filtragem de lixo eletrônico e vírus, os programas de férias, o tratamento da lista de livre-ocupado, o gerenciamento de recursos (salas, carros), grupos, listas de distribuição, tratamento automático de convites, &etc;</para>
<para>Mas isso poderá causar problemas iniciais de configuração. Para um inexperiente como eu, significa um pesadelo realmente longo e frustrante e muita complexidade para gerenciar, assim que funcionar. Assim, não obrigado, eu passarei a usar apenas o simples e bom <acronym>IMAP</acronym>.</para>
<para>Minha escolha vai para o <application>Cyrus</application>, que faz parte do conjunto de aplicativos <application>Kolab</application>, por isso, se quiser mudar no futuro para o <application>Kolab</application>, já estará habituado a ele.</para> <para>Vejamos a instalação e configuração!</para>
<computeroutput>Installing cyrus21-imapd...</computeroutput><lineannotation>O instalador pergunta algumas coisas esquisitas que eu desconheço sobre um endereço de procura... eu simplesmente pressionei <keycap>Enter</keycap></lineannotation>.</screen>
<para>O instalador também criou o usuário <systemitem class="username">cyrus</systemitem>, que está no grupo (criado automaticamente)<systemitem class="groupname">sasl</systemitem>, que é o <quote>dono</quote> de todos os arquivos do 'cyrus'. No final, com o comando <command>ps <option>-A</option></command>, você poderá descobrir os processos novos: <command>cyrmaster</command> e <command>notifyd</command>.</para>
<para>O problema real na configuração do <application>Cyrus</application> está na autenticação, simplesmente porque não é trivial e eu possuo poucos conhecimentos do que estou fazendo.</para>
<para>O <application>Cyrus</application> pode usar vários mecanismos de <acronym>SASL</acronym> (Simple Authentication and Security Layer), sendo o padrão o 'sasldb' (guarda os usuários e as senhas no arquivo de senhas do SASL <filename>sasldb</filename>), mas também são suportados o getpwent, kerberos4, kerberos5, PAM, rimap, shadow e LDAP.</para>
<para>Uma vez que eu não pretendo definir os usuários/senhas diferentes dos usados para acessar ao sistema &Linux;, eu optei por usar o <quote>shadow</quote>, de modo que o <application>Cyrus</application> use as senhas do &Linux; para a autenticação.</para>
<para>Para fazer isso, nós teremos que dizer ao 'sasl' para usar o <command>saslauthd</command> como método de autenticação de senhas, e depois configurar o <command>saslauthd</command> para usar o <quote>shadow</quote> (ou o <quote>getpwent</quote>) como mecanismo de autenticação.</para>
<para>Ok, vamos começar!</para>
<para>Como <systemitem class="username">root</systemitem>, mude a senha de Linux do usuário <systemitem class="username">cyrus</systemitem>:</para>
<para>Insira a senha que desejar (e que você se lembre); para este exemplo, será configurada a <quote>cyrus</quote> como a senha do administrador <application>cyrus</application>.</para>
<programlisting>sasl_pwcheck_method: <userinput>saslauthd</userinput> <lineannotation>em vez do valor padrão <literal>auxprop</literal></lineannotation></programlisting>
<para>remova comentário <literal>#</literal> da linha:</para>
<programlisting>#admins: cyrus</programlisting>
<para>desta forma, você poderá administrar o <application>cyrus</application>, entrando com o usuário <systemitem class="username">cyrus</systemitem> (com qual fantasia eu tiver!)</para>
<para>(caso contrário, o <application>saslauthd</application> não irá iniciar na inicialização, mesmo que seja referenciado em algum <filename class="directory">/etc/rcx.d</filename>!)</para>
<para>e, em vez de <literal>MECHANISMS="pam"</literal>, coloque <userinput>MECHANISMS="shadow"</userinput>; desta forma, na inicialização, será executado um <command>saslauthd</command> <option>-a <parameter>shadow</parameter></option>.</para>
<para>Logo que tenha saído do seu editor, reinicie o <application>sasl</application> e o <application>cyrus</application>.</para>
<para>Para testar o <acronym>IMAP</acronym>:</para>
<para>Será pedida a senha do <systemitem class="username">cyrus</systemitem> (usuário), assim, introduza-a.</para>
<para>Se o usuário <systemitem class="username">cyrus</systemitem> estiver corretamente autenticado, irão aparecer as seguintes linhas:</para>
<screen><computeroutput>S: L01 OK User logged in
Authenticated.</computeroutput></screen>
<para>Para sair, digite <userinput>. logout</userinput> (&ie; ponto espaço <quote>logout</quote>)</para>
<para>Agora, adicione um usuário chamado <systemitem class="username">groupware</systemitem> e defina uma senha para ele, usando as suas ferramentas normais do sistema. Deverá estar num grupo sem privilégios, como o <systemitem class="groupname">nobody</systemitem>, e não necessita de uma sessão ou de uma pasta pessoal.</para>
<para>Agora, eu terei que criar o usuário e um <acronym>IMAP</acronym> no <application>cyrus</application> também:</para>
<screen># <userinput><command>cyradm</command> <option>--user cyrus localhost</option></userinput>
depois de inserir a senha do usuário de administração <systemitem class="username">cyrus</systemitem>, irá obter a linha de comando <prompt>localhost></prompt>
<prompt>localhost></prompt> <userinput><command>lm</command></userinput> <lineannotation>lista a caixa de correio que acaba de criar</lineannotation>
-rw------- 1 cyrus mail 76 Oct 29 20:55 cyrus.index</computeroutput></screen>
<para>Agora, você deverá ser capaz de conectar-se com um cliente de <acronym>IMAP</acronym> como o usuário <systemitem class="username">groupware</systemitem> e ver a <literal>INBOX</literal> (pasta de Recebidos).</para>
<note><para>No protocolo <acronym>IMAP</acronym>, a seleção da caixa de correio <literal>INBOX</literal> é uma palavra-mágica, uma espécie de <quote>apelido</quote> para a estrutura de pastas acima. O cliente vê a <literal>INBOX</literal> e o servidor de <acronym>IMAP</acronym> mapeia-a na pasta <filename class="directory">/var/spool/cyrus/mail/...</filename> e respectiva estrutura de arquivos.</para></note>
<para>Eu conecto ao meu PC servidor do escritório, com GNU/Linux (uma espécie de "caixa preta" sem monitor nem teclado), a partir de 2 PCs com &Windows; 2000, através do <application>Cygwin/X</application>, usando-os como um servidor de X-Window server (num futuro próximo, eu pretendo substituir ambos por 2 clientes mínimos mini-ITX e usando o LTSP). Com esta configuração, todos os usuários rodam o &kontact; na mesma máquina em que o <application>Cyrus</application> está instalado e rodando (o 'localhost').</para>
<step><para>Crie uma conta de <acronym>IMAP</acronym> no <application>Cyrus</application> para o usuário falso <systemitem class="username">groupware</systemitem> (o que já foi feito anteriormente!)</para></step>
<step><para>Crie/configure uma conta de <acronym>IMAP</acronym> no &kmail; para se autenticar com esse usuário</para></step> <step><para>Use o 'tderesources' para fazer com que os componentes do &kontact; funcionem com os dados retirados da fonte de <acronym>IMAP</acronym></para></step>
<step><para>Ative a funcionalidade de 'groupware' e crie as subpastas relacionadas com este nessa <literal>INBOX</literal> do <acronym>IMAP</acronym> (se já não tiver sido feito)</para></step>
<step><para>Divirta-se com o &kontact; e os dados compartilhados através do IMAP da <application>Cyrus</application></para></step>
<para>Para isso, logue-se ao &kde; com a primeira conta do <quote>usuário real</quote>, à qual pretende oferecer as funcionalidades de 'groupware'.</para>
<para>Vamos criar então a conta de IMAP no &kmail;.</para>
<para>Execute o &kontact; e selecione o <guilabel>E-Mail</guilabel> (o componente do &kmail;). No menu, escolha a opção <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar o KMail </guimenuitem><guilabel>Contas</guilabel><guilabel>página Recepção</guilabel></menuchoice> e clique no botão <guibutton>Adicionar...</guibutton>. Será então pedido o tipo da sua conta de correio, onde irá selecionar a opção <guilabel>IMAP desconectado</guilabel> (não selecione o <guilabel>IMAP</guilabel> simples). Finalmente, na página <guilabel>Geral</guilabel>, insira os seguintes dados:</para>
<para>Assinale a opção <guilabel>guardar senha IMAP</guilabel>, para que não lhe seja pedida, da próxima vez que executar o &kontact;. Assinale a opção <guilabel>Ativar a verificação periódica de correio</guilabel> e defina um valor em minutos.</para>
<para>Lembre-se que foi assinalado o tipo de conta <guilabel>IMAP desconectado</guilabel>. Isto tem o efeito de que uma cópia dos dados de 'groupware' é guardada <quote>localmente</quote> no cliente (sob a pasta pessoal) e que é sincronizada, sempre que o cliente se conecta. Isto parece muito ineficiente, uma vez que os seus dados são duplicados várias vezes (&ie; se tiver 10 usuários que usam o &kontact;, terá 10+1 vezes os mesmos dados), mas é a única forma de fazer com que as coisas funcionem rapidamente já que, em todas as conexões, o &kontact; tem que obter todos os dados e fazer com que o &korganizer; e o &kaddressbook; os interpretem. Se usar o <quote>IMAP desconectado</quote>, os dados são mantidos localmente em 'cache', sendo enviado apenas o <quote>delta</quote> (&ie; os dados alterados).</para>
<para>Por outro lado, se os seus usuários executam o &korganizer; no mesmo PC que roda o servidor de <acronym>IMAP</acronym>, parece razoável usar o <acronym>IMAP</acronym> (isto é chamado de <quote>IMAP conectado</quote>) para poupar espaço, uma vez que a velocidade de transferência não deverá ser um problema. Porém, infelizmente, isto não funciona, porque o &kontact; não atualiza automaticamente a pasta de <guilabel>Calendário</guilabel> no <quote>IMAP conectado</quote>, assim, você não será atualizado quando alguém adicionar eventos (terá que mudar manualmente para o aplicativo &kmail; e clicar na pasta de <guilabel>Calendário</guilabel>). Além disso, na inicialização, quando ele lê as pastas de <guilabel>Calendário</guilabel>, você poderá ver uma intermitência tremenda e uma atualização lenta dos dados.</para>
<para>Agora, nós teremos que dizer ao &kontact; para usar o <acronym>IMAP</acronym> como fonte de dados para os seus vários componentes. No &kmenu;, escolha o <guimenuitem>Executar um comando</guimenuitem>, execute o <userinput><command>tdecmshell tderesources</command></userinput>. Na lista, selecione os <guilabel>Contatos</guilabel> e clique depois no botão <guibutton>Adicionar...</guibutton>, onde poderá escolher o <guilabel>Livro de endereços num Servidor de IMAP através do KMail</guilabel>. Depois, selecione essa nova linha e clique em <guibutton>Usar como Padrão</guibutton>. Faça o mesmo para o <guilabel>Calendário</guilabel> e para as <guilabel>Notas</guilabel>.</para>
<para>Escolha no menu a opção <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar o KMail</guimenuitem><guilabel>Diversos</guilabel><guilabel>Groupware</guilabel></menuchoice></para>
<para>Escolha o <guilabel>Inglês</guilabel> como <guilabel>Idioma das pastas de 'groupware'</guilabel> (isto é no caso de já ter as pastas criadas no servidor de <acronym>IMAP</acronym> por um outro programa num idioma diferente).</para>
<para>Agora, vá para a opção <guilabel>As pastas de recursos estão na conta</guilabel> e selecione a subpasta <guilabel>Inbox</guilabel> da pasta <guilabel>dados_escritorio</guilabel>.</para>
<para>Desligue a opção <guilabel>Ocultar as pastas de 'groupware'</guilabel> por enquanto, para que possamos ver o que acontecerá. Você poderá voltar aqui e assinalá-la, logo que esteja tudo bem.</para>
<para>Quando você pressionar em OK, aparecerá a mensagem: <computeroutput>O &kmail; irá agora criar as pastas necessárias no recurso de IMAP como subpastas da Inbox</computeroutput> </para>
<para>Se você não quiser isto, clique em <guibutton>Não</guibutton>, ficando então o recurso de <acronym>IMAP</acronym> desativado. Clique em <guibutton>Sim</guibutton> (isto só acontece na primeira vez com o primeiro <quote>usuário real</quote>). Você verá imediatamente que, na árvore de pastas do &kmail;, sob a pasta <menuchoice><guilabel>dados_escritorio</guilabel><guilabel>Inbox</guilabel></menuchoice>, serão criadas as subpastas:</para>
-rw------- 1 cyrus mail 76 Oct 31 15:28 cyrus.index</computeroutput></screen>
<para>Como pode ver, o <guilabel>office_gwdata/Inbox</guilabel> está guardado, não de forma local na pasta do usuário atual do &kontact;, mas sim nas pastas de <acronym>IMAP</acronym> do usuário <systemitem class="username">groupware</systemitem>.</para>
<para>Agora, o &kontact; está pronto para trabalhar e guardar os dados aí. No aplicativo de calendário, se a conta de <acronym>IMAP</acronym> do &kmail; era do tipo <quote>desconectado</quote>, a janela do <guilabel>recurso</guilabel> irá mostrar o item <guilabel>Recurso de IMAP</guilabel> com 3 sub-itens, que são referências para arquivos locais do usuário. Por outro lado, o aplicativo dos <guilabel>Contatos</guilabel> não mostra sub-itens abaixo do <guilabel>Recurso de IMAP</guilabel>.</para>
<para>Você poderá agora logar-se ao &kde; com um usuário diferente e configurar o seu cliente do &kontact; de uma forma muito semelhante:</para>
<para>Abra o &kontact; e, no componente de <guilabel>Correio</guilabel>, adicione uma conta de <acronym>IMAP</acronym> que indique como <guilabel>servidor</guilabel> o computador em que o servidor de <application>Cyrus</application> se executa (neste caso, o <literal>192.168.1.3</literal>).</para>
<para>Lembre-se de assinalar a opção <guilabel>Ativar a verificação periódica do correio</guilabel> e defina um valor em minutos. Quando confirmar, não lhe será pedida a confirmação da criação das subpastas (uma vez que elas existem no servidor de <acronym>IMAP</acronym>), de modo que as verá na árvore de pastas.</para>
<para>Tenha cuidado observando que, no <quote><acronym>IMAP</acronym> desconectado</quote>, os dados são transmitidos de um cliente para um servidor de <acronym>IMAP</acronym>, apenas quando o cliente se logar para verificar o correio novo. Assim, se tiver os seus clientes do &kontact; com um <guilabel>intervalo de verificação de correio</guilabel> de, por exemplo, 5 minutos, no pior dos casos, terá um atraso de 10 minutos entre a escrita do evento e a sua aparição nos outros usuários.</para>
<title>Como Ter Acesso Apenas para Leitura</title>
<note><para>Tenha cuidado observando que a implementação de <acronym>IMAP</acronym> das Notas no &kontact; anterior à versão do 1.01 possui problemas, assim esta configuração não irá funcionar nesse caso; aí, se quiser usá-la, terá que usar a configuração anterior.</para></note>
<para>Na configuração anterior, existe o mesmo usuário <quote>falso</quote>, chamado <systemitem class="username">groupware</systemitem>, que é usado por todos os usuários <quote>reais</quote> do &kontact; (&ie; o <systemitem class="username">antonio</systemitem>, o <systemitem class="username">jose</systemitem>, a <systemitem class="username">amanda</systemitem>, &etc;), através da conta de <acronym>IMAP</acronym> com o seu usuário e senha. Porém, desta forma, todos os usuários reais têm as mesmas permissões de leitura/escrita dos outros, uma vez que todos se logam com o usuário <systemitem class="username">groupware</systemitem> ao servidor de <acronym>IMAP</acronym>.</para>
<para>Para limitar o acesso a alguns usuários (tipicamente, oferecendo o acesso apenas para leitura), serão usadas as <acronym>ACL</acronym>s (Access Control Lists - Listas de Controle de Acesso).</para>
<para>Selecione no &kmail; uma subpasta da caixa de correio <guilabel>dados_escritorio</guilabel>, como por exemplo a <guilabel>Calendar</guilabel> e clique com o botão direito do mouse. Selecione a opção <guilabel>Propriedades</guilabel><guilabel>Controle de Acesso</guilabel>. Aqui, você poderá inserir os usuários aos quais deseja dar acesso a esta pasta, bem como o que eles poderão fazer.</para>
<para>Só para experimentar a troca de eventos, serão dadas <quote>Todas</quote> as permissões ao usuário <systemitem class="username">maria</systemitem></para>
<para>No <application>cyrus</application> (no <acronym>PC</acronym> que está a rodando o servidor de <acronym>IMAP</acronym> da Cyrus, com as ferramentas do <application>cyrus</application>), nós teremos primeiro que adicionar o usuário <systemitem class="username">maria</systemitem>, para que seja um usuário reconhecido de <acronym>IMAP</acronym>, e criar uma pasta de <acronym>IMAP</acronym> para ela.</para>
<para>Depois, logue-se ao GNU/Linux como a <systemitem class="username">maria</systemitem> e entre no &kontact;. Como foi mostrado anteriormente, será configurada uma conta de <acronym>IMAP</acronym> no &kmail; com os mesmos dados, com a diferença do usuário (em vez do usuário falso <systemitem class="username">groupware</systemitem> e a sua senha, nós usaremos a <systemitem class="username">maria</systemitem> e a senha dela).</para>
<para>Na árvore de pastas do &kmail;, desta vez você verá a seguinte estrutura: <menuchoice><guimenu>dados_escritorio</guimenu><guisubmenu>usuário</guisubmenu> <guisubmenu>groupware</guisubmenu><guimenuitem>Calendário e Tarefas</guimenuitem></menuchoice>. Verifique o correio (<menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Verificar o Correio</guimenuitem></menuchoice>) e você terá também uma pasta <quote>inbox</quote> sob a <quote>dados_escritorio</quote>.</para>
<para>Agora, ative a funcionalidade de 'groupware' do &kmail; e, no campo <guilabel>As pastas de recursos são subpastas de </guilabel>, coloque a <guimenuitem>inbox</guimenuitem>, que é uma subpasta da <quote>dados_escritorio</quote>.</para>
<para>Agora, ative a funcionalidade de 'groupware' do &kmail; e, no campo <guilabel>As pastas de recursos são subpastas de </guilabel>, coloque a <guimenuitem>inbox</guimenuitem>, que é uma subpasta da <guisubmenu>dados_escritorio</guisubmenu>.</para>
<para>A <quote>inbox</quote>, com o Calendar, Contacts, Notes, Tasks e a Journal, que estão gravadas nas pastas de <acronym>IMAP</acronym> da <systemitem class="username">maria</systemitem>, no servidor de <acronym>IMAP</acronym></para>
<para>O <quote>usuário</quote>, com a subpasta <quote>groupware</quote> e as subpastas a que a <systemitem class="username">maria</systemitem> tem acesso (neste exemplo, à Calendar (Calendário) e às Tasks (Tarefas))</para>
<para>Clique com o &RMB; na pasta <quote>Calendar</quote> do usuário e verifique se é do tipo Calendário (se não, defina-a como tal) e se a <quote>usuário</quote><quote>Tasks</quote> é do tipo de Tarefas.</para>
<para>Agora, no Calendário, você terá dois recursos de <acronym>IMAP</acronym> disponíveis, nos quais poderá escrever; assim, se criar um novo evento, será perguntado qual será usado (ou, se deixar disponíveis os recursos, locais, terá então 3!).</para>
<para>Você terá que ir à pequena janela do lado esquerdo no Calendário, a que mostra os recursos disponíveis, e deslogar os que não apontam para o local <guilabel>.groupware.directory</guilabel> (veja a parte final de cada pasta de recursos).</para>
<para>Eu me considero pouco experiente e, para este HOWTO, só ofereci o meu tempo e vontade. Para conhecimento de todos, eu desejo agradecer a algumas pessas dos canais da 'freenode' pela sua competência, paciência e vontade de ajudar.</para>
