[Somente no local/híbrido]{class="badge yellow" title="Aplica-se somente a implantações locais e híbridas"}

Configuração do SpamAssassin configuring-spamassassin

NOTE
Algumas configurações só podem ser executadas por Adobe para implantações hospedadas por Adobe. Por exemplo, para acessar os arquivos de configuração do servidor e da instância. Para saber mais sobre as diferentes implantações, consulte a seção Modelos de hospedagem ou esta página.

Visão geral overview

O SpamAssassin é um software criado para filtrar emails indesejáveis. Em conjunto com esse software, o Adobe Campaign pode atribuir uma pontuação aos emails e determinar se uma mensagem provavelmente será considerada indesejável antes que o delivery seja iniciado. Para fazer isso, o SpamAssassin deve ser instalado e configurado no(s) servidor(es) de aplicativos do Adobe Campaign e requer um determinado número de módulos Perl adicionais para operar.

A implantação e a integração do SpamAssassin, conforme descrito neste capítulo, baseiam-se na instalação de software padrão, bem como nas regras de filtragem e pontuação, que são as fornecidas pelo SpamAssassin sem qualquer alteração ou otimização. A atribuição de pontuação e a qualificação de mensagem baseiam-se exclusivamente na configuração das opções do SpamAssassin e nas regras de filtragem. Os administradores de rede são responsáveis por adaptá-los às necessidades de sua empresa.

IMPORTANT
A qualificação de emails como indesejáveis pelo SpamAssassin é baseada inteiramente nas regras de filtragem e pontuação.
Portanto, essas regras precisam ser atualizadas pelo menos uma vez por dia para que sua instalação do SpamAssassin e sua integração no Adobe Campaign funcionem plenamente e para garantir a relevância das pontuações atribuídas a seus deliveries antes do envio.
Essa atualização é responsabilidade do administrador do servidor que hospeda o SpamAssassin.

O uso do SpamAssassin no Adobe Campaign fornece uma indicação sobre o possível comportamento de servidores de e-mail que usam o SpamAssassin quando recebem e-mails enviados pelo Adobe Campaign. No entanto, é possível que os servidores de e-mail de provedores de Internet ou servidores de e-mail on-line ainda considerem as mensagens enviadas pelo Adobe Campaign como indesejáveis.

A implantação do SpamAssassin e seus módulos em Perl requer servidores de aplicativos Adobe Campaign equipados com acesso à Internet por meio de uma conexão HTTP (fluxo TCP/80).

Instalando em um computador com Windows installing-on-a-windows-machine

Para instalar e configurar o SpamAssassin no Windows e habilitar a integração com o Adobe Campaign, siga as etapas abaixo:

  1. Instalar o SpamAssassin
  2. Integrar o SpamAssassin ao Adobe Campaign

Instalação do SpamAssassin installing-spamassassin

  1. Conecte-se ao Portal de distribuição de software usando suas credenciais de usuário. Saiba mais sobre a Distribuição de softwares em esta página.

  2. Baixe o arquivo Neolane Spam Assassin (Instalação do Windows) (2.0) (neolane_spamassassin.2.0.zip).

  3. Copie esse arquivo no servidor do Adobe Campaign e descompacte-o.

    note note
    NOTE
    Você pode optar por descompactar o arquivo onde quiser, contanto que o caminho seja composto de qualquer um dos seguintes caracteres de expressão regular: -_A-Za-z\xA0-\xFF0-9\.\%\@\=+\,\/\\\:.. O caminho de instalação não deve incluir espaços em branco.
  4. Vá para o arquivo em que você descompactou o arquivo e clique duas vezes no arquivo run_me.bat para iniciar o script de instalação.

    Se um Shell do Windows for exibido e continuar sendo exibido por alguns segundos, aguarde até que a instalação e a atualização sejam concluídas e, em seguida, clique em Enter.

    Se o Shell do Windows não aparecer ou não for exibido antes de desaparecer instantaneamente, siga estas etapas, clique duas vezes no arquivo portableShell.bat para exibir um Shell do Windows e verificar se o caminho do Shell corresponde à pasta na qual o arquivo spamassassin.zip foi descompactado. Se esse não for o caso, acesse-o usando o comando cd.

    Digite run_me.bat e clique em Enter para iniciar o processo de instalação e atualização. A operação retorna um dos seguintes valores para indicar o resultado da atualização.

    • 0: uma atualização foi realizada.
    • 1: nenhuma atualização nova disponível.
    • 2: nenhuma atualização nova disponível.
    • 3: falha na atualização durante a verificação anterior.
    • 4 ou mais: erro.
  5. Para verificar se a instalação do SpamAssassin foi bem-sucedida, use o teste GTUBE (Teste genérico para e-mail em massa não solicitado) usando o seguinte procedimento:

    1. Crie um arquivo de texto e salve em C:\TestSpamMail.txt.

    2. Insira o seguinte conteúdo no arquivo:

      code language-none
      Subject: Test Spam Mail (GTUBE)
      Message-ID: <1010101@example.net>
      Date: MM-DD-YY
      From: Sender <sender@example.net>
      To: Recipient <recipient@example.net>
      Precedence: junk
      MIME-Version: 1.0
      Content-Type: text/plain; charset=us-ascii
      Content-Transfer-Encoding: 7bit
      
      XJS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X
      
    3. Clique duas vezes no arquivo portableShell.bat para exibir um Shell do Windows e depois inicie o seguinte comando (ou "<root>" designa a pasta criada ao descompactar o arquivo spamassassin.zip):

      code language-none
       "<root>\perl\site\bin\spamassassin" "C:\TestSpamMail.txt"
      

      O conteúdo desse email de teste aciona uma pontuação de 1.000 pontos pelo SpamAssassin. Isso significa que foi detectado como indesejável e que a instalação foi bem-sucedida e está totalmente funcional.

Integração do SpamAssassin ao Adobe Campaign integrating-spamassassin-into-adobe-campaign

  1. Edite o arquivo [INSTALL]/conf/serverConf.xml. Todos os parâmetros disponíveis no serverConf.xml estão listados nesta seção.

  2. Altere o valor do atributo command dos elementos spamCheck no nó Web. Para fazer isso, execute o seguinte comando:

    code language-none
    <spamCheck command='"<absolute path to the folder where you unzipped the zip file>\call_perl_with_args.bat" "<absolute path to nlserver>/spamcheck.pl"'/>
    
    note note
    NOTE
    Todos os caminhos devem ser absolutos.

    Pare e inicie o serviço Adobe Campaign.

  3. Para verificar a integração do SpamAssassin no Adobe Campaign, use um teste GTBUE (Teste genérico para emails em massa não solicitados):

    Clique duas vezes no arquivo portableshell.bat. Isso aciona a exibição de um Shell do Windows. Em seguida, execute o seguinte comando:

    code language-none
    perl "[INSTALL]\bin\spamcheck.pl" "C:\TestSpamMail.txt"
    

    O conteúdo deste email de teste aciona 1.000 pontos atribuídos pelo SpamAssassin. Isso significa que foi detectado como indesejável e que a integração no Adobe Campaign foi bem-sucedida e está totalmente funcional.

  4. Atualizar regras de pontuação e filtragem do SpamAssassin

    Para obter uma atualização inicial das regras de filtragem e pontuação, inicie o portableShell.bat e execute o seguinte comando:

    code language-none
    sa-update --no-gpg
    

    Para executar uma atualização automática de regras de filtragem e pontuação, use este mesmo comando em uma tarefa do sistema programada:

    code language-none
    sa-update --no-gpg
    

Instalando em uma máquina Linux installing-on-a-linux-machine

Etapas de instalação no Debian installation-steps-in-debian

  • Se necessário, instale o Perl e o SpamAssassin usando o seguinte comando:

    code language-none
    apt-get install spamassassin libxml-writer-perl
    
  • No arquivo serverConf.xml (disponível em /usr/local/[INSTALL]/nl6/conf/), altere a linha spamCheck da seguinte maneira:

    code language-none
    <spamCheck command="perl
    /usr/local/[NSTALL]/nl6/bin/spamcheck.pl"/>
    

Etapas de instalação no RHEL/CentOS installation-steps-in-rhel-centos

Se necessário, instale o Perl e recupere os pacotes usando CPAN:

cpan Digest::SHA1
cpan HTML::Parser
cpan Net::DNS
cpan Mail::SPF
cpan XML::LibXML
cpan XML::Writer
cpan Mail::SpamAssassin

Atualizando regras de filtro updating-filter-rules

As regras de filtro podem ser atualizadas automaticamente com a ferramenta sa-update. Consulte o site oficial do SpamAssassin https://spamassassin.apache.org/ para obter mais informações.

No Debian, as atualizações ocorrem automaticamente todos os dias.

Se esse não for o caso (por exemplo, quando o Debian for instalado manualmente), crie um script para automatizar as atualizações de regras.

!/bin/sh
test -x /usr/bin/sa-update || exit 0
/usr/sbin/sa-update && /etc/init.d/spamassassin update

Insira este script em crontab usando o seguinte comando:

crontab-e

Otimização do desempenho performance-optimization

Para melhorar o desempenho no Linux, edite o arquivo /etc/spamassassin/local.cf e adicione a seguinte linha ao final do arquivo:

dns_available no
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1