Documentation de certaines variables d'Amavisd-new
Par Yves Tannier le lundi, septembre 28 2009, 21:17 - Le pingouin - Lien permanent
Une des particularités intéressantes d'Amavisd-new est de permettre le stockage des règles de filtrage dans une base de données (*SQL, LDAP... Mysql dans mon cas). Ceci est particulièrement pratique lorsqu'on souhaite appliquer une configuration différente par utilisateur et/ou par domaine concernant l'analyse antispam/antivirus.
Il existe plusieurs interfaces web pour la gestion de ces réglages. Cependant, souhaitant intégrer cette fonctionnalité à un panel déjà existant, j'ai développé la mienne (script non distribuable en l'état)
Pour cette réalisation, il était nécessaire de récapituler, en français, le rôle des différentes variables disponible. Voici le résultat. La version sous forme de tableau associatif PHP est à peine différente dans les formulations. Peut-être utile pour une personne souhaitant développer une interface de ce type.
Activer ou désactiver certaines analyses
- virus_lover : Recevoir les mails détectés comme virus
- spam_lover : Recevoir les mails détectés comme SPAM
- banned_files_lover : Recevoir les mails qui contiennent des pièces jointes non autorisées
Liste des interdits
- bad_header_lover : Recevoir les mails qui possèdent une mauvaise entête
- bypass_virus_checks : Désactiver complètement l'analyse antivirus
- bypass_spam_checks : Désactiver complètement l'antispam
- bypass_banned_checks : Désactiver complètement l'analyse simple des pièces jointes
- bypass_header_checks : Désactiver complètement l'analyse des entêtes de message
Modifier le comportement et le contenu des mails en fonction des résultats de l'analyse
- spam_modifies_subj : Modifier le sujet du mail pour les SPAM
- spam_tag_level : Score à partir duquel l'entête du mail contient le résultat de l'analyse (ne modifie pas le corps ou le sujet du mail. Seule l'entête est modifiée)
- spam_tag2_level : Score à partir duquel le mail est marqué comme SPAM et délivré au destinataire
- spam_kill_level : Score à partir duquel le mail est marqué comme SPAM et ne vous est pas délivré. Il est cependant mis en quarantaine sauf si vous avez modifié l'option spam_quarantine_cutoff_level
- spam_dsn_cutoff_level : Score à partir duquel l'expéditeur n'est pas prévenu que son mail a été considéré comme du SPAM. Nous vous déconseillons fortement de changer cette valeur si vous ne souhaitez pas que votre adresse mail soit enregistrée comme valide par les spammeurs
- spam_quarantine_cutoff_level : Score à partir duquel le mail est définitivement effacé (il n'est donc pas gardé en quarantaine pendant 30 jours)
- spam_subject_tag : Terme ajouté dans le sujet des mails sains (non spam, virus ou bannis)
- spam_subject_tag2 : Terme ajouté dans l'objet d'un mail soupçonné d'être un SPAM
Transférer les mails sur en fonction des résultats de l'analyse
- virus_quarantine_to : Envoyer les mails soupçonnés d'être des virus vers l'adresse spécifiée
- spam_quarantine_to : Envoyer les mails soupçonnés d'être des SPAM vers l'adresse spécifiée
- banned_quarantine_to : Envoyer les mails contenant des fichiers bannis vers l'adresse spécifiée
- bad_header_quarantine_to : Envoyer les mails avec une mauvaise entête vers l'adresse spécifiée
- clean_quarantine_to : Envoyer les mails corrects soupçonnés vers l'adresse spécifiée (peut-être utilisé pour l'archivage de vos messages)
- other_quarantine_to : Envoyer les mails soupçonnés d'être des SPAM vers l'adresse spécifiée
- addr_extension_virus : Ajouter une extension dans l'adresse d'un mail soupçonné d'être un SPAM. Exemple : monadresse+spam@example.tld
- addr_extension_spam : Ajouter une extension dans l'adresse d'un mail soupçonné d'être un SPAM. Exemple : monadresse+spam@example.tld
- addr_extension_banned : Ajouter une extension dans l'adresse d'un mail soupçonné d'être un SPAM. Exemple : monadresse+spam@example.tld
- addr_extension_bad_header : Ajouter une extension dans l'adresse d'un mail soupçonnés d'être un SPAM. Exemple : monadresse+spam@example.tld
- warnvirusrecip : Avertir le destinataire de la réception d'un virus
- warnbannedrecip : Avertir le destinataire de la réception d'un mail contenant un fichier banni
- warnbadhrecip : Avertir le destinataire de la réception d'un mail contenant une mauvaise entête
- newvirus_admin : Envoyer un rapport à cette adresse mail à la réception d'un mail supposé contenir un nouveau virus
- virus_admin : Envoyer un rapport à cette adresse mail à la réception d'un mail supposé contenir un virus
- banned_admin : Envoyer un rapport à cette adresse mail à la réception d'un mail contenant un fichier banni
- spam_admin : Envoyer un rapport à cette adresse mail à la réception d'un mail contenant une mauvaise entête
- banned_rulenames : Liste des types de fichiers bannis
Sensiblement la même chose mais sous forme de tableau PHP :
$array_amavis = array(
'spam' => array(
'name' => 'Antispam',
'values' => array(
'spam_lover' => array(
'name' => 'Recevoir <strong>tous</strong> les mails détectés comme SPAM malgré les autres réglages',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'bypass_spam_checks' => array(
'name' => 'Désactiver complètement l\'antispam (aucune analyse ne sera effectuée)',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'spam_modifies_subj' => array(
'name' => 'Modifier le sujet des mails soupçonnés d'être des SPAM',
'default' => 'N',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'spam_tag_level' => array(
'name' => 'Score à partir duquel l\'entête des mails contiennent le résultat de l\'analyse (ne modifie pas le corps ou le sujet des mail. Seule les entêtes "cachées" sont modifiées)',
'default' => '-9999.99',
'type' => 'numeric',
'values' => array('-9999.99' => '9999.99'),
),
'spam_tag2_level' => array(
'name' => 'Score à partir duquel les mails sont marqués comme SPAM <strong>et vous sont délivrés</strong>',
'default' => '6.31',
'type' => 'numeric',
'values' => array('-9999.99' => '9999.99'),
),
'spam_kill_level' => array(
'name' => 'Score à partir duquel les mails sont marqués comme SPAM mais <strong>ne vous sont pas délivrés</strong>. Ils sont cependant <strong>mis en quarantaine</strong> sauf si vous avez modifié l\'option <i>spam_quarantine_cutoff_level</i>',
'default' => '40',
'type' => 'numeric',
'values' => array('-9999.99' => '9999.99'),
),
'spam_dsn_cutoff_level' => array(
'name' => 'Score à partir duquel l\'expéditeur n\'est pas prévenu que son mail a été considéré comme du SPAM. Nous vous déconseillons fortement de changer cette valeur !',
'default' => '10',
'type' => 'numeric',
'values' => array('-9999.99' => '9999.99'),
),
'spam_quarantine_cutoff_level' => array(
'name' => 'Score à partir duquel <strong>les mails sont définitivement effacés</strong> (ils ne sont donc pas gardés en quarantaine pendant 30 jours). IL EST IMPOSSIBLE DE LES RÉCUPÉRER ENSUITE.',
'default' => '',
'type' => 'numeric',
'values' => array('-9999.99' => '9999.99'),
),
'spam_subject_tag' => array(
'name' => 'Terme ajouté dans le sujet des mails sains',
'default' => '',
'type' => 'string',
'maxvalue' => 30,
),
'spam_subject_tag2' => array(
'name' => 'Terme ajouté dans l\'objet des mails soupçonnés d'être des SPAM',
'default' => '[SPAM] ',
'type' => 'string',
'maxvalue' => 30,
),
'spam_quarantine_to' => array(
'name' => 'Envoyer les mails soupçonnés d\'être des SPAM vers l\'adresse spécifiée',
'default' => '',
'type' => 'mail',
),
'addr_extension_spam' => array(
'name' => 'Ajouter une extension dans votre adresse à la réception des mails soupçonnés d\'être des SPAM. Exemple : monadresse+spam@example.tld',
'default' => '',
'type' => 'mail',
),
'spam_admin' => array(
'name' => 'Envoyer un rapport à cette adresse à la réception des mails soupçonnés d\'être des SPAM',
'default' => '',
'type' => 'mail',
),
),
),
'virus' => array(
'name' => 'Antivirus',
'values' => array(
'virus_lover' => array(
'name' => 'Recevoir les mails détectés comme virus',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'bypass_virus_checks' => array(
'name' => 'Désactiver complètement l\'analyse antivirus',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'virus_quarantine_to' => array(
'name' => 'Envoyer les mails soupçonnés d\'être des virus vers l\'adresse spécifiée',
'default' => '',
'type' => 'mail',
),
'addr_extension_virus' => array(
'name' => 'Ajouter une extension dans votre adresse à la réception des mails contenant des virus. Exemple : monadresse+virus@example.tld',
'default' => 'virus',
'type' => 'mail',
),
'warnvirusrecip' => array(
'name' => 'Avertir le destinataire de la réception d\'un mail contenant un virus',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'newvirus_admin' => array(
'name' => 'Envoyer un rapport à cette adresse à la réception d\'un mail contenant un nouveau virus',
'default' => '',
'type' => 'mail',
),
'virus_admin' => array(
'name' => 'Envoyer un rapport à cette adresse à la réception d\'un mail contenant un virus connu',
'default' => '',
'type' => 'mail',
),
),
),
'banned' => array(
'name' => 'Extensions de fichier interdites',
'values' => array(
'banned_files_lover' => array(
'name' => 'Recevoir les mails qui contiennent des pièces jointes non autorisées',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'bypass_banned_checks' => array(
'name' => 'Désactiver complètement l\'analyse simple des pièces jointes',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'banned_quarantine_to' => array(
'name' => 'Envoyer les mails contenant des fichiers bannis vers l\'adresse spécifiée',
'default' => '',
'type' => 'mail',
),
'addr_extension_banned' => array(
'name' => 'Ajouter une extension dans votre adresse à la réception des mails qui contiennent des fichiers bannis. Exemple : monadresse+banned@example.tld',
'default' => 'banned',
'type' => 'mail',
),
'warnbannedrecip' => array(
'name' => 'Avertir le destinataire de la réception d\'un mail contenant un fichier banni',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'banned_admin' => array(
'name' => 'Envoyer un rapport à cette adresse à la réception des mails contenant des fichiers bannis',
'default' => '',
'type' => 'mail',
),
),
),
'badh' => array(
'name' => 'Entêtes de message non-valide',
'values' => array(
'bad_header_lover' => array(
'name' => 'Recevoir les mails qui possèdent une mauvaise entête',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'bypass_header_checks' => array(
'name' => 'Désactiver complètement l\'analyse des entêtes de message',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
'bad_header_quarantine_to' => array(
'name' => 'Envoyez les mails avec une mauvaise entête vers l\'adresse spécifiée',
'default' => '',
'type' => 'mail',
),
'addr_extension_bad_header' => array(
'name' => 'Ajouter une extension dans votre adresse à la réception des mails avec une mauvaise entête. Exemple : monadresse+badh@example.tld',
'default' => 'badh',
'type' => 'mail',
),
'warnbadhrecip' => array(
'name' => 'Avertir le destinataire de la réception des mails contenant une mauvaise entête',
'default' => 'N',
'type' => 'select',
'values' => array('Y' => 'Oui', 'N' => 'Non'),
),
),
),
'others' => array(
'name' => 'Autres paramètres',
'values' => array(
'clean_quarantine_to' => array(
'name' => 'Envoyez les mails corrects vers l\'adresse spécifiée (peut-être utilisé pour l\'archivage de vos messages)',
'default' => '',
'type' => 'mail',
),
'banned_rulenames' => array(
'name' => 'Liste des types de fichiers bannis',
),
),
)
);
Je ne rentrerais pas dans le détail concernant la configuration d'Amavis. Vous trouverez plein d'infos sur le site de Tonio (qui m'a d'ailleurs éclairé sur le rôle de certains champs) ou avec une petite recherche web
