Como configurar regras personalizadas do SpamAssassin no Zimbra (com segurança)

Qual arquivo do Zimbra SpamAssassin você deve editar?

Para o Zimbra Collaboration Suite 8.5 e versões posteriores, a documentação do Zimbra indica que as personalizações locais do SpamAssassin devem ser armazenadas em um arquivo com a extensão /opt/zimbra/data/spamassassin/localrules.zimbra. Um arquivo de regra com a .cfextensão .zimbra pode estar localizado lá; o exemplo do Zimbra utiliza um arquivo separado para uma regra personalizada. Versões anteriores do Zimbra utilizavam locais diferentes, portanto, verifique a versão e o diretório no seu servidor antes de editar o arquivo. O layout atual do pacote também pode variar de acordo com a versão ou implantação.

Este guia adiciona uma pequena regra reversível para todo o site, verifica sua sintaxe, recarrega o serviço de verificação de e-mails e verifica se uma mensagem foi entregue. Pressupõe-se que você administre o Zimbra MTA. Se você executar vários servidores MTA, aplique o arquivo e recarregue o SpamAssassin em cada servidor que verifica e-mails recebidos.

O guia de regras personalizadas do SpamAssassin para o Zimbra documenta o caminho do arquivo localrules e o zmamavisdctl restartcomando. Suas orientações anti-spam diferenciam a configuração mais antiga do ZCS 8 da configuração do ZCS 8.5 e versões posteriores.

O que uma regra personalizada altera?

Uma regra do SpamAssassin detecta uma característica da mensagem, atribui um nome simbólico à regra e contribui com uma pontuação. O SpamAssassin combina essa pontuação com outros resultados de testes. O Zimbra, então, aplica seus limites de tratamento de spam configurados. Uma regra, por si só, não garante que uma mensagem seja direcionada para a pasta de Lixo Eletrônico ou rejeitada: o restante da pontuação da mensagem e as configurações do seu servidor são importantes.

Essa distinção é importante na hora de escolher uma pontuação. Comece com um valor moderado, verifique os falsos positivos e aumente-o somente quando os testes mostrarem que o sinal é confiável. Evite copiar uma pontuação alta de um exemplo sem verificar sua própria pontuação de spam e limite de descarte necessários.

Antes de editar qualquer coisa, o que você deve confirmar?

• Versão e caminho: Verifique sua versão do Zimbra e se o arquivo /opt/zimbra/data/spamassassin/localrulesexiste. O caminho neste guia se aplica ao ZCS 8.5 e versões posteriores, de acordo com a documentação do Zimbra. Não assuma que se aplica a versões anteriores.
• Qual host verifica os e-mails: Identifique todos os MTAs que executam Amavis/SpamAssassin. Uma regra instalada em um servidor não aparecerá automaticamente em outro MTA independente.
• Objetivo da regra: Escolha um sinal de mensagem específico e repetível. Evite regras que correspondam a palavras genéricas como "grátis" ou "oferta" sem evidências adicionais.
• Reverter: Registre qualquer arquivo existente antes de alterá-lo. Use um nome de arquivo novo e descritivo para uma nova regra e não sobrescreva um .cfarquivo existente acidentalmente.

Essas são personalizações em nível de servidor, não filtros de caixa de correio. Todos os usuários cujas mensagens passam pelo scanner configurado podem ser afetados.

Como se escreve uma regra simples?

O SpamAssassin suporta tipos de regras como `header` header, body`body` uri, `subject` e ` metabody`. Uma regra de cabeçalho é útil quando o sinal é um assunto ou valor de cabeçalho distinto. Uma regra de corpo pesquisa o conteúdo textual da mensagem; a documentação do SpamAssassin observa que as regras de corpo comuns operam no texto decodificado e tratam o assunto como parte do corpo por padrão. Use uma regra de URI quando a condição for especificamente sobre links.

Aqui está um exemplo propositalmente específico que adiciona uma pequena pontuação quando o assunto de uma mensagem de teste contém uma frase única. Substitua a frase por um sinal que você tenha verificado em seus próprios e-mails; este exemplo não é uma assinatura genérica de spam.

header LOCAL_SUBJECT_REVIEW Subject =~ /\bExample Vendor Alert\b/i
score LOCAL_SUBJECT_REVIEW 2.0
describe LOCAL_SUBJECT_REVIEW Subject contains the review phrase

O nome simbólico deve ser único e usar letras, dígitos e sublinhados. A headerlinha define a correspondência, scorecontrola os pontos adicionados quando ela ocorre e describefornece uma explicação no relatório do SpamAssassin. Mantenha a descrição curta e deixe claro para outro administrador o motivo da existência do teste.

Os documentos de referência de configuração do SpamAssassin abordam a sintaxe das regras de cabeçalho e corpo, o comportamento da pontuação e os detalhes das expressões regulares. A versão do Zimbra SpamAssassin instalada pode ser diferente da documentação mais recente do Apache, portanto, evite depender de recursos de regras mais recentes até confirmar a compatibilidade local.

Como instalar a regra no Zimbra 8.5 e versões posteriores?

1. Conecte-se ao MTA com uma conta de administrador que possa alternar para a conta de serviço do Zimbra.
2. Verifique o diretório de instalação e de regras locais. Por exemplo:
   su - zimbra
ls -ld /opt/zimbra/data/spamassassin/localrules
3. Escolha um nome de arquivo que ainda não exista, como local_subject_review.cf. Verifique primeiro:
   ls -l /opt/zimbra/data/spamassassin/localrules/local_subject_review.cf
   se existir, inspecione-o e selecione outro nome em vez de sobrescrevê-lo.
4. Crie o novo arquivo como zimbrausuário com seu editor e adicione as três linhas de regra acima:
   vi /opt/zimbra/data/spamassassin/localrules/local_subject_review.cf
5. Salve o arquivo e, em seguida, confirme o proprietário e o conteúdo:
   ls -l /opt/zimbra/data/spamassassin/localrules/local_subject_review.cf
cat /opt/zimbra/data/spamassassin/localrules/local_subject_review.cf

Se o diretório estiver faltando, pare o programa e confirme a versão do Zimbra e seu layout de configuração documentado. Não crie um diretório com nome semelhante em um local aleatório; o SpamAssassin não o carregará necessariamente.

Como devo validar e recarregar?

Execute a verificação de sintaxe do SpamAssassin antes de recarregar. A documentação da linha de comando do Apache descreve --lintisso como uma verificação de sintaxe de conjunto de regras e configuração. Como usuário do Zimbra, execute o spamassassin --lintcomando se ele estiver disponível no ambiente Zimbra. Se o comando não for encontrado ou não carregar a configuração do Zimbra, localize o executável incluído e use o caminho de configuração apropriado para a versão, em vez de testar em uma instalação de sistema não relacionada. Um resultado de verificação de sintaxe limpo verifica a sintaxe; não prova que seu padrão corresponderá às mensagens que você pretende.

A documentação de comandos do SpamAssassin explica a opção lint. Após a validação ser concluída com sucesso, reinicie o Amavis como o zimbrausuário para que o scanner carregue as regras alteradas:

zmamavisdctl restart

O exemplo de regras personalizadas do Zimbra usa este comando de serviço. Em uma instalação com vários MTAs, repita a implantação do arquivo e a reinicialização do serviço em todos os scanners aplicáveis. Se a sua versão usar um comando de serviço diferente, siga a documentação do Zimbra correspondente a essa versão.

Como saber se a regra está funcionando?

Envie uma mensagem de teste controlada pela mesma rota de entrada que os usuários utilizam. Use a frase de assunto exata da regra para uma mensagem e, em seguida, envie uma mensagem semelhante sem ela. Inspecione os cabeçalhos originais da mensagem entregue, especialmente o cabeçalho `<subject>` X-Spam-Status, LOCAL_SUBJECT_REVIEWa contribuição para a pontuação e o cabeçalho `<score>`. Compare as duas mensagens e verifique onde o Zimbra entregou cada uma delas.

O resultado é útil se a regra aparecer apenas no teste pretendido e a pontuação total produzir o tratamento esperado. Se o nome do teste estiver ausente, verifique se a mensagem passou por este MTA, se o nome do arquivo termina em .gitignore .cf, se o arquivo está no diretório localrules correto, se o scanner foi reiniciado com sucesso e se a amostra realmente corresponde à expressão regular. Lembre-se de que os clientes de e-mail podem ocultar cabeçalhos de diagnóstico em sua visualização normal; abra o código-fonte da mensagem ou os cabeçalhos completos.

E se a regra gerar falsos positivos ou não corresponder a nenhum resultado?

• Muitas mensagens legítimas correspondem: diminua a pontuação ou restrinja a expressão regular. Teste com exemplos de e-mails desejados e indesejados antes de aumentar a pontuação.
• Nenhuma mensagem corresponde: verifique o nome exato do cabeçalho, a expressão regular que ignora maiúsculas e minúsculas, os caracteres de escape, a extensão do arquivo, o caminho e a reinicialização do serviço. Para URLs, avalie uma uriregra em vez de presumir que uma regra no corpo da URL seja o melhor teste.
• O Lint reportou um erro: corrija a linha indicada e execute o Lint novamente antes de reiniciar. Uma regra personalizada malformada pode causar problemas de configuração ou impedir que os testes esperados sejam carregados.
• A regra aparece, mas o e-mail permanece na Caixa de Entrada: Isso pode ser normal se os pontos adicionados não elevarem a pontuação total acima do limite de spam configurado. Revise a X-Spam-Statuspontuação completa e os limites de tratamento local.

Para reverter as alterações, remova apenas o arquivo personalizado que você adicionou e reinicie o Amavis. Se você alterou um arquivo existente, restaure a cópia salva e valide a configuração antes de recarregar. Mantenha um breve registro de alterações com a finalidade da regra, a pontuação, as mensagens de teste e o nome do arquivo de reversão para que administradores futuros possam reavaliá-la.

Limites de versão e comportamento

As diretrizes de roteamento publicadas pelo Zimbra abrangem explicitamente o ZCS 8.5 e versões posteriores, e documentam um layout diferente para versões anteriores. A versão exata do SpamAssassin incluída e os limites são específicos da instalação. Uma regra válida também pode se comportar de maneira diferente com diferentes formatos de mensagem, servidores de retransmissão e caminhos de fluxo de e-mail. Consulte a documentação da sua versão instalada, teste em uma rota controlada e avalie os resultados com base nos cabeçalhos das mensagens e em exemplos reais de falsos positivos, em vez de se basear apenas no texto da regra.