[On-Premise/hybride uniquement]{class="badge yellow" title="S’applique uniquement aux déploiements on-premise et hybrides"}

Paramétrage de SpamAssassin configuring-spamassassin

NOTE
Pour les déploiements hébergés par Adobe, certaines configurations peuvent uniquement être effectuées par Adobe, comme l'accès aux fichiers de configuration de serveur et d’instance. Pour en savoir plus sur les différents déploiements, consultez la section Modèles d'hébergement ou cette page.

Vue d'ensemble overview

SpamAssassin est un logiciel destiné à filtrer les emails indésirables. Intégré à Adobe Campaign, il permet d’attribuer un score aux emails créés dans la plateforme et d’évaluer le risque que les messages soient considérés comme indésirables par les messageries des destinataires avant qu’une diffusion ne soit lancée. Pour cela, SpamAssassin doit être installé et configuré sur le ou les serveurs d’application d’Adobe Campaign et requiert un certain nombre de modules additionnels en Perl pour fonctionner.

Le déploiement et l'intégration de SpamAssassin décrits dans ce chapitre sont basés sur l'installation par défaut du logiciel, de même que les règles de filtrage et de scores qui sont celles fournies par SpamAssassin sans modification ou optimisation aucune. L'attribution des scores et la qualification des messages reposant exclusivement sur la configuration des options de SpamAssassin et sur l'utilisation des jeux de règles de filtrage, il reviendra à chaque administrateur réseau de les adapter aux besoins de son entreprise.

IMPORTANT
La qualification des emails comme indésirables par SpamAssassin repose entièrement sur les règles de filtrage et de scoring.
Ces règles doivent donc être mises à jour au moins une fois par jour pour que votre installation de SpamAssassin et son intégration dans Adobe Campaign soient entièrement fonctionnelles et pour garantir la pertinence des scores attribués à vos diffusions avant envoi.
Cette mise à jour est de la responsabilité de l'administrateur serveur qui héberge SpamAssassin.

L'utilisation de SpamAssassin dans Adobe Campaign permet de donner une indication sur le comportement éventuel des serveurs de messagerie, utilisant eux-mêmes SpamAssassin, à la réception des emails envoyés par Adobe Campaign. Il se peut toutefois que les serveurs de messagerie des fournisseurs d'accès Internet ou les messageries Web considèrent malgré tout les messages envoyés par Adobe Campaign comme indésirables.

Le déploiement de SpamAssassin et de ses modules en Perl nécessite impérativement que les serveurs d'application Adobe Campaign sur lesquels ils sont installés aient accès à Internet via une connexion HTTP (flux TCP/80).

Installation sur une machine Windows installing-on-a-windows-machine

Pour installer et configurer SpamAssassin sous Windows afin d'en permettre l'intégration avec Adobe Campaign, les étapes sont les suivantes :

  1. Installer SpamAssassin
  2. Intégrer SpamAssassin dans Adobe Campaign

Installation de SpamAssassin installing-spamassassin

  1. Connectez-vous au portail de distribution de logiciels à l’aide de vos informations d’identification d’utilisateur. En savoir plus sur la distribution de logiciels sur cette page.

  2. Téléchargez le fichier Neolane Spam Assassin (Windows Installation) (2.0) (neolane_spamassassin.2.0.zip).

  3. Copiez ce fichier sur le serveur Adobe Campaign puis décompressez-le.

    note note
    NOTE
    Vous pouvez décompresser le fichier à l'emplacement de votre choix. Cependant, assurez-vous que le chemin d'accès à ce dernier comporte uniquement des caractères de l'expression régulière suivante : -_A-Za-z\xA0-\xFF0-9\.\%\@\=+\,\/\\\:.. Le chemin d'installation ne doit pas comporter d'espace.
  4. Accédez au dossier dans lequel vous avez décompressé le fichier puis double-cliquez sur le fichier run_me.bat afin de lancer le script d'installation.

    Si un Shell Windows apparaît et reste affiché durant plusieurs secondes, attendez que l'installation et la mise à jour soient terminées puis appuyez sur Entrée.

    Si le shell Windows n’apparaît pas ou s’il apparaît puis disparaît instantanément, procédez comme suit : double-cliquez sur le fichier portableShell.bat afin d'afficher un shell Windows et vérifiez que le chemin du shell correspond au dossier dans lequel le fichier spamassassin.zip a été décompressé. Si ce n’est pas le cas, accédez-y à l’aide de la commande cd.

    Entrez run_me.bat puis appuyez sur Entrée afin de lancer le processus d'installation et de mise à jour. L'opération renvoie l'une des valeurs suivantes afin d'indiquer le résultat de la mise à jour :

    • 0  : une mise à jour a été effectuée.
    • 1  : aucune nouvelle mise à jour n'était disponible.
    • 2  : aucune nouvelle mise à jour n'était disponible.
    • 3  : la mise à jour a échoué lors de la vérification préalable.
    • 4 ou plus : une erreur s'est produite.
  5. Vérifiez que l'installation de SpamAssassin s'est bien déroulée en effectuant le test GTUBE (Generic Test for Unsolicited Bulk Email) selon la procédure décrite ci-après :

    1. Créez un fichier texte et enregistrez-le sous C:\TestSpamMail.txt.

    2. Insérez le contenu suivant dans ce fichier :

      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. Double-cliquez sur le fichier portableShell.bat afin d'afficher un Shell Windows puis lancez la commande suivante (où « <root> » désigne le dossier créé lors de la décompression du fichier spamassassin.zip) :

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

      Le contenu de cet e-mail de test déclenche l'attribution par SpamAssassin d'un score de 1000 points au message. Cela signifie qu'il a bien été détecté comme indésirable et que l'installation a été correctement réalisée et est désormais fonctionnelle.

Intégration de SpamAssassin dans Adobe Campaign integrating-spamassassin-into-adobe-campaign

  1. Editez le fichier [INSTALL]/conf/serverConf.xml. Tous les paramètres disponibles dans le fichier serverConf.xml sont répertoriés dans cette section.

  2. Modifiez la valeur de l'attribut spamCheck de l'élément command du nœud Web. Pour cela, exécutez la commande suivante :

    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
    Tous les chemins doivent être absolus.

    Arrêtez puis redémarrez le service Adobe Campaign.

  3. Vérifiez l'intégration de SpamAssassin dans Adobe Campaign en effectuant le test GTUBE (Generic Test for Unsolicited Bulk Email) :

    Double-cliquez sur le fichier portableShell.bat afin d'afficher un Shell Windows puis lancez la commande suivante :

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

    Le contenu de cet e-mail de test déclenche l'attribution par SpamAssassin d'un score de 1000 points au message. Cela signifie qu'il a bien été détecté comme indésirable et que l'intégration dans Adobe Campaign a été correctement réalisée. Elle est désormais fonctionnelle.

  4. Mettez à jour les règles de filtrage et de scores de SpamAssassin

    Pour une première mise à jour des règles de filtrage et de scores, lancez portableShell.bat et exécutez la commande suivante :

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

    Pour effectuer la mise à jour automatisée des règles de filtrage et de scores, utilisez cette même commande dans une tâche système planifiée :

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

Installation sur une machine Linux installing-on-a-linux-machine

Etapes d'installation sous Debian installation-steps-in-debian

  • Au besoin, installez Perl et SpamAssassin à l'aide de la commande suivante :

    code language-none
    apt-get install spamassassin libxml-writer-perl
    
  • Dans le fichier serverConf.xml (disponible sous /usr/local/[INSTALL]/nl6/conf/), modifiez la ligne spamCheck comme suit :

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

Etapes d'installation sous RHEL/CentOS installation-steps-in-rhel-centos

Au besoin, installez Perl et récupérez les packages à l'aide de CPAN :

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

Mise à jour des règles de filtrage updating-filter-rules

Les règles de filtrage peuvent être mises à jour automatiquement à l’aide de l’outil sa-update. Pour plus d’informations, consultez le site web officiel de SpamAssassin https://spamassassin.apache.org/.

Sous Debian, la mise à jour est automatique et quotidienne.

Si cela ne devait pas être le cas (par exemple, dans le cas d'une installation manuelle de Debian), créez un script afin d'automatiser la mise à jour des jeux de règles.

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

Insérez ce script dans crontab à l'aide de la commande suivante :

crontab-e

Optimisation des performances performance-optimization

Pour améliorer les performances sous Linux, modifiez le fichier /etc/spamassassin/local.cf et ajoutez la ligne suivante à la fin du fichier :

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