Geração de Relatórios para o PostFix por meio do Post-la

Colaboração: José Messias Alves da Silva

Data de Publicação: 27 de fevereiro de 2008

Introdução

O que é?

Post-la é um gerador de relatórios que nasceu pela ausência de uma ferramenta prática para monitorar o que transita pelos servidores de e-mail PostFix. Foi desenvolvido pelos colegas Henrique Bueno e Tiago Azevedo .

Como funciona?

O script post-la.sh analiza o log do Postfix e gera um arquivo texto com apenas os dados relevantes. O arquivo index.cgi lê esse arquivo e gera um relatório html.

É compatível com qualquer instalação Postfix?

As expressões regulares foram desenvolvidas para que casassem com qualquer log do postfix, independente do anti-vírus ou anti-spam instalados.

Passos para Instalação

• Criar o diretorio /etc/post-la e, em seguida, acessar o diretório

• Fazer o download da última versão do programa pelo link:

    # wget -c http://post-la.kibibit.com.br/download/post-la.tar.gz 
  

• Descompactar o arquivo

    # tar xvzf post-la.tar.gz 
  

• Abrir o arquivo post-la.conf e alterá-lo, se necessário. O arquivo é auto-explicativo.

• Executar o instalador com o comando

    #./instalar.sh  
  

• Inserir os dominios no arquivo /etc/post-la/dominios

• Configurar o postfix para logar o assunto das mensagens:
  No main.cf adicione a linha caso não exista:

    header_checks = regexp:/etc/postfix/header_checks 
  

  e criar o arquivo header_checks com o conteúdo:

    /^Subject:/ WARN POST-LA 
  

  Nota: Caso o arquivo já exista, adicionar a linha ao final do arquivo,
  caso contrário poderá afetar o funcionamento de outros programas.
  Reiniciar o postfix

    #/etc/init.d/postfix restart 
  

• Configurar o apache:
  Adicionar as linhas no arquivo de configuração do apache:

    < Directory seu_diretorio_www_do_post-la> 
           AllowOverride FileInfo AuthConfig Limit 
           Options Indexes SymLinksIfOwnerMatch ExecCGI IncludesNoExec 
           < Limit GET POST OPTIONS PROPFIND> 
              Order allow,deny 
              Allow from all 
           </Limit> 
    </Directory> 
  

  Sugere-se criar usuários e senhas para o diretório www_do_post-la, dado que relatórios dessa natureza só devem ser vistos e analisados por gestores da alta administração das instituições.
  Assim, as linhas no arquivo de configuração do apache:

    < Directory seu_diretorio_www_do_post-la> 
    	AllowOverride FileInfo AuthConfig Limit 
    	Options Indexes SymLinksIfOwnerMatch ExecCGI IncludesNoExec 
    
    	# Autenticação de Usuário 
    	AuthName "Acesso Restrito a Relatórios do Postfix" 
    	AuthType Basic 
    	AuthUserFile /etc/post-la/postla-users 
    	require valid-user 
    
    	< Limit GET POST OPTIONS PROPFIND> 
    	    Order allow,deny 
    	    Allow from all 
    	</Limit> 
    </Directory> 
  

  O arquivo postla-users é onde serão armazenados usuários e senhas. Para criar o arquivo de senhas e/ou adicionar senha para um determinado usuário, digita-se o comando abaixo:

    # htpasswd -c /etc/post-la/postla-users usuario 
  

  Por fim, reiniciar o apache

    apache2ctl restart  
  

• Agendar a execução do script no crontab, por exemplo, para executar todos os dias às 23:55.

    crontab -e  
  

  Acrescentar:

    55 23 * * * root /etc/post-la/post-la.sh 
  

  Nota:
  Para gerar uma base "na mão" execute o script /etc/post-la/post-la.sh. Caso tenha alterado a variavel DIRPOST no arquivo post-la.conf ou instalado o programa em diretório diferente de /etc/post-la, alterar também no arquivo DIRWWW/index.cgi

Considerações Finais

A ferramenta mostrou-se bastante interessante sob diversos aspectos, simplicidade, usabilidade e diversificação dos relatórios, por dominío e por meio de filtros.

Referência

Site do Projeto: http://post-la.kibibit.com.br