hMailServer-5-3 - Guide de L'utilisateur

Copyright <2013> by <philou-traductions.com>. Tous Droits Rservs.
hMailServer - Guide de
l'Utilisateur
hMailServer - Guide de l'Utilisateur
2 / 214
Table des matires
Avant l'installation ............................................................................................... 7
Qu'est-ce que hMailServer? .............................................................................. 7
Qu'est-ce que SMTP, POP3 et IMAP? ................................................................. 7
A Propos de hMailServer 5.3 ............................................................................ 8
Informations sur l'auteur ................................................................................ 10
Journal des Changements de hMailServer ......................................................... 10
Installation ....................................................................................................... 10
Configuration Systme Requise ....................................................................... 10
Choisir un moteur de base de donnes ............................................................ 12
Guide de dmarrage rapide ............................................................................ 13
Didacticiel d'Installation .............................................................................. 13
Didacticiel de Configuration ........................................................................ 18
Installation de PHPWebAdmin .................................................................... 20
Scnarios d'Installation .................................................................................. 21
Simple serveur, adresse IP dynamique ......................................................... 21
Simple serveur, adresse IP statique ............................................................. 23
Mise niveau ................................................................................................ 24
Conseils de mises niveau ......................................................................... 24
Mise niveau: 3.x vers 4.0 ......................................................................... 25
Mise niveau: 4.x vers 5.0 ......................................................................... 27
Mise niveau: 5.0 vers 5.1 ......................................................................... 28
Mise niveau: 5.1 vers 5.2 ......................................................................... 29
Mise niveau: 5.2 vers 5.3 ......................................................................... 31
Revenir la version prcdente ................................................................... 31
Configuration .................................................................................................... 32
Compte ........................................................................................................ 32
Avanc ......................................................................................................... 36
Alias ............................................................................................................ 36
Antispam ..................................................................................................... 37
Antivirus ...................................................................................................... 40
Interdiction automatique ................................................................................ 42
Sauvegarde .................................................................................................. 43
Liste de diffusion ........................................................................................... 44
Liste noire DNS ............................................................................................. 45
Domaine ...................................................................................................... 45
Comptes externes .......................................................................................... 48
Liste grise ..................................................................................................... 50
Groupe ........................................................................................................ 51
Configuration IMAP ....................................................................................... 52
Relais entrant ................................................................................................ 53
Configuration du fichier ini ............................................................................. 53
Plage IP ....................................................................................................... 55
Activit ........................................................................................................ 57
Cration des journaux .................................................................................... 57
Miroir ........................................................................................................... 58
Requte MX .................................................................................................. 58
Performance ................................................................................................. 59
3 / 214
POP3 settings ............................................................................................... 60
Protocoles .................................................................................................... 60
Routage ....................................................................................................... 60
Rgles .......................................................................................................... 63
Exemples de rgle ..................................................................................... 66
Scripts ......................................................................................................... 68
OnAcceptMessage ..................................................................................... 69
OnBackupCompleted ................................................................................. 70
OnBackupFailed ........................................................................................ 70
OnClientConnect ....................................................................................... 70
OnDeliverMessage ..................................................................................... 71
OnDeliveryFailed ....................................................................................... 71
OnDeliveryStart ......................................................................................... 72
OnError ................................................................................................... 72
OnExternalAccountDownload ...................................................................... 72
Message du serveur ....................................................................................... 73
Envoi du serveur ........................................................................................... 73
Configuration ................................................................................................ 74
Configuration SMTP ....................................................................................... 74
Certificat SSL ................................................................................................ 76
tat ............................................................................................................. 79
Serveurs SURBL ............................................................................................ 80
Port TCP/IP .................................................................................................. 80
Utilitaires ...................................................................................................... 81
Accueil ......................................................................................................... 81
Liste blanche ................................................................................................. 81
Dpannage ....................................................................................................... 83
Messages d'erreur .......................................................................................... 83
Messages d'erreur de la base de donnes ..................................................... 83
Messages d'erreur DNS .............................................................................. 83
Messages d'erreur hMailServer Administrator ................................................ 84
Messages d'erreur SMTP ............................................................................. 84
Conseils de dpannage .................................................................................. 91
Dpannage d'une rgle .............................................................................. 91
Envoyer de messages ................................................................................ 92
Recevoir des messages .............................................................................. 93
Autres conseils de dpannage... .................................................................. 94
Ports bloqus ........................................................................................ 94
Connexion la base de donnes ............................................................. 95
Connexion via le client de messagerie ...................................................... 95
hMailServer choue pour distribuer les messages certains serveurs ........... 96
Problmes MX ....................................................................................... 97
Port SMTP non par dfaut ..................................................................... 98
Plantages Outlook ................................................................................. 98
Problmes d'installation de PHPWebAdmin ............................................... 99
Serveur utilis pour les spams ............................................................... 100
Lancer lee serveur ............................................................................... 101
Mot de passe erron ............................................................................ 102
Maintenance .................................................................................................... 102
Database maintenance ................................................................................. 102
4 / 214
Sauvegarde & Restauration ........................................................................... 102
Migrer sur un nouveau serveur ...................................................................... 103
Autres ............................................................................................................ 105
propos des destinataires du message .......................................................... 105
Mthodes Anti-spam .................................................................................... 106
Mise en cache .............................................................................................. 109
API COM .................................................................................................... 110
Objet Account ......................................................................................... 112
Objet Accounts ....................................................................................... 115
Objet Alias ............................................................................................. 116
Objet Aliases .......................................................................................... 116
Objet AntiSpam ...................................................................................... 117
Objet AntiVirus ....................................................................................... 119
API Exemple: Changer le mot de passe d'un compte ................................... 120
API Exemple: Copier un message dans un nouveau dossier IMAP ................. 120
API Exemple: Crer un compte ................................................................. 121
API Exemple: Supprimer un compte .......................................................... 122
API exemple: Activer un domaine ............................................................. 122
API exemple: Liste des dossiers d'un utilisateur .......................................... 122
API exemple: Envoyer un message ............................................................ 123
Objet Application .................................................................................... 124
Objet Attachment .................................................................................... 125
Objet Attachments ................................................................................... 125
Objet Backup .......................................................................................... 126
Objet BackupManager .............................................................................. 127
Objet BackupSettings ............................................................................... 127
Objet BlockedAttachment ......................................................................... 127
Objet BlockedAttachments ........................................................................ 128
Objet Cache ............................................................................................ 129
Objet Client ............................................................................................ 130
API COM: ChangeLog .............................................................................. 130
API COM: Structure API ........................................................................... 137
Objet Database ....................................................................................... 137
Objet DeliveryQueue ................................................................................ 139
Objet Directories ..................................................................................... 139
Objet DistributionList ............................................................................... 140
Objet DistributionListRecipient .................................................................. 141
Objet DistributionListRecipients ................................................................. 141
Objet DistributionLists .............................................................................. 141
Objet DNSBlackList .................................................................................. 142
Objet DNSBlackLists ................................................................................. 143
Objet Domain ......................................................................................... 144
Objet DomainAlias .................................................................................. 146
Objet DomainAliases ............................................................................... 146
Objet Domains ........................................................................................ 147
Objet EventLog ....................................................................................... 148
Objet FetchAccount ................................................................................. 148
Objet FetchAccounts ................................................................................ 149
Objet GlobalObjects ................................................................................. 150
Objet GreyListingWhiteAddress ................................................................. 150
5 / 214
Objet GreyListingWhiteAddresses .............................................................. 151
Objet Group ........................................................................................... 152
Objet GroupMember ................................................................................ 152
Objet GroupMembers ............................................................................... 153
Objet Groups .......................................................................................... 153
Objet IMAPFolder .................................................................................... 154
Objet IMAPFolderPermission .................................................................... 155
Objet IMAPFolderPermissions ................................................................... 156
Objet IMAPFolders .................................................................................. 157
Objet Language ....................................................................................... 157
Objet Languages ..................................................................................... 157
Objet Links ............................................................................................. 158
Objet Logging ......................................................................................... 158
Objet Message ........................................................................................ 160
Objet MessageHeader .............................................................................. 162
Objet MessageHeaders ............................................................................. 162
Objet Messages ....................................................................................... 162
Objet Recipient ....................................................................................... 163
Objet Recipients ...................................................................................... 164
Objet Result ........................................................................................... 164
Objet Route ............................................................................................ 164
Objet RouteAddress ................................................................................. 165
Objet RouteAddresses .............................................................................. 166
Objet Routes ........................................................................................... 166
Objet Rule .............................................................................................. 167
Objet RuleAction ..................................................................................... 168
Objet RuleActions .................................................................................... 169
Objet RuleCriteria .................................................................................... 170
Objet RuleCriterias .................................................................................. 171
Objet Rules ............................................................................................. 172
Objet Scripting ........................................................................................ 172
Objet SecurityRange ................................................................................ 173
Objet SecurityRanges ............................................................................... 174
Objet ServerMessage ............................................................................... 175
Objet ServerMessages .............................................................................. 175
Objet Settings ......................................................................................... 176
Objet SSLCertificate ................................................................................. 180
Objet SSLCertificates ................................................................................ 180
Objet Status ............................................................................................ 181
Objet SURBLServer .................................................................................. 182
Objet SURBLServers ................................................................................ 182
Objet TCPIPPort ...................................................................................... 183
Objet TCPIPPorts .................................................................................... 184
Objet Utilities .......................................................................................... 184
Objet WhiteListAddress ............................................................................ 186
Objet WhiteListAddresses ......................................................................... 186
Synchroniseur du rpertoire Data .................................................................. 187
Configuration des antivirus externes .............................................................. 188
Implmentation de fonctionnalits ................................................................. 189
Questions souvent poses ............................................................................ 189
6 / 214
FAQ: Informations d'hbergement ............................................................ 191
Stocker les pices jointes seules sur le disque dur ....................................... 191
Enregistrer le message dans la base de donnes ......................................... 191
Pourquoi des dossiers vides dans le rpertoire Data? ................................... 192
Structure d'un dossier hMailServer ................................................................. 193
COMMENT.. ................................................................................................ 194
Agir en tant que sauvegarde MX ................................................................ 194
Administrer distance hMailServer ............................................................ 196
Effacer la file d'attente de distribution ........................................................ 197
Se connecter MySQL .............................................................................. 197
Permissions DCOM .................................................................................. 198
Examen antiviral externe - valeur de retour ................................................ 198
Changer le mot de passe administrateur ..................................................... 199
Dterminer le mot de passe MySQL hMailServer .......................................... 200
Activer l'authentification SMTP dans le client de messagerie .......................... 200
Installer les outils clients de hMailServer ..................................................... 200
Rgler manuellement la langue de hMailServer ........................................... 200
Dplacer les spams dans un dossier IMAP .................................................. 201
Recrer la liste des messages dans la base de donnes ................................ 202
Rparer une table MySQL corrompue ......................................................... 203
Rinitialiser le mot de passe de MySQL ...................................................... 204
Router tous les messages sortants via un autre serveur ................................ 204
Dfinir des plages IP pour votre rseau priv .............................................. 205
Mettre en place un serveur local / autonome ............................................... 206
Utiliser ASSP ........................................................................................... 207
Changer le dossier Data ........................................................................... 208
Informations IMAP ...................................................................................... 208
Extension IMAP Sort .................................................................................... 209
Prise en charge IPv6 .................................................................................... 209
Tests des relais ouvert ................................................................................. 211
Gestion distance ....................................................................................... 211
Fonctionnement interne ................................................................................ 212
Gestionnaires de commande ..................................................................... 212
Les RFC .................................................................................................. 213
Traduction ...................................................................................................... 214
7 / 214
Avant l'installation
Qu'est-ce que hMailServer?
Vue d'Ensemble
hMailServer est un serveur de messagerie pour Microsoft Windows. Il vous permet de manipuler
tous vos e-mail vous-mme sans avoir recours un Fournisseur d'Accs Internet (FAI) pour les
grer. Au lieu de laisser votre FAI hberger vos e-mails, hMailServer ajoute flexibilit et scurit, et
vous procure le contrle complet sur la protection anti spam.
Historique
Le projet hMailServer a dbut en 2002 avec Martin Knafve. depuis cette poque, il est devenu
l'un des serveurs de messagerie les plus populaires pour Windows. depuis le dbut, le but a t
de crer un systme de messagerie simple utiliser et qui incluttoutes les fonctions essentielles
ncessaires. Le projet a dbut chez SourceForge.net, mais a t dplac par la suite sur son
propre site web. hMailServer est gratuit, et tout le code source peut tre rcupr sur NovellForge
de Novell
Qu'est-ce que SMTP, POP3 et IMAP?
Gnralits
SMTP, POP3 et IMAP sont des protocoles TCP/IP utiliss pour la diffusion des e-mails. Si vous
prvoyez installer un serveur de messagerie tel hMailServer, vous devez savoir quoi il sert.
Chaque protocole est un simple jeu de rgles de communication spcifique entre ordinateurs.
SMTP
SMTP signifie Simple Mail Transfer Protocol. SMTP est utilis lorsqu'un e-mail est envoy partir
d'un client de messagerie tel Outlook Express, vers un serveur de messagerie, ou lorsqu'un e-mail
est dlivr d'un serveur de messagerie vers un autre. SMTP utilise le port 25.
POP3
POP3 signifie Post Office Protocol. POP3 permet tlcharger un e-mail sepuis un serveur de
messagerie. Le protocole POP3 est simple et n'offre pas de nombreuses fonctionnalits sauf pour
le tlchargement. Sa conception suppose que le client de messagerie tlcharge tous les e-mails
disponibles depuis le serveur, les efface du serveur et se dconnecte. POP3 utilise normalement le
port 110.
IMAP
IMAP signifie Internet Message Access Protocol. IMAP partage plusieurs fonctionnalits semblebles
avec POP3. Il s'agit, aussi, d'un protocole qu'un client de messagerie peut utiliser pour tlcharger
les messages partir d'un serveur de messagerie. Cependant, IMAP inclut beaucoup plus de
fonctionnalits que POP3. Le protocole IMAP est conu pour laisser l'utilisateur conserver ses e-
mails sur le serveur. IMAP ncessite davantage d'espace disque sur le serveur et davantage de
ressources CPU que POP3, car tous les messages sont stocks sur le serveur. IMAP utilise
normalement le port 143. Vous trouverez ici plus d'informations sur IMAP.
Exemple
Supposons que vous utilisiez hMailServer comme votre serveur de messagerie pour envoyer un e-
8 / 214
mail bill@microsoft.com.
1.Vous cliquez sur Envoyer dans votre client de messagerie, disons, Outlook Express.
2.Outlook Express dlivre le message hMailServer en utilisant le protocole SMTP.
3.hMailServer dlivre le message au serveur de messagerie de Microsoft, mail.microsoft.com, en
utilisant le protocole SMTP.
4.Le client Mozilla Mail de Bill tlcharge le message depuis mail.microsoft.com vers son ordinateur
portable en utilisant le protocole POP3 (ou IMAP).
A Propos de hMailServer 5.3
Nouveauts dans hMailServer 5.3
Nouvelles fonctionnalits majeures:
Prise en charge pour IPv6
Autres amliorations:
Dans la requte MX, vous pouvez dsormais effectuer un clic droit sur les lignes et copier dans le
presse-papiers.
Il est dsormais possible de contourner les listings griss si une connexion provient d'un MX ou
d'un enregistrement pour le domaine d'envoi.
Un nouvel vnement a t ajout, OnExternalAccountDownload
News in hMailServer 5.2
Major new features:
When an email is sent from a local domain, the sender is now considered local. This means that if
a message arrives from an alias address, such as alias@example.com, hMailServer will require
SMTP authentication by default. The purpose of this is to stop spammers sending messages from
local domains. In earlier versions, SMTP authentication was only required when sending messages
from local accounts. Note that this also affects routes.
A basic diagnostic tool has been added to hMailServer Administrator and WebAdmin. The
diagnostic tool performs basic tests on your set up and checks DNSsettings. The purpose of the
diagnostic tool is to help you troubleshooting.
In the performance settings, it's now possible to enable Message indexing. When this is enabled,
some additional message meta data is stored in the database. This can greatly improve browsing
speed in large folders when using a webmail client.The downside of this feature is that the
database size will increase. It's not recommended to enable this feature unless you're
experiencing performance problems related to large folders in web mail.
Other improvements:
If MySQL with InnoDB was used, message ID's could sometimes repeat themselves, which could
lead to lost messages (client dependant).This was reported as issue 213.
Attachment names containing non-latin characters didn't always show up properly, issue 218.
If a message is downloaded from an external account, the message was not delivered to
recipients on routes. There is now a new option in the external account settings which allows you
to enable this behavior.Issue 215.
In the grey listing options you can now choose to bypass greylisting if SPF passes.
The IMAP property UIDNEXT has now been implemented. This makes it possible to use
hMailServer with POPfile.
A new rule action has been added; Create Copy. This can be used for example to deliver copies of
the same message to different destination servers.
A new rule criteria has been added; Delivery attempts. This can be used for example to deliver
messages to different routes, depending on the current number of delivery attempts.
When you delete items in hMailServer Administrator, you now need to confirm the deletion before
it's performed. This should reduce the number of accidental deletes.
9 / 214
The database upgrade is now done in a transaction (assuming the underlying database supports
it). This should reduce problems if something goes wrong during a database upgrade.
If hMailServer tries to deliver the same message multiple times, global rules will now be executed
every time.
If a Date header contained the timezone "GMT" (with quotes, obsolete syntax) the message was
not displayed if Outlook Express was used(Issue 209)
SMTP connection sometimes dropped during DKIM verification. The problem occured if
DKIMrecords in the DNS contained CNAME records.
News in hMailServer 5.1
Major new features:
hMailServer 5.1 supports Domain Keys Identified Mail,DKIM. hMailServer can verify signatures of
incoming email and sign outgoing email. Email messages which have been DKIM-signed receives
higher trust from sme large Internet email servers, making it less likely that your email is treated
as spam.
Using the new auto-ban settings, you can configure hMailServer to automatically disconnect and
temporarily ban users after too many failed logon attempts.
Other improvements:
A few new settings have been added to IPranges. IP ranges in 5.1 allows more fine-grained
control over authentication.
The user interfaec in WebAdmin has been updated. The interface is now tab-based, which makes
it more easy to navigate.
News in hMailServer 5
Major new features:
Score based spam protection. In version 5, every spam protection mechanism generates a spam
score for an email message. If the total spam score reaches a certain threshold, the message will
be marked as spam. If it reaches an even higher threshold, it may be deleted. This new
functionality will improve the overall spam classification of messages.
Built in SSL encryption. Using this new functionality, you can set up a secure connection
between hMailServer installation and your users. The SSL functionality is also available when
hMailServer communicates with other servers which supports SSL. For example, you no longer
need to use external tools to download messages from otherSSLPOP3 servers.
hMailServer 5 includes a SpamAssassin integration which makes spam detection more efficient.
After SpamAssassin has been installed, you can configure hMailServer to use it simply by enabling
the integration.
hMailServer now supports Public folders. You can now set up public folders which some or all
users on the server can access. It is possible to give users (or groups) separate permissions for
these public folders, for example to make sure that only moderators can add or delete messages
in the folder. Messages can be put into these public folders either manually, or by using rules.
Other improvements:
hMailServer is now officially tested with Windows Vista and Windows Server 2008.
Support for PostgreSQL have been added. Next to MySQL and Microsoft SQL Server, hMailServer
can now use PostgreSQL as backend store.
Fully integrated database. In earlier versions, MySQL was bundled as the default database
option. In version 5, this has been changed to MSSQL CE. The database engine will be hosted by
hMailServer which makes hMailServer easier to install. Upgrades will not be affected by this
change.
It's now possible to trigger a manual download of messages from external accuonts.
In the account settings, you can now create and delete IMAP folders connected to the accounts.
You can also manually empty accounts.
A Delivered-To header can be added to incoming messages. This header will contain the value of
10 / 214
the recipient address specified in the SMTP conversation.
In hMailServer Administrator, it's now possible to see the number of currently active SMTP, POP3
and IMAP sessions.
You can now define a maximum size of messages which are going to be scanned for spam.
In hMailServer 5, you can use rules to specify which route should be used when delivering a
message. This makes it possible to override the default routing functionality.
In version 5, the hMailServer COM API has full support for Unicode. This means that scripts which
accesses email data will have no problem accessing messages containing for example japanese or
arabic characters.
A lot of new functionality have been added to the hMailServer COM API. See the Com API change
log for more information.
And more...
Informations sur l'auteur

La technologie de serveur et la conception gnrale de hMailServer est l'uvre de Martin Knafve.
Le logiciel utilise un certain nombre de composants et de bibliothques tiers.
Encodage / dcodage Mime par Jeff Lee
Algorithme MD5 par RSA Data Security
Algorithme Blowfish par Bruce Schneier
Bibliothque SPF par Roger Moser
Boost par boost.org
Winsock, ATL, ADO etc par Microsoft
InnoSetup par JR Software
ToolkitCe produit inclut un logiciel dvelopp par le Projet OpenSSL pour utilisation dans le
OpenSSL (http://www.OpenSSL.org/).
Informations de Contact
Martin Knafve
Nedre Lngvinkelsgatan 21
252 20 Helsingborg
Sweden
martin@hmailserver.com
Phone:+46 (0)42 30 10000
Cell: +46 (0)73 82 00 781
Journal des Changements de hMailServer
Le journal des changement a t dplac
Le journal des changements a t dplac sur http://www.hmailserver.com/?page=changelog.
Vous devez actualiser vos signets.
Installation
Configuration Systme Requise
Systme d'Exploitation
hMailServer peut tre install sur les systmes d'exploitation ci-dessous. Le dernier pack service
Windows disponible doit tre install. hMailServer n'a t test que sur les systmes
d'exploitation suivants, mais peut aussi fonctionner sur les autres versions des systmes
11 / 214
d'exploitation. Seules les versions ci-dessous sont officiellement et rgulirement testes.
hMailServer 5
Microsoft Windows 2008 (toutes ditions, sauf Core)
Microsoft Windows Vista
Microsoft Windows 2003 (toutes ditions)
Microsoft Windows XP Professionnel
hMailServer 4.3 and 4.4
La prise en charge de Windows NT a t supprime depuis que Microsoft ne prend plus en charge
ce systme d'exploitation.
hMailServer 4.2
Microsoft Windows NT
Autres Logiciels
Serveur de base de donnes
hMailServer a t conu pour fournir, sous un seul tlchargement, tout ce dont vous avez besoin
pour excuter un serveur de messagerie. hMailServer possde son ppropre serveur de base de
donnes intgr, une version lgre du serveur de base de donnes MSSQL. Si vous ne souhaitez
pas l'utiliser, il vous suffit de slectionner l'un des moteurs de base de donnes suivant:
MySQL 4 et MySQL5
Microsoft SQLServer 2000, 2005 et2008(incluant les ditions Express, Standard et Entreprise)
PostgreSQL 8
Notez que hMailServer n'est test qu'avec la version dfinitive des moteurs de base de donnes.
Si vous installez une version alpha ou beta de MySQL, par exemple, ne vous attendez pas ce
que hMailServer fonctionne avec cette version.
SquirrelMail
Si vous prvoyez d'utiliser le module de Changement de Mot de Passe hMailServer ou le module
Rponse Automatique avec SquirrelMail, il vous faudra SquirrelMail 1.4.7 ou suprieur.
Administration Web
Si vous prvoyer d'utiliser PHPWebAdmin pour grer votre installation de hMailServer via un
navigateur web, vous devez excuter un serveur web dont la prise en charge de PHP est
disponible.
Logiciel incompatible
12 / 214
hMailServer est incompatible avec les logiciels suivants:
NetLimiter de Locktime Software. NetLimiter a une LSP Windows incorrectement crite ("pilote
Winsock") qui entraine des problmes pour hMailServer. NetLimiter ne fonctionne pas non plus
correctement avec d'autres logiciels (y compris les logiciels de Microsoft) et il ne devrait donc
jamais tre install sur le mme ordinateur que hMailServer). L'quipe de hMailServer a essay
d'obtenir des explications de Locktime Software concernant ceci, mais n'a jamais reu de rponse.
NOD32/IMON de ESET. hMailServer n'est pas compatible avec le composant IMON de NOD32. Lors
de l'installation de NOD32, une alerte apparat pour indiquer quele composant IMON ne devrait
pas tre install sur les serveurs car il est connu pour entraner des problmes avec les logiciels
serveurs. (hMailServer n'a aucun problme pour coexister et utiliser NOD32 tant que le composant
IMON n'est pas activ)
Antivirus
Pour que hMailServer fonctionne correctement, l'examen viral automatique du dossier hMailServer
Data doit tre dsactiv. Vous devriez configurer votre antivirus pour exclure le dossier
hMailServer Data de l'examen. Si vous le faites, il est conseill de configure hMailServer pour qu'il
lance examen viral ds qu'un nouveau e-mail est reu.
Matriel
Performance
La configuration matrielle est trs dpendante du nombre d'utilisateurs. Elle dpend aussi de
l'utilisation ou non de la prise en charge IMAP, de l'antivirus, des filtres, etc. POP3 utilise beaucoup
moins de ressources CPU que IMAP, et si vous avez de nombreux utilisateurs, POP3 est
recommand. hMailServer utilise normalement moins de 100Mo de mmoire. Les installations les
plus tendues de hMailServer ont plus de 20.000 comptes utilisateur hbergs sur un seul
serveur.
Rsolution de l'cran
Le programme d'administration pour hMailServer, l'Administrateur de hMailServer, ncessitent une
rsolution d'cran de 800x600 ou suprieure.
Connaissances techniques
Pour tre capable de russir le paramtrage d'un serveur de messagerie, vous devez connatre
les bases concernant certaines techniques relatives Internet et la messagerie. Bien que la
documentation de hMailServer dcrive et commente ces lments, elle ne doit pas tre considre
comme une documentation de rfrence dans ce domaine. Vous devez possder des
connaissances de base concernant les lments suivants pour mener bien les rglages d'un
serveur de messagerie sous Windows.
Microsoft Windows
Noms de domaine et noms d'hte
Pare-feux et routeurs
DNS, Systme de Noms de Domaine
Ports TCP/IP
Choisir un moteur de base de donnes

Gnralits
13 / 214
hMailServer prend en charge 5 diffrents moteurs de base de donnes
Microsoft SQL Server 2000 et suprieur
Microsoft SQL Server Compact Edition (CE)
MySQL 4 et suprieur
PostgreSQL
Choisir une base de donnes
Dans la version 5, Microsoft SQL Server Mobile Edition est utilis par dfaut. Le plus gros avantage
avec ce moteur de base de donnes est la faible utilisation de la mmoire et de l'espace disque, et
aussi le fait qu'aucun autre logiciel externe n'est requis pour fonctionner sur l'ordinateur. Le
moteur de base de donnes s'excute l'intrieur de hMailServer, ce qui signifie que hMailServer
ne dpend aucunement de moteurs de base de donnes externe.Les versions prcdentes de
hMailServer (4 et infrieures) comprennent MySQL, qui a t chang pour MSSQL CE dans le
version 5.Il existe des inconvnients avec la base de donnes par dfaut si:
L'installation de Microsoft SQL Server Compact Edition fourni avec hMailServer est limite 4Go . Si
vous pensez que votre installation devient volumineuse (des centaines ou des milliers de de
messages ou de nombreux comptes), il est conseill de choisir Microsoft SQL Server ou MySQL.
Une base de donnes MSSQL CE de 4Go peut contenir les rfrences d'environ 10 million de
messages. En terme de performance, MSSQLCEest plus lent que les autres moteurs de bases de
donnes pris en charge. Aussi, quelques outils sont disponibles si une base de donnes SQLCE
devient corrompue, du fait, par exemple, d'une panne matrielle ou d'un plantage du systme.
Recommandations
Microsoft SQLServer ou MySQLest conseill si...
... l'envoi et la rception de massages est vital et que vous ne pouvez pas prendre le risque de
perdre des donnes
... vous envisagez de faire une intgration qui implique la base de donnes hMailServer. Il existe
davantage d'outils client disponibles pour MicrosoftSQLServer et MySQL par rapport
PostgreSQL.
PostgreSQL est conseill si vous l'avez dj utilis et que vous vous sentez l'aise avec ce
moteur.
Guide de dmarrage rapide

Didacticiel d'Installation
Installer hMailServer
Cette section dcrit les tapes ncessaires pour installer hMailServer 5. Avant l'installation de
hMailServer, vous devez vrifier que votre ordinateur correspond la Configuration Systme
Requise.
Etape 1: Tlchargement
La premire tape consiste tlcharger hMailServer. Le programme d'installation est disponible
au tlchargement la page de tlchargement. Il est recommand de tlcharger la dernire
version stable. Le fichier tlcharger un nom sous la forme hMailServer-version-build.exe. Par
exemple, version-build peut signifier 5.0-Build-305.
14 / 214
Etape 2: Installation
Double-cliquez sur le fichier tlcharg pour lancer l'installation. La premire bote de dialogue qui
apparat est la fentre de Bienvenue. Cliquez sur Suivant.
L'tape suivante consiste lire le contrat de licence. Si voous n'acceptez pas l'accord de licence,
annulez l'installation. Si vous l'acceptez, slectionnez "J'accepte cet accord"et cliquez sur Suivant.
Slectionnez le dossier de destination et cliquez sur Suivant. Vous devez choisir un lecteur local
15 / 214
et non un dossier rseau. Il est possible d'installer hMailServer sur un priphrique amovible, mais
vous ne pourrez pas excuter hMailServer partir d'un autre ordinateur.
Slectionnez les composants installer et cliquez sur Suivant. Sur le serveur, vous devez installer
tous les composants disponibles. Si vous avez dj install le serveur hMailServer sur un autre
ordinateur et que vous souhaitez le grer distance, il vous suffit d'installer les outils
Administratifs.
Slectionnez le dossier du menu Dmarrer dans lequel vous souhaitez placer les icnes de
hMailServer et cliquez sur Suivant.
16 / 214
Confirmez que les paramtres sont corrects et cliquez sur Installer pour effectuer l'installation.
Patientez...L'installation devrait prendre 10 20 secondes.
17 / 214
Aprs l'installation des fichiers, vous devez fournir au programme d'installation un mot de passe
principal hMailServer. Pour la version 4.3 et ultrieur, un mot de passe principal est utilis pour
amliorer la scurit. Le mot de passe peut librement choisi, condition qu'il dpasse 5
caractres. Vous aurez besoin de ce mot de passe plus tard, lors de l'administration du serveur, et
vous ne devez donc pas l'oublier. Il vous faut spcifier le mot de passe uniquement la premire
fois que vous installez hMailServer
A la fin de l'installation, vous pouvez lancer hMailServer Administrator (que vous trouverez dans le
menu Dmarrer). La premire fentre qui apparat est la bote de dialogue Connexion. Elle vous
permet de vous connecter diffrentes installations de hMailServer sur votre rseau.
Normalement, vous aurez vous connecter localhost. Slectionnez localhost, et cliquez sur
Connexion. Dans la bote de dialogue du mot de passe, entrez votre mot de passe principal
18 / 214
hMailServer et cliquez sur OK.
Etape 3: Tches aprs installation
Configuration DNS
Aprs l'installation de hMailServer, vrifiez que vous configurez votre serveur DNS correctement.
Pour que SMTP fonctionne, vous devez dfinir les enregistrements MX de votre domaine. MX
signifie Mail eXchanger. Autrement dit, les enregistrements MX indiquent aux autres serveurs de
messagerie que ce serveur de votre domaine est responsable de la gestion du courrier. Cliquez ici
pour en savoir plus sur les enregistrements MX.
Etape 4: Configuration du serveur
Le didacticiel pour configurer le serveur est ici.
Si vous rencontrez des problmes, consultez la rubrique guide de dpannage.
Didacticiel de Configuration
Gnralits
Cette rubrique dcrit les bases de la configuration de hMailServer. Elle n'inclut pas les informations
concernant le rglage des examens de l'antivirus, ni la protection contre les spams. Si vous n'tes
pas sr de comprendre le fonctionnement de hMailServer, consultez cette rubrique avant de
configurer le serveur.
Connexion hMailServer
1.Dans le menu Dmarrer, slectionnez hMailServer Administrator
La bote de dialogue Connexion de hMailServer Administrator apparat. Elle vous permet de vous
connecter diffrents services de hMailServer.
2.Double-cliquez sur le nom d'hte "localhost" pour vous connecter l'instance de hMailServer
s'excutant sur localhost.
3.Dans la bote de dialogue Mot de Passe, indiquez le mot de passe que vous avez spcifi lors de
l'installation de hMailServer - le mot de passe d'administration principal de hMailServer, et cliquez
sur OK
19 / 214
4.Maintenant, hMailServer Administrator est lanc.
Domaines & Comptes
Tout domaine hMailServer doit tre connect un domaine Internet. Supposons que vous tre le
propritaire du domaine
something.com
, vous allez ajouter
something.com
comme domaine
hMailAdmin:
1.Lancez hMailAdmin.
2.Cliquez sur Ajouter un domaine.
3.Entrez
something.com
comme nom de domaine.
4.Cliquez sur Enregistrer
L'tape suivante consiste ajouter les comptes votre serveur. Le situation normale consiste
possder un compte par adresse e-mail partir de laquelle vous voulez envoyer et recevoir des
messages. Si vous possdez les adresses
webmaster@something.com
et
info@something.com
,
ajoutez-les simplement hMailAdmin:
1.Lancez hMailAdmin
2.Dployez Domaines dans l'arborescence de gauche
3.Cliquez sur le domaine something.com
4.Cliquez sur Ajouter un compte
5.Entrez
webmaster
comme adresse de compte, indiquez le mot de passe et cliquez sur Enregistrer
6.Cliquez sur le domaine something.com dans l'arborescence de gauche
7.Cliquez sur Ajouter un compte
8.Entrez
info
comme adresse de compte, indiquez le mot de passe et cliquez sur Enregistrer
Spcifier le nom de l'hte public
Pour qu'un serveur fonctionne correctement, il doit connatre son nom public sur Internet. Il s'agit
normalement de quelque chose comme
mail.something.com
. Comme rien n'existe comme logiciel
pour dtecter automatiquement le nom de l'hte de l'ordinateur sur lequel il s'excute, vous devez
indiquer hMailServer le nom d'hte utiliser. Bien qu'il soit possible d'excuter hMailServer sans
lui indiquer son nom d'hte public, certains serveurs de messagerie refuseront vos messages si
vous ne le spcifiez pas.
1.Lancez hMailAdmin
2.Dans l'arborescence de gauche, allez Paramtres -> Protocoles -> SMTP
3.A droit, les paramtres SMTP sont dsormais affichs. Cliquez sur l'onglet Distribution des
messages.
4.Dans Nom d'hte, entrez le nom d'hte public de l'ordinateur sut lequel s'excute hMailServer.
5.Enregistrez les changements
Spcifiez le serveur SMTP
Certains fournisseurs d'accs internet (ceux qui offrent votre connexion Internet) bloquent le
trafic sortant sur le port 25. Comme le trafic sortant sur le 25 est requis pour que la messagerie
fonctionne correctement, vous devez convaincre votre FAI de vous ouvrir le port 25 (s'il n'est pas
ouvert), ou configurer hMailServer pour transmettre tout courrier lectronique via le serveur de
messagerie de votre FAI.
Pour dterminer si le port 25 est bloqu, entrez
telnet mail.hmailserver.com 25
en ligne de
commande. Si vous pouvez vous connecter, le port 25 n'est pas bloqu; Sinon, le port 25 est
bloqu.
Si vous configurez le serveur de messagerie de votre FAI comme relais SMTP, hMailServer dlivrera
tous les messages sortants au serveur de messagerie de votre FAI, qui son tour les dlivrera au
bon destinataire. Comme c'est, la plupart du temps, toujours possible d'envoyer un e-mail via le
serveur de messagerie de votre FAI, il s'agit d'un palliatif si le port 25 est bloqu.
1.Lancez hMailAdmin
2.Dans l'arborescence de gauche, allez Paramtres -> Protocoles -> SMTP
3.A droite, les rglages SMTP apparaissent. Cliquez sur l'onglet Dlivrer un e-mail.
4.Dans le champ Relais MTP, entrez le nom d'hte du serveur de messagerie de votre FAI, avec vos
identifiants sur ce serveur au cas o une identification serait demande.
5.Enregistrez vos modifications
20 / 214
Notez que vous ne devez JAMAIS spcifier
localhost
,
127.0.0.1
, ou votre propre nom d'hte
comme relais SMTP, car cela signifierait que hMailServer devrait essayer de transmettre les
messages lui-mme. Il en rsulterait une boucle interminable. De mme, vous devez laisser ce
champ vierge si votre FAI n'a pas bloqu le port 25.
Configuration des plages IP
Les plages IP sont utilises par hMailServer pour spcifier qui est autoris envoyer des
messages via votre serveur. Vous pouvez, par exemple, utiliser des plages IP pour configurer
hMailServer de telle sorte que seuls les ordinateurs de votre rseau local soient autoriss
utiliser le serveur pour envoyer des messages. Par dfaut, hMailServer est propos avec deux
plages IP diffrentes. Ces plages IP par dfaut doivent tre suffisantes pour la plupart des
utilisateurs. Sauf si vous utilisez de vieux clients de messagerie avec trs peu de fonctionnalits,
vous ne devriez jamais avoir les modifier sauf si vous tes absolument sr de votre objectif en
utilisant des plages IP, et comment y parvenir.
Dpannage
La plupart du temps, lorsqu'un utilisateur rapporte un problme d'installation et de configuration
de hMailServer, le problme ne se situe pas au niveau de l'installation de hMailServer, mais au
niveau des paramtres seau, du pare-feu, de la configuration DNS et autres logiciels externes.
Ce didecticiel ne couvre que l'installation de hMailServer et il est donc fortement conseill de lire la
rubrique dpannage si vous rencontrez des problmes.
Installation de PHPWebAdmin
Gnralits
Cette rubrique dcrit comment installer hMailServer WebAdmin, le front-end de l'administration
PHP pour hMailServer.
Pralable
Apache ou IIS (ou tout autre serveur web compatible PHP)
PHP >= 4.3.11 ou PHP >= 5.0.3. Du fait de bugs sous PHP 4.3.10, hMailServer ne fonctionne plus
avec cette version.
La valeur de register_globals PHP doit tre rgle sur off pour que PHPWebAdmin fonctionne
correctement.
Dans la configuration PHP, les paramtres suivants doivent tre configurs que PHPWebAdmin
fonctionne correctement:
o
register_globals doit tre rgl sur off
o
display_errors doit tre rgl sur off
Etape 1: Copier les fichiers
La premire tape consiste copier PHPWebAdmin partir du dossier hMailServer dans votre
dossier racine web. La racine web diffre des serveurs web, ce qui fait que vous devez consultez
la documentation de votre serveur web si vous n'tes pas sr de savoir o est place votre racine
veb. Copiez la totalit de PHPWebAdmin de C:\Program Files/hMailServer dans votre racine web.
Si, par exemple, votre racine web est C:/wwwroot, copiez PHPWebAdmin dans C:\wwwroot, de
faon obtenir C:\wwwroot\PHPWebAdmin.
La description ci-dessous suppose que votre racine web est C:\wwwroot.
Etape 2: Installation
21 / 214
Accdez au dossier WebAdmin la racine web.
1.Crez une copie du fichier nomm config-dist.php et donnez-lui pour nom config.php.
2.Le fichier config.php contient les paramtres de base pour PHPWebAdmin et doit tre modifi
pour l'ajuster votre systme:
o
Rglez la valeur de rooturl sur l'URL d'accs au WebAdmin.
Exemple:
$hmail_config['rooturl'] = "http://localhost/PHWebAdmin/";
3.Si vous utilisez IIS6 ou si vous excutez votre serveur web (Apache ou IIS) comme un compte
utilisateur spcifique avec des permissions limites, vous devez suivre ces tapes.
4.Crez un fichier robots.txt lla racine du serveur web pour empcher Google et autres robots de
recherche d'indexer hMailServer WebAdmin. Si une vulnrabilit de scurit est dtecte dans
PHPWebAdmin, l'attaque sera plus difficile
Etape 3: Utilisation
Pointez votre navigateur web sur http://localhost/PHPWebAdmin et ouvrez une session avec vos
nom d'utilisateur et mot de passe hMailServer.
Lorsque vous actualisez votre installation de hMailServer pour une version suprieure, vrifiez que
vous copiez bien le dernier WebAdmin du dossier d'installation de hMailServer dans votre dossier
web. Si vous ne le faites pas, vou obtiendrez un message d'erreur lors de la tentative d'accs
WebAdmin.
Erreurs de configuration courantes
Il existe quelques fautes courantes d'installation. Consultez la rubrique guide de dpannage pour
en savoir plus.
Scnarios d'Installation
Installation scenarios
Installing on a single server with dynamic IP address
Installing on a single server with static IP address
Simple serveur, adresse IP dynamique
Scnario:
Vous avez un simple serveur que vous souhaitez utiliser comme serveur de messagerie. Vous
Fournisseur d'Accs Internet (FAI) vous a attribu une adresse IP dynamique.
Etape 1: Vrification de la Configuration Systme
Avant de continuer, vous devez vrifier que votre FAI vous permet d'excuter votre propre serveur
de messagerie sur votre rseau. Vous devez aussi vrifier que votre FAI n'a pas bloqu le port 25
pour le trafic entrant. Il vous faut aussi savoir si il a bloqu le trafic sortant sur le port 25.
Etape 2: Configurer les enregistrements MX
22 / 214
Pour pouvoir recevoir les e-mails des autres serveurs, vous devez installer les enregistrements MX
pour votre domaine. Les enregistrements MX sont des entres du serveur DNS qui indiquent aux
autres ordinateurs sur Internet quel ordinateur (nom d'hte) hberge les e-mails pour votre
domaine.
Comme vous utilisez une adresse IP dynamique, vous devez enregistrer un nom d'hte qui est
actualis automatiquement ds que votre adresse IP change. Il existe plusieurs socits qui
proposent ce service gratuitement. Le didacticiel suivant suppose que vous avez enregistr un
sous-domaine gratuit sur No-IP, nomm something.no-ip.com et que ce nom d'hte pointe sur
l'adresse IP de votre ordinateur (No-IP offre unn petit utilitaire Windows gratuit qui actualise
automatiquement l'hte ds que votre adresse IP change).
Si vous avez accs une interface web qui vous permet de modifier les paramtres DNS, vous
pouvez configurer vos enregistrements MX vous mme. Sinon, vous devez contacter la socit qui
a enregistr votre domaine et lui demander de configurer les enregistrement MX pour votre
domaine.
Ainsi, dans cet exemple, vous devriez entrer quelque chose comme something.no-ip.com comme
enregistrement MX pour votre domaine.
Step 3: Changer les rglages du pare-feu
Si vous avez un pare-feu (je l'espre) vous devez modifier ses paramtres pour autoriser
hMailServer recevoir des e-mails. Un e-mail est normalement envoy et reu sur le port 25 en
TCP/IP. Ce qui signifie que vous devez configurer votre pare-feu pour autoriser le trafic entrant et
sortant sur le port 25 en TCP/IP. Si vous tes devant une sorte de routeur, vous devez configurer
celui-ci pour transmettre tout trafic sur le port 25 l'ordinateur sur lequel s'excute hMailServer.
Step 4: Installer hMailServer
1.Tlchargez la dernire version de hMailServer
2.Suivez l'assistant d'installation.
3.Lancez hMailServer Administrator.
4.Cliquez sur Ajouter un Domaine...
5.Entrez le nom de votre domaine, something.no-ip.com, et cliquez sur Enregistrer.
6.Cliquez sur Ajouter un Compte... et ajoutez un nom de compte de messagerie.
7.Allez Configuration->Protocoles->SMTP et choisissez l'onglet Livraison des messages.
8.Dans le champ Nom d'hte, entrez le nom d'hte de votre ordinateur, something.no-ip.com dans
notre exemple.
Etape 5: Configurer la messagerie sortante
Si votre FAI a bloqu le trafic sortant sur le port 25, hMailServer ne pourra pas dlivrer les
messages aux autres serveurs car normalement tous les serveurs SMTP ne reoivent les e-mails
que sur le port 25. Si votre FAI a bloqu le trafic sortant sur le port 25, la meilleure solution est,
normalement, de configurer hMailServer pour expdier tous les messages sortants via le serveur
SMTP de votre FAI. Pour ce faire, suivez ces tapes:
1.Lancez hMailServer Administrator
2.Allez aux paramtres SMTP et choisissez Livraison des e-mails.
3.Dans les rglages du relais SMTP, entrez le nom du serveur SMTP de votre FAI, par exemple
smtp.myisp.com.
4.Si votre FAI demande un nom d'utilisateur / mot de passe lors de l'envoi de messages via son
serveur, activez Le serveur ncessite une authentification, et entrez le nom d'utilisateur et le mot de
passe.
Step 6: Configurer votre client de messagerie
Dans votre client de messagerie, ajoutez un nouveau compte. Entrez les informations suivantes:
Nom d'hte - Le nom d'hte ou l'adresse IP de l'ordinateur qui excute hMailServer
Nom d'utilisateur - Votre adresse de messagerie complte. La mme que l'adresse du compte que
23 / 214
vous avez ajoute dans hMailServer Administrator.
Mot de passe - Le mot de passe que vous avez dfini dans hMailServer Administrator
Simple serveur, adresse IP statique
Scnario:
Vous avez un simple serveur que vous souhaitez utiliser comme serveur de messagerie priv.
Votre FAI vous a fourni une adresse IP statique. Le didacticiel ci-dessous suppose que le domaine
sur lequel vous souhaitez hberger les messages se nomme mydomain.com.
Etape 1: Vrification de la Configuration Systme
Avant de poursuivre, vous devez vrifier si votre FAI vous autorise excuter votre propre
serveur de messagerie. Vous devez aussi vrifier que votre FAI n'a pas bloqu le port 25 pour le
trafic entrant. Vous devez aussi savoir s'il n'a pas aussi bloqu le trafic sortant sur le port 25.
Etape 2: Configurer le serveur DNS
Pour recevoir les messages des autres serveurs, vous devez rgler les enregistrements MX pour
votre domaine. Les enregistrements MX sont des entres du serveur DNS qui indiquent aux autres
ordinateurs sur Internet quel ordinateur (nom d'hte) hberge les e-mails pour votre domaine.
Si vous avez accs une interface web qui vous permet de modifier les paramtres DNS, vous
pouvez configurer vos enregistrements MX vous mme. Sinon, vous devez contacter la socit qui
a enregistr votre domaine et lui demander de configurer les enregistrement MX pour votre
domaine.
1.Crez un enregistrement A nomm mail.something.com.
2.Configurez l'enregistrement A mail.something.com de sorte qu'il pointe sur l'adresse IP de votre
ordinateur.
3.Ajoutez un enregistrement MX qui a pour valeur mail.something.com pour votre domaine.
Step 3: Changer les rglages du pare-feu
Si vous avez un pare-feu (je l'espre) vous devez modifier ses paramtres pour autoriser
hMailServer recevoir des e-mails. Un e-mail est normalement envoy et reu sur le port 25 en
TCP/IP. Ce qui signifie que vous devez configurer votre pare-feu pour autoriser le trafic entrant et
sortant sur le port 25 en TCP/IP. Si vous tes devant une sorte de routeur, vous devez configurer
celui-ci pour transmettre tout trafic sur le port 25 l'ordinateur sur lequel s'excute hMailServer.
Step 4: Installer hMailServer
1.Tlchargez la dernire version de hMailServer
2.Suivez l'assistant d'installation.
4.Cliquez sur Ajouter un Domaine...
5.Entrez le nom de votre domaine cliquez sur Enregistrer.
6.Cliquez sur Ajouter un Compte... et ajoutez un nom de compte de messagerie.
7.Allez Configuration->Protocoles->SMTP et choisissez l'onglet Livraison des messages.
8.Dans le champ Nom d'hte, entrez le nom d'hte de votre ordinateur, something.no-ip.com dans
notre exemple.
Step 5: Configurer la messagerie sortante
Si votre FAI a bloqu le trafic sortant sur le port 25, hMailServer ne pourra pas dlivrer les
messages aux autres serveurs car normalement tous les serveurs SMTP ne reoivent les e-mails
que sur le port 25. Si votre FAI a bloqu le trafic sortant sur le port 25, la meilleure solution est,
24 / 214
normalement, de configurer hMailServer pour expdier tous les messages sortants via le serveur
SMTP de votre FAI. Pour ce faire, suivez ces tapes:
2.Allez aux paramtres SMTP et choisissez Livraison des e-mails.
3.Dans les rglages du relais SMTP, entrez le nom du serveur SMTP de votre FAI, par exemple
smtp.myisp.com.
4.Si votre FAI demande un nom d'utilisateur / mot de passe lors de l'envoi de messages via son
serveur, activez Le serveur ncessite une authentification, et entrez le nom d'utilisateur et le mot de
passe.
Step 6: Configurer votre client de messagerie
Dans votre client de messagerie, ajoutez un nouveau compte. Entrez les informations suivantes:
Nom d'hte - Le nom d'hte ou l'adresse IP de l'ordinateur qui excute hMailServer
Nom d'utilisateur - Votre adresse de messagerie complte. La mme que l'adresse du compte que
vous avez ajoute dans hMailServer Administrator.
Mot de passe - Le mot de passe que vous avez dfini dans hMailServer Administrator
Mise niveau
Conseils de mises niveau
Gnralits
Ce document vous propose quelques recommandations gnrales concernant la mise niveau de
votre version de hMailServer vers une version plus rcente.
Etape 1: Tout sauvegarder
Avant la mise niveau de hMailServer, vous devez sauvegarder tous vos messages et
paramtres. C'est trs rare qu'une mise niveau de hMailServer choue, mais si c'est le cas, vous
devez restaurer une sauvegarde de votre installation. Souvenez-vous que si une mise niveau
choue, tous vos messages peuvent tre perdus, et il est donc capital de sauvegarder votre
systme avant une mise niveau.
Step 2: Dsinstaller une ancienne version avant d'en installer une nouvelle?
Gnralement, il n'est pas ncessaire de dsinstaller l'ancienne version de hMailServer avant d'en
installer une nouvelle. Le programme d'installation de hMailServer arrtera automatiquement
l'installation en cours de hMailServer avant d'installer la nouvelle version. La recommandation est
donc de ne pas dsinstaller la version existante avant d'installer la nouvelle version.
Exception cette rgle: si vous passez de hMailServer 3.x hMailServer 4.x. L'API COM de
hMailServer a un nouveau nom dans hMailServer 4.x. Si vous ne dsinstallez pas hMailServer 3.x
avant d'installer hMailServer 4.x, cet ancien API existera encore sur votre systme. Ce qui ne
devrait jamais poser de problmes. Mais si vous ne voulez pas que l'ancien API soit encore
disponible, vous devrez dsinstaller hMailServer 3.x avant d'installer hMailServer 4.x.
La dsinstallation de hMailServer ne supprime pas les messages, les comptes ou autres
paramtres. Vous pouvez dsinstaller hMailServer et le rinstaller sans aucune perte de
messages.
Step 3: Installer la nouvelle version
25 / 214
Les tapes ci-dessous sont les mmes pour la plupart des versions de hMailServer. Pour les
informations spcifiques d'une version, consultez la rubrique Mise Niveau de cette
documentation.
1.Tlchargez hMailServer sur le site web de hMailServer.
2.Lancez l'excutable d'installation en double-cliquant dessus.
3.Suivez les diffrentes botes de dialogue et cliquez sur Installer de la bote de dialogue Prt
installer.
4.Le programme d'installation effectue alors une copie des fichiers. Si vous avez un message qui
indique qu'il ne peut pas remplacer le fichier libmysql.dll, redmarrez Apache/IIS et cliquez sur
Ressayer.
5.Aprs la copie des fichiers, l'installateur lancera automatiquement la mise jour de la base de
donnes de hMailServer si ncessaire.
6.Si la mise jour de la base de donnes de hMailServer est lance, cliquez sur Actualiser pour
passer de la base de donnes actuelle la nouvelle structure de base de donnes.
7.Aprs le mise jour de la base de donnes, l'installateur lance automatiquement le service
hMailServer.
8.Cliquez sur Quitter pour revenir l'assistant d'installation
9.Cliquez sur Terminer pour quitter l'installation et lancer hMailAdmin.
Etapes de mises niveau de versions multiples
Lorsque vous mettez niveau hMailServer pour la dernire version, vous pouvez installer
immdiatement la dernire version l'tape 3. Si, par exemple, vous passez de la version 4.0 la
version 4.4, vous n'avez pas installer les versions 4.1, 4.2 ou 4.3 car la version 4.4 contient
toutes les modifications effectues pour les versions 4.1, 4.2 et 4.3. Il est possible de passer
directement de la version 2.0 et suprieure le dernire version sans installer les autres versions
intermdiaires. La seule exception la rgle est la suivante:
Si vous utilisez MySQL, et que vous passez de la version 4.3 ou antrieure la version 5, vous
devez devez d'abord passer version 4.4 avant de passer la version 5.
Questions Souvent Poses
Mes donnes sont-elles prserves lors de la mise niveau?
Lorsque vous passez d'une version la dernire version, les donnes de votre base de donnes
et la totalit de vos messages sont prservs. Cependant, il existe un risque que quelque chose
se passe mal au cours du processus de mise niveau, et il est donc important d'effectuer une
sauvegarde complte de votre installation.
hMailServer continuera t-il utiliser ma base de donnes actuelle?
Lorsque vous passez d'une version la dernire version, hMailServer continue utiliser la mme
base de donnes qu'il utilisait auparavant. Le processus de mise niveau actualisera la structure
des tables de la base de donnes afin qu'elle soit compatible avec la nouvelle version de
hMailServer.
Mise niveau: 3.x vers 4.0
Gnralits
Cette section dcrit les tapes suivre pour passer de hMailServer version 3.x hMailServer
version 4.0. Si vous suivez ces tapes, le temps d'arrt du serveur ne durera que quelques
minutes. Avant la mise niveau, vrifiez que vous possdez une sauvegarde du dossier complet
de hMailServer, de la base de donnes de hMailServer et du fichier hMailServer.ini, au cas o
quelque chose se passerait mal. Les tapes ci-dessous sont les mmes, quel que soit le type de
serveur de base de donnes utilise par hMailServer. Lisez la totalit de cette rubrique avant de
passez la mise niveau.
Installer la nouvelle version
26 / 214
1.IMPORTANT: Sauvegardez votre base de donnes, votre dossier hMailServer et le fichier
hMailServer.ini.
2.Tlchargez hMailServer 4.0 sur le site web de hMailServer.
3.Lancez l'excutable d'installation en double-cliquant dessus. Il n'est pas ncessaire d'arrter ou
de dsinstaller la version prcdente avant d'installer la version 4.0. L'installateur de hMailServer
4.0 prendra soin de cela.
4.Suivez le diffrentes botes de dialogue de l'installation et cliquez sur Installer dans la bote de
dialogue Prt installer.
5.L'installateur effectue alors une copie des fichiers. Si vous avez un message qui indique qu'il ne
peut pas remplacer le fichier libmysql.dll, redmarrez Apache/IIS et cliquez sur Ressayer
6.Aprs la copie des fichiers, l'installateur lance automatiquement la mise jour de la base de
donnes de hMailServer.
7.Cliquez sur Actualiser pour mettre jour la base de donnes pour la structure 4.0.
8.Aprs la mise jour de la base de donnes, l'installateur lancera automatiquement le service
hMailServer.
10.Cliquez sur Terminer pour quitter l'installateur et lancer hMailAdmin.
Qoui de neuf?
Niveaux des utilisateurs dans PHPWebAdmin
Dans hMailServer 4.0, PHPWebAdmin propose la prise en charge des diffrents niveaux
d'utilisateurs. Pour chaque compte du serveur, vous pouvez dfinir si l'utilisateur aura les droits
d'Administration du Serveur, les droits d'administration du domaine ou les droits d'administration
utilisateur seuls. A l'aide de ces niveaux, il est possible de dlguer des tches aux propritaires
du domaines, de sorte que ceux-ci peuvent ajouter leurs comptes eux-mmes via PHPWebAdmin.
Rgles
hMailServer 4.0 prend en charges des rgles. Avec ces rgles, vous pouvez spcifier de quelle
faon les messages seront traits en fonction de leur contenu. Si vous souhaitez, par exemple que
tous les messages contenant un certain en-tte, soient dplacs dans un dossier IMAP nomm
"spam", ou que tous les messages destins order@yourdomain.com soient transfrs
you@yourdomain.com. Ces options, ainsi que de nombreuses autres, sont possibles en utilisant
des rgles.
Prise en charge des Scripts
En utilisant des scripts cette fonction, vous pouvez crire vos propres scripts VBA qui seront
excuts lors de certains vnements. Exemple; un vnement nomm OnMessageDeliver est
excut lorsqu'un message est dlivr. Lors de cet vnement, vous pouvez faire ce que vous
voulez avec ces messages messages, comme en remplacer le sujet lorsqu'il correspond certains
critres. Autrement dit, avec VBA-scrip, vous pouvez effectuer des actions avances sur vos
messages.
Rcuprateur POP3
La prise en charge du tlchargement des e-mails partir des autres serveurs POP3 a t
ajoute. Vous pouvez spcifier les paramtres du serveur, l'intervalle de rcupration et indiquer
si les messages sont supprimer du serveur distant. Le protocole POP3 est utilis pour ce faire.
Service DCOM
La bibliothque COM de hMailServer 4.0 prend en charge l'excution distante. Ce qui vous permet
d'excuter PHPWebAdmin sur un ordinateur et le serveur hMailServer sur un autre. Cependant, la
configuration DCOM est ncessaire, en utilisant les Services du Composant.
Aprs l'installation
27 / 214
hMailServer.ini
Avec hMailServer 3.x et antrieur, hMailServer.ini tait enregistr dans le dossier Windows. Ce qui
posait parfois des problmes sur les serveurs excutant Terminal Services (TS), car vous ne
pouviez avoir qu'un seul dossier Windows par utilisateur lors de l'excution de TS. Lorsque vous
passez la version 4.0, le fichier hMailServer.ini est copi de votre dossier Windows vers le
dossier Bin de hMailServer. Si votre serveur ne dmarre pas aprs la mise niveau, il se peut que
vous ayez copier le fichier manuellement du dossier Windows au dossier Bin.
Nouveau type de service
Avec hMailServer 4.0, le composant service a t compltement rcrit. Les utilisateurs l'excutent
avec succs sous Windows NT 4, Windows 2000, XP et Windows 2003. Si vous avez une autre
version de Windows, comme l'dition MediaCenter, vous allez installer le composant service vos
propres risques.
Service & API COM
Avec hMailServer 4.0, la bibliothque COM est beaucoup plus intgre au service du serveur,
plutt que d'tre une DLL externe comme pour les prcdentes versions. Il en rsulte que le
service doit tre lanc pour que la bibliothque COM fonctionne. Comme hMailAdmin utilise la
bibliothque COM, vous ne pourrez plus arrter le service en utilisant hMailAdmin. Au lieu de cela,
lorsque vous cliquez sur Stop ou Dmarrer dans hMailAdmin, vous lancez ou arrtez l'excution du
serveur hMailServer l'intrieur du service. Si vous arrtez le serveur, hMailServer fermera toutes
les connexions, les ports et arrtera la diffusion des messages. Cependant, le service hMailServer
sera encore actif.
Mise niveau: 4.x vers 5.0
Gnralits
Cette section dcrit les tapes suivre pour passer de hMailServer version 4.x hMailServer
Notez que la configuration systme requise pour la version 5 n'est pas,la mme que pour la
version 4. Pour la version 5.0, Microsoft SQLServer version 2005 est requis. Pour la version 5.1, la
version 2000 est galement prise en charge. Ainsi, si vous utilisez Microsoft SQLServer 2000, vous
pouvez passer directement de la version 4 la version 5.1 ou suprieure. Nne pas passer d'abord
la version 5.0.
Si vous utilisez la base de donnes interne MySQL, et que vous passez de la version 4.2 ou
antrieure, vous devez installer la dernire version 4.4 avant de passer la version 5. Si vous ne
le faites pas, la mise jour de la base de donnes chouera.
hMailServer.ini.
2.Lisez la section Rtro-compatibilit plus bas. Si quelque chose n'est pas clair, il est conseill
d'installer hMailServer 5 d'abord sur un serveur test pour en connatre les nouvelles
fonctionnalits.
3.Tlchargez hMailServer 5 sur le site web de hMailServer.
de dsinstaller la version en cours avant d'installer la nouvelle version.
28 / 214
6.L'installateur effectue alors une copie des fichiers.
donnes de hMailServer. Si vous voyez le texte "Cration de la base de donnes hMailServer" dans
l'assistant d'installation pendant plus de 15 secondes, et qu'aucune bote de dialogue "Mise jour
de la base de donnes" n'apparat, il est vraisemblable que cette dernire se trouve "derrire"
l'assistant. Ainsi, si elle n'apparat pas, essayez de dplacer la fentre de l'assistant d'installation.
8.Cliquez sur Mettre jour pour actualiser la base de donnes selon la structure la plus rcente.
Quoi de neuf?
Pour obtenir la liste des nouvelles fonctionnalits et connatre les problmes concernant
hMailServer 5, cliquez ici.
Rtro-compatibilit
hMailServer 5 inclut de nombreux changements. Certains de ces changements modifient le
comportement des fonctionnalits existantes. Les fonctionnalits suivantes ont t rorganises
dans hMailServer 5. Aprs la mise niveau, revoyez la configuration pour vrifier qu'elle
correspond bien vos attentes.
Nouveau moteur de base de donnes pa dfaut
Dans hMailServer 4, le moteur de base de donnes interne tait MySQL. hMailServer 5 utilise la
place Microsoft SQLServer 2008 Compact Edition. Ce qui n'aura aucun effet sur les mises jour - si
vous avez install hMailServer 4 avec la base de donnes interne MySQL et que vous passez la
version 5, votre installation de hMailServer se poursuivra en utilisant MySQL.
Changements de configuration du port TCP/IP
Avec hMailServer 4, il tait possible de configurer les adresses IP et les ports TCP/IP que
hMailServer doit surveiller. Ill n'y avait aucun lien entre ces deux paramtres et ils taient crs
indpendamment l'un de l'autre.Avec la version 5, ces deux rglages sont dsormais uniques, ce
qui signifie qu'il est maintenant possible de spcifier les ports que hMailServer doit surveiller pour
diffrentes adresses IP. Sur 127.0.0.1, par exemple, hMailServer peut surveiller le port 25 et sur
192.168.0.1, il peut surveiller le port TCP/IP 26. Si vous n'avez pas modifi le multi-hbergement
par dfaut ou le paramtrage du port TCP/IP dans hMailServer 4, ce changement ne vous
affectera pas.
Changements de l'API COM
De nombreux changements ont t effectus dans l'API COM.
Algorithme de hachage du mot de passe
Avec la version 4, hMailServer stocke les mots de passe des comptes sous la forme de hachages
MD5 dans la base de donnes. MD5 n'est plus considr comme sr, et dans hMailServer 5, un
algorithme nomm SHA256 le remplace. Si vous disposez d'un logiciel personnalis qui accde la
base de donnes de hMailServer et qui suppose que les mots de passe des comptes sont sous la
forme de hachages MD5, vous devez actualiser ce logiciel, ou configurer hMailServer pour
continuer utiliser MD5 en utilisant le paramtre PreferredHashAlgorithm.
Mise niveau: 5.0 vers 5.1

Gnralits
Cette section dcrit les tapes suivre pour passer de hMailServer version 5.0 hMailServer
29 / 214
Notez que la configuration systme requise pour la version 5 n'est pas,la mme que pour la
version 4. Si vous utilisez, par exemple, Microsoft SQLServer, Microsoft SQL Server 2005 est
dsormais requis.
hMailServer.ini.
d'installer hMailServer 5.1 d'abord sur un serveur test pour en connatre les nouvelles
fonctionnalits.
Rtro-compatibilit
hMailServer 5.1 inclut de nombreux changements. Certains de ces changements modifient le
comportement des fonctionnalits existantes. Les fonctionnalits suivantes ont t rorganises
dans hMailServer 5. Aprs la mise niveau, revoyez la configuration pour vrifier qu'elle
correspond bien vos attentes.
Paramtrer l'authentification SMTP
Avec hMailServer 5.1, le paramtrage concernant l'authentification SMTP dans les plages IP a t
rorganis. Aprs la mise niveau pour la version 5.1, il est important de revoir la configuration
des plages IP pour voir si elle correspondent vos attentes.
Gnralits
30 / 214
Si vous utilisez un autre logiciel qui communique avec hMailServer, vrifiez que ce logiciel est
compatible avec la version de hMailServer que vous mettez niveau. Ce qui peut tre le cas, par
exemple, si vous utilisez une interface web tierce comme serveur.
hMailServer.ini.
fonctionnalits.
Qoui de neuf?
Dans hMailServer Administrator, sous Utilitaires, un nouvel outil diagnostic de base est
dsormais disponible. Cet outil vous aide rsoudre les problmes configuration de base.
Si un client envoie un message depuis un domaine local, le serveur est alors considr comme
local. La mme chose s'applique si l'adresse correspond un itinraire. Le comportement
prcdent impliquait que l'expditeur tait seulement considr comme local si son adresse
correspondait un compte local. Ce qui signifie que si vous envoyez un message partir de l'alias
d'une adresse, vous tes dsormais considr comme local. Notez qu'il n'est toujours pas possible
de s'authentifier en utilisant un alias.
Dans les options greylisting, vous pouvez dsormais choisir contourner greylisting si SPF passe.
Une nouvelle rgle d'action a t ajoute; Crer une copie. Cette rgle peut tre utilise pour
dlivrer, par exemple, des exemplaires du mme message diffrents serveurs de destination.
Un nouveau critre de rgle a t ajout. Tentatives de Diffusion. Il peut tre utilis pour
envoyer, par exemple, des messages vers diffrents itinraires, en fonction du nombre actuel des
tentatives de diffusion.
Si hMailServer essaie de diffuser le mme message plusieurs fois, les rgles gnrales seront
dsormais excutes chaque fois.
Lorsque vous supprimez des domaines dans hMailServer, vous devez dsormais confirmer cette
action avant suppression.
La mise jour de la base de donnes est dsormais effectue selon une transaction (en
supposant que la base de donnes concerne la prend en charge).
Dans l'assistant d'installation de la base de donnes, le journal de cration dans l'avant-dernire
page est dsormais effac lorsque la page est affiche. Auparavant, le journal pouvait contenir les
donnes des prcdentes tentatives de cration, ce qui pouvait prter confusion.
Rtro-compatibilit
hMailServer 5.2 inclut de nombreux changements. Certains d'entre eux modifient le comportement
de fonctionnalits existantes. Les fonctionnalits suivantes ont t rorganises dans hMailServer
5. Aprs le mise niveau, revoyez cette configuration pour vrifier qu'elle correspond bien vous
31 / 214
attentes.
Configuration de l'authentification SMTP
Dans hMailServer 5.2, les paramtres relatifs l'authentification SMTP pour les plages IP ont t
rorganiss. Aprs la mise niveau pour la version 5.2, il est important de revoir les paramtres
de la plage IP pour confirmer qu'ils correspondent vous besoins.
UID de Message
Lors de la mise niveau vers hMailServer 5.2, les UID de message seront rgnrs. Si votre
client de messagerie a reli les informations a un UID spcifique, ces informations peuvent tre
perdues. Certains clients de messagerie, par exemple, enregistrent des indicateurs d'information,
comme Important ou Suivi par UID de message, ce qui signifie que ces indicateurs peuvent tre
perdus au cours de passage la version 5.2.
Gnralits
Si vous utilisez un autre logiciel qui communique avec hMailServer, vrifiez que ce logiciel est
compatible avec la version de hMailServer que vous mettez niveau. Ce qui peut tre le cas, par
exemple, si vous utilisez une interface web tierce comme serveur.
hMailServer.ini.
fonctionnalits.
Revenir la version prcdente
32 / 214
Gnralits
Il n'existe aucune fonctionnalit dans hMailServer pour effectuer un retour la version
prcdente. Lorsque vous passez d'une version la suivante, des changements concernent la
structure de la base de registre. L'ancienne version de hMailServer ne pourra pas excuter une
base de donnes en utilisant la nouvelle structure de base de donnes, et inversement. Le
package d'installation de hMailServer inclut des scripts de base de donnes qui effectuent les
modifications de base de donnes, mais ils sont unidirectionnels, Les scripts peuvent mettre
niveau la base de donnes, mais pas la rtrograder. Il existe des mthodes manuelles pour
rtrograder une installation de hMailServer, mais ceci ne fonctionnera pas dans la plupart des cas.
Restaurer une sauvegarde
Si vous avez effectu une mise niveau et que vous souhaitez revenir la version prcdente, la
mthode possible consiste dsinstaller compltement hMailServer, d'installer l'ancienne version
puis de restaurer la sauvegarde. Cette approche suppose, de toute vidence, que vous avez
effectu une sauvegarde de l'ancienne version. Un inconvnient potentiel cette approche est
que les messages que vous aurez reus avec la nouvelle version seront perdus (sauf si vous les
avez dj tlchargs via POP3).
Inverser manuellement les changements de la base de donnes
Les changements effectus la base de donnes par les scripts de mise niveau peuvent , dans
certains cas, tre inverss manuellement pour un utilisateur qui connat la syntaxe SQL.
L'utilisateur doit manuellement accder aux scripts de mise niveau en commenant par la fin et
dfinir leur action. Il doit crer de nouveaux scripts qui inversent les modifications de la base de
donnes.Dans de nombreux cas, cette approche n'est pas possible. Si, par exemple, une
fonctionnalit, qui existait dans l'ancienne version, a t supprime dans la nouvelle version, les
donnes requises pour cette fonctionnalit peuvent avoir t perdues lors de la mise niveau.
Alternatives
Si vous rencontrez un problme avec la version en cours de hMailServer, le mieux est d'essayer de
le rsoudre.Les utilisateurs pensent parfois qu'ils doivent revenir la version antrieure s'ils sont
confronts un problme, alors que ce problme n'est pas, en fait, li hMailServer. Le problme
peut tre li certaines fonctions qui ont t modifies dans hMailServer, ou il peut s'agir d'un
bug, auquel cas il peut tre corrig s'il a t rapport.
Configuration
Compte
Gnral
Adresse du compte
L'adresse de messagerie du compte. Un compte ne peut possder qu'une seule adresse e-mail.
Vous pouvez utiliser des alias pour rediriger le message de plusieurs adresses de messagerie vers
un seul compte.
Mot de passe du compte
Le mot de passe du compte. Les mots de passe sont crypts et enregistrs dans la base de
donnes de hMailServer.
33 / 214
Taille maximum(Mo)
L'espace disque maximum que peut utiliser le compte. Si la limite est atteinte, le compte ne pourra
plus recevoir de messages. Dans hMailServer 3.0, la taille du compte est mesure en Ko. A partir
de hMailServer 4.0, elle est mesure en Mo. Si un message est envot ce compte lorsque son
quota a t utilis, hMailServer envoie une notification l'expditeur qui indique que le quota du
destinataire a t atteint. Le message sera alors abandonn.
Lorsqu'un message est envoy via Internet, les donnes binaires sont encodes (du fait des
limitations du protocole SMTP). Cet encodage augmente, la taille du message de 50% en
moyenne. Ce qui signifie que lors de la cration du compte, si vous rglez le quota sur 10Mo et
que vous envoyez une pice jointe de 10Mo, le message sera vraisemblablement trop volumineux
pour le compte. Lors de la configuration de la taille de la bote aux lettres, vous pouvez en tenir
compte.
Niveau d'administration
Les rglages du niveau d'administration vous permettent de dfinir la partie du serveur laquelle
un utilisateur pourra accder. Le paramtre est d'abord utilis par PHPWebAdmin.
Utilisateur - L'utilisateur peut changer les paramtres qui s'appliquent son propre compte. Il
peut, par exemple, changer son mot de passe, son message d'absence du bureau et ses
paramtres de transfert. Il ne peut pas augmenter la taille maximum de son propre compte, ni
modifier les paramtres du dossier actif
Domaine - L'utilisateur peut modifier la configuration qui s'applique son domaine et aux
utilisateurs qui en font partie. L'utilisateur pour modifier tous les rglages des autres utilisateurs
de son domaine, ajouter de nouveaux utilisateurs, des alias et des listes de diffusion, supprimer
des lments, augmenter la taille maximum du compte et ainsi de suite.
Serveur - L'utilisateur peut changer tout paramtre et modifier tout lment (tels que le domaine
et les comptes) sur le serveur.
Date et heure de la dernire ouverture de session
Indique la date et l'heure de la dernire ouverture de session du compte. Si un utilisateur n'a
jamais ouvert de session sur le compte, la date et l'heure de cration du compte seront affiches.
Activ
Cette option vous permet d'activer ou de dsactiver le compte.
Rponse automatique
La Rponse Automatique est galement connue sous le terme de Message de Vacation ou
Notification d'Absence du Bureau. Une rponse automatique est envoye automatiquement
lorsque vous partez en vacances ou que vous tes absent de votre bureau pour un certain temps.
Avant de partir, entrez un sujet et saisissez un message. Lorsqu'on vous envoie un essage,
hMailServer envoie automatiquement votre Rponse Automatique l'expditeur.
Spcifier un message de Rponse Automatique
1.Accdez au compte dans hMailAdmin
2.Slectionnez l'onglet Rponse Automatique
3.Choisissez Activer
4.Entrez un sujet et saisissez un message
Remarques
Si vous laissez le champ Sujet vierge, le serveur rglera automatiquement le sujet sur

Re: [sujet d'origine du courrier lectronique de l'expditeur]
Pour viter un message en boucle, les messages de rponse automatique ne sont pas envoys
34 / 214
aux comptes dont la rponse automatique est active. De mme, hMailServer n'envoie qu'une
seule rponse automatique par expditeur.
Nous vous conseillons de vous dsinscrire des listes de diffusion avant d'activer le message
d'absence.
La macro %SUBJECT% peut etre utilise dans le Sujet et le Corps du message de rponse
automatique. Le texteThe text %SUBJECT% will be replaced with the subject of the original e-mail
message.
Expiration Automatique
En slectionnant Expiration Automatique, vous pouvez configurer hMailServer pour dsactiver
automatiquement la Rponse Automatique une date donne. Ce qui peut tre souhaitable si
vous savez que vous vous absentez pendant deux ou trois jours du bureau. A votre retour, vous
n'aurez plus penser que vous devez dsactivez la rponse automatique manuellement.
Transfrer
La fonctionnalit Transfrer vous permet de transmettre un message depuis ce compte vers un
autre. Slectionnez Activer le transfert pour lancer le transfert des messages. Entrez l'adresse de
messagerie vers laquelle vous souhaitez transfrer les messages. Si vous souhaitez transfrer
des messages sans en garder un exemplaire, dsactivez Garder un original du message.
Signature
Si vous spcifiez une signature, elle sera ajoute tous vos messages sortants. Il est possible de
spcifier une signature en texte simple et une signature HTML. Si une signature en texte simple a
t spcifie, sans signature HTML, hMailServer utilisera la signature en texte simple comme
signature HTML. hMailServer convertira les sauts de lignes du texte simple en sauts de ligne HTML.
Il est possible d'utiliser les macros%User.FirstName%et %User.LastName% dans les signatures.
Ces macros seront remplaces respectivement par le prnom et par le nom de l'utilisateur comme
spcifi dans les paramtres du compte.
Rgles
Les rgles du compte fonctionnent exactement comme les rgles gnrales. La diffrence est qe
les rgles locales ne s'appliquent que pour les messages qui sont dlivrs un compte spcifique.
Voir la documentation sur les rgles gnrales pour en savoir plus.
Comptes Externes
A l'aide de la fonctionnalit Comptes Externes, vous pouvez configurer hMailServer pour
tlcharger les messages partir d'autres serveurs de messagerie, en utilisant le protocole POP3.
Aprs le tlchargement des messages, les rgles gnrales, l'examen viral, etc sont appliqus
aux messages. Ils sont ensuite normalement diffuss un ou plusieurs comptes locaux.
Scnario 1:
Votre installation de hMailServer hberge les e-mails de votre domaine. Vous souhaitez
tlcharger les massages d'un autre serveur de messagerie et les placer dans des comptes
locaux.
Etapes suivre:
1.Accdez la Configuration du Compte vers lequel vous souhaitez tlcharger les messages
2.Affichez l'onglet Comptes externes
3.Cliquez sur Ajouter pour ajouter un nouveau compte.
35 / 214
4.Entrez un nom pour le compte externe.
5.Entrez les informations d'ouverture de session.
6.D-slectionnez "Distribuer aux destinataires dans les en-ttes MIME" (le cas chant)
7.Spcifiez la frquence laquelle vous souhaitez que hMailServer tlcharge les messages, et la
dure de leur stockage sur le serveur POP3 distant.
8.Enregistrez le compte
Aprs avoir suivi ces tapes, hMailServer tlchargera les messages et les placera dans les
comptes pour lesquels vous avez cr un compte externe.
Scnario 2:
Votre domaine est hberg par votre FAI. Il a cr un compte de messagerie "catch all" pour vous.
Ds que quelqu'un vous envoie un message vers un destinataire de votre domaine, il aboutit dans
le compte "catch-all".
Etapes suivre
1.Crez un domaine dans hMailServer
Le nom du domaine devrait tre votre nom de domaine public.
2.Crez des comptes pour vos utilisateurs.
3.Accdez aux paramtres de votre propre compte
4.Affichez l'onglet Comptes Externes
5.Cliquez sur Ajouter pour ajouter un nouveau compte.
6.Entrez un nom pour votre compte externe.
7.Entrez les informations d'ouverture de session.
8.Slectionnez "Distribuer aux destinataires dans les en-ttes MIME"
9.Spcifiez la frquence laquelle vous souhaitez que hMailServer tlcharge les messages, et la
dure de leur stockage sur le serveur POP3 distant..
10.Enregistrez le compte
Aprs avoir suivi ces tapes, hMailServer tlchargera les messages et les distribuera aux
destinataires dans les en-ttes MIME des messages. Si hMailServer ne peut pas dfinir qui les
messages sont distribuer (s'il n'existe aucun destinataire dans les en-ttes MIME), il les dlivre
sur votre compte (celui dans lequel vous avez ajout le compte externe)
Lier Active Directory
Compte Active Directory
Activez cette option si vous souhaitez lier le compte un Compte Active Directory sous Windows
NT/2000. Il y a plusieurs avantages utiliser un lien vers un Active Directory. Par exemple, aucun
des mots de passe de compte n'est enregistr dans la base de donnes de hMailServer.
L'utilisateur doit, la place, fournir son mot de passe de domaine Windows NT/2000 lors de son
ouverture de session sur le serveur POP3.
Domaine Active Directory
Domaine Active Directory est le nom de domaine de Windows NT/2000, lorsque le compte du
serveur de messagerie est li un compte Active Directory de Windows 2000/NT.
Nom d'Utilisateur Active Directory
Le Nom d'Utilisateur Active Directory est le nom d'utilisateur du domaine Active Directory auquel le
compte du serveur de messagerie est li.
Avanc
36 / 214
Informations personnelles
Utilisez ce rglage pour indiquer le nom complet de l'utilisateur hbergeant ce compte. hMailServer
n'utilise pas ces informations.
Autres actions
Editer les dossiers - Cette option vous permet de crer et de supprimer les dossiiers IMAP lis
ce compte.
Vider le compte - Cette option supprime tous les dossiers IMAPet leur contenu (messages) de ce
compte.
Dverrouiller - Cette option supprime le verrouillage POP3 de ce dossier. Cette option ne devrait
tre utilise que si le compte reste verrouill mme lorsque le client s'est dconnect.
Avanc
Gnral
Domaine par dfaut
Ce paramtre vous permet de spcifier le domaine hMailServer qui sera utilis par dfaut si un
utilisateur ne spcifie pas le nom de domaine lors de son ouverture de session. Si vous spcifiez,
par exemple, que le nom de domaine par dfaut est example.com, et qu'une personne essaie
d'ouvrir une session avec pour nom d'utilisateur "bob", hMailServer supposera qu'il s'agit de
"bob@example.com" qui essaie d'ouvrir une session.
Mot de Passe d'Administration
Ce paramtre vous permet de changer le mot de passe administrateur de votre installation
hMailServer. Ce mot de passe est requis pour ouvrir un session Administrateur sur hMailServeret il
est donc important de le mmoriser.
Alias
Gnralits
Las alias sont utiliss pour Transfrer un message d'une adresse de messagerie spcifique une
autre. Imaginez-les comme des adresses sans bote aux lettres; au lieu de possder leur propre
bote aux lettres, ils enregistrent les messages reus dans la bote aux lettres d'un autre compte.
Ce qui peut tre utile si vous souhaitez surveiller plusieurs adresses de messagerie, mais que
vous ne possdez qu'un seul compte de messagerie rel sur le serveur. Vous pourriez, par
exemple, souhaiter recevoir les massages envoys webmaster@domain.com,
feedback@domain.com et yourname@domain.com, mais vous souhaitez crer le seul compte
webmaster@domain.com au lieu de trois comptes diffrents. Les comptes feedback@domain.com
et yourname@domain.com pourront alors tre des alias du compte webmaster@domain.com
Ajouter un alias
1.Accdez au domaine dans hMailServer Administrator
2.Slectionnez le nud Alias du domaine.
3.Cliquez sur Ajouter...
4.Entrez une adresse de messagerie dans Rediriger depuis. Il s'agit de l'alias d'une adresse
messagerie, ex.:
feedback@domain.com
de l'illustration ci-dessous. Les messages envoys cette
adresse seront transfrs l'adresse que vous avez spcifie dans le champ .
5.Entrez l'adresse de messagerie principale dans le champ .
37 / 214
Remarques
Vous ne pouvez pas utiliser un alias d'adresse qui correspond l'adresse de messagerie d'un
compte existant.
Il est impossible d'utiliser un alias pour Transfrer un message deux comptes diffrents. Utilisez
plutt une liste de diffusion.
Un alias peut Transmettre des messages tout compte - mme aux comptes de domaines qui ne
rsident pas sur lle mme serveur.
Lors de l'ouverture d'une session sur le serveur, un alias ne peut pas tre utilis. Seule une
adresse de compte peut tre utilise pour ce faire.
Configuration
Rediriger depuis
Une adresse de messagerie alias partir de laquelle les messages seront redirigs. L'adresse de
messagerie ne peut tre la mme qu'une adresse de compte ou qu'une adresse de liste de
diffusion.
L'adresse de messagerie vers laquelle l'alias doit rediriger. Il peut s'agir d'un compte, d'un autre
alias, d'une liste de diffusion ou de l'adresse de messagerie d'un domaine externe.
Antispam
Gnralits
hMailServer dispose d'un certain nombre de mthodes protections anti-spam intgres.Celles-ci
fonctionnent en vrifiant l'expditeur des messages, le contenu des message et la faon dont ils
sont envoys hMailServer. Si un message contient, par exemple, des liens qui pointent sur des
pages web de spammer, ou s'il est envoy partir d'une adresse connue pour envoyer des
spams, il peut tre classifi comme spam. La liste complte des mthodes de protections intgres
contre les spams peut tre consulte ici.
Score de Spam
Chacun des tests effectus par hMailServer gnre une Score de Spam. Si le test spcifique du
spam indique hMailServer que le message est un spam, un score de spam configur - ou calcul
- est ajout au message. Lorsque tous les tests de spam sont excuts, hMailServer compares le
score total de spam du message deux seuils diffrents mis en place dans hMailServer.
Le premier seuil est le seuil de Marquage.Si le score total du message atteint le seuil de
Marquage de spam, le sujet du message est modifi pour indiquer que le message contient un
spam. En utilisant le marquage des messages, l'utilisateur peut facilement dtecter et supprimer
les messages spam, ou en tant qu'administrateur du serveur, vous pouvez dfinir des rgles pour
dplacer les messages spam dans un dossier IMAPspcifique, ou les transfrer dans un dossier
spcifique.
Le second seuil de spam est le seuil de Suppression.Si le message atteint ce seuil, le message
est supprim.
Quand la protection anti-spam est-elle excute?
hMailServer essaie de dterminer si le message est un spam aussi ds que possible lors de la
38 / 214
communication avec l'expditeur du message. Plus tt la dtection est effectue, moins les
ressources de votre serveur seront requises pour manipuler le message. Un autre avantage d'un
dtection rapide est que hMailServer peut plus facilement dire l'expditeur que son message est
rejet par la protection anti-spam et donc lui notifier.
Si un e-mail est dlivr hMailServer via SMTP, hMailServer effectue la protection selon les tapes
suivantes:
Aprs la commande RCPTTO.Aprs que le destinataire du message a t indiqu, hMailServer
excute la protection anti-spam.
Aprs la commande DATA. Lorsque la totalit du message a t transmise hMailServer, celui-ci
excute la protection anti-spam sur le contenu du message.
Si hMailServer tlcharge les messages partir d'un compte externe, la protection anti-spam est
excute avant l'enregistrement dans le dossier du compte.
Quels messages sont examins?
hMailServer examine tous les messages qui sont dlivrs aux comptes utilisateur, en supposant
que les lments suivants soient runis:
Le message est dlivr hMailServer via SMTP, ou tlcharg partir d'un compte externe
utilisant POP3.
Au moins une mthode de protection anti-spam est active dans la Configuration Anti-spam.
L'adresse IP ou le domaine de l'expditeur n'est pas dans la liste blanche en utilisant une liste
dossier blanc
L'adresse IP de l'expditeur correspond une plage IPpour laquelle l'Anti-spam est activ.
Configuration
Seuil de marquage d'un spam
Lorsque hMailServer excute la protection anti-spam, chaque mcanisme de protection anti-spam
attribue un score. Si le score total du message dpasse cette valeur - mais reste infrieur au Seuil
de Suppression du Spam, le message sera marqu comme spam.
Ajouter X-hMailServer-Spam - Ajoute un en-tte MIME X-hMailServer-Spam au message.
Ajouter X-hMailServer-Reason - Cette option active, hMailServer ajoutera un en-tte de
message qui contient le motif pour lequel il a considr le message comme un spam.
Ajouter au sujet du message - Avec cette option, vous pouvez spcifier le texte qui devra
prcder le sujet du message. En association avec les rgles, les messages de spam peuvent tre
dplacs dans des dossiers IMAP spcifiques.
Seuil de suppression d'un spam
Lorsque hMailServer excute la protection anti-spam, chaque mcanisme de protection anti-spam
attribue un score. Si le score total du message dpasse cette valeur, le message sera supprim et
ne sera pas distribu aux destinataires.
Taille maximum du message examiner (Ko)
Si la taille d'un message dpasse cette valeur, hMailServer ne l'examinera pas pour la dtection
anti-spam. Gnralement, les spammers envoient des petits messages pour conomiser la bande
passante, et l'examen de messages volumineux ne sert rien dans la plupart des cas. L'examen
de messages volumineux la recherche d'un spam peut ncessiter beaucoup de ressources CPU.
Teste anti-spam
39 / 214
Utiliser SPF
Slectionnez pour activer le protection anti-spam via SPF.
Vrifier l'hte dans la commande HELO
Activez cette option si vous souhaitez que hMailServer vrifie le nom de l'hte que le client a
spcifi dans la commande HELO. En fonction de la spcification SMTP, l'hte indiqu dans la
commande HELO doit correspondre l'adresse IP du client. Activer cette option peut arrter le
spam, mais est aussi une violation du RFC SMTP - si vous avez configur votre serveur pour
supprimer les spams. Si vous avez configur votre serveur pour dlivrer les spams en modifiant
l'en-tte Sujet, il n'y aura pas violation du RFC SMTP. Techniquement, hMailServer vrifie
l'enregistrement A de l'hte donn pour voir s'il correspond l'adresse IP du client se connectant.
Vrifier que l'expditeur a les enregistrements MX DNS
Si vous activez cette option, hMailServer vrifiera que le domaine de l'expditeur a des
enregistrements MX valides dans les DNS. Sinon, le score de spam de ce test sera ajout au score
de spam total pour le message.Notez qu'il n'est pas ncessaire que les domaines aient des
enregistrements MX. Il est parfaitement valable pour un domaine de ne pas possder les
enregistrements MX et d"envoyer tout de mme des messages. Bien que la plupart des
propritaires de domaine dfinissent les enregistrements MX, loin s'en faut. Ce qi signifie que vous
devez vous attendre de nombreux faux positifs en utilisant ce test anti-spam.
Vrifier l'en-tte de signature DKIM
Si vous activez cette option, hMailServer recherchera un en-tte de signature DKIM dans chaque
message entrant. Si un tel en-tte est dtect, hMailServer vrifiera que le contenu du message
correspond la signature. Sinon, le score de spam de ce test sera ajout au score total de spam
pour ce message.
SpamAssassin
Utilisez cette option si vous souhaitez que hMailServer s'intgre une installation SpamAssassin
existante.
Nom d'hte
Il s'agit du nom d'hte du serveur SpamAssassin auquel hMailServer doit se connecter. Si
SpamAssasin est excut sur le mme ordinateur que hMailServer, la valeur doit tre
"localhost" (sans les guillemets).
Port TCP/IP
Spcifiez le port TCP/IP que le serveur SpamAssassin surveille. Par dfaut, SpamAssassin surveille
le port 783.
Utiliser le score de SpamAssassin
Si cette option est active, hMailServer utilisera le score de spam fourni par SpamAssassin et
l'ajoutera au score de spam de hMailServer. Sinon, hMailServer utilisera le score spcifi dans le
champ Score.
Test
Cliquez sur ce bouton si vous souhaitez que hMailServer teste la connexion SpamAssassin.
Aprs ce test, le rsultat sera affich.
Informations connexes
40 / 214
Plages IP
Il est possible de dsactiver la fonctionnalit de protection anti-spam de hMailServer par plage IP.
Par exemple, il n'est normalement pas ncessaire de contrler l'existence de spams sur un rseau
local. Consultez la documentation sur les plages IP pour en savoir plus.
Liste blanche
Il est possible d'utiliser les enregistrements de la liste blanche pour dsactiver la protection anti-
spam des messages envoys partir d'une adresse de messagerie ou IP spcifique. Il s'agit d'une
solution plus flexible que d'utiliser les plages IP.
Avanc
Tarpitting
Le Tarpitting (rpulsion) est une technique anti-spam qui fonctionne en ralentissant la
communication avec les spammers.
Autres mthodes
Rfrence liste noire DNS
Rfrence SURBL
Rfrence liste grise
Rubrique connexe
Liste blanche
Antivirus
Gnralits
hMailServer dispose d'une prise en charge intgre pour l'antivirus open source, ClamWin. Pour
utiliser un autre antivirus, utilisez la fonctionnalit Antivirus Externe. Elle vous permet d'excuter
tout antivirus qui prend en charge l'examen en ligne de commande. Dans le champ Excutable
Antivirus, spcifiez la ligne de commande utiliser lors de l'examen. Dans lee champ Retourner la
Valeur, spcifiez la valeur que l'antivirus retournera lors de la dtection d'un virus. Cette valeur
varie en fonction de l'antivirus. Voyez la fin de cette page pour la liste des antivirus et leurs lignes
de commande. Si vous utilisez la macro %FILE% dans la ligne de commande, hMailServer
remplacera %FILE% par le chemin complet du fichier examiner.
Configurer hMailServer pour utiliser un antivirus externe
Cet exemple indique comment rgler hMailServer pour qu'il utilise AVG Free 7. Il suppose que vous
avez install AVG Free sur C:\Program Files\Grisoft\AVG Free
2.Accdez Configuration -> Protocoles -> SMTP -> AntiVirus
3.Accdez la page Antivirus externe.
4.Slectionnez Utiliser un antivirus externe
5.Spcifiez la ligne de commande suivante.

Les guillemets (") sont inclure
:
"C:\Program Files\Grisoft\AVG Free\avgscan.exe" /EXT=* /NOBOOT /NOMEM /SCAN /NOSELF /
41 / 214
NOHIMEM /ARC "%FILE%"
6.Entrez
6
comme valeur de retour. (
Avgscan.exe
retournera la valeur 6 si un virus est dtect).
Lignes de commande des antivirus
Pour en savoir plus sur les lignes de commande des antivirus, consultez la liste des exemples
Faire un test
Comme un test avec un vrai virus est risqu, vous pouvez utiliser le fichier de test antivirus EICAR.
Il est considr comme un virus par les antivirus, mais il est sans risque car il n'est pas un vrai
virus. Ces sites vous permettent d'envoyer un message contenant le fichier de test antivirus
EICAR:
Alpha-tec.
Webmail.us.
En savoir plus
Comment dterminner la valeur de retour d'un antivirus
Remarque
La fonctionnalit de la macro %FILE% ne s'applique qu' hMailServer 4.0 build 85 et suprieur.
Configuration
Lorsqu'un virus est dtect
Choisissez Supprimer le message si vous souhaitez supprimer immdiatement le message
contenant un virus. Choisissez Supprimer les pices jointes si vous souhaitez que le message
contenant un virus vous soit dlivr, mais que les pices jointes soient supprimes. Lors de la
suppression du message, vous pouvez choisir d'informer l'expditeur du message qu'un virus a
t dtect dans celui-ci.
Taille maximum du message pour l'examen viral (Ko)
La plupart des messages qui contiennent un virus sont de taille relativement petite. A l'aide de ce
paramtre, vous pouvez configurer hMailServer pour ignorer l'examen viral si un message et de
taille suprieure la taille spcifie.
ClamWin
Dtection Auto
hMailServer peut tre automatiquement configur pour utiliser ClamWin. Pour ce faire, cliquez sur
Dtection auto. hMailServer lira les paramtres de ClamWin partir de la base de registre de
Windows. Aprs a dtection automatique des paramtres, vrifiez qu'ils sont corrects.
Notez que ClamWin doit d'abord tre install pour ce faire.
Antivirus Externes
Excutable de l'antivirus
42 / 214
Le chemin de l'excutable de l'antivirus qui doit tre excut. Ce qui devrait tre un examen en
ligne de commande sans interface utilisateur.
Valeur de retour
La valeur que doit retourner l'antivirus si un virus est dtect.
Bloquer les pices jointes
Ce paramtre vous permet de bloquer les pices jointes en fonction de leur extension. Si vous
activez cette option, hMailServer supprimera la pice jointe et ajoutera une nouvelle pice jointe
avec pour nom <nom d'origine>.txt qui contient un bref message indiquant que la pice jointe a
t supprime.
Interdiction automatique
Auto-ban
Gnralits
C'est un problme frquent que les gens utilisent des mots de passe faibles que les spammeurs
parviennent comprendre l'aide de dictionnaires. En utilisant la fonctionnalit interdiction
automatique, hMailServer peut dconnecter automatiquement ces spammeurs et rduire le risque
que votre serveur soit utilis pour diffuser des spams.
Si le Nombre maximum de tentatives de connexions non valides est effectu partir d'une adresse
IP spcifique dans le nombre de Minutes avant rinitialisation, la connexion des clients de cette
adresse IP sera interdite automatiquement pendant les Minutes d'interdiction automatique.
Lorsqu'un utilisateur est banni, une plage d'adresses IP correspondant cet utilisateur est
automatiquement cre. Dans cette plage IP, tous les protocoles sont dsactivs, ce qui a pour
effet d'empcher l'utilisateur de se connecter. La nouvelle plage IP aura une date d'expiration, ce
qui signifie qu'elle sera supprime lorsque les minutes d'interdiction automatique sont atteintes.
Nommer la plage IP
Lorsqu'un client est banni, une plage IP correspondant son adresse IP sera cre. Cette plage
IPportera le nom suivant:
Auto-ban:username (random)
o "username" sera remplac par le nom d'utilisateur avec lequel il tente d'ouvrir une session, et
"random" par une chane alatoire de 9 caractres.
Dans hMailServer, vous ne pouvez pas avoir plusieurs plages IPdu mme nom. C'est la raison
pour laquelle la chane alatoire est incluse.
Problmes potentiels
La fonctionnalit Interdiction Automatique bloque les adresses IP. Si trop de tentatives
d'ouvertures de session non valides sont effectues partir de la mme adresse IP, celle-ci sera
bannie. Si vous utilisez un systme webmail, toutes les connexions hMailServer partir de ce
systme webmail proviendront de la mme adresse IP. Si trop de tentatives d'ouverture de
session sont effectues depuis ce systme webmail, l'adresse IP laquelle celui-ci se connecte
sera bloque.
43 / 214
Pour rsoudre ce problme, vous pouvez insrer le systme webmail dans la liste blanche. Un
contournement du problme consiste ajouter une nouvelle plage IPcorrespondant l'adresse IP
partage et attribuer cette plage IPune priorit plus leve que toute plage IP ajoute par la
fonctionnalit Interdiction Automatique. Les plages IP ajoutes par l'Interdiction Automatique se
voient attribuer la priorit 20, et si votre propre plage IP a pour priorit la valeur 25, elle aura la
priorit.
Configuration
Si le Nombre maximum de tentatives de connexions non valides est cr partir d'une adresse IP
spcifique dans les Minutes avant rinitialisation, La connexion des clients de l'adresse IP sera
Interdite Automatiquement pendant les minutes d'interdiction automatique.
Sauvegarde
Gnralits
Les sauvegardes hMailServer sont effectues par le service hMailServers. Lorsque vous dcidez de
lancer une sauvegarde dans hMailServer Administrator, celui-ci se connecte au service hMailServer
via l'API COM, et demande au service hMailServer de lancer une sauvegarde. De ce fait, le service
hMailServer doit tre en activit lorsqu'une sauvegarde va s'effectuer.
La fonctionnalit de sauvegarde intgre est conue pour des petites installations. Si vous avez
plus de 50 comptes ou 10.000 messages sur le serveur, nous vous recommandons vivement
d'utiliser un outil externe pour effectuer une telle sauvegarde.
Un fichier de sauvegarde cr par une version spcifique ne peut pas tre restaur pour une
version diffrente. Vous ne pouvez pas restaurer, par exemple, une sauvegarde cre sous la
version 4.2 dans une version 4.3.
Sauvegarder sur des lecteurs rseau
Pour russir une sauvegarde, le service hMailServer doit avoir la permission d'crire vers le chemin
que vous avez spcifi comme destination de sauvegarde.
Si la destination de la sauvegarde est un lecteur rseau, vous devez vrifier que le service
hMailServer les permissions d'criture sur le lecteur. Normalement, vous aurez modifier le
compte d'ouverture de session pour le service hMailServer avant de sauvegarder sur un lecteur
rseau. Vous y parviendrez dans les paramtres du service dans le Panneau de Configuration de
Windows
En savoir plus
Pour en savoir plus, consultez la rubrique
Recommandations sur la sauvegarde
Configuration
Remarque: Comme la sauvegarde est une partie critique de l'excution d'un serveur, et que
hMailServer 4.2 est la premire version inclure une prise en charge de sauvegarde intgre,
vous devez considrer que la fonction de sauvegarde de hMailServer comme exprimentale. Ne
vous fiez pas elle pour sauvegarder des donnes professionnelles critiques.
La fonctionnalit de sauvegarde intgre est conue pour les petites installations. Si vous avez
plus de 50 comptes ou 10.000 messages sur le serveur, nous vous recommandons vivement
d'utiliser des outils externes pour ce faire.
44 / 214
Destination
Le chemin o sera enregistre la sauvegarde.
Paramtres
Si cette option est slectionne, hMailServer enregistrera ses propres paramtres. L'option
comprend les rgles gnrales, les rglages SMTP, POP3, IMAP, le cache, les hbergements
multiples et autres options de Configuration dans hMailServer Administrator.
Domaines
Cette option inclut tous les domaines hMailServer et les lments lis aux domaines. Ce qui
signifie que si vous choisissez de sauvegarder les domaines, les comptes, les comptes externes,
les rgles de niveau de compte, les alias, les listes de diffusion et autres lments appartenant au
domaine seront sauvegards. Les options ne comprennent pas les dossiers IMAP lis aux
comptes.
Messages
Si vous avez choisi de sauvegarder les domaines, vous pouvez aussi choisir de sauvegarder les
messages. Si vous choisissez cette option, hMailServer sauvegardera les dossiers IMAP et les
messages qu'ils contiennent. Les messages en file d'attente envoys hMailServer ne seront pas
sauvegards.
Liste de diffusion
Gnralits
Adresse
L'adresse de la liste de diffusion. Les messages envoys cette adresse seront transfrs tous
les destinataires de la liste de diffusions.
Mode
Public - tout le monde peut envoyer la liste
Membres - Seuls les membres peuvent envoyer la liste
Annonce - Seuls les messages de la liste partir d'une adresse spcifique seront autoriss.
Authentification SMTP Requise
Si cette option est active, hMailServer ncessitera une authentification SMTP pour les diffusions
de la liste. Si vous activez cette option, seuls les utilisateurs ayant des comptes sur le serveur
pourront envoyer un message la liste de diffusion.
Membres
Ajouter
Cliquez sur Ajouter pour ajouter une adresse la liste de diffusion.
Supprimer
Cliquez sur Supprimer pour effacer les adresses slectionnes de la liste de diffusion.
45 / 214
Liste noire DNS
General
Hte DNS
L'hte DNS que hMailServer devrait interroger lorsque vous faites une recherche dans la liste noire
DNS.
Rsultat attendu
L'adresse IP que le serveur de liste noire DNS retournera si l'adresse IP des expditeurs est
dtecte dans la liste noire DNS. Il est possible d'utiliser des jokers dans l'adresse IP. Il n'est pas
possible de spcifier plusieurs adresses diffrentes telles 127.0.0.1 et 127.0.0.4. 127.0.0.* doit
tre utilis dans ce cas.
Message de rejet
Le message que hMailServer enverra au client expditeur si un message est rejet
Domaine
Gnralits
Chaque compte de messagerie de hMailServer doit appartenir un domaine. Le domaine spcifi
dans hMailServer peut tre un domaine de rseau local ou un domaine internet gnral comme
hMailServer.com.
Gnral
Nom de domaine
Le nom du domaine. Pour tre considr comme valide, un nom de domaine doit comprendre un
point. Vous devez dfinir vos serveurs DNS afin que les messages puissent tre envoys votre
serveur de messagerie.
Noms
Un domaine peut avoir plusieurs noms. Ils sont galement connus sous le terme d'alias de
domaine. Votre socit, par exemple, peut possder le nom de domaine company.com, mais elle
peut aussi possder company.org, company.se et company.de. Si vous voulez avoir la possibilit
de recevoir les messages de tous ces domaines, vous disposez de deux options:
1.Ajouter les quatre domaines hMailServer. Le problme, avec cette option, est que vous aurez
ajouter chaque compte de messagerie 4 fois, une fois pour chaque domaine.
2.Ajouter company.com comme domaine, et sous celui-ci, dans l'onglet Noms, ajouter company.org,
company.se et company.de. 'est--dire que vous ajoutez company.org, company.se et company.de
comme des alias de company.com. C'est l'itinraire prfr des utilsiateurs.
Si vous dfinissez un domaine nomm example.com, et un alias nomme example.net, votre
serveur acceptera les messages de someone@example.com et someone@example.net.Vos
utilisateurs pourront aussi ouvrir une session sur someone@example.com et
someone@example.net.
Crer un alias de nom de domaine
46 / 214
2.Dployez le nud Domaines et slectionnez le domaine (ex.:
mydomain.com
).
3.Slectionnez l'onglet Noms.
4.Ajoutez les noms de domaine la liste (ex.:
mydomain.org
et
mydomain.net
)
Remarques
vous ne devriez pas ajouter le nom principal (dans notre exemple,
mydomain.com
) la liste.
vous ne pouvez pas ajouter le mme alias de nom de domaine plusieurs domaines.
Signature
Dans l'onglet Signature, vous pouvez configurer hMailServer pour qu'il ajoute une signature tous
les e-mails envoys partir de ce domaine. Il est possible d'entrer une version Texte Clair et une
version HTML de la signature. Si aucune signature HTML n'est spifie, hMailServer utilisera la
signature texte simple comme signature HTML.
Ajouter une signatures aux rponses
Si cette option est active, hMailServer ajoutera la signature aux rponses. Pour savoir si un
message est une rponse, hMailServer recherche En rponse et l'En-tte des Rfrences du
message. Cette option est dsactive par dfaut.
Ajouter une signature au message local
Si vous choisissez cette option, hMailServer ajoutera une signature au message local. Un message
est considr comme local si l'expditeur et le destinataire existent dans le mme domaine. Un
message envoy d'un domaine un autre n'est pas considr comme un message local, car
l'expditeur et le destinataire peuvent ne pas savoir qu'ils sont hbergs sur le mme serveur.
Activer la signature du domaine
Si vous activez cette option, la signature spcifie sera ajoute au message.
o
Utilisez la signature si aucun n'a t spcifie dans le compte des expditeurs.
Cette option slectionne, hMailServer n'utilisera que la signature du domaine si une
signature de compte n'a pas t spcifie.
o
Remplacer la signature du compte
Cette option slectionne, hMailServer n'utilisera pas les signatures de compte pour ce
domaine. Au lieu de cela, la signature de domaine sera utilise pour tous les messages.
o
Ajouter la signature du compte
Cette option slectionne, hMailServer ajoutera la signature de compte avec la signature de
domaine. Ce qui peut tre utilis, par exemple, si vous souhaitez ajouter des
avertissements tous les messages sortants.
Signature texte simple / signature HTML
Ces deux champs spcifient la signature utiliser
Vous pouvez utiliser les macros%User.FirstName%et %User.LastName% dans les signatures.
Ces macros seront remplaces par le prnom et le nom de l'utilisateur comme indiqu dans la
Configuration de Compte.
Limites
Taille maximum (Mo)
Si cette valeur a t spcifie (diffrente de 0), l'administrateur du serveur et le propritaire du
domaine ne pourront pas ajouter de comptes si la taille totale de tous les comptes dpasse cette
valeur. Si vous abez spcifi 500 Mo, la taille totale de tous les messages du domaine n'excdera
pas 500 Mo.
Taille maximum d'un message
Si cette valeur a t spcifie, hMailServer refusera les messages plus volumineux que cette taille.
Taille maximum des comptes (Mo)
47 / 214
Si cette valeur a t spcifie (diffrente de 0), l'administrateur du serveur et le propritaire du
domaine ne pourront pas ajouter de comptes dont la taille totale dpasse cette valeur.
Numbre de comptes, d'alias et de listes de diffusion
En utilisant ces rglages, vous pouvez limiter le nombre de comptes, d'alias et de listes de
diffusion que les administrateurs du serveur et les propritaires du domaine peuvent crer dans
ce domaine.
Signer DKIM
Le DKIM, Domain Keys Identified Mail, est une mthode pour signer le contenu des messages. Le
destinataire peut vriifier que le message est envoy d'un serveur authentifi pour envoyer
partir du domaine de l'expditeur, et que le contenu du message n'a pas t modifi lors du
transit.
Avant que hMailServer distribue un message un autre serveur, il examinera l'adresse de
l'expditeur du message. Si l'adresse de l'expditeur correspond un domaine local, l'option de
signature DKIM de ce domaine sera utilise. Si la signature DKIM a t active, le message sera
sign.
Que ce soit ou non l'expditeur d'origine qui a utilis l'authentification SMTP lors de la remise du
message hMailServer n'a aucun effet sur le processus de signature DKIM.
hMailServer appose seulement la signature DKIM sur les messages distribus aux autres serveurs.
Si l'utilisateur d'une autre installation hMailServer envoie un message un autre utilisateur du
mme serveur, le message ne sera pas sign.
Fichier cl prive
La cl prive utiliser lors de la signature d'un messages avec DKIM. Il doit s'agir d'un fichier
existant sur le systme de fichiers local, lisible par hMailServer, et qui ne doit pas contenir un jeu
de mots de passe.
Slecteur
Il s'agit du slecteur DKIM utiliser utiliser pour la signature. Pour pouvoir utiliser DKIM, vous
devez spcifier un slecteur.Celui-ci doit tre le mme que le slecteur que vous utilisez pour
l'enregistrement DKIM sur votre serveur DNS. Si, par exemple, votre enregistrement DNSest
nomm myselector._domainkey.example.net, vous devez entrer "myselector" comme slecteur
(sans les guillemets).
Mthode d'en-tte
Choisissez entre la mthode de canonisation simple et modre. Si vous choisissez la mthode de
canonisation simple, les en-ttes signes du message ne doivent pas tre du tout modifis. Si une
nouvelle ligne est ajoute dans un en-tte, la vrification chouera. Choisissez la mthode
modre si vous souhaitez permettre des modifications mineures de l'en-tte.
Mthode de corps
Choisissez entre la mthode de canonisation simple et modre. Si vous choisissez la mthode de
canonisation simple, le corps du message ne doit pas tre du tout modifis. Si une nouvelle ligne
est ajoute au corps, la vrification chouera. Choisissez la mthode modre si vous souhaitez
permettre des modifications mineures du corps du message.
Mthode de signature
Choisissez entre les algorithmes SHA1 et SHA256. SHA256 est conseill car il offre une scurit
plus leve que SHA1. Les expditeurs de messages de faible scurit comme les newsletters
souhaitent plutt utiliser SHA1 car il ncessite moins de ressources CPU.
48 / 214
Avanc
Cet onglet contient les paramtres avancs pour le domaine. Normalement, il n'est pas ncessaire
de modifier ces rglages.
Adresse Catch-all (Attrape-tout)
Il est possible de spcifier une adresse de messagerie qui reoive tous les messages envoys
des adresses qui n'existent pas dans votre domaine. Vous pourriez avoir, par exemple,
sales@mydomain.com
,
webmaster@mydomain.com
et
support@mydomain.com
comme comptes existants.
Mais il y a le risque que quelqu'un puisse mal orthographier une adresse -mail, et crire
sails@mydomain.com
au lieu de
sales@mydomain.com
.
La solution consiste spcifier un compte - soit un compte existant, ou un compte cr pour la
circonstance - comme compte Catch-all. Tous les messages envoys vers une adresse qui n'existe
pas sur le domaine seront envoys au compte catch-all.
Exemple
1.Lancez hMailAdmin
2.Dployez le nud Domaines et slectionnez le domaine, disons,
mydomain.com
3.Crez un nouveau compte avec pour nom
catchall@mydomain.com
4.Slectionnez votre domaine et entrez
catchall@mydomain.com
comme adresse catch-all
5.Enregistrez les modifications
Remarques
L'adresse catch-all peut tre toute adresse de messagerie de votre choix. Elle n'a pas tre
strictement du format
catchall@myDomain.com
L'adresse catch-all n'a pas appartenir un compte de votre domaine, ou mme hMailServer.
Vous pouvez transfrer les messages vers des serveurs externes.
Si vous voulez que hMailServer rejette des messages envoys vers des adresses inexistantes de
votre domaine, ne spcifiez aucune adresse catch-all.
Plus d'adressage
Utilisez cette option pour activer plus d'adressage pour ce domaine. Pour viter la confusion et les
problmes de configuration, seul un jeu limit de caractres est autoris pour plus d'adressage.
Liste grise
Utilise cette option pour activer et dsactiver la liste grise pour ce domaine.
Comptes externes
Gnralits
hMailServer peut tlcharger les messages de comptes POP3 sur d'autres serveurs. Les
tlchargements des messages sont distribus un compte spcifique, mais il est possible de les
rediriger vers un compte externe l'aide de rgles. Les comptes externes sont dfinis selon les
paramtres Compte de l'onglet Comptes externes.
49 / 214
Nom
Le nom du compte externe. Le nom est choisi librement en texte simple.
Type de serveur
Actuellement POP3 uniquement. La prise en charge des autres protocoles, comme IMAP, sera
ajoute ultrieurement.
Adresse du serveur & port TCP
Le nom d'hte et le port TCP/IP du serveur hMailServer auquel s'effectue la connexion lors du
tlchargement des messages.
Nom d'utilisateur & Mot de passe
Le nom d'utilisateur et le mot de passe que hMailServer doit utiliser lors de l'ouverture de session
sur le serveur externe. Ils doivent tre identiques aux informations d'ouverture de session que
vous entrez dans votre client de messagerie lorsque vous vous connectez ce compte.
Configuration
Minutes entre les tlchargements: Dfinit la frquence laquelle hMailServer doit tlcharger
les messages partir du serveur externe. La valeur par dfaut est 30 minutes. Il est conseill de
ne pas rduire cette valeur.
Si vous slectionnez Supprimer les messages immdiatement, hMailServer supprimera les

messages du serveur externe immdiatement aprs leur tlchargement. Inversement, Ne pas
supprimer les messages, indiquera hMailServer de ne pas effacer les messages du serveur
externe. Si vous choisissez Supprimer les messages aprs [x] jours, hMailServer effacera
automatiquement les messages du serveur POP3 lorsqu'ils sont plus gs que [x] jours.
Distribuer aux bnficiaires d'en-ttes MIME: Vous permet grer qui hMailServer doit dlivrer
les messages tlchargs. Par dfaut, hMailServer tlcharge les messages et les place dans le
compte o vous avez cr le compte externe. Si vous avez ajout, par exemple, le compte externe
un compte nomm something@domain.com, tous les tlchargements seront placs dans la
bote de rception something@domain.com. Cependant, si vous slectionnez cette option,
hMailServer les distribuera plutt aux bnficiaires d'en-ttes MIME. Si le champ contient, par
exemple, someone@domain.com, hMailServer vrifiera s'il existe un compte nomm
someone@domain.com. Dans ce cas, il distribuera les messages ce compte.
Dans certains cas, tous les destinataires peuvent ne pas exister dans les en-ttes MIME. Si, par
exemple, vous envoyer un message un destinataire de la liste BCC, ce destinataire ne sera pas
disponible dans les en-ttes MIME, et hMailServer ne saura pas que le message doit lui tre
distribu
Retrouver la date de l'en-tte Reu: Vous permet de configurer hMailServer pour qu'il utilise la
date du dernier en-tte Reu, au lieu d'utiliser la date en cours. Lorsque hMailServer a tlcharg
un e-mail depuis un serveur externe, il rgle normalement la date interne du message sur la date
et l'heure en cours. Si par la suite vous tlchargez le message partir de hMailServer via IMAP, la
date interne peut apparatre comme date de "Rception" dans votre client de messagerie. Si vous
avez slectionn cette option, hMailServer essaiera de dterminer la date de rception du serveur
POP3 externe, et rglera la date interne l'identique. Si ceci choue, hMailServer utilisera la date
en cours.
En d'autres termes: Si vous souhaitez que la colonne Reu de votre client de messagerie affiche la
date laquelle hMailServer a tlcharg le message, ne slectionnez pas cette option. Si vous
souhaitez que la colonne affiche la date laquelle le serveur POP3 externe a reu le message,
activez cette option.
Anti-spam &Antivirus
Slectionnez cette option si vous souhaitez que hMailServer examine les messages tlchargs
pour y dtecter les spam et virus. Si vous savez que le serveur hbergeant le compte externe
50 / 214
excute dj un logiciel anti-spam et antivirus, vous pouvez dsactiver ces options pour le
compte externe afin d'amliorer la performance.
Remarques
Vous devez activer SMTP dans hMailServer pour que les fonctionnalits des comptes externes
fonctionnent.
hMailServer 4.0 et 4.1 tlchargeront les messages des comptes externes, mme si le compte/
domaine parent est dsactiv. Cependant,, si les messages sont supprims du serveur distant, et
que le compte/domaine local a t dsactive, ils seront perdus. Pour viter ceci l'avenir, partir
de la version 4.2, hMailServer ne tlcharge plus les messages des comptes externes si le compte
ou le domaine parent est dsactiv.
Lorsque lee rglage permet de distribuer les messages aux bnficiaires des en-ttes MIME,
hMailServer vrifie les en-ttes suivants:
o
A
o
CC
o
X-RCPT-TO
o
X-Envelope-To
o
Reu (multiple)
Si vous avez choisi de distribuer les messages aux bnficiaires des en-ttes MIME, et qu'aucun
destinataire n'a t trouv, hMailServer placera les messages dans le compte au sein duquel le
compte externe t cr.
Problmes courants
Les destinataires ne sont pas dans les en-ttes MIME
Lors de la distribution des messages aux destinataires des en-ttes MIME, il y a le risque qu'ils ne
soient pas distribus aux bons destinataires ou que certains reoivent des messages en double. Il
est possible, par exemple, d'envoyer un message une adresse mais pas d'en placer une autre
dans les en-ttes MIME. Si hMailServer lit les destinataires partir des en-ttes MIME, le message
ne sera pas distribu au bon destinataire (le destinataire de l'en-tte). Il est galement possible
de placer les destinataires d'un message dans l'en-tte BCC (qui n'est pas inclus au message).
hMailServer ne distribuera pas les messages aux destinataires qui ne sont pas numrs dans les
en-ttes A, CC, X-RCPT-TO, X-Envelope-To ou Reu.
Des messages en double ont t distribus
Si plusieurs exemplaires d'un mme message sont enregistrs dans le compte externe,
hMailServer distribuera plusieurs copies de ces messages. certains serveurs SMTP peuvent
distribuer plusieurs exemplaires d'un mme message un mme compte, si un compte catch-all
est utilis et que le message est envoy plusieurs personnes d'un mme serveur. Le seul
contournement de ce problme consiste reconfigurer le serveur SMTP pour qu'il n'enregistre pas
plusieurs exemplaires d'un mme message. Notez que ce n'est pas hMailServer qui doit tre
reconfigur, mais le serveur SMTP qui distribue les messages au compte POP3 partir duquel
hMailServer effectue le tlchargement.
Liste grise
Gnral
La liste grise vous permet de vous protger d'un spam en rejetant temporairement le message de
votre serveur. La liste grise tire avantage du fait que les serveurs de messagerie correctement
configurs essaieront de redistribuer les messages ultrieurement, alors que les spammeurs, en
principe, abandonneront immdiatement si votre serveur rejette un e-mail.
Lorsqu'un expditeur essaie de diffuser un message pour la premire fois votre serveur,
hMailServer enregistre l'adresse IP de l'expditeur, l'adresse de messagerie de l'expditeur et
l'adresse de messagerie du destinataire. Ces informations sont appeles un triplet. hMailServer
rejettera le message et demandera au serveur d'envoi de bien vouloir ressayer ultrieurement.
La prochaine fois que le serveur d'envoi essaie de distribuer un message qui correspond au
51 / 214
triplet, hMailServer accepte celui-ci.
Les messages de spam qui sont arrts par le liste grise ne sont pas compts dans la page tat
de hMailServer Administrator. Ainsi, mme si vous configurez hMailServer pour distribuer des
messages de spam sans modifier l'en-tte, les messages rejets par le liste grise ne seront pas
distribus du fait du mcanisme de fonctionnement de la liste grise.
Minutes d'attente pour accepter un message
Spcifiez le nombre de minutes d'attente avant que hMailServer accepte un message.
Jours d'attente avant la suppression du triplet inutilis
Si hMailServer rejette temporairement un message, mais que l'expditeur ne refait pas l'essai de
redistribuer le message, hMailServer supprimera le triplet aprs le nombre de jours spcifi.
Jours d'attente avant la suppression du triplet utilis
Avec ce rglage, vous pouvez spcifier la dure de vie du triplets dans hMailServer avant d'tre
supprim. Le nombre de jours est compt partir de la date de dernire utilisation du triplet. Si un
triplet a t cr, par exemple, le jour 1, qu'il est rutilis le jour 5, et que ce paramtre est rgl
sur 10, le triplet sera supprim 15 jours aprs sa cration.
Contourner la liste grise sur Passe SPF
L'inconvnient avec la liste grise est qu'elle entrane un dlai pour les messages lgitimes. Mme
si le dlai n'est pas trs long, il peut parfois tre un facteur de frustration pour l'utilisateur
final.Comme solution partielle ce problme, vous pouvez activer "Contourner la liste grise sur
Passe SPF". Les fournisseurs de messages les plus importants comme Gmail et Hotmail publient
des enregistrements SPFpour leur domaine. Si hMailServer reoit un message d'un domaine qui a
publi des enregistrements SPF, que l'adresse IP lie hMailServer est autorise envoyer
partir de ce domaine, te que cette option est active, hMailServer ne traitera pas avec la liste
grise.
Contourner la liste grise si un message arrive d'un enregistrement ou MX.
Avant de traiter avec la liste grise, hMailServer effectue une recherche DNS/et DNS/MX. Si
l'adresse de connexion est dtecte dans l'un des enregistrements, la liste grise sera ignore
lorsque cette option est active.
Liste blanche
Les serveurs de messagerie qui utilisent des adresses IP diffrentes chaque fois qu'ils essaient
d'envoyer un message hMailServer, les serveurs qui n'essaient pas de renvoyer les messages
qui ont t temporairement rejets, ne sont ps compatibles avec la liste grise. Vous pouvez
ajouter ici une adresse IP de tels serveurs. hMailServer n'utilisera pas la liste grise pour ce
serveur. Les jokers sont pris en charge pour cette liste.
Groupe
Gnral
Nom du groupe
52 / 214
Vous pouvez attribuer un nom de groupe de votre choix.
Membres
Dans l'option Membres, ajoutez le compte des membres que vous souhaitez affecter ce groupe.
Configuration IMAP
Gnral
Connexions
Ce rglage d'finit le nombre maximum de connexions simultanes qui seront autorises au serveur
IMAP. Si zro est spcifi, un nombre illimit de connexions sera autoris.
Autre / Message de bienvenue
Le message de bienvenue est envoy directement aux clients IMAP aprs qu'ils se soient
connects au serveur. Vous pouvez modifier ce message si vous ne souhaitez pas que l'on sache
le type de logiciel serveur que vous utilisez.
Dossiers publics
Nom du dossier public
Le nom du dossier public sera visible de tous les utilisateurs qui ont accs aux dossiers publics.
Editer les dossiers
Choisissez cette option pour grer les dossiers publics.
Les Permissions sont appliques de la manire suivante:
Si une permission correspondant l'utilisateur spcifique est trouve, cette permission est
utilise.
Sinon, hMailServer vrifiera si l'utilisateur est un membre d'un groupe.Si c'est le cas, le premier
groupe est slectionn.
Sinon, hMailServer vrifiera si une permission "Anyone" ("tous") a t dfinie.
Avanc
Extensions
Utilisez ces rglages pour activer ou dsactiver les extensions IMAP sur le serveur.
L'extension SORT IMAP permet aux messages d'tre tris sur le serveur au lieu du client de
messagerie. Ce qui augmente la performance des clients de messagerie web.
Quota IMAP - L'extension Quota IMAP donne la possibilit aux clients IMAP de vrifier l'utilisation
du quota pour le compte.
Idle IMAP - A l'aide de cette extension, le client IMAP peut recevoir des notifications de la part du
serveur ds qu'un nouveau message existe. De cette faon, le client de messagerie n'a pas
vrifier manuellement l'existence de nouveaux toutes les X minutes.
ACL IMAP - Lorsque cette extension est active, vous pouvez dfinir les dossiers publics et leurs
permissions.
53 / 214
Sparateur hirarchique
Choisissez le sparateur hirarchique que hMailServer utilisera. Le sparateur est utilis dans les
communication entre les clients IMAP et hMailServer. Par exemple, dans la hirarchieInbox\Test
\Sub le sparateur est \.
Aprs avoir choisi le sparateur, celui-ci ne peut pas tre utilis dans le nom des dossiers - du fait
qu'il est utilis pour sparer les niveaux d'un dossier. Il n'est pas possible de changer le
sparateur pour un caractre qui est seulement utilis dans un nom de dossier sur le serveur. Il
n'est pas non plus possible de le changer pour un sparateur qui est utilis pour les noms de
dossiers dans des actions de rgle car cela crerait un conflit.
Lorsque vous changer le sparateur hirarchique, hMailServer actualise automatiquement toutes
les actions de rgles qui contiennent ce sparateur hirarchique pour le nouveau.
Relais entrant
Gnralits
hMailServer suppose que tous les messages reus de l'adresse IP d'un relais entrant sont
transfrer.
Normalement hMailServer utilise l'adresse TCP/IP des expditeurs lors de la protection anti-spam.
Si hMailServer reoit le message d'une sauvegarde MX, il ne peut pas utiliser l'adresse TCP/IP des
expditeurs car il s'agit de l'adresse IP du serveur de sauvegarde. Si vous ajoutez l'adresse IP
des serveurs de sauvegarde MX comme relais entrant, hMailServer saura que les messages de ce
serveur sont transfrer. hMailServer essaiera alors de dterminer l'adresse IP d'origine des
expditeurs en analysant les en-ttes Reu du message.
Notez que les relais entrants n'affectent pas la liste grise.Celle-ci prend toujours place avant que
les en-ttes Reu aient t transmis hMailServer. Vous pourriez ajouter toute adresse IP de
relais entrant de la liste grise la liste blanche pour viter qu'il fasse partie de la liste grise.
Configuration du fichier ini

Gnralits
La plupart des paramtres d'installation de hMailServer sont enregistrs dans la base de
donnes. Cependant, certains rglages le sont dans le fichier hMailServer.ini. Les informations
concernant les chemins et les connexions, par exemple, sont enregistres dans le fichier ini. Ce
document numre tous les paramtres prsents dans le fichier hMailServer.ini.
Si vous souhaitez utiliser un paramtre qui n'est pas prsent dans la fichier hMailServer.ini de
votre systme, vous pouvez le faire vous-mme. Pour ajouter, par exemple le paramtre
ConnectionAttempts la section Database, ajoutez simplement la ligne ConnectionAttempts=5
sous la ligne [Database] du fichier hMailServer.ini. Dans certains cas, vous aurez peut-tre aussi
ajouter la section relle ([SectionName]).Si la section existe dj dans le fichier, ajoutez le
paramtre ce fichier. Vous ne pouvez pas avoir deux sections du fichier ini portant le mme nom.
Sections
54 / 214
Directories
ProgramFolder - le chemin du dossier hMailServer. Par dfaut, C:\Program Files\hMailServer.
DataFolder - le chemin du dossier de donnes de hMailServer. Par dfaut, C:\Program Files
\hMailServer\Data.
LogFolder - Le chemin d'enregistrement des fichiers journaux de hMailServer. Par dfaut, C:
\Program Files\hMailServer\Logs
TempFolder - Le chemin d'enregistrement des fichiers temporaires de hMailServer, comme les
pices jointes lors de l'examen antivirus. Par dfaut C:\Program Files\hMailServer\Temp
EventFolder - Le chemin d'enregistrement du fichier vnement de hMailServer. Par dfaut, C:
\Program Files\hMailServer\Events
GUILanguages
ValidLanguages - liste des langues de l'interface utilisateur de hMailServer. hMailServer
Administrator utilise cette liste pour dfinir les langues afficher dans le menu Langue.
Database
Internal - 1 si la base de donnes MySQL interne est utilise, 0 autrement. hMailServer utilise ce
rglage pour dterminer si les scripts sont appliquer la base de donnes MySQL au premier
dmarrage. Si, par exemple, une nouvelle version de MySQL fait partie du programme
d'installation, hMailServer pourra excuter le script SQL pour y apporter le correctif.
Type - le type de base de donnes. Il peut s'agir de MySQL ou MSSQL. hMailServer l'utilise pour
dterminer la mthode utiliser pour la connexion au serveur de base de donnes, et la syntaxe
utiliser pour les instructions SQL.
Username - hMailServer utilisera ce nom d'utilisateur lors de la connexion au serveur de base de
donnes. Si ce paramtre est vierge et que MSSQL est utilis, hMailServer essaiera d'utiliser
Windows Authentication.
Password - le mot de passe que hMailServer doit utiliser lors de la connexion au serveur de base
de donnes. Si passwordencryption est rgl sur 1, le mot de passe est crypt via blowfish.
Passwordencryption - rgl sur 1, le mot de passe de la base de donnes est crypt via blowfish.
Dans ce cas, le service hMailServer dcode le mot de passe avant la connexion la base de
donnes.
Port - le port auquel hMailserver doit se connecter sur le serveur de base de donnes.
Server - le nom d'hte du serveur de base de donnes auquel hMailServer doit se connecter.
Database - le nom de la base de donnes laquelle hMailServer doit essayer de se connecter.
NumberOfConnections - le nombre de connexions qui doit s'ouvrir la base de donnes. La
valeur par dfaut de cette valeur est 5, ce qui signifie que hMailServer ouvrira la connexion 5 au
serveur de base de donnes. hMailServer veut souvent excuter plusieurs requtes de base de
donnes la fois. Comme une connexion spcifique une base de donnes ne peut utiliser qu'un
instruction SQL la fois, plusieurs connexions a la base de donnes amliore la performance.
ConnectionAttempts - le nombre de fois que hMailServer doit essayer de se connecter la base
de donnes avant d'abandonner lors du dmarrage. La valeur par dfaut est 6 fois (hMailServer
4.4 et suprieur).
ConnectionAttemptsDelay - le nombre de secondes de pause que hMailServer doit attendre entre
chaque tentative de connexion lors du dmarrage. La valeur par dfaut est 5 secondes
(hMailServer 4.4 et suprieur).
Security
AdministratorPassword - le mot de passe principal d'administration de hMailServer. L'utilisateur,
par exemple, doit entrer ce mot de passe au dmarrage de hMailServer Administrator. Ce mot de
passe est encod via MD5.
Settings
Les paramtres ci-dessous doivent tre dits avec prudence. Ils existent dans le fichier ini,
uniquement pour des raisons de compatibilit de la base de donnes. Ils seront dplacs vers la
base de donnes dans une prochaine version. Lorsque vous installez la version suivante de
hMailServer, il se peut que vous ayez modifier nouveau ces rglages en utilisant hMailServer
55 / 214
Administrator.
DNSBLChecksAfterMailFrom - par dfaut, hMailServer traite la vrification des listes noires DNS
aprs SMTP/MAIL FROM. Certains utilisateurs prfrent que cette action s'excute aprs la
commande SMTP/RCPT TO. Dans ce cas, rglez cette valeur sur 0.
AddXAuthUserHeader - rgl sur 1, hMailSever ajoutera un en-tte X-AuthUser contenant un nom
d'utilisateur au message reu via SMTP, s'il cet utilisateur t identifi.
GreylistingEnabledDuringRecordExpiration - ce rglage vous permet de configurer hMailServer
pour dsactiver temporairement la fonctionnalit liste grise alors que les anciens enregistrement
de l'ancienne liste grise sont effacs. Ce qui peut tre ncessaire si vous avez une quantit
importante d'enregistrements greylisting et que vous utilisez SQL. Lorsque hMailServer efface les
anciens enregistrements, la table greylisting entire sera verrouille pour longtemps. Si d'autres
connexions de base de donnes tente d'accder la table en attente, ils devront attendre la fin
de la suppression. Si le processus prend plusieurs minutes, ceci est susceptible d'entraner des
problmes. La valeur pas dfaut est 1, ce qui signifie que hMailServer continuera utiliser la liste
grise lors de l'effacement des enregistrements de la base de donnes.
GreylistingRecordExpirationInterval - ce rglage dfinit la frquence laquelle hMailserver doit
effacer les enregistrements greylisting expirs de la base de donnes. La suppression des
enregistrements peut tre une tche fastidieuse. La valeur par dfaut est 240, ce qui signifie que
hMailServer effacera les enregistrements expirs toutes les 240 minutes (toutes les 4 heures).
PreferredHashAlgorithm - Ce paramtre vous permet de spcifier l'algorithme de hachage que
hMailServer doit utiliser pour les mots de passe de la base de donnes hMailServer. Dans les
anciennes versions de hMailServer, les mots de passe taient enregistrs en texte clair. Dans
hMailServer 4, les mots de passe taient enregistrs en MD5. Dans hMailServer 5, le hachage
prfr par dfaut est dsormais SHA256. Les valeurs valides pour ce rglage sont les suivantes:
o
0 - Aucun. Enregistrement des mots de passe en texte claire. Non recommand.
o
1 -Blowfish. Enregistrement des mots de passe via Blowfish. Non recommand, car le mot
de passe utilis pour le cryptage est connu. Ce qui fait que la scurit n'est pas plus leve
que l'option 0.
o
2 - MD5. Enregistrement des mots de passe en hachage MD5. Seulement recommand pour
assurer la compatibilit ascendante, si vous avez une application qui s'intgre avec la base
de donnes hMailServer.
o
3 - SHA256 - Enregistrement des mots de passe en hachages SHA256. C'est habituellement
l'option recommande qui fournit le niveau de scurit le plus lev.
Plage IP
Gnral
Nom
Le nom de la plage IP. Tout texte entre 1 et 40 caractres. Indiquez des noms de plages IP qui
dcrivent ces plages, per exemple Mon ordinateur, Mon LAN, etc....
Priorit
La priorit de la plage IP. Vous pouvez spcifier une valeur entre 0 et 1000. Un valeur leve
signifie une priorit leve. Si hMailServer est confront deux plages d'adresses IP, la plage
d'adresses IP avec la plus haute priorit sera utilis. Par exemple, si un client correspond une
plage IP de priorit 5, et une de priorit 10, hMailServer utilisera la plage IP de priorit 10. Si un
client correspond deux plages IP de mme priorit, le choix que fera hMailServer n'est pas dfini.
IP infrieure & IP suprieure
Toutes les adresses IP situes entre (et comprises) une IP infrieure et une IP suprieure sera
affecte par cette plage IP. Par exemple, l'adresse IP
127.0.0.4
correspond une plage IP o l'IP
infrieure est
127.0.0.1
et l'IP suprieure
127.0.0.5
. L'adresse IP
255.255.255.0
correspond
une plage IP o l'IP infrieure et l'IP suprieure est
255.255.255.0
.
Expire
56 / 214
Si vous souhaitez que la plage IPsoit efface automatiquement, slectionnez Expire et indiquez la
date et l'heure souhaites pour la suppression.
La date d'expiration n'est pas exacte la seconde - la tche interne qui efface les plages expires
s'excute une fois toutes les minutes.
Cette fonctionnalit est utilise par la fonction auto-ban de hMailServer. Si une adresse IP est
auto bannie, une plage IPqui correspond cette adresse IP sera cre.La date d'expiration sera
automatiquement rgle un moment futur, comme dfini dans les paramtres auto-ban.
Autoriser les connexions
Ce paramtre vous permet de dfinir le protocole que hMailServer autorisera, partir des
connexions TCP/IP provenant de cette plage d'adresses IP.
Autoriser les distributions
Ce paramtre vous permet de dfinir si hMailServer doit autoriser les distributions SMTP pour cette
plage.
Une personne qui envoie un message est considre locale si la partie domaine de son adresse e-
mail correspond
un domaine local ou
un itinraire dans lequel vous avez slectionn "Quand un destinataire correspond l'itinraire,
traiter le domaine du destinataire comme un domaine local"
Une personne est considre comme externe dans tous les autres cas.
Tous les utilisateurs possdant des comptes sur votre serveur seront habituellement considrs
comme locaux. Tous les autres seront considrs comme externes.
Si vous slectionnez "Externe vers externe", les gens pourront envoyer des e-mail via le serveur,
mme si l'adresse de l'expditeur ne correspond pas un compte du serveur. Si vous slectionnez
cette option, vous devez tre sr de slectionner les paramtres adquats dans "Requiert une
authentification SMTP". Sinon votre serveur sera ouvert aux spammeurs.
Requiert une authentification SMTP
En utilisant ces paramtres, vous pouvez slectionner ce qui est requis pour utiliser
l'authentification SMTP lors de l'envoi via le serveur. L'authentification SMTP devrait normalement
tre utilise par toutes les personnes envoyany des messages depuis des comptes sur votre
serveur.
De mme, Externe vers externe devrait normalement toujours tre slectionn. Si vous ne
demandez pas d'authentification lorsque des utilisateurs externes envoient des messages via
votre serveur, celui-ci sera maltrait par les spammeurs.
Anti-spam
Si cette option est active, hMailServer excutera la protection anti-spam (comme le SPF, la liste
noire DNS et la vrification MX) pour la distribution SMTP originaire de cette plage IP. Vous pourriez
dsactiver cette option pour votre rseau local.
Anti-virus
Si cette option est active, hMailServer excutera la protection antivirus pour les distributions
originaires de cette plage IP. Vous pourriez dsactiver cette option pour votre rseau local..
Recommandations
57 / 214
Excuter les tests de ralais ouverts
Aprs avoir chang ou ajout une plage IP, vous devriez excuter au moins un test de relais
ouverts pour vrifier qu'aucun ne peut utiliser votre serveur pour envoyer des spams.
Activit
Gnralits
Live (Activit) dans hMailAdmin vous permet de voir l'tat actuel du serveur hMailServer. Par son
intermdiaire, vous pouvez voir si le serveur a dmarr, le nombre de messages traits, le nombre
de spams et le nombre de virus dtects.
Si vous avez activ l'ouverture d'une session hMailServer, vous pouvez voir les informations
d'ouverture de session directement dans l'onglet Ouverture de session. Si vous activez le Journal
de l'Application, vous pouvez voir directement les dtails des messages distribuer dans cette
interface utilisateur, sans avoir examiner les fichiers journaux.
Vous pouvez aussi consulter une liste des messages non distribus. Ce sont les messages qui ont
t reus par hMailServer mais qui n'ont pas t distribus au destinataire. Ces messages sont
dans la file d'attente de distribution.
Cration des journaux
Gnral
Activer la cration des journaux
Cette option permet la cration de journaux. Si cette option est dsactive, rien ne sera
enregistr dans un journal, sauf les erreurs.
Application
Le journal des applications contient des vnements majeurs des serveurs, comme les
informations de dmarrage, d'arrt et de distribution des messages du serveur.
Echange SMTP
Le journal des changes SMTP contient les communication SMTP que cre hMailServer, lorsque
hMailServer agit comme client SMTP (distribution) et comme serveur SMTP (rception).
Echange POP3
Le journal des changes POP3 contient les communication POP3 que cre hMailServer, lorsque
hMailServer agit comme client POP3 (tlchargement des messages d'un serveur externe) et
comme serveur POP3 (tlchargement des messages par le client de messagerie partir de
hMailServer).
Echange IMAP
Le journal des changes IMAP contient les communications IMAP que cre hMailServer.
TCP/IP
58 / 214
Le journal TCP/IP contient les vnements TCP/IP, comme les requtes DNS, l'ouverture et la
fermeture des connexions, etc.
Messages de dbogage
Le journal des messages de dbogage contient les messages de bas niveau. L'enregistrement du
journal de dbogage devrait tre activ uniquement pour dpannage.
AWStats
Le journal AWStats (enregistr sous hmailserver_awstats.log) contient les vnements de
distributions SMTP formats pour AWstats.
Dans la configuration AWstats, les paramtres suivants sont utiliser pour la versions 4.x:
LogFormat="%time2 %email %email_r %host %host_r %method %url %code %bytesd"
LogSeparator="\t"
Pour la version 5, les paramtres suivants sont utiliser:
LogFormat="%time2 %email %email_r %host %host_r %method %url %code %bytesd"
LogSeparator="\t"
Garder les fichiers ouverts
Cette option vous permet de spcifier si hMailServer doit garder les fichiers journaux ouverts entre
les critures intermdiaires. Le comportement d'criture du journal par dfaut dans hMailServer
est que toutes les fois o hMailServer ajoute un lment un fichier journal, celui-ci est ouvert,
crit, puis ferm. Ce qui signifie que les donnes crites par hMailServer dans le fichier sont
vacues immdiatement. S'il existe de nombreuses petites critures dans les fichiers journaux, la
performance peut en ptir.
Si vous configurez hMailServer pour garder les fichiers journaux ouverts, Windows mettra dans un
tampon les donnes envoyer dans le fichier journal. Ce qui peut radicalement amliorer la
performance du fichier journal.L'inconvnient est que ces fichiers journaux ne peuvent pas tre
effacs lorsqu'ils sont ouverts. Lorsque hMailServer a fini d'crire dans un fichier journal (dans le
cas de fichiers journaux normaux, ceci se produit minuit lorsqu'un nouveau nom de fichier est
gnr), il ferme le fichier et celui-ci peut tre supprim.
Miroir
Gnralits
Configuration
Adresse e-mail miroir
L'adresse de messagerie vers laquelle tous les messages seront transfrs.
Les messages avec l'adresse miroir dans la liste des destinataires ne sont pas envoys vers
cette adresse pour viter la raction en boucle.
Si une adresse locale a t spcifie, mais que le domaine ou le compte est inactif, ou que ce
dernier n'existe pas, une erreur est insre dans le journal.
Requte MX
59 / 214
Configuration
Adresse e-mail
Indiquez l'adresse de messagerie pour laquelle vous souhaitez effectuer une recherche MX.
Rsoudre
Slectionnez Rsoudre pour effectuer la rsolution DNS/MX. Sauf si les information sont localement
en cache sous Windows, hMailServer contactera le serveur DNS pour les informations
Serveurs Mail
Aprs avoir cliqu sur Rsoudre, une liste des serveurs de messagerie responsables de la
manipulation des messages d'une adresse e-mail donnes sera affiche.
Performance
Gnralits
Ces paramtres vous permettent de rgler finement la performance de hMailServer.
Cache
Utilisez ces paramtres pour configurer le cache hMailServer. hMailServer peut mettre en cache
des objets de la base de donnes. Si un objet est mis en cache, hMailServer n'a ps contacter la
base de donnes pour y accder. Activez le cache peut amliorer radicalement la performance de
hMailSever. Consultez le guide de l'utilisateur pour en savoir plus sur ces rglages.
Processus
Nombre Max de processus de commande
Lorsque qu'un client SMTP, POP3 ou IMAP envoie une commande hMailServer, elle est manipule
par ce que l'on appelle un processus de commande. Les processus de commande manipulent
habituellement des commandes simples, comme "ouvrir une session", "rcuprer le message" et
"ajouter un destinataire au message". Cette valeur spcifie le nombre de commandes simultanes
qui peuvent tre utilises par les clients. Si vous augmentez cette valeur, davantage de
commandes peuvent s'excuter en mme temps, mais chacune d'entre elles s'effectuera plus
lentement. Si vous rduisez cette valeur, moins de commandes seront excutes la fois, mais
elles seront traites plus vite.
Processus de distribution
hMailServer peut distribuer plusieurs messages la fois. Ce paramtre vous permet de dfinir le
nombre de messages que hMailServer pourra distribuer simultanment. Une valeur leve
ncessite plus de ressources CPU. Une valeur plus faible induira une distribution plus lente. Le
meilleur rglage dpend de votre matriel et de la quantit de messages distribuer par votre
serveur. Pour les petites installations, 3 distributions simultanes suffisent. Pour les installations
plus importantes, vous pouvez augmenter cette valeur jusqu' 15 ou 20. Pour les installations trs
60 / 214
importantes, cette valeur est rgler entre 50 et 100. Les valeurs relles optimales varient en
fonction des habitudes d'utilisation, des envois quotidiens de messages, et ainsi de suite.
Nombre Max de processus de tches asynchrones
Ce rglage dfinit le nombre de connexions parallles que hMailServer effectuera vers le logiciel
externe lors de l'excution de la protection nti-spam.Ce rglage dfinit, par exemple, le nombre
de connexions que hMailServer lancera au plus SpamAssassin.
Priorit du processus actif
hMailServer est une application multi-processus. Ce qui signifie qu'au sein du service hMailServer,
plusieurs tches diffrentes sont effectues exactement au mme moment. Par exemple, un
message est reu, distribu, pendant que les clients tlchargent des messages au mme
moment. Ces diffrentes tches sont traites pour ce que l'on appelle les processus actifs. Vous
pouvez changer la priorit des processus actifs pour modifier la quantit de temps qu'utilise le
systme d'exploitation pour ces processus. Si vous diminuez cette valeur, hMailServer s'excutera
plus lentement et davantage de ressources CPU seront disponibles pour d'autres tches du
systme d'exploitation. Si vous augmentez la priorit, hMailServer s'excutera plus vite, mais les
autres logiciels seront ralentis.
Indexation des messages
Lorsque l'option Indexation des Messages est active, certaines mtadonnes de message
supplmentaires sont enregistres dans la base de donnes. Ce qui peut amliorer
considrablement la vitesse de parcours des dossiers volumineux lors de l'utilisation d'un client
webmail en rapport avec le ct tri du serveur. La performance est atteinte depuis que
hMailServer peut trier les messages en rcuprant les lments analysables de la base de
donnes, plutt qu'en ayant lire tous les fichiers du dossier pour en analyser chaque contenu un
un.
L'inconvnient de ces option est que la taille de la base de donnes ira en augmentant. Il n'est
pas conseill d'activer cette fonction sauf si vous rencontrez des problmes de performance en
rapport avec les dossiers volumineux du webmail.
POP3 settings
Connexions
Ce rglage dfinit le nombre maximum de connexions simultanes autorises au serveur POP3. Si
zro est spcifi, un nombre illimit de connexions sera autoris.
Message d'accueil
Le message d'accueil est envoy aux clients POP3 directement aprs leur connexion au serveur. la
raison pour laquelle vous auriez modifier le message d'accueil est de rendre plus difficile le
dtection du logiciel serveur que vous excutez.
Protocoles
Protocoles
Utilisez cette section pour dfinir les protocoles que hMailServer doit prendre en charge.
Routage
61 / 214
Gnralits
Itinraires spcifie comment et o les messages de domaines spcifiques sont distribuer.
Normalement, hMailServer utilise les recherches DNS pour dterminer o les messages sont
distribuer. Itinraire vous permet de contourner ce comportement. Exemple:
Itinraire vous permet de distribuer les messages un domaine spcifique via un serveur
spcifique sans utiliser la recherche MX.
Itinraire vous permet votre serveur d'agir comme une sauvegarde MX pour un autre serveur
En utilisant les Itinraires, vous pouvez configurer hMailServer pour transfrer les messages de
comptes spcifiques vers d'autres serveurs SMTP, mme si le domaine du compte existe dans
votre installation hMailServer.
Configuration
Domaine
Le domaine auquel cet itinraire doit s'appliquer. Le nom de domaine est insensible la casse.
Hte SMTP cible
L'hte vers lequel seront dlivrs les messages auxquels l'itinraire s'applique. Il s'agit
habituellement d'un nom d'hte internet tel que mail.exemple.com.
Scurit
Lorsqu'une personne essaie d'envoyer un message au destinataire qui correspond un itinraire,
hMailServer utilise une plage IPet les paramtres de scurit de l'itinraire pour dfinir si la
distribution doit s'effectuer. En utilisant deux paramtres de scurit, "Quand l'expditeur
correspond l'itinraire" et "Quand le destinataire correspond l'itinraire", vous spcifiez si
l'expditeur et le destinataire doivent tre considrs comme locaux ou externes. Combines aux
rglages des plages IP, ces options spcifient quel moment les distributions seront autorises,
et si l'authentification SMTP sera requise ou pas.
Si vous configurez hMailServer pour traiter les destinataires correspondants un itinraire
d'adresses locales, et que les plages IP ne permettent pas la distribution des adresses locales,
la distribution ne sera pas accepte par hMailServer. De mme, si vous configurez le destinataire
pour tre considr comme externe, et que les plages IPindiquent que l'authentification SMTP est
requise pour la distribution des adresses externes, hMailServer ncessitera une authentification
SMTP avant d'accepter la distribution.
Exemples:
Si vous voulez que les utilisateurs externes (les utilisateurs d'autres serveurs de
messagerie)puisent envoyer des messages via l'itinraire, slectionnez "Quand le destinataire
correspond l'itinraire, le considrer comme local". Les plages IP par dfaut dans hMailServer
permettent de distribuer depuis des adresses externes vers des adresses locales sans
authentification SMTP.
Si vous souhaitez que seuls les utilisateurs locaux puissent distribuer des messages via
l'itinraire, indiquez que le destinataire doit tre considr comme un domaine externe.Par
dfaut, les plages IPdans hMailServer ne permettent pas la distribution depuis des utilisateurs
externes vers des utilisateurs externes sans authentification SMTP.
Adresses
Ce rglage vous permet d'indiquer les adresses de messagerie auxquelles hMailServer autorise la
distribution. Par exemple, si vous savez que seule l'adresse valide de l'hte SMTP cible est
webmaster@domain.com, vous pouvez ajouter cette adresse la liste. dans ce cas, hMailServer
ne distribuera qu' cette adresse spcifique. Ce qui conomise l'utilisation de la bande passante.
62 / 214
Vous pouvez configurer hMailServer pour qu'il distribue toutes les adresses. Dans ce cas,
hMailServer transfrera tout message adress au domaine de l'hte spcifi dans l'itinraire.
Distribution
Utilisez le Nombre de tentatives pour spcifier le nombre de fois que hMailServer devra ressayer
d'envoyer vers ce domaine. Si l'itinraire est utilis pour la sauvegarde MX, vous aurez
probablement intrt rgler ce paramtre sur une valeur plutt leve. Les minutes entre
chaque tentative vous permettent de spcifier le dlai entre deux tentatives de hMailServer. Si,
par exemple, l'hte SMTP cible est en panne, il n'est pas ncessaire de ressayer chaque minute.
Par contre, si l'hte SMTP cible rapparat, vous ne voudrez certainement pas attendre 10 heures
pour que le serveur essaie nouveau. Utilisez Le serveur requiert une authentification pour
spcifier le nom d'utilisateur et le mot de passe si l'hte SMTP cible ncessite une authentification.
Exemples
Exemple 1 - Crer un nouvel itinraire
L'exemple suivant explique comment configurer tous les messages du domaine
hmailserver.com
pour qu'ils passent par
mx.hmailserver.com
au lieu du serveur par dfaut,
mail.hmailserver.com
:
2.Accdez Configuration -> Protocoles -> SMTP -> Routes
3.Cliquez sur Ajouter
4.Dans le champ Domaine, entrez
hmailserver.com
5.Dans le champ Hte SMTP cible, entrez
mx.hmailserver.com
.
Ainsi, tous les messages envoys
hMailServer.com
passeront par
mx.hmailserver.com
, au lieu
de passer par le serveur par dfaut,
mail.hmailserver.com
.
Exemple 2 - Router tous le courrier envoy au domaine example.com vers un autre serveur
Cet exemple explique comment router tout le courrier envoy au domaine
example.com
vers un
autre serveur. Dans cet exemple, le domaine
example.com
est un domaine "local" que nous
hbergeons nous-mme. Ce qui peut tre utile, par exemple, si nous avons actualis les
enregistrements MX pour un domaine, mais que nous souhaitons encore recevoir le courrier du
domaine sur l'ancienne adresse IP au cas o certains expditeurs SMTP n'auraient pas actualis
leur cache DNS.
4.Dans le champ Domaine, entrez
example.com
5.Dans le champ Hte SMTP cible, entrez le nom d'hte vers lequel le courrier de ce domaine sera
transfr.
Si hMailServer reoit un message adress au domaine
example.com
, et qu'il ne peut pas trouver le
destinataire dans l'installation locale, Il distribuera dsormais le courrier au nom d'hte que vous
avez spcifi dans l'itinraire. Si hMailServer ne trouve pas le destinataire dans l'installation locale,
le courrier sera alors plac dans le comte local - hMailServer ne transfre le courrier en utilisant les
itinraires que si les destinataires sont introuvables localement.
Exemple 3 -Configurer un serveur enDMZ pour transfrer un serveur de messagerie interne
Cet exemple explique comment mettre en place une installation de hMailServer dans une DMZ qui
transmet tout le courrier entrant vers un serveur d'arrire-plan. Une des raisons courantes pour
configurer une telle installation est de prfrer que la protection anti spam et anti-virale s'excute
en dehors de votre rseau interne. Autres raison courante: les socits qui excutent
MicrosoftExchange en interne ne souhaitent pas exposer ce serveur Internet.
63 / 214
4.Dans le champ Domaine, entrez votre nom de domaine, par exemple
example.com
5.Dans le champ Hte SMTP cible, entrez le nom d'hte du serveur de messagerie interne.
Vous ne devez pas ajouter le domaine au serveur dans le DMZ- seulement dans le routage.
Si hMailServer reoit un message adress votre nom de domaine, il le transfrera au serveur
backend.Si hMailServer reoit un message d'un domaine inconnu, il sera rejet.
Le problme, avec cette configuration, est que hMailServer n'a pas connaissance des destinataires
existant sur le domaine interne. De ce fait, hMailServer acceptera le courrier de tout destinataire
qui correspond votre nom de domaine et essaiera de transfrer le message votre serveur
interne. Si le destinataire n'existe pas sur les serveur interne, un message d'avertissement sera
cr pour informer l'expditeur que l'adresse du destinataire n'est pas valide. Un faon de
contourner ce problme consiste ajouter tous les destinataires valides la Configuration du
Routage, de sorte que hMailServer sache quels destinataires sont valides. Dans ce cas,
hMailServer n'acceptera pas le courrier de l'expditeur et aucun message d'avertissement ne sera
envoy.
Rgles
Gnralits
Les rgles vous permettent de dfinir les actions prendre en fonction du contenu des messages.
Vous pouvez, par exemple, dfinir une rgle pour supprimer des messages en fonction d'un sujet
spcifique, ou transfrer un message de taille suprieure une taille spcifie.
Les rgles peuvent tre dfinies deux niveaux diffrents: Gnral et Compte. Les rgles
Gnrales s'appliquent tous es messages distribus au serveur, sans tenir compte des
destinataires qui les reoivent. Les rgles Compte ne s'appliquent qu'aux messages d'un compte
spcifique.
Chaque rgle possde un jeu de critres et d'actions. Lorsque vous crez une rgle, vous ajoutez
un critre qui spcifie quel message la rgle sera applique. Vous pouvez ajouter, par exemple,
un critre qui limite la rgle aux messages qui contiennent un en-tte d'ID de message spcifique.
Aprs avoir ajout un critre, vous ajoutez des actions. Les Actions dfinissent ce que hMailServer
fera si un message correspond au critre. L'action peut, par exemple, consister transmettre le
message, le supprimer ou le dplacer dans un dossier spcifique.
Les rgles sont appliques lors de la phase de distribution des messages. Ce qui signifie que, si
vous effectuez des modifications du contenu de la rgle du message, ou si vous dplacez le
message dans un dossier IMAP spcifique, cela n'affectera que la faon dont le destinataire verra
le message. Si vous avez dfini, par exemple, une rgle globale pour dplacer les messages dans
un dossier IMAP Spam, et que l'Utilisateur 1 envoie un message l'Utilisateur 2, seul l'Utilisateur 2
verra le message dans la bote aux lettres Spam. L'Utilisateur 1 ne verra pas le message dans la
bote aux lettres Spam, car il n'est pas le destinataire du message. La raison en est que si
l'Utilisateur 1 envoie l'Utilisateur 2, le message n'est pas distribu l'Utilisateur 1, mais
l'Utilisateur 2.
Test de correspondance
Dans la bote de dialogue Critres de Rgle, vous pouvez tester si les valeurs spcifies
correspondent aux critres.Pour effectuer un test, entrez simplement la valeur tester dans la
champ Valeur du Test. Si la valeur correspond au critre, le texte"Correspond" (Match) apparatra
prs du champ de saisie. Sinon, "Ne correspond pas" (No match) s'affichera. Ce qui facilite la
cration de critre plus avancs, pour utiliser, par exemple, des expressions rgulires.
64 / 214
Exemples
Voici quelques exemples sur la faon d'appliquer les rgles.
Diffrents types de recherche
hMailServer prend en charge diffrents types de recherches. Ces types de recherche sont: Est,
Contient, Infrieur , Suprieur et Expression Rgulire.
Is: (est) utilis pour spcifier une correspondance exacte.
Contains: (contient) utilis pour spcifier une correspondance partielle. Vous pouvez, par
exemple, appliquer la rgle un message dont le Corps Contient un certain mot.
Less than: (infrieur ) utilis pour des correspondances numriques. Vous pouvez, par exemple,
appliquer la rgle aux messages dont la taille est infrieure 1 Mo.
Larger than: (suprieur ) utilis pour des correspondances numriques. L'inverse de Infrueur
Regular expression: (expression rgulire) en utilisant la correspondance d'une expression
rgulire, vous pouvez spcifier des correspondances plus complexes. Vous pouvez, par exemple,
appliquer la rgle tous les messages dont le sujet commence par une lettre et le reste par des
chiffres. Pour en savoir plus sur les expressions rgulires, consultez la page http://www.regular-
expressions.info/. L'expression rgulire utilise doit correspondre la valeur totale avec laquelle
elle est compare. Il n'est pas possible d'utiliser une correspondance partielle. hMailServer
s'appuie sur Boost/Regex pour faire l'analyse d'une expression rgulire, et utilise la syntaxe Perl.
Pour en savoir plus sur les options disponibles, consultez le site Boost.
Actions
Supprimer le message - Choisissez cette rgle pour supprimer le message. Le message sera
supprim la fin du traitement de la rgle.
Transfrer le message - Choisissez cette rgle si vous souhaitez transfrer le courrier un autre
destinataire.Il est possible de spcifier des destinataires locaux et externes.
Rpondre - Cette option peut s'utiliser si vous souhaitez rpondre automatiquement aux
courriers.
Excuter la fonction - Utilisez cette option si vous souhaitez excuter un script hMailServer ds
qu'un message correspond la rgle.
Dfinit la valeur de l'en-tte - Avec cette option, vous pouvez ajouter des en-ttes MIME au
message.
Dplacer dans un dossier IMAP - Il est possible, lors du dplacement du courrier dans un dossier,
d'utiliser une rgle, pour le dplacement dans des dossiers et des sou-dossiers. Utilisez cette
syntaxe: Folder.Subfolder1.Subfolder2. Si vous avez chang le Sparateur Hirarchique par dfaut
dans hMailServer, vous devez utiliser le nouveau sparateur plutt que le . (point).
Arrter le traitement de la rgle - Choisissez cette option si vous souhaitez annuler le traitement
de la rgle restante.Ainsi, toute action ou rgle spcifie ne sera plus excute.
Dtails
Si vous souhaitez connatre les dtails sur le mode de fonctionnement du traitement d'une rgle,
voyez le document dtaill.
Dpannage
Si vous rencontrez des problmes, voyez la rubrique Conseils de dpannage.
Configuration
Nom
Le nom de la rgle. Tout texte de votre chhoix.
65 / 214
Critre
Le critre de cette rgle. Les messages correspondant ce critre sera affect par les actions de
le rgle.
Utiliser AND - Tous les critres doivent correspondre pour que le message soit affect par la rgle.
Utiliser OR - Si un critre correspond, le message sera affcet par la rgle.
Champ prdfini
De - L'en-tte MIME De: du message.
- L'en-tte MIME : du message. A ne pas confondre avec le paramtre Liste des destinataires.
Voir les remarques (3) ci-dessous pour en savoir plus.
CC - L'en-tte MIME CC: du message.
Liste des destinataires - Liste de tous les destinataires du message actuel. Cette liste rcupre
partir de l'enveloppe SMTP, pas partir des en-ttes MIME. Voir les remarques (3) ci-dessous
pour en savoir plus.
Sujet - L'en-tte MIME Sujet: du message.
Corps - Le corps du message. Ceci comprend le corps en texte clair et en HTML.
Taille du message - La taille du message
Champ d'en-tte personnalis
Si l'en-tte que vous voulez filtrer n'existe pas dans la liste des champs prdfinis, vous pouvez le
nom de l'en-tte MIME dans ce champ.
Types de recherche
Equals - (gal) la valeur / chane doit correspondre exactement
Not equals - (non gal) la valeur / chane ne doit pas correspondre.
Contains - (contient) correspond partiellement
Not contains - (ne contient pas) le valeur ne doit pas exister dans le champ Prdfini field / en-
tte personnalis.
Less than - (infrieur ) ne peut tre utilis que pour les valeurs
Greater than - (suprieur ) ne peut tre utilis qe pour les valeurs.
Regular expression - (expression rgulire) utilisez une expression rgulire pour correspondre
la valeur.
Wildcard - (joker) utilisez une chane de recherche avec des jokers pour rechercher une valeur.
Valeur
Entrez la valeur rechercher, ou l'expression rgulire utiliser.
Test
Dans la section Test de la bote de dialogue Critre, vous pouvez tester si les diffrentes valeurs
correspondent votre critre. Si la valeur entre correspond au critre, le texte Correspond
(Match) apparat prs de la valeur entre, sinon Ne correspond pas (No match) apparat.
Actions
Action que hMailServer doit prendre lorsqu'un message correspond au critre d'une rgle.
Supprimer le message - Le message sera supprim et non distribu au destinataire
Transfrer le message - Transfre le message l'adresse spcifie. Le message sera toujours
distribu au destinataire d'origine
Dplacer dans un dossier IMAP - Dplace le message dans le dossier IMAP spcifique. Ne
s'applique que si la distribution est locale. Si le dossier n'existe pas, il sera cr.
Rpondre - Rpond l'expditeur avec le message spcifi
66 / 214
Excuter la fonction - Excute la fonction d'un fichier script de hMailServer.
Cette fonction doit prendre un objet hMailServer.Message comme paramtre, par exemple Sub
OnSomething(oMessage).
Dfinir la valeur de l'en-tte -Cette action vous permet de crer ou de modifier une valeur d'en-
tte existant.
Arrter le traitement de la rgle - Cette action annule les rgles restantes.
Envoyer via l'itinraire - Normalement, hMailServer utilise les adresses des destinataires pour
dterminer si oui ou non un itinraire doit tre utilis. Avec cette action de rgle, vous pouvez
contourner ce comportement par dfaut. Comme exemple, vous pouvez dfinir une rgle qui
demande hMailServer d'envoyer tout le courrier adress un domaine spcifique vers un autre
serveur.
Remarques
1.Il est possible de spcifier les macros %YEAR%, %MONTH% et %DAY% comme paramtres du
nom de dossier si l'action Dplacer dans un dossier IMAP a t choisie.
2.Lors de la recherche des valeurs de champs d'en-tte, une chane vide sera traite de la mme
faon qu'un en-tte inexistant. Ainsi, si vous crez une rgle qui supprimera les messages si le
Sujet est vide, elle supprimera aussi les lignes dont l'en-tte Sujet n'existe pas.
3.Un message possde, normalement, deux listes de destinataires. Savoir ceci est trs important
lors de la dfinition des rgles pour filtrer les listes d'en-tte A et de Destinataires.
La premire liste est la liste destinataires MIME. Cette liste de destinataires est celle que vous
voyez dans votre client de messagerie, dans les en-ttes A et CC. La seconde liste est celle de
l'enveloppe MIME - l'enveloppe MIME contient les adresses vers lesquelles le courrier sera
distribu. Normalement, il n'est pas possible de voir cette liste dans le client de messagerie. Ce qui
signifie qu'un message peut tre envoy une adresse, mais qu'il contient aussi d'autres
destinataires dans les en-ttes A et CC. Exemple courant: vous envoyez un message et vous
placez quelqu'un dans le champ BCC. L'adresse entre dans le champ BCC sera ajoute la liste
des adresses de l'enveloppe SMTP, mais ne sera pas ajoute aux en-ttes MIME.
Lorsque hMailServer transfre un courrier, la liste Destinataires (de l'enveloppe SMTP) est
actualise. Mais pas la liste Destinataire des en-ttes MIME. Ce qui signifie que le destinataire qui
reoit le message transfr verra les destinataires d'origine dans son client de messagerie.
De mme, si un message est plac dans un compte, la liste Destinataire est efface pour
conomiser l'espace disque. Ainsi, lorsque les rgles de niveau du compte est excute, la liste
Destinataires sera purge et ne pourra pas tre vrifie.
Exemples de rgle
Exemple 1, Supprimer les messages
Supprimer automatiquement tous les messages dont le sujet contient le mot SPAM
1.Lancez hMailAdmin, et choisissez l'onglet Rgles dans l'arborescence de gauche, sous Domaines
2.Cliquez sur Ajouter. Entrez le nom
MaRgle
3.Dans Critre, cliquez sur Ajouter.
4.Dans le Champ Prdfini, slectionnez Sujet
5.Dans Type de recherche, choisissez Contient.
6.Dans le champ de saisie Valeur, entrez le mot
SPAM
7.Cliquez sur Enregistrer pour ajouter le critre la rgle.
8.Dans Actions, cliquez sur Ajouter.
9.Choisissez Suprimer le message dans la liste droulante
10.Cliquez sur Enregistrer pour enregistrer l'Action
11.Cliquez nouveau sur EEnregistrer pour enregistrer la rgle
Exemple 2, Transfrer les messages
transfrer tous les messages distribus une adresse de messagerie externe. Le message
d'origine sera toujours distribu normalement. Ne crez pas une rgle qui envoie le message
vous-mme, car cela provoquerait une boucle sans fin.
1.Lancez hMailAdmin et accdez la configuration du compte.
67 / 214
2.Slectionnez l'onglet Rgles.
3.Cliquez sur Ajouter. Entrez le nom RegleTransfert
5.Dans le Champ prdfini, choisissez Taille du message
6.Dans Type de recherche, choisissez Suprieur .
7.Dans le champ de saisie Valeur, entrez la valeur
0
. Tous les messages dont la taille dpasse 0
octets seront affects par la rgle.
10.Choisissez Transfrer les messages dans la liste droulante. Entrez l'adresse externe vers
laquelle transfrer les messages.
11.Cliquez sur Enregistrer pour enregistrer cette Action
12.Cliquez nouveau sur Enregistrer pour enregistrer la rgle complte
Exemple 3, dlacer les messages dans un dossier IMAP
Dplacer tous les messages d'un expditeur spcifique vers un dossier IMAP spcifique
1.Lancez hMailAdmin et accdez la configuration du compte.
2.Slectionnez l'onglet Rgles.
RgleDplacer
5.Dans Champ prdfini, choisissez De
6.Dans Type de recherche, choisissez Contient.
7.Dans le champ de saisie Valeur, entrez le valeur
someone@somedomain.com
. Tous les messages
contenant someone@somedomain.com du champ de l'en-tte De seront affects par la rgle.
10.Choisissez Dplacer vers le dossier IMAP dans la liste droulante. Entrez le nom du dossier IMAP
dans lequel s'effectuera le dplacement.
Exemple 4, actualiser le Sujet d'un message
Le didacticiel suivant vous apprend savoir appeler un script VBA en fonction du contenu du
message. Il vous montre comment actualiser le Sujet d'un message en fonction de la taille du
celui-ci.
Configurer la rgle
2.Choisissez Rgles
RgleTaille
5.Dans Champ prdfini, choisissez MessageSize
6.Dans Type de recherche, choisissez Suprieur .
7.Dans le champ de saisie Valeur, entrez la valeur 4000. Tous les messages suprieurs 4000
octets seront affects par cette rgle.
10.Choisissez Excuter la fonction dans la liste droulante. Entrez le nom OnSizeRule
Crer le script
1.Ouvrez le fichier Events\EventHandlers.vbs.
2.Ajoutez les lignes suivantes et enregistrez les modifications:
Sub OnSizeRule(oMessage)
oMessage.Subject = "[4000] " & oMessage.Subject
68 / 214
oMessage.Save
End Sub
Activer le script dans hMailServer
2.Accdez Configuration, Avanc, Scripts
3.Cliquez sur Vrifier la syntaxe pour confirmer que celle-ci est correcte
4.Slectionnez Activer
5.Cliquez sur Enregistrer pour activer le script.
Scripts
Gnralits
hMailServer vous permet d'crire vos propres scripts pour tendre la fonctionnalit du serveur. La
prise en charge pour Microsoft VBScript et Microsoft JScript existe actuellement sur le serveur. Vous
trouverez, sur hMailServer.com,, des modles de script utiles, crits en VBScript. Pour la syntaxe
de script gnrale, consultez la bibliothque Microsoft MSDN.
Tous les scripts hMailServer sont pplacer dans un fichier nnomm EventHandlers.vbs. Vous
trouverez ce fichier dans le dossier Events de hMailServer, normalement C:\Program Files
\hMailServer\Events.
hMailServer propose les vnements prdfinis suivants:
vnement But Implment dans

OnBackupCompleted Excut si une sauvegarde a
russi.
4.2
OnBackupFailed Excut si une sauvegarde a
chou.
4.2
OnClientConnect Excut si un client est
connect.
4.0
OnAcceptMessage Excut si un message a t
distribu au serveur utilisant
le protocole SMTP.
4.0
OnDeliveryStart Excut directement si la
distribution d'un message a
dbut avant l'excution de
toute rgle.
4.4
OnDeliverMessage Excut si un message est en
cours de distribution. Excut
aprs l'excution des rgles
gnrales, mas avant les
rgles de niveau du compte.
4.0
OnDeliveryFailed Excut si la distribution d'un
message a chou
5.0
OnExternalAccountDownload Excut si un message a t 5.3
69 / 214
tlcharg partir d'un
compte POP3 distant.
OnError Excut si une erreur s'est
produite dans hMailServer.
5.0
Configuration
Suivez ces tapes pour activer le script:
Lancez hMailServer Administrator
Accdez Configuration->Avanc->Scripts
Slectionnez Activ
Cliquez sur Enregistrer pour enregistrer les modifications
Ds que vous modifiez le fichier de script, vous devez cliquer sur Recharger le script pour que
hMailServer rafrachisse, enregistre les changements. hMailServer conserve un exemplaire de la
totalit du script en mmoire, ce qui amliore la performance.
OnAcceptMessage
Signature
OnAcceptMessage(oClient as hMailServer.Client, oMessage as hMailServer.Message)
Valeurs rsultantes
0 - hMailServer accepte le message
1 - hMailServer rejette le message avec l'erreur 542 Rejected
2 - hMailServer rejette le message avec une erreur de script dfinie.
Exemples
Authentification requise pour les expditeurs locaux
La fonctionnalit d'authentification SMTP intgre vrifie seulement l'adresse de l'expditeur pour
dterminer si l'authentification SMTP est requise. Souvent, il vous faut aussi vrifier l'adresse de
l'expditeur. Le script suivant ncessite une authentification de la part de hMailServer, si l'adresse
des expditeurs contient @example.com.
VB-script:
Sub OnAcceptMessage(oClient, oMessage)
if (InStr(1, oMessage.FromAddress, "@example.com", 1) > 0) Then

' Local user.
If (oClient.Username = "") Then
Result.Message = "Vous devez tre authentifi pour envoyez
depuis le domaine local."
Result.Value = 2
End If
End If

End Sub
70 / 214
Refus des messages suprieurs une taille donne.
VB-script:
Sub OnAcceptMessage(oClient, oMessage)
If oMessage.Size > 10 Then
' Reject the message since it's larger
' than 10 kb.
Result.Message = "Ce message est trop volumineux"
Result.Value = 2
Else
' Accept the message
Result.Value = 0
End If
End Sub
Remarque
OnAcceptMessage est excut avant que hMailServer accepte le message et qu'il l'enregistre
dans la base de donnes. Ce qui signifie que vous ne pouvez pas accder l'ID du message de
cet vnement.
OnBackupCompleted
Signature
Sub OnBackupCompleted()
Valeurs rsultantes
Aucune
OnBackupFailed
Signature
Sub OnBackupFailed()
Valeurs rsultantes
Aucune
OnClientConnect
Signature
OnClientConnect(oClient as hMailServer.Client)
Description
71 / 214
Cet vnement est dclench directement aprs qu'une connexion TCP/IP ait t ouverte vers
hMailServer. L'vnement est dclench avant l'ouverture de session de l'utilisateur, ce qui signifie
que la proprit oClient.Username retournera une chane vide.
Valeurs rsultantes
0 - hMailServer accepte la connexion
1 - hMailServer refuse la connexion
Exemples
VB-script:
[]
OnDeliverMessage
Signature
OnDeliverMessage(oMessage as hMailServer.Message)
Valeurs rsultantes
0 - Distribuer le message
1 - Ne pas distribuer le message
Exemples
VB-script:
[]
OnDeliveryFailed
Gnralits
Cet vnement est excut si la distribution au destinataire choue. Si un courrier pour plusieurs
destinataires ne peut pas tre envoy, l'vnement est excut une fois pour chaque
destinataire.
Signature
OnDeliveryFailed(oMessage, sRecipient, sErrorMessage)
Paramtres
oMessage - Le message qui n'a pas t distribu.
sRecipient - Le destinataire auquel le message n'a pas t distribu
sErrorMessage - L'erreur qui a dclench l'chec de la distribution
Valeurs rsultantes
Aucune
72 / 214
OnDeliveryStart
Gnralits
Cet vnement est excut directement lorsque la distribution d'un message a dbut.
L'vnement est excut avant l'excution de toute rgle gnrale
Signature
OnDeliveryStart(oMessage as hMailServer.Message)
Valeurs rsultantes
0 - Distribuer le message
1 - Ne pas distribuer le message
Exemples
VB-script:
[]
OnError
Gnralits
Cet vnement est excut si une erreur se produit dans hMailServer.
Signature
OnError(iSeverity, iCode, sSource, sDescription)
Parameters
iSeverity - Svrit de l'erreur. 1 - Critique, 2 - leve, 3 - Moyenne, 4 - Faible
iCode - Le code d'erreur hMailServer.
sSource - Le composant qui a rapport l'erreur.
sDescription - Une description de l'erreur rapporte.
Valeurs rsultantes
Aucune
OnExternalAccountDownload
Gnralits
Cet vnement est excut si un message a t tlcharg partir d'un compte externe
hMailServer.
73 / 214
Signature
Sub OnExternalAccountDownload(oFetchAccount, oMessage, sRemoteUID)
Paramtres
oFetchAccount - Le compte externe partir duquel le message a t tlcharg.
oMessage - Le message qui a t llcharg. Si le message a dj t tlcharg, ce paramtre
sera Nothing /Null.
sRemoteUID - L'UID du message sur e serveur distant.
Valeurs rsultantes
A l'aide de l'objet Result, il est possible de dfinir si hMailServer doit supprimer le message du
serveur distant ou non. Dfinissez les valeurs ci-dessous sur la variable Result.Value.
1 -Supprimer immdiatement le message du serveur distant.
2 - Supprimer le message aprs le nombre de jours spcifi. Rglez le nombre de jours sur la
variable Result.Parameter.
3 -Ne jamais supprimer le messages sur le serveur distant.
Notez que les messages tlchargs seront encore distribus. Les paramtres ci-dessus
n'affectent que la suppression ou non des messages sur le serveur distant.
Message du serveur
Gnral
Utilisez ces rglages pour changer les messages d'erreur et d'informations crs par hMailSever.
Nom
Le nom du message du serveur modifier.
Texte
Le texte du message du serveur.
Envoi du serveur
Envoyer
Slectionnez les destinataires auxquels envoyer le message. Vous ne pouvez envoyer qu'aux
comptes du serveur.
E-mail
Spcifiez le contenu du message. Seul un texte et non un HTML est autoris dans le champ Corps.
74 / 214
Configuration
A la section Configuration de hMailServer Administrator, vous pouvez rgler diffrentes parties du
comportement de hMailServer. Bien que les paramtres par dfaut fonctionnent sur de
nombreuses installations, vous pouvez les modifier pour activer l'anti-spam, la journalisation ou
rgler finement les paramtres de performance.
Configuration SMTP
Gnral
Connexion
Le nombre maximum de connexions SMTP simultanes au serveur. Si cette valeur est rgle sur
zro, un nombre illimit de connexions sera autoris. Par dfaut, cette valeur est rgle sur zro.
Message d'accueil
Le message d'accueil est envoy directement aux clients SMTP clients aprs qu'ils se soient
connects au serveur. Ce message n'est gnralement jamais vu par l'expditeur ou le
destinataire. Une des raisons pour modifier le message d'accueil est de rendre la difficile, pour les
autres utilisateur, la dtection du logiciel serveur utilis.
Taille maximum d'un message
Si une Taille Maximum de Message est spcifie, hMailServer refusera tout message suprieur
cette taille. Si vous souhaitez autoriser les messages d'une taille illimite, rglez cette valeur sur
zro. La taille est spcifie en Ko.
Il est fortement conseill d'utiliser une taille maximum limite de message. Dans le cas contraire,
vous exposez votre serveur toutes sortes d'attaques. Des utilisateurs, par exemple, pourraient
envoyer un message si volumineux qu'il remplirait le disque dur du serveur, ce qui dclencherait un
comportement imprvisible. La taille maximum par dfaut d'un message est de 20Mo.
Distribution d'un message
Nombre de tentatives
Ce rglage dfinit le nombre de fois que hMailServer devra essayer d'envoyer un message. La
distribution peut chouer pour de nombreuses raisons. Le serveur de messagerie du destinataire
du courrier, par exemple, est peut-tre en cours de rinitialisation, ou votre rseau peut tre
temporairement indisponible. La valeur par dfaut est de 4 tentatives, ce qui signifie que
hMailServer essaiera 5 fois au total avant d'abandonner et de renvoyer un message d'erreur
l'expditeur.
Minutes entre chaque tentative
Ce rglage dfinit le nombre de minutes que hMailServer devra attendre avant chaque tentative,
lors de la distribution des messages aux autres serveurs. La valeur par dfaut est 60 minutes.
Nom d'hte
Lorsqu'un serveur SMTP se connecte un autre serveur pour envoyer un message, la premire
chose qui se passe, c'est que le serveur d'envoi s'identifie lui-mme en utilisant le nom d'hte.
Comme il n'existe aucun moyen de dtecter automatiquement en toute scurit le nom d'hte d'un
ordinateur, vous devez spcifier ce paramtre manuellement. Le nom d'hte doit rsoudre
l'adresse IP de l'ordinateur qui excute hMailServer. Certains serveurs valideront ceci et classeront
75 / 214
votre e-mail comme un spam si l'adresse IP n'est pas rsolue correctement.
Peu importe le nom d'hte que vous saisissez, tant qu'il rsout l'adresse IP o s'excute
hMailServer.Vous pouvez avoir 15 noms d'hte diffrents qui rsolvent l'adresse IPsous laquelle
s'excute hMailServer. Si c'est le cas, vous pouvez entrer l'un de ces 15 noms d'hte dans le
champ Nom d'hte.
Exemple: Si hMailServer s'excute sur une machine dont le nom d'hte est mail.domain.com, vous
pouvez spcifier mail.domain.com comme nom d'hte. Si votre machine a plusieurs noms d'hte
publics, comme mail.domain.com et mail.domain2.com, vous pouvez spcifier l'un d'entre eux
comme nom d'hte.
Relais SMTP
Le paramtre Relais SMTP vous permet de spcifier quel serveur de messagerie les massages
seront distribus. Vous ne devez jamais rgler cette valeur sur "localhost" ou sur le nom d'hte de
votre propre serveur de messagerie. hMailServer essaierait alors de se connecter lui-mme.
Lorsqu'un serveur SMTP distribue un courrier un autre, la recherche MX DNS est normalement
utilise. Ce qui signifie que si vous m'envoyez un message, someone@hmailserver.com, votre
serveur de messagerie effectuera une recherche MX pour mon domaine, hmailserver.com. La
rponse MX indiquera votre serveur qu'il devra distribuer le courrier mail.hmailserver.com. La
communication s'tablit via le port 25. Cependant, il peut arriver que votre FAI bloque le trafic
sortant sur le port SMT (25) vers tous les ordinateurs sauf vers leur propre serveur de
messagerie. Vous ne pourriez, par consquent, vous connecter mail.hmailserver.com. Dans ce
cas, configurez hMailServer pour qu'il envoie tout le courrier via le serveur de messagerie de votre
FAI. Le serveur de messagerie de votre FAI sera alors votre relais . La valeur entrer dans la
champ Relais est le nom du serveur de messagerie de votre FAI. par exemple, si vous utilisez le
fournisseur de service haut dbit Sudois Bredbandsbolaget, entrez smtp.bredband.net comme
relais SMTP.
Si vous ne souhaitez pas relayer tous les courriers sortants via un serveur SMTP spcifique, ce
champ doit rester vierge.
Port TCP du relais SMTP
Le port TCP/IP auquel hMailServer doit se connecter lors de la distribution au relais SMTP.
Le serveur requiert une authentification
Slectionnez cette option si le serveur spcifi comme relais SMTP ncessite une authentification.
Utiliser SSL
Slectionnez cette option si vous souhaitez que hMailServer utilise le cryptage SSLlors de la
connexion au serveur relais SMTP. Notez que le serveur relais SMTPdoit tre configur pour
utiliser SSL pour que ceci fonctionner.
Conformit RFC
Autoriser l'authentification en texte clair
Cette option indique au serveur SMTP de hMailServer si oui ou non une authentification en texte
clair est autorise.
Autoriser une adresse d'expditeur vide
Certains spammeurs envoient du courrier avec une adresse d'expditeur vide. Si vous dsactivez
cette option, hMailServer traitera ces messages comme des spams. Cependant, certains
messages lgitimes ont galement des adresses d'expditeur vides, et il est donc vivement
conseill de ne pas dsactiver cette option.
76 / 214
Autoriser les fins de ligne formates
Selon la spcification SMTP, chaque ligne d'un message doit tre spare par les codes ASCII 13
et 10. Certains spammeurs envoient des messages qui ne sont pas formats correctement.
Utilisez ce rglage pour refuser ces messages. Notez que des messages lgitimes peuvent avoir
t incorrectement formats en fin de lignes, si le logiciel de distribution contient des bugs.
Dconnecter le client aprs trop de commandes non valides
Avec ce rglage, vous pouvez dconnecter les clients qui envoient trop de commandes non
valides. Certains spammeurs, par exemple, essaient d'envoyer du courrier de nombreuses
adresses diffrentes de votre serveur, en esprant que celui-ci acceptera au moins l'un d'entre
eux. Avec cette option, vous pouvez dconnecter automatiquement les clients qui se comportent
de la sorte.
Avanc
Lier l'adresse IP locale
Utilisez cette option pour spcifier l'adresse IP locale que hMailServer doit utiliser lors d'une
connexion ux autres serveurs SMTP. Ce qui peut tre utilis si votre serveur a plusieurs adresses
IP publiques, mais que vous souhaitez n'en utiliser qu'une seule pour les distributions. Si ce
rglage n'est pas spcifi, hMailServer utilisera l'option par dfaut de Windows qui fonctionne
dans la plupart des cas.
Nombre maximum de destinataires par lots
Les serveurs SMTP peuvent refuser les messages de hMailServer s'il y a trop de destinataires pour
un seul courrier. Ce qui peut se produire si le serveur SMTP de rception pense que votre courrier
est un spam du fait que vous l'envoyez un trop grand nombre d'utilisateurs. Utilisez ce
paramtre pour limiter le nombre de destinataires que hMailServer utilise pour une mme
distribution. Lorsque cette valeur a t atteinte, hMailServer se dconnecte du serveur
destinataire, se reconnecte et continue avec les destinataires restants.
Ajouter l'en-tte Distribu
Si cette option est slectionne, hMailServer ajoutera un en-tte Distribu A tous les
messages.Cet en-tte contiendra les adresses des destinataires fournies dans l'enveloppe SMTP
lors de la communication SMTP.
Rgler le nombre de boucles
Cette option vous permet d'empcher hMailServer de crer des messages dlivrs en boucle sans
fin. Exemple: Il est possible de crer une rgle de compte qui transfre les messages d'un
utilisateur A un autre B, et une autre rgle qui transfre nouveau les messages de l'utilisateur
B l'utilisateur A. Pour viter que ceci produise une boucle sans fin, hMailServer limite le nombre
de transferts automatiques la valeur dfinie par la Rgle du nombre de boucles (hMailServer 4.2 et
suprieur).
Certificat SSL
Gnralits
hMailServer 5 possde une prise en charge intgre pour SSL. Ce qui signifie qu'aprs avoir
obtenu un certificat SSL, vous pouvez crypter le trafic de messagerie entre vous et vos
utilisateurs. Le trafic de messagerie normal sur Internet consiste envoyer des messages non
77 / 214
crypts, ce qui signifie que le courrier est souvent lisible par des tiers. Si, par exemple, un
utilisateur de rseau sans fil non crypt envoie un message, d'autres personnes peuvent
intercepter le trafic sans fil et lire le message. Autres exemples: les Fournisseurs d'Accs
Internet qui analysent les communications de messagerie de leurs utilisateurs et la curiosit des
agences gouvernementales.
Obtenir un certificat SSL
Il existe deux mthodes pour obtenir un certificat SSL. Vous pouvez acheter un certificat
SSLauprs d'une autorit de certification, ou crer votre propre certificat auto-sign. Acheter un
certificat auprs d'une autorit de certification procure gnralement une scurit plus leve que
la cration d'un certificat auto-signe.
Les clients de messagerie ne sont pas configurs pour faire confiance des certificats auto-
signs. Ce qui signifie que si vous utilisez un certificat auto-sign, une bote de dialogue
d'avertissement sera affiche lors de votre connexion au serveur. Dans de nombreux de
messagerie, vous pouvez choisir d'ignorer l'avertissement et encore vous connecter. C'est la
raison pour laquelle il est prfrable d'acheter un certificat auprs d'une autorit de certification.
Il existe de trs nombreuses socits qui vendent des certificats SSL et que vous trouverez via
Google.Si vous prfrez crer votre propre certificat SSL, le plus simple est d'utiliser OpenSSL.
Acheter un certificat SSL comprend gnralement les tapes suivantes:
1.Vous gnrez une cl prive en utilisant OpenSSL.
2.Vous gnrez une requte de signature de certificat en utilisant OpenSSL.
3.Vous supprimer le mot de passe cl de la cl prive.
4.Vous commandez un certificat auprs de l'autorit de certification et vous leur fournissez une
requte de signature de certificat.
5.L'autorit de certification vous envoie le certificat.
6.Vous configurez hMailServer pour utiliser la cl prive et le certificat SSL.
Crer un certificat SSL auto-sign comprend les tapes suivantes:
1.Vous gnrez une cl prive en utilisant OpenSSL.
2.Vous gnrez une requte de signature de certificat en utilisant OpenSSL.
3.Vous supprimer le mot de passe cl de la cl prive.
4.A l'aide de OpenSSL, vous gnrez le certificat auto-sign.
5.Vous configurez hMailServer pour utiliser le cl prive et le certificat SSL.
Configurer hMailServer pour utiliser un certificatSSL
Deux tches lies sont ncessaires la configuration de hMailServer pour qu'il utilise un certificat
SSL:
Ajouter le certificat SSL hMailServer
1.Lancez hMailServerAdministrator
2.Accdez Configuration->Avanc->Certificat SSL
4.Entrez un nom de certificat SSL.Ces era un nom de votre choix, mais nous vous conseillons de le
dfinir par le nom d'hte du certificat SSL.
5.Slectionnez le fichier certificat et une cl prive dpose.
Aprs avoir suivi ces tapes, hMailServer connat le certificat SSL, mais vous devez aussi lui
indiquer quand l'utiliser.
Configurer hMailServer pour utiliser le certificat SSL
1.Lancez hMailServerAdministrator
2.Accdez Configuration->Avanc->ports TCP/IP
3.Slectionnez un port
4.Slectionnez "Utiliser SSL" et le certificat.
6.Redmarrez hMailServer
78 / 214
Ainsi, tout le trafic sur ce port sera crypt l'aide du certificat. Normalement vous aurez ajouter
un port TCP/IPsupplmentaire hMailServer et slectionnez l'utilisation SSLpour ce port. Notez
que tous les clients se connectant au port doivent tre configurs pour utiliser SSL.
Configurer les clients
Aprs avoir configur hMailServer pour utiliser les certificats SSL, vous devez aussi configurer les
clients. Ce qui implique la fois d'accder aux paramtres du compte du client de messagerie et
de slectionner l'utilisation SSL du serveur.
Si vous souhaitez que la communication SMTP entre vous et vos utilisateurs soit crypte, vous
devez configurer le port TCP/IPpour que SMTP utilise SSL.Cependant, comme les autres serveurs
de messagerie qui distribuent le courrier hMailServer ne savent pas que SSL est requis, vous
devez crer un second port TCP/IPpour SMTP et le configurer pour utiliser SSL. Aprs cela, vous
devez reconfigurer les clients pour qu'il se connectent ce nouveau port TCP/IP et qu'ils utilisent
SSL. Ainsi, les autres serveurs de messagerie continueront distribuer le courrier non crypt sur le
port 25, alors que vos utilisateurs vous distribueront les messages sur un port secondaire.
Recommandations
Il est conseill d'utiliser une cl RSA.
Observations sur la scurit
Lorsque hMailServer se connecte un autre serveur utilisant SSL (lors d'une distribution SMTP ou
d'un tlchargement partir d'un compte externe), il ne vrifie pas les certificats SSLdes
serveurs. Ce qui signifie que la communication entre le client et le serveur est crypte et ainsi
moins ouverte pour l'coute que les connexions non cryptes.Mais quelqu'un qui se trouve tre la
cible d'une attaque est toujours vulnrable car hMailServer ne vrifie pas qu'il communique avec le
bon serveur.
Pour que hMailServer vrifie le certificat des serveurs, vous devez suivre quelques tapes:
1.Dterminez l'autorit de certification qui a fournie le certificat du serveur auquel vous vous
connectez.Ce que vous ferez avec la commande:
openssl s_client -connect ${URL}:${PORT}
Exemple:
openssl s_client -connect pop.gmail.com:995
L'autorit sera numre la fin de la chane du certificat.
2.Rcuprez le certificat auprs de l'autorit de certification. Ce qui peut tre fait en contactant
l'autorit de certification ou en l'exportant partir de votre navigateur web local.Firefox inclut les
certificats de la plupart des autorits de certification importantes. Le fichier de certificat doit tre
au format PEM.
3.Calculez le hachage du certificat. Vous pouvez le faire via la commande:
openssl x509 -in "C:\path\to\ca.pem" -hash
La premire ligne montrera le hachage du fichier. Exemple: le hachage pour Equifax Secure CA est
594f1775.
4.Renommez le fichier PEM de certificat pour <hash>.0 (le nom du fichier doit tre hash et
l'extension 0 (un zro). Dans l'exemple Equifax, le nom du fichier sera 594f1775.0.
5.Placez le fichier dans le dossier C:\Program Files\hMailServer\Externals\CA.
6.Redmarrez le service hMailServer.
Aprs ces tapes, hMailServer essaiera toujours de vrifier les certificat du serveur lors des
connexions un port de serveur SSL. Si la vrification choue, hMailServer abandonnera la
connexion. Notez que cela se produit pour tous les ports SSLet pas seulement pour ceux sur
lesquels vous avez install un certificat.
Pour plus de scurit, vous pouvez dfinir des autorisations pour le fichier de certificat de sorte
que seul le service de hMailServer peut y accder.
Configuration
79 / 214
Nom
Le nom du certificat SSL. Le nom n'est utilis que pour l'affichage et ne doit avoir aucune relation
avec le certificat SSL.
Fichier certificat
Le fichier de certificat utiliser.
Fichier de cl prive
Le fichier de cl prive utiliser.
hMailServer sera incapable de lire la cl prive si elle contient un mot de passe. Assurez-vous
d'avoir supprim le mot de passe de la cl avant de configurer hMailServer pour qu'il utilise le
fichier
tat
Gnralits
La bote de dialogue tat vous fournit des informations sur l'tat en cours de votre installation
hMailServer.
Serveur
A la section Serveur, vous pouvez lancer ou arrter le serveur hMailServer, voir la version actuelle
de hMailServer et les informations sur la base de donnes. Si vous lancez ou arrtez le serveur
partir de cette bote de dialogue, en fait vous ne lancez pas ni n'arrtez pas le service du serveur
actuel. Mme si vous cliquez sur Stop, le service hMailServer continuera s'excuter. Autrement
dit, le serveur s'arrte, pas le service. Le service est le fichier excutable, hMailServer.exe, alors
que le serveur est le sous-composant de l'excutable, celui qui accepte la connexion des clients.
Sous Avertissements de Configuration, vous verrez une liste des problmes de configuration que
l'auto-test de hMailServer Administrators a dtects. La plupart d'entre eux sont des problmes
que vous aurez rsoudre ds que possible.
tat
La section tat affiche des informations tels que le moment o le serveur a t lanc, le nombre
de messages traits et le nombre de sessions actuellement actives pour les diffrents protocoles.
Notez que le compteur de messages augmente mesure que le courrier est trait (il ne dcroit
jamais) alors que le nombre de sessions ouvertes dcroit mesure que les clients se
dconnectent du serveur.
Messages traits
Il s'agit du nombre de messages que hMailServer a accept de distribuer et a commenc
distribuer.Ils ont t distribus hMailServer par un client SMTP, ou tlchargs d'un compte
POP3 externe, ou crs directement dans la base de donnes hMailServer ou en utilisant le API.
Virus dtects(avant:Messages contenant un Virus)

Il s'agit du nombre total de messages que hMailServer a trait et dans lesquels des virus ont t
trouvs. Ce qui devrait tre gale ou infrieure au nombre de messages traits.
Messages de spam(avant:Messages contenant un spam)

80 / 214
Il s'agit du nombre total de messages que hMailServer a dtect comme contenant un spam. Ces
messages peuvent avoir t distribus aux destinataires, en fonction de la configuration du
serveur. Si, par exemple, hMailServer est configur pour abandonner tous les spams
immdiatement, le dcompte peut tre suprieur au nombre de messages traits.
Journalisation
En utilisant le journal en temps rel, vous pouvez voir ce qui se passe au niveau de votre
installation de hMailServer sans tre oblig d'ouvrir manuellement le journal. Le journal en temps
rel est principalement utilis pour le dpannage. Pour utiliser le journal, accdez d'abord ses
paramtres et activez les options de dtails que vous souhaitez enregistrer. Ensuite, ouvrez cette
section et cliquez sur Dmarrer. Ds que quelque chose est ajout au journal, elle apparat
automatiquement dans cette section.
File d'attente de distribution
La section File d'attente de distribution affiche les messages qui sont en file d'attente pour tre
distribus. Les tches suivantes peuvent tre effectues:
Rafrachir - La liste affiche est un instantan de l'instant o vous ouvrez cette section. Si vous
attendes quelques minutes, plusieurs messages auront t distribus. Pour afficher un nouvell
instantan, cliquez sur Rafrachir.
Effacer le file d'attente - Choisissez Effacer le file d'attente pour effacer tous les messages de la
file d'attente de distribution. Les messages actuellement en cours de distribution peuvent encore
tre distribus, en fonction de l'tat prcis du moment.
Afficher (clic droit dans la liste) - Choisissez cette option pour afficher une nouvelle bote de
dialogue qui vous permettra de voir le contenu d'un message.
Envoyer maintenant (clic droit dans la liste) -Cette option placera le message en file d'attente
pour un envoi immdiat. Ce qui signifie que si un processus de distribution est disponible, celle-ci
sera effectue immdiatement. Sinon, l'envoi dbutera ds qu'un processus de distribution est
disponible.
Effacer(clic droit dans la liste). Cette option effacera le message de la file d'attente de
distribution.
Serveurs SURBL
Gnral
Hte DNS
L'hte DNS que hMailServer doit demander lors d'une recherche SURBL.
Message de refus
Le message que hMailServer enverra l'expditeur si un courrier est refus.
Port TCP/IP
Port TCP/IP
Protocole
Choisissez le protocole utiliser pour ce port spcifique. Si un client se connecte au port,
hMailServer utilisera ce protocole pour analyser les commandes entrantes du client.
81 / 214
Adresse TCP/IP
Spcifiez l'adresse TCP/IP que hMailServer doit surveiller. La valeur par dfaut, 0.0.0.0, signifie que
hMailServer doit surveiller toutes les adresses IP disponibles.
Port TCP/IP
Le nombre de ports que hMailServer doit surveiller pour l'adresse IP spcifie.
Utiliser SSL
Slectionnez cette option si vous souhaitez que les transmissions entre le client et hMailServer
soient cryptes. Si SSL est activ, toutes les communications avec hMailServer via ce port
ncessitent d'tre effectues en utilisant SSL. hMailServer ne prend pas en charge STARTTLS.
Certificat SSL
Si vous avez choisi d'utiliser SSL, vous devez slectionner le certificat SSL utiliser pour ce port
spcifique.
Utilitaires
Utilitaires
La section Utilitaires contient les lments qui peuvent tre considrs comme des outils de prise
en charge pour l'installation de votre hMailServer.
Accueil
Accueil
Lorsque vous lancez hMailServer Administrator, une fentre d'Accueil apparat pour vous aider
crer votre premier domaine dans hMailServer.
Liste blanche
Gnral
hMailServer propose de nombreuses fonctionnalits anti-spam. Dans certains cas, vous aurez
probablement besoin que certains expditeurs les contournent. Si, par exemple, une certaine
adresse IP a t place en liste noire par erreur, et que vous souhaitez recevoir son courrier.
Autre exemple: vous attendez un courriel d'un expditeur spcifique, et vous ne voulez pas
risquer de perdre ce courriel s'il est class comme spam.
Pour ce faire, vous pouvez ajouter des enregistrement de liste blanche la configuration. Si
hMailServer reoit le courriel d'une source qui correspond l'un de ces enregistrements,
hMailServer n'essaiera pas de dterminer s'il s'agit d'un spam. Pour ajouter un enregistrement de
liste blanche, lancez hMailServer Administrator, et accdez Configuration, Protection anti-spam,
Liste Blanche. Pour chaque enregistrement de liste blanche, vous pouvez entrer une description,
une dresse IP infrieure et suprieure et une adresse de messagerie.
82 / 214
Avant de traiter la protection anti-spam, hMailServer dtermine l'adresse IP de l'expditeur.
Lorsque c'est fait, hMailServer parcourt la liste blanche. Si un enregistrement correspond
l'adresse IP est dtect, hMailServer vrifie si l'adresse de messagerie spcifie dans la liste
blanche correspond. Si c'est le cas, la protection anti-spam est ignore pour ce courriel.
Exemples
Exemple 1: Placer en liste blanche tous les messages de bill@example.com:
1.Cliquez sur Ajouter pour ajouter un nouvel enregistrement la liste blanche
2.Dans le champ Description, spcifiez "Liste blanche de bill@example.com"
3.Dans le champ Adresse e-mail, spcifiez bill@example.com.
4.Cliquez sur Enregistrer.
Dsormais, un enregistrement est ajout. Notez que la plage IP pour cet enregistrement est
rgle sur 0.0.0.0 - 255.255.255.255. Ce qui signifie que le courrier provenant de
bill@example.com contournera la protection ant-spam, sans tenir compte de l'origine de l'adresse
IP.
Exemple 2: Placer en liste blanche tous les messages du domaine example.com.
Dans cet exemple, vous allez utiliser un joker pour placer en liste blanche tous les expditeurs
d'un domaine spcifi.
1.Cliquez sur Ajouter pour ajouter un nouvel enregistrement de liste blanche
2.Dans le champ Description, spcifiez "Placer tout example.com en liste blanche"
3.Dans le champ Adresse e-mail, indiquez *@example.com.
Exemple 3: Placer en liste blanche tous les courriels envoys du domaine example.com, du rseau
local (192.168.0.*)
2.Dans le champ Description, entrez "Rseau Local"
3.Dans le champ IP infrieur, saisissez 192.168.0.1
4.Dans le champ IP suprieur, saisissez 192.168.0.255.
5.Dans le champ Adresse e-mail, indiquez *@example.com.
Exemple 4: Placer en liste blanche tous les courriels envoys du rseau local (192.168.0.*)
2.Dans le champ Description, entrez "Rseau Local"
3.Dans le champ IP infrieur, saisissez 192.168.0.1
4.Dans le champ IP suprieur, saisissez 192.168.0.255.
Dsormais, un enregistrement est ajout. Notez que l'adresse e-mail de cet enregistrement est
rgle sur *. Ce qui signifie que hMailServer ignorera la protection anti-spam pour tout le courrier
originaires du rseau local, peu importe l'expditeur.
Remarques
Vous pouvez utiliser les jokers dans la partie adresse de messagerie des enregistrements de
liste blanche. Vous pouvez les utiliser, par exemple dans la liste blanche:
o
pour un domaine entier - *@example.com
o
pour une bote aux lettres spcifique, par exemple sales de tous les domaines - sales@*.
o
pour les edresses contenant des mots spcifiques, comme "support" - *support*
En d'autres termes, vous pouvez utiliser le * n'importe quel endroit d'une adresse de
messagerie.
Il n'est pas possible d'utiliser les jokers dans une adresse IP.
Si vous avez slectionn "Relais de transfert" dans la plage IP partir de laquelle l'expditeur se
connecte, hMailServer utilisera l'es en-ttes Reu du message pour dterminer l'adresse IP du
message d'origine.
83 / 214
Configuration
Description
Description textuelle des enregistrements de la liste blanche.
Adresse e-mail
L'adresse de messagerie qui doit tre place en liste blanche. Il est possible d'utiliser les jokers
dans ce champ. Vous pouvez, par exemple, placer en liste blanche tous le courriel du domaine
example.com, en spcifiant l'adresse *@example.com
IP Infrieur et Suprieur
La plage IP laquelle s'applique les enregistrements de la liste blanche. Si vous laissez ces
champs vierges, hMailServer supposera que vous indiquez 0.0.0.0-255.255.255.255 (la totalit
d'Internet).
Dpannage
Messages d'erreur
Messages d'erreur de la base de donnes
Le serveur MySQL a disparu
Si hMailServer perd sa connexion avec le serveur de base de donnes lors d'une requte, il essaie
de relancer la connexion et de relancer la requte. Ci cela choue, l'erreur Le serveur MySQL a
disparu est journalise. Ce qui peut se produire si le serveur MySQL s'excute sur un autre
ordinateur, et que la connexion rseau est perdue. Il est galement possible que le serveur
MySQL soit sur le point d'tre arrt, lors du redmarrage d'un ordinateur, par exemple. Dans la
plupart des cas, cette panne n'a aucun effet secondaire.
Messages d'erreur DNS
Erreurs DNS
Informations gnrales
hMailServer utilise l'API de Windows pour interroger le serveur DNS. hMailServer lui-mme ne
demande pas Windows d'utiliser un serveur DNS spcifique. La requte DNS se fait l'aide de la
fonction API de Windows DnsQuery. En fonction de l'erreur DNS qui s'est produite, DnsQuery
renvoie diffrentes valeurs. Si une erreur se produit, elle sera numre dans le journal de
hMailServer.
84 / 214
1460, ERROR_TIMEOUT
L'erreur DNS 1460 signifie qu'il y a eu un temps mort lors de l'excution de DnsQuery. Ce qui peut
se produire si le serveur DNS est en cours d redmarrage ou s'il n'est pas disponible du fait de
problmes de rseau.
9002, DNS_ERROR_RCODE_SERVER_FAILURE
Le numro d'erreur 9002 signifie qu'une panne du serveur DNS s'est produite.
Messages d'erreur hMailServer Administrator
Erreurs hMailServer Administrator
La machine du serveur distant n'existe pas ou est indisponible
Lors d'une connexion une instance de hMailServer en utilisant hMailServer Administrator, DCOM
est utilis. hMailServer se connecte au service hMailServer en utilisant l'API de DCOM et gre le
serveur via l'API. hMailServer Administrator (et PHPWebAdmin) ne se connecte pas directement au
serveur de base de donnes. De ce fait, pour pouvoir excuter hMailServer Administrator, le
service hMailServer doit tre en activit.
Si hMailServer Administrator ne peut pas se connecter au service hMailServer, vous pourrez voir
l'erreur ci-dessus. Par dfaut, hMailServer Administrator essaie de se connecter une instance de
hMailServer en activit sur localhost. Si vous obtenez ce message d'erreur, vrifiez que le nom
d'hte auquel vous essayez de vous connecter dans la bote de dialogue de connexion est valide.
Si c'est le cas, vous devez vous dpanner.
Messages d'erreur SMTP
Messages d'erreur SMTP
421 Temps mort de connexion
S'il y a un temps mort lorsque hMailServer attend une commande du client SMTP, ce message
d'erreur est envoy au client avant que hMailServer le dconnecte. Le temps mort SMTPdans
hMailServer est de 10 minutes.
421 Quantit excessive de donnes envoye au serveur.
Cette erreur est gnre par hMailServer si un client envoie une grande quantit de donnes
hMailServer ne contenant pas le caractre retour chariot (fin de commande). Un client ne doit
jamais pratiquer de la sorte, mais des clients mal configurs peuvent dclencher ce problme.
451 Merci d'essayer nouveau ultrieurement.
Ce message d'erreur est gnr si la liste grise est active et que le triplet expditeur,
destinataire et l'adresse IP ne correspond pas au triplet d'une liste grise existante.
500 Ligne trop longue
85 / 214
Si un client SMTPenvoie une commande SMTP que hMailServer considre comme tant trop long, il
dclenche cette erreur. Cette erreur indique habituellement un dfaut du client ou une tentative
de piratage.
501 EHLO Adresse de domaine non valide
502 TURNdsactiv
Si un client SMTPessaie d'utiliser la commande TURN, hMailServer rpond par ce code d'erreur.
hMailServer n'inclut pas la prise en charge du verbe TURN.
502 Commande non implmente
Si un clientSMTPessaie d'utiliser une commande pour laquelle hMailServer n'a pas
d'implmentation, ce message d'erreur est envoy au client.
502 Utiliser d'abord HELO/EHLO
Aprs qu'un client SMTPse soit connect un serveur SMTP, la premire chose qu'il doit faire est
de s'identifier via la commande HELOou EHLO. Dans le cas contraire, hMailServer rpond par ce
message d'erreur.
502 VRFY refus
Si un client SMTPessaie d'utiliser la commande VRFY, hMailServer rpond par ce code d'erreur.
hMailServer ne propose pas la prise en charge du verbe VRFY.
503 Effectuer une rinitialisation si vous voulez recommencer
Lorsqu'un client de messagerie distribue un courriel un serveur de messagerie, il indique d'abord
au serveur l'adresse de messagerie de l'expditeur. Ensuite, il lance une transaction qui ne se
termine pas tant que la totalit du message n'a pas t distribue au serveur de messagerie.Si le
client souhaite abandonner la transaction et envoyer un autre message, il doit mettre la
commande RSET.Si un client, en plein milieu de la transaction, essaie d'envoyer un nouveau
courriel sans avoir d'abord abandonn la transaction en cours, hMailServer mettra ce message
d'erreur. Ce qui indique un bug du client SMTP.
503 Ncessite d'abord l'expditeur et le destinataire.
Lorsqu'un client SMTPdistribue un courriel un serveur SMTP, il doit spcifier l'expditeur et le
destinataire avant d'essayer de soumettre le contenu du message en cours.Si un client ne russit
pas indiquer l'adresse de l'expditeur et du destinataire hMailServer avant d'essayer de
soumettre le contenu du courriel, hMailServer rpondra par cette erreur. Ce qui indique un bug du
client SMTP.
503 Ncessite d'abord l'expditeur.
Lorsqu'un client SMTPdistribue un courriel un serveur SMTP, il doit spcifier l'expditeur et le
destinataire avant d'essayer de soumettre le contenu du message en cours. Le client doit d'abord
l'adresse de l'expditeur au serveur, et indiquer ensuite l'adresse du destinataire. Si le client
essaie d'indiquer hMailServer l'adresse du destinataire avant l'adresse de l'expditeur, ce
message d'erreur est mis. Ce qui indique un bug du client SMTP.
86 / 214
504 Mcanisme d'authentification non pris en charge.
Ce message d'erreur est mis si un client essaie de s'authentifier en utilisant une mthoode qui
n'est pas prise en charge par hMailServer.
504 Type d'authentification non spcifi.
Ce message d'erreur est mis par hMailServer si un client essaie de s'authentifier sans spcifier la
mthode d'authentification. Cette erreur indique un bug du client SMTPutilis.
530 Authentification SMTP requise.
Vous avez activ l'authentification SMTP pour la plage IP laquelle l'utilisateur est connect, mais
l'utilisateur n'a pas configur son client pour utiliser l'authentification SMTP. Deux mthodes sont
possibles pour rsoudre ce problme. Vous configurez votre client de messagerie pour qu'il utilise
l'authentification SMTP (rglage accessible dans la configuration du compte de votre client de
messagerie), ou vous dsactivez l'authentification SMTP pour la plage IP. La premire mthode est
prfrable car elle rduit le risque que quelqu'un eenvoie des spams sur votre serveur.
Par dfaut, hMailServer ne ncessite pas d'authentification SMTP pour connexions en provenance
de localhost / 127.0.0.1. Pour les connexions en provenance des autres htes, l'authentification
SMTP est requise pour les distributions aux destinataires externes. Par dfaut, hMailServer ne
ncessite jamais d'authentification SMTP pour distribuer aux comptes locaux, car cela empcherait
les autres serveurs de messagerie de distribuer du courrier votre installation. Pour en savoir
plus sur l'activation de l'authentification SMTP, consultez la rubrique HOWTO.
Si vous utilisez un routeur Cisco, vous aurez sans doute dsactiver le protocole SMTP Fixup.
Dans le cas contraire, le routeur interceptera parfois le trafic SMTP et remplacera les donnes qu'il
contient avant d'atteindre hMailServer, ce qui entranera des problmes.
535 L'authentification a choue. Relancez le processus d'authentification.
Si un client SMTPs'authentifie mais que le nom d'utilisateur ou le mot de passe est incorrect, ou si
le compte est dsactiv, hMailServer envoie ce message d'erreur au client.
550 Une adresse valide est requise
hMailServer met ce message d'erreur si un client SMTPessaie de spcifier une adresse de
destinataire non valide (dont la syntaxe n'est pas correcte).
550 Le compte n'est pas actif.
Si un client SMTPessaie d'envoyer un courriel un compte qui n'a pas t activ, ce message
d'erreur est envoy au client.
550 L'alias n'est pas actif.
Si un client SMTPessaie d'envoyer un courriel un alias qui n'a pas t activ, ce message
d'erreur est envoy au client.
550 Bloqu par SPF
Si un courriel est refus au cours des vrifications SPF, ce message d'erreur est mis.
87 / 214
550 La distribution n'est pas autorise cette adresse
Cette erreur signifie que l'expditeur essaie d'envoyer un courriel une adresse laquelle il n'est
pas autoris effectuer un envoi.Ce message est gnr aprs que hMailServer ait vrifi les
paramtres de la plage IP. Exemple: la configuration par dfaut de la plage IP ne permet pas aux
utilisateurs externes d'envoyer des courriels aux autres utilisateurs externes. Ceci pour empcher
les gens d'utiliser votre serveur pour envoyer des spams. ainsi, si un utilisateur externe essaie
d'envoyer un courriel un autre utilisateur externe, il recevra ce message.
550 Le liste de distribution n'est pas active.
Si un client SMTPessaie d'envoyer un courriel une liste de distribution qui n'est pas active, ce
message d'erreur sera envoy au client.
550 Le domaine a t dsactiv.
Si un client SMTPessaie d'envoyer un courriel domaine qui a t dsactiv, ce message d'erreur
sera envoy au client.
550 Syntaxe non valide. La syntaxe doit tre MAIL FROM:<userdomain>[crlf]
Si un client met une commandeMAILFROMdont la syntaxe est incorrecte, hMailServer enverra ce
message d'erreur.
550 Les identifiants d'ouverture de session ne sont plus valides. Veuillez vous identifier
nouveau.
Lors d'une session SMTP, un expditeur SMTP peut envoyer plusieurs courriels. A chaque fois
qu'un client SMTPessaie de distribuer un nouveau courriel hMailServer, le client est re-identifi
pour garantir que le nom d'utilisateur et le mot de passe sont toujours valides.Ce qui est
ncessaire car il n'y a aucune limitation quant la dure de connexion d'un client SMTP
hMailServer, tant qu'il envoie des messages. Si hMailServer ne r-identifiait pas les utilisateurs
connects, il n'y aurait aucun moyen de dconnecter ceux qui enverraient des spams non stop.
550 Erreur de configuration du serveur de messagerie. Trop de transferts rcurrents.
Lorsqu'un client de messagerie indique hMailServer pour qui le courriel est destin, il essaie de
dterminer le "destinataire final". L'adresse de messagerie que le client a fournie hMailServer
peut ne pas tre celle du destinataire final. Exemple:vous avez dfini un alias, alias@example.com,
qui pointe sur account@example.com, et le client de messagerie indique hMailServer que le
courriel est destin alias@example.com, alors que le destinataire final est
account@example.com.
Il est possible, ici, de configurer hMailServer de faon incorrecte. Exemple: vous avez nomm un
alias alias@example.com pointant sur alias2@example.com, et l'alias alias2@example.com pointant
sur alias@example.com. Lorsque hMailServer essaie de dterminer le destinataire final pour un
courriel destin alias@example.com, il abandonnera car il n'existe pas et il rapportera ce
message d'erreur. L'erreur sera toujours rapporte si hMailServer ne peut pas dterminer le
destinataire final.
Les causes suivantes sont les plus courantes:
Une adresse fourre-tout a t spcifi pour le domaine du destinataire, mais aucun compte
n'existe qui correspond l'adresse fourre-tout indique.
Le courriel a t envoy un alias qui ne pointe pas sur un compte valide.
88 / 214
550 Non autoris.
Si un client de messagerie essaie d'envoyer un courriel une liste de distribution qui n'a pas de
permission de rception, ce message d'erreur est mis.
550 Bnficiaire absent de la liste de l'itinraire.
Si un client essaie d'envoyer un courriel un domaine de destinataires qui correspond
l'itinraire, mais que l'adresse du destinataire ne figure pas dans la liste des adresses valides, ce
message d'erreur est envoy au client.
550 L'adresse de l'expditeur doit tre spcifie.
Si hMailServer est configur pour refuser les adresses d'expditeur vides, et qu'un client
SMTPessaie d'utiliser une adresse d'expditeur vide, cette erreur est mise.
550 Le domaine de l'expditeur n'a pas d'enregistrements MX.
Si un courriel est refus aprs vrification MX, ce message d'erreur est mis.
550 L'adresse n'est pas valide.
hMailServer met ce message d'erreur si un client SMTPspcifie une adresse d'expditeur non
valide (dont la syntaxe n'est pas correcte).
550 Le nom d'hte spcifi dans HELO ne correspond pas l'adresse IP.
Ce message d'erreur fait partie du mcanisme de protection anti-spam de hMailServer. Si un
serveur d'envoi de courriel distribue un e-mail hMailServer, l'une des premires choses qu'il doit
faire est de s'identifier lui-mme. Il le fait via une commande HELO <HOSTNAME> o <HOSTNAME>
est remplac par son nom d'hte. Le nom d'hte que le serveur d'envoi fournit la commande
HELO doit rsoudre l'adresse IP du mme serveur.
Si, par exemple, un des serveurs Hotmails essaie de distribuer un courriel votre serveur, il
enverra une commande similaire HELO mx1.hotmail.com. Si l'option Vrifier l'hte dans la
commande HELO a t active dans les paramtres de la protection anti-spam protection de
hMailServer, celui-ci vrifiera que le nom d'hte envoy par le serveur de Hotmails,
mx1.hotmail.com, correspond l'adresse IP partir de laquelle la connexion va s'effectuer. Si
l'adresse IP ne correspond pas au nom d'hte, hMailServer considre le courriel comme un spam.
Si vous avez configur hMailServer pour supprimer un e-mail considr comme un spam,
hMailServer rapportera le message d'erreur ci-dessus l'expditeur.
Si quelqu'un essaie de vous envoyer un e-mail et que vous recevez cette erreur, effectuez l'une
des actions suivantes:
Informez l'administrateur du serveur qui envoie le courriel qu'il n' pas spcifi le nom d'hte
correct dans la commande HELO.
Dsactivez l'option "Vrifier l'hte dans la commande HELO" au niveau des paramtres de la
protection anti-spam via hMailServer Administrator ou PHPWebAdmin. Cette option est dsactive
par dfaut.
Dans les paramtres de la prootection anti-spam, indiquez que hMailServer doit distribuer les
spams, mais modifiez le en-ttes de message. De mme, choisissez de modifier le sujet du
message. Le courriel sera alors distribu, mais [SPAM] sera ajout au sujet.
550 Utilisateur inconnu
89 / 214
Ce message d'erreur est mis si le client SMTPessaie de distribuer un courriel un domaine
hberg par hMailServer et que le compte de l'utilisateur est introuvable et qu'aucune adresse
fourre-tout n'a r spcifie pour le domaine destinataire.
550 Votre message a t reu mais ne peut pas tre enregistr. Essayez ultrieurement.
Si le courriel a t reu par hMailServer mais qu'il n'a pu tre enregistr, ce message d'erreur est
envoy au client. Il indique des problmes concernant la base de donnes.
550 <Autre message d'erreur>
Dans la liste noire DNSet la configuration SURBL, il est possible de spcifier des messages d'erreur
personnaliss utiliser lorsqu'un courriel est refus.
552 La taille du message dpasse la taille de message maximum fixe. Taille: x Ko, Taille
Max: y Ko
Dans hMailServer, il est possible de spcifier une taille maximum de message dans la configuration
SMTP et dans la configuration du domaine. Si la taille d'un courriel dpasse cette limite, ce
message d'erreur est mis.
554 Refus
Si un script hMailServer, s'excutant lors de l'vnement OnAcceptMessage, refuse un courriel
sans message d'erreur spcifique, cette erreur est mise.
554 Refus - Le message contient un LF seul.
Selon la spcification SMTP, les lignes d'un courriel doivent tre spares par les codes ASCII 13 et
10 - retour chariot (CR) et saut de ligne (LF). Certains spammeurs et logiciels dfectueux envoient
des courriels qui ne sont pas formats correctement. Utilisez ce paramtre pour refuser ces
messages. Notez que des e-mails lgitimes peuvent avoir t formats de faon incorrecte en fin
de ligne, si le logiciel d'envoi contient des bugs.
Si, en temps que dveloppeur, vous tes confront ce problme, vrifiez que chaque ligne de
votre courriel (en-tte et corps) se termine par un retour chariot et un saut de ligne, et pas
seulement un saut de ligne. La faon d'y parvenir dpend du langage de programmation avec
lequel vous travaillez. En .C++, C#, et PHP, ajoutez \r\n la fin de chaque ligne. En Visual Basic,
ajoutez vbNewLine ou vbCRLF.
Sous Windows, le sparateur de ligne est CRLF. Sous Linux et UNIX, le sparateur par dfaut est
LF seul. Cependant, lors de l'envoi d'un courriel depuis un systme Linux/UNIX, CRLF doit toujours
tre utilis. Certains serveurs de messagerie sous Linux (comme Postfix) remplacent
automatiquement LF par CRLF. Par consquent, si vous rglez le sparateur de ligne des courriels
sur CRLF, il sera remplac par CRCRLF.
554 Refus - Aucune donne enregistre.
Si hMailServer reoit un courriel d'un client SMTPmais qu'il ne peut pas enregistrer le fichier
correspondant sur le disque, ce message d'erreur est mis. Le problme se produit si le dossier de
donnes spcifi dans hMailServer.ini n'est pas accessible en criture par le service hMailServer.
554 Refus - <autre message d'erreur>
Si un script hMailServer refuse un courriel lors de l'vnementOnAcceptMessage, il peut envoyer
90 / 214
un message d'erreur au client.Si un script le fait, hMailServer envoie ce message d'erreur aue
client. <Other error message>est remplac par le message d'erreur fourni par le script.
554 Marqu comme spam par SpamAssassin
Si un courriel est refus par SpamAssassin, ce message d'erreur est mis.
Messages d'erreur des messages de rebond
Le logiciel serveur de messagerie essaie de distribuer un e-mail la machine locale
Ce message d'erreur typiquement une erreur de configuration du serveur. hMailServer effectue de
nombreuses vrifications avant la distribution du courriel pour viter des envois en boucles
infinies. Si un courriel est envoy et que le destinataire est introuvable dans l'installation locale,
hMailServer essaiera normalement de contacter le serveur des destinataires pour distribuer le
courriel.
Avant que hMailServer se connecte au serveur des destinataires, il vrifie que l'adresse IP
laquelle il va se connecter n'est pas une adresse IP locale. Si l'adresse IP est une adresse IP
locale, cela signifierait que hMailServer se connecte lui-mme, ce qui dclencherait
vraisemblablement une boucle de message. Dans ce cas, hMailServer refuse le courriel et retourne
un message d'erreur l'expditeur.
Les causes suivantes sont courantes pour ce problme:
Un nom d'hte ou une adresse IP qui pointe sur un ordinateur local a t saisi comme relais
SMTP. Accdez la section Distribution des e-mails de la configuration SMTP. Vrifiez le rglage du
Relais SMTP. Si vous avez entr localhost, 127.0.0.1, your-own-domain-name.com, ou quelque
chose de similaire dans le champ de saisie, c'est probablement la cause du problme. Si c'est le
cas, consultez la rubrique Configuration SMTP pour en savoir plus et corrigez le problme.
Un des enregistrements MX pour le domaine pointe sur votre serveur, mais le domaine n'a pas
t ajout votre installation.
Il n'existe aucun serveur de messagerie pour l'adresse.
Lorsque hMailServer distribue un courriel un destinataire externe, il effectue une requte DNS
pour dterminer o le courriel doit tre envoy. Si la requte DNS choue, le message d'erreur ci-
dessus est rapport. Exemple: la requte peut chouer si le serveur DNS n'est pas disponible ou
si le domaine du destinataire n'existe pas. Pour de plus amples dpannages, consultez le journal
d'erreurs de hMailServer. Le journal d'erreurs de hMailServer contient les codes d'erreur du client
DNS sous Windows.
Messages d'erreur non gnrs par hMailServer
550 Bote aux lettres non disponible
hMailServer ne gnre jamais ce message d'erreur. Si hMailServer essaie de distribuer un e-mail
une autre serveur, mais que le compte du destinataire est introuvable sur ce serveur, le serveur
des destinataires peut mettre ce message d'erreur.
Le message d'erreur indique que vous envoyez le courriel une adresse incorrecte.Si vous tes
sr que l'adresse est correcte, le problme peut provenir de la configuration DNS des
destinataires.
550 chec de la vrification de l'expditeur
91 / 214
Lorsque hMailServer distribue un courriel un autre serveur, le serveur SMTP destinataire peut
essayer de valider que l'expditeur du courriel existe rellement. Si cette vrification choue, il
peut rpondre par le message d'erreur 'chec de vrification de l'expditeur'. Dans ce cas, l'e-mail
sera renvoy l'expditeur. Cette vrification fonctionne de la faon suivante:
1.hMailServer se connecte au serveur SMTP des destinataires
2.hMailServer indique au serveur SMTP des destinataires que l'e-mail provient de
example@example.com
3.Le serveur SMTP des destinataires recherche un enregistrement MX pour le domaine
example.com.
4.Le serveur SMTP des destinataires se connecte l'hte spcifi dans l'enregistrement MX - qui
se trouve vraisemblablement l o votre serveur hMailServer s'excute si les enregistrements MX
sont rgls correctement.
5.Ensuite, le serveur SMTP des destinataires met les commandes HELO, MAIL FROM<> et RCPT
TO:
6.Si hMailServer confirme que le destinataire example@example.com existe, le serveur SMTP des
destinataires autorisera la distribution initialise l'tape 2 ci-dessus.
Certaines tapes peuvent mal se drouler au cours de ce processus:
Si les enregistrements MX du domaine example.com ne sont pas rgls correctement, le serveur
SMTP des destinataires peut se connecter un hte SMTP incorrect et la vrification de l'adresse
de l'expditeur chouera.
Si le compte example@example.com n'existe pas, la vrification de l'expditeur chouera.
Si vous avez dsactiv Autoriser une adresse d'expditeur vide, la vrification de l'expditeur
chouera, car le serveur SMTP des destinataires essaie de vrifier en utilisant une adresse
d'expditeur vide.
Conseils de dpannage
Dpannage d'une rgle
Gnralits
Cette rubrique contient les conseils de dpannage concernant le traitement des rgles.Si vous
rencontrez des problmes avec une rgle, nous vous recommandons de consulter cette rubrique.
Conseils
Dlai de 60 secondes
Lorsqu'un e-mail est gnr automatiquement par une rgle, aprs un transfert, par exemple, 60
secondes peuvent s'couler avant que le message soit distribu. Il le sera la prochaine fois que
hMailServer sondera la base de donnes pour la distribution des messages. Ce dlai est
ncessaire. Sans lui, il serait facile de crer une rgle qui distribuerait des messages selon une
boucle sans fin, et hMailServer utiliserait 100% des ressources CPU jusqu' suppression de la
rgle.
Champs d'en-tte encods
Les en-ttes d'un e-mail peuvent tre encods en utilisant diffrents types d'encodages. Si vous
dfinissez un critre de recherche d'un champ d'en-tte, hMailServer essaiera de dcoder ce
champ d'en-ttes si possible. Si l'en-ttes est en Japonais, par exemple, le contenu du message
ne pourra pas tre recherch.
Messages incorrectement formats
92 / 214
Si un message n'est pas correctement format, hMailServer peut rencontrer des problmes pour
retrouver les valeurs des en-ttes individuels du message. Dans un message correctement
format, chaque ligne doit se terminer par un retour chariot et un saut de ligne. Dans certains cas,
le message peut contenir un retour chariot seul ou un saut de ligne seul. Si c'est le cas,
hMailServer sera incapable de retrouver les valeurs de l'en-tte. Sur un plan technique,
hMailServer fonctionne correctement - si une ligne dans un e-mail n'est pas correctement termin,
il n'est pas termin.
Ce qui peut prter confusion est que certains clients de messagerie ignorent le fait que les
messages ne sont pas formats correctement. Un e-mail que hMailServer n' pas pu analyser peut
tre affich correctement dans votre client de messagerie. La seule faon de dterminer si un e-
mail est correctement format ou pas est de localiser le fichier message dans le dossier data de
hMailServer. Ouvrez le fichier de message dans le Bloc-notes et examinez les en-ttes au dbut
du message. Si vous voyez plusieurs en-ttes sur une mme ligne, c'est que le message n'est pas
correctement format. Il est important d'utiliser le Bloc-notes, et pas Wordpad ou Microsoft Word,
car ces derniers insrent automatiquement des fins de ligne correctes.
Vous pouvez configurer hMailServer pour qu'il refuse les messages qui ne sont pas correctement
formats:
2.Dployez Configuration et Protocoles dans l'arborescence gauche.
3.Choisissez SMTP
4.Slectionnez l'onglet Conformit RFC.
5.Dsactivez "Autoriser les fins de ligne incorrectement formates".
Envoyer de messages
Port 25 bloqu pour le trafic sortant
Pour distribuer un message sortant, tous les serveurs de messagerie doivent se connecter au
serveur de messagerie du destinataire sur le port 25 TCP/IP. Certains Fournisseurs d'Accs
Internet (FAI) bloquent ce port pour rduire les spams. Ce qui cre un problme pour hMailServer,
car il ne peut plus se connecter un autre serveur de messagerie pour distribuer le message.
Pour tester si votre FAI a bloqu le port 25, vous pouvez essayer de vous connecter
manuellement notre serveur de messagerie en suivant ces tapes:
1.Slectionnez Dmarrer->Excuter
2.Entrez
telnet mail.hmailserver.com 25
(saisissez exactement ce texte; ne remplacez pas
mail.hmailserver.com par le nom de votre propre serveur)
3.Cliquez sur OK pour lancer la session telnet
Si vous pouvez vous connecter, c'est que votre FAI n'a pas bloqu le trafic sortant sur le port 25.
Sinon, votre FAI a bloqu le trafic sur le port 25. Ce qui signifie que la seule faon d'envoyer des
messages en dehors du rseau de votre FAI est d'utiliser leurs propre serveurs de messagerie.
Vous pouvez essayer de re-router vos messages sortants via les serveurs SMTP de votre FAI. En
cas d'insuccs, contactez votre FAI et demandez-lui de vous permettre de re-router via leurs
serveurs SMTP ou de vous ouvrir le port 25.
Configuration DNS incorrecte sur l'ordinateur local
La configuration DNS incorrecte sur l'ordinateur local est connue pour entraner des problmes de
distribution pour hMailServer. Si le paramtrage DNS est incorrect, vous recevrez normalement un
message de bounce qui vous indique qu'aucun serveur de messagerie n'a t trouv pour le
destinataire. Windows utilise diffrents jeux de paramtres DNS, ce qui fait que mme si, par
exemple, votre navigateur web fonctionne correctement, le paramtrage DNS peut tre incorrect.
Pour vrifier si votre configuration DNS est correcte, suivez ces tapes:
1.Slectionnez Dmarrer->Excuter
2.Entrez nslookup
3.Cliquez sur OK
4.Entrez set type=mx et appuyez sur Entrer
5.Saisissez gmail.com et appuyez sur Entrer
Vous devez alors voir la liste des serveurs de messagerie de GMails. Si a n'est pas le cas, cela
93 / 214
signifie que vos paramtres DNS ne sont pas corrects.
Spam dans la file d'attente de distribution
Si vous avez mal configur hMailServer, il sera possible pour les autres de vous envoyer des
spams via votre serveur. Un moyen simple de dterminer si un spam vous sera envoy sur votre
serveur est d'ouvrir le dossier data de hMailServer. La racine du dossier data contient la file
d'attente de distribution de hMailServer. S'il y a un nombre important de messages dans la filc
d'attente de distribution, il est probable que quelqu'un vous envoie des spams via votre serveur.
Vrifiez que vous avez dsactiv Externe vers externe pour toutes les plages IP dans la
configuration de hMailAdmin.
Recevoir des messages
Les problmes les plus courants pour vous empcher de recevoir des massages sont:
Problmes MX
Tout serveur de messagerie doit possder des enregistrements MX dfinis pour le domaine qu'il
hberge. Les enregistrements MX sont ajouts aux DNS. Vous pouvez vrifier si vos
enregistrements sont dfinis correctement en entrant votre nom de domaine sur intoDNS.com.
Vous devez entrer votre nom de domaine, en excluant tout sous-domaine. Si votre domaine est
something.com, entrez something.com et non smtp.something.com ou mail.something.com. Aprs
la recherche, consultez le rsultat, sous la catgorie MX category. FAIL ne devrait apparatre nulle
part. Sinon, vos enregistrements MX sont probablement mal dfinis. En savoir plus...
Ports TCP/IP bloqus
Certains FAI bloquent le port 25 TCP/IP pour viter les spams. Certains bloquent le trafic entrant
sur le port 25, alors que d'autres bloquent le trafic sortant. Pour vrifier si votre FAI a bloqu le
trafic entrant, faites une requte sur intoDNS.com. Aprs la reequte, cherchez la catgorie Mail. It
should not say FAIL ne devrait apparatre nulle part. Sinon, votre FAI a probablement bloqu le
trafic vers ou depuis le port 25. En savoir plus.... Pour savoir si c'est la cas, contactez votre FAI et
posez-lui la question.
Port 25 non utilis
Pour fonctionner correctement, tous les serveurs de messagerie doivent utiliser le port 25 pour le
trafic entrant. Si vous avez reconfigur hMailServer pour utiliser un autre port, vous ne pourrez
pas recevoir de courriel. En savoir plus....
Routeur / Pare-feu non configur
Comme il est dit plus haut, tout serveur de messagerie doit utiliser le port 25 pour le trafic entrant.
Si vous souhaitez recevoir les e-mails d'autres personnes, vous devez laisser hMailServer
surveiller les connexions SMTP sur le port 25 (ce qu'il fait par dfaut). Cependant, si votre
installation de hMailServer est derrire un routeur ou pare-feu, vous devez probablement
configurer le routeur ou le pare-feu pour transfrer le trafic TCP entrant sur le port 25 de
l'ordinateur o s'excute hMailServer. Sinon, le trafic ne parviendra pas hMailServer et les
expditeurs de messages ne pourront pas se connecter.
Erreurs DNS
Si les enregistrements DNS de votre domaine ne sont pas dfinis correctement, vous ne pouvez
pas recevoir de messages. Pour vrifier que vos enregistrements DNS sont dfinis correctement,
utilisezintoDNS.com.
94 / 214
Paramtres multi-hbergement incorrects
Si vous avez configur hMailServer pour surveiller une adresse IP spcifique, vrifiez que cette
adresse est correcte et qu'il ne s'agit pas d'une adresse locale, comme 127.0.0.1. Si hMailServer
ne surveille qu'une adresse IP locale, telle 127.0.0.1, personne, sauf les gens que se connectent
partir de l'ordinateur local, ne pourra se connecter.
Plages IP incorrectes
Par dfaut, une plage IP nomme Internet est cre. Si vous modifiez cette plage IP, il y a le
risque que vous ne puissiez pas recevoir les messages des autres serveurs. hMailServer n'accepte
pas les messages des adresses IP qui ne correspondent aucune des plages IP.
Autre
Si la description ci-dessus ne s'applique pas votre problme, vous pouvez demander des
suggestions sur notre forum. Avant de poser vos questions:
Envoyez un e-mail depuis un serveur externe. Attendez le retour du message d'erreur. Insrez le
message d'erreur dans votre demande sur le forum.
Si vous n'obtenez pas de message en retour, activez le journalisation SMTPdans hMailServer,
reproduisez l'erreur et vrifiez si quelque chose a t ajout au journal. Si c'est le cas, ajoutez-le
votre demande sur le forum.
Autres conseils de dpannage...
Dpannage
Vous trouverez ci-dessous des conseils qui peuvent vous tre utiles si vous rencontrez des
problmes avec hMailServer. Si vous ne trouvez pas de rponse sur ces liens, posez votre
question sur le Forum de hMailServer.
Problmes courants
Impossible de lancer le serveur
Impossible de se connecter au serveur via mon client de messagerie
Impossible d'envoyer des messages aux adresses externes au serveur
Impossible d'envoyer des messages des serveurs spcifiques, comme Google ou Yahoo.
Impossible de recevoir les messages d'autres serveurs
Mon serveur indique "mot de passe incorrect"
Outlook plante ou affiche un message d'erreur
Quelqu'un semble envoyer un spam sur mon serveur
hMailServer ne peut pas se connecter la base de donnes
PHPWebAdmin ne fonctionne pas
Messages d'erreur
Si vous recevez un message d'erreur de hMailserver lorsqu'un problme se produit, vous pouvez
consulter la rubrique messages d'erreur. Ce document contient une liste avec description des
messages d'erreur gnrs par hMailServer.
Ports bloqus
95 / 214
Dpannage des ports bloqus
Si vous ne pouvez pas recevoir les messages d'autres serveurs, et que vous tes sr que vos
enregistrements MX sont dfinis correctement, essayez ce qui suit: De l'extrieur de votre rseau,
rglez votre ordinateur telnet sur le port 25. Si cela choue, un logiciel ou un matriel bloque la
connexion sur votre port 25.
Raisons possibles:
Vous n'avez pas ouvert le port 25 dans votre pare-feu.
Un routeur / commutateur de votre rseau qui reoit le trafic d'Internet ne transfert pas le trafic
vers l'ordinateur o s'excute hMailServer.
Votre FAI (Fournisseur d'Accs Internet) bloque le port 25 pour le trafic entrant.
Le pare-feu de Windows XP SP2 est activ par dfaut, et peut bloquer les connexions entrantes.
Les versions prcdentes de XP possdent aussi un pare-feu intgr, mais il ets dsactiv par
dfaut. Si vous tes sr que vous n'avez pas bloqu le port 25 dans votre pare-feu, et que vous
ne pouvez toujours pas vous connecter sepuis l'extrieur de votre rseau, demandez votre FAI
s'il a bloqu le port 25. Certains FAI bloquent les ports du serveur (e-mail, FTP et HTTP) car ils ne
souhaitent pas que leurs utilisateurs installent des serveurs.
Autres solutions
Si votre FAI a bloqu le port 25, il existe des alternatives.
Connexion la base de donnes
Ouvrez le dossier Log de hMailServer dans l'Explorateur Windows. Ouvrez le fichier nomm
ERROR_*.log dans un diteur de texte et examinez les dernires lignes.
Error: Cannot connect to xx on host xx (Connexion impossible xx sur l'hte xx)
Raison: hMailServer ne peut pas se connecter la base de donnes.
Error: Cannot open requested database (Impossible d'ouvrir la base de donnes requise)
Raison: Vrifiez que la base de donnes spcifie dans hMailServer.ini existe et que l'utilisateur
qui essaie de s'y connecter les droits appropris pour son utilisation.
Connexion via le client de messagerie
Suggestions gnrales
Si vous ne pouvez pas vous connecter hMailServer en utilisant votre client de messagerie, les
causes les plus frquentes sont les suivantes:
Vous n'avez pas entr le nom d'hte correct du serveur de messagerie dans la configuration du
compte de votre client de messagerie.
Le nom d'hte que vous avez saisi dans votre client de messagerie ne rsout pas l'adresse IP de
l'ordinateur qui excute le serveur de messagerie.
Un pare-feu actif bloque le trafic vers hMailServer. Il peut s'agir d'un pare-feu logiciel ou matriel.
Trs souvent, les administrateurs du serveur n'ont pas ouvert les ports pertinents (typiquement
25, 110 et 143) dans le pare-feu de Windows XP.
La connexion Loopback n'est pas activ dans le routeur, ce qui fait que mme si vous vous
connectez une adresse IP publique correcte, et que le pare-feu est ouvert, votre routeur ne
transmet pas la connexion au serveur de messagerie puisque vous vous connectez l'intrieur du
rseau.
hMailServer n'est pas l'coute des ports TCP/IP. Dans la plupart des cas, ceci se produit si un
autre serveur de messagerie est en activit sur le mme ordinateur que hMailServer. Souvent, les
administrateurs du serveur ont choisi d'installer le serveur SMTP Microsoft IIS et l'ont oubli.
Lancez une commande Telnet depuis votre serveur sur les ports 25, 110 et 143 pour vrifier si un
autre serveur est l'coute sur ces ports.
Problmes de connexion depuis l'ordinateur o est install hMailServer
96 / 214
Vrifiez que vous pouvez lancer un ping depuis l'ordinateur sur lequel hMailServer s'excute.
Vrifier que le serveur de messagerie a rellement dmarr, en lanant une commande Telnet
depuis le serveur sur les ports 25 et 110. Dans hMailAdmin, cherchez les paramtres des plages IP
et vrifiez que vous n'avez pas dfini des plages IP qui rendent impossible l'envoi d'e-mail. Vous
pouvez spcifier le nombre maximum de connexions simultanes dans hMailAdmin. La valeur par
dfaut est 0 (illimites). Vrifiez que vous avez rgl cette valeur sur 0 ou sur une valeur leve.
Si ces conseils ne vous aident pas, faites ce qui suit:
1.Arrtez le serveur.
2.Activez la journalisation Application, Debug, SMTP, POP3 et IMAP.
3.Supprimez tous les anciens journaux du dossier Log (C:\Program Files\hMailServer\Logs)
4.Dmarrez le serveur
5.Essayez de vous connecter avec votre client de messagerie.
6.Crez une nouvelle rubrique dans le forum hMailServer et postez votre journal. Avant ceci,
vrifiez le journal pour tre sr que votre mot de passe n'y figure pas.
Problme seulement lors d'une connexion depuis un autre ordinateur
Vrifiez que les pare-feu ne bloquent pas les ports. De nombreux FAI, par exemple, bloquent le
port 25 tout trafic sortant, et ainsi peuvent bloquer la connexion votre serveur.
hMailServer choue pour distribuer les messages certains serveurs
Gnralits
Ce document couvre les problmes d'chec de hMailServer distribuer des messages un serveur
spcifique, comme par exemple Yahoo, Google ou Hotmail. Si vous avez essay d'envoyer des
messages plusieurs serveurs diffrents, mais qu'aucun ne fonctionne, vous devez lire cce qui
suit.
Enregistrements MX manquants
Si votre domaine aucun enregistrements MX, les autres serveurs de messagerie peuvent refuser
les messages de votre serveur. Si vous n'tes pas sr de savoir si votre domaine possde des
enregistrements MX, allez sur intoDNS.com, entrez votre domaine et cliquez sur DNS Report ou
contactez la socit qui a enregistr votre domaine.
Enregistrements DNS incorrects
Des entres DNS incorrectes ont pour effet que les autres serveurs de messagerie n'acceptent
pas les messages de votre domaine. Pour vrifier si vos enregistrements DNS sont corrects, allez
surintoDNS.com, entrez votre domaine et cliquez sur DNS Report.
Votre IP ne correspond pas votre enregistrement SPF
Si des enregistrements SPF sont dfinis dans les DNS de votre domaine, vous devez vrifier que
vous distribuez des messages partir de l'adresse IP spcifie dans vos enregistrements SPF. Si
vous envoyez partir d'autres adresses IP, de nombreux refuseront vos e-mails.
Nom d'hte incorrect dans HELO
Dans la configuration SMTP de hMailServer, vous devez spcifier le nom d'hte de l'ordinateur sur
lequel vous excutez hMailServer. Ce doit tre un nom d'hte qui a un enregistrement A dans le
DNS qui pointe sur l'adresse IP de votre ordinateur. Si vous entrez un autre nom d'hte, comme
localhost, mycomputername, de nombreux serveurs refuseront les messages de votre serveur.
97 / 214
Adresse d'expditeur vide non autorise
Dans la configuration SMT de hMailServer, vous pouvez choisir de ne pas autoriser les messages
dont l'adresse de messagerie d'expditeur est vide. Par dfaut, c'est autoris, et de nombreux
serveurs de messagerie refuseront le smessages de votre serveur si vous dsactivez cette option.
Votre adresse IP est sur liste noire.
Si un spam a t envoy partir de votre adresse IP, celle-ci peut se retrouver dans une liste
noire. Si le serveur des destinataires vrifie cette liste noire, il peut refuser vos e-mails. Sur http://
blacklistalert.org/ vous pouvez vrifier si votre adresse IP est dans une liste noire commune.
Filtre personnalis
Le serveur des destinataires peut utiliser un filtre personnalis qui gre un certain type de spam
comme voqu ci-dessus.Le seul moyen d'tre sr de cela est de contacter l'administrateur du
serveur distant et de lui demander pourquoi vos messages sont refuss. Si vous pouvez envoyer
aux autres serveurs et pas ce serveur spcifique, et que les conseils prcdents n'apportent
pas de solution, ii est conseill de contacter l'administrateur du serveur distant.
Problmes MX
Qu'est-ce que MX?
MX est l'abrviation de Mail Exchanger et est utilis par tous les serveurs de messagerie lors de
l'envoi d'e-mails. Il est utilis par hMailServer lorsqu'il envoie un message un domaine externe,
et est utilis par les domaines externes lorsqu'ils envoient des messages hMailServer. Les
enregistrements MX sont stocks sur les serveurs DNS.
Comment fonctionne t-il?
Supposons que vous souhaitiez envoyer un e-mail webmaster@undomaineexterne.com. Si vous
cliquez sur Envoyer dans votre client de messagerie, il sera d'abord prsent et enregistr dans la
base de donnes de hMailServer. Celui-ci contacte alors le serveur DNS pour obtenir l'IP du
serveur responsable de la manipulation du message pour le domaine, undomaineexterne.com. Le
serveur DNS rpond avec l'adresse IP du serveur. hMailServer se connecte cet IP et envoie le
message.
Le mme processus se produit dans l'autre sens. Si vous envoyez un e-mail via votre FAI
hMailServer, votre FAI contactera le serveur DNS pour obtenir l'adresse IP du serveur responsable
de la manipulation du message pour le domaine, votre-domaine-hmailserver.com. Le serveur DNS
rpondra avec l'adresse IP de votre ordinateur, celui sur lequel est situ hMailServer. Le serveur
de messagerie de votre FAI se connecte alors cet IP.
Comment le serveur DNS connat-il l'IP de votre ordinateur?
Il vous faut configurer votre DNS pour le savoir. Le serveur DNS responsable des questions-
rponses concernant votre domaine doit possder un enregistrement MX. Si vous possdez un
domaine, vous devez avoir accs un panneau de contrle dans lequel vous pouvez spcifier
l'adresse IP pour l'enregistrement MX. Si vous n'avez pas accs un panneau de contrle DNS,
contactez la socit qui a enregistr votre domaine et demandez lui d'ajouter un enregistrement
MX avec votre IP.
Il n'est pas suffisant de seulement faire pointer votre nom de domaine sur votre adresse IP. Le
fait que votre nom de domaine dcide de votre adresse IP ne fait pas fonctionner votre
messagerie; l'enregistrement MX doit aussi dcider de l'adresse IP correcte. Un domaine peut
avoir plusieurs enregistrements MX (si vous excutez, pour des raisons de sauvegarde par
98 / 214
exemple, plusieurs serveurs de messagerie pour un seul domaine).
Comment puis-je configurer les enregistrements MX?
Normalement, l o vous enregistrez votre domaine, vous pouvez aussi ajouter les
enregistrements MX via une interface web . Si vous n'avez accs aucune interface web pour
votre domaine, vous devez contacter les gens qui ont enregistr votre domaine, et leur demander
de configurer un enregistrement MX pour vous. Configurer un enregistrement MX ne prend que
quelques minutes au plus. En fait, si vous tes chanceux, ils le feront gratuitement.
Nslookup est un programme en ligne de commande qui interroge les serveurs DNS pour plus
d'informations. Vous pouvez faire toutes sortes de requtes DNS en utilisant nslookup. Le
paragraphe ci-dessous indique comment effectuer une recherche MX. Lancez l'invite de commande.
Entrez nslookup -type=mx votrenomdedomaine.com et appuyez sur Entrer.
(Exemple: nslookup -type=mx hmailserver.com)
La rponse devrait ressembler :
C:\Documents and Settings\votre-nom d'utilisateur>nslookup -type=mx
votrenomdedomaine.com
Server: your-isp-dns-host
Address: your-isp-dns-ip
Non-authoritative answer:
votrenomdedomaine.com MX preference = 10, mail exchanger =
mail.votrenomdedomaine.com
(la ligne ci-dessus est votre MX exchanger)
votrenomdedomaine.com nameserver = your-dns-host-name
votrenomdedomaine.com nameserver = your-dns-host-name
mail.votrenomdedomaine.com internet address = your-mail-server-ip
ns2.yourdns.com internet address = your-dns-ip
ns1.yourdns.com internet address = your-dns-ip
Si la rponse n'inclut pas un enregistrement MX, c'est que vous n'avez dfini aucun
enregistrement MX pour le domaine.
Port SMTP non par dfaut
Les e-mail envoys entre serveurs de messagerie sont toujours envoys sur le port 25. Ce qui
n'est pas configurable et ce qui est pareil pour tous les serveurs de messagerie. Si vous changez
le port SMTP pour autre chose que 25, les autres serveurs ne pourront pas vous envoyer des
messages. Sauf si, vous avez mis en place une sorte de transfert de port.
Si votre FAI a bloqu le port 25 pour le trafic entrant dans son pare-feu, ou si vous ne pouvez pas
utiliser le port 25 pour une raison quelconque, deux solutions sont possibles:
Changer de FAI
ou
Utiliser un service de routage. Il existe des socits qui proposent d'accepter les e-mails pour
votre domaine sur le port 25 et ainsi de les transfrer sur votre hMailServer via un port SMTP non
standard qui n'est pas bloqu par votre FAI.
Plantages Outlook
L'implmentation IMAP d'Outlook 2003 se comporte de faon lgrement diffrente de
l'implmentation IMAP des autres clients de messagerie. Il existes des problmes avec Outlook et
qui ne sont pas spcifiques hMailServer. Ils se produisent sans rapport avec le serveur IMAP que
vous utilisez.
Outlook 2003 tombe parfois en panne s'il ne peut pas se connecter au serveur IMAP. Il s'agit d'un
bug d'Outlook qui n'a rien voir avec hMailServer.
Outlook 2003 peut parfois afficher un message d'erreur qui indique qu'il ne peut pas ouvrir le
dossier nomm Null. Pour certaines raisons, les versions internationales d'Outlook utilisent des
noms internationaux pour le dossier INBOX, mme si la spcification IMAP prcise que le nom doit
toujours tre INBOX. Pour contourner le comportement d'Outlook, accdez Outils->Comptes e-
mail->Affichage, ou changer le compte. Dans les proprits du compte IMAP, cliquez sur Plus de
Paramtres, slectionnez Avanc et entrez INBOX comme chemin du dossier Racine. Ce champ de
saisie n'est pas disponible pour la version anglaise d'Outlook.
99 / 214
Problmes d'installation de PHPWebAdmin
Gnralits
Cette section dcrit les erreurs courantes d'installation de PHPWebAdmin.
Installation de base
Lorsque vous mettez niveau votre installation de hMailServer pour une nouvelle version, vrifiez
bien que vous copiez lla version la plus rcente de PHPWebAdmin, depuis le dossier d'installation
de hMailServer vers le dossier web. Ignorer cette procdure peut empcher PHPWebAdmin de
fonctionner.
Paramtres de config.php
Lorsque vous spcifiez les chemins et les URL dans le fichier config, il est trs important d'utiliser
le /, et pas l'antislash \ comme sparateur de dossier. Il est galement trs important de terminer
chaque chemin et chaque URL par un /.
Paramtres de PHP.ini
Editing the wrong PHP.ini
Une cause courante de problmes est l'dition du fichier PHP.ini dans le mauvais dossier.
Lorsqu'un script PHP est excut, aucune erreur n'est rapporte si le fichier PHP.ini est
introuvable. Certains utilisateurs ditent parfois un PHP.ini dans un dossier spcifique et, par la
suite, il s'avre que PHP essaie de lire le fichier partir d'un autre dossier. Pour vrifier le fichier
PHP.ini qui ets utilis, suivez ces tapes:
1.Crez un nouveau fichier nomm test.php dans votre dossier web racine.
2.Ajoutez le code suivant au fichier:
<?php phpinfo();?>
3.Accdez au script PHP via votre navigateur web (http://www.example.com/test.php)
4.Vrifiez la valeur du paramtre Configuration File (php.ini) Path au dbut du fichier.
Le rapport d'erreur n'est pas activ
Si vous obtenez une page vierge lors de l'ouverture de PHPWebAdmin, il est probable que le
rapport d'erreur n'est pas activ dans php.ini. Activez le rapport d'erreur pour faciliter le
dpannage. Vrifiez que error_reporting n'est pas comment et qu'il est dfini sur E_ALL. Si vous
n'excutez aucun autre script PHP sur le serveur, rglez display_errors sur On. Si vous excutez
d'autres scripts PHP, il est probable que vous ne souhaitez pas afficher les erreurs dans votre
navigateur web et que vous prfrez consulter le journal PHP pour prendre connaissance des
erreurs rapportes.
DCOM n'a pas t activ
PHPWebAdmin utilise l'API COM de hMailServer pour accder aux paramtres et objets de votre
installation hMailServer. Pour que cela fonctionne, il peut tre ncessaire d'activer DCOM dans la
configuration PHP. Vrifiez que com.allow_dcom = true existe dans php.ini et qu'il n'est pas
comment.
Dossier de session non cr
100 / 214
Si PHP est configur pour utiliser des sessions, vous devez vrifier que session.save_path n'est
pas comment et qu'il prsente une valeur valide. Vous devez aussi vrifier que votre navigateur
web possde le droit en criture dans ce dossier. Par exemple, si vous utilisez Microsoft IIS,
l'utilisateur IUSR_[computername] ncessite write-permissions sur ce dossier.
Autres problmes de permission
Si vous utilisez Microsoft SQL Server pour hMailServer, vous devez accorder l'utilisateur
IUSR_[computername] les droits d'accs la base de donnes de hMailServer.
Si vous utilisez IIS, ou Apache sous un utilisateur ddi, vous devez accorder l'accs du service
du compte la bibliothque COM de hMailServer.
Serveur utilis pour les spams
Contexte
C'est un problme assez frquent que les spammeurs utilisent le serveur d'autres personnes pour
transmettre des messages de spam. hMailServer n'autorise pas ceci par dfaut, mais si vous avez
configur hMailServer de faon incorrect, ou si vous utilisez un mot de passe faible pour vos
comptes de messagerie, il sera assez facile pour les spammeurs d'agir de la sorte.
Comment puis-je le savoir avec certitude?
Vrifiez d'abord la file d'attente de distribution de hMailServer. Si la file d'attente contient un
grand nombre de messages de l'extrieur vers d'autres adresses externes, il est probable que
quelqu'un abuse de votre serveur pour envoyer des spams. Ainsi, si vous ne reconnaissez pas
l'adresse des expditeurs ou l'adresse des destinataires, ce sont probablement des spams.
Une autre mthode consiste envoyer une commande telnet relay-test.mail-abuse.org partir
de l'ordinateur qui excute hMailServer. Le serveur distant se reconnectera automatiquement au
serveur de messagerie qui s'excute sur votre ordinateur et effectuera quelques tests pour
vrifier si votre ordinateur peut tre utilis pour l'envoi de spams.
Vrifiez aussi votre dossier data. Si ce dossier (pas le sous-dossier) contient de nombreux fichiers
.ema, disons plus de 250, mme si personne n'est en train d'envoyer des messages via votre
serveur, il est probable que quelqu'un utilise votre serveur pour envoyer des spams.
Une quatrime mthode consiste utiliser d'autres tests de relais ouvert.
Que puis-je faire?
Tout d'abord:
Examinez la configuration de votre plage IP et vrifiez bien que vous demandez une
authentification. En gnral, dans la plage IP Internet, hMailServer doit tre configur pour exiger
l'authentification SMTP pour les distributions aux comptes externes.
Ne jamais permettre la distribution de comptes externes vers des comptes externes. Vrifiez
toutes vos plages d'adresses IP.
Si vous tes certain que la distribution externe vers externe n'est pas autorise dans aucune de
vos plages IP, et que vous avez vrifi que vous demandez une authentification pour distribuer
vers des comptes externes, cela signifie probablement qu'un spammeur l'un de vos comptes du
serveur pour envvoyer des spams. Dans la plupart des cas, lorsque cela se produit, l'utilisateur a
choisi un mot de passe faible comme "test" ou "secret". Ainsi, vous devez dtecter les comptes
qui vous envoient ces messages:
1.Activez Application et journalisation SMTP. N'activez que ces deux lments. Activer davantage
d'lments rendra plus difficile l'analyse des journaux
2.Attendez quelques minutes que le spammeur envoie un autre e-mail sur votre serveur. Surveillez
la file d'attente des "Undelivered messages" et notez l'adresse de l'expditeur et celle du
destinataire de l'un des spams.
3.Recherchez l'adresse des expditeurs dans le journal hMailServer.
Le journal contiendra dsormais des infos concernant la personne qui essaie de vous envoyer des
spams. Vous verrez une section qui ressemble ceci: (les premires colonnes sont laisss de ct
101 / 214
pour rendre le texte plus facile lire)
"<spammers IP address>" "SENT: 220 <your-host-name> ESMTP"
"<spammers IP address>" "RECEIVED: EHLO <spammers-host-name>"
"<spammers IP address>" "SENT: 250-hmailserver[nl]250-SIZE[nl]250 AUTH
LOGIN"
"<spammers IP address>" "RECEIVED: AUTH LOGIN"
"<spammers IP address>" "SENT: 334 VXNlcm5hbWU6"
"<spammers IP address>" "RECEIVED: dGVzdEB0ZXN0LmNvbQ=="
"<spammers IP address>" "SENT: 334 UGFzc3dvcmQ6"
"<spammers IP address>" "RECEIVED: ***"
"<spammers IP address>" "SENT: 235 authenticated."
"<spammers IP address>" "RECEIVED: MAIL FROM: <sender-address@example.com>"
"<spammers IP address>" "SENT: 250 OK"
"<spammers IP address>" "RECEIVED: RCPT TO: <recipient-
address@example.com>"
"<spammers IP address>" "SENT: 250 OK"
"<spammers IP address>" "RECEIVED: DATA"
"<spammers IP address>" "SENT: 354 OK, send."
"<spammers IP address>" "SENT: 250 Queued (0.000 seconds)"
"<spammers IP address>" "RECEIVED: QUIT"
"<spammers IP address>" "SENT: 221 goodbye"
Les lignes intressantes ici sont dans la section suivante:
"<spammers IP address>" "SENT: 334 VXNlcm5hbWU6"
"<spammers IP address>" "RECEIVED: dGVzdEB0ZXN0LmNvbQ=="
"<spammers IP address>" "SENT: 334 UGFzc3dvcmQ6"
Ces lignes contiennent une version code des informations de connexion utilises par le
spammeur. Le texte est cod en utilisant Base64 et peut tre dcod en utilisant n'importe quel
dcodeur base64. En clair, il indique
"<spammers IP address>" "SENT: 334 Username:"
"<spammers IP address>" "RECEIVED: test@test.com"
"<spammers IP address>" "SENT: 334 Password:"
Ainsi, dans cet exemple, le spammeur est authentifi l'aide de test@test.com, et a envoy un
message partir de sender-address@example.com. Dsormais, quand vous savez de quel compte
le spammeur a abus, vous pouvez dsactiver le compte, ou choisir un meilleur mot de passe.
Lancer lee serveur
Services Terminal Server
La raison la plus courante de l'chec du dmarrage de hMailServer, c'est que les services Terminal
Server sont utiliss. L'installation du logisiel hMailServer cre un fichier dans le dossier de
Windows nomm hMailServer.ini. Le fichier est cr dans le dossier rel de Windows,
C:\Windows. Cependant, lorsque le service est lanc, Windows prtend que le dossier Windows
est situ dans C:\Documents And Settings\Username\Windows. Il en rsulte que hMailServer
essaie de lire partir de ce fichier. Comme ce fichier n'existe pas, le dmarrage du service
hMailServer choue (hMailServer 4.0 et suprieur placent le fichier hMailServer.ini dans le dossier
Bin de hMailServer pour viter ce problme).
Les ports sont en cours d'utilisation
Une autre raison courante pour que hMailServer ne dmarre pas est qu'un autre logiciel peut
utiliser les ports TCP/IP ncessaires hMailServer. Certaines versions de Windows possdent, par
dfaut, un serveur de messagerie intgr. Il est extrmement lger. Sous Windows 2000/XP, il
n'inclut que SMTP (pas POP3), et sous Windows 2003, il n'inclut pas IMAP. Ce serveur intgr peut
occuper le port ncessaire hMailServer.
102 / 214
Si hMailServer s'arrte immdiatement aprs son dmarrage, la premire chose faire est de
vrifier l'Observateur d'Evnements Windows. L'Observateur d'Evnements Windows se trouve
dans le dossier Outils d'Administration du Panneau de Configuration. hMailServer rapporte ici
toutes les erreurs fatales. Si le serveur ne dmarre pas ou si elle s'arrte de manire inattendue,
c'est le premier endroit examiner.
Si l'Observateur d'Evnements Windows ne vous aide pas, essayez d'envoyer une commande
telnet sur le port 25. Lorsque vous vous connectez, un message indiquera le serveur de
messagerie que vous utilisez. Reprez ce serveur de messagerie dans l'applet Services du
Panneau de configuration et arrtez / dsactivez-le. Si aucun message d'erreur n'apparat, vrifiez
que vous n'utilisez pas actuellement un examen antiviral du message.
Mot de passe erron
Dans votre client de messagerie, vous devez indiquer votre adresse de messagerie complte
comme nom d'utilisateur. Si votre adresse de messagerie est user@domain.com, vous devez
spcifier user@domain.com comme nom d'utilisateur.
Maintenance
Database maintenance
Maintenance de la base de donnes
Contexte
Il existe une limitation intgre hMailServer qui se produit lorsque 2 milliards de messages ont
travers le serveur.
Chaque message dans une installation de hMailServer possde un identifiant numrique unique.
Lorsque le premier message est reu dans une installation de hMailServer, il reoit l'ID1.
Lorsqu'il est copi dans la bote de rception des destinataires, il reoit l'ID2.
S'il est copi dans un autre dossier IMAP par l'utilisateur, il reoit l'ID3.
Cet ID de message est utilis dans la communication avec les clients IMAP. Le protocole
IMAPspcifie que cette valeur ne doit jamais dpasser les 4 milliards. Ce qui signifie que si vous
recevez 2 milliards de messages, vous atteignez cette limite. Si vous utilisez IMAP, vous atteignez
la limite plus vite car un message reoit un nouvel ID lorsqu'il est copi dans un nouveau dossier.
Dterminer la situation actuelle
Si vous voulez dterminer la situation en cours, vous pouvez excuter l'instruction SQL suivante
dans la base de donnes hMailServer. Elle vous indiquera l'ID de message le plus lev
actuellement attribu dans votre base de donnes.
select max(messageid) from hm_messages
Si cette valeur dpasse 4 000 000 000, vous allez bientt rencontrer ce problme.
Sauvegarde & Restauration
Gnralits
hMailServer propose un outil intgr qui peut tre utilis pour la sauvegarde et la restauration.
Cependant, cet outil est conu seulement pour fonctionner sur des toutes petites installations
103 / 214
avec moins de 1Go de donnes. Pour les installations plus importantes, vous devez utiliser un outil
externe.
Que sauvegarder?
Diffrents lments sont sauvegarder:
La base de donnes. Elle contient toutes les donnes de configuration et les liens qui pointent
vers les messages enregistrs sur votre disque dur. Le meilleur moyen de sauvegarder la base de
donnes est d'utiliser mysqldump ou, si vous utilisez Microsoft SQL Server, l'outil de sauvegarde
MS SQL intgr.
Le dossier data. Le dossier data contient les messages en cours. Ceux qui n'ont pas encore t
distribus, et ceux que vous avez enregistrs dans les dossiers IMAP. Le moyen le plus simple de
sauvegarder le dossier data est d'utiliser xcopy de MS-DOS.
Autres fichiers. Vous pourriez aussi sauvegarder le dossier Events (hMailServer version 4.0 et
suprieur), le fichier hMailServer.ini, le dossier log, etc.
Sauvegarde intgre
hMailServer 4.2 et suprieur incluent un outil de sauvegarde intgr. Dans les paramtre de
sauvegarde de hMailAdmin, vous pouvez dfinir le type d'objets sauvegarder. La fonctionnalit
de sauvegarde intgre est conue pour les petites installations. Si vous avez plus de 50 comptes
ou 10 000 messages sur le serveur, nous vous conseillons d'utiliser un outil externe pour ce faire.
Sauvegarde chaud
Il est possible de sauvegarder hMailServer pendant que le serveur est en activit. Cependant, si
vous le faites, il existe un risque que certaines donnes ne soient pas sauvegardes. Scnario
typique: vous essayez de sauvegarder quand hMailServer n'a que partiellement reu un message.
Si vous voulez tre sr que tout est sauvegard, arrtez le serveur avant le processus de
sauvegarde.
Robocopy
(version GUI) effectue tout ce que peut effectuer
xcopy
, mais il peut aussi "synchroniser",
ou crer une copie miroir de deux dossiers, et ainsi ne copier que les diffrences. Pour aller plus
vite, vous pouvez copier les fichiers dans un dossier de sauvegarde par la voie habituelle pendant
que le service hMailServer est actif. A un moment plus opportun, vous arrtez le service et vous
utilisez nouveau
robocopy
. Cette seconde dopie sera plus rapide car seuls les changements
seront copis. Ce qui peut aider conomiser du temps. Cependant, sachez que
robocopy
peut
entraner un dsastre si vous ne l'utilisez pas avec les bons commutateurs. Consultez
soigneusement sa documentation avant de l'utiliser.
Sauvegarde planifie
Dans le dossier Addons de hMailServer, vous trouverez un script VBA nomm StartBackup.vbs.
Pour excuter ce script, vous devez l'diter et entrer votre mot de passe d'administration
hMailServer principal. Quand c'est fait, vous pouvez lancer une sauvegarde en double-cliquant sur
le fichier VBA. Vous pouvez utiliser le Gestionnaire de Tches de Windows pour planifier la
sauvegarde excuter un moment spcifi.
Recommandations
Indpendamment de la faon dont vous effectuez la sauvegarde, il est fortement recommand de
vrifier rgulirement que les sauvegardes fonctionnent correctement en les restaurant sur un
autre serveur.
Migrer sur un nouveau serveur

104 / 214
Gnralits
Ce document dcrit comment dplacer hMailServer d'un serveur physique un autre. La procdure
se droule en six tapes:
1.Vrifiez la configuration ncessaire
2.Installez hMailServer sur le nouveau serveur
3.Sauvegardez votre systme
4.Dplacez les donnes
5.Vrifier la configuration TCP/IP adapte
6.Confirmez la migration
Si c'est la premire fois que vous suivez ces tapes, il est recommand de le faire d'abord avec
une installation d'essai avant de passer une installation de production. Il s'agit de s'assurer que
vous comprenez exactement ce que vous devez faire.
Etape 1 - Vrifier la configuration ncessaire
Avant de commencer dplacer votre installation de hMailServer sur un nouveau serveur, vous
devez vrifier que le nouveau serveur rpond la configuration ncessaire pour hberger
hMailServer. En plus de la configuration standard, les lments suivant s'appliquent aussi lors de
la migration:
Chemin du dossier data
La base de donnes de hMailServer contient des liens vers les fichiers message sur le disque dur.
Pour chaque message de la base de donnes, le chemin complet du fichier sur le disque dur est
spcifi. Ce qui signifie que lorsque vous migrez sur un autre serveur, le dossier Data doit tre
plac au mme emplacement que pour que la migration russisse. Si le dossier Data est plac sur
un autre lecteur, par exemple D: au lieu de C:, hMailServer ne pourra plus trouver les messages
aprs la migration.
Etape 2 - Installer hMailServer sur le nouveau serveur
Avant de commencer la migration des donnes, vous devez installer hMailServer sur le nouveau
serveur. Il est essentiel que vous installiez la mme version de hMailServer que vous utilisiez sur
l'ancien serveur, et que vous l'installiez dans le mme dossier que sur l'ancien serveur. Si
hMailServer est install dans C:\hMailServer sur l'ancien serveur, vous devez l'installer dans le
mme chemin de dossier sur le nouveau serveur.
Etape 3 - Sauvegarder votre systme
Avant de sauvegarder votre systme, vous devez arrter votre service hMailServer pour tre sr
qu'aucun changement n'aura lieu au cours de la sauvegarde. Il est, bien entendu, recommand
d'informer temps vos utilisateurs avant d'effectuer ces processus.
La configuration de hMailServer et les donnes seront copies manuellement de l'ancien serveur
vers le nouveau serveur. La sauvegarde ne sera ncessaire que si quelque chose se passe mal au
cours du processus de copie afin de pouvoir restaurer les donnes sur l'ancien serveur.
Etape 4 - Dplacer les donnes
Trois lments sont ncessaires copier:
Le dossier Data
105 / 214
Le dossier data contient tous les messages et doit tre copi de l'ancien serveur sur le nouveau
(sauf s'ils sont situs sur un SAN accessible par les deux serveurs). Il est important de copier les
fichiers dans le mme dossier sur le nouveau serveur que sur l'ancien. Si les fichiers sont placs
sur C:\Program Files\hMailServer\Data sur l'ancien serveur, ils doivent tre situs au mme
emplacement sur le nouveau serveur.
Personnalisation
Toute personnalisation que vous pouvez avoir effectu dans hMailServer doit tre copie de
l'ancien serveur vers le nouveau. Cela consiste gnralement en des modifications apportes au
fichier de script hMailServer.
Base de donnes
Les tches impliques cette tape dpendent du type de serveur base de donnes que vous
utilisez.
MySQL intgre
Si vous utilisez le serveur MySQL intgr, vous pouvez copier les dossiers entiers de donnes
MySQL de l'ancien serveur vers le nouveau serveur. Si vous pratiquez ainsi, vous devez galement
copier le mot de passe de base de donnes de hMailServer.ini depuis l'ancien serveur vers le
nouveau serveur afin que hMailServer puisse se connecter sur le serveur de base de donnes.
Avant de copier les dossiers, assurez-vous que MySQL et le service hMailServer soient arrts.
Serveur MySQL externe
Une mthode consiste supprimer la base de donnes de hMailServer sur le nouveau serveur et
de copier la base de donnes hMailServer de l'ancien serveur vers le nouveau, ou d'exporter la
base de donnes de l'ancien serveur puis de l'importer sur le nouveau.
Serveur SQL
Si vous souhaitez dplacer votre base de donnes hMailServer une nouvelle installation de
Microsoft SQL Server, une mthode consiste sauvegarder la base de donnes et la restaurer
sur le nouveau serveur. Si vous avez cr des utilisateurs et des connexions spcifiques
hMailServer, vous devez vous assurer qu'ils existent toujours et sont configurs correctement sur
la nouvelle installation
Etape 5 - Configuration adapte TCP/IP
Aprs avoir dplac les donnes, pensez :
Actualiser tout enregistrement MX qui pointait sur l'ancien nom d'hte.
Actualiser le nom d'hte dans votre configuration de hMailServer (en cas de modification)
Vrifier que votre pare-feu de Windows ne bloque pas le trafic vers hMailServer
Etape 6 - Confirmer la migration
Confirmer que vous pouvez envoyer des e-mails votre serveur depuis un serveur externe
Confirmer que vous pouvez vous connectez au nouveau serveur et accder vos messages
Informer vos utilisateurs que la migration est termine, et demandez-leur (si ncessaire) de
mettre jour leur client de messagerie avec les nouvelles informations d'hte.
Autres
propos des destinataires du message
106 / 214
Contexte
Pour un e-mail, il ya deux listes distinctes de destinataires du message. Il y a une liste qui dfinit
qui le message qui doit tre distribu, et une liste qui est affiche aux bnficiaires dans leurs
clients de messagerie.
La liste qui dfinit qui le message doit tre distribu, les destinataires de l'enveloppe SMTP, n'a
pas correspondre aux destinataires affichs dans les clients de messagerie (destinataires de
l'en-tte MIME).
Si, par exemple, vous envoyez un e-mail utilisateur1@example.com et que vous placez
utilisateur2@example.com dans le champ BCC, les utilisateurs seront dans la liste de l'enveloppe
des destinataires SMTP, mais seul utilisateur1@example.com sera plac dans le champ des
destinataires de l'en-tte MIME. Ce qui fait que le serveur de messagerie sait o distribuer le
message, mais les destinataires ne verront pas usertwo@example.com dans leur client de
messagerie.
Les informations ci-dessus s'appliquent de faon tout fait similaire aux adresses des
expditeurs. Un message possde une enveloppe d'adresse d'expditeur SMTP et une adresse
dans le champ De dans l'en-tte MIME. Ces deux adresses n'ont pas correspondre. Vous pouvez
envoyer un e-mail partir de votre propre adresse, mais avec quelquundautre@example.com
dans l'en-tte De, la rendant ainsi visible du destinataire qui le message a t envoy avec
quelquundautre@example.com.
Ceci doit tre pris en compte lors du paramtrage des rgles, des scripts et lotrs d'un dpannage.
Les spammeurs envoient parfois des messages avec des bnficiaires d'en-tte MIME ne
correspondant pas aux destinataires de l'enveloppe SMTP. Cela peut entraner l'illusion que vous
avez reu un e-mail qui ne vous a pas t envoy. Vous pouvez tre le destinataire de l'enveloppe
SMTP - le destinataire rel - mme si vous ne figurez pas dans les en-ttes MIME.
Exemples
Exemple 1:
Le fait que vous voyez votre propre adresse e-mail dans le champ De de votre client de
messagerie ne signifie pas que l'e-mail a t envoy partir de votre compte. Cela signifie
simplement que l'expditeur du message voulait que votre adresse soit dans le champ De.
Exemple 2:
Lorsque vous dfinissez une rgle pour transfrer un message, le message transfr aura un
mme en-tte A mais une liste de destinataires diffrente. Ce qui est d au fait que les
destinataires du message changent, mais pas le contenu rel du message.
Exemple 3:
Si vous recevez un message de spam adresse au quelquundautre@example.com, cela signifie
que le spammeur a voulu vous envoyer un e-mail, mais il voulait le faire apparatre comme ayant
t envoy quelquundautre@example.com.
Mthodes Anti-spam
Anti spam methods
107 / 214
hMailServer propose un certain nombre de fonctionnalits anti-spam que vous trouverez dans
hMailServer Administrator, sous Configuration -> Anti-spam. Cette section dcrit les diffrentes
options.
SPF
SPF signifie Sender Policy Framework (Cadre Stratgique de l'Expditeur). Les propritaires de
domaine peuvent, au moyen d'un enregistrement de texte dans leur DNS, identifier les serveurs
de messagerie qui sont autoriss envoyer des courriels partir de leur domaine. Si vous activez
SPF dans hMailServer, hMailServer vrifie si l'adresse IP de l'expditeur correspond l'adresse IP
de l'enregistrement texte du DNS. Sinon, le message sera considr comme tant indsirable.
Vous en saurez plus sur SPF en consultant la page http://spf.pobox.com/. hMailServer ne traite
que les rsultats SPF FAIL comme spam.
Vrifier l'hte dans la commande HELO
Lorsqu'un autre serveur de messagerie distribue un e-mail hMailServer, il doit s'identifier en
envoyant son propre nom d'hte. Si vous avez configur hMailServer pour vrifier l'hte dans la
commande HELO, hMailServer fera une recherche DNS et confirmera que le serveur d'envoi a
donn un nom d'hte correct.
L'inconvnient de cette mthode est le risque de faux positifs. Bien que cette mthode peut tre
utilise pour dtecter les spams, beaucoup de propritaires de domaines lgitimes ne configurent
pas correctement leur serveur.
Vrifier que l'expditeur a des enregistrements MX DNS
Si vous activez cette option, hMailServer va vrifier si le nom de domaine dans l'adresse email de
l'expditeur a des enregistrements MX DNS. Si, par exemple,,
bill@microsoft.com
vous envoie un
e-mail, hMailServer vrifiera si le domaine,
microsoft.com
, a des enregistrements MX DNS. Si c'est
le cas, le message est accept. Sinon, il sera abandonn (si le score de spam est au-dessus du
seuil d esuppression des spams). Certains spammeurs envoient des messages partir de faux
domaines qui n'existent pas. L'activation de cette option vite que hMailServer les accepte.
L'inconvnient de cette option est que le serveur peut refuser des messages lgitimes. Si, par
exemple, un message automatique est gnr par
cgi.domain.com
et que
cgi.domain.com
n'a pas
d'enregistrements MX valides, le message sera supprim (en supposant que le score de spam soit
suprieur au seuil de suppression).
SpamAssassin
SpamAssassin est un systme populaire anti-spam tierce partie. Il fait des centaines de contrles
sur le message pour dterminer s'il s'agit d'un spam.
Pour utiliser SpamAssassin avec hMailServer, vous devez installer SpamAssassin sparment.
Tarpitting
Tarpitting peut tre utilise pour ralentir la communication entre hMailServer et les spammeurs.
Certains spammeurs peuvent cesser d'envoyer des e-mails votre serveur s'il rpond trs
lentement leurs demandes. La fonction suppose que le spammeur envoie un e-mail plusieurs
destinataires sur le serveur pendant une session SMTP. Si le nombre de bnficiaires dpasse le
nombre de Tarpitting, hMailServer va retarder la rponse de chaque bnficiaire suivant, pour le
nombre de secondes spcifi.
Bien que cette mthode de spam arrte les spammeurs, elle peut galement entraner des
problmes pour les expditeurs de courriels lgitimes. Par consquent, l'utilisation de cette
mthode de protection anti-spam n'est pas encourage.
108 / 214
Listes noires DNS
Les listes noires sont des listes de serveurs de messagerie qui sont connus pour envoyer des
spams. Les listes noires sont entretenues par diffrentes organisations ou individus. Si vous
activez les listes noires dans hMailServer, chaque fois que hMailServer reoit un message
lectronique, il va vrifier l'adresse IP de l'expditeur par rapport aux listes noires que vous avez
choisi d'utiliser. Si l'adresse IP se trouve tre dans l'une des listes noires, hMailServer n'acceptera
pas le message.
Des statistiques diffrentes existent, mais on sait que les listes noires peuvent rduire vos spams
d'environ 15 25%, simplement sur la base de l'adresse IP de l'expditeur. Sachezque la liste
noire peut bloquer des messages lectroniques lgitimes, par exemple, si un spammeur utilise le
serveur de messagerie d'un FAI particulier, qu'il en obtient la liste noire, et qu'il utilise le mme FAI
que, les e-mails de vos amis seront galement bloques.
SURBL
Les SURBL diffrent des listes noires DNS en ce qu'ils sont utiliss pour dtecter les spams en
fonction de l'URL du corps du message (gnralement des sites web). Les SURBL ne sont pas
destins identifier les expditeurs de spam par leurs en-ttes de messages ou leurs adresses IP
de connexion. Au contraire, ils vous permettent d'identifier les messages par les sites de spam
mentionns dans leur corps de message. Cela signifie que lorsque vous avez activ SURBL,
hMailServer recherches les liens des messages. Si des liens sont trouvs, hMailServer contrle
avec le serveur SURBL si ces liens existent normalement dans les messages de spam.
Liste grise
Les listes grises vous permettent d'viter les spams en refusant temporairement les messages
vers votre serveur. Les listes grises bnficient du fait que, correctement configures, les serveurs
de messagerie vont tenter de renvoyer les messages plus tard, alors que les spammeurs
normalement abandonnent immdiatement si votre serveur refuse un e-mail.
Lorsqu'un expditeur tente de distribuer un message pour la premire fois votre serveur,
hMailServer enregistre l'adresse IP de l'expditeur, l'adresse de messagerie de l'expditeur et
l'adresse de messagerie du destinataire. Ces informations sont nommes un triplet. hMailServer
refusera le message et demandera gentiment serveur expditeur de ressayer ultrieurement.
La prochaine fois que le serveur d'envoi tentera de remettre un e-mail qui correspond au triplet,
hMailServer acceptera le message.
DKIM
DKIM, Domain Keys Identified Mail, est une mthode pour signer le contenu des messages. Le
destinataire peut vrifier que le message est envoy partir d'un serveur authentifi pour
envoyer partir du domaine des expditeurs, et que le contenu du message n'a pas t modifi
pendant le transit.
Si la vrification DKIM est active, hMailServer va chercher un en-tte de Signature DKIM pour
chaque message.Si l'en-tte est trouv, hMailServer va vrifier que le contenu du message
correspond la signature. Si aucun en-tte de Signature DKIM est inclus, aucune vrification DKIM
ne sera faite.
Ce test devrait dtecter peu de spams, car les spammeurs peuvent simplement ignorer mme l'en-
tte Signature DKIM.
SpamAssassin
hMailServer 5 et suprieur comprend un systme d'intgration de SpamAssassin. Toutefois, le
programme d'installation du hMailServer ne comprend pas SpamAssassin lui-mme. Ce qui signifie
que vous devez installer SpamAssassin sparment, avant d'installer hMailServer. Il est possible
109 / 214
d'utiliser hMailServer avec les ports Windows de SpamAssassin, comme sawin32, et les serveurs
de SpamAssassin s'excutant sur d'autres ordinateurs Linux.
Outils externes
Des outils externes, comme ASSP ou SpamAssassin, peuvent tre utiliss avec hMailServer pour
prvenir des spams. ASSP et SpamAssassin sont des logiciels dont le seul but est de dtecter si
un e-mail est un spam. Ils offrent donc une fonctionnalit beaucoup plus riche que la protection
anti-spam propose dans hMailServer.
Mise en cache
Gnralits
La communication entre hMailServer et la base de donnes peut tre un goulot d'tranglement
lorsque la charge est leve. Ainsi, afin d'amliorer la performance, un cache a t implment
avec hMailServer, afin d'viter certains accs la base de donnes en mettant en cache les objets
de base de donnes dans la mmoire des processus de hMailServer. Si un objet est mis en
mmoire cache, hMailServer n'a pas se connecter la base de donnes pour lire nouveau
l'objet. La fonction de mise en cache se trouve dans les paramtres avancs de hMailAdmin.
Comment cela fonctionne t-il?
Lorsque hMailServer doit consulte un objet partir de la base de donnes, il examine d'abord le
cache pour voir si l'objet y est prsent. Si c'est le cas, hMailServer vrifie depuis combien de temps
l'objet a t consult. Si ce laps de temps dpasse la dure de vie (TTL) dfinie pour ce type
d'objet, celui-ci sera supprim du cache. Si l'objet n'existe pas dans le cache, ou s'il existe dans le
cache mais qu'il est trop ancien, hMailServer consulte l'objet partir de la base de donnes et
actualise le cache. Si un objet est modifi ou supprim en utilisant PHPWebAdmin ou hMailAdmin,
l'objet sera immdiatement mis jour dans le cache. Si un objet est modifi ou supprim
directement dans la base de donnes par un outil tiers, l'objet sera mis jour dans la mmoire
lorsque son ge dpasse le TTL.
Seul un objet d'un type spcifique peut tre mis en cache. Par exemple, lorsque vous mettez en
cache l'objet Domaine, seul l'objet Domaine est mis en cache. Les sous-objets tels que les
comptes et les alias ne sont pas mis en cache avec le domaine.
La valeur du taux de succs
Le taux de succs vous informe du succs du cache, en montrant la frquence laquelle
hMailServer doit interroger la base de donnes pour un type d'objet de cache spcifique. Si le taux
de succs pour un type d'objet est de 70%, cela signifie que hMailServer trouve le type d'objet
dans la mmoire cache 70% du temps, et doit interroger la base de donnes seulement 30% du
temps. Augmenter le TTL d'un objet augmente habituellement le taux de succs. Lorsque
hMailServer recherche un objet et qu'il ne peut pas le localiser ni dans le cache, ni dans la base de
donnes, ceci ne compte pas comme un manque de cache, parce que l'objet ne pourrait jamais
tre dans le cache en premier lieu.
Changer la dure de vie
La valeur TTL par dfaut des objets est de 60 secondes. Il est difficile de donner une valeur
universelle de TTL qui fonctionne pour toutes les configurations de serveur. Par exemple, si vous
actualisez les domaines directement dans la base de donnes, et que vous le faites souvent, 10
secondes semble tre une bonne valeur. Si vous actualisez les domaines directement dans la
base de donnes, mais que vous le faites pas trop souvent, 60 secondes semble correct. Si vous
ne mettez jour les domaines qu'en utilisant PHPWebAdmin ou hMailAdmin, vous pouvez rgler le
TTL sur 3600 secondes (1 heure). hMailServer n'aura alors consulter les domaines partir la
110 / 214
base de donnes qu'une fois par heure.
Avantages
Consulter un objet partir de la mmoire consomme moins de ressources CPU qu' partir de la
base de donnes.
Lorsque hMailServer consulte un objet en mmoire, le serveur de base de donnes n'est pas
impliqu. Ce qui rduit l'utilisation du CPU du serveur de base de donnes.
Inconvnients
L'utilisation de la mmoire est toutefois lgrement augmente, mais que trs lgrement.
Si un objet est modifi ou supprim de la base de donnes l'aide d'un outil tiers, hMailServer ne
saura rien de celui-ci jusqu' ce que sa dure de vie soit dpasse.
Garder la cohrence du cache
Si un objet qui est modifi directement dans la base de donnes existe aussi dans le cache,,
hMailServer utilisera l'objet dans le cache, jusqu' ce qu'il expire. Ce qui peut tre gnant dans
certaines circonstances. Dans l'idal, hMailServer devrait toujours utiliser les donnes les plus
rcentes qui se trouvent dans la base de donnes, mais abaisser le TTL augmente les accs la
base de donnes. Il existe, nanmoins, trois faons de s'assurer que hMailServer obtient toujours
les donnes les plus rcentes de la base de donnes:
Dsactiver le cache. S'il n'existe aucun cache, hMailServer accdera directement la base de
donnes, et obtiendra ainsi les donnes les plus rcentes.
Ne pas actualiser directement la base de donnes. Si vous n'utilisez que hMailAdmin ou COM, le
cache sera toujours cohrent. Dans ce cas, utiliser une trs grande dure de vie est absolument
sans danger. C'est en fait l'approche privilgie, car vous pourrez profiter des avantages d'avoir
un cache, tout en vitant la plupart de ses inconvnients (sauf pour la consommation de
mmoire).
Si vous avez absolument besoin d'actualiser directement la base de donnes, dsactivez le
cache. Si vous dsactivez le cache avant de mettre jour la base de donnes directement, et que
vous r-activez ensuite le cache - les deux sont faisables via COM- vous n'aurez jamais de
problmes de cohrence; ce pourrait tre une meilleure approche que d'attendre l'expiration des
objets, selon ceux que vous actualisez. Bien sr, une approche plus radicale consiste arrter le
service de hMailServer pendant que la base de donnes est mise jour manuellement, et la
redmarrer la fin.
API COM
Gnralits
L'API COM de hMailServer vous permet d'crire vos propres scripts et applications qui s'intgrent
hMailServer. La plupart des objets de hMailServer sont accessibles en utilisant la bibliothque
COM. A titre d'exemple, hMailServer Administrator et PHP WebAdmin sont entirement bass sur la
bibliothque COM. En plus d'crire de telles applications, vous pouvez crire des scripts qui seront
automatiquement excuts lorsque certains vnements se drouleront. Par exemple, vous
pouvez crire un script qui filtre les messages avant qu'ils ne soient remis aux destinataires.
L'objet Application est l'objet racine du modle COM de hMailServers. En utilisant cet objet, vous
pouvez accder tous les objets et paramtres de hMailServer. Avant d'accder aux proprits et
mthodes de l'objet Application, vous devez appeler Application.Authenticate avec des
informations d'identification valides.
L'API de hMailServer se comporte comme la plupart des autres API COM, mais il ya certains
comportements particuliers qui se rapporte la gestion des exceptions et aux permissions.
111 / 214
Etapes fondamentales
Ce sont les tapes de base effectuer lorsque vous souhaitez accder l'API COM de
hMailServer.
1.Crer une instance de l'objet Application de hMailServer. Le moyen d'y parvenir dpend du
langage de programmation que vous utilisez. En VBScript, appelez
CreateObject("hMailServer.Application").
2.S'authentifier. Avant de pouvoir appeler d'autres mthodes dans l'API, vous devez vous
authentifier. Ce qui se fait en utilisant la mthode Authenticate() sur l'objet Application. Ceci est
ncessaire pour empcher les utilisateurs non autoriss d'accder votre installation de
hMailServer.
3.Appeler la mthode et utiliser les proprits ncessaires.
Journal des modifications
Pour une liste des changements dans API COM, consultez la rubrique Journal des Modifications
API COM
Rfrence
Objets Domain
o
Domains
o
Domain
Accounts
Account
IMAPFolders
IMAPFolder
o
Messages
o
Message
Attachments
Attachment
Recipients
Recipient
FetchAccounts
FetchAccount
Aliases
Alias
DistributionLists
DistributionList
DistributionListRecipients
DistributionListRecipient
DomainAliases
DomainAlias
Settings
o
AntiSpam
o
AntiVirus
o
Cache
o
BackupSettings
o
BlockedAttachments
o
BlockedAttachment
o
DNSBlackLists
o
DNSBlackList
o
GreyListingWhiteAddresses
o
GreyListingWhiteAddress
112 / 214
o
Language
o
Links
o
Logging
o
Routes
o
Route
RouteAddresses
RouteAddress
o
Scripting
o
SecurityRanges
o
SecurityRange
o
ServerMessages
o
ServerMessage
o
SURBLServers
o
SURBLServer
o
TCPIPPorts
o
TCPIPPort
o
Settings
o
Rules
o
Rule
RuleCriterias
RuleCriteria
RuleActions
RuleAction
o
WhiteListAddresses
o
WhiteListAddress
Objets Server-wide
o
Application
o
Backup
o
BackupManager
o
Database
o
DeliveryQueue
o
GlobalObjects
o
Status
o
Utilities
Objets Scripting-wide
o
Client
o
Result
Exemples
Les exemples ci-dessous sont crits en VBA. Pour les utiliser, copiez-les dans un fichier texte,
enregistrez le fichier avec l'extension .Vbs et double-cliquez sur le fichier dans l'Explorateur
Windows pour l'excuter. Avant de faire cela, assurez-vous de bien comprendre le but du script et
l'effet qu'il peut avoir sur votre installation de hMailServer. Nous vous recommandons fortement
d'excuter les scripts dans un environnement de test avant de les excuter sur une installation de
hMailServer utilise pour la production.
Changer le mot de passe d'un compte
Copier un message d'un dossier IMAP un autre
Crer un compte
Supprimer un compte
Activer un domaine
numrer les dossiers IMAP appartenant un compte spcifique
Envoyer un message
Objet Account
113 / 214
Description
L'objet account reprsente un simple compte hMailServer.
Mthodes
Delete()
Supprime le compte de la base de donnes.
DeleteMessages()
Supprime tous les messages qui existent ddans le compte.
Save()
Enregistre le compte dans la base de donness.
UnlockMailbox()
Dverrouille la bote aux lettres POP3.
ValidatePassword(string Password)
Valide le mot de passe. Retourne true si le mot de passe est correct.
Proprits
bool Active
Active
string ADDomain
Name du domaine Active Directory.
string Address
L'adresse de messagerie du compte.
eAdminLevel AdminLevel
Niveau d'administration.
string ADUsername
Nom du compte utilisateur Active Directory.
long DomainID
L'identificateur de base de donnes du domaine auquel appartient le compte.
FetchAccounts FetchAccounts
Chargement externe des comptes lis ce compte.
(lecture seule)
string ForwardAddress
Adresse du compte auquel ces messages sont transfrer.
bool ForwardEnabled
Le transfert ce compte est activ.
114 / 214
bool ForwardKeepOriginal
Garder le message d'origine aprs l'application du transfert.
long ID
L'identificateur de base de donnes pour le compte.
(lecture seule)
IMAPFolders IMAPFolders
Les dossiers IMAP appartenant ce compte.
(lecture seule)
bool IsAD
Le compte est connect Active Directory.
VARIANT LastLogonTime
L'horodatage de dernire utilisation de ce compte.
(lecture seule)
long MaxSize
Taille maximum dans le compte (Mo).
Messages Messages
Messages dans le bote aux lettres du compte.
(lecture seule)
string Password
Le mot de passe du compte.
string PersonFirstName
Prnom du titulaire du compte.
string PersonLastName
Nom du titulaire du compte.
long QuotaUsed
Pourcentage de cota utilis (0-100).
(lecture seule)
Rules Rules
Les rgles spcifies pour ce compte.
(lecture seule)
bool SignatureEnabled
Activer la signature
string SignatureHTML
La version HTML de la signature
string SignaturePlainText
La version texte clair de la signature
float Size
115 / 214
La taille du compte.
(lecture seule)
string VacationMessage
Le message d'absence
bool VacationMessageExpires
Le message d'absence est rgl pour expirer
string VacationMessageExpiresDate
Le message d'absence expire cette date
bool VacationMessageIsOn
Le message d'absence est activ
string VacationSubject
Le sujet du message d'absence
Objet Accounts
Description
L'objet Accounts est une collection de tous les comptes connects un domaine spcifique.
Mthodes
Add()
Ajoute un nouvel lment la collection.
Delete(long Index)
Supprime un lment par son index donn dans la collection.
DeleteByDBID(long DBID)
Supprime un compte dans la base de donnes pour son identificateur de base de donnes donn.
Refresh()
Rafrachit la collection
Proprits
long Count
Retourne le nombre d'lments de la collection
(lecture seule)
Account Item(long Index)
Retourne un compte par son index donn dans la collection.
(lecture seule)
Account ItemByAddress(string Address)
Retourne un compte par son adresse de messagerie donne.
116 / 214
(lecture seule)
Account ItemByDBID(long DBID)
Retourne un compte par son identificateur de base de donnes donn.
(lecture seule)
Objet Alias
Description
L'objet Alias reprsente un alias de hMailServer.
Mthodes
Delete()
Supprime l'alias de la base de donnes.
Save()
Enregistre l'alias dans la base de donnes.
Proprits
bool Active
L'alias est actif.
long DomainID
L'identificateur du domaine auquel l'alias appartient.
long ID
L'identificateur unique de base de donnes pour l'alias.
(lecture seule)
string Name
Le nom de l'alias.
string Value
La valeur de l'alias.
Objet Aliases
Description
L'objet Aliases est une collection de tous les alias connects un domaine spcifique.
Mthodes
Add()
Ajoute un nouvel alias la collection.
Delete(long Index)
117 / 214
Supprime l'alias avec l'index spcifi.
Supprime un alias par son identificateur de base de donnes donn.
Refresh()
Rafrachit la collection.
Proprits
long Count
Retourne le nombre d'alias dans la collection.
(lecture seule)
Alias Item(long Index)
Retourne un alias par un index donn.
(lecture seule)
Alias ItemByDBID(long DBID)
Retourne un alias par son identificateur de base de donnes donn.
(lecture seule)
Alias ItemByName(string Name)
Retourne un alias par son nom.
(lecture seule)
Objet AntiSpam
Description
L'objet AntiSpam contient tous les paramtres au niveau serveur lis l'anti-spam.
Mthodes
ClearGreyListingTriplets()
Efface les triplets de la liste grise.
Proprits
bool AddHeaderReason
Ajoute l'en-tte X-hMailServer-Reason si un spam est trouv.
bool AddHeaderSpam
Ajoute l'en-tte X-hMailServer-Spam si un spam est trouv.
bool CheckHostInHelo
Vrifie l'hte spcifi dans la commande HELO.
long CheckHostInHeloScore
Vrifie l'hte spcifi dans la commande HELO (SpamScore).
118 / 214
DNSBlackLists DNSBlackLists
Antispam: Collection des listes noires DNS.
(lecture seule)
bool GreyListingEnabled
Utiliser la liste grise.
long GreyListingFinalDelete
GreyListing - Supprimer le triplet utilis aprs ce temps (heures).
long GreyListingInitialDelay
GreyListing - Dlai avant acceptation des messages (minutes).
long GreyListingInitialDelete
GreyListing - Supprime le triplet utilis aprs ce temps (heures).
GreyListingWhiteAddresses GreyListingWhiteAddresses
Liste blanche pour liste grise.
(lecture seule)
long MaximumMessageSize
Taille maximum de message pour excuter l'anti-spam actif.
bool PrependSubject
Prfixer l'objet du message.
string PrependSubjectText
Texte pour prfixer le sujet du message.
bool SpamAssassinEnabled
Antispam: Activer l'intgration de SpamAssassin
string SpamAssassinHost
Antispam: Nom d'hte de SpamAssassin
bool SpamAssassinMergeScore
Antispam: Fusionner les scores de SpamAssassin.
long SpamAssassinPort
Antispam: Port de SpamAssassin
long SpamAssassinScore
Antispam: SpamAssassin (score).
long SpamDeleteThreshold
Seuil de suppression des spams
long SpamMarkThreshold
Seuil de marquage des spams
SURBLServers SURBLServers
119 / 214
Collection des serveurs SURBL.
(lecture seule)
long TarpitCount
Compte Tarpit.
long TarpitDelay
Dlai Tarpit.
bool UseMXChecks
Antispam: Utiliser les vrifications MX.
long UseMXChecksScore
Antispam: Utiliser les vrifications (score).
bool UseSPF
Antispam: Utiliser SPF.
long UseSPFScore
Antispam: Utiliser SPF (score).
WhiteListAddresses WhiteListAddresses
Liste blanche gnrale.
(lecture seule)
Objet AntiVirus
Description
L'objet Anti virus paramtre les examens relatifs aux virus.
Proprits
eAntivirusAction Action
Action.
BlockedAttachments BlockedAttachments
Pices jointes bloques
(lecture seule)
string ClamWinDBFolder
Dossiier de base de donnes ClamWIn.
bool ClamWinEnabled
ClamWin activ.
string ClamWinExecutable
Chemin de l'excutable ClamWin.
bool CustomScannerEnabled
Examen personnalis activ.
120 / 214
string CustomScannerExecutable
Chemin de l'excutable personnalis.
long CustomScannerReturnValue
Valeur de retour d'examen personnalise.
bool EnableAttachmentBlocking
Activer le blocage des pices jointes.
long MaximumMessageSize
Taille maximum d'un message lors de l'excution de l'antivirus (Ko).
bool NotifyReceiver
Avertir le destinataire qu'un e-mail a t supprim.
bool NotifySender
Avertir l'expditeur qu'un e-mail a t supprim.
API Exemple: Changer le mot de passe d'un compte
Cet exemple montre comment changer le mot de passe d'un compte de votre installation
hMailServer. Le script est crit en VBA. Pour l'utiliser, suivez ces tapes:
1.Copiez le script dans un diteur de texte
2.Enregistrez-le avec pour extension .vbs, par exemple Exemple.vbs
3.Dans l'Explorateur Windows, double-cliquez sur le fichier .vbs pour l'excuter.
Changer le mot de passe d'un compte
Dim obApp
Set obApp = CreateObject("hMailServer.Application")
' Authenticate. Without doing this, we won't have permission
' to change any server settings or add any objects to the
' installation.
Call obApp.Authenticate("Administrator", "testar")

' Locate the domain we want to add the account to
Dim obDomain
Set obDomain = obApp.Domains.ItemByName("example.com")

Dim obAccount
Set obAccount = obDomain.Accounts.ItemByAddress("account@example.com")

' Set the password to "secret"
obAccount.Password = "secret"
obAccount.Save
API Exemple: Copier un message dans un nouveau dossier IMAP
Gnralits
Cet exemple indique comment copier un message d'un dossier IMAP vers un autre. Le script
ncessite hMailServer 5 ou suprieur.
121 / 214
Copier un message
Dim obApp
' installation.
Call obApp.Authenticate("Administrator", "secret")

Dim obDomain

Dim obAccount
Set obAccount = obDomain.Accounts.ItemByAddress("test@example.com")

Dim obInboxFolder
Set obInboxFolder = obAccount.IMAPFolders.ItemByName("Inbox")
' Assume that the backup folder already exists. This may
' not be the case.
Dim obBackupFolder
Set obBackupFolder = obAccount.IMAPFolders.ItemByName("Backup")

' Copy all messages in Inbox to the backup folder
Dim obMessages
Set obMessages = obInboxFolder.Messages

For i = 0 to obMessages.Count - 1
Call obMessages.Item(i).Copy(obBackupFolder.ID)
Next
API Exemple: Crer un compte
Cet exemple indique comment ajouter un nouveau compte un domaine existant de votre
installation hMailServer. Le script est crit en VBA. Pour l'utiliser, suivez ces tapes:
Crer un compte
Dim obApp
' installation.
Call obApp.Authenticate("Administrator", "your-main-hmailserver-password")

Dim obDomain

Dim obAccount
Set obAccount = obDomain.Accounts.Add

' Set the account properties
obAccount.Address = "account@example.com"
obAccount.Password = "secret"
122 / 214
obAccount.Active = True
obAccount.MaxSize = 100 ' Allow max 100 megabytes

obAccount.Save
API Exemple: Supprimer un compte
Cer exemple montre comment supprimer un compte de votre domaine de votre installation
hMailServer. Le script est crit en VBA. Pour l'utiliser, suivez ces tapes:
Supprimer un compte
Dim obApp
' installation.

Dim obDomain
' To be able to delete an account, we need to know the database
' identifier for it. Because of this, we first need to fetch the account
object.
Dim obAccount
Set obAccount = obDomain.Accounts.ItemByAddress("account@example.com")

obDomain.Accounts.DeleteByDBID obAccount.ID
API exemple: Activer un domaine
Cet exemple indique comme activer un domaine existant de votre installation hMailServer. Le script
est crit en VBA.
Activer un domaine
Dim obApp
' installation.

Dim obDomain
obDomain.Active = True
obDomain.Save
API exemple: Liste des dossiers d'un utilisateur
Cet exemple indique comment dresser la liste des dossiers IMAP d'un utilisateur en utilisant l'API
COM de hMailServer. Le script affichera une liste droulante de tous les dossiers IMAP (y compris
les sous-dossiers) appartenant au compte test@example.com.
123 / 214
Dresser la liste des dossiers d'un utilisateur
Dim obApp
' installation.
Call obApp.Authenticate("Administrator", "<administrator-password>")

Dim obDomain

Dim obAccount
Set obAccount = obDomain.Accounts.ItemByAddress("test@example.com")

MsgBox ListFolders(obAccount.IMAPFolders, 0)
Function ListFolders(obFolders, iRecursion)
' Loop over all folders

iRecursion = iRecursion +1

Dim sMessage

dim i
for i = 0 to obFolders.Count -1

Dim obFolder
Set obFolder = obFolders.Item(i)

sMessage = sMessage & String(iRecursion*3, " ") & obFolder.Name &
vbNewLine
sMessage = sMessage & ListFolders(obFolder.SubFolders, iRecursion)

Next

iRecursion = iRecursion -1

ListFolders = sMessage

End Function
API exemple: Envoyer un message
Cet exemple montre comment envoyer un e-mail en utilisant l'API COM de hMailServer.
Envoyer un message
dim oMessage
Set oMessage = CreateObject("hMailServer.Message")
oMessage.From = "Me"
oMessage.FromAddress = "myaddress@mydomain.com"
oMessage.Subject = "Hi"
oMessage.AddRecipient "My friend", "myfriend@myfriend.com"
oMessage.Body = "This is the contents of the email."
oMessage.Save
124 / 214
Objet Application
Description
L'objet Application est l'objet racine de l'API de hMailServer. C'est le premier objet que vous devez
crer si vous souhaitez accder l'API de hMailServer
Mthodes
Authenticate(string Username, string Password)
Authentifier le client.
Connect()
Ouvrir une connexion la base de donnes de hMailServer.
Reinitialize()
Rinitialiser tous les paramtres du serveur
Start()
Dmerrer un serveur hMailServer.
Stop()
Arrter un serveur hMailServer.
SubmitEMail()
Mettre en attente un e-mail. Peut tre dclenche si un courriel a t insre manuellement dans
la base de donnes.
Proprits
BackupManager BackupManager
Accde au gestionnaire de sauvegarde.
(lecture seule)
Database Database
Accde l'interface de base de donnes.
(lecture seule)
Domains Domains
Accde la collection des Domaines.
(lecture seule)
GlobalObjects GlobalObjects
Accde l'objet Objects gnral.
(lecture seule)
string InitializationFile
Le fichier d'initialisation en cours d'utilisation.
(lecture seule)
Links Links
125 / 214
Liens rapides pour accder aux objets
(lecture seule)
Rules Rules
Obtient une colleciton des rgles gnrales.
(lecture seule)
eServerState ServerState
Obtient l'tat actuel du serveur.
(lecture seule)
Settings Settings
Obtient l'obbjet Settings.
(lecture seule)
Status Status
Retourne l'objet Status.
(lecture seule)
Utilities Utilities
Obtient l'objet Utilities.
(lecture seule)
string Version
Obtient la version actuelle de hMailServer
(lecture seule)
Objet Attachment
Description
L'objet Attachment reprsente une simple pice jointe de message.
Mthodes
Delete()
Supprime cette pice jointe du message.
SaveAs(string sName)
Enregistre la pice jointe dans un fichier sous ne nom indiqu.
Proprits
string Filename
Le nom de fichier de la pice jointe.
(lecture seule)
long Size
La taille de la pice jointe.
(lecture seule)
Objet Attachments
126 / 214
Description
L'objet Attachments est une collection de toutes les pices jointes d'un seul message.
Mthodes
Add(string sFilename)
Ajoute une pice jointe la collection.
Clear()
Supprime toutes les pices jointes du message.
Proprits
long Count
Le nombre d'objets de la collection.
(lecture seule)
Attachment Item(long Index)
Retourne une pice jointe par son index donn.
(lecture seule)
Objet Backup
Description
L'objet Backup reprsente une simple sauvegarde de hMailServer.
Mthodes
StartRestore()
Lance une restauration de cette sauvegarde.
Proprits
bool ContainsDomains
Contient les domaines.
(lecture seule)
bool ContainsMessages
Contient les messages.
(lecture seule)
bool ContainsSettings
Contient les paramtres.
(lecture seule)
bool RestoreDomains
Restaure les domaines.
127 / 214
bool RestoreMessages
Restaure les messages.
bool RestoreSettings
Restaure les paramtres.
Objet BackupManager
Description
L'objet BackupManager est l'objet qui lance et restaure les sauvegardes.
Mthodes
LoadBackup(string sXMLFile)
Charge un sauvegarde partir d'un fichier.
StartBackup()
Lance une sauvegarde.
Objet BackupSettings
Description
L'objet BackupSettings contient tous les paramtres relatifs la sauvegarde.
Properties
bool BackupDomains
Sauvegarder les domaines.
bool BackupMessages
Sauvegarder les messages.
bool BackupSettings
Sauvegarder les paramtres.
bool CompressDestinationFiles
Compresser les fichiers de destination
string Destination
Sauvegarder la destination
string LogFile
Sauvegarder le fichier journal
(lecture seule)
Objet BlockedAttachment
128 / 214
Description
L'objet BlockedAttachment reprsente une simple extension de fichier bloqu (ou un joker).
Mthodes
Delete()
Supprime l'objet.
Save()
Enregistre les changements de l'objet dans la base de donnes.
Proprits
string Description
Description pour le bocage.
long ID
L'identificateur unique de l'objet dans le base de donnes.
(lecture seule)
string Wildcard
Joker pour la pice jointe bloque.
Objet BlockedAttachments
Description
L'objet BlockedAttachments est une collection de toutes les pices jointes bloques de
l'installation de hMailServer.
Mthodes
Add()
Ajoute un nouvel objet la collection.
Supprime un objet de la base de donnes par son identificateur de base de donnes.
Refresh()
Proprits
long Count
(lecture seule)
BlockedAttachment Item(long Index)
129 / 214
Retourne une pice jointe bloque par son index.
(lecture seule)
BlockedAttachment ItemByDBID(long DBID)
Retourne une pice jointe bloque par son identificateur de base de donnes
(lecture seule)
Objet Cache
Description
L'objet Cache contient tous les paramtres relatifs la mise en cache de hMailServer.
Mthodes
Clear()
Efface le et rinitialise les statistiques.
Proprits
long AccountCacheTTL
Temps de cache du compte (en secondes).
long AccountHitRate
Taux de succs du compte
(lecture seule)
long AliasCacheTTL
Temps de cache de l'alias (secondes).
long AliasHitRate
Taux de succs de l'alias.
(lecture seule)
long DistributionListCacheTTL
Temps de cache de la liste de distribution (secondes).
long DistributionListHitRate
Taux de succs de la liste de distribution.
(lecture seule)
long DomainCacheTTL
Temps de cache du domaine (secondes).
long DomainHitRate
Taux de succs du domaine.
(lecture seule)
bool Enabled
Le cache est activ.
130 / 214
Objet Client
Description
L'objet Client est un objet temporaire utilis dans les vnements hMailServer qui autorise les
scripts pour vrifier l'adresse et le nom d'utilisateur du client connect.
Proprits
string IPAddress
L'adresse TCP/IP laquelle le client est connect.
(lecture seule)
long Port
Le port TCP/IP auquel le client est connect.
(lecture seule)
string Username
Le nom d'utilisateur du client.
(lecture seule)
API COM: ChangeLog
Ce document numre brivement les changements effectus l'API COM.
hMailServer 5.0
Changements rompant la rtrocompatibilitAPI COM: Structure API
hMailServer 5 inclut de nombreuses fonctionnalits nouvelles. Certaines fonctionnalits de
hMailServer 4 ont t refondes, ce qui a eu aussi pour effet de refonder les API correspondants.
De ce fait, hMailServer 5 a eu ses API modifis qui rompent la rtrocompatibilit.
Les objets suivants n'existent plus. Leur contenu a t dplac dans l'objet TCPIPPort
IPHomes
IPHome
Les proprits suivantes n'existent plus:
Alias
o
Type - Cette proprit a t supprime depuis qu'elle n'est plus utilise.
AntiSpam
o
AntiSpamAction - Cette proprit n'existe plus depuis que la fonctionnalit anti-spam de la
version 5 est base sur le score.
Backup
o
OverwriteObjects - Cette proprit a t supprime depuis qu'elle n'est plus utilise - la
fonctionnalit correspondante dans la fonction de sauvegarde a t supprime.
o
DeleteObjectsNotInBackups - Cette proprit a t supprime depuis qu'elle n'est plus
utilise - la fonctionnalit correspondante dans la fonction de sauvegarde a t supprime.
GlobalObjects
o
La proprit Language a t supprime et remplace par une proprit Languages qui
renvoie une collection de langages.
Language
o
La signature de la proprit String a t actualise.
Settings
o
POP3Port. Cette proprit n'est plus pertinente depuis que hMailServer peut surveiller
131 / 214
plusieurs ports.
o
SMTPPort. Cette proprit n'est plus pertinente depuis que hMailServer peut surveiller
plusieurs ports.
o
TarpitDelay - Cette proprit a t dplace dans l'objet AntiSpam.
o
TarpitCount - Cette proprit a t dplace dans l'objet AntiSpam.
o
IMAPPort - Cette proprit n'est plus pertinente depuis que hMailServer peut surveiller
plusieurs ports.
o
UseSPF - Cette proprit a t dplace dans l'objet AntiSpam.
o
UseMXChecks - Cette proprit a t dplace dans l'objet AntiSpam.
o
DNSBlackLists - Cette proprit a t dplace dans l'objet AntiSpam.
o
ListenOnAllAddresses - Cette proprit n'est plus pertinente depuis que la configuration des
surveillances de hMailServer de diffrents ports a t modifie.
o
IPHomes - Cette proprit n'est plus pertinente depuis que les objets Homes/IPHome
n'existent plus.
Les lments suivants ont t changs:
Domains
o
ItemByName a t chang de Mthode Proprit
Les mthodes et proprits suivantes ont t ajoutes aux objets existants:
Account
o
PersonFirstName - Obtient ou dfinit le prnom du propritaire du compte.
o
PersonLastName - Obtient ou dfinit le nom du propritaire du compte.
o
Delete - Supprime le compte de la base de donnes.
Alias
o
Delete -Supprime l'alias de la base de donnes.
AntiSpam
o
CheckHostInHeloScore - Obtient ou dfinit une valeur dterminant si hMailServer doit vrifier
l'hte HELOdes expditeurs lors de la protection anti-spam.
o
ClearGreylistingTriplets - Efface tous les triplets de la liste grise.
o
DNSBlackLists - Obtient une collection des listes noires DNS.
o
MaximumMessageSize -Obtient ou dfinit la taille maximum d'un message que sera
examin par hMailServer pour une recherche de spam.
o
SpamMarkThreshold - Obtient ou dfinit le seuil de marquage du spam.
o
SpamDeleteThreshold -Obtient ou dfinit le seuil de suppression du spam.
o
SpamAssassinEnabled -Obtient ou dfinit une valeur dterminant si l'intgration de
SpamAssassin est active.
o
SpamAssassinScore -Obtient ou dfinit le score SpamAssassin.
o
SpamAssassinMergeScore - Obtient ou dfinit une valeur dterminant si hMailServer doit
utiliser le score de spam de SpamAssassin.
o
SpamAssassinHost - Obtient ou dfinit le nom d'hte du serveur qui excute SpamAssassin.
o
SpamAssassinPort - Obtient ou dfinit le port du serveur de SpamAssassin.
o
TarpitDelay - Obtient ou dfinit dlai de rpulsion.
o
TarpitCount -Obtient ou dfinit dlai de rpulsion.
o
UseSPF - Obtient ou dfinit une valeur dterminant si hMailServer doit excuter les
vrificationsSPFlors de la protection anti-spam.
o
UseSPFScore - Obtient ou dfinit le score SPF.
o
UseMXChecks -Obtient ou dfinit une valeur dterminant si hMailServer doit effectuer les
vrifications MXlors de la protection anti-spam.
o
UseMXChecksScore - Obtient ou dfinit le score des vrifications MX.
BlockedAttachment
o
Delete - Supprime l'objet de la base de donnes.
Database
o
CreateInternalDatabase - Cre une base de donnes interne utilisant MSSQLCompact
Edition.
o
CreateExternalDatabase - Cre une base de donnes externe utilisant les informations de
connexion fournies.
o
DatabaseExists - Obtient une valeur qui dtermine si les paramtres de base de donnes
dans hMailServer.ini semblent valides.
o
BeginTransaction - Lance une nouvelle transaction SQL.
o
CommitTransaction - Engage untransaction SQL.
o
RollbackTransaction - Restaure une transaction SQL.
o
ExecuteSQLScript - Excute un script SQL
o
SetDefaultDatabase - Rgle les paramtres par dfaut de la base de donnes dans
hMailServer.ini.
132 / 214
o
IsConnected - Obtient une valeur qui dtermine si hMailServer a pu se connecter la base
de donnes.
o
ServerName - Obtient le nom du serveur de base de donnes auquel hMailServer est
connect.
o
DatabasName - Obtient le nom de la base de donnes laquelle hMailServer est connect
DNSBlackLists
o
Score - Obtient ou dfinit le score de spam pour la liste noire DNS.
o
Delete -Supprime l'objet de la base de donnes.
FetchAccount
o
UseSSL - Obtient ou dfinit une valeur qui dtermine si SSL doir tre utilis lors de la
connexion au serveur d'un compte externe.
o
Delete - Supprime le compte externe de hMailServer.
o
NextDownloadTime - Obtient une chane contenant la date et l'heure de la prochaine
tentative de tlchargement.
GreyListingWhiteAddress
o
Delete - Supprime l'lment de la base de donnes.
IMAPFolder
o
Save -Enregistre les changements effectus au dossier IMAP dans la base de donnes.
o
ParentID- Obtient l'identificateur de base de donnes pour le dossier IMAPparent.
o
Permissions- Obtient une collection contenant les permissions ACL.
o
Language
o
Name -Obtient le nom du langage.
Logging
o
CurrentAwstatsLog - Obtient le nom du fichier journal awstats actuel.
o
CurrentEventLog - Obtient le nom di fichier journal d'vnement actuel.
o
CurrentErrorLog - Obtient le nom du fichier journal d'erreur actuel.
o
CurrentDefaultLog - Obtient le nom du journal par dfaut en cours.
o
KeepFilesOpen -Obtient ou dfinit une valeur qui dtermine si hMailServer doit garder les
fichiers journaux ouverts entre les critures.
Message
o
Charset -Obtient ou dfinit le jeu de caractres du message.
o
Copy - Copie le message dans le dossier IMAPspcifi(doit tre le mme que le compte
utilisateur).
Messages
o
Add - Ajoute un nouveau message la collection
o
Clear - Supprime tous les messages de la collection.
Recipient
o
OriginalAddress - Obtient l'adresse originale du destinataire (comme spcifi lors de la
conversation SMTP)
Route
o
UseSSL - Obtient ou dfinit une valeur qui dtermine si hMailServer doit utiliser SSL lors
d'une connexion l'itinraire.
o
Description -Obtient ou dfinit une description de l'itinraire.
o
Delete -Supprime l'itinraire de la base de donnes.
RouteAddress
o
Delete -Supprime l'adresse de l'itinraire de la base de donnes.
Rule
o
Delete - Supprime la rgle de la base de donnes.
RuleAction
o
HeaderName -Obtient ou dfinit le nom de l'en-tte modifier
o
Value - Obtient ou dfinit la valeur de l'en-tte modifier.
o
RuleCriteria
o
Delete -Supprime le critre de rgle de la base de donnes.
Scripting
o
CurrentScriptFile - Le fichier de script en cours d'utilisation.
SecurityRange
o
EnableAntiVirus -Obtient ou dfinit une valeur qui dtermine si l'antivirus est activ pour la
plage IP.
o
Delete - Supprime la plage IP de la base de donnes.
SecurityRanges
o
SetDefault - Rtablit tous les rglages de la plage IP pour les paramtres par dfaut de
hMailServer. Toute plage IP ajoute qui ne fait pas partie de la configuration par dfaut est
133 / 214
supprime.
ServerMessages
o
ItemByName - Retourne un message au serveur par son nom.
Settings
o
SMTPRelayerUseSSL - Obtient ou dfinit la valeur qui dtermine si hMailServer doit utiliser
SSL lors d'une communication vec le relais SMTP.
o
SSLCertificates - Obtient une collection des certificats SSLqui ont t dfinis dans
hMailServer.
o
AddDeliveredToHeader -Obtient ou dfinit la valeur qui dtermine si hMailServer doit
ajouter un en-tte Distribu A aux messages reus.
o
IMAPPublicFolderName - Obtient ou dfinit le nom du dossier public.
o
IMAPACLEnabled - Obtient ou dfinit la valeur qui dtermine si l'extension ACLdans le
protocole IMAPdoit tre activ.
o
SetAdministratorPassword - Dfinit le mot de passe de hMailServer Administrator.
o
Directories - Obtient un objet Directories qui contient les paramtres du rpertoire li.
o
PublicFolders - Obtient une collection de dossiers publics.
o
PublicFolderDiskName - Obtient le nom du dossier rpertoire o les dossiers public sont
stocks.
o
Groups - Obtient une collection de groupes tendus de serveurs
SURBLServer
o
Score - Obtient ou dfinit le score de spam pour le serveur SURBL.
o
Delete - Supprime le serveur SURBLde la base de donnes.
TCPIPPort
o
Address - Obtient ou dfinit l'adresse IP locale que hMailServer doit surveiller.
o
UseSSL - Obtient ou dfinit une valeur dterminant si hMailServer doit s'attendre des
connexions SSL sur ce port.
o
SSLCertificateID - Obtient ou dfinit une valeur dterminant l'IDdes certificats SSL utiliser
pour ce port.
o
TCPIPPorts
o
SetDefault - Rtablit la configuration TCP / IP pour les valeurs par dfaut.
Utilities
o
IsStrongPassword - Retourne true si le passeport dfini apparat comme tant assez forte.
Notez que les exigences pour qu'un mot de passe soit considr comme fort sont faibles.
o
SHA256 - Retourne un hachage SHA256 pour la chane donne.
WhiteListAddress
o
Delete -Supprime l'lment de la base de donnes.
WhiteListAddresses
o
Clear - Efface la collection
hMailServer 4.4
Changements rompant la rtrocompatibilit
Aucun changement n'a t effectu l'API COM de hMailServer qui rompt la compatibilit avec les
versions prcdentes.
Nouveaux vnements
OnDeliveryStart - Cet vnement est excut directement aprs le dmarrage de la distribution
d'un e-mail, avant que les rgles gnrales soient excutes.
Nouveaux objets
WhiteListAddresses - Collection de toutes les adresses de la liste blanche.
WhiteListAddress - Une adresse vers la liste blanche.
Changements des objets existants
134 / 214
Aucune proprit ou mthode n'a t supprime dans hMailServer 4.4. Ci-dessous la liste des
proprits ajoutes
AntiSpam
o
WhiteListAddresses - Retourne une collection avec les adresses de la liste blanche.
Account
o
LastLogonTime - L'horodatage de la dernire utilisation de ce compte. (Lecture seule)
o
VacationMessageExpires - Active l'expiration automatique du message d'absence du
bureau.
o
VacationMessageExpiresDate - La date laquelle le message d'absence doit expirer.
Cache
o
AliasCacheTTL - Dure du cache pour les alias (secondes)
o
AliasHitRate - Taux de consultation du cache de l'alias.
o
DistributionListCacheTTL - Dure du cache pour les listes de diffusion (secondes)
o
DistributionListHitRate - Taux de consultation du cache des listes de diffusion.
Domain
o
MaxNumberOfAccounts - Nombre maximum de comptes qui peuvent tre ajouts au
domaine. *
o
MaxNumberOfAliases - Nombre maximum d'alias qui peuvent tre ajouts au domaine. *
o
MaxNumberOfDistributionLists - Nombre maximum de listes de diffusion qui peuvent tre
ajoutes au domaine. *
o
MaxNumberOfAccountsEnabled - Nombre limite de comptes activer. *
o
MaxNumberOfAliasesEnabled - Nombre limite d'alias activer. *
o
MaxNumberOfDistributionListsEnabled - Nombre limite de listes de diffusion activer. *
o
MaxAccountSize - Taille maximum des comptes ajouts ce domaine *
* Notez que ces proprits ne font pas, en fait, appliquer les limitations. Pour l'instant, ces
limitations ncessitent d'tre excutes dans la couche de l'interface utilisateur de l'application
(elles soont excutes dans hMailServer Administrator et PHPWebAdmin). L'excution dans le
cur du serveur ncessiterait une refonte des lments internes. Ce qui est prvu pour
hMailServer 5.
IMAPFolders
o
Add - Ajoute un nouveau dossier IMAP la collection
o
DeleteByDBID - Supprime un dossier IMAP avec l'identificateur de base de donnes attribu.
Message
o
InternalDate - La date interne du message (l'heure laquelle le message a t cr dans
hMailServer)
Utilities
o
ImportMessageFromFileToIMAPFolder - Importe un fichier message partir du dossier du
disque et le place dans un dossier IMAP spcifique.
SecurityRange
o
IsForwardingRelay - Spcifie si la plage IP couvre le relais de transfert, par exemple une
sauvegarde MX.
FetchAccount
o
DownloadNow - Force dsormais un tlchargement des messages depuis un compte
externe.
o
ProcessMIMEDate - Activer le traitement de la date de rception dans l'en-tte Reu.
Rule
o
MoveUp - Dplace la rgle vers le haut dans l'ordre de traitement.
o
MoveDown - Dplace la rgle vers le bas dans l'ordre de traitement.
RuleAction
o
MoveUp - Dplace l'action de la rgle vers le haut dans l'ordre de traitement.
o
MoveDown - Dplace l'action de la rgle vers le bas dans l'ordre de traitement.

135 / 214
hMailServer 4.3
Changements rompant la rtrocompatibilit
Dans hMailServer 4.3, les clients COM doivent appeler la fonction Authenticate() de l'objet
hMailServer.Application avant d'accder aux autres fonctions dans l'API. Ces changements ont t
effectus pour augmenter la scurit de l'API COM de hMailServer.
L'exception ceci est l'objet Message. Les clients COM peuvent crer et envoyer des messages en
utilisant l'objet hMailServer.Message sans appeler la mthode Authenticate.
Si vous devez passer hMailServer 4.3, et que vous ne pouvez pas actualiser votre client COM,
une alternative consiste rgler AdministratorPassword dans hMailServer.ini sur empty. Si vous le
faites, vous n'aurez pas appeler Authenticate method()
Nouveaux objets
SURBLServers - Collection de tous les serveurs SURBL mis en place dans le systme
SURBLServer - Contient les proprits pour un simple serveur SURBL
AntiSpam - Configuration relative AntiSpam
BlockedAttachments - Collection de tous les objets mis en place dans l'examen antiviral / le
blocage des pices jointes.
BlockedAttachment - Proprits d'une pice jointe prsente dans l'examen antivirral / les pices
jointes bloques
ServerMessages - Collection des messages texte utiliss par le serveur (notification de virus, par
exemple)
ServerMessage - Un message en texte clair utilis par le serveur
GreyListingWhiteAddresses - Une collection de toutes les adresses blanches spcifies dans les
options de la liste grise
GreyListingWhiteAddress - Une simple adresse blanche de liste grise
TCPIPPorts - Une collection de tous les ports TCP/IP qui doivent tre utiliss
TCPIPPort - Proprits d'un simple port TCP/IP
Enumration des nouveauts
eRuleActionType, Added value: eRARunScriptFunction, - Excuter d'une fonction de script
eAntiSpamAction - Action prendre si un spam a t dtect
eDistributionListMode - Mode de liste de diffusion
eSessionType - Type de session (SMTP/POP3/IMAP)
eDomainSignatureMethod - Spcifie comment les signatures sont appliquer (ajout,
remplacement, t ainsi de suite)
eMessageFlag - Contient des indicateurs de message (vus, supprims, et ainsi de suite)
Changements sur les objets existants
Aucune proprit ou mthode n'a t supprime dans hMailServer 4.3. Ci-dessous le liste des
proprits ajoutes
Application
o
Authenticate - Authentifie un client
Account
o
ForwardEnabled - Le transfert pour ce compte est activ.
o
ForwardAddress - Adresse vers laquelle les messages de ce compte seront transfrs.
o
ForwardKeepOriginal - Garder le message original aprs l'application du transfert.
o
SignatureEnabled - Activer la signature
o
SignaturePlainText - La version en texte clair de la signature
AntiVirus
o
MaximumMessageSize - Taille maximale du message lors de l'excution de l'antivirus (Ko).
136 / 214
o
BlockedAttachments - Collection de tous les types de pices jointes bloques
o
EnableAttachmentBlocking - Activer le blocage des pices jointes
Database
o
RequiresUpgrade - La base de donnes ncessite une mise jour.
DeliveryQueue
o
Remove - Supprime le message de la file d'attente de distribution.
DistributionList
o
Mode - Mode de liste de diffusion
Domain
o
PlusAddressingEnabled - Utiliser l'adressage plus pour ce domaine.
o
PlusAddressingCharacter - Caractre d'adressage plus.
o
AntiSpamEnableGreylisting - Activer la liste grise pour ce domaine.
o
MaxSize - Taille maximum de ce domaine en Mo.
o
Size - Taille actuelle de ce domaine en Mo.
o
AllocatedSize - Espace allou ce domaine.
o
SignatureEnabled - Activer la signature
o
SignatureMethod - La mthode de signature du domaine
o
SignaturePlainText - La version texte claiir de la signature
o
SignatureHTML - The HTML version of the signature
o
AddSignaturesToReplies - Ajouter les signatures aux rponses du message
o
AddSignaturesToLocalMail - Ajouter les signatures au message local
FetchAccount
o
ProcessMIMERecipients - Envoyer un message aux destinataires des en-ttes Reu/A/CC.
Logging
o
MaskPasswordsInLog - Masquer les mots de passe avant de les crire dans le fichier
journal.
Message
o
Flag - Retourne l'tat d'un indicateur de message (supprim, vu, etc)
RuleAction
o
ScriptFunction - Lorsque le type d'action est rgl sur eRARunScriptFunction, cette fonction
est excute
Status
o
SessionCount - Nombre de sessions par type de session
Settings
o
DefaultDomain - Domaine utiliser si le domaine n'a pas t spcifi lorsque l'utilisateur se
connecte.
o
SMTPDeliveryBindToIP - L'adresse TCP / IP laquelle se lier lors de la distribution de
messages des htes distants.
o
MaxIMAPConnections - Nombre maximum des connexions IMAP simultanes.
o
IMAPSortEnabled - Activer l'extension SORT IMAP.
o
IMAPQuotaEnabled - Activer l'extension QUOTA IMAP.
o
IMAPIdleEnabled - Activer l'extension IDLE IMAP.
o
WorkerThreadPriority - Priorit accorder aux processus de travail
o
TCPIPThreads - Nombre de processus TCP/IP (pour la communication) excuter.
o
AllowIncorrectLineEndings - Autoriser les messages avec des fins de ligne incorrectes (CR ou
LF manquants).
o
MaxSMTPRecipientsInBatch - Nombre maximum de destinataires SMTP lors d'une distribution
par lots.
o
AntiSpam - Retourne l'objet AntiSpam contenant les paramtres relatifs Anti spam.
o
DisconnectInvalidClients - Dconnecter les clients qui ne suivent pas les RFC
o
MaxNumberOfInvalidCommands - Nombre maximum de commandes de client non valides
avant dconnexion.
o
ServerMessages - Retourne l'objet ServerMessage contenant des chanes de texte utilises
par le serveur.
o
TCPIPPorts - Une collection de tous les ports TCP/IP utiliser
137 / 214
Utilities
o
IsLocalHost - Vrifier si le nom d'hte donn pointe sur localhost.
API COM: Structure API

Gnralits
La plupart du temps, hMailServer se comporte comme tout autre API COM. Cependant, certaines
choses sont bonnes savoir avant de commencer crire du code qui utilise l'API COM
hMailServer.
Accder un objet
Quel que soit l'objet hMailServer auquel vous souhaitez accder, vous devez passer par l'objet
Application de hMailServer. Par exemple, pour accder un domaine spcifique, vous devez crer
une instance de l'objet hMailServer.Application, rcuprer une collection de tous les domaines
l'aide de la proprit Domaines, puis recherchez le domaine spcifique. Il n'est pas possible de
crer une instance de la collection hMailServer.Domains pour rcuprer le nom de domaine
spcifique. La raison de ce comportement rside dans les mcanismes d'authentification de l'API
COM.
Manipulation des exceptions
L'API COM hMailServer gnre une exception dans les cas suivants:
Lorsque vous essayez de crer un nouvel objet avec le mme nom que celle qui existe. Par
exemple, si vous essayez de crer deux comptes avec la mme adresse, une exception sera
gnre.
Si une erreur de base de donnes se produit. Si la connexion au serveur de base de donnes est
perdue, ou qu'un autre problme de base de donnes se produit, une exception sera gnre.
Si les autorisations client ne suffisent pas. Avant de pouvoir accder aux objets de l'API COM
hMailServer, vous devez d'abord vous authentifier ( l'aide d'authentification de
hMailServer.Application). Si vous essayez d'accder un objet pour lequel vous n'avez pas la
permission d'accs, une exception sera gnre. Par exemple, si vous vous authentifiez en tant
qu'utilisateur avec des droits au niveauutilisateur, une exception sera gnre si vous essayez
d'accder aux paramtres gnraux du serveur.
Une exception sera gnre si vous essayez d'accder un lment inexistant dans une
collection. Par exemple, ItemByName appelant () sur la collection hMailServer.Domains lvera une
exception si le domaine ne peut pas tre trouv.
Crer de nouveaux objets
Pour crer un nouvel objet, vous excutez gnralement Add() sur la collection parent. Par
exemple, pour ajouter un nouveau domaine, excutez Add() sur la collection Domaines. La
mthode Add() retournera un nouvel objet. Ce nouvel objet n'existera qu'en mmoire, et vous
aurez excuter la mthode Save() sur l'objet pour l'enregistrer dans la base de donnes.
Lorsque vous excutez Save(), l'objet est enregistr dans la base de donnes et ajout la
collection.
Objet Database
Description
L'objet Database contient les informations sur la mise en place de la base de donnes en cours et
138 / 214
sur les mthodes fondamentales pour excuter SQL vers la base de donnes.
Mthodes
BeginTransaction()
Lance une nouvelle transaction SQL. Ne concerne que ExecuteSQL().
CommitTransaction()
Valide une transaction SQL. Ne concerne que ExecuteSQL().
CreateExternalDatabase(eDBtype ServerType, string ServerName, long lPort, string
DatabaseName, string Username, string Password)
Crer une base de donnes externe
CreateInternalDatabase()
Crer une base de donnes interne
ExecuteSQL(string sSQLStatement)
Excute une instruction SQL.
ExecuteSQLScript(string sFilename)
Excute un fichier de script contenant des instructions SQL.
RollbackTransaction()
Restaure une transaction SQL. ne concerne que ExecuteSQL().
SetDefaultDatabase(eDBtype ServerType, string ServerName, long lPort, string DatabaseName,
string Username, string Password)
Configurer la base de donnes par dfaut
UtilGetFileNameByMessageID(long MessageID)
Retourne le nom de fichier d'une ID de message donne.
Proprits
long CurrentVersion
Version de la base de donnes actuelle.
(lecture seule)
bool DatabaseExists
Vrifie si une base de donnes existe.
(lecture seule)
string DatabaseName
Nom de la base de donnes.
(lecture seule)
eDBtype DatabaseType
Type de base de donnes.
(lecture seule)
bool IsConnected
139 / 214
Retourne true si une base de donnes est disponible.
(lecture seule)
long RequiredVersion
Version de base de donnes requise.
(lecture seule)
bool RequiresUpgrade
La base de donnes doit tre mise jour.
(lecture seule)
string ServerName
Nom du serveur.
(lecture seule)
Objet DeliveryQueue
Description
L'objet DeliveryQueue contient le mthode pour manipuler la file d'attente de hMailServer.
Mthodes
Clear()
Efface la file d'attente de distribution.
Remove(int iMessageID)
Supprime les message de la file d'attente de distribution.
ResetDeliveryTime(int iMessageID)
Rinitialise l'heure de la prochaine distribution
StartDelivery()
Force le librateur SMTP chercher les messages distribuer.
Objet Directories
Description
L'objet Directories contient tous les rpertoires mis en place dans hMailServer.ini.
Proprits
string DatabaseDirectory
Dossier de base de donnes
string DataDirectory
Dossier de donnes
string DBScriptDirectory
Dossier des scripts de base de donnes
(lecture seule)
140 / 214
string EventDirectory
Dossier vnements
string LogDirectory
Dossier journal
string ProgramDirectory
Dossier programme
string TempDirectory
Dossier temporaire
Objet DistributionList
Description
L'objet DistributionList reprsente une liste de diffusion de hMailServer.
Mthodes
Delete()
Supprime la liste de diffusion de la base de donnes.
Save()
Enregistre la liste de diffusion dans la base de donnes.
Proprits
bool Active
Le nom de la liste de diffusion.
string Address
L'adresse de la liste de diffusion..
long ID
L'identificateur unique de base de donnes de la liste de diffusion.
(lecture seule)
eDistributionListMode Mode
Mode de la liste de diffusion.
DistributionListRecipients Recipients
Les destinataires de la liste de diffusion.
(lecture seule)
string RequireSenderAddress
Demande l'utilisateur d'envoyer partir de l'adresse.
bool RequireSMTPAuth
141 / 214
Dfinit si la liste ncessite une authentification SMTP de la part de l'utilisateur avant de lui envoyer
un e-mail.
Objet DistributionListRecipient
L'objet DistributionListRecipient reprsente un destinataire d'une liste de diffusion de hMailServer.
Proprits
Property ID As Long
L'identificateur de base de donnes pour le dossier de la liste de diffusion
Property RecipientAddress As String
L'adresse e-mail du destinataire.
Mthodes
Sub Save()
Enregistre le destinataire.
Sub Delete()
Supprime le destinataire.
Objet DistributionListRecipients
Description
L'objet DistributionListRecipients est une collection de tous les destinataires d'une seule liste de
diffusion.
Mthodes
Add()
Ajoute un nouveau destinataire la collection.
DeleteByDBID(long lDBID)
Supprime un destinataire de la collection.
Proprits
long Count
Retourne le nombre de destinataires de la collection.
(lecture seule)
DistributionListRecipient Item(long Index)
Retourne le destinataire de la collection avec un index attribu.
(lecture seule)
DistributionListRecipient ItemByDBID(long DBID)
Retourne le destinataire de la collection avec l'index de base de donnes attribu.
(lecture seule)
Objet DistributionLists
Description
142 / 214
L'objet DistributionLists est une collection de tous les listes de diffusion lies un domaine
spcifique.
Mthodes
Add()
Ajoute une nouvelle liste la collection.
Supprime une liste de la collection.
Refresh()
Rafrachit la collection de la base de donnes.
Proprits
long Count
Retourne le nombre de listes de la collection.
(lecture seule)
DistributionList Item(long Index)
Retourne la liste de diffusion par l'index attribu.
(lecture seule)
DistributionList ItemByAddress(string sAddress)
Retourne la liste de la collection par l'adresse attribue.
(lecture seule)
DistributionList ItemByDBID(long DBID)
Retourne la liste de la collection par l'identificateur de base de donnes.
(lecture seule)
Objet DNSBlackList
Description
L'objet DNSBlacklist reprsente une simple liste noire hMailServer.
Methods
Delete()
Supprime l'objet de la base de donnes.
Save()
Proprits
bool Active
L'objet est actif.
143 / 214
string DNSHost
L'hte DNS demander.
string ExpectedResult
L'adresse IP que la requte va rsoudre si l'hte est dans la liste noire.
long ID
L'identificateur unique de base de donnes pour l'objet.
(lecture seule)
string RejectMessage
Le message envoyer au client si le serveur refuse le courriel.
long Score
Score de spam
Objet DNSBlackLists
Description
L'objet DNSBlackLists est une collection de toutes les listes noires DNS black lists set up in the
hMailServer installation.
Methods
Add()
Supprime un objet de la base de donnes par son identificateur de base de donnes attribu.
Refresh()
Proprits
long Count
Le nombre d'objets dans la collection.
(lecture seule)
DNSBlackList Item(long Index)
Retourne une liste noire DNS par son index attribu.
(lecture seule)
DNSBlackList ItemByDBID(long DBID)
Retourne une liste noire DNS par son identificateur de base de donnes.
(lecture seule)
DNSBlackList ItemByDNSHost(string sDNSHost)
Retourne une liste noire DNS par son hte DNS.
(lecture seule)
144 / 214
Objet Domain
Description
L'objet Domain reprsente un domaine hMailServer.
Mthodes
Delete()
Supprime le domaine de la base de donnes.
Save()
SynchronizeDirectory()
Synchronise ce domaine vers Active Directory
Properties
Accounts Accounts
La collection des comptes pour le domaine.
(lecture seule)
bool Active
L'tat activ du domaine.
string ADDomainName
Le domaine Active Directory avec lequel ce domaine sera synchronis.
bool AddSignaturesToLocalMail
Ajouter les signatures au message local
bool AddSignaturesToReplies
Ajouter les signatures au message de rponse
Aliases Aliases
La collection des alias de ce domaine.
(lecture seule)
long AllocatedSize
Espace allou pour ce domaine.
(lecture seule)
bool AntiSpamEnableGreylisting
Activer la liste grise pour ce domaine.
DistributionLists DistributionLists
La collection des listes de diffusion pour le domaine.
(lecture seule)
145 / 214
DomainAliases DomainAliases
Les alias du nom de domaine.
(lecture seule)
long ID
L'identificateur de base de donnes unique pour le domaine.
(lecture seule)
long MaxAccountSize
La taille maximum des comptes crs dans ce domaine.
long MaxMessageSize
La taille maximum d'un message lors d'un envoi partir de ce domaine.
long MaxNumberOfAccounts
Le nombre maximum de comptes ajouter ce domaine.
bool MaxNumberOfAccountsEnabled
Activer le nombre maximum de comptes.
long MaxNumberOfAliases
Nombre maximum d'alias ajouter ce domaine.
bool MaxNumberOfAliasesEnabled
Activer le nombre maximum d'alias.
long MaxNumberOfDistributionLists
Nombre maximum de listes de diffusion ajouter ce domaine.
bool MaxNumberOfDistributionListsEnabled
Activer le nombre maximum de listes de diffusion.
long MaxSize
Taille maximum du domaine en Mo.
string Name
Nom du domaine.
string PlusAddressingCharacter
Caractre d'adressage plus.
bool PlusAddressingEnabled
Utiiser l'adressage plus pour ce domaine.
string Postmaster
Le postmaster de ce domaine. Un e-mail envoy une adresse inexistante sera redirig cette
adresse.
bool SignatureEnabled
Activer la signature
string SignatureHTML
146 / 214
La version HTML de la signature
eDomainSignatureMethod SignatureMethod
La mthode de signature du domaine
string SignaturePlainText
La version texte clair de la signature
long Size
Taille actuelle de ce domaine en Mo.
(lecture seule)
Objet DomainAlias
Description
L'objet DomainAlias reprsente un simple alias de nom de domaine hMailServer. A ne pas
confondre avec un Alias normal.
Mthodes
Delete()
Save()
Proprits
string AliasName
Alias
long DomainID
L'ID du domaine
long ID
ID
(lecture seule)
Objet DomainAliases
Description
L'objet DomainAliases est une collection de tous les alias de noms de domaine mis en place pour
un domaine spcifique.
Mthodes
Add()
147 / 214
Delete(long Index)
Supprime un lment de la collection
Supprime l'alias par l'identificateur de base de donn attribu.
Refresh()
Rafrachit
Proprits
long Count
Compte
(lecture seule)
DomainAlias Item(long Index)
Elment
(lecture seule)
DomainAlias ItemByDBID(long DBID)
ItemByDBID
(lecture seule)
Objet Domains
Description
L'objet Domains est une collection de tous les domaines mis en place dans l'installation de
hMailServer.
Methods
Add()
Ajoute un nouvel lment la collection
Supprime le domaine par l'identificateur de base de donn attribu.
Refresh()
Proprits
long Count
Le nombre d'objets dans la collection.
(lecture seule)
Domain Item(long Index)
Retourne un domaine par son index attribu dans la collection.
(lecture seule)
148 / 214
Domain ItemByDBID(long DBID)
Retourne un domaine par son identificateur de base de donne attribu attribu dans la
collection.
(lecture seule)
Domain ItemByName(string ItemName)
Retourne un domaine par son nom
(lecture seule)
string Names
Retourne une liste contenant l'ID du nom
(lecture seule)
Objet EventLog
Description
L'objet EventLog est utilis par event-implementors pour crire des messages dans le journal
d'vnements.
Mthodes
Write(string sMessage)
Ecrit un a message dans le journal d'vnements de hMailServer.
Objet FetchAccount
Description
L'objet FetchAccount reprsente un compte externe partir duquel hMailServer tlcharge les
messages.
Methods
Delete()
DownloadNow()
Effectue un tlchargement immdiat.
Save()
Enregistre l'objet dans la base de donnes.
Proprits
long AccountID
Le compte auquel ce compte externe est connect.
long DaysToKeepMessages
Le nombre de jours de conservation des messages sur le serveur externe.
149 / 214
bool Enabled
Le compte externe est activ.
long ID
ID
(lecture seule)
long MinutesBetweenFetch
Le nombre de minutes attendre entre chaque tlchargement.
string Name
Le nom du compte externe.
string NextDownloadTime
Prochaine tentative de tlchargement
(lecture seule)
string Password
Le mot de passe utiliser lors de l'ouverture de session sur le serveur externe.
long Port
Le port TCP/IP auquel hMailServer doit se connecter.
bool ProcessMIMEDate
Lire la date de rception depuis l'en-tte Reu.
bool ProcessMIMERecipients
Lire les destinataires du message depuis l'en-tte A/CC.
string ServerAddress
L'adresse du serveur POP3 auquel hMailServer doit se connecter.
long ServerType
Le type de serveur, POP3 seul pour l'instant.
string Username
Le nom d'utilisateur utiliser lors d'une ouverture de session sur le serveur externe.
bool UseSSL
Utiliser SSL pour le compte externe.
Objet FetchAccounts
Description
L'objet FetchAccounts est une collection de tous les comptes externes mis en place dans un
compte hMailServer.
Mthodes
Add()
150 / 214
Delete(long Index)
Supprimer
DeleteByDBID
Refresh()
Rafrachit
Properties
long Count
Compter
(lecture seule)
FetchAccount Item(long Index)
Elment
(lecture seule)
FetchAccount ItemByDBID(long DBID)
ItemByDBID
(lecture seule)
Objet GlobalObjects
Description
L'objet GlobalObjects est l'objet racine des objets hMailServer gnraux.
Proprits
DeliveryQueue DeliveryQueue
Distribuer la file d'attente
(lecture seule)
Languages Languages
Retourne une collection de langues GUI.
(lecture seule)
Objet GreyListingWhiteAddress
Description
L'objet GreyListingWhiteAddress contient une simple adresse de liste blanche qui ne sera pas
affecte par la liste grise.
Mthodes
Delete()
151 / 214
Save()
Proprits
string Description
Description de l'adresse IP.
long ID
L'identificateur unique de base de donnes pour l'objet.
(lecture seule)
string IPAddress
Adresse IP.
Objet GreyListingWhiteAddresses
Description
L'objet GreyListingWhiteAddresses est une collection de toutes les adresses de la liste blanche
partir de la liste grise.
Mthodes
Add()
Refresh()
Proprits
long Count
(lecture seule)
GreyListingWhiteAddress Item(long Index)
Retourne un objet par son index attribu.
(lecture seule)
GreyListingWhiteAddress ItemByDBID(long DBID)
Retourne un objet par son identificateur de base de donnes attribu
(lecture seule)
GreyListingWhiteAddress ItemByName(string sName)
152 / 214
Retourne un objet par son adresse IP.
(lecture seule)
Objet Group
Description
L'objet Group reprsente un simple groupe mis en place dans hMailServer.
Mthodes
Delete()
Save()
Proprits
long ID
L'identificateur de base de donnes de l'objet.
(lecture seule)
GroupMembers Members
Collection des membres du groupe
(lecture seule)
string Name
Le nom du groupe.
Objet GroupMember
Description
L'objet GroupMember reprsente un seul membre d'un groupe hMailServer.
Mthodes
Delete()
Save()
Proprits
Account Account
Retourne le compte rfrence par ce membre.
(lecture seule)
long AccountID
153 / 214
L'identificateur de base de donnes pour le compte du membre.
long GroupID
L'identificateur de base de donnes pour le groupe auquel ce membre appartient.
long ID
L'identificateur de base de donnes unique pour l'objet.
(lecture seule)
Objet GroupMembers
Description
L'objet GrupMembers est une collection de tous les membres d'un groupe.
Mthodes
Add()
Refresh()
Proprits
long Count
Nombre d'objets de la collection.
(lecture seule)
GroupMember Item(long Index)
Retourne un objet par son index.
(lecture seule)
GroupMember ItemByDBID(long DBID)
Retourne un objet par son identificateur de base de donnes
(lecture seule)
Objet Groups
Description
L'objet Groups est une collection de tous les groupes de serveurs mis en place dans hMailServer.
Mthodes
Add()
154 / 214
Refresh()
Proprits
long Count
(lecture seule)
Group Item(long Index)
(lecture seule)
Group ItemByDBID(long DBID)
Retourne un objet par son identificateur de base de donnes
(lecture seule)
Group ItemByName(string Name)
Retourne un objet par son nom
(lecture seule)
Objet IMAPFolder
Description
L'objet IMAPFolder reprsente un simple dossier IMAP.
Mthodes
Delete()
Supprime l'objet de a base de donnes.
Save()
Proprits
long ID
L'identificateur de base de donnes pour le dossier IMAP.
(lecture seule)
Messages Messages
Les messages dans ce dossier.
(lecture seule)
string Name
Nom du dossier IMAP.
155 / 214
long ParentID
Identificateur de base de donnes su dossier IMAP parent.
(lecture seule)
IMAPFolderPermissions Permissions
Permissions pour ce dossier IMAP
(lecture seule)
IMAPFolders SubFolders
Les dossiers IMAP dans ce dossier.
(lecture seule)
bool Subscribed
L'tat souscrit du dossier IMAP.
Objet IMAPFolderPermission
Description
L'objet IMAPFolderPermission reprsente une permission simple lie un dossier IMAP.
Mthodes
Delete()
Save()
Proprits
Account Account
Obtient le compte rfrenc par cette permission.
(lecture seule)
Group Group
Obtient le groupe rfrenc par cette permission.
(lecture seule)
long ID
L'identificateur unique de base de donnes pour la permission ACL.
(lecture seule)
bool Permission(eACLPermission iType)
Permission ACL
long PermissionAccountID
L'identificateur du compte auquel cette permission ACL est lie.
long PermissionGroupID
156 / 214
L'identificateur du groupe auquel cette permission ACL est lie.
eACLPermissionType PermissionType
Le type d'objet auquel cette permission ACL est lie.
long ShareFolderID
Le dossier qui a t partag
(lecture seule)
long Value
La valeur de la permission ACL.
Objet IMAPFolderPermissions
Description
L'objet IMAPFolderPermissions est une collection de toutes les permissions lies un dossier IMAP
public spcifique.
Mthoses
Add()
Ajoute une nouvelle permission la collection.
Delete(long Index)
Supprime la permission avec l'index spcifi.
Supprime une permission par sonn identificateur de base de donnes attribu.
Refresh()
Proprits
long Count
Retourne le nombre de permissions de la collection.
(lecture seule)
IMAPFolderPermission Item(long Index)
Retoourne une permission par un index donn.
(lecture seule)
IMAPFolderPermission ItemByDBID(long DBID)
Retourne une permission par son identificateur de base de donnes attribu.
(lecture seule)
IMAPFolderPermission ItemByName(string Name)
Retourne une permission par son nom.
(lecture seule)
157 / 214
Objet IMAPFolders
Description
l'objet IMAPFolders est une collection des dossiers IMAP racines ou des dossiers publics d'un
compte.
Mthodes
Add(string sName )
Ajoute un dossier IMAP avec le nom attribu la collection. L'enregistrement est immdiat.
Supprime un dossier IMAP avec l'identificateur de base de donnes attribu.
Properties
long Count
Retourne le nombre de dossiers IMAP de la collection
(lecture seule)
IMAPFolder Item(long Index)
Retourne un dossier IMAP par son index dans la collection.
(lecture seule)
IMAPFolder ItemByDBID(long DBID)
Retourne un dossier IMAP par son ID de base de donnes.
(lecture seule)
IMAPFolder ItemByName(string sName)
Retourne un dossier IMAP par son nom.
(lecture seule)
Objet Language
Description
L'objet Language reprsente une simple langue et contient sa fonctionnalit de traduction.
Proprits
string Name
Nom de la langue
(lecture seule)
string String(string EnglishString)
Une chane
(lecture seule)
Objet Languages
158 / 214
Description
L'objet Languages est une collection de toutes les langues accessibles par hMailServer.
Proprits
long Count
(lecture seule)
Language Item(long Index)
Retourne une langue par son index attribu dans la collection.
(lecture seule)
Language ItemByName(string ItemName)
Retourne une langue par son nom
(lecture seule)
Objet Links
Description
L'objet Links est un objet qui facilite l'accs aux objets dont l'ID est connu.
Proprits
Account Account(long DBID)
Retrouve un compte par son ID de base de donnes
(lecture seule)
Alias Alias(long DBID)
Retrouve un alias par son ID de base de donnes
(lecture seule)
DistributionList DistributionList(long DBID)
Retrouve une liste de diffusion par son ID de base de donnes
(lecture seule)
Domain Domain(long DBID)
Retrouve un domaine par son ID de base de donnes
(lecture seule)
Objet Logging
Description
L'objet Logging contient tous les paramtres relatifs la journalisation.
Methods
EnableLiveLogging(bool newVal)
Active la journalisation en direct.
159 / 214
Proprits
bool AWStatsEnabled
Crer un journal AWStats
string CurrentAwstatsLog
Chemin complet vers le journal awstats en cours
(lecture seule)
string CurrentDefaultLog
Chemin complet vers le journal par dfaut en cours
(lecture seule)
string CurrentErrorLog
Chemin complet vers le journal d'erreur en cours
(lecture seule)
string CurrentEventLog
Chemin complet vers le journal d'vnements en cours
(lecture seule)
eLogDevice Device
Priphrique de journalisation.
string Directory
Chemin vers le rpertoire log
(lecture seule)
bool Enabled
Journalisation active.
bool KeepFilesOpen
Garder ouvert le fichier journal entre les critures.
string LiveLog
Sortie du journal actuel en direct
(lecture seule)
bool LogApplication
Application du journal.
bool LogDebug
Messages de dbogage du journal
eLogOutputFormat LogFormat
Format du fichier journal
bool LogIMAP
Journal des conversations IMAP.
bool LogPOP3
160 / 214
Journal des conversations POP3
bool LogSMTP
Journal des conversations SMTP
bool LogTCPIP
Journal TCP/IP.
bool MaskPasswordsInLog
Masque les mots de passe avant de les crire dans le fichierjournal.
Objet Message
Description
L'objet Message reprsente un simple e-mail.
Mthodes
AddRecipient(STR sName, STR sAddress)
Ajoute un destinataire au message.
ClearRecipients()
Efface lle destinataire du message (y compris les en-ttes MIME).
Copy(long iDestinationFolderID)
Copie le message dans le dossier IMAP spcifi
HasBodyType(string BodyType)
Vrifie si le message contient un type de contenu spcifique.
RefreshContent()
Rafrachit le contenu du message
Save()
Enregistre le message. S'il s'agit d'un nouveau message, il sera distribu aprs enregistrement
Proprits
Attachments Attachments
Pices jointes du message.
(lecture seule)
string Body
Contenu en texte clair du message.
string CC
L'en-tte CC du message.
(lecture seule)
string Charset
161 / 214
Jeu de caractres principal du message.
string Date
En-tte Date du message.
long DeliveryAttempt
Nombre de tentatives de distribution.
(lecture seule)
bool EncodeFields
Encoder les champs.
string Filename
Nom du fichier dans lequel le message est enregistr.
(lecture seule)
bool Flag(eMessageFlag iType)
Indicateurs du message
string From
Expditeur du message.
string FromAddress
Adresse de l'expditeur du message.
MessageHeaders Headers
Collection des en-ttes du message.
(lecture seule)
string HeaderValue(string FieldName)
Valeur du champ d'en-tte donn.
string HTMLBody
Contenu HTML du message.
long ID
ID unique de base de donnes du message.
(lecture seule)
VARIANT InternalDate
Date et heure internes du message.
(lecture seule)
Recipients Recipients
Liste des destinataires du message
(lecture seule)
long Size
Taille du message, en Ko.
(lecture seule)
long State
162 / 214
tat du message.
(lecture seule)
string Subject
Sujet du message.
string To
En-tte A du message.
(lecture seule)
Objet MessageHeader
Description
L'objet MessageHeader reprsente un simple en-tte de message (un en-tte MIME).
Mthodes
Delete()
Supprime le champ de l'en-tte.
Properties
string Name
Nom de l'en-tte MIME.
string Value
Valeur de l'en-tte MIME.
Objet MessageHeaders
Description
L'objet MessageHeaders est la collection des en-ttes MIME d'un simple message.
Proprits
long Count
Nombre d'objets dans la collection.
(lecture seule)
MessageHeader Item(long Index)
(lecture seule)
MessageHeader ItemByName(string sName)
Retourne un objet par son nom. Lorsqu'il existe plusieurs correspondances, la premire est
retourne.
(lecture seule)
Objet Messages
163 / 214
Description
L'objet Messages est une collection des messages, habituellement lis un dossier IMAP
spcifique.
Mthodes
Add()
Ajoute un nouveau message cette collection.
Clear()
Efface tous les messages de la collection.
Supprime un message.
Proprits
long Count
Retourne le nombre de messages de la collection.
(lecture seule)
Message Item(long Index)
Retourne le message de la collection par son index.
(lecture seule)
Message ItemByDBID(long DBID)
Retourne le message de la collection par son ID de base de donnes.
(lecture seule)
Objet Recipient
Description
L'objet Recipient reprsente un simple destinataire de message (trouv dans l'enveloppe SMTP).
Proprits
string Address
L'adresse de messagerie de ce destinataire
(lecture seule)
bool IsLocalUser
Cet utilisateur est-il un utilisateur local?
(lecture seule)
string OriginalAddress
L'adresse de messagerie du message d'origine
(lecture seule)
164 / 214
Objet Recipients
Description
L'objet Recipients est une collection de tous les destinataires d'un message.
Properties
long Count
Dcompte
(lecture seule)
Recipient Item(long Index)
Elment
(lecture seule)
Objet Result
Description
L'objet Result est un objet temporaire utilis dans les vnements hMailServer pour permettre les
implmentations d'vnements pour la requte d'un comportement spcifique de hMailServer.
Proprits
string Message
Message
long Value
Valeur
Objet Route
Description
L'objet Route reprsente un itinraire de hMailServer.
Mthodes
Delete()
Supprime l'objet Domain de la base de donnes.
Save()
SetRelayerAuthPassword(string newVal)
Dfinit le mot de passe du serveur SMTP
Proprits
165 / 214
RouteAddresses Addresses
Adresses valides
(lecture seule)
bool AllAddresses
Itinraire vers toutes les adresses
string Description
Description de cet itinraire.
string DomainName
Nom du domaine.
long ID
ID de base de donnes.
(lecture seule)
long MinutesBetweenTry
Nombre de minutes entre chaque tentative
long NumberOfTries
Nombre de tentatives
string RelayerAuthUsername
Nom d'utilisateur du serveur SMTP
bool RelayerRequiresAuth
Le serveur SMTP ncessite une authentification
string TargetSMTPHost
Hte SMTP cible
long TargetSMTPPort
Port SMTP cible
bool TreatSecurityAsLocalDomain
Traiter la scurit comme pour les domaines locaux.
bool UseSSL
Utiliser SSL pour cet itinraire.
Objet RouteAddress
Description
L'objet RouteAddress reprsente un simple destinataire d'un itinraire.
Mthodes
Delete()
Supprime l'objet Domain de la base de donnes.
166 / 214
Save()
Proprits
string Address
Adresse.
long ID
ID de base de donnes.
(lecture seule)
long RouteID
ID d'itinraire
Objet RouteAddresses
Description
L'objet RouteAddresses est une collection de tous les destinataires d'un simple itinraire de
hMailServer.
Mthodes
Add()
DeleteByAddress(string sAddress)
Supprime un objet de la base de donnes par son adresse.
Supprime un objet de la base de donnes par son ID.
Proprits
long Count
(lecture seule)
RouteAddress Item(long Index)
Retourne une pice jointe par son index.
(lecture seule)
RouteAddress ItemByDBID(long DBID)
Retourne une adresse d'itinraire par son ID de base de donnes
(lecture seule)
Objet Routes
167 / 214
Description
L'objet Routes ets une collection de tous les itinraires mis en place dans l'installation de
hMailServer.
Mthodes
Add()
Supprime un objet de la base de donnes par son ID de base de donnes.
Refresh()
Proprits
long Count
Nombre d'objets dans la collection.
(lecture seule)
Route Item(long Index)
Retourne un itinraire par son index.
(lecture seule)
Route ItemByDBID(long DBID)
Retourne un itinraire par son ID de base de donnes.
(lecture seule)
Route ItemByName(string ItemName)
Retourne un itinraire par son nom de domaine.
(lecture seule)
Objet Rule
Description
L'objet Rule reprsente une simple rgle hMailServer.
Mthodes
Delete()
MoveDown()
Dplace la rgle vers le bas dans l'ordre de priorit
MoveUp()
Dplace la rgle vers le haut dans l'ordre de priorit
168 / 214
Save()
Proprits
long AccountID
ID du compte
RuleActions Actions
Actions pour cette rgle.
(lecture seule)
bool Active
Activer
RuleCriterias Criterias
Les critres pour cette rgle.
(lecture seule)
long ID
ID
(lecture seule)
string Name
Nom
bool UseAND
Utiliser AND
Objet RuleAction
Description
L'objet RuleAction reprsente une simple action dans une rgle spcifique.
Mthodes
Delete()
MoveDown()
Dplace la rgle vers le bas dans l'ordre de priorit
MoveUp()
Dplace la rgle vers le haut dans l'ordre de priorit
Save()
169 / 214
Proprits
string Body
Corps
string Filename
Nom de fichier
string FromAddress
De (adresse)
string FromName
De (nom)
string HeaderName
Nom d'en-tte
long ID
ID
(lecture seule)
string IMAPFolder
Dossier IMAP
long RouteID
ID d'itinraire pour la distribution
long RuleID
ID de la rgle
string ScriptFunction
Fonction du script excuter
string Subject
Sujet
string To
A
eRuleActionType Type
Type
string Value
Valeur
Objet RuleActions
Description
L'objet RuleActions est une collection de toutes les actions mises en place dans une simple rgle.
170 / 214
Mthodes
Add()
Ajouter
Delete(long DBID)
Refresh()
Rafrachir
Proprits
long Count
Dcompte
(lecture seule)
RuleAction Item(long Index)
lment
(lecture seule)
RuleAction ItemByDBID(long DBID)
lment par son ID de base de donnes
(lecture seule)
Objet RuleCriteria
Description
L'objet RuleCriteria reprsente un seul critre d'une rgle.
Mthodes
Delete()
Save()
Proprits
string HeaderField
Champ d'en-tte
long ID
ID
171 / 214
(lecture seule)
eRuleMatchType MatchType
Type de correspondance
string MatchValue
Valeur
eRulePredefinedField PredefinedField
Champ prdfini
long RuleID
ID de la rgle
bool UsePredefined
Utiliser la rgle prdfinie
Objet RuleCriterias
Description
L'objet RuleCriterias est une collection de tous les critres mais en place dans une simple rgle.
Mthodes
Add()
Ajouter
Delete(long DBID)
Supprime l'objet de la base de donnes par son index.
Refresh()
Rafrachir la collection.
Proprits
long Count
Compte
(lecture seule)
RuleCriteria Item(long Index)
Elment
(lecture seule)
RuleCriteria ItemByDBID(long DBID)
(lecture seule)
172 / 214
Objet Rules
Description
L'objet Rules est une collection des rgles. Elles sont soit gnrales, soit lies un compte
spcifique.
Mthodes
Add()
Ajouter
Refresh()
Rafrachir la collection
Proprits
long Count
Dcompte
(lecture seule)
Rule Item(long Index)
lment
(lecture seule)
Rule ItemByDBID(long DBID)
(lecture seule)
Objet Scripting
Description
L'objet Scripting contient tous les paramtres relatifs aux scripts.
Mthodes
CheckSyntax()
Compile le script dans le rpertoire event et retourne le rsultat.
Reload()
Recharge le script depuis le rpertoire event.
Proprits
string CurrentScriptFile
Le fichier de script actuellement utilis
173 / 214
(lecture seule)
string Directory
Le chemin au rpertoire events
(lecture seule)
bool Enabled
Activer le serveur de script
string Language
Langage du script
Objet SecurityRange
Description
L'objet SecurityRange reprsente une plage IP de hMailServer.
Mthodes
Delete()
Save()
Enregistre la plage de scurit dans la base de donnes.
Proprits
bool AllowDeliveryFromLocalToLocal
Autoriser la distribution de local local.
bool AllowDeliveryFromLocalToRemote
Autoriser la distribution de local distant.
bool AllowDeliveryFromRemoteToLocal
Autoriser la distribution de distant local.
bool AllowDeliveryFromRemoteToRemote
Autoriser la distribution de distant distant.
bool AllowIMAPConnections
Autoriser les connexions IMAP
bool AllowPOP3Connections
Autoriser les connexions POP3.
bool AllowSMTPConnections
Autoriser les connexions SMTP.
bool EnableAntiVirus
174 / 214
Activer la protection antivirale pour cette plage IP.
bool EnableSpamProtection
Activer la protection anti-spam pour cette plage IP.
long ID
ID de base de donnes
(lecture seule)
bool IsForwardingRelay
True s'il s'agit d'un relais de transfert.
string LowerIP
IP le plus bas
string Name
Nom de cet objet.
long Priority
Priorit de cette plage de scurit.
bool RequireAuthForDeliveryToLocal
Ncessite une authentification SMTP pour distribuer aux utilisateurs locaux.
bool RequireAuthForDeliveryToRemote
Ncessite une authentification SMTP pour distribuer aux utilisateurs distants.
string UpperIP
IP le plus lev
Objet SecurityRanges
Description
L'objet SecurityRanges est une collection de toutes les plages IP mises en place dans l'installation
de hMailServer.
Mthodes
Add()
Ajoute une nouvelle plage de scurit la collection.
Delete(long Index)
Supprime la plage de scurit par l'index spcifi.
Supprime la plage de scurit par l'ID de base de donnes spcifi.
Refresh()
175 / 214
SetDefault()
Revient aux paramtres de plage IP leurs valeurs par dfaut.
Proprits
long Count
(lecture seule)
SecurityRange Item(long Index)
Retourne une plage de scurit par un index attribu.
(lecture seule)
SecurityRange ItemByDBID(long DBID)
Retourne une plage de scurit par un ID de base de donnes.
(lecture seule)
SecurityRange ItemByName(string sName)
Retourne une plage de scurit par un nom attribu.
(lecture seule)
Objet ServerMessage
Description
L'objet ServerMessage reprsente un seul message de serveur personnalisable.
Mthodes
Save()
Proprits
long ID
L'ID unique de base de donnes pour l'objet.
(lecture seule)
string Name
Nom du message du serveur.
string Text
Message du serveur.
Objet ServerMessages
Description
L'objet ServerMessages est une collection des messages du serveur personnalisables.
176 / 214
Mthodes
Refresh()
Proprits
long Count
Nombre d'lments de la collection.
(lecture seule)
ServerMessage Item(long Index)
(lecture seule)
ServerMessage ItemByDBID(long DBID)
Retourne un objet par son ID de base de donnes
(lecture seule)
ServerMessage ItemByName(string sName)
Retourne un objet par son nom
(lecture seule)
Objet Settings
Description
L'objet Settings est l'objet racine pour tous les paramtres de hMailServer qui ne sont pas relatifs
un domaine spcifique.
Mthodes
SetAdministratorPassword(string newVal)
Dfinir le mot de passe d'Administration hMailServer principal
SetSMTPRelayerPassword(string newVal)
Dfinir le mot de passe du relais SMTP
Proprits
bool AddDeliveredToHeader
Dtermine si l'en-tte Distribu A doit tre ajout aux messages entrants.
bool AllowIncorrectLineEndings
Autoriser les messages avec des fins de ligne incorrectes (CR ou LF manquant).
bool AllowSMTPAuthPlain
Autoriser l'authentification SMTP en clair.
AntiSpam AntiSpam
177 / 214
Configuration anti-spam
(lecture seule)
AntiVirus AntiVirus
Configuration AntiVirus.
(lecture seule)
BackupSettings Backup
Obtient la sauvegarde de l'objet Settings
(lecture seule)
Cache Cache
Configuration du cache
(lecture seule)
string DefaultDomain
Domaine utiliser si le domaine n'a pas t spcifi lors de l'ouverture de session d'un utilisateur.
bool DenyMailFromNull
Refuser un message aved une adresse d'expditeur vide.
Directories Directories
Configuration du rpertoire
(lecture seule)
bool DisconnectInvalidClients
Dconnecter les clients qui ne suivent pas les RFC
Groups Groups
Collection de groupes.
(lecture seule)
string HostName
Obtient ou dfinit le nom d'hte sous lequel hMailServer s'identifie lui-mme.
bool IMAPACLEnabled
Active l'extension ACL IDLE.
bool IMAPIdleEnabled
Active l'extension IMAP IDLE.
string IMAPPublicFolderName
Nom du dossier public si IMAP est utilis.
bool IMAPQuotaEnabled
Active l'extension IMAP QUOTA.
bool IMAPSortEnabled
Active l'extension IMAP SORT.
Logging Logging
Obtient l'interface d'ouverture de session.
178 / 214
(lecture seule)
long MaxDeliveryThreads
Nombre maximum de processus de distribution SMTP.
long MaxIMAPConnections
Nombre maximum de connexions IMAP simultanes.
long MaxMessageSize
Taille maximum d'un message lors d'un envoi depuis ce serveur.
long MaxNumberOfInvalidCommands
Nombre maximum de commandes de client non valides avant dconnexion.
long MaxPOP3Connections
Obtient ou dfinit le nombre maximum de connexions POP3 simultanes.
long MaxSMTPConnections
Obtient ou dfinit le nombre maximum de connexions tp simultanes.
long MaxSMTPRecipientsInBatch
Nombre maximum de destinataires SMTP dans un lot lors de la distribution.
string MirrorEMailAddress
Copie de tous les messages envoys cette adresse.
string PublicFolderDiskName
Nom du dossier du disque dans lequel les dossiers publics sont stocks.
(lecture seule)
IMAPFolders PublicFolders
Dossiers publics
(lecture seule)
Routes Routes
Collection des itinraires.
(lecture seule)
long RuleLoopLimit
Nombre maximum de fois qu'un message peut tre trait par les rgles.
Scripting Scripting
Configuration du script
(lecture seule)
SecurityRanges SecurityRanges
Plages de scurit.
(lecture seule)
bool SendStatistics
Obtiennt ou dfinit si les statistiques doivent tre envoyes hMailServer.com
ServerMessages ServerMessages
179 / 214
Messages du serveurr
(lecture seule)
bool ServiceIMAP
Active le service IMAP.
bool ServicePOP3
Active le service POP3.
bool ServiceSMTP
Active le service SMTP.
string SMTPDeliveryBindToIP
Adresse TCP/IP laquelle se lier lors de la distribution d'un message aux htes distants.
long SMTPMinutesBetweenTry
Nombre de minutes entre chaque tentative lors de la distribution d'un message.
long SMTPNoOfTries
Nombre de tentatives lors que le serveur SMTP distribue un message.
string SMTPRelayer
Serveur relais fixe.
long SMTPRelayerPort
Port de serveur relais fixe
bool SMTPRelayerRequiresAuthentication
Le relais SMTP ncessite une authentification
string SMTPRelayerUsername
Nom d'utilisateur du relais SMTP
bool SMTPRelayerUseSSL
Dtermine si SSL doir tre uitlis lors de la distribution au serveur relais.
SSLCertificates SSLCertificates
Certificats SSL.
(lecture seule)
TCPIPPorts TCPIPPorts
Ports TCP/IP utiliser.
(lecture seule)
long TCPIPThreads
Nombre de processus TCP/IP (pour la communication) excuter.
bool UseDeliveryLog
Utiliser le journal de distribution.
string UserInterfaceLanguage
180 / 214
Utiliser la langue de l'interface
string WelcomeIMAP
Message d'accueil pour le serveur IMAP.
string WelcomePOP3
Message d'accueil pour le serveur POP3.
string WelcomeSMTP
Message d'accueil pour le serveur SMTP.
long WorkerThreadPriority
Priorit accorder aux processus de travail.
Objet SSLCertificate
Description
L'objet SSLCertificate reprsente un simple certificat SSL mis en place dans hMailServer.
Mthodes
Delete()
Save()
Proprits
string CertificateFile
Le fichierr certificat.
long ID
(read-only)
string Name
Le nom de l'objet.
string PrivateKeyFile
Le fichier de cl prive.
Objet SSLCertificates
Description
L'objet SSLCertificates est une collection de tous les certificats SSL mis en place dans hMailServer.
181 / 214
Mthodes
Add()
Clear()
Efface la collection.
Refresh()
Proprits
long Count
(lecture seule)
SSLCertificate Item(long Index)
Retourne un certificat SSL par son index.
(lecture seule)
SSLCertificate ItemByDBID(long DBID)
Retourne un certificat SSL par son ID de base de donnes
(lecture seule)
Objet Status
Description
L'objet Status contient les informations sur votre systme, comme la disponibilit et les
statistiques de base.
Proprits
long ProcessedMessages
Obtient le nombre de messages distribus
(lecture seule)
long RemovedSpamMessages
Obtient le nombre de messages de spam dtects
(lecture seule)
long RemovedViruses
Obtient le nombre de virus supprims
(lecture seule)
long SessionCount(eSessionType iType)
Obtient le nombre de sessions en cours
182 / 214
(lecture seule)
string StartTime
Obtient le temps de dmarrage du serveur
(lecture seule)
string UndeliveredMessages
Obtient une liste des messages non distribus.
(lecture seule)
Objet SURBLServer
Description
L'objet SURBLServer reprsente un simple serveur SURBL.
Mthodes
Delete()
Save()
Proprits
bool Active
L'objet est actif.
string DNSHost
L'hte DNS interroger.
long ID
(lecture seule)
string RejectMessage
Le message envoyer au client si le serveur refuse le message.
long Score
Score de spam
Objet SURBLServers
Description
L'objet SURBLServers est une collection de tous les serveurs SURBL mis e, place dns l'installation
hMailServer.
Mthodes
183 / 214
Add()
Suprime un objet de la base de donnes par son ID de base de donnes.
Refresh()
Proprits
long Count
(lecture seule)
SURBLServer Item(long Index)
Retourne un serveur SURBL par son index.
(lecture seule)
SURBLServer ItemByDBID(long DBID)
Retourne un serveur SURBL par son ID de base de donnes
(lecture seule)
SURBLServer ItemByDNSHost(string sDNSHost)
Retourne un serveur SURBL par son hte DNS
(lecture seule)
Objet TCPIPPort
Description
L'objet TCPIPPort reprsente une simple adresse et un port configurs pour tre sous la
surveillance de hMailServer.
Mthodes
Delete()
Save()
Proprits
string Address
Adresse TCP/IP laquelle se lier.
long ID
(lecture seule)
184 / 214
long PortNumber
Le numro du port TCP/IP.
eSessionType Protocol
Le type de protocole connect ce port.
long SSLCertificateID
L'ID du certificat SSL utiliser.
bool UseSSL
Utiliser SSL pour ce port TCP/IP.
Objet TCPIPPorts
Description
L'objet TCP/IPPorts contient une collection de tous les ports et adresses TCP/IP configurs pour
tre surveills par hMailServer.
Methods
Add()
Supprime un objet de la base de donnes par son Id de base de donnes.
Refresh()
SetDefault()
Gnre le rglage par dfaut des objets de la collection
Proprits
long Count
(lecture seule)
TCPIPPort Item(long Index)
(lecture seule)
TCPIPPort ItemByDBID(long DBID)
Retourne un objet par son ID de base de donnes
(lecture seule)
Objet Utilities
185 / 214
Description
L'objet Utilities contient les fonctions misc. utilises par hMailServer Administrator.
Mthodes
BlowfishDecrypt(string Input)
Dcrypte une chane depuis Blowfish.
BlowfishEncrypt(string Input)
Crypte une chane via Blowfish.
EmailAllAccounts(string sRecipientWildcard, string sFromAddress, string sFromName, string
sSubject, string sBody)
Envoie un message aux comptes du serveur.
GenerateGUID()
Retourne un GUID unique
GetMailServer(string EMailAddress)
Retourne le serveur de messagerie manipulant le message partir d'une adresse de messagerie
spcifie.
ImportMessageFromFile(string sFilename, long iAccountID)
Importe le message d'un fichier du disque ou d'un compte spcifique pour distribution.
ImportMessageFromFileToIMAPFolder(string sFilename, long iAccountID, string sIMAPFolder)
Importe le message d'un fichier du disque ou d'un compte spcifique pour distribution.
IsLocalHost(string sHostname)
Vrifie si le nom d'hte donn pointe sur localhost.
IsStrongPassword(string Username, string Password)
Retourne true si le mot de passe est faible
IsValidDomainName(string sDomainName)
Retourne true si le nom de domaine est valide.
IsValidEmailAddress(string EMailAddress)
Retourne true si l'adresse de messagerie est valide. false dans le cas contraire.
MakeDependent(string OtherService)
Rend le service hMailServer dpendant d'un autre service.
MD5(string Input)
Retourne la chane hexadcimale MD5 pour une chane.
RunTestSuite(string sTestPassword)
Excute une suite de tests. Ce qui supprimera tous les objets du serveur.
SHA256(string Input)
186 / 214
Retourne la chane hex SHA256 pour une chane.
Objet WhiteListAddress
Description
L'objet WhiteListAddress reprsente une simple adresse IP ou adresse de messagerie en liste
blanche.
Mthodes
Delete()
Save()
Proprits
string Description
Description de l'enregistrement.
string EmailAddress
Adresse de messagerie en liste blanche
long ID
L'ID de base de donnes unique pour l'objet.
(lecture seule)
string LowerIPAddress
Adresse IP la plus basse.
string UpperIPAddress
Adresse IP la plus leve.
Objet WhiteListAddresses
Description
L'objet WhiteListAdresses est une collection de toutes les adresses de messagerie / adresses IP
en liste blanche.
Mthodes
Add()
Clear()
Efface la collection.
187 / 214
Refresh()
Proprits
long Count
(lecture seule)
WhiteListAddress Item(long Index)
(lecture seule)
WhiteListAddress ItemByDBID(long DBID)
Retourne un objet par son ID de base de donnes.
(lecture seule)
Synchroniseur du rpertoire Data
Contexte
Lorsque hMailServer reoit un message, les informations concernant ce message sont
enregistres deux emplacements. Les informations sur l'enveloppe SMTP, la date de rception et
les indicateurs du message sont placs dans la base de donnes de hMailServer (tables
hm_messages et hm_messagerecipients). Le message lui-mme est plac dans un fichier .eml
stock dans le dossier Data de hMailServer.
Dans certaines situations, ces deux emplacements peuvent ne plus tre synchroniss. Par
exemple, si une table de base de donnes devient corrompue, des messages du dossier Data
peuvent ne pas tre rfrencs par la base de donnes. Si cela se produit, vous ne pourrez plus
tlcharger les messages avec votre client de messagerie. Et si les messages n'ont pas t
distribus, hMailServer ne le fera pas
La solution ce problme consiste utiliser le Synchroniseur du Dossier Data (DDS) de
hMailServer. L'outil est install avec hMailServer et situ dans le dossier Addons.
Que fait-il?
Le Synchroniseur du Dossier Data parcourt tous les fichiers message du dossier Data. Il recherche
les fichiers dont l'extension est .hma ou .eml (les anciennes versions de hMailServer utilisaient
.hma comme extension, et dsormais .eml est utilis). Lorsqu'un fichier .eml est dtect, il vrifie si
le fichier est rfrenc par la base de donnes, sinon, le message est insr dans la base de
donnes.
Si le fichier .eml existe dans un dossier utilisateur, hMailServer insre le message dans ce compte
utilisateur. Le message termine alors dans le dossier Inbox (bote de rception) de l'utilisateur.
Les information du dossier IMAP sont stockes dans la base de donnes, et comme ces infos ont
t perdues, hMailServer ne sait pas dans quel dossier olacer le message.
Si le fichier .eml existe dans le dossier racine Data, le message est insr dans la file d'attente de
distribution. hMailServer analyse les en-ttes A et CC du message pour dterminer qui le
message doit tre distribu. Pour viter que le message soir re-distribu aux destinataires,
hMailServer n'envoie les messages qu'aux destinataires locaux.
188 / 214
Comment puis-je l'excuter?
1.Sauvegardez votre systme. Le DDS effectue une quantit de modifications relativement
importantes dans la base de donnes. De ce fait, il est conseill de tout sauvegarder avant
d'excuter le DDS.
2.Cherchez DataDirectorySynchronizer.exe dans le dossier Addons et excutez-le.
3.Cliquez sur Suivant pour lancer la synchronisation.
Qu'est-ce qui est import?
Comme les donnes d'un message IMAP, telles les informations de dossier, les indicateurs de
message, etc sont stockes dans la base de donnes et pas dans le fichier message, ces
information ne seront pas re-cres lors de la reconstruction de la liste des messages. Par
consquent, lorsque les messages sont insrs dans la base de donnes, ils se retrouveront tous
dans la bote de rception et marqus comme non lu.
Seuls les fichiers avec l'extension .eml ou .hma sont importes dans la base de donnes
Pour chaque fichier qui existe dj dans la base de donnes, vous verrez un message "ignor".
O les messages imports seront-ils placs?
Les fichiers situs dans le dossier Data racine seront remis aux destinataires locaux des en-ttes
A et CC. Les informations de destinataire d'origine, de l'enveloppe SMTP, ne sont pas disponibles
dans les fichiers. EML. Par consquent, les en-ttes To / CC sont utiliss. E-mail ne sont remis aux
seuls destinataires locaux pour viter que des messages ne soient re-transmis des adresses
externes.
Les fichiers situs dans les sous-rpertoires du dossier de donnes, telles que le domain
\username seront relis cet utilisateur dans la base de donnes.
Les fichiers imports directement dans les comptes d'utilisateurs ne seront pas traits par les
filtres, les rgles, les fonctions de dtection de virus dans hMailServer
Quel effet a t-il sur la production?
Vous n'avez pas arrter hMailServer avant d'excuter DDS.
Aprs l'importation de tous les messages, DDS redmarrer automatiquement le serveur
hMailServer pour actualiser le cache.
Configuration des antivirus externes

Gnralits
Cette rubrique prsente des exemples de ligne de commande d'antivirus externes qui
fonctionnent avec hMailServer.
AVG Free 7
Ligne de commande: "C:\Program Files\Grisoft\AVG Free\avgscan.exe" /EXT=* /NOBOOT /
NOMEM /SCAN /NOSELF /NOHIMEM /ARC "%FILE%"
Retourne la valeur: 6
AVG Free 8
Notez que pour les versions antrieures AVG Free 8, avgscanx.exe ne retourne pas de valeur
indiquant si un virus a t dtect. Pour pouvoir utiliser la ligne de commande ci-dessous, vrifiez
189 / 214
que vous avez une version jour de AVG Free 8 sur http://free.avg.com/.
Ligne de commande: "C:\Program Files\AVG\AVG8\avgscanx.exe" /EXT=* /NOBOOT /NOMEM /
SCAN="%FILE%" /NOSELF /NOHIMEM /ARC
Retourne la valeur: 5
Implmentation de fonctionnalits
Comment puis demander une fonctionnalit?
Si vous souhaitez demander une fonctionnalit, ajoutez-la la section Feature du forum des
utilisateurs. Si vous ne savez pas si la fonctionnalit est dj implment, demandez-le d'abord
la section Discussions Gnrales
Qnand ma fonctionnalit sera t-elle implmente?
Quand une demande de fonctionnalit a t prsente la section de demande de fonctionnalit
du forum, un sondage est ajout. En utilisant le scrutin, d'autres utilisateurs de hMailServer
peuvent voter pour ou contre la fonctionnalit.
L'quipe de dveloppement hMailServer utilise ces votes pour dcider des fonctionnalits
implmenter. La rgle gnrale est que les fonctions qui ont reu le plus de votes populaires
seront mis en uvre en premier lieu, les fonctions qui ont reues moins de voix positives seront
mises en uvre ultrieurement.
Sur la page des rsultats du vote, vous pouvez voir une top-list des demandes les plus
populaires.
Il existe certaines exceptions cette rgle.
Les fonctions importantes, qui ncessitent une refonte interne importante, sont normalement
reportes une version majeure (comme 5.0, 6.0). Exemples de telles fonctionnalits: "prise en
charge Full SSL" et "prise en charge multi-plateformes". La raison en est que l'ajout de plus
grandes fonctionnalits ncessite de nombreux tests et prend plus de temps. Et les versions
mineures, telles que 4.1, 4.2 devraient tre publis plus souvent, et on ne peut pas mettre en
uvre des fonctionnalits haut risque.
Certains utilisateur risquent de rencontrer un problme o il est tout simplement incapable
d'utiliser correctement le serveur en raison de la faon dont d'autres serveurs fonctionnent. S'il n'y
a pas de solution raisonnable ce problme, cette demande reoit une priorit plus leve. Cela
s'applique uniquement aux fonctionnalits de base du serveur. Par exemple, "Je ne peux pas
utiliser ce logiciel tant qu'il ne peut pas utiliser les listes de diffusion" ne relve pas de cette
catgorie.
Les trs petites fonctions qui peuvent tre mises en uvre sans aucun risque, et en quelques
minutes, reoivent une priorit plus leve.
Une entreprise peut dcider d'acheter une nouvelle fonctionnalit de hMailServer. Cette nouvelle
fonctionnalit sera alors implmente paralllement aux autres caractristiques.
Questions souvent poses
Question 1 - Qu'est-ce que hMailServer?
hMailServer est un serveur de messagerie pour Microsoft Windows. Il vous permet de grer tous
vos mails vous-mme sans avoir dpendre d'un fournisseur de services Internet (FAI) pour ce
faire. Compar votre FAI, hMailServer ajoute flexibilit et scurit et vous donne le plein contrle
sur la protection anti-spam.
Question 2 - Qui utilise hMailServer?
190 / 214
hMailServer est utilis par un grand nombre de diffrents types d'utilisateurs. Voici quelques
exemples:
Le type le plus commun est l'entreprise qui utilisent hMailServer pour hberger la messagerie de
ses propres domaines.
hMailServer est galement utilis par les petits et important fournisseurs d'accs Internet pour
hberger la messagerie pour leurs clients.
Diffrents gouvernements travers le monde utilisent hMailServer pour hberger leurs e-mails.
D nombreuses personnes et familles excutent hMailServer chez eux pour rduire la quantit de
spam qui envahit leur bote de rception.
Question 3 - Quand dois-je utiliser hMailServer?
Toute personne ayant une adresse de messagerie peut bnficier de l'utilisation de hMailServer.
En rgle gnrale, les organisations et les personnes qui ont enregistr un nom de domaine sur
Internet utilisent hMailServer pour hberger la messagerie de ce domaine.
Question 4 - Dois-je tre connect Internet pour excuter hMailServer?
Non, vous pouvez excuter utilisent hMailServer sans tre connect Internet, mais avec la
limitation vident que ne pas pouvoir envoyer des courriels d'autres personnes sur Internet.
Question 5 - Combien de domaines, de comptes et de messages hMailServer peut-il grer?
Cela dpend principalementdu matriel de l'ordinateur qui utilise hMailServer et du type
d'utilisateurs. Par exemple, si vos utilisateurs sont trs actifs, vous devez avoir un un serveur
rapide par rapport des utilisateurs qui ne vrifient pas souvent leur messagerie. Il existe des
installations de hMailServer avec des dizaines de milliers de comptes utilisateurs sur un seul
serveur.
Question 6 - Comment puis-je dmarrer?
La premire chose que vous devez faire est de dterminer ce que vous voulez faire de
hMailServer. Ensuite, suivez le didecticiel d'installation.
Question 7 - J'ai install hMailServer, que dois-je faire ensuite?
Cela dpend de la faon dont vous prvoyez d'utiliser hMailServer. Si vous voulez hberger la
messagerie de votre propre nom de domaine, vous devez ajouter un domaine et les comptes
utilisateurs pour hMailServer. Les tapes pour ce faire sont dcrites sur cette page: Configuration
de base.
Question 8 - Je reois le message "Authentification SMTP requise" si j'essaie d'envoyer un
message. Que dois-je faire?
Il s'agit d'un message d'erreur courant, d, dans la plupart des cas un client de messagerie mal
configur. Vrifier les rubriques suivantes pour obtenir des informations sur les messages
d'erreur: Messages d'erreur
Question 9 - Dois-je dfinir les noms d'hte pop.example.com, smtp.example.com et ainsi de
suite?
C'est inutile d'un point de vue technique, d'avoir plusieurs noms d'hte pour rsoudre la mme
adresse IP. Tant que le nom d'hte que vous utilisez pointe sur la bonne adresse IP, peu importe
le nom d'hte.
191 / 214
Autres considrations techniques:
Pourquoi les messages entiers ne sont-ils pas enregistre dans la base de donnes?
Pourquoi be pas enregistrer seulement les pices jointes sur le disque dur?
Pourquoi existe t-il des dossiers vides dans le rpertoire Data?
FAQ: Informations d'hbergement
Informations d'hbergement de hMailServer
hMailServer est un serveur de messagerie. Ce qui signifie que c'est un logicielqui fonctionne sur
un ordinateur, qui peut tre utilis par les entreprises, les organisations et les individus pour
hberger des messages. hMailServer.com ne fournit pas de services de courrier lectronique, mais
seulement les logiciels qui sont utiliss pour crer des services de messagerie.
Si vous avez des problmes avec hMailServer, mais que vous ne l'avez pas install vous-mme,
vous devez contacter l'administrateur du serveur de messagerie. Si vous avez votre propre nom
de domaine, l'administrateur est gnralement la socit que vous payez chaque mois /
trimestre / anne pour ses services.
Stocker les pices jointes seules sur le disque dur

Question: Pourquoi ne pas enregistrer les pices jointes seules sur le disque
dur?
La question semble impliquer que le corps et les pices jointes sont des entits distinctes, ce
qu'ils ne sont pas. Un message lectronique est un flux continu d'octets, qui comprend un en-
ttes, un corps, des pices jointes etc . Lorsque hMailServer envoie ou reoit des donnes, il le fait
sous la forme de donnes codes MIME, pas sous la forme de donnes binaires, ce qui inclut
pices jointes. Chaque message est remis au client de messagerie tel qu'il a t reu, c'est alors
au client de savoir quoi en faire .
Actuellement, ce que hMailServer fait consiste obtenir un flux de donnes partir du rseau, de
les stocker dans un fichier exactement comme il a t reu, et la remettre au client de courrier
lectronique la demande. Finalement, si un antivirus est prsent, il devra dcoder le MIME du
message en entier et effectuer un examen antivirus.
Cependant, selon votre suggestion, chaque message devrait tre dcod MIME au niveau du
serveur, les pices jointes extraites du message et stockes sous forme de donnes binaires, et
le reste stock dans la base de donnes. Les pices jointes doivent ncessairement tre des
donnes binaires simples (pas encod MIME en utilisant base64 ou tout autre algorithme), sinon
elles ne peuvent pas tre examines pour les virus.
Ce scnario conduirait au moins deux problmes:
Problme 1: Lorsque hMailServer accepte un message, il doit alors le dcoder de Base64/Quoted-
Printable et stocker chaque pice jointe sur le disque, ayant en fait le dcoder MIME le message
entier avant de pouvoir l'enregistrer. Ce qui lve non seulement les besoins en mmoire, mais
aussi consomme beaucoup de CPU.
Problme 2: Quand un client POP3 demande ce message, le serveur devrait encoder MIME toutes
les pices jointes et les remettre dans un flux unique avant de les envoyer. Ce qui aurait, encore
une fois, pour effet d'augmenter l'utilisation de la mmoire etdu processeur.
Ainsi, demander hMailServer d'extraire les pices jointes ne servirait rien, parce que cela
entranerait, en fait, plus de travail, pas moins.C'est pourquoi extraire les pices jointes du
message est traditionnellement le rle du client de messagerie, pas celui du serveur.
Enregistrer le message dans la base de donnes
192 / 214
Question: Pourquoi les messages entiers ne sont-ils pas stocks dans la
base de donnes?
Stocker les e-mails pourrait avoir quelques avantages. Par exemple, il serait plus facile pour
hMailServer de sauvegarder si toutes les donnes ont t stockes dans base de donnes.
Cependant, il pourrait galement y avoir de srieux inconvnients:
Consommation plus leve de mmoire
Quand un message est transmis par hMailServer un client ou un autre serveur de messagerie,
hMailServer dlivre le message par portions de 50Ko. hMailServer lit la valeur de 50Ko de donnes
du message stock sur le disque en mmoire. Il les envoie au client, et libre la mmoire de 50Ko.
Ainsi, quand hMailServer envoie un message, l'utilisation de la mmoire n'a jamais besoin de
dpasser 50 Ko par message. Il n'existe pas de moyen adquat pour lire des portions de 50Ko
d'un message partir de la base de donnes. Si le message a t enregistr dans la base de
donnes, hMailServer devra lire l'intgralit de la base de donnes et mettre en cache ce qui est
dans la mmoire, ce qui augmenterait considrablement l'utilisation de celle-ci.
Utilisation plus importante du CPU
Stocker le message dans la base de donnes impliquerait plusieurs tches supplmentaires, ce
qui consommerait tous les cycles de CPU:
Si le message tait stocke dans la base de donnes, il ne serait pas possible d'effectuer un
examen antivirus. Ainsi, hMailServer aurait extraire l'intgralit du message de la base de
donnes et en stocker les donnes sur le disque dur, avant de l'examiner, puis supprimer
nouveau le fichier partir du disque. Vous pourriez utiliser un examen antiviral de la mmoire
pour rsoudre ce problme, mais vous seriez loin des infections possibles des API.
Les anciennes versions de MySQL ont d'assez faible limite de dure maximale de requte. Stocker
un message lors de l'utilisation de ces versionsncessiterait que hMailServer divise les donnes
en plusieurs commandes SQL et les excute une une.
Il n'est pas possible d'excuter
insert into table (column) values ('the-puremessage-data')
.
Avant cela, hMailServer aurait chercher dans l'intgralit du message et "extraire" " les
caractres spciaux, par exemple, extraire ' en \'. Pour contourner cela, vous pouvez utiliser des
procdures stockes, mais tous les moteurs de base de donnes que hMailServer prend en
charge, ne prennent pas en charge les procdures stockes.
gestion plus difficile
Stocker des e-mails sur le disque donne l'administrateur un bon aperu des messages sur le
serveur. Il est possible d'afficher un e-mail juste en double-cliquant dessus, et de le supprimer en
appuyant simplement sur la touche Suppr du clavier. Si les messages ont t stocks dans la base
de donnes, l'administrateur doit savoir comment excuter des instructions SQL.
Pourquoi des dossiers vides dans le rpertoire Data?
Question: Pourquoi existe t-il des dossiers vides dans le rpertoire Data?
hMailServer stocke les e-mails dans le rpertoire Data. Les fichiers de messages sont stocks
dans des sous-rpertoires nomms aprs la cration des comptes de domaine et d'utilisateur.
Dans les premires versions de hMailServer, les fichiers de messages taient stocks directement
dans le dossier du compte utilisateur (exemple:
hMailServer/Data/domain.com/utilisateur1/
.
Quand il y avait 50 000 messages dans un compteutilisateurs, il y avait 50 000 messages dans le
dossier de donnes des utilisateurs. tant donn que Windows ne gre pas efficacement les
dossiers volumineux, ces nombreux les fichiers de messages ont eu un effet ngatif sur les
performances de hMailServer.
193 / 214
Pour amliorer les performances, hMailServer stocke dsormais les fichiers de messages dans des
sous rpertoires composs de 2 caractres de 0 9 et de A F. Ces sous-rpertoires sont crs
dynamiquement en cas de besoin, mais ils ne sont pas supprims tant que le compte n'est pas
supprim. De ce fait, il peut y avoir plusieurs sous-rpertoires vides. tant donn que le nom d'un
rpertoire ne se compose que de deux caractres, il y aura au plus 256 sous-rpertoires.
Structure d'un dossier hMailServer
/Addons Ajour de scripts et utilitaires
/Bin Fichiers binaires hMailServer.
Le serveur actuel et
hMailAdmin
/Data Messages E-mail. Les fichiers
dans la racine Data sont des
messages qui n'ont pas encore
t distribus. Les sous-
dossiers contiennent les
messages distribus. Les e-
mails ont pour extension. hma
ou. .eml, en fonction de la
version dans laquelle
hMailServer les crs.
/DBScripts Les scripts SQL qui sont
utiliss lors de la mise
niveau d'une version l'autre.
Les fichiers ont la norme de
dnomination suivante:
UpgradeXXXXtoYYYYZZZZ.sql.
XXXX est l'ancienne version,
YYYY est la nouvelle version
et ZZZZ est le type du serveur
de base de donnes.
/Events Scripts VBA et JavaScript
utiliss par hMailServer.
/Languages Traduction de l'interface
utilisateur de hMailServer.
/Logs Fichiers journaux crs par
hMailServer.
/MySQL Le serveur MySQL
/PHPWebAdmin L'interface d'administration
web PHP pour hMailServer.
/Temp Dossier temporaire utilis par
hMailServer. Utilis, par
exemple, quand hMailServer
extrait les pices jointes qui
sont examiner pour les
virus. Lorsque hMailServer
extrait une pice jointe pour
194 / 214
un examen viral, l'extension
.tmp lui est attribue.
COMMENT..
How do I...
Installation
configure DCOM permissions for IIS
use ASSP with hMailServer?
configure hMailServer to use a specific language?
Configuration
move spam to a specific IMAP folder?
configure hMailServer to act as a backup server?
configure hMailServer to act as a local, stand-alone server?
route all email through my ISP's server?
setup IP ranges for my home network?
Maintenance
change the data directory?
clear the delivery queue
repair a corrupt MySQL table?
re-insert messages into the database when the database entries have been lost?
change hMailServer Administrator password?
enable SMTP authentication in my email client?
Agir en tant que sauvegarde MX
Contexte
Dans DNS, il est possible de configurer un domaine pour qu'il puisse avoir plusieurs
enregistrements Mail Exchange (MX). Les diffrents enregistrements MX ont des prfrences ou
priorit diffrentes. L'expditeur d'un e-mail va d'abord essayer de distribuer au MX avec la
prfrence la plus basse, et ensuite aux autres. Les serveurs de messagerie en cours d'excution
sur les enregistrements MX avec une prfrence leve peuvent donc tre considrs comme des
serveurs de messagerie de sauvegarde.
Exemple
Hte
Prfrenc
e
mail.hmailserver.com 25
mail-backup.hmailserver.com 50
Un expditeur qui m'envoie un e-mail va d'abord essayer de le distribuer mon serveur,
mail.hmailserver.com. Si la distribution mon hte choue pour une raison quelconque, par
exemple, en raison d'erreurs de rseau ou d'un crash de la machine, l'expditeur va essayer de le
distribuer au serveur, messagerie backup.hmailserver.com. Le serveur de messagerie-
backup.hmailserver.com devra alors transfrer le message chaque fois que mail.hmailserver.com
est en ligne. Les tapes indiquent comment configurer l'installation hMailServer s'excutant sur
mail-backup.hmailserver.com pour transfrer tout le courrier du domaine hmailserver.com l'hte
195 / 214
mail.hmailserver.com.
tapes
2.Accdez Configuration
3.Dployez le nud des paramtres SMTP
4.Slectionnez Itinraire et cliquez sur Ajouter
5.Spcifiez ce qui suit:
o
Domaine - Nom du domaine que vous souhaitez sauvegarder. Cela ne devrait pas tre un
domaine configur sur votre serveur.
o
Hte SMTP Cible - Nom d'hte ou, de prfrence, l'adresse IP de l'ordinateur vers lequelle
tous les messages du domaine doivent tre transfrs.
o
Port TCP - Le port TCP/IP que l'hte SMTP cible surveille.
o
Slectionnez l'expditeur qui doit tre trait comme externe et les destinataires comme
locaux. Quand quelqu'un envoie un e-mail partir du nom de domaine de l'itinraire, ils doit
tre considr comme externe. Si quelqu'un vous envoie un e-mail avec le nom de domaine,
il doit tre considr comme local. Ceci a pour effet que hMailServer va permettre la
distribution au nom de domaine de l'itinraire sans authentification SMTP.
o
Page adresse - Si vous avez une liste des adresses e-mail existantes sur l'hte SMTP cible,
vous pouvez les spcifier ici. Si vous faites cela, hMailServer rejettera les e-mail envoy
des adresses non-existantes.
o
Page Distribution - Indiquez le nombre de fois que hMailServer devra essayer de distribuer
ce serveur.
Les indications ci-dessous sont valables pour les versions 5.2 et suprieures.
196 / 214
Administrer distance hMailServer
Gnralits
Ce guide dcrit comment administrer hMailServer distance. L'ordinateur A est l'ordinateur o
hMailServer doit tre excut, et l'ordinateur B est l'ordinateur que vous voulez administrer depuis
hMailServer. Les deux ordinateurs sont dans le mme domaine Windows. L'administration
distance est effectue l'aide de DCOM.
Ordinateur A
Installer hMailServer normalement.
Ordinateur B
Vous devez avoir Administrateur hMailServer install, et la bibliothque hMailServer COM dois tre
enregistre. Comme il n'y a pas d'installation qui ne fait que cela, vous devez mettre en place une
installation complte de hMailServer et ensuite dsactiver le service de hMailServer. Pour installer
hMailServer sur l'ordinateur B, suivez ces tapes:
1.Installez la mme version de hMailServer que sur l'ordinateur A.
2.Ouvrez le Panneau de Configuration, Outils d'Administration, Services.
3.Cherchez le service hMailServer, arrtez-le et dsactivez-le.
Ensuite, vous devez indiquer Windows que lorsque vous utilisez l'administrateur hMailServer,
vous souhaitez administrer l'installation hMailServer s'excutant sur l'ordinateur A. Cela se fait en
197 / 214
modifiant les paramtres de l'objet COM hMailServer sur l'ordinateur B.
1.Ouvrez le Panneau de Configuration, Outils d'Administration, Services de Composants.
2.Dployez le composant Services de Composants->Ordinateurs->Poste de Travail->Configuration
DCOM.
3.Cherchez hMailServer
4.Faites un clic droit dessus et choisissez Proprits
5.Dans l'onglet Localisation, d-slectionnez Excutez l'application sur cet ordinateur et activez
Excuter l'application sur l'ordinateur suivant
6.Indiquez le nom de l'Ordinateur A
hMailAdmin de l'Ordinateur B doir dsormais administrer hMailServer sur l'Ordinateur A.
Effacer la file d'attente de distribution
Contexte
La file d'attente de distribution de hMailServer se compose de deux parties, la liste des messages
de la file d'attente dans la base de donnes et les messages rels dans le dossier Data. La
mthode pour supprimer la file d'attente de distribution dpend de la version hMailServer que
vous utilisez.
hMailServer 4.1 et antrieurs
Pour supprimer la file d'attente de distribution, supprimez tous les fichiers dans la racine du
rpertoire Data. Si vous avez install hMailServer sur C:\Program Files\hMailServer supprimez tous
les fichiers du rpertoire C:\Program Files\hMailServer\Data\. Pour chaque fichier que vous
supprimez, hMailServer supprime le message de la base de donnes et signale une erreur dans le
journal d'erreur comme quoi le message n'a pas pu tre distribu puisque le fichier de message a
t supprim. Ne supprimez pas les sous-dossiers du rpertoire Data, car ils pourraient contenir
des messages pour les comptes d'utilisateurs.
hMailServer 4.2 et suprieurs
A la section tat de hMailAdmin, slectionnez l'onglet "Messages non distribus" et cliquez sur
Effacer la file d'attente. hMailServer commencera alors effacer toute la file d'attente.
Se connecter MySQL
Cette section dcrit comment se connecter la base de donnes MySQL pour excuter des
instructions.
tapes 1: Dterminer le mot de passe MySQL
Si vous utilisez une version externe de MySQL, vous devez dj connatre votre mot de passe
MySQL. Si vous utilisez la version intgre de MySQL fournie avec hMailServer, vous ne connaissez
peut-tre pas votre mot de passe. Pour le dterminer, procdez comme suit:
1.Ouvrez hMailserver.ini, situ dans votre dossier Windows.
2.Si vous nne trouvez pas passwordencryption=1 dans le fichier, localisez le mot de passe dans le
fichier et allez Etape 2: Se connecter au serveur ci-dessous.
3.Excutez le script \hMailServer\Addons\Utilities\DecryptBlowfish.vbs.
4.Copiez le mot de passe de hMailServer.ini dans la bote de dialogue DecryptBlowfish.
5.Cliquez sur OK dans DecryptBlowfish pour afficher votre mot de passe. DecryptBlowfish affichera
alors votre mot de passe. Gardez la bote de dialogue ouverte ou mmorisez votre mot de passe.
tapes 2: Se connecter au serveur
Pour vous connecter MySQL, il vous faut un client MySQL. Vous pouvez utiliser MySQL Front pour
ce faire.
1.Tlchargez et dcompressez MySQLFront
2.Excutez MySqlFront.exe
3.Dans le bote de dialogue de connexion, cliquez sur Nouveau
198 / 214
4.Entrez les informations de connexion pour votre serveur MySQL. Si vous utilisez le serveur
intgr, vous devez entrer le nom d'hte: localhost, utilisateur: root, mot de passe: le mot de
passe, port: 3307
5.Cliquez sur Connexion pour vous connecter au serveur de base de donnes.
Maintenant, vous tes connect MySQL.
tapes 3: Excuter des instructions
Aprs vous tre connect MySQL, vous pouvez excuter des instructions en suivant ces tapes:
1.Dans l'arborescence de gauche, cliquez sur la base de donnes hmailserver. Vous verrez droite
la liste des tables de la base de donnes.
2.Au-dessus de la liste des tables, vous verrez un "onglet" avec pour titre Requte . Cliquez sur
cet onglet.
3.Entrez votre requte SQL
4.Cliquez sur le bouton Executer SQL ou appuyez sur la touche de clavier F9 pour excuter la
requte.
Permissions DCOM
Gnralits
Par dfaut, IIS 6 n'est pas autoris se connecter hMailServer en raison des autorisations
Distributed COM qu'utilise Windows. De mme, Apache fonctionner comme un compte d'utilisateur
avec des autorisations restreintes et n'est pas autoris se connecter par dfaut.
tapes
Suivez ces tapes pour attribuer IIS ou Apache les permissions requises pour se connecter
hMailServer en utilisant DCOM.
1.Lancez DCOMconfig en cliquant sur Dmarrer, Excuter, entrez dcomcnfg.exe et cliquez sur OK.
2.Dans le programmeServices des composants, dployez le dossier Services des Composants
3.Allez Ordinateurs | Poste de Travail | DCOM Config
4.Faites un clic droit sur hMailServer et choisissez Proprits
5.Ouvrez l'onglet Scurit
6.Sous "Lancer et Activer les Permissions", slectionnez Personnaliser et cliquez sur diter
7.Sous "Groupe ou noms des utilisateurs", cliquez sur Ajouter
8.Pour IIS6: ajoutez le compte d'utilisateur intgr anonyme IIS
9.Pour Apache: ajoutez le compte d'utilisateur Apache
10.Rglez les permissions Lancement Local et Activation Locale pour ces utilisateurs sur Autoriser.
Examen antiviral externe - valeur de retour
Gnralits
Si vous avez l'intention d'utiliser un antivirus externe pour hMailServer, vous devez configurer la
valeur de retour dans hMailAdmin. Il ya deux faons de dterminer la valeur entrer. Soit en lisant
la documentation de votre antivirus soit en le testant vous-mme. On va maintenant dcrire
comment tester soi-mme. Notez que vous ne devriez jamais effectuer le test sur un systme
hMailServer de production, car il y a le risque que mme e-mail sans virus soit supprim lors du
test.
La valeur retourne est normalement sirue entre 1 et 255.
Dterminer la valeur
199 / 214
Etape 1: Activer l'examen antiviral
1.Lancez hMailAdmin
2.Accdez aux paramtres de l'antivirus externe.
3.Slectionnez Utiliser l'examen antiviral externe.
4.Indiquez le chemin complet de votre antivirus.
5.Entrez la valeur de retour 250.
Etape 2: Activez la journalisation et vrifiez la valeur de retour
1.Activez l'application et le journal de dbogage.
2.Envoyez un e-mail qui contient le virus test eicar.
3.Vrifiez la valeur de retour dans le fichier journal.
4.Envoyez un e-mail qui ne contient le virus test eicar.
5.Vrifiez la valeur de retour dans le fichier journal.
Dans hMailAdmin, vous devez spcifier la valeur de retour qui a t donne par les journaux
lorsque vous avez envoy le virus de test EICAR. Si vous trouvez que la valeur de retour est la
mme lorsque vous joignez le virus de test EICAR et lorsque vous ne le faites pas, il y a alors un
problme. Dans ce cas, vous ne devez spcifier aucune valeur. Signaler ceci dans le forum et vous
devriez obtenir de l'aide.
Changer le mot de passe administrateur
Contexte
partir de hMailServer 4.3, un mot de passe administrateur principal existe pour hMailServer. Le
but est d'empcher les utilisateurs non autoriss de modifier votre installation de hMailServer.
Lors de l'installation de hMailServer 4.3, vous spcifiez le mot de passe que vous souhaitez
utiliser. Un hachage MD5 de ce mot de passe est ensuite stock dans hMailServer.ini (Le rglage
AdministratorPassword dans la section Scurit)
Changer le mot de passe
Mthode 1 -Utiliser hMailServer Administrator
Si vous connaissez le mot de passe actuel de l'administrateur, ou tout autre mot de passe pour un
compte avec des autorisations d'administration au niveau du serveur, vous pouvez modifier le mot
de passe l'aide hMailServer Administrator.
1.Lancez hMailServerAdministrator et ouvrez une session.
2.Accdez Configuration ->Avanc
3.Entrez le nouveau mot de passe d'administration et enregistrez les changements.
Mthode 2 - Rinstaller hMailServer
1.Supprimez le paramtre AdministratorPassword de hMailServer.ini.
2.Rinstallez la mme version de hMailServer que vous aviez dj installe. Lors de l'installation il
vous sera demand de spcifier le nouveau mot de passe.
Mthode 3 - Utiliser une calculatrice MD5
1.Utilisez une calculatrice MD5 pour calculer un nouvel hachage MD5.
2.Spcifiez le nouveau hachage MD5 dans hMailServer.ini. Le rglage que vous devez actualiser
est AdministratorPassword
3.Relancez le service hMailServer.

200 / 214
Dterminer le mot de passe MySQL hMailServer
Si vous utilisez la version intgre de MySQL fournie avec hMailServer, vous ne connaissez peut-
tre pas votre mot de passe. Pour dterminer le mot de passe, procdez comme suit:
1.Excutez le script hMailServer/Addons/Utilities/DecryptBlowfish.vbs.
2.Entrez votre mot de passe principal d'administrateur de hMailServer. Il s'agit du mot de passse
que vous avez spcifi lors de l'installation. Cliquez sur OK.
3.Ouvrez hMailserver.ini, dans votre dossier Windows ou dans le dossier bin de hMailServer.
4.Copiez le mot de passe de la base de donnes de hMailServer.ini dans la bote de dialogue
"Entrer le mot de passe crypt".
5.Cliquez sur OK dans DecryptBlowfish pour afficher votre nouveau mot de passe.
Activer l'authentification SMTP dans le client de messagerie
Gnralits
Cette rubrique dcrit comment activer l'authentification SMTP dans votre client de messagerie. Par
dfaut, hMailServer requiert une authentification SMTP activer dans le client de messagerie.
Outlook Express 6
1.Slectionnez Comptes dans le menu Outils.
2.Slectionnez l'onglet Messagerie.
3.Double-cliquez sur le compte modifier.
4.Slectionnez l'onglet Serveurs.
5.Sous Serveur de Messages Sortants, choisissez Mon serveur ncessite une authentification.
Outlook 2003
1.Slectionnez Comptes de messagerie dans le menu Outils.
2.Slectionnez Afficher ou changer un compte de messagerie existant
3.Double-cliquez sur le compte modifier.
4.Cliquez sur Plus de paramtres.
5.Ouvrez l'onglet Serveur Sortant.
6.Choisissez Mon serveur sortant (SMTP) ncessite une authentification.
7.Vrifiez que Utiliser les mme rglages que mon serveur de messagerie entrant est slectionn.
PHP/mail()
La fonction PHP mail() ne prend pas en charge l'authentification SMTP. Dsactivez la plage
d'adresses IP pour l'authentification SMTP correspondant l'ordinateur sur lequel PHP fonctionne,
ou utilisez une autre commande pour envoyer l'e-mail.
Installer les outils clients de hMailServer
Cette rubrique dcrit comment installer les outils clients hMailServer. Si vous souhaitez grer votre
installation hMailServer distance, vous devez installer les outils clients hMailServer sur
l'ordinateur partir duquel vous souhaitez grer votre installation .
1.Lancez le programme d'installation de hMailServer et cliquez sur Suivant dans la fentre
d'accueil.
2.Choisissez l'emplacement de l'installation des outils clients et cliquez sur Suivant.
3.A la section Slectionnez les composants, dcochez Serveur.
4.Cliquez sur Suivant jusqu' la fin de l'installation.
Rgler manuellement la langue de hMailServer
Gnralits
201 / 214
Dans l'installation de hMailServer, seules deux langues sont incluses - sudois et en anglais. Il est
cependant possible de configurer hMailServer pour utiliser une plage d'autres langues.
Quelles traductions sont disponibles?
Pour voir les traductions disponibles, allez la page hMailServerTranslation Status. La page
affiche la liste des langues et la quantit de l'interface utilisateur qui a t traduite dans cette
langue. La traduction de certaines langues ne sont pas compltes 100%. Cela signifie que
certaines parties de l'interface utilisateur seront toujours affichs en anglais. Par exemple, si
seulement 70% de l'interface utilisateur est traduite, 30% de l'interface utilisateur sera affich en
anglais.
Il est recommand de ne pas utiliser une traduction si moins de 97% de l'interface utilisateur est
traduite. Bien qu'il n'y ait pas de problmes techniques avec l'utilisation d'une langue qui n'est que
partiellement traduite, cela pourrait tre une source de confusion lorsque des chanes sont dans
une langue et d'autres dans une autre langue.
Comment puis-je installer une nouvelle traduction?
A l'avenir, cette fonctionnalit est susceptible d'tre intgr dans hMailServer Administrator, mais
pour l'instant c'est un processus manuel.
1.Accdez la page hMailServerTranslation Status et choisissez la traduction utiliser.
2.Si vous voyez la liste de toutes les chanes truduites, slectionnez-les toutes et copiez-les dans
le presse-papiers.
3.Lancez le Bloc-notes, et collez les chanes dans ce traitement de texte.
4.Enregistrez le fichier dans le dossier Languages de hMailServer, normalement C:\Program Files
\hMailServer\Languages. Nommez le fichier <langue>.ini, par exemple french.ini ou german.ini.
5.Ouvrez hMailServer.ini, normalement dans C:\Program Files\hMailServer\Bin.
6.Cherchez la ligne qui contient ValidLanguages=english,swedish et ajoutez french cette
ligne.Notez que chaque langue est spare par une virgule. Par exemple:
ValidLanguages=english,swedish,french
7.Redmarrez le service hMailServer.
Dsormais, le service hMailServer connat l'existence de la traduction en franais, dans notre
exemple.
Comment puis-je utiliser la nouvelle traduction?
Dans hMailServer Administrator, choisissez Slectionner une langue du menu Fichier.
Pour configurer WebAdmin pour utiliser cette langue, la spcifier dans le fichier de configuration de
WebAdmin, config.php.
Dplacer les spams dans un dossier IMAP
Ces instructions supposent que vous utilisez hMailServer version 4.0 ou suprieure. Elles sont
applicables au courrier marqu comme spam, en utilisant ASSP, mais devraient fonctionner aussi
bien avec un autre filtre anti-spam. Il est seulement ncessaire que le filtre place un indicateur de
spam dans l'en-tte, par exemple, en remplaant simplement les tapes 3 et 4 ci-dessous avec
l'en-tte et la valeur approprie.
1.Ouvrez hMailAdmin
2.Slectionnez Rgles (pour crer une rgle qui s'applique globalement)
4.Spcifiez un nom pour cette rgle
5.Cliquez sur Ajouter prs de Critre
6.Slectionnez En-tte Personnalise et entrez X-Assp-Spam
7.Entrez YES dans la champ Valeur
9.Cliquez sur Ajouter prs de Action
202 / 214
10.Slectionnez Dplacer dans le dossier IMAP
11.Sous Dossier entrez le dossier dans lequel vous souhaitez effectuer le dplacement (exemple:
Inbox\SPAM)
Le dossier sera automatiquement cr pour les utilisateurs s'il n'existe pas la premire fois qu'ils
reoivent un message de spam.
Propos par Colin Murphy
Recrer la liste des messages dans la base de donnes
Contexte
Les messages de hMailServer sont stocks dans le rpertoire Data de hMailServer (normalement
C:\Program Files\hMailServer\Data). La base de donnes contient une liste de ces messages. Par
exemple, le chemin d'accs au fichier du message, la taille des messages, l'indicateur de message
et les destinataires du message sont stocks dans la base de donnes.
Lorsque vous tlchargez les messages de hMailServer en utilisant POP3 ou IMAP, hMailServer
charge une liste des messages de la base de donnes pour dterminer si le message existe pour
votre compte. Ainsi, si le fichier e-mail existe sur le disque dans le rpertoire Data, mais pas dans
la base de donnes, vous ne serez pas en mesure de tlcharger le message.
Normalement, vous ne devriez pas avoir recrer la liste des messages. Ne pas essayer de
recrer la liste des messages, sauf si vous tes certain que vous avez besoin de le faire. Si vous
tes un doute, n'hsitez pas poser une question dans le forum des utilisateurs.
Recrer la liste des messages dans la base de donnes
A l'aide de l'outil DataDirectory Synchronizer, vous pouvez recrer la liste des messages dans la
base de donnes.
Suivez ces tapes pour recrer la liste des messages dans la base de donnes:
1.Sauvegardez votre systme hMailServer (base de donnes et dossier Data). Comme
DataDirectorySynchronizer effectue de nombreuses modifications dans votre base de donnes
hMailServer, cette tape est importante.
2.Lancez DataDirectorySynchronizer.exe partir du dossier Addons
3.Cliquez sur Suivant pour lancer la synchronisation
La vitesse de la synchronisation varie en fonction du matriel de l'ordinateur. Sur un Intel P4
2.4Ghz, vous pouvez estimer qu'environ 50 messages par seconde seront imports.
Remarques importantes
Vous n'avez pas arrter hMailServer avant d'excuter DDS.
Aprs que tous les messages aient t imports, DDS redmarrer automatiquement le
serveurhMailServer pour actualiser le cache.
Comme les donnes de messages IMAP, tels que l'information du dossier, les indicateurs de
message, etc sont stocks dans la base de donnes et non pas dans les fichiers de messages,
ces informations ne seront pas recres quand sera recre la liste des messages. Par
consquent, quand les messages seront insrs dans la base de donnes, ils se retrouveront
tous dans la bote de rception et marqu comme non lu.
Les fichiers situs dans le dossier racine Data seront remis aux destinataires locaux des en-ttes
A et CC. Les informations de destinataires d'origine, de l'enveloppe SMTP, ne sont pas disponibles
dans les fichiers .EML. Par consquent, les en-ttes A / CC seront utiliss. Les e-mail ne sont remis
qu'aux destinataires locaux pour viter que des messages soient r-distribus des adresses
externes.
Les fichiers situs dans les sous-rpertoires du dossier Data, tels que le nom de domaine \
d'utilisateur seront relis cet utilisateur dans la base de donnes.
Seuls les fichiers avec l'extension. eml ou. hma sont importes dans la base de donnes
Les fichiers imports directement dans les comptes d'utilisateurs ne seront pas traits par les
filtres, les rgles, les fonctions de dtection de virus de hMailServer.
203 / 214
Rparer une table MySQL corrompue
Les tables MySQL peuvent se corrompre pour diffrentes raisons, telles que la dfaillance du
matriel, les bogues du systme d'exploitation, les virus et les bogues de MySQL. hMailServer lui-
mme ne provoque pas de corruption des tables MySQL. hMailServer communique avec MySQL via
TCP / IP l'aide d'un langage standardis. Il n'y a rien dans ce langage qui puisse entraner une
corruption des tables.
Si une table MySQL est corrompue, vous devez la rparer. Notez que la rparation d'une table
MySQL corrompus peut conduire la perte de donnes. Il est donc important de crer une
sauvegarde de votre systme.
Comment savoir si une table est corrompue?
Examinez le journal d'erreur de hMailServer. Si vous voyez beaucoup d'erreur formules lors de
l'excution des messages d'tat SQL, il est probable qu'une ou plusieurs de vos tables soient
corrompues. N'hsitez pas demander de l'aide dans le forum si vous n'tes pas sr de vous.
tape 1: Dterminez le mot de passe MySQL
Si vous utilisez une version externe de MySQL, vous devriez dj connatre votre mot de passe
MySQL. Si vous utilisez la version intgre de MySQL fournie avec hMailServer, vous pourriez ne
pas le connatre. Pour le dterminer, procdez comme suit:
1.Excutez le script hMailServer/Addons/Utilities/DecryptBlowfish.vbs.
2.Entrez votre mot de passe hMailServer Administrator principal. Il s'agit du mot de passe que
vous avez spcifi lors de votre premire installation de hMailServer. Cliquez sur OK.
3.Ouvrez hMailserver.ini, situ dans votre dossier Windows ou dans le dossier bin de hMailServer.
4.Copiez le mot de passe de base de donnes de hMailServer.ini dans la bote de dialogue "Entrer
le mot de passe crypt". Dans hMailServer.ini, vous devriez voir une ligne ressemblant ceci:
[Database]
...
password=c85dae3cb73394ab
Dans cet exemple, c85dae3cb73394ab est le mot de passe crypt.
5.Cliquez sur OK dans DecryptBlowfish pour afficher votre mot de passe
DecryptBlowfish va maintenant afficher votre mot de passe. Gardez la bote de dialogue ouverte
ou mmorisez le mot de passe.
tape 2: Connectez-vous au serveur
Pour pouvoir rparer votre table, vous devez vous connectez au serveur MySQL l'aide d'un client
MySQL. Vous pouvez utiliser SQLyog pour ce faire.
1.Tlchargez et installez SQLyog
2.Crez une nouvelle connexion.
3.Entrez les informations de connexion pour votre serveur MySQL. Si vous utilisez le serveur
intgr, vous devez entrer le nom d'hte: localhost, d'utilisateur: root, le mot de passe: mot de
passe DecryptBlowfish, le port: 3307
4.Cliquez sur Connexion pour vous connecter au serveur de base de donnes
tape 3: Rparer la table
Suivez ces tapes pour excuter l'instruction SQL afin de rparer la table.
1.Dans l'arborescence de gauche, cliquez sur la base de donnes hmailserver.
La base de donnes de hMailServer devient alors active.
2.Dans la partie droite de la fentre de SQL, cliquez sur l'onglet Requte.
3.Entrez REPAIR TABLE tablename, par exemple, REPAIR TABLE hm_messages.
4.Cliquez sur le bouton Excuter la Requte en Cours de la barre d'outils (ou slectionnez Editer-
>Excuter une Requte->Excuter la requte en cours ou appuyez sur F5).
5.MySQL devrait alors rparer la table. Aprs la rparation de la table, redmarrez MySQL puis le
service hMailServer. Selon la table qui tait corrompue, un redmarrage des services peut ne pas
tre ncessaire, mais nous vous recommandons de le faire systmatiquement.
204 / 214
Rinitialiser le mot de passe de MySQL
Contexte
Lorsque vous installez hMailServer, vous pouvez choisir d'utiliser la base de donnes MySQL
interne. Si vous le faites, le programme d'installation va crer une base de donnes MySQL que
hMailServer utilisera. Le programme d'installation va galement crer un utilisateur root sur le
serveur MySQL qui recevra un mot de passe gnr de faon alatoire. Ce mot de passe sera
ensuite crit sous forme crypt dans hMailServer.ini. Si vous avez accs hMailServer.ini, vous
pouvez dcrypter le mot de passe en utilisant hMailServer\Addons\Utilities\DecryptBlowfish.vbs.
Router tous les messages sortants via un autre serveur
Contexte
De nombreux fournisseurs de services Internet (entreprises qui fournit aux utilisateurs une
connexion Internet) bloquent le trafic sortant sur le port 25. Ce qui ne permet plus hMailServer
de se connecter directement d'autres serveurs SMTP sur Internet. Une solution consiste
acheminer tout votre courrier sortant via le serveur de messagerie de votre FAI.
De mme, pour diffrentes raisons, des diffrents peuvent vouloir router tout le courrier sortant
via un service tiers comme gmail.
tapes
2.Accdez Configuration > Protocoles > SMTP
3.Ouvrez l'onglet Distribution des e-mails.
4.Spcifiez les paramtres suivants:
Serveur relais SMTP - Le nom d'hte du serveur de messagerie de votre FAI ou l'adresse IP.
Port TCP - Le port TCP/IP que le serveur de votre FAI surveille, habituellement 25 (sauf si SSL est
utilis).
5.Si le serveur de votre FAI ncessite une authentification, slectionnez Le serveur ncessite une
authentification et entrez le nom d'utilisateur et le mot de passe.
Les paramtres ci-dessous sont valables pour les versions 3.4 suprieures.
205 / 214
Dfinir des plages IP pour votre rseau priv
Contexte
La plage IP est l'un des mcanismes que hMailServer utilise pour la scurit. En utilisant des
plages d'adresses IP, vous pouvez donner un accs diffrent aux diffrents ordinateurs en
fonction de leur adresse IP. Par exemple, vous pouvez activer le protocole IMAP pour votre rseau
alors que les gens en dehors de votre rseau (par exemple sur Internet), ne peuvent accder que
via POP3.
Normalement, il ne devrait y avoir aucune raison pour ajouter ou supprimer des plages d'adresses
IP. Vous ne devriez pas le faire, sauf si vous tes sr de ce que vous voulez et comment y
parvenir. Les plages d'adresses IP par dfaut crs lors de l'installation devraient fonctionner pour
la plupart des utilisateurs.
Les tapes suivantes dcrivent comment mettre en place plages d'adresses IP pour un rseau
domestique de 3 ordinateurs. On suppose que vous avez un rseau domestique o il a t
attribu aux ordinateurs des adresses IP commenant par 192.168.1.
Etapes
1.Lancez up hMailAdmin.
2.Dployez le nud Configuration
3.Slectionnez les plages IP dans l'arborescence et cliquez sur Ajouter
4.Entrez les informations suivantes:
o
Nom: Mon rseau priv
o
Priorit: 25
Lorsque hMailServer dtermine la plage IP utiliser, il peut y avoir plusieurs plages IP
206 / 214
correspondant aux utilisateurs connects. Si c'est le cas, la plage d'adresses IP avec la
priorit la plus leve est utilise. Pour que cette plage d'adresses IP fonctionne
correctement, elle doit disposer d'une priorit plus leve que toutes les autres plages
d'adresses IP.
o
IP la plus basse: 192.168.1.0
o
IP la plus leve: 192.168.1.255
o
Autoriser les connexions: SMTP, POP3 et IMAP
o
Pour les autres paramtres, utiliser les mmes rglages que pour la plage IP Internet.
Les donnes ci-dessous sont valables pour les versions 5.2 et suprieures.
Mettre en place un serveur local / autonome
Contexte
Ce document dcrit comment configurer un serveur de messagerie pour usage interne
uniquement. Les utilisateurs de votre rseau pourront envoyer et recevoir des e-mails via le
serveur. Ils ne seront pas en mesure d'envoyer ou de recevoir des emails des autres utilisateurs
sur Internet.
Crer le domaine
Lancez hMailServerAdministrator et choisissez Ajouter un domaine.
Entrez un nom de domaine comme companyname.local. Pour viter toute confusion, il est
recommand de ne pas choisir un nom de domaine dj utilis par quelqu'un d'autre sur Internet.
Vrifiez que le domaine est activ /actif.
207 / 214
Crez les comptes
Aprs la mise en place du domaine, crez des comptes pour vos utilisateurs. Par exemple, vous
pouvez configurer des comptes nomms bill@companyname.local et sales@companyname.local.
Configurez le pare-feu
Assurez-vous que le pare-feu fonctionnant sur le mme serveur que hMailServer est configur
pour autoriser le trafic entrant sur les ports 25, 110 (POP3) et 143 (pour IMAP).
Configurez les clients de messagerie
Lorsque les comptes ont t crs et le pare-feu configur, il est temps de configurer vos clients
de messagerie. Comme nom d'utilisateur, vous devez utiliser une adresse e-mail complte, par
exemple bill@companyname.local. Comme adresse de serveur, utilisez le nom ou l'adresse IP de
l'ordinateur sur lequel fonctionne hMailServer. Notez que le nom du serveur n'est gnralement
pas le mme que le nom de domaine.
Termin
Ds que les tapes ci-dessus sont effectues, les utilisateurs de votre rseau seront en mesure
de s'envoyer des messages l'aide des adresses internes.
Utiliser ASSP
Contexte
Configurer hMailServer et ASSP pour filtrer le SPAM (Jason Weir: jason.weir @ comcast.net 14 avril,
2004)
Cette configuration a t teste la fois avec hMailServer et ASSP fonctionnant sur la mme
installation de Windows 2000 Professionnel, mais cela devrait fonctionner pour pratiquement
n'importe quel systme qui excutera hMailServer.
Versions Logicielles
- ASSP v1.0.9 -
- hMailServer v2.0.x et 3.x
- Activestate Perl v5.6.1
Configuration requise
hMailserver jour et fonctionnel, configur correctement et traitant les e-mails
Perl install sous Win32
Module Daemon install
Configurer hMailServer
1.Ouvrir hMailServer Administrator
2.Sous Configuration->SMTP, changez le port SMTP pour 125, enregistrez les paramtres et
redmarrez le serveur
ASSP Installation & Configuration
208 / 214
1.L'installation est simple, tlchargez et dcompressez les fichiers dans c:\ASSP
2.Crez les dossiers suivants:
o
c:/assp/spam
o
c:/assp/notspam
o
c:/assp/errors
o
c:/assp/errors/spam
o
c:/assp/errors/notspam
3.Ouvrez une ligne de commande pour c:\assp. Excutez: perl assp.pl
4.Pointez votre navigateur sur http://127.0.0.1:55555/ nom d'utilisateur vierge, mot de passe
nospam4me
5.Cochez la case "Afficher les Options de Configuration Avance" et cliquez sur le bouton Appliquer
les changements
6.Changez les paramtres suivants:
o
Destination SMTP = 127.0.0.1:125
o
Cochez "Comme un Service"
o
Port d'coute = 25
o
Domaines Locaux = numrez les domaines que vous avez configur pour hMailServer
7.Cliquez sur Appliquer les changements
8.Appuyez sur Ctrl-C pour arrter le processus assp.pl
9.Excuter: perl addservice.pl -i c:\assp\assp.pl c:\assp
10.Lancer le service Proxy Smtp Anti-Spam
11.Testez en essayant telnet pour 127.0.0.1:25; vous devriez voir la bannire du serveur de
messagerie.
Ceci fait fonctionner ASSP en Mode Test. Le courrier doit maintenant passer par ASSP vers
hMailServer. Vous remarquerez que les messages s'accumulent dans les rpertoires mails et
notspam. Si vous voyez un spam dans le dossier notspam ou vice versa, vous devez dplacer
manuellement les messages dans le dossier appropri. Une fois que vous avez accumul quelque
100 messages dans les dossiers mails et notspam, excutez le script rebuildspamdb.pl. Ce qui
crera la base de donnes spam. Lisez la documentation sur ASSP pour dsactiver le mode test et
sur l'automatisation de rebuildspamdb.pl
Changer le dossier Data
Contexte
Par dfaut, tous les e-mails sont stocks dans le rpertoire Data de hMailServer, sous C:\Program
Files\hMailServer\Data. Dans certains cas, vous voudrez peut-tre changer pour un chemin
diffrent. Par exemple, si vous avez plus d'espace disque sur un autre lecteur. Bien qu'il soit
possible de modifier le chemin d'accs, les e-mails existants ne seront pas dplacs vers le
nouveau chemin. Si vous dplacez les fichiers existants de l'ancien rpertoire Data vers le
nouveau, votre client de messagerie ne sera pas en mesure de les tlcharger.
Etapes
1.Ouvrez hMailServer.ini
2.Localisez DataFolder la section Directories
3.Indiquez le nouveau chemin
Remarque
Si vous souhaitez dplacer vos fichiers de messages existants, vous devez vous connecter au
serveur de base de donnes et mettre jour la table hm_messages manuellement.
Informations IMAP
IMAP signifie Internet Message Access Protocol. Il s'agit d'un protocole qu'un client de messagerie
peut utiliser pour tlcharger des e-mail partir d'un serveur de messagerie. IMAP comprend
beaucoup plus de fonctionnalits que POP3. Le protocole IMAP est conu pour permettre aux
utilisateurs de garder leur e-mail sur le serveur. Le protocole IMAP ncessite plus d'espace disque
et de ressources CPU sur le serveur que le protocole POP3, car tous les messages restent stocks
sur le serveur aprs que le client de messagerie les a tlchargs. IMAP utilise normalement le
209 / 214
port 143.
Dossiers IMAP
C'est le client IMAP lui-mme (client webmail, Outlook Express, Netscape Mail et ainsi de suite) qui
est responsable des proprits des composants mis en place sur le client IMAP. Par exemple,
hMailServer ne dcide pas du nom que doit avoir le dossier "Elments envoys". Il ne sait pas non
plus que le dossier "Elments envoys" contient effectivement des lments envoys. Le client
IMAP demande au serveur de crer un dossier pour les lments envoys, puis place les
messages dans le dossier. Si vous souhaitez modifier le nom de ce dossier, vous devez le faire
dans votre client IMAP, pas dans hMailServer.
Rafrachir le liste des dossiers IMAP
Le protocole IMAP ne fournit pas de mcanisme pour l'actualisation automatique des dossiers
IMAP. Si vous avez plusieurs clients IMAP connects au mme compte en mme temps, et que l'un
des clients cre un nouveau dossier IMAP, les autres clients ne seront pas automatiquement
avertis de ce dossier.
Rafrachir la liste des messages
Le protocole IMAP possde une extension appele IMAP IDLE. L'extension IMAP IDLE permet au
client de "S'abonner" dans un dossier IMAP et de recevoir des notifications partir du serveur
lorsque de nouveaux messages existent et lorsque l'tat des messages change. De cette faon, le
client n'a pas besoin de vrifier les nouveaux messages lui-mme. hMailServer 4.3 et ultrieures
prennent en charge cette extension.
Trier la liste des messages
hMailServer prend en charge l'extension IMAP SORT. Cette extension peut considrablement
amliorer les performances lorsque vous travaillez avec de grands dossiers IMAP. Pour en savoir
plus....
Sparateur de dossiers
hMailServer utilise le . (point) comme sparateur de dossiers. Cela signifie que vous ne pouvez
pas avoir de point dans un nom de dossier IMAP.
Extension IMAP Sort
Gnralits
hMailServer 4.2 et ultrieur prend en charge l'extension IMAP sort. Cette extension peut amliorer
les performances lors du chargement des botes aux lettres qui contiennent un grand nombre d'e-
mails. Si le client IMAP utilise l'extension IMAP Sort, le tri des messages sera effectu sur le
serveur, au lieu du client. Par exemple, si la bote aux lettres contient 1000 e-mails et que le client
ne veut charger que les 10 messages les plus rcent, il peut demander au serveur les 10 derniers
e-mails. Si le client n'utilise pas l'extension IMAP Sort, il doit tlcharger les 1000 e-mails et faire
lui-mme le tri.
Prise en charge IPv6
210 / 214
Gnralits
hMailServer prend en charge IPv4 et IPv6. La plupart des serveurs de messagerie sur Internet
utilisent IP version 4.
Comment fonctionne t-il?
La prise en charge IPv6 sera automatiquement active dans hMailServer si elle est active dans le
systme d'exploitation. Si vous activez IPv6 dans le systme d'exploitation, vous aurez besoin de
redmarrer le service hMailServer pour que hMailServer devienne pleinement inform de la
prsence d'IPv6.
Dans toutes les botes de dialogue de l'administrateur et de WebAdmin o vous pouvez entrer des
adresses IP, vous pouvez saisir les adresses IPv4 et IPv6. Le stockage de base de donnes sous-
jacent peut enregistrer la fois les adresses IPv4 et IPv6.
Par exemple, si vous souhaitez relayer tous les messages sortants vers un serveur de votre
rseau, vous pouvez spcifier l'une des trois valeurs dans les rglages du relais SMTP:
Le nom du serveur hte
L'adresse IPv4 du serveur
L'adresse IPv6 du serveur
De mme, lorsque vous configurez hMailServer pour surveiller ou de se lier une adresse IP
spcifique, vous pouvez saisir une adresse IPv4 ou une adresse IPv6.
Configuration
La configuration par dfaut de hMailServer ne surveille pas les adresses IPv6. Si vous voulez que
hMailServer surveille l'adresse IPv6, vous devez faire deux choses. Notez que ces modifications de
configuration ne sont ncessaires que si vous voulez que hMailServer surveille des adresses IPv6.
Si vous ne voulez utiliser IPv6 par exemple que lors de la distribution du courrier sortant, ces
changements ne sont pas ncessaires.
Ajouter un port TCP/IP
Dans hMailServer Administrator, accdez Configuration, Avanc, Ports TCP/IP. Ajoutez un
nouveau port TCP/IP et spcifiez l'adresse IPv6 que vous souhaitez surveiller.Sinon, hMailServer
ne surveillera aucune adresse IPv6.
Ajouter une lage IP
Crer une nouvelle plage IPcouvrant Internet IPv6 - :: - ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff. Dans la plage
IP, choisissez les mmes paramtres que dans la plage IP Internet dj existante. Sinon,
hMailServer acceptera toujours les connexions entrantes sur IPv6, mais il dbranchera
immdiatement les clients car l'adresse IP des clients ne correspond aucune plage IP.
Limitations
Le protocole de communication utilis entre Administrateur / WebAdmin et hMailServer varie en
fonction de la configuration de votre systme d'exploitation. Microsoft Windows 2003 prend en
charge DCOM sur IPv6. Les versions antrieures de Windows peuvent ne pas prendre en charge
DCOM sur IPv6. Il ne s'agit pas vraiment d'une limitation de hMailServer mais des limitations dans
la prise en charge du systme d'exploitation Windows pour DCOM.

211 / 214
Tests des relais ouvert
Ds que vous avez termin l'installation et la configuration de hMailServer, vous devez excuter
des tests de relais ouvert. Ce qui vous garantit que votre serveur ne sera pas utilis pour du
spam.
http://www.aupads.org/test-relay.html
http://www.abuse.net/relay.html
Faux positifs
Dans certains cas, des tests de relais ouverts peuvent retourner des faux positifs. Cela signifie
que le test de relais ouvert prtend que votre serveur peut tre un relais ouvertmme s'il ne l'est
pas. En d'autres termes, le serveur peut vous donner un avertissement, mme si vous n'avez rien
craindre.
Domaine par dfaut et adresse fourre-tout
Si vous spcifiez un domaine par dfaut dans hMailServer, ce nom de domaine sera ajout
toutes les adresses e-mail qui il manque un nom de domaine (le rglage se trouve dans
hMailServer Administrator sous Configuration->Avanc). Si vous spcifiez le domaine example.com
par dfaut, et que quelqu'un tente d'envoyer un mail au webmaster, hMailServer supposera que le
message doit tre envoye webmaster@example.com.
Si vous spcifiez une adresse fourre-tout pour un domaine, hMailServer acceptera tous les emails
envoys ce domaine. Si l'adresse du destinataire ne correspond pas un compte, le message
sera envoy l'adresse fourre-tout.
Combiner les paramtres du domaine par dfaut avec le rglage de l'adresse fourre-tout peut
conduire des faux positifs. Si vous avez activ ces deux paramtreset que quelqu'un se
connecte votre serveur pour envoyer un courriel <any-random-string>, hMailServer acceptera
la distribution. hMailServer va tout d'abord ajouter le domaine par dfaut l'adresse - <any-
random-string> @ example.com. Ensuite, il essaiera de trouver le compte <any-random-string> @
example.com. Si cela choue, le message sera toujours livre sur le compte fourre-tout.
Gestion distance
Gnralits
Il existe deux mthodes courantes diffrentes pour grer une installation hMailServer distance.
La premire consiste utiliser PHPWebAdmin. PHPWebAdmin est un package d'administration
base sur le Web qui offre presque les mmes fonctionnalits que hMailServer (l'dition de rgles
n'est pas disponible dans PHPWebAdmin). PHPWebAdmin ncessite un serveur web avec prise en
charge de PHP afin de fonctionner,mais il permet de grer votre installation hMailServer de
n'importe o sur Internet. L'autre mthode consiste installer les outils clients hMailServer et de
se connecter distance sur l'installation hMailServer. En raison de blocage du port dans le pare-
feu cette mthode ne fonctionne que sur un rseau local ou une connexion VPN. Thoriquement, il
serait possible d'ouvrir ces ports mais ce n'est pas recommand en raison de problmes de
scurit.
Utiliser PHPWebAdmin
Consultez le didacticiel d'installation pour PHPWebAdmin.
212 / 214
Utiliser hMailServer Administrator
Pour vous connecter une instance de hMailServer s'excutant sur un autre ordinateur de votre
rseau, excutez le programme d'installation de hMailServer sur l'ordinateur partir duquel vous
souhaitez vous connecte. Lors de l'installation choisissez d'installer les outils clients. Aprs
l'installation des outils clients dmarrez hMailServer Administrator. Dans la bote de dialogue de
connexion, slectionnez l'option "localhost" et cliquez sur Editer, puis entrez les informations
appropries.
Problmes courants
Lorsque vous utilisez l'administrateur de hMailServer pour se connecter une instance en cours
d'excution de hMailServer sur un autre ordinateur, il n'est pas rare que vous obteniez un
message de refus d'accs. hMailServer Administrator utilise DCOM / RPC pour communiquer avec
l'instance de hMailServer sur l'autre ordinateur et pour que cela fonctionne correctement, vous
devez peut-tre modifier les paramtres de votre client ou serveur. En raison des limites de cette
technologie Microsoft, il n'est pas possible pour l'administrateur de hMailServer de dterminer la
cause originelle de ce message Accs refus, si vous avez besoin de vrifier manuellement les
paramtres. Si vous obtenez une erreur Accs refus, ou une Erreur d'Automatisation lorsque
vous essayez de vous connecter, vrifiez que ...
le service d'Appel de procdure distante (RPC) est actif sur le client et le serveur.
votre pare-feu ne bloque pas les ports DCOM. Pour en savoir plus sur ce sujet, consultez
Microsoft KB217351.
les entrs de base de registre ont la valeur suivante:
o
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Ole\EnableDCOM
o
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Ole\EnableRemoteConnect
que DCOM est actif sur le client et le serveur comme dcrit dans Microsoft KB 313273:
que vous tes membre du groupe d'Administrateurs sur le client et le serveur.
que, si votre ordinateur fait partie d'un groupe de travail et non d'un domaine, qu'une compte
Windows avec le mme nom et mot de passe existe sur le serveur et le client, et que vous avez
ouvert une session en tant que cet utilisateur.
Fonctionnement interne
Gestionnaires de commande
Gnralits
La communication entre un serveur de messagerie et un client de messagerie est constitu d'un
grand nombre de commandes diffrentes et de transfert de donnes. Gnralement, un client de
messagerie se connecte un serveur de messagerie sur TCP / IP et transfre les donnes via un
socket. Lorsque le client de messagerie a envoy toutes ses commandes, il se dconnecte et
ferme la connexion TCP / IP. Exemples de commandes qu'un client peut envoyer: commandes de
connexion, diffusion de messages , rcupration de messages, cration de botes aux lettres, et
ainsi de suite.
L'ancien groupe d'units d'excution
Dans hMailServer 4.2 et version antrieure, hMailServer lanait un nouveau processus (thread) du
systme d'exploitation chaque nouvelle connexion TCP / IP (les processus sont un moyen, pour
les logiciels, d'excuter plusieurs tches la fois). Chaque processus tait responsable de la
surveillance d'une seule connexion TCP / IP, et de la manipulation des commandes envoyes par
le client. Crer un nouveau processus tait une opration assez intensive pour le CPU. Pour
rsoudre ce problme, hMailServer proposait cette fameuse unit d'excution. Lors du dmarrage,
il estimait le nombre de processus ncessaires, et les lanait immdiatement, mme si aucun client
n'tait connect. Quand un client se connectait, hMailServer attribuait l'un de ses processus la
responsabilit de grer ce client de messagerie.
213 / 214
Les units d'excution de hMailServer 4.2 contenaient rarement assez de processus, ainsi de
nouveaux processus devaient tre lancs lorsque les clients se connectaient. Comme mentionn
prcdemment, lancer des processus est une opration assez intensive pour le CPU, ce qui n'tait
pas bon pour la performance. La solution consistait lancer un grand nombre de processus lors
du dmarrage du service. Mais lancer plusieurs processus en mme temps tait galement
nfaste pour la performance. Un CPU simple cur ne peut excuter qu'une seule tche un
moment donn. Cela signifie que si le logiciel veut excuter deux choses en mme temps, le CPU
va d'abord traiter une petite partie de la tche 1, puis une petite partie de la tche 2, puis une
petite partie de la tche 1 et nouveau la tche 2 et ainsi de suite . Ces allers-retours
(commutation des tches) conduit un gaspillage des processus - le systme d'exploitation doit
passer plus de temps sur la commutation des tches que sur le traitement effectif des tches .
Le nouveau gestionnaire de commandes
Dans hMailServer 4.3, une nouvelle mthode base sur un gestionnaire de commande est utilise.
Lors d'un dmarrage du service, un nombre fixe de processus de commandes est lanc (dfini
dans Avanc-> Performance-> Paramtres des Processus). hMailServer indique Windows que
ces processus sont prts traiter les commandes des clients TCP / IP. Lorsqu'un client de
messagerie se connecte, hMailServer indique Windows qu'il est intress par toutes les
donnes que ce client envoie.
Lorsqu' un client de messagerie envoie une commande au serveur, le noyau Windows donne
l'ordre de traiter la commande l'un de ses processus de commande. Le processus de commande
traitera la commande et indiquera Windows que tout est prt pour traiter une autre commande.
Ce qui signifie qu'un processus de commande unique peut excuter des commandes pour de
nombreux clients de messagerie. La plupart du temps, les clients de messagerie sont inactifs (ils
n'envoie pas de commande) et cela conduit une utilisation plus efficace du processus
Cela signifie galement que hMailServer ne peut pas traiter plus de commandes de clients
simultans que le nombre de processus de commandes . Ce qui n'est normalement pas un
problme car les commandes sont traites trs rapidement. Comme le nombre de processus de
commandes est limit, chaque commande peut s'excuter plus rapidement que si le nombre de
commandes parallles tait illimit. Les commandes des clients sont mises en file d'attente jusqu'
ce qu'un processus de commande soit disponible pour les traiter.
tant donn qu'un cur de processeur unique ne peut jamais excuter plus d'une tches la fois,
le gestionnaires de commandes de hMailServer 4.3 donnera dans l'ensemble de meilleures
performances que la mthode "processus par connexion" de hMailServer 4.2.
Les RFC
Gnralits
Cette rubrique dcrit les RFC pertinents pour hMailServer.
Protocoles
RFC 5321 - Simple Mail Transfer Protocol, SMTP
RFC3501 - Internet Message Access Protocol, IMAP, v4
RFC1939 - Post Office Protocol, POP, v3
Encodage de message
RFC2047 - MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions
pour texte non ASCII
o
RFC 2045 dcrit un mcanisme pour dsigner les parties textuelles du corps qui sont codes
via diffrents jeux de caractres, ainsi que les mthodes pour coder ces parties du corps
selon des squences de caractres imprimables US-ASCII. Cette note dcrit des techniques
similaires pour permettre l'encodage de texte non-ASCII dans diverses parties d'un en-tte
de message RFC 822 [2], d'une manire qu'il est peu probable de confondre avec les
logiciels de traitement d'en-tte de message existants.
214 / 214
RFC 2184 - MIME Parameter Value et Encoded Word Extensions: Jeux de Caractres, Langages,
et suites
o
un moyen de spcifier les valeurs des paramtres dans les jeux de caractres autres que
US-ASCII
o
pour spcifier la langue utiliser si la valeur est affiche, et
o
un mcanisme de continuit pour les valeurs de paramtres longs pour viter les problmes
avec les retours la ligne d'en-tte.
Extensions IMAP
RFC 2177 - Commande IMAP4 IDLE
Cette commande permet aux serveurs IMAP d'aviser les clients connects quand un nouveau
message est arriv (plutt que d'avoir des requtes des clients pour les nouveaux messages).
RFC4314 - Liste de Contrle d'Accs IMAP4
Cette extension permet de crer des dossiers publics partags entre plusieurs dossiers. Le
document prcise par exemple la faon dont l'accs est accord par un client IMAP.
RFC2087 - Extension IMAPQuota
Avec cette extension, les cients IMAP peuvent vrifier quel quota de disque du serveur a t utilis
et quelle quantit est disponible.
RFC 5256 - Extensions SORT et THREAD
L'extension SORT offre des capacits de tri ct serveur. Ce qui ajoute de la performance, puisque
les clients IMAP n'ont pas tlcharger tous les messages dans une bote aux lettres pour
pouvoir les trier. L'extension Thread n'est pas implmente dans hMailServer.
Autre
RFC 4871 - spcification DKIM
DomainKeys Identified Mail (DKIM) dfinit un cadre d'authentification au niveau du domaine pour le
courrier lectronique en utilisant la cryptographie cl publique et la technologie de serveur de
cls pour permettre la vrification de la source et le contenu des messages par des Agents de
Transfert de Courrier (MTA) ou des Agents Utilisateurs de Messagerie (MUA).
Traduction
Ce document a t traduit par Philou traductions sur
http://philou-traductions.com/
Vous trouverez sur ce site de nombreuses autres traductions.

hMailServer-5-3 - Guide de L'utilisateur

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

hMailServer-5-3 - Guide de L'utilisateur

Transféré par

Droits d'auteur :

Formats disponibles

Copyright <2013> by <philou-traductions.com>. Tous Droits Rservs.

Informations sur l'auteur

Choisir un moteur de base de donnes

Guide de dmarrage rapide

Mise niveau: 5.0 vers 5.1

Si vous slectionnez Supprimer les messages immdiatement, hMailServer supprimera les

Configuration du fichier ini

vnement But Implment dans

Virus dtects(avant:Messages contenant un Virus)

Messages de spam(avant:Messages contenant un spam)

Migrer sur un nouveau serveur

hMailServer - Guide de l'Utilisateur

API COM: Structure API

Configuration des antivirus externes

Stocker les pices jointes seules sur le disque dur

hMailServer - Guide de l'Utilisateur

hMailServer - Guide de l'Utilisateur

Vous aimerez peut-être aussi