en cours de rédaction...
================== REMARQUE ================== Les paramètres dans ce document son extraits de la version 2.4.5 '''d'amavisd-new'''. Dans les prochaines mises à jour, un nouveau paramètre aura une annotation supplémentaire comme : '''Depuis 2.X.X''' et un paramètre obsolète aura : '''Obsolète depuis 2.X.X'''
Pour plus de détail, se référer à la documentation de Perl car tous les paramètres dans amavis sont en Perl.
$var = 'texte'; $var = 10; $var = $autre_var;
%var = ( 'key1' => 'value', 'key2' => 'value' );
@var = ['texte1', 'texte2']; @var = [1, 2, 3];
$var = undef : Désactive le paramètre $var = 2.1 : Décimal toujours séparés par un point $MYHOME : Répertoire de base pour amavis (vue par le chroot comme : /addons/amavis/var/amavis)
Quelques fonctions spéciales :
%var = read_hash("$MYHOME/local_domains");
@var = read_array('/etc/amavisd-mynetworks');
$var = read_text("$MYHOME/notify_virus_admin.txt");
$var = new_RE( qr'nimda|hybris|klez'i); @var = ( new_RE( qr'nimda|hybris|klez'i, qr'tanatos|lentin|bridex|mimail'i ) );
Des paramètres peuvent être regroupés par politique et attribué par domaine à l'aide de policy_bank et d'une utilisation particulière de Postfix.
Etant à l'intérieur d'un HASH (tableau associatif), ces paramètres doivent être utilisés en respectant certaines contraintes.
%final_destiny_by_ccat = ( CC_VIRUS, D_DISCARD, CC_BANNED, D_DISCARD, CC_UNCHECKED, D_BOUNCE, CC_SPAM, D_PASS, CC_BADH, D_PASS, CC_OVERSIZED, D_BOUNCE, CC_CLEAN, D_PASS, CC_CATCHALL, D_PASS, ); @spam_subject_tag_maps = undef; @spam_subject_tag2_maps = ['***SPAMMY*** ']; @spam_subject_tag3_maps = ['***SPAM*** ']; @spam_tag_level_maps = [-999.0]; @spam_tag2_level_maps = [8.0]; @spam_tag3_level_maps = [10.0]; @spam_kill_level_maps = [10.0]; ''' Ou plus généralement : ''' $sa_tag_level_deflt = -999.0; $sa_tag2_level_deflt = 8.0; $sa_tag3_level_deflt = 10.0; $sa_kill_level_deflt = 10.0;
$policy_bank{'POLITIQUE1'} = {
final_destiny_by_ccat => {(
CC_VIRUS, D_DISCARD,
CC_BANNED, D_DISCARD,
CC_UNCHECKED, D_BOUNCE,
CC_SPAM, D_PASS,
CC_BADH, D_PASS,
CC_OVERSIZED, D_BOUNCE,
CC_CLEAN, D_PASS,
CC_CATCHALL, D_PASS,
)},
spam_subject_tag_maps => undef,
spam_subject_tag2_maps => ['***SPAMMY*** '],
spam_subject_tag3_maps => ['***SPAM*** '],
spam_tag_level_maps => [-999.0],
spam_tag2_level_maps => [8.0],
spam_tag3_level_maps => [10.0],
spam_kill_level_maps => [10.0],
};
Vous trouverez ces valeurs dans les paramètres comme final_destiny_by_ccat ou final_XXXXX_destiny.
Date: %d From: %f Subject: SPAM FROM <%o> - \[%c\] To: [? %#T |undisclosed-recipients: ;|[<%T>|, ]] Message-ID: <SA%i@%h> --------------------------------------------------------------------- ID Quarantaine : %i --------------------------------------------------------------------- Policy : %p Hit : %c sur _REQD_ From : %o Subject : %j Reçu le : %d Client : %a - %g ------------------------- Destinataires ----------------------------- Non délivré(s) : %O Délivré(s) : %D [%A ]\ ------------------------- BEGIN HEADERS ----------------------------- Return-Path: %s [%H ]\ -------------------------- END HEADERS ------------------------------
Date: %d From: %f Subject: [? [:ccat_maj] |Clean (?) mail|Clean mail|TEMPFAIL-ed mail|\ OVERSIZED mail|INVALID HEADER in mail|spam|SPAM|UNCHECKED contents in mail|\ BANNED contents (%F) in mail|VIRUS (%V) in mail]\ FROM [?%l||LOCAL ][?%a||\[%a\] ][?%s|<>|[?%o|(?)|%s]] To: [? %#T |undisclosed-recipients: ;|[<%T>|, ]] [? %#C |#|Cc: [<%C>|, ]] Message-ID: <VA%i@%h> --------------------------------------------------------------------- Policy : %p Hit : %c From : %o Subject : %j Quar.ID : %i Msg.ID : %n Reçu le : %d Tag l2 : %2 MTA id : %Q Cli. IP : %a Cli. DNS: %g ------------------------- Destinataires ----------------------------- Non délivré(s) : %O Délivré(s) : %D --------------------------------------------------------------------- # Chemin vers le fichier en quarantaine %q [%A ]\ ------------------------- BEGIN HEADERS ----------------------------- Return-Path: %s [%H ]\ -------------------------- END HEADERS ------------------------------
Date: %d From: %f Subject: Notification: Action sur un message. To: [? %#T |undisclosed-recipients: ;|[<%T>|, ]] [? %#C |#|Cc: [<%C>|, ]] Message-ID: <VR%i@%h> Le message suivant n'a pas été livré. Date.............: %d Expéditeur.......: ([?%s|<>|[?%o|(?)|%s]]) Destinataire.....: %T Sujet............: %j Pièce jointe.....: %F Le message a été supprimé car il ne répondait pas aux normes de securité : Virus ou Attachement de pièce jointe non conforme (par exemple .exe, .bat, .com, ...)
Date: %d From: %f Subject: Notification: Action sur un message. To: [? %#T |undisclosed-recipients: ;|[<%T>|, ]] [? %#C |#|Cc: [<%C>|, ]] Message-ID: <VR%i@%h> Le message suivant a été supprimé. Date.............: %d Expéditeur.......: ([?%s|<>|[?%o|(?)|%s]]) Destinataire.....: %T Sujet............: %j Pièce jointe.....: %F Le message a été supprimé car il ne répondait pas aux normes de securité : Virus ou Attachement de pièce jointe non conforme (par exemple .exe, .bat, .com, ...)
%0 : recipient email address belong to local_domains_maps: L or 0
%1 : above tag level for this recipient: Y or 0
%2 : above tag2 level for this recipient: Y or 0
%a : Adresse IP du client original
%b : message digest of mail body (MD5, hex)
%c : Nombre de points que SpamAssassin a attribué au message
%d : Voir %date_rfc2822_local
%e : best guess of the originator IP address collected from the Received trace
%f : Email administrateur (utilisé dans le From:)
%g : Nom DNS du client original
%h : Nom dns du serveur en cours (variable $myhostname) ou résolution DNS
%i : quarantine id, e.g. name of the quarantine file, or empty ($VIRUSFILE)
%j : Champs 'Subject' du message d'origine
%k above kill level for this recipient: Y or 0
%l : true si l'expéditeur est dans local_domains, undef sinon
%m : Champs 'Message-ID' du message d'origine
%n : ID attribué par Amavis
%o : best attempt at determining true sender of the virus - normally same as %s
%p : Nom de la policy utilisé
%q : list of quarantine mailbox names, or empty if not quarantined
%r : first 'Resent-Message-ID' header field body #TODO: A tester
%s : Adresse originale de l'expéditeur prise dans le champs 'From' de l'enveloppe (rfc2821-quoted)
%t : Premier 'Received'
%u : Voir %date_unix_utc
%v : Dernier virus trouvé
%x : Spécial !!! Utilisé pour l'évaluation de macros
%y : Durée en ms pris pour le traitement du message par Amavis
%z : Taille originale du message en octets
%A : Rapport SpamAssassin pour les spam
%B : Liste des destinataires du champs 'Bcc:' (sur plusieurs lignes)
%C : Liste des destinataires du champs 'Cc:' (sur plusieurs lignes)
%D : Liste des destinataires qui ont effectivement reçus le message
%F : Liste des fichiers interdits (scr, vbs, etc...)
%H : Liste de toutes les entêtes (sauf 'Return-Path:' ou 'Delivered-To:')
%N : a list of recipients with UNsuccessful delivery status (will NOT get mail)
%O : Liste des destinataires qui n'ont pas reçus le message
%Q : queue ID du MTA
%R : Liste originale de tous les destinataires dans l'enveloppe
%S : address that will get sender notification;
%T : Liste des destinataires du champs 'To:' (sur plusieurs lignes)
%U : Voir %date_iso8601_utc
%V : Liste des virus trouvé
%W : Liste des scanners anti-virus detectés
%X : a list of header syntax violations
%date_unix_utc : timestamp of the message reception - Unix time (seconds since 1970-01-01T00:00Z as a decimal integer)
%date_iso8601_utc : timestamp of the message reception - ISO 8601 (EN 28601) UTC date-time
%date_iso8601_local : sub {iso8601_timestamp($MSGINFO->rx_time)}
%date_rfc2822_local : Date au format de la RFC 2822
[:header_field|Authentication-Results]
[:header_field|From]
[:wrap|78|| |Message-ID: %m] wrap with arguments: width, prefix, indent, string
lc lowercases arguments and concatenates them to a single string
uc uppercases arguments and concatenates them to a single string
len returns string length of its first argument
incr
decr
min
max
sprintf
join
dquote
uquote
substr
index
useragent
x-mailer
ccat_maj
ccat_min
ccat_name
AUTOLEARN autolearn status
DATE same as date_rfc2822_local
SCORE similar to macro 'c', but returns a single number (sum of
SA score and boost), and allows padding as per SA documentation.
In a per-message log ($log_templ) when a message has multiple
recipients, a minimum value is given;
STARS score as in macro SCORE, but represented as a bar of characters
REPORT a SA terse report of tests hit (for header reports)
SUMMARY similar to macro A, but provides a single multiline string,
a SA summary of tests hit for standard body reports
REMOTEHOSTADDR IP address of your connecting MTA (often 127.0.0.1)
REMOTEHOSTNAME your connecting MTA (often [127.0.0.1] or localhost)
TESTS similar to %T in logging, but without scores
TESTSSCORES similar to %T in logging, but allows to specify a separator
YESNO similar to macro '2', but provides Yes/No instead of 1/0
YESNOCAPS similar to macro '2', but provides YES/NO instead of 1/0
REQD minimal tag2 level of all recipients
Désactivation de filtre :
Gestion des Niveaux (score) :
Gestion de la Quarantaine :
Notifications :
Modification du sujet :
Performances :
Filtrage des pièces jointes :
Listes blanches / noires / lovers :
Protocole SMTP :
| Depuis la version | 2.4.3 |
| Type | Scalaire : $ |
| Description | Chargement de modules Perl supplémentaires |
| Syntaxe | ? |