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

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