214
Copyright © <2013> by <philou-traductions.com>. Tous Droits Réservés. hMailServer - Guide de l'Utilisateur

hMailServer-5-3 - Guide de l'Utilisateur

Embed Size (px)

DESCRIPTION

hMailServer-5-3 - Guide DE l'Utilisateur

Citation preview

Copyright © <2013> by <philou-traductions.com>. Tous Droits Réservés.

hMailServer - Guide del'Utilisateur

hMailServer - Guide de l'Utilisateur

2 / 214

Table des matières

Avant l'installation ............................................................................................... 7Qu'est-ce que hMailServer? .............................................................................. 7Qu'est-ce que SMTP, POP3 et IMAP? ................................................................. 7A Propos de hMailServer 5.3 ............................................................................ 8Informations sur l'auteur ................................................................................ 10Journal des Changements de hMailServer ......................................................... 10

Installation ....................................................................................................... 10Configuration Système Requise ....................................................................... 10Choisir un moteur de base de données ............................................................ 12Guide de démarrage rapide ............................................................................ 13

Didacticiel d'Installation .............................................................................. 13Didacticiel de Configuration ........................................................................ 18Installation de PHPWebAdmin .................................................................... 20

Scénarios d'Installation .................................................................................. 21Simple serveur, adresse IP dynamique ......................................................... 21Simple serveur, adresse IP statique ............................................................. 23

Mise à niveau ................................................................................................ 24Conseils de mises à niveau ......................................................................... 24Mise à niveau: 3.x vers 4.0 ......................................................................... 25Mise à niveau: 4.x vers 5.0 ......................................................................... 27Mise à niveau: 5.0 vers 5.1 ......................................................................... 28Mise à niveau: 5.1 vers 5.2 ......................................................................... 29Mise à niveau: 5.2 vers 5.3 ......................................................................... 31Revenir à la version précédente ................................................................... 31

Configuration .................................................................................................... 32Compte ........................................................................................................ 32Avancé ......................................................................................................... 36Alias ............................................................................................................ 36Antispam ..................................................................................................... 37Antivirus ...................................................................................................... 40Interdiction automatique ................................................................................ 42Sauvegarde .................................................................................................. 43Liste de diffusion ........................................................................................... 44Liste noire DNS ............................................................................................. 45Domaine ...................................................................................................... 45Comptes externes .......................................................................................... 48Liste grise ..................................................................................................... 50Groupe ........................................................................................................ 51Configuration IMAP ....................................................................................... 52Relais entrant ................................................................................................ 53Configuration du fichier ini ............................................................................. 53Plage IP ....................................................................................................... 55Activité ........................................................................................................ 57Création des journaux .................................................................................... 57Miroir ........................................................................................................... 58Requête MX .................................................................................................. 58Performance ................................................................................................. 59

hMailServer - Guide de l'Utilisateur

3 / 214

POP3 settings ............................................................................................... 60Protocoles .................................................................................................... 60Routage ....................................................................................................... 60Règles .......................................................................................................... 63

Exemples de règle ..................................................................................... 66Scripts ......................................................................................................... 68

OnAcceptMessage ..................................................................................... 69OnBackupCompleted ................................................................................. 70OnBackupFailed ........................................................................................ 70OnClientConnect ....................................................................................... 70OnDeliverMessage ..................................................................................... 71OnDeliveryFailed ....................................................................................... 71OnDeliveryStart ......................................................................................... 72OnError ................................................................................................... 72OnExternalAccountDownload ...................................................................... 72

Message du serveur ....................................................................................... 73Envoi du serveur ........................................................................................... 73Configuration ................................................................................................ 74Configuration SMTP ....................................................................................... 74Certificat SSL ................................................................................................ 76État ............................................................................................................. 79Serveurs SURBL ............................................................................................ 80Port TCP/IP .................................................................................................. 80Utilitaires ...................................................................................................... 81Accueil ......................................................................................................... 81Liste blanche ................................................................................................. 81

Dépannage ....................................................................................................... 83Messages d'erreur .......................................................................................... 83

Messages d'erreur de la base de données ..................................................... 83Messages d'erreur DNS .............................................................................. 83Messages d'erreur hMailServer Administrator ................................................ 84Messages d'erreur SMTP ............................................................................. 84

Conseils de dépannage .................................................................................. 91Dépannage d'une règle .............................................................................. 91Envoyer de messages ................................................................................ 92Recevoir des messages .............................................................................. 93Autres conseils de dépannage... .................................................................. 94

Ports bloqués ........................................................................................ 94Connexion à la base de données ............................................................. 95Connexion via le client de messagerie ...................................................... 95hMailServer échoue pour distribuer les messages à certains serveurs ........... 96Problèmes MX ....................................................................................... 97Port SMTP non par défaut ..................................................................... 98Plantages Outlook ................................................................................. 98Problèmes d'installation de PHPWebAdmin ............................................... 99Serveur utilisé pour les spams ............................................................... 100Lancer lee serveur ............................................................................... 101Mot de passe erroné ............................................................................ 102

Maintenance .................................................................................................... 102Database maintenance ................................................................................. 102

hMailServer - Guide de l'Utilisateur

4 / 214

Sauvegarde & Restauration ........................................................................... 102Migrer sur un nouveau serveur ...................................................................... 103

Autres ............................................................................................................ 105À propos des destinataires du message .......................................................... 105Méthodes Anti-spam .................................................................................... 106Mise en cache .............................................................................................. 109API COM .................................................................................................... 110

Objet Account ......................................................................................... 112Objet Accounts ....................................................................................... 115Objet Alias ............................................................................................. 116Objet Aliases .......................................................................................... 116Objet AntiSpam ...................................................................................... 117Objet AntiVirus ....................................................................................... 119API Exemple: Changer le mot de passe d'un compte ................................... 120API Exemple: Copier un message dans un nouveau dossier IMAP ................. 120API Exemple: Créer un compte ................................................................. 121API Exemple: Supprimer un compte .......................................................... 122API exemple: Activer un domaine ............................................................. 122API exemple: Liste des dossiers d'un utilisateur .......................................... 122API exemple: Envoyer un message ............................................................ 123Objet Application .................................................................................... 124Objet Attachment .................................................................................... 125Objet Attachments ................................................................................... 125Objet Backup .......................................................................................... 126Objet BackupManager .............................................................................. 127Objet BackupSettings ............................................................................... 127Objet BlockedAttachment ......................................................................... 127Objet BlockedAttachments ........................................................................ 128Objet Cache ............................................................................................ 129Objet Client ............................................................................................ 130API COM: ChangeLog .............................................................................. 130API COM: Structure API ........................................................................... 137Objet Database ....................................................................................... 137Objet DeliveryQueue ................................................................................ 139Objet Directories ..................................................................................... 139Objet DistributionList ............................................................................... 140Objet DistributionListRecipient .................................................................. 141Objet DistributionListRecipients ................................................................. 141Objet DistributionLists .............................................................................. 141Objet DNSBlackList .................................................................................. 142Objet DNSBlackLists ................................................................................. 143Objet Domain ......................................................................................... 144Objet DomainAlias .................................................................................. 146Objet DomainAliases ............................................................................... 146Objet Domains ........................................................................................ 147Objet EventLog ....................................................................................... 148Objet FetchAccount ................................................................................. 148Objet FetchAccounts ................................................................................ 149Objet GlobalObjects ................................................................................. 150Objet GreyListingWhiteAddress ................................................................. 150

hMailServer - Guide de l'Utilisateur

5 / 214

Objet GreyListingWhiteAddresses .............................................................. 151Objet Group ........................................................................................... 152Objet GroupMember ................................................................................ 152Objet GroupMembers ............................................................................... 153Objet Groups .......................................................................................... 153Objet IMAPFolder .................................................................................... 154Objet IMAPFolderPermission .................................................................... 155Objet IMAPFolderPermissions ................................................................... 156Objet IMAPFolders .................................................................................. 157Objet Language ....................................................................................... 157Objet Languages ..................................................................................... 157Objet Links ............................................................................................. 158Objet Logging ......................................................................................... 158Objet Message ........................................................................................ 160Objet MessageHeader .............................................................................. 162Objet MessageHeaders ............................................................................. 162Objet Messages ....................................................................................... 162Objet Recipient ....................................................................................... 163Objet Recipients ...................................................................................... 164Objet Result ........................................................................................... 164Objet Route ............................................................................................ 164Objet RouteAddress ................................................................................. 165Objet RouteAddresses .............................................................................. 166Objet Routes ........................................................................................... 166Objet Rule .............................................................................................. 167Objet RuleAction ..................................................................................... 168Objet RuleActions .................................................................................... 169Objet RuleCriteria .................................................................................... 170Objet RuleCriterias .................................................................................. 171Objet Rules ............................................................................................. 172Objet Scripting ........................................................................................ 172Objet SecurityRange ................................................................................ 173Objet SecurityRanges ............................................................................... 174Objet ServerMessage ............................................................................... 175Objet ServerMessages .............................................................................. 175Objet Settings ......................................................................................... 176Objet SSLCertificate ................................................................................. 180Objet SSLCertificates ................................................................................ 180Objet Status ............................................................................................ 181Objet SURBLServer .................................................................................. 182Objet SURBLServers ................................................................................ 182Objet TCPIPPort ...................................................................................... 183Objet TCPIPPorts .................................................................................... 184Objet Utilities .......................................................................................... 184Objet WhiteListAddress ............................................................................ 186Objet WhiteListAddresses ......................................................................... 186

Synchroniseur du répertoire Data .................................................................. 187Configuration des antivirus externes .............................................................. 188Implémentation de fonctionnalités ................................................................. 189Questions souvent posées ............................................................................ 189

hMailServer - Guide de l'Utilisateur

6 / 214

FAQ: Informations d'hébergement ............................................................ 191Stocker les pièces jointes seules sur le disque dur ....................................... 191Enregistrer le message dans la base de données ......................................... 191Pourquoi des dossiers vides dans le répertoire Data? ................................... 192

Structure d'un dossier hMailServer ................................................................. 193COMMENT.. ................................................................................................ 194

Agir en tant que sauvegarde MX ................................................................ 194Administrer à distance hMailServer ............................................................ 196Effacer la file d'attente de distribution ........................................................ 197Se connecter à MySQL .............................................................................. 197Permissions DCOM .................................................................................. 198Examen antiviral externe - valeur de retour ................................................ 198Changer le mot de passe administrateur ..................................................... 199Déterminer le mot de passe MySQL hMailServer .......................................... 200Activer l'authentification SMTP dans le client de messagerie .......................... 200Installer les outils clients de hMailServer ..................................................... 200Régler manuellement la langue de hMailServer ........................................... 200Déplacer les spams dans un dossier IMAP .................................................. 201Recréer la liste des messages dans la base de données ................................ 202Réparer une table MySQL corrompue ......................................................... 203Réinitialiser le mot de passe de MySQL ...................................................... 204Router tous les messages sortants via un autre serveur ................................ 204Définir des plages IP pour votre réseau privé .............................................. 205Mettre en place un serveur local / autonome ............................................... 206Utiliser ASSP ........................................................................................... 207Changer le dossier Data ........................................................................... 208

Informations IMAP ...................................................................................... 208Extension IMAP Sort .................................................................................... 209Prise en charge IPv6 .................................................................................... 209Tests des relais ouvert ................................................................................. 211Gestion à distance ....................................................................................... 211Fonctionnement interne ................................................................................ 212

Gestionnaires de commande ..................................................................... 212Les RFC .................................................................................................. 213

Traduction ...................................................................................................... 214

hMailServer - Guide de l'Utilisateur

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 manipulertous vos e-mail vous-même sans avoir recours à un Fournisseur d'Accès Internet (FAI) pour lesgérer. Au lieu de laisser votre FAI héberger vos e-mails, hMailServer ajoute flexibilité et sécurité, etvous procure le contrôle complet sur la protection anti spam.

Historique

Le projet hMailServer a débuté en 2002 avec Martin Knafve. depuis cette époque, il est devenul'un des serveurs de messagerie les plus populaires pour Windows. depuis le début, le but a étéde créer un système de messagerie simple à utiliser et qui incluttoutes les fonctions essentiellesnécessaires. Le projet a débuté chez SourceForge.net, mais a été déplacé par la suite sur sonpropre site web. hMailServer est gratuit, et tout le code source peut être récupéré sur NovellForgede Novell

Qu'est-ce que SMTP, POP3 et IMAP?

Généralités

SMTP, POP3 et IMAP sont des protocoles TCP/IP utilisés pour la diffusion des e-mails. Si vousprévoyez installer un serveur de messagerie tel hMailServer, vous devez savoir à quoi il sert.Chaque protocole est un simple jeu de règles de communication spécifique entre ordinateurs.

SMTP

SMTP signifie Simple Mail Transfer Protocol. SMTP est utilisé lorsqu'un e-mail est envoyé à partird'un client de messagerie tel Outlook Express, vers un serveur de messagerie, ou lorsqu'un e-mailest délivré d'un serveur de messagerie vers un autre. SMTP utilise le port 25.

POP3

POP3 signifie Post Office Protocol. POP3 permet à télécharger un e-mail sepuis un serveur demessagerie. Le protocole POP3 est simple et n'offre pas de nombreuses fonctionnalités sauf pourle téléchargement. Sa conception suppose que le client de messagerie télécharge tous les e-mailsdisponibles depuis le serveur, les efface du serveur et se déconnecte. POP3 utilise normalement leport 110.

IMAP

IMAP signifie Internet Message Access Protocol. IMAP partage plusieurs fonctionnalités sembleblesavec POP3. Il s'agit, aussi, d'un protocole qu'un client de messagerie peut utiliser pour téléchargerles messages à partir d'un serveur de messagerie. Cependant, IMAP inclut beaucoup plus defonctionnalités que POP3. Le protocole IMAP est conçu pour laisser l'utilisateur conserver ses e-mails sur le serveur. IMAP nécessite davantage d'espace disque sur le serveur et davantage deressources CPU que POP3, car tous les messages sont stockés sur le serveur. IMAP utilisenormalement 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-

hMailServer - Guide de l'Utilisateur

8 / 214

mail à [email protected] cliquez sur Envoyer dans votre client de messagerie, disons, Outlook Express.2.Outlook Express délivre le message à hMailServer en utilisant le protocole SMTP.3.hMailServer délivre le message au serveur de messagerie de Microsoft, mail.microsoft.com, enutilisant le protocole SMTP.4.Le client Mozilla Mail de Bill télécharge le message depuis mail.microsoft.com vers son ordinateurportable en utilisant le protocole POP3 (ou IMAP).

A Propos de hMailServer 5.3

Nouveautés dans hMailServer 5.3

Nouvelles fonctionnalités majeures:

·Prise en charge pour IPv6

Autres améliorations:

·Dans la requête MX, vous pouvez désormais effectuer un clic droit sur les lignes et copier dans lepresse-papiers.·Il est désormais possible de contourner les listings grisés si une connexion provient d'un MX oud'un enregistrement pour le domaine d'envoi.·Un nouvel événement 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 ifa message arrives from an alias address, such as [email protected], hMailServer will requireSMTP authentication by default. The purpose of this is to stop spammers sending messages fromlocal domains. In earlier versions, SMTP authentication was only required when sending messagesfrom local accounts. Note that this also affects routes.·A basic diagnostic tool has been added to hMailServer Administrator and WebAdmin. Thediagnostic tool performs basic tests on your set up and checks DNS settings. The purpose of thediagnostic 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 browsingspeed in large folders when using a webmail client. The downside of this feature is that thedatabase size will increase. It's not recommended to enable this feature unless you'reexperiencing 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 couldlead 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 torecipients on routes. There is now a new option in the external account settings which allows youto 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 usehMailServer with POPfile.·A new rule action has been added; Create Copy. This can be used for example to deliver copies ofthe same message to different destination servers.·A new rule criteria has been added; Delivery attempts. This can be used for example to delivermessages 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 beforeit's performed. This should reduce the number of accidental deletes.

hMailServer - Guide de l'Utilisateur

9 / 214

·The database upgrade is now done in a transaction (assuming the underlying database supportsit). 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 executedevery time.·If a Date header contained the timezone "GMT" (with quotes, obsolete syntax) the message wasnot displayed if Outlook Express was used (Issue 209)·SMTP connection sometimes dropped during DKIM verification. The problem occured ifDKIM records 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 ofincoming email and sign outgoing email. Email messages which have been DKIM-signed receiveshigher trust from sme large Internet email servers, making it less likely that your email is treatedas spam.·Using the new auto-ban settings, you can configure hMailServer to automatically disconnect andtemporarily ban users after too many failed logon attempts.

Other improvements:

·A few new settings have been added to IP ranges. IP ranges in 5.1 allows more fine-grainedcontrol over authentication.·The user interfaec in WebAdmin has been updated. The interface is now tab-based, which makesit more easy to navigate.

News in hMailServer 5

Major new features:

·Score based spam protection. In version 5, every spam protection mechanism generates a spamscore for an email message. If the total spam score reaches a certain threshold, the message willbe marked as spam. If it reaches an even higher threshold, it may be deleted. This newfunctionality will improve the overall spam classification of messages.·Built in SSL encryption. Using this new functionality, you can set up a secure connectionbetween hMailServer installation and your users. The SSL functionality is also available whenhMailServer communicates with other servers which supports SSL. For example, you no longerneed to use external tools to download messages from other SSL POP3 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 enablingthe integration.·hMailServer now supports Public folders. You can now set up public folders which some or allusers on the server can access. It is possible to give users (or groups) separate permissions forthese public folders, for example to make sure that only moderators can add or delete messagesin 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, hMailServercan now use PostgreSQL as backend store.·Fully integrated database. In earlier versions, MySQL was bundled as the default databaseoption. In version 5, this has been changed to MSSQL CE. The database engine will be hosted byhMailServer which makes hMailServer easier to install. Upgrades will not be affected by thischange.·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

hMailServer - Guide de l'Utilisateur

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, POP3and 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 amessage. 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 whichaccesses email data will have no problem accessing messages containing for example japanese orarabic characters.·A lot of new functionality have been added to the hMailServer COM API. See the Com API changelog for more information.·And more...

 

Informations sur l'auteur

La technologie de serveur et la conception générale de hMailServer est l'œuvre de Martin Knafve.

Le logiciel utilise un certain nombre de composants et de bibliothèques tiers.

·Encodage / décodage Mime par Jeff Lee·Algorithme MD5 par RSA Data Security·Algorithme Blowfish par Bruce Schneier·Bibliothèque SPF par Roger Moser·Boost par boost.org·Winsock, ATL, ADO etc par Microsoft·InnoSetup par JR Software·ToolkitCe produit inclut un logiciel développé par le Projet OpenSSL pour utilisation dans le OpenSSL (http://www.OpenSSL.org/).

Informations de Contact

Martin KnafveNedre Långvinkelsgatan 21252 20 HelsingborgSweden

[email protected]: +46 (0)42 30 10000Cell: +46 (0)73 82 00 781

Journal des Changements de hMailServer

Le journal des changement a été déplacé

Le journal des changements a été déplacé sur http://www.hmailserver.com/?page=changelog.Vous devez actualiser vos signets.

Installation

Configuration Système Requise

Système d'Exploitation

hMailServer peut être installé sur les systèmes d'exploitation ci-dessous. Le dernier pack serviceWindows disponible doit être installé. hMailServer n'a été testé que sur les systèmesd'exploitation suivants, mais peut aussi fonctionner sur les autres versions des systèmes

hMailServer - Guide de l'Utilisateur

11 / 214

d'exploitation. Seules les versions ci-dessous sont officiellement et régulièrement testées.

hMailServer 5

·Microsoft Windows 2008 (toutes éditions, sauf Core)·Microsoft Windows Vista·Microsoft Windows 2003 (toutes éditions)·Microsoft Windows XP Professionnel·Microsoft Windows 2000 (toutes éditions)

hMailServer 4.3 and 4.4

·Microsoft Windows 2003 (toutes éditions)·Microsoft Windows XP Professionnel·Microsoft Windows 2000 (toutes éditions)

La prise en charge de Windows NT a été supprimée depuis que Microsoft ne prend plus en chargece système d'exploitation.

hMailServer 4.2

·Microsoft Windows 2003 (toutes éditions)·Microsoft Windows XP Professionnel·Microsoft Windows 2000 (toutes éditions)·Microsoft Windows NT

Autres Logiciels

Serveur de base de données

hMailServer a été conçu pour fournir, sous un seul téléchargement, tout ce dont vous avez besoinpour exécuter un serveur de messagerie. hMailServer possède son ppropre serveur de base dedonnées intégré, une version légère du serveur de base de données MSSQL. Si vous ne souhaitezpas l'utiliser, il vous suffit de sélectionner l'un des moteurs de base de données suivant:

·MySQL 4 et MySQL 5·Microsoft SQL Server 2000, 2005 et 2008 (incluant les éditions Express, Standard et Entreprise)·PostgreSQL 8

Notez que hMailServer n'est testé qu'avec la version définitive des moteurs de base de données.Si vous installez une version alpha ou beta de MySQL, par exemple, ne vous attendez pas à ceque hMailServer fonctionne avec cette version.

SquirrelMail

Si vous prévoyez d'utiliser le module de Changement de Mot de Passe hMailServer ou le moduleRéponse Automatique avec SquirrelMail, il vous faudra SquirrelMail 1.4.7 ou supérieur.

Administration Web

Si vous prévoyer d'utiliser PHPWebAdmin pour gérer votre installation de hMailServer via unnavigateur web, vous devez exécuter un serveur web dont la prise en charge de PHP estdisponible.

Logiciel incompatible

hMailServer - Guide de l'Utilisateur

12 / 214

hMailServer est incompatible avec les logiciels suivants:

·NetLimiter de Locktime Software. NetLimiter a une LSP Windows incorrectement écrite ("piloteWinsock") qui entraine des problèmes pour hMailServer. NetLimiter ne fonctionne pas non pluscorrectement avec d'autres logiciels (y compris les logiciels de Microsoft) et il ne devrait doncjamais être installé sur le même ordinateur que hMailServer). L'équipe de hMailServer a essayéd'obtenir des explications de Locktime Software concernant ceci, mais n'a jamais reçu de réponse.·NOD32/IMON de ESET. hMailServer n'est pas compatible avec le composant IMON de NOD32. Lorsde l'installation de NOD32, une alerte apparaît pour indiquer quele composant IMON ne devraitpas être installé sur les serveurs car il est connu pour entraîner des problèmes avec les logicielsserveurs. (hMailServer n'a aucun problème pour coexister et utiliser NOD32 tant que le composantIMON n'est pas activé)

Antivirus

Pour que hMailServer fonctionne correctement, l'examen viral automatique du dossier hMailServerData doit être désactivé. Vous devriez configurer votre antivirus pour exclure le dossierhMailServer Data de l'examen. Si vous le faites, il est conseillé de configure hMailServer pour qu'illance examen viral dès qu'un nouveau e-mail est reçu.

Matériel

Performance

La configuration matérielle est très dépendante du nombre d'utilisateurs. Elle dépend aussi del'utilisation ou non de la prise en charge IMAP, de l'antivirus, des filtres, etc. POP3 utilise beaucoupmoins de ressources CPU que IMAP, et si vous avez de nombreux utilisateurs, POP3 estrecommandé. hMailServer utilise normalement moins de 100Mo de mémoire. Les installations lesplus étendues de hMailServer ont plus de 20.000 comptes utilisateur hébergés sur un seulserveur.

Résolution de l'écran

Le programme d'administration pour hMailServer, l'Administrateur de hMailServer, nécessitent unerésolution d'écran de 800x600 ou supérieure.

Connaissances techniques

Pour être capable de réussir le paramétrage d'un serveur de messagerie, vous devez connaîtreles bases concernant certaines techniques relatives à Internet et à la messagerie. Bien que ladocumentation de hMailServer décrive et commente ces éléments, elle ne doit pas être considéréecomme une documentation de référence dans ce domaine. Vous devez posséder desconnaissances de base concernant les éléments suivants pour mener à bien les réglages d'unserveur de messagerie sous Windows.

·Microsoft Windows·Noms de domaine et noms d'hôte·Pare-feux et routeurs·DNS, Système de Noms de Domaine·Ports TCP/IP

 

Choisir un moteur de base de données

Généralités

hMailServer - Guide de l'Utilisateur

13 / 214

hMailServer prend en charge 5 différents moteurs de base de données

·Microsoft SQL Server 2000 et supérieur·Microsoft SQL Server Compact Edition (CE)·MySQL 4 et supérieur·PostgreSQL

Choisir une base de données

Dans la version 5, Microsoft SQL Server Mobile Edition est utilisé par défaut. Le plus gros avantageavec ce moteur de base de données est la faible utilisation de la mémoire et de l'espace disque, etaussi le fait qu'aucun autre logiciel externe n'est requis pour fonctionner sur l'ordinateur. Lemoteur de base de données s'exécute à l'intérieur de hMailServer, ce qui signifie que hMailServerne dépend aucunement de moteurs de base de données externe. Les versions précédentes dehMailServer (4 et inférieures) comprennent MySQL, qui a été changé pour MSSQL CE dans leversion 5. Il existe des inconvénients avec la base de données par défaut si:

L'installation de Microsoft SQL Server Compact Edition fourni avec hMailServer est limitée à 4Go . Sivous pensez que votre installation devient volumineuse (des centaines ou des milliers de demessages ou de nombreux comptes), il est conseillé de choisir Microsoft SQL Server ou MySQL.Une base de données MSSQL CE de 4Go peut contenir les références d'environ 10 million demessages. En terme de performance, MSSQL CE est plus lent que les autres moteurs de bases dedonnées pris en charge. Aussi, quelques outils sont disponibles si une base de données SQL CEdevient corrompue, du fait, par exemple, d'une panne matérielle ou d'un plantage du système.

Recommandations

Microsoft SQL Server ou MySQL est conseillé si...

·... l'envoi et la réception de massages est vital et que vous ne pouvez pas prendre le risque deperdre des données ·... vous envisagez de faire une intégration qui implique la base de données hMailServer. Il existedavantage d'outils client disponibles pour Microsoft SQL Server et MySQL par rapport àPostgreSQL.

PostgreSQL est conseillé si vous l'avez déjà utilisé et que vous vous sentez à l'aise avec cemoteur.

 

Guide de démarrage rapide

Didacticiel d'Installation

Installer hMailServer

Cette section décrit les étapes nécessaires pour installer hMailServer 5. Avant l'installation dehMailServer, vous devez vérifier que votre ordinateur correspond à la Configuration SystèmeRequise.

Etape 1: Téléchargement

La première étape consiste à télécharger hMailServer. Le programme d'installation est disponibleau téléchargement à la page de téléchargement. Il est recommandé de télécharger la dernièreversion stable. Le fichier à télécharger à un nom sous la forme hMailServer-version-build.exe. Parexemple, version-build peut signifier 5.0-Build-305.

hMailServer - Guide de l'Utilisateur

14 / 214

Etape 2: Installation

·Double-cliquez sur le fichier téléchargé pour lancer l'installation. La première boîte de dialogue quiapparaît est la fenêtre 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, sélectionnez "J'accepte cet accord" et cliquez sur Suivant.

 

·Sélectionnez le dossier de destination et cliquez sur Suivant. Vous devez choisir un lecteur local

hMailServer - Guide de l'Utilisateur

15 / 214

et non un dossier réseau. Il est possible d'installer hMailServer sur un périphérique amovible, maisvous ne pourrez pas exécuter hMailServer à partir d'un autre ordinateur.

·Sélectionnez les composants à installer et cliquez sur Suivant. Sur le serveur, vous devez installertous les composants disponibles. Si vous avez déjà installé le serveur hMailServer sur un autreordinateur et que vous souhaitez le gérer à distance, il vous suffit d'installer les outilsAdministratifs.

·Sélectionnez le dossier du menu Démarrer dans lequel vous souhaitez placer les icônes dehMailServer et cliquez sur Suivant.

hMailServer - Guide de l'Utilisateur

16 / 214

·Confirmez que les paramètres sont corrects et cliquez sur Installer pour effectuer l'installation.

·Patientez... L'installation devrait prendre 10 à 20 secondes.

hMailServer - Guide de l'Utilisateur

17 / 214

·Après l'installation des fichiers, vous devez fournir au programme d'installation un mot de passeprincipal hMailServer. Pour la version 4.3 et ultérieur, un mot de passe principal est utilisé pouraméliorer la sécurité. Le mot de passe peut librement choisi, à condition qu'il dépasse 5caractères. Vous aurez besoin de ce mot de passe plus tard, lors de l'administration du serveur, etvous ne devez donc pas l'oublier. Il vous faut spécifier le mot de passe uniquement la premièrefois que vous installez hMailServer

·A la fin de l'installation, vous pouvez lancer hMailServer Administrator (que vous trouverez dans lemenu Démarrer). La première fenêtre qui apparaît est la boîte de dialogue Connexion. Elle vouspermet de vous connecter à différentes installations de hMailServer sur votre réseau.Normalement, vous aurez à vous connecter à localhost. Sélectionnez localhost, et cliquez surConnexion. Dans la boîte de dialogue du mot de passe, entrez votre mot de passe principal

hMailServer - Guide de l'Utilisateur

18 / 214

hMailServer et cliquez sur OK.

Etape 3: Tâches après installation

Configuration DNS

Après l'installation de hMailServer, vérifiez que vous configurez votre serveur DNS correctement.Pour que SMTP fonctionne, vous devez définir les enregistrements MX de votre domaine. MXsignifie Mail eXchanger. Autrement dit, les enregistrements MX indiquent aux autres serveurs demessagerie que ce serveur de votre domaine est responsable de la gestion du courrier. Cliquez icipour en savoir plus sur les enregistrements MX.

Etape 4: Configuration du serveur

Le didacticiel pour configurer le serveur est ici.

Si vous rencontrez des problèmes, consultez la rubrique guide de dépannage.

Didacticiel de Configuration

Généralités

Cette rubrique décrit les bases de la configuration de hMailServer. Elle n'inclut pas les informationsconcernant le réglage des examens de l'antivirus, ni la protection contre les spams. Si vous n'êtespas sûr de comprendre le fonctionnement de hMailServer, consultez cette rubrique avant deconfigurer le serveur.

Connexion à hMailServer

1.Dans le menu Démarrer, sélectionnez hMailServer AdministratorLa boîte de dialogue Connexion de hMailServer Administrator apparaît. Elle vous permet de vousconnecter à différents services de hMailServer.2.Double-cliquez sur le nom d'hôte "localhost" pour vous connecter à l'instance de hMailServers'exécutant sur localhost.3.Dans la boîte de dialogue Mot de Passe, indiquez le mot de passe que vous avez spécifié lors del'installation de hMailServer - le mot de passe d'administration principal de hMailServer, et cliquezsur OK

hMailServer - Guide de l'Utilisateur

19 / 214

4.Maintenant, hMailServer Administrator est lancé.

Domaines & Comptes

Tout domaine hMailServer doit être connecté à un domaine Internet. Supposons que vous être lepropriétaire 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 àposséder un compte par adresse e-mail à partir de laquelle vous voulez envoyer et recevoir desmessages. Si vous possédez les adresses [email protected] et [email protected],ajoutez-les simplement à hMailAdmin:

1.Lancez hMailAdmin2.Déployez Domaines dans l'arborescence de gauche3.Cliquez sur le domaine something.com4.Cliquez sur Ajouter un compte5.Entrez webmaster comme adresse de compte, indiquez le mot de passe et cliquez sur Enregistrer6.Cliquez sur le domaine something.com dans l'arborescence de gauche7.Cliquez sur Ajouter un compte8.Entrez info comme adresse de compte, indiquez le mot de passe et cliquez sur Enregistrer

Spécifier le nom de l'hôte public

Pour qu'un serveur fonctionne correctement, il doit connaître son nom public sur Internet. Il s'agitnormalement de quelque chose comme mail.something.com. Comme rien n'existe comme logicielpour détecter automatiquement le nom de l'hôte de l'ordinateur sur lequel il s'exécute, vous devezindiquer à hMailServer le nom d'hôte à utiliser. Bien qu'il soit possible d'exécuter hMailServer sanslui indiquer son nom d'hôte public, certains serveurs de messagerie refuseront vos messages sivous ne le spécifiez pas.

1.Lancez hMailAdmin2.Dans l'arborescence de gauche, allez à Paramètres -> Protocoles -> SMTP3.A droit, les paramètres SMTP sont désormais affichés. Cliquez sur l'onglet Distribution desmessages.4.Dans Nom d'hôte, entrez le nom d'hôte public de l'ordinateur sut lequel s'exécute hMailServer.5.Enregistrez les changements

Spécifiez le serveur SMTP

Certains fournisseurs d'accès internet (ceux qui offrent votre connexion à Internet) bloquent letrafic sortant sur le port 25. Comme le trafic sortant sur le 25 est requis pour que la messageriefonctionne correctement, vous devez convaincre votre FAI de vous ouvrir le port 25 (s'il n'est pasouvert), ou configurer hMailServer pour transmettre tout courrier électronique via le serveur demessagerie de votre FAI.Pour déterminer si le port 25 est bloqué, entrez telnet mail.hmailserver.com 25 en ligne decommande. Si vous pouvez vous connecter, le port 25 n'est pas bloqué; Sinon, le port 25 estbloqué.Si vous configurez le serveur de messagerie de votre FAI comme relais SMTP, hMailServer délivreratous les messages sortants au serveur de messagerie de votre FAI, qui à son tour les délivrera aubon destinataire. Comme c'est, la plupart du temps, toujours possible d'envoyer un e-mail via leserveur de messagerie de votre FAI, il s'agit d'un palliatif si le port 25 est bloqué.

1.Lancez hMailAdmin2.Dans l'arborescence de gauche, allez à Paramètres -> Protocoles -> SMTP3.A droite, les réglages SMTP apparaissent. Cliquez sur l'onglet Délivrer un e-mail.4.Dans le champ Relais MTP, entrez le nom d'hôte du serveur de messagerie de votre FAI, avec vosidentifiants sur ce serveur au cas où une identification serait demandée.5.Enregistrez vos modifications

hMailServer - Guide de l'Utilisateur

20 / 214

Notez que vous ne devez JAMAIS spécifier localhost, 127.0.0.1, ou votre propre nom d'hôtecomme relais SMTP, car cela signifierait que hMailServer devrait essayer de transmettre lesmessages à lui-même. Il en résulterait une boucle interminable. De même, vous devez laisser cechamp vierge si votre FAI n'a pas bloqué le port 25.

Configuration des plages IP

Les plages IP sont utilisées par hMailServer pour spécifier qui est autorisé à envoyer desmessages via votre serveur. Vous pouvez, par exemple, utiliser des plages IP pour configurerhMailServer de telle sorte que seuls les ordinateurs de votre réseau local soient autorisés àutiliser le serveur pour envoyer des messages. Par défaut, hMailServer est proposé avec deuxplages IP différentes. Ces plages IP par défaut doivent être suffisantes pour la plupart desutilisateurs. Sauf si vous utilisez de vieux clients de messagerie avec très peu de fonctionnalités,vous ne devriez jamais avoir à les modifier sauf si vous êtes absolument sûr de votre objectif enutilisant des plages IP, et comment y parvenir.

Dépannage

La plupart du temps, lorsqu'un utilisateur rapporte un problème d'installation et de configurationde hMailServer, le problème ne se situe pas au niveau de l'installation de hMailServer, mais auniveau des paramètres é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 dépannage si vous rencontrez des problèmes.

Installation de PHPWebAdmin

Généralités

Cette rubrique décrit comment installer hMailServer WebAdmin, le front-end de l'administrationPHP pour hMailServer.

Préalable

·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 plusavec cette version.·La valeur de register_globals PHP doit être réglée sur off pour que PHPWebAdmin fonctionnecorrectement.·Dans la configuration PHP, les paramètres suivants doivent être configurés que PHPWebAdminfonctionne correctement:

o register_globals doit être réglé sur offo display_errors doit être réglé sur off

Etape 1: Copier les fichiers

La première étape consiste àà copier PHPWebAdmin à partir du dossier hMailServer dans votredossier racine web. La racine web diffère des serveurs web, ce qui fait que vous devez consultezla documentation de votre serveur web si vous n'êtes pas sûr de savoir où est placée votre racineveb. 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, defaçon à obtenir C:\wwwroot\PHPWebAdmin.

La description ci-dessous suppose que votre racine web est C:\wwwroot.

Etape 2: Installation

hMailServer - Guide de l'Utilisateur

21 / 214

Accédez au dossier WebAdmin à la racine web.

1.Créez une copie du fichier nommé config-dist.php et donnez-lui pour nom config.php.2.Le fichier config.php contient les paramètres de base pour PHPWebAdmin et doit être modifiépour l'ajuster à votre système:

o Réglez la valeur de rooturl sur l'URL d'accès au WebAdmin.

Exemple:$hmail_config['rooturl'] = "http://localhost/PHWebAdmin/";

3.Si vous utilisez IIS6 ou si vous exécutez votre serveur web (Apache ou IIS) comme un compteutilisateur spécifique avec des permissions limitées, vous devez suivre ces étapes.4.Créez un fichier robots.txt à lla racine du serveur web pour empêcher Google et autres robots derecherche d'indexer hMailServer WebAdmin. Si une vulnérabilité de sécurité est détectée dansPHPWebAdmin, l'attaque sera plus difficile

Etape 3: Utilisation

Pointez votre navigateur web sur http://localhost/PHPWebAdmin et ouvrez une session avec vosnom d'utilisateur et mot de passe hMailServer.

Lorsque vous actualisez votre installation de hMailServer pour une version supérieure, vérifiez quevous copiez bien le dernier WebAdmin du dossier d'installation de hMailServer dans votre dossierweb. Si vous ne le faites pas, vou obtiendrez un message d'erreur lors de la tentative d'accès àWebAdmin.

Erreurs de configuration courantes

Il existe quelques fautes courantes d'installation. Consultez la rubrique guide de dépannage pouren savoir plus. 

 

Scénarios 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

Scénario:

Vous avez un simple serveur que vous souhaitez utiliser comme serveur de messagerie. VousFournisseur d'Accès à Internet (FAI) vous a attribué une adresse IP dynamique.

Etape 1: Vérification de la Configuration Système

Avant de continuer, vous devez vérifier que votre FAI vous permet d'exécuter votre propre serveurde messagerie sur votre réseau. Vous devez aussi vérifier que votre FAI n'a pas bloqué le port 25pour 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

hMailServer - Guide de l'Utilisateur

22 / 214

Pour pouvoir recevoir les e-mails des autres serveurs, vous devez installer les enregistrements MXpour votre domaine. Les enregistrements MX sont des entrées du serveur DNS qui indiquent auxautres ordinateurs sur Internet quel ordinateur (nom d'hôte) héberge les e-mails pour votredomaine.

Comme vous utilisez une adresse IP dynamique, vous devez enregistrer un nom d'hôte qui estactualisé automatiquement dès que votre adresse IP change. Il existe plusieurs sociétés quiproposent ce service gratuitement. Le didacticiel suivant suppose que vous avez enregistré unsous-domaine gratuit sur No-IP, nommé something.no-ip.com et que ce nom d'hôte pointe surl'adresse IP de votre ordinateur (No-IP offre unn petit utilitaire Windows gratuit qui actualiseautomatiquement l'hôte dès que votre adresse IP change).

Si vous avez accès à une interface web qui vous permet de modifier les paramètres DNS, vouspouvez configurer vos enregistrements MX vous même. Sinon, vous devez contacter la société quia enregistré votre domaine et lui demander de configurer les enregistrement MX pour votredomaine.

Ainsi, dans cet exemple, vous devriez entrer quelque chose comme something.no-ip.com commeenregistrement MX pour votre domaine.

Step 3: Changer les réglages du pare-feu

Si vous avez un pare-feu (je l'espère) vous devez modifier ses paramètres pour autoriserhMailServer à recevoir des e-mails. Un e-mail est normalement envoyé et reçu sur le port 25 enTCP/IP. Ce qui signifie que vous devez configurer votre pare-feu pour autoriser le trafic entrant etsortant sur le port 25 en TCP/IP. Si vous êtes devant une sorte de routeur, vous devez configurercelui-ci pour transmettre tout trafic sur le port 25 à l'ordinateur sur lequel s'exécute hMailServer.

Step 4: Installer hMailServer

1.Téléchargez la dernière version de hMailServer2.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'hôte, entrez le nom d'hôte de votre ordinateur, something.no-ip.com dansnotre exemple.

Etape 5: Configurer la messagerie sortante

Si votre FAI a bloqué le trafic sortant sur le port 25, hMailServer ne pourra pas délivrer lesmessages aux autres serveurs car normalement tous les serveurs SMTP ne reçoivent les e-mailsque 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 expédier tous les messages sortants via le serveurSMTP de votre FAI. Pour ce faire, suivez ces étapes:

1.Lancez hMailServer Administrator2.Allez aux paramètres SMTP et choisissez Livraison des e-mails.3.Dans les réglages 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 sonserveur, activez Le serveur nécessite une authentification, et entrez le nom d'utilisateur et le mot depasse.

Step 6: Configurer votre client de messagerie

Dans votre client de messagerie, ajoutez un nouveau compte. Entrez les informations suivantes:

·Nom d'hôte - Le nom d'hôte ou l'adresse IP de l'ordinateur qui exécute hMailServer·Nom d'utilisateur - Votre adresse de messagerie complète. La même que l'adresse du compte que

hMailServer - Guide de l'Utilisateur

23 / 214

vous avez ajoutée dans hMailServer Administrator.·Mot de passe - Le mot de passe que vous avez défini dans hMailServer Administrator

Simple serveur, adresse IP statique

Scénario:

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 domainesur lequel vous souhaitez héberger les messages se nomme mydomain.com.

Etape 1: Vérification de la Configuration Système

Avant de poursuivre, vous devez vérifier si votre FAI vous autorise à exécuter votre propreserveur de messagerie. Vous devez aussi vérifier que votre FAI n'a pas bloqué le port 25 pour letrafic 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 régler les enregistrements MX pourvotre domaine. Les enregistrements MX sont des entrées du serveur DNS qui indiquent aux autresordinateurs sur Internet quel ordinateur (nom d'hôte) héberge les e-mails pour votre domaine.

Si vous avez accès à une interface web qui vous permet de modifier les paramètres DNS, vouspouvez configurer vos enregistrements MX vous même. Sinon, vous devez contacter la société quia enregistré votre domaine et lui demander de configurer les enregistrement MX pour votredomaine.

1.Créez 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 votreordinateur.3.Ajoutez un enregistrement MX qui a pour valeur mail.something.com pour votre domaine.

Step 3: Changer les réglages du pare-feu

Si vous avez un pare-feu (je l'espère) vous devez modifier ses paramètres pour autoriserhMailServer à recevoir des e-mails. Un e-mail est normalement envoyé et reçu sur le port 25 enTCP/IP. Ce qui signifie que vous devez configurer votre pare-feu pour autoriser le trafic entrant etsortant sur le port 25 en TCP/IP. Si vous êtes devant une sorte de routeur, vous devez configurercelui-ci pour transmettre tout trafic sur le port 25 à l'ordinateur sur lequel s'exécute hMailServer.

Step 4: Installer hMailServer

1.Téléchargez la dernière version de hMailServer2.Suivez l'assistant d'installation.3.Lancez hMailServer Administrator.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'hôte, entrez le nom d'hôte de votre ordinateur, something.no-ip.com dansnotre exemple.

Step 5: Configurer la messagerie sortante

Si votre FAI a bloqué le trafic sortant sur le port 25, hMailServer ne pourra pas délivrer lesmessages aux autres serveurs car normalement tous les serveurs SMTP ne reçoivent les e-mailsque sur le port 25. Si votre FAI a bloqué le trafic sortant sur le port 25, la meilleure solution est,

hMailServer - Guide de l'Utilisateur

24 / 214

normalement, de configurer hMailServer pour expédier tous les messages sortants via le serveurSMTP de votre FAI. Pour ce faire, suivez ces étapes:

1.Lancez hMailServer Administrator2.Allez aux paramètres SMTP et choisissez Livraison des e-mails.3.Dans les réglages 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 sonserveur, activez Le serveur nécessite une authentification, et entrez le nom d'utilisateur et le mot depasse.

Step 6: Configurer votre client de messagerie

Dans votre client de messagerie, ajoutez un nouveau compte. Entrez les informations suivantes:

·Nom d'hôte - Le nom d'hôte ou l'adresse IP de l'ordinateur qui exécute hMailServer·Nom d'utilisateur - Votre adresse de messagerie complète. La même que l'adresse du compte quevous avez ajoutée dans hMailServer Administrator.·Mot de passe - Le mot de passe que vous avez défini dans hMailServer Administrator

Mise à niveau

Conseils de mises à niveau

Généralités

Ce document vous propose quelques recommandations générales concernant la mise à niveau devotre version de hMailServer vers une version plus récente.

Etape 1: Tout sauvegarder

Avant la mise à niveau de hMailServer, vous devez sauvegarder tous vos messages etparamètres. C'est très rare qu'une mise à niveau de hMailServer échoue, mais si c'est le cas, vousdevez 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 votresystème avant une mise à niveau.

Step 2: Désinstaller une ancienne version avant d'en installer une nouvelle?

Généralement, il n'est pas nécessaire de désinstaller l'ancienne version de hMailServer avant d'eninstaller une nouvelle. Le programme d'installation de hMailServer arrêtera automatiquementl'installation en cours de hMailServer avant d'installer la nouvelle version. La recommandation estdonc de ne pas désinstaller la version existante avant d'installer la nouvelle version.

Exception à cette règle: si vous passez de hMailServer 3.x à hMailServer 4.x. L'API COM dehMailServer a un nouveau nom dans hMailServer 4.x. Si vous ne désinstallez pas hMailServer 3.xavant d'installer hMailServer 4.x, cet ancien API existera encore sur votre système. Ce qui nedevrait jamais poser de problèmes. Mais si vous ne voulez pas que l'ancien API soit encoredisponible, vous devrez désinstaller hMailServer 3.x avant d'installer hMailServer 4.x.

La désinstallation de hMailServer ne supprime pas les messages, les comptes ou autresparamètres. Vous pouvez désinstaller hMailServer et le réinstaller sans aucune perte demessages.

Step 3: Installer la nouvelle version

hMailServer - Guide de l'Utilisateur

25 / 214

Les étapes ci-dessous sont les mêmes pour la plupart des versions de hMailServer. Pour les informations spécifiques d'une version, consultez la rubrique Mise à Niveau de cettedocumentation.

1.Téléchargez hMailServer sur le site web de hMailServer.2.Lancez l'exécutable d'installation en double-cliquant dessus.3.Suivez les différentes boîtes de dialogue et cliquez sur Installer de la boîte de dialogue Prêt àinstaller.4.Le programme d'installation effectue alors une copie des fichiers. Si vous avez un message quiindique qu'il ne peut pas remplacer le fichier libmysql.dll, redémarrez Apache/IIS et cliquez surRéessayer.5.Après la copie des fichiers, l'installateur lancera automatiquement la mise à jour de la base dedonnées de hMailServer si nécessaire.6.Si la mise à jour de la base de données de hMailServer est lancée, cliquez sur Actualiser pourpasser de la base de données actuelle à la nouvelle structure de base de données.7.Après le mise à jour de la base de données, l'installateur lance automatiquement le servicehMailServer.8.Cliquez sur Quitter pour revenir à l'assistant d'installation9.Cliquez sur Terminer pour quitter l'installation et lancer hMailAdmin.

Etapes de mises à niveau de versions multiples

Lorsque vous mettez à niveau hMailServer pour la dernière version, vous pouvez installerimmédiatement la dernière version à l'étape 3. Si, par exemple, vous passez de la version 4.0 à laversion 4.4, vous n'avez pas à installer les versions 4.1, 4.2 ou 4.3 car la version 4.4 contienttoutes les modifications effectuées pour les versions 4.1, 4.2 et 4.3. Il est possible de passerdirectement de la version 2.0 et supérieure à le dernière version sans installer les autres versionsintermédiaires. La seule exception à la règle est la suivante:

·Si vous utilisez MySQL, et que vous passez de la version 4.3 ou antérieure à la version 5, vousdevez devez d'abord passer à version 4.4 avant de passer à la version 5.

Questions Souvent Posées

Mes données sont-elles préservées lors de la mise à niveau?

Lorsque vous passez d'une version à la dernière version, les données de votre base de donnéeset la totalité de vos messages sont préservés. Cependant, il existe un risque que quelque chosese passe mal au cours du processus de mise à niveau, et il est donc important d'effectuer unesauvegarde complète de votre installation.

hMailServer continuera t-il à utiliser ma base de données actuelle?

Lorsque vous passez d'une version à la dernière version, hMailServer continue à utiliser la mêmebase de données qu'il utilisait auparavant. Le processus de mise à niveau actualisera la structuredes tables de la base de données afin qu'elle soit compatible avec la nouvelle version dehMailServer.

Mise à niveau: 3.x vers 4.0

Généralités

Cette section décrit les étapes à suivre pour passer de hMailServer version 3.x à hMailServerversion 4.0. Si vous suivez ces étapes, le temps d'arrêt du serveur ne durera que quelquesminutes. Avant la mise à niveau, vérifiez que vous possédez une sauvegarde du dossier completde hMailServer, de la base de données de hMailServer et du fichier hMailServer.ini, au cas oùquelque chose se passerait mal. Les étapes ci-dessous sont les mêmes, quel que soit le type deserveur de base de données utilisée par hMailServer. Lisez la totalité de cette rubrique avant depassez à la mise à niveau.

Installer la nouvelle version

hMailServer - Guide de l'Utilisateur

26 / 214

1.IMPORTANT: Sauvegardez votre base de données, votre dossier hMailServer et le fichierhMailServer.ini.2.Téléchargez hMailServer 4.0 sur le site web de hMailServer.3.Lancez l'exécutable d'installation en double-cliquant dessus. Il n'est pas nécessaire d'arrêter oude désinstaller la version précédente avant d'installer la version 4.0. L'installateur de hMailServer4.0 prendra soin de cela.4.Suivez le différentes boîtes de dialogue de l'installation et cliquez sur Installer dans la boîte dedialogue Prêt à installer.5.L'installateur effectue alors une copie des fichiers. Si vous avez un message qui indique qu'il nepeut pas remplacer le fichier libmysql.dll, redémarrez Apache/IIS et cliquez sur Réessayer6.Après la copie des fichiers, l'installateur lance automatiquement la mise à jour de la base dedonnées de hMailServer.7.Cliquez sur Actualiser pour mettre à jour la base de données pour la structure 4.0.8.Après la mise à jour de la base de données, l'installateur lancera automatiquement le servicehMailServer.9.Cliquez sur Quitter pour revenir à l'assistant d'installation10.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 différents niveauxd'utilisateurs. Pour chaque compte du serveur, vous pouvez définir si l'utilisateur aura les droits d'Administration du Serveur, les droits d'administration du domaine ou les droits d'administrationutilisateur seuls. A l'aide de ces niveaux, il est possible de déléguer des tâches aux propriétairesdu domaines, de sorte que ceux-ci peuvent ajouter leurs comptes eux-mêmes via PHPWebAdmin.

Règles

hMailServer 4.0 prend en charges des règles. Avec ces règles, vous pouvez spécifier de quellefaçon les messages seront traités en fonction de leur contenu. Si vous souhaitez, par exemple quetous les messages contenant un certain en-tête, soient déplacés dans un dossier IMAP nommé"spam", ou que tous les messages destinés à [email protected] soient transférés à[email protected]. Ces options, ainsi que de nombreuses autres, sont possibles en utilisantdes règles.

Prise en charge des Scripts

En utilisant des scripts cette fonction, vous pouvez écrire vos propres scripts VBA qui serontexécutés lors de certains événements. Exemple; un événement nommé OnMessageDeliver estexécuté lorsqu'un message est délivré. Lors de cet événement, vous pouvez faire ce que vousvoulez avec ces messages messages, comme en remplacer le sujet lorsqu'il correspond à certainscritères. Autrement dit, avec VBA-scrip, vous pouvez effectuer des actions avancées sur vosmessages.

Récupérateur POP3

La prise en charge du téléchargement des e-mails à partir des autres serveurs POP3 a étéajoutée. Vous pouvez spécifier les paramètres du serveur, l'intervalle de récupération et indiquersi les messages sont à supprimer du serveur distant. Le protocole POP3 est utilisé pour ce faire.

Service DCOM

La bibliothèque COM de hMailServer 4.0 prend en charge l'exécution distante. Ce qui vous permetd'exécuter PHPWebAdmin sur un ordinateur et le serveur hMailServer sur un autre. Cependant, laconfiguration DCOM est nécessaire, en utilisant les Services du Composant.

Après l'installation

hMailServer - Guide de l'Utilisateur

27 / 214

hMailServer.ini

Avec hMailServer 3.x et antérieur, hMailServer.ini était enregistré dans le dossier Windows. Ce quiposait parfois des problèmes sur les serveurs exécutant Terminal Services (TS), car vous nepouviez avoir qu'un seul dossier Windows par utilisateur lors de l'exécution de TS. Lorsque vouspassez à la version 4.0, le fichier hMailServer.ini est copié de votre dossier Windows vers ledossier Bin de hMailServer. Si votre serveur ne démarre pas après la mise à niveau, il se peut quevous ayez à copier le fichier manuellement du dossier Windows au dossier Bin.

Nouveau type de service

Avec hMailServer 4.0, le composant service a été complètement réécrit. Les utilisateurs l'exécutentavec succès sous Windows NT 4, Windows 2000, XP et Windows 2003. Si vous avez une autreversion de Windows, comme l'édition MediaCenter, vous allez installer le composant service à vospropres risques.

Service & API COM

Avec hMailServer 4.0, la bibliothèque COM est beaucoup plus intégrée au service du serveur,plutôt que d'être une DLL externe comme pour les précédentes versions. Il en résulte que leservice doit être lancé pour que la bibliothèque COM fonctionne. Comme hMailAdmin utilise labibliothèque COM, vous ne pourrez plus arrêter le service en utilisant hMailAdmin. Au lieu de cela,lorsque vous cliquez sur Stop ou Démarrer dans hMailAdmin, vous lancez ou arrêtez l'exécution duserveur hMailServer à l'intérieur du service. Si vous arrêtez le serveur, hMailServer fermera toutesles connexions, les ports et arrêtera la diffusion des messages. Cependant, le service hMailServersera encore actif.

Mise à niveau: 4.x vers 5.0

Généralités

Cette section décrit les étapes à suivre pour passer de hMailServer version 4.x à hMailServerversion 5.0. Si vous suivez ces étapes, le temps d'arrêt du serveur ne durera que quelquesminutes. Avant la mise à niveau, vérifiez que vous possédez une sauvegarde du dossier completde hMailServer, de la base de données de hMailServer et du fichier hMailServer.ini, au cas oùquelque chose se passerait mal. Les étapes ci-dessous sont les mêmes, quel que soit le type deserveur de base de données utilisée par hMailServer. Lisez la totalité de cette rubrique avant depassez à la mise à niveau.

Avant l'installation

·Notez que la configuration système requise pour la version 5 n'est pas,la même que pour laversion 4. Pour la version 5.0, Microsoft SQL Server version 2005 est requis. Pour la version 5.1, laversion 2000 est également prise en charge. Ainsi, si vous utilisez Microsoft SQL Server 2000, vouspouvez passer directement de la version 4 à la version 5.1 ou supérieure. Nne pas passer d'abordà la version 5.0.·Si vous utilisez la base de données interne MySQL, et que vous passez de la version 4.2 ouantérieure, vous devez installer la dernière version 4.4 avant de passer à la version 5. Si vous nele faites pas, la mise à jour de la base de données échouera.

Installer la nouvelle version

1.IMPORTANT: Sauvegardez votre base de données, votre dossier hMailServer et le fichierhMailServer.ini.2.Lisez la section Rétro-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 connaître les nouvellesfonctionnalités.3.Téléchargez hMailServer 5 sur le site web de hMailServer.4.Lancez l'exécutable d'installation en double-cliquant dessus. Il n'est pas nécessaire d'arrêter oude désinstaller la version en cours avant d'installer la nouvelle version.5.Suivez le différentes boîtes de dialogue de l'installation et cliquez sur Installer dans la boîte dedialogue Prêt à installer.

hMailServer - Guide de l'Utilisateur

28 / 214

6.L'installateur effectue alors une copie des fichiers.7.Après la copie des fichiers, l'installateur lance automatiquement la mise à jour de la base dedonnées de hMailServer. Si vous voyez le texte "Création de la base de données hMailServer" dansl'assistant d'installation pendant plus de 15 secondes, et qu'aucune boîte de dialogue "Mise à jourde la base de données" n'apparaît, il est vraisemblable que cette dernière se trouve "derrière"l'assistant. Ainsi, si elle n'apparaît pas, essayez de déplacer la fenêtre de l'assistant d'installation.8.Cliquez sur Mettre à jour pour actualiser la base de données selon la structure la plus récente.9.Cliquez sur Quitter pour revenir à l'assistant d'installation10.Cliquez sur Terminer pour quitter l'installation et lancer hMailAdmin.

Quoi de neuf?

Pour obtenir la liste des nouvelles fonctionnalités et connaître les problèmes concernanthMailServer 5, cliquez ici.

Rétro-compatibilité

hMailServer 5 inclut de nombreux changements. Certains de ces changements modifient lecomportement des fonctionnalités existantes. Les fonctionnalités suivantes ont été réorganiséesdans hMailServer 5. Après la mise à niveau, revoyez la configuration pour vérifier qu'ellecorrespond bien à vos attentes.

·Nouveau moteur de base de données pa défaut

Dans hMailServer 4, le moteur de base de données interne était MySQL. hMailServer 5 utilise à laplace Microsoft SQLServer 2008 Compact Edition. Ce qui n'aura aucun effet sur les mises à jour - sivous avez installé hMailServer 4 avec la base de données interne MySQL et que vous passez à laversion 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 quehMailServer doit surveiller. Ill n'y avait aucun lien entre ces deux paramètres et ils étaient créésindépendamment l'un de l'autre. Avec la version 5, ces deux réglages sont désormais uniques, cequi signifie qu'il est maintenant possible de spécifier les ports que hMailServer doit surveiller pourdifférentes adresses IP. Sur 127.0.0.1, par exemple, hMailServer peut surveiller le port 25 et sur192.168.0.1, il peut surveiller le port TCP/IP 26. Si vous n'avez pas modifié le multi-hébergement par défaut ou le paramétrage du port TCP/IP dans hMailServer 4, ce changement ne vousaffectera pas.

·Changements de l'API COM

De nombreux changements ont été effectués 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 hachagesMD5 dans la base de données. MD5 n'est plus considéré comme sûr, et dans hMailServer 5, unalgorithme nommé SHA256 le remplace. Si vous disposez d'un logiciel personnalisé qui accède à labase de données de hMailServer et qui suppose que les mots de passe des comptes sont sous laforme de hachages MD5, vous devez actualiser ce logiciel, ou configurer hMailServer pourcontinuer à utiliser MD5 en utilisant le paramètre PreferredHashAlgorithm.

 

Mise à niveau: 5.0 vers 5.1

Généralités

Cette section décrit les étapes à suivre pour passer de hMailServer version 5.0 à hMailServerversion 5.1. Si vous suivez ces étapes, le temps d'arrêt du serveur ne durera que quelquesminutes. Avant la mise à niveau, vérifiez que vous possédez une sauvegarde du dossier completde hMailServer, de la base de données de hMailServer et du fichier hMailServer.ini, au cas oùquelque chose se passerait mal. Les étapes ci-dessous sont les mêmes, quel que soit le type de

hMailServer - Guide de l'Utilisateur

29 / 214

serveur de base de données utilisée par hMailServer. Lisez la totalité de cette rubrique avant depassez à la mise à niveau.

Avant l'installation

·Notez que la configuration système requise pour la version 5 n'est pas,la même que pour laversion 4. Si vous utilisez, par exemple, Microsoft SQL Server, Microsoft SQL Server 2005 estdésormais requis.·Si vous utilisez la base de données interne MySQL, et que vous passez de la version 4.2 ouantérieure, vous devez installer la dernière version 4.4 avant de passer à la version 5. Si vous nele faites pas, la mise à jour de la base de données échouera.

Installer la nouvelle version

1.IMPORTANT: Sauvegardez votre base de données, votre dossier hMailServer et le fichierhMailServer.ini.2.Lisez la section Rétro-compatibilité plus bas. Si quelque chose n'est pas clair, il est conseilléd'installer hMailServer 5.1 d'abord sur un serveur test pour en connaître les nouvellesfonctionnalités.3.Téléchargez hMailServer 5.1 sur le site web de hMailServer.4.Lancez l'exécutable d'installation en double-cliquant dessus. Il n'est pas nécessaire d'arrêter oude désinstaller la version en cours avant d'installer la nouvelle version.5.Suivez le différentes boîtes de dialogue de l'installation et cliquez sur Installer dans la boîte dedialogue Prêt à installer.6.L'installateur effectue alors une copie des fichiers.7.Après la copie des fichiers, l'installateur lance automatiquement la mise à jour de la base dedonnées de hMailServer. Si vous voyez le texte "Création de la base de données hMailServer" dansl'assistant d'installation pendant plus de 15 secondes, et qu'aucune boîte de dialogue "Mise à jourde la base de données" n'apparaît, il est vraisemblable que cette dernière se trouve "derrière"l'assistant. Ainsi, si elle n'apparaît pas, essayez de déplacer la fenêtre de l'assistant d'installation.8.Cliquez sur Mettre à jour pour actualiser la base de données selon la structure la plus récente.9.Cliquez sur Quitter pour revenir à l'assistant d'installation10.Cliquez sur Terminer pour quitter l'installation et lancer hMailAdmin.

Rétro-compatibilité

hMailServer 5.1 inclut de nombreux changements. Certains de ces changements modifient lecomportement des fonctionnalités existantes. Les fonctionnalités suivantes ont été réorganiséesdans hMailServer 5. Après la mise à niveau, revoyez la configuration pour vérifier qu'ellecorrespond bien à vos attentes.

Paramétrer l'authentification SMTP

Avec hMailServer 5.1, le paramétrage concernant l'authentification SMTP dans les plages IP a étéréorganisé. Après la mise à niveau pour la version 5.1, il est important de revoir la configurationdes plages IP pour voir si elle correspondent à vos attentes.

Mise à niveau: 5.1 vers 5.2

Généralités

Cette section décrit les étapes à suivre pour passer de hMailServer version 5.1 à hMailServerversion 5.2. Si vous suivez ces étapes, le temps d'arrêt du serveur ne durera que quelquesminutes. Avant la mise à niveau, vérifiez que vous possédez une sauvegarde du dossier completde hMailServer, de la base de données de hMailServer et du fichier hMailServer.ini, au cas oùquelque chose se passerait mal. Les étapes ci-dessous sont les mêmes, quel que soit le type deserveur de base de données utilisée par hMailServer. Lisez la totalité de cette rubrique avant depassez à la mise à niveau.

hMailServer - Guide de l'Utilisateur

30 / 214

Avant l'installation

·Si vous utilisez la base de données interne MySQL, et que vous passez de la version 4.2 ouantérieure, vous devez installer la dernière version 4.4 avant de passer à la version 5. Si vous nele faites pas, la mise à jour de la base de données échouera.·Si vous utilisez un autre logiciel qui communique avec hMailServer, vérifiez que ce logiciel estcompatible avec la version de hMailServer que vous mettez à niveau. Ce qui peut être le cas, parexemple, si vous utilisez une interface web tierce comme serveur.

Installer la nouvelle version

1.IMPORTANT: Sauvegardez votre base de données, votre dossier hMailServer et le fichierhMailServer.ini.2.Lisez la section Rétro-compatibilité plus bas. Si quelque chose n'est pas clair, il est conseilléd'installer hMailServer 5.2 d'abord sur un serveur test pour en connaître les nouvellesfonctionnalités.3.Téléchargez hMailServer 5.2 sur le site web de hMailServer.4.Lancez l'exécutable d'installation en double-cliquant dessus. Il n'est pas nécessaire d'arrêter oude désinstaller la version en cours avant d'installer la nouvelle version.5.Suivez le différentes boîtes de dialogue de l'installation et cliquez sur Installer dans la boîte dedialogue Prêt à installer.6.L'installateur effectue alors une copie des fichiers.7.Après la copie des fichiers, l'installateur lance automatiquement la mise à jour de la base dedonnées de hMailServer. Si vous voyez le texte "Création de la base de données hMailServer" dansl'assistant d'installation pendant plus de 15 secondes, et qu'aucune boîte de dialogue "Mise à jourde la base de données" n'apparaît, il est vraisemblable que cette dernière se trouve "derrière"l'assistant. Ainsi, si elle n'apparaît pas, essayez de déplacer la fenêtre de l'assistant d'installation.8.Cliquez sur Mettre à jour pour actualiser la base de données selon la structure la plus récente.9.Cliquez sur Quitter pour revenir à l'assistant d'installation10.Cliquez sur Terminer pour quitter l'installation et lancer hMailAdmin.

Qoui de neuf?

·Dans hMailServer Administrator, sous Utilitaires, un nouvel outil diagnostic de base estdésormais disponible. Cet outil vous aide à résoudre les problèmes configuration de base.·Si un client envoie un message depuis un domaine local, le serveur est alors considéré commelocal. La même chose s'applique si l'adresse correspond à un itinéraire. Le comportementprécédent impliquait que l'expéditeur était seulement considéré comme local si son adressecorrespondait à un compte local. Ce qui signifie que si vous envoyez un message à partir de l'aliasd'une adresse, vous êtes désormais considéré comme local. Notez qu'il n'est toujours pas possiblede s'authentifier en utilisant un alias.·Dans les options greylisting, vous pouvez désormais choisir contourner greylisting si SPF passe.·Une nouvelle règle d'action a été ajoutée; Créer une copie. Cette règle peut être utilisée pourdélivrer, par exemple, des exemplaires du même message à différents serveurs de destination.·Un nouveau critère de règle a été ajouté. Tentatives de Diffusion. Il peut être utilisé pourenvoyer, par exemple, des messages vers différents itinéraires, en fonction du nombre actuel destentatives de diffusion.·Si hMailServer essaie de diffuser le même message plusieurs fois, les règles générales serontdésormais exécutées à chaque fois.·Lorsque vous supprimez des domaines dans hMailServer, vous devez désormais confirmer cetteaction avant suppression.·La mise à jour de la base de données est désormais effectuée selon une transaction (ensupposant que la base de données concernée la prend en charge).·Dans l'assistant d'installation de la base de données, le journal de création dans l'avant-dernièrepage est désormais effacé lorsque la page est affichée. Auparavant, le journal pouvait contenir lesdonnées des précédentes tentatives de création, ce qui pouvait prêter à confusion.

Rétro-compatibilité

hMailServer 5.2 inclut de nombreux changements. Certains d'entre eux modifient le comportementde fonctionnalités existantes. Les fonctionnalités suivantes ont été réorganisées dans hMailServer5. Après le mise à niveau, revoyez cette configuration pour vérifier qu'elle correspond bien à vous

hMailServer - Guide de l'Utilisateur

31 / 214

attentes.

Configuration de l'authentification SMTP

Dans hMailServer 5.2, les paramètres relatifs à l'authentification SMTP pour les plages IP ont étéréorganisés. Après la mise à niveau pour la version 5.2, il est important de revoir les paramètresde 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 régénérés. Si votreclient de messagerie a relié les informations a un UID spécifique, ces informations peuvent êtreperdues. 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 êtreperdus au cours de passage à la version 5.2.

Mise à niveau: 5.2 vers 5.3

Généralités

Cette section décrit les étapes à suivre pour passer de hMailServer version 5.2 à hMailServerversion 5.3. Si vous suivez ces étapes, le temps d'arrêt du serveur ne durera que quelquesminutes. Avant la mise à niveau, vérifiez que vous possédez une sauvegarde du dossier completde hMailServer, de la base de données de hMailServer et du fichier hMailServer.ini, au cas oùquelque chose se passerait mal. Les étapes ci-dessous sont les mêmes, quel que soit le type deserveur de base de données utilisée par hMailServer. Lisez la totalité de cette rubrique avant depassez à la mise à niveau.

Avant l'installation

·Si vous utilisez la base de données interne MySQL, et que vous passez de la version 4.2 ouantérieure, vous devez installer la dernière version 4.4 avant de passer à la version 5. Si vous nele faites pas, la mise à jour de la base de données échouera.·Si vous utilisez un autre logiciel qui communique avec hMailServer, vérifiez que ce logiciel estcompatible avec la version de hMailServer que vous mettez à niveau. Ce qui peut être le cas, parexemple, si vous utilisez une interface web tierce comme serveur.

Installer la nouvelle version

1.IMPORTANT: Sauvegardez votre base de données, votre dossier hMailServer et le fichierhMailServer.ini.2.Lisez la section Rétro-compatibilité plus bas. Si quelque chose n'est pas clair, il est conseilléd'installer hMailServer 5.3 d'abord sur un serveur test pour en connaître les nouvellesfonctionnalités.3.Téléchargez hMailServer 5.3 sur le site web de hMailServer.4.Lancez l'exécutable d'installation en double-cliquant dessus. Il n'est pas nécessaire d'arrêter oude désinstaller la version en cours avant d'installer la nouvelle version.5.Suivez le différentes boîtes de dialogue de l'installation et cliquez sur Installer dans la boîte dedialogue Prêt à installer.6.L'installateur effectue alors une copie des fichiers.7.Après la copie des fichiers, l'installateur lance automatiquement la mise à jour de la base dedonnées de hMailServer. Si vous voyez le texte "Création de la base de données hMailServer" dansl'assistant d'installation pendant plus de 15 secondes, et qu'aucune boîte de dialogue "Mise à jourde la base de données" n'apparaît, il est vraisemblable que cette dernière se trouve "derrière"l'assistant. Ainsi, si elle n'apparaît pas, essayez de déplacer la fenêtre de l'assistant d'installation.8.Cliquez sur Mettre à jour pour actualiser la base de données selon la structure la plus récente.9.Cliquez sur Quitter pour revenir à l'assistant d'installation10.Cliquez sur Terminer pour quitter l'installation et lancer hMailAdmin.

Revenir à la version précédente

hMailServer - Guide de l'Utilisateur

32 / 214

Généralités

Il n'existe aucune fonctionnalité dans hMailServer pour effectuer un retour à la versionprécédente. Lorsque vous passez d'une version à la suivante, des changements concernent lastructure de la base de registre. L'ancienne version de hMailServer ne pourra pas exécuter unebase de données en utilisant la nouvelle structure de base de données, et inversement. Lepackage d'installation de hMailServer inclut des scripts de base de données qui effectuent lesmodifications de base de données, mais ils sont unidirectionnels, Les scripts peuvent mettre àniveau la base de données, mais pas la rétrograder. Il existe des méthodes manuelles pourrétrograder 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 précédente, laméthode possible consiste à désinstaller complètement hMailServer, d'installer l'ancienne versionpuis de restaurer la sauvegarde. Cette approche suppose, de toute évidence, que vous avezeffectué une sauvegarde de l'ancienne version. Un inconvénient potentiel à cette approche estque les messages que vous aurez reçus avec la nouvelle version seront perdus (sauf si vous lesavez déjà téléchargés via POP3).

Inverser manuellement les changements de la base de données

Les changements effectués à la base de données par les scripts de mise à niveau peuvent , danscertains cas, être inversés manuellement pour un utilisateur qui connaît la syntaxe SQL.L'utilisateur doit manuellement accéder aux scripts de mise à niveau en commençant par la fin etdéfinir leur action. Il doit créer de nouveaux scripts qui inversent les modifications de la base dedonnées. Dans de nombreux cas, cette approche n'est pas possible. Si, par exemple, unefonctionnalité, qui existait dans l'ancienne version, a été supprimée dans la nouvelle version, lesdonnées requises pour cette fonctionnalité peuvent avoir été perdues lors de la mise à niveau.

Alternatives

Si vous rencontrez un problème avec la version en cours de hMailServer, le mieux est d'essayer dele résoudre. Les utilisateurs pensent parfois qu'ils doivent revenir à la version antérieure s'ils sontconfrontés à un problème, alors que ce problème n'est pas, en fait, lié à hMailServer. Le problèmepeut être lié à certaines fonctions qui ont été modifiées dans hMailServer, ou il peut s'agir d'unbug, auquel cas il peut être corrigé s'il a été rapporté.

Configuration

Compte

Général

Adresse du compte

L'adresse de messagerie du compte. Un compte ne peut posséder qu'une seule adresse e-mail.Vous pouvez utiliser des alias pour rediriger le message de plusieurs adresses de messagerie versun seul compte.

Mot de passe du compte

Le mot de passe du compte. Les mots de passe sont cryptés et enregistrés dans la base dedonnées de hMailServer.

hMailServer - Guide de l'Utilisateur

33 / 214

Taille maximum (Mo)

L'espace disque maximum que peut utiliser le compte. Si la limite est atteinte, le compte ne pourraplus recevoir de messages. Dans hMailServer 3.0, la taille du compte est mesurée en Ko. A partir de hMailServer 4.0, elle est mesurée en Mo. Si un message est envoté à ce compte lorsque sonquota a été utilisé, hMailServer envoie une notification à l'expéditeur qui indique que le quota dudestinataire a été atteint. Le message sera alors abandonné. Lorsqu'un message est envoyé via Internet, les données binaires sont encodées (du fait deslimitations du protocole SMTP). Cet encodage augmente, la taille du message de 50% enmoyenne. Ce qui signifie que lors de la création du compte, si vous réglez le quota sur 10Mo etque vous envoyez une pièce jointe de 10Mo, le message sera vraisemblablement trop volumineuxpour le compte. Lors de la configuration de la taille de la boîte aux lettres, vous pouvez en tenircompte.

Niveau d'administration

Les réglages du niveau d'administration vous permettent de définir la partie du serveur à laquelleun utilisateur pourra accéder. Le paramètre est d'abord utilisé par PHPWebAdmin.·Utilisateur - L'utilisateur peut changer les paramètres qui s'appliquent à son propre compte. Ilpeut, par exemple, changer son mot de passe, son message d'absence du bureau et sesparamètres de transfert. Il ne peut pas augmenter la taille maximum de son propre compte, nimodifier les paramètres du dossier actif·Domaine - L'utilisateur peut modifier la configuration qui s'applique à son domaine et auxutilisateurs qui en font partie. L'utilisateur pour modifier tous les réglages des autres utilisateursde son domaine, ajouter de nouveaux utilisateurs, des alias et des listes de diffusion, supprimerdes éléments, augmenter la taille maximum du compte et ainsi de suite.·Serveur - L'utilisateur peut changer tout paramètre et modifier tout élément (tels que le domaineet les comptes) sur le serveur. 

Date et heure de la dernière ouverture de session

Indique la date et l'heure de la dernière ouverture de session du compte. Si un utilisateur n'ajamais ouvert de session sur le compte, la date et l'heure de création du compte seront affichées.

Activé

Cette option vous permet d'activer ou de désactiver le compte.

Réponse automatique

La Réponse Automatique est également connue sous le terme de Message de Vacation ouNotification d'Absence du Bureau. Une réponse automatique est envoyée automatiquementlorsque 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 Réponse Automatique à l'expéditeur.

Spécifier un message de Réponse Automatique

1.Accédez au compte dans hMailAdmin2.Sélectionnez l'onglet Réponse Automatique3.Choisissez Activer4.Entrez un sujet et saisissez un message5.Cliquez sur Enregistrer

Remarques

·Si vous laissez le champ Sujet vierge, le serveur réglera automatiquement le sujet sur Re: [sujet d'origine du courrier électronique de l'expéditeur]·Pour éviter un message en boucle, les messages de réponse automatique ne sont pas envoyés

hMailServer - Guide de l'Utilisateur

34 / 214

aux comptes dont la réponse automatique est activée. De même, hMailServer n'envoie qu'uneseule réponse automatique par expéditeur.·Nous vous conseillons de vous désinscrire des listes de diffusion avant d'activer le messaged'absence.·La macro %SUBJECT% peut êetre utilisée dans le Sujet et le Corps du message de réponseautomatique. Le texteThe text %SUBJECT% will be replaced with the subject of the original e-mailmessage. 

Expiration Automatique

En sélectionnant Expiration Automatique, vous pouvez configurer hMailServer pour désactiverautomatiquement la Réponse Automatique à une date donnée. Ce qui peut être souhaitable sivous savez que vous vous absentez pendant deux ou trois jours du bureau. A votre retour, vousn'aurez plus à penser que vous devez désactivez la réponse automatique manuellement.

Transférer

La fonctionnalité Transférer vous permet de transmettre un message depuis ce compte vers unautre. Sélectionnez Activer le transfert pour lancer le transfert des messages. Entrez l'adresse demessagerie vers laquelle vous souhaitez transférer les messages. Si vous souhaitez transférerdes messages sans en garder un exemplaire, désactivez Garder un original du message.

Signature

Si vous spécifiez une signature, elle sera ajoutée à tous vos messages sortants. Il est possible despécifier une signature en texte simple et une signature HTML. Si une signature en texte simple aété spécifiée, sans signature HTML, hMailServer utilisera la signature en texte simple commesignature 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 remplacées respectivement par le prénom et par le nom de l'utilisateur commespécifié dans les paramètres du compte.

Règles

Les règles du compte fonctionnent exactement comme les règles générales. La différence est qeles règles locales ne s'appliquent que pour les messages qui sont délivrés à un compte spécifique.Voir la documentation sur les règles générales pour en savoir plus.

Comptes Externes

A l'aide de la fonctionnalité Comptes Externes, vous pouvez configurer hMailServer pourtélécharger les messages à partir d'autres serveurs de messagerie, en utilisant le protocole POP3.Après le téléchargement des messages, les règles générales, l'examen viral, etc sont appliquésaux messages. Ils sont ensuite normalement diffusés à un ou plusieurs comptes locaux.

Scénario 1:

Votre installation de hMailServer héberge les e-mails de votre domaine. Vous souhaiteztélécharger les massages d'un autre serveur de messagerie et les placer dans des compteslocaux.

Etapes à suivre:

1.Accédez à la Configuration du Compte vers lequel vous souhaitez télécharger les messages2.Affichez l'onglet Comptes externes3.Cliquez sur Ajouter pour ajouter un nouveau compte.

hMailServer - Guide de l'Utilisateur

35 / 214

4.Entrez un nom pour le compte externe.5.Entrez les informations d'ouverture de session.6.Dé-sélectionnez "Distribuer aux destinataires dans les en-têtes MIME" (le cas échéant)7.Spécifiez la fréquence à laquelle vous souhaitez que hMailServer télécharge les messages, et ladurée de leur stockage sur le serveur POP3 distant.8.Enregistrez le compte

Après avoir suivi ces étapes, hMailServer téléchargera les messages et les placera dans lescomptes pour lesquels vous avez créé un compte externe.

Scénario 2:

Votre domaine est hébergé par votre FAI. Il a créé un compte de messagerie "catch all" pour vous.Dès que quelqu'un vous envoie un message vers un destinataire de votre domaine, il aboutit dansle compte "catch-all".

Etapes à suivre

1.Créez un domaine dans hMailServerLe nom du domaine devrait être votre nom de domaine public.2.Créez des comptes pour vos utilisateurs.3.Accédez aux paramètres de votre propre compte4.Affichez l'onglet Comptes Externes5.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.Sélectionnez "Distribuer aux destinataires dans les en-têtes MIME"9.Spécifiez la fréquence à laquelle vous souhaitez que hMailServer télécharge les messages, et ladurée de leur stockage sur le serveur POP3 distant..10.Enregistrez le compte

Après avoir suivi ces étapes, hMailServer téléchargera les messages et les distribuera auxdestinataires dans les en-têtes MIME des messages. Si hMailServer ne peut pas définir à qui lesmessages sont à distribuer (s'il n'existe aucun destinataire dans les en-têtes MIME), il les délivresur 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 WindowsNT/2000. Il y a plusieurs avantages à utiliser un lien vers un Active Directory. Par exemple, aucundes mots de passe de compte n'est enregistré dans la base de données de hMailServer.L'utilisateur doit, à la place, fournir son mot de passe de domaine Windows NT/2000 lors de sonouverture de session sur le serveur POP3.

Domaine Active Directory

Domaine Active Directory est le nom de domaine de Windows NT/2000, lorsque le compte duserveur 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 lecompte du serveur de messagerie est lié.

Avancé

hMailServer - Guide de l'Utilisateur

36 / 214

Informations personnelles

Utilisez ce réglage pour indiquer le nom complet de l'utilisateur hébergeant ce compte. hMailServern'utilise pas ces informations.

Autres actions

·Editer les dossiers - Cette option vous permet de créer et de supprimer les dossiiers IMAP liés àce compte.·Vider le compte - Cette option supprime tous les dossiers IMAP et leur contenu (messages) de cecompte.·Déverrouiller - Cette option supprime le verrouillage POP3 de ce dossier. Cette option ne devraitêtre utilisée que si le compte reste verrouillé même lorsque le client s'est déconnecté.

Avancé

Général

Domaine par défaut

Ce paramètre vous permet de spécifier le domaine hMailServer qui sera utilisé par défaut si unutilisateur ne spécifie pas le nom de domaine lors de son ouverture de session. Si vous spécifiez,par exemple, que le nom de domaine par défaut est example.com, et qu'une personne essaied'ouvrir une session avec pour nom d'utilisateur "bob", hMailServer supposera qu'il s'agit de"[email protected]" qui essaie d'ouvrir une session.

Mot de Passe d'Administration

Ce paramètre vous permet de changer le mot de passe administrateur de votre installationhMailServer. Ce mot de passe est requis pour ouvrir un session Administrateur sur hMailServer et ilest donc important de le mémoriser.

Alias

Généralités

Las alias sont utilisés pour Transférer un message d'une adresse de messagerie spécifique à uneautre. Imaginez-les comme des adresses sans boîte aux lettres; au lieu de posséder leur propreboîte aux lettres, ils enregistrent les messages reçus dans la boîte aux lettres d'un autre compte.Ce qui peut être utile si vous souhaitez surveiller plusieurs adresses de messagerie, mais quevous ne possédez qu'un seul compte de messagerie réel sur le serveur. Vous pourriez, parexemple, souhaiter recevoir les massages envoyés à [email protected],[email protected] et [email protected], mais vous souhaitez créer le seul [email protected] au lieu de trois comptes différents. Les comptes [email protected] [email protected] pourront alors être des alias du compte [email protected]

Ajouter un alias

1.Accédez au domaine dans hMailServer Administrator2.Sélectionnez le nœud Alias du domaine.3.Cliquez sur Ajouter...4.Entrez une adresse de messagerie dans Rediriger depuis. Il s'agit de l'alias d'une adressemessagerie, ex.: [email protected] de l'illustration ci-dessous. Les messages envoyés à cetteadresse seront transférés à l'adresse que vous avez spécifiée dans le champ À.5.Entrez l'adresse de messagerie principale dans le champ À.6.Cliquez sur Enregistrer

hMailServer - Guide de l'Utilisateur

37 / 214

Remarques

·Vous ne pouvez pas utiliser un alias d'adresse qui correspond à l'adresse de messagerie d'uncompte existant.·Il est impossible d'utiliser un alias pour Transférer un message à deux comptes différents. Utilisezplutôt une liste de diffusion.·Un alias peut Transmettre des messages à tout compte - même aux comptes de domaines qui nerésident pas sur lle même serveur.·Lors de l'ouverture d'une session sur le serveur, un alias ne peut pas être utilisé. Seule uneadresse de compte peut être utilisée pour ce faire.

Configuration

Rediriger depuis

Une adresse de messagerie alias à partir de laquelle les messages seront redirigés. L'adresse demessagerie ne peut être la même qu'une adresse de compte ou qu'une adresse de liste dediffusion.

À

L'adresse de messagerie vers laquelle l'alias doit rediriger. Il peut s'agir d'un compte, d'un autrealias, d'une liste de diffusion ou de l'adresse de messagerie d'un domaine externe.

 

Antispam

Généralités

hMailServer dispose d'un certain nombre de méthodes protections anti-spam intégrées. Celles-cifonctionnent en vérifiant l'expéditeur des messages, le contenu des message et la façon dont ilssont envoyés à hMailServer. Si un message contient, par exemple, des liens qui pointent sur despages web de spammer, ou s'il est envoyé à partir d'une adresse connue pour envoyer desspams, il peut être classifié comme spam. La liste complète des méthodes de protections intégréescontre les spams peut être consultée ici.

Score de Spam

Chacun des tests effectués par hMailServer génère une Score de Spam. Si le test spécifique duspam 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 exécutés, hMailServer compares lescore total de spam du message à deux seuils différents mis en place dans hMailServer.

Le premier seuil est le seuil de Marquage. Si le score total du message atteint le seuil deMarquage de spam, le sujet du message est modifié pour indiquer que le message contient unspam. En utilisant le marquage des messages, l'utilisateur peut facilement détecter et supprimerles messages spam, ou en tant qu'administrateur du serveur, vous pouvez définir des règles pourdéplacer les messages spam dans un dossier IMAP spécifique, ou les transférer dans un dossierspécifique.

Le second seuil de spam est le seuil de Suppression. Si le message atteint ce seuil, le messageest supprimé.

Quand la protection anti-spam est-elle exécutée?

hMailServer essaie de déterminer si le message est un spam aussi dès que possible lors de la

hMailServer - Guide de l'Utilisateur

38 / 214

communication avec l'expéditeur du message. Plus tôt la détection est effectuée, moins lesressources de votre serveur seront requises pour manipuler le message. Un autre avantage d'undétection rapide est que hMailServer peut plus facilement dire à l'expéditeur que son message estrejeté par la protection anti-spam et donc lui notifier.

Si un e-mail est délivré à hMailServer via SMTP, hMailServer effectue la protection selon les étapessuivantes:

·Après la commande RCPT TO. Après que le destinataire du message a été indiqué, hMailServerexécute la protection anti-spam.·Après la commande DATA. Lorsque la totalité du message a été transmise à hMailServer, celui-ciexécute la protection anti-spam sur le contenu du message.

Si hMailServer télécharge les messages à partir d'un compte externe, la protection anti-spam estexécutée avant l'enregistrement dans le dossier du compte.

Quels messages sont examinés?

hMailServer examine tous les messages qui sont délivrés aux comptes utilisateur, en supposantque les éléments suivants soient réunis:

·Le message est délivré à hMailServer via SMTP, ou téléchargé à partir d'un compte externeutilisant POP3.·Au moins une méthode de protection anti-spam est activée dans la Configuration Anti-spam.·L'adresse IP ou le domaine de l'expéditeur n'est pas dans la liste blanche en utilisant une listedossier blanc·L'adresse IP de l'expéditeur correspond à une plage IP pour laquelle l'Anti-spam est activé.

Configuration

Seuil de marquage d'un spam

Lorsque hMailServer exécute la protection anti-spam, chaque mécanisme de protection anti-spamattribue un score. Si le score total du message dépasse cette valeur - mais reste inférieur au Seuilde Suppression du Spam, le message sera marqué comme spam.

·Ajouter X-hMailServer-Spam - Ajoute un en-tête MIME X-hMailServer-Spam au message.·Ajouter X-hMailServer-Reason - Cette option activée, hMailServer ajoutera un en-tête demessage qui contient le motif pour lequel il a considéré le message comme un spam.·Ajouter au sujet du message - Avec cette option, vous pouvez spécifier le texte qui devraprécéder le sujet du message. En association avec les règles, les messages de spam peuvent êtredéplacés dans des dossiers IMAP spécifiques.

Seuil de suppression d'un spam

Lorsque hMailServer exécute la protection anti-spam, chaque mécanisme de protection anti-spamattribue un score. Si le score total du message dépasse cette valeur, le message sera supprimé etne sera pas distribué aux destinataires.

Taille maximum du message à examiner (Ko)

Si la taille d'un message dépasse cette valeur, hMailServer ne l'examinera pas pour la détectionanti-spam. Généralement, les spammers envoient des petits messages pour économiser la bandepassante, et l'examen de messages volumineux ne sert à rien dans la plupart des cas. L'examende messages volumineux à la recherche d'un spam peut nécessiter beaucoup de ressources CPU.

Teste anti-spam

hMailServer - Guide de l'Utilisateur

39 / 214

Utiliser SPF

Sélectionnez pour activer le protection anti-spam via SPF.

Vérifier l'hôte dans la commande HELO

Activez cette option si vous souhaitez que hMailServer vérifie le nom de l'hôte que le client aspécifié dans la commande HELO. En fonction de la spécification SMTP, l'hôte indiqué dans lacommande HELO doit correspondre à l'adresse IP du client. Activer cette option peut arrêter lespam, mais est aussi une violation du RFC SMTP - si vous avez configuré votre serveur poursupprimer les spams. Si vous avez configuré votre serveur pour délivrer les spams en modifiantl'en-tête Sujet, il n'y aura pas violation du RFC SMTP. Techniquement, hMailServer vérifiel'enregistrement A de l'hôte donné pour voir s'il correspond à l'adresse IP du client se connectant.

Vérifier que l'expéditeur a les enregistrements MX DNS

Si vous activez cette option, hMailServer vérifiera que le domaine de l'expéditeur a desenregistrements MX valides dans les DNS. Sinon, le score de spam de ce test sera ajouté au scorede spam total pour le message. Notez qu'il n'est pas nécessaire que les domaines aient desenregistrements MX. Il est parfaitement valable pour un domaine de ne pas posséder lesenregistrements MX et d"envoyer tout de même des messages. Bien que la plupart despropriétaires de domaine définissent les enregistrements MX, loin s'en faut. Ce qi signifie que vousdevez vous attendre à de nombreux faux positifs en utilisant ce test anti-spam.

Vérifier l'en-tête de signature DKIM

Si vous activez cette option, hMailServer recherchera un en-tête de signature DKIM dans chaquemessage entrant. Si un tel en-tête est détecté, hMailServer vérifiera que le contenu du messagecorrespond à la signature. Sinon, le score de spam de ce test sera ajouté au score total de spampour ce message.

SpamAssassin

Utilisez cette option si vous souhaitez que hMailServer s'intègre à une installation SpamAssassinexistante.

Nom d'hôte

Il s'agit du nom d'hôte du serveur SpamAssassin auquel hMailServer doit se connecter. SiSpamAssasin est exécuté sur le même ordinateur que hMailServer, la valeur doit être"localhost" (sans les guillemets).

Port TCP/IP

Spécifiez le port TCP/IP que le serveur SpamAssassin surveille. Par défaut, SpamAssassin surveillele port 783.

Utiliser le score de SpamAssassin

Si cette option est activée, hMailServer utilisera le score de spam fourni par SpamAssassin etl'ajoutera au score de spam de hMailServer. Sinon, hMailServer utilisera le score spécifié dans lechamp Score.

Test

Cliquez sur ce bouton si vous souhaitez que hMailServer teste la connexion à SpamAssassin.Après ce test, le résultat sera affiché.

Informations connexes

hMailServer - Guide de l'Utilisateur

40 / 214

Plages IP

Il est possible de désactiver la fonctionnalité de protection anti-spam de hMailServer par plage IP.Par exemple, il n'est normalement pas nécessaire de contrôler l'existence de spams sur un réseaulocal. 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 désactiver la protection anti-spam des messages envoyés à partir d'une adresse de messagerie ou IP spécifique. Il s'agit d'unesolution plus flexible que d'utiliser les plages IP.

Avancé

Tarpitting

Le Tarpitting (répulsion) est une technique anti-spam qui fonctionne en ralentissant lacommunication avec les spammers.

Autres méthodes

·Référence liste noire DNS·Référence SURBL·Référence liste grise

Rubrique connexe

·Liste blanche

 

Antivirus

Généralités

hMailServer dispose d'une prise en charge intégrée pour l'antivirus open source, ClamWin. Pourutiliser un autre antivirus, utilisez la fonctionnalité Antivirus Externe. Elle vous permet d'exécutertout antivirus qui prend en charge l'examen en ligne de commande. Dans le champ ExécutableAntivirus, spécifiez la ligne de commande à utiliser lors de l'examen. Dans lee champ Retourner laValeur, spécifiez la valeur que l'antivirus retournera lors de la détection d'un virus. Cette valeurvarie en fonction de l'antivirus. Voyez la fin de cette page pour la liste des antivirus et leurs lignesde commande. Si vous utilisez la macro %FILE% dans la ligne de commande, hMailServerremplacera %FILE% par le chemin complet du fichier à examiner.

Configurer hMailServer pour utiliser un antivirus externe

Cet exemple indique comment régler hMailServer pour qu'il utilise AVG Free 7. Il suppose que vousavez installé AVG Free sur C:\Program Files\Grisoft\AVG Free

1.Lancez hMailServer Administrator2.Accédez à Configuration -> Protocoles -> SMTP -> AntiVirus3.Accédez à la page Antivirus externe.4.Sélectionnez Utiliser un antivirus externe5.Spécifiez la ligne de commande suivante. Les guillemets (") sont à inclure:"C:\Program Files\Grisoft\AVG Free\avgscan.exe" /EXT=* /NOBOOT /NOMEM /SCAN /NOSELF /

hMailServer - Guide de l'Utilisateur

41 / 214

NOHIMEM /ARC "%FILE%"

6.Entrez 6 comme valeur de retour. (Avgscan.exe retournera la valeur 6 si un virus est détecté).

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 considéré comme un virus par les antivirus, mais il est sans risque car il n'est pas un vraivirus. Ces sites vous permettent d'envoyer un message contenant le fichier de test antivirusEICAR:

·Alpha-tec.·Webmail.us.

En savoir plus

·Comment déterminner la valeur de retour d'un antivirus

Remarque

·La fonctionnalité de la macro %FILE% ne s'applique qu'à hMailServer 4.0 build 85 et supérieur.

Configuration

Lorsqu'un virus est détecté

Choisissez Supprimer le message si vous souhaitez supprimer immédiatement le messagecontenant un virus. Choisissez Supprimer les pièces jointes si vous souhaitez que le messagecontenant un virus vous soit délivré, mais que les pièces jointes soient supprimées. Lors de lasuppression du message, vous pouvez choisir d'informer l'expéditeur du message qu'un virus aété détecté 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 ceparamètre, vous pouvez configurer hMailServer pour ignorer l'examen viral si un message et detaille supérieure à la taille spécifiée. 

ClamWin

Détection Auto

hMailServer peut être automatiquement configuré pour utiliser ClamWin. Pour ce faire, cliquez sur Détection auto. hMailServer lira les paramètres de ClamWin à partir de la base de registre deWindows. Après a détection automatique des paramètres, vérifiez qu'ils sont corrects.

Notez que ClamWin doit d'abord être installé pour ce faire.

Antivirus Externes

Exécutable de l'antivirus

hMailServer - Guide de l'Utilisateur

42 / 214

Le chemin de l'exécutable de l'antivirus qui doit être exécuté. Ce qui devrait être un examen enligne de commande sans interface utilisateur.

Valeur de retour

La valeur que doit retourner l'antivirus si un virus est détecté.

Bloquer les pièces jointes

Ce paramètre vous permet de bloquer les pièces jointes en fonction de leur extension. Si vousactivez cette option, hMailServer supprimera la pièce jointe et ajoutera une nouvelle pièce jointeavec pour nom <nom d'origine>.txt qui contient un bref message indiquant que la pièce jointe aété supprimée.

 

Interdiction automatique

Auto-ban

Généralités

C'est un problème fréquent que les gens utilisent des mots de passe faibles que les spammeursparviennent à comprendre à l'aide de dictionnaires. En utilisant la fonctionnalité interdictionautomatique, hMailServer peut déconnecter automatiquement ces spammeurs et réduire le risqueque votre serveur soit utilisé pour diffuser des spams.

Si le Nombre maximum de tentatives de connexions non valides est effectué à partir d'une adresseIP spécifique dans le nombre de Minutes avant réinitialisation, la connexion des clients de cetteadresse 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 créée. Dans cette plage IP, tous les protocoles sont désactivés, ce qui a poureffet d'empêcher l'utilisateur de se connecter. La nouvelle plage IP aura une date d'expiration, cequi signifie qu'elle sera supprimée 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 créée. Cette plageIP portera 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 chaîne aléatoire de 9 caractères.

Dans hMailServer, vous ne pouvez pas avoir plusieurs plages IP du même nom. C'est la raisonpour laquelle la chaîne aléatoire est incluse.

Problèmes potentiels

La fonctionnalité Interdiction Automatique bloque les adresses IP. Si trop de tentativesd'ouvertures de session non valides sont effectuées à partir de la même adresse IP, celle-ci serabannie. Si vous utilisez un système webmail, toutes les connexions à hMailServer à partir de cesystème webmail proviendront de la même adresse IP. Si trop de tentatives d'ouverture desession sont effectuées depuis ce système webmail, l'adresse IP à laquelle celui-ci se connectesera bloquée.

hMailServer - Guide de l'Utilisateur

43 / 214

Pour résoudre ce problème, vous pouvez insérer le système webmail dans la liste blanche. Uncontournement du problème consiste à ajouter une nouvelle plage IP correspondant à l'adresse IPpartagée et à attribuer à cette plage IP une priorité plus élevée que toute plage IP ajoutée par lafonctionnalité Interdiction Automatique. Les plages IP ajoutées par l'Interdiction Automatique sevoient attribuer la priorité 20, et si votre propre plage IP a pour priorité la valeur 25, elle aura lapriorité.

Configuration

Si le Nombre maximum de tentatives de connexions non valides est créé à partir d'une adresse IPspécifique dans les Minutes avant réinitialisation, La connexion des clients de l'adresse IP seraInterdite Automatiquement pendant les minutes d'interdiction automatique.

Sauvegarde

Généralités

Les sauvegardes hMailServer sont effectuées par le service hMailServers. Lorsque vous décidez delancer une sauvegarde dans hMailServer Administrator, celui-ci se connecte au service hMailServervia l'API COM, et demande au service hMailServer de lancer une sauvegarde. De ce fait, le servicehMailServer doit être en activité lorsqu'une sauvegarde va s'effectuer.

La fonctionnalité de sauvegarde intégrée est conçue pour des petites installations. Si vous avezplus de 50 comptes ou 10.000 messages sur le serveur, nous vous recommandons vivementd'utiliser un outil externe pour effectuer une telle sauvegarde.

Un fichier de sauvegarde créé par une version spécifique ne peut pas être restauré pour uneversion différente. Vous ne pouvez pas restaurer, par exemple, une sauvegarde créée sous laversion 4.2 dans une version 4.3.

Sauvegarder sur des lecteurs réseau

Pour réussir une sauvegarde, le service hMailServer doit avoir la permission d'écrire vers le cheminque vous avez spécifié comme destination de sauvegarde.

Si la destination de la sauvegarde est un lecteur réseau, vous devez vérifier que le servicehMailServer à les permissions d'écriture sur le lecteur. Normalement, vous aurez à modifier lecompte d'ouverture de session pour le service hMailServer avant de sauvegarder sur un lecteurréseau. Vous y parviendrez dans les paramètres du service dans le Panneau de Configuration deWindows

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'exécution d'un serveur, et quehMailServer 4.2 est la première version à inclure une prise en charge de sauvegarde intégrée,vous devez considérer que la fonction de sauvegarde de hMailServer comme expérimentale. Nevous fiez pas à elle pour sauvegarder des données professionnelles critiques.

La fonctionnalité de sauvegarde intégrée est conçue pour les petites installations. Si vous avezplus de 50 comptes ou 10.000 messages sur le serveur, nous vous recommandons vivementd'utiliser des outils externes pour ce faire.

hMailServer - Guide de l'Utilisateur

44 / 214

Destination

Le chemin où sera enregistrée la sauvegarde.

Paramètres

Si cette option est sélectionnée, hMailServer enregistrera ses propres paramètres. L'optioncomprend les règles générales, les réglages SMTP, POP3, IMAP, le cache, les hébergementsmultiples et autres options de Configuration dans hMailServer Administrator.

Domaines

Cette option inclut tous les domaines hMailServer et les éléments liés aux domaines. Ce quisignifie que si vous choisissez de sauvegarder les domaines, les comptes, les comptes externes,les règles de niveau de compte, les alias, les listes de diffusion et autres éléments appartenant audomaine seront sauvegardés. Les options ne comprennent pas les dossiers IMAP liés auxcomptes.

Messages

Si vous avez choisi de sauvegarder les domaines, vous pouvez aussi choisir de sauvegarder lesmessages. Si vous choisissez cette option, hMailServer sauvegardera les dossiers IMAP et lesmessages qu'ils contiennent. Les messages en file d'attente envoyés à hMailServer ne seront passauvegardés.

Liste de diffusion

Généralités

Adresse

L'adresse de la liste de diffusion. Les messages envoyés à cette adresse seront transférés à tousles 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 spécifique seront autorisés.

Authentification SMTP Requise

Si cette option est activée, hMailServer nécessitera une authentification SMTP pour les diffusionsde la liste. Si vous activez cette option, seuls les utilisateurs ayant des comptes sur le serveurpourront 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 sélectionnées de la liste de diffusion.

hMailServer - Guide de l'Utilisateur

45 / 214

Liste noire DNS

General

Hôte DNS

L'hôte DNS que hMailServer devrait interroger lorsque vous faites une recherche dans la liste noireDNS.

Résultat attendu

L'adresse IP que le serveur de liste noire DNS retournera si l'adresse IP des expéditeurs estdétectée dans la liste noire DNS. Il est possible d'utiliser des jokers dans l'adresse IP. Il n'est paspossible de spécifier plusieurs adresses différentes 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 expéditeur si un message est rejeté

Domaine

Généralités

Chaque compte de messagerie de hMailServer doit appartenir à un domaine. Le domaine spécifiédans hMailServer peut être un domaine de réseau local ou un domaine internet général commehMailServer.com.

Général

Nom de domaine

Le nom du domaine. Pour être considéré comme valide, un nom de domaine doit comprendre unpoint. Vous devez définir vos serveurs DNS afin que les messages puissent être envoyés à votreserveur de messagerie.

Noms

Un domaine peut avoir plusieurs noms. Ils sont également connus sous le terme d'alias dedomaine. Votre société, par exemple, peut posséder le nom de domaine company.com, mais ellepeut aussi posséder 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 problème, 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.decomme des alias de company.com. C'est l'itinéraire préféré des utilsiateurs.

Si vous définissez un domaine nommé example.com, et un alias nommeé example.net, votreserveur acceptera les messages de [email protected] et [email protected]. Vosutilisateurs pourront aussi ouvrir une session sur [email protected] [email protected].

Créer un alias de nom de domaine

hMailServer - Guide de l'Utilisateur

46 / 214

1.Lancez hMailServer Administrator.2.Déployez le nœud Domaines et sélectionnez le domaine (ex.: mydomain.com).3.Sélectionnez 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 même alias de nom de domaine à plusieurs domaines.

Signature

Dans l'onglet Signature, vous pouvez configurer hMailServer pour qu'il ajoute une signature à tousles e-mails envoyés à partir de ce domaine. Il est possible d'entrer une version Texte Clair et uneversion HTML de la signature. Si aucune signature HTML n'est spéifiée, hMailServer utilisera lasignature texte simple comme signature HTML.·Ajouter une signatures aux réponsesSi cette option est activée, hMailServer ajoutera la signature aux réponses. Pour savoir si unmessage est une réponse, hMailServer recherche En réponse À et l'En-tête des Références dumessage. Cette option est désactivée par défaut.·Ajouter une signature au message localSi vous choisissez cette option, hMailServer ajoutera une signature au message local. Un messageest considéré comme local si l'expéditeur et le destinataire existent dans le même domaine. Unmessage envoyé d'un domaine à un autre n'est pas considéré comme un message local, carl'expéditeur et le destinataire peuvent ne pas savoir qu'ils sont hébergés sur le même serveur.·Activer la signature du domaineSi vous activez cette option, la signature spécifiée sera ajoutée au message.

o Utilisez la signature si aucun n'a été spécifiée dans le compte des expéditeurs.Cette option sélectionnée, hMailServer n'utilisera que la signature du domaine si unesignature de compte n'a pas été spécifiée. 

o Remplacer la signature du compteCette option sélectionnée, hMailServer n'utilisera pas les signatures de compte pour cedomaine. Au lieu de cela, la signature de domaine sera utilisée pour tous les messages. 

o Ajouter la signature du compteCette option sélectionnée, hMailServer ajoutera la signature de compte avec la signature dedomaine. Ce qui peut être utilisé, par exemple, si vous souhaitez ajouter desavertissements à tous les messages sortants.

·Signature texte simple / signature HTMLCes deux champs spécifient la signature à utiliser

Vous pouvez utiliser les macros %User.FirstName% et %User.LastName% dans les signatures.Ces macros seront remplacées par le prénom et le nom de l'utilisateur comme indiqué dans laConfiguration de Compte.

Limites

Taille maximum (Mo)

Si cette valeur a été spécifiée (différente de 0), l'administrateur du serveur et le propriétaire dudomaine ne pourront pas ajouter de comptes si la taille totale de tous les comptes dépasse cettevaleur. Si vous abez spécifié 500 Mo, la taille totale de tous les messages du domaine n'excéderapas 500 Mo.

Taille maximum d'un message

Si cette valeur a été spécifiée, hMailServer refusera les messages plus volumineux que cette taille.

Taille maximum des comptes (Mo)

hMailServer - Guide de l'Utilisateur

47 / 214

Si cette valeur a été spécifiée (différente de 0), l'administrateur du serveur et le propriétaire dudomaine ne pourront pas ajouter de comptes dont la taille totale dépasse cette valeur.

Numbre de comptes, d'alias et de listes de diffusion

En utilisant ces réglages, vous pouvez limiter le nombre de comptes, d'alias et de listes dediffusion que les administrateurs du serveur et les propriétaires du domaine peuvent créer dansce domaine.

Signer DKIM 

Le DKIM, Domain Keys Identified Mail, est une méthode pour signer le contenu des messages. Ledestinataire peut vériifier que le message est envoyé d'un serveur authentifié pour envoyer àpartir du domaine de l'expéditeur, et que le contenu du message n'a pas été modifié lors dutransit.

Avant que hMailServer distribue un message à un autre serveur, il examinera l'adresse del'expéditeur du message. Si l'adresse de l'expéditeur correspond à un domaine local, l'option designature DKIM de ce domaine sera utilisée. Si la signature DKIM a été activée, le message serasigné.

Que ce soit ou non l'expéditeur d'origine qui a utilisé l'authentification SMTP lors de la remise dumessage à hMailServer n'a aucun effet sur le processus de signature DKIM.

hMailServer appose seulement la signature DKIM sur les messages distribués aux autres serveurs.Si l'utilisateur d'une autre installation hMailServer envoie un message à un autre utilisateur dumême serveur, le message ne sera pas signé.

Fichier clé privée

La clé privée à utiliser lors de la signature d'un messages avec DKIM. Il doit s'agir d'un fichierexistant sur le système de fichiers local, lisible par hMailServer, et qui ne doit pas contenir un jeude mots de passe.

Sélecteur

Il s'agit du sélecteur DKIM à utiliser à utiliser pour la signature. Pour pouvoir utiliser DKIM, vousdevez spécifier un sélecteur. Celui-ci doit être le même que le sélecteur que vous utilisez pourl'enregistrement DKIM sur votre serveur DNS. Si, par exemple, votre enregistrement DNS estnommé myselector._domainkey.example.net, vous devez entrer "myselector" comme sélecteur(sans les guillemets).

Méthode d'en-tête

Choisissez entre la méthode de canonisation simple et modérée. Si vous choisissez la méthode decanonisation simple, les en-têtes signées du message ne doivent pas être du tout modifiés. Si unenouvelle ligne est ajoutée dans un en-tête, la vérification échouera. Choisissez la méthodemodérée si vous souhaitez permettre des modifications mineures de l'en-tête.

Méthode de corps

Choisissez entre la méthode de canonisation simple et modérée. Si vous choisissez la méthode decanonisation simple, le corps du message ne doit pas être du tout modifiés. Si une nouvelle ligneest ajoutée au corps, la vérification échouera. Choisissez la méthode modérée si vous souhaitezpermettre des modifications mineures du corps du message.

Méthode de signature

Choisissez entre les algorithmes SHA1 et SHA256. SHA256 est conseillé car il offre une sécuritéplus élevée que SHA1. Les expéditeurs de messages de faible sécurité comme les newsletterssouhaitent plutôt utiliser SHA1 car il nécessite moins de ressources CPU.

hMailServer - Guide de l'Utilisateur

48 / 214

Avancé

Cet onglet contient les paramètres avancés pour le domaine. Normalement, il n'est pas nécessairede modifier ces réglages.

Adresse Catch-all (Attrape-tout)

Il est possible de spécifier une adresse de messagerie qui reçoive tous les messages envoyés àdes adresses qui n'existent pas dans votre domaine. Vous pourriez avoir, par exemple, [email protected], [email protected] et [email protected] comme comptes existants.Mais il y a le risque que quelqu'un puisse mal orthographier une adresse -mail, et écrire [email protected] au lieu de [email protected].

La solution consiste à spécifier un compte - soit un compte existant, ou un compte créé pour lacirconstance - comme compte Catch-all. Tous les messages envoyés vers une adresse qui n'existepas sur le domaine seront envoyés au compte catch-all.

Exemple

1.Lancez hMailAdmin2.Déployez le nœud Domaines et sélectionnez le domaine, disons, mydomain.com3.Créez un nouveau compte avec pour nom [email protected]électionnez votre domaine et entrez [email protected] comme adresse catch-all5.Enregistrez les modifications

Remarques

·L'adresse catch-all peut être toute adresse de messagerie de votre choix. Elle n'a pas à êtrestrictement du format [email protected]·L'adresse catch-all n'a pas à appartenir à un compte de votre domaine, ou même à hMailServer.Vous pouvez transférer les messages vers des serveurs externes.·Si vous voulez que hMailServer rejette des messages envoyés vers des adresses inexistantes devotre domaine, ne spécifiez aucune adresse catch-all.

Plus d'adressage

Utilisez cette option pour activer plus d'adressage pour ce domaine. Pour éviter la confusion et lesproblèmes de configuration, seul un jeu limité de caractères est autorisé pour plus d'adressage.

Liste grise

Utilise cette option pour activer et désactiver la liste grise pour ce domaine.

 

Comptes externes

Généralités

hMailServer peut télécharger les messages de comptes POP3 sur d'autres serveurs. Lestéléchargements des messages sont distribués à un compte spécifique, mais il est possible de lesrediriger vers un compte externe à l'aide de règles. Les comptes externes sont définis selon lesparamètres Compte de l'onglet Comptes externes.

hMailServer - Guide de l'Utilisateur

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, seraajoutée ultérieurement.

Adresse du serveur & port TCP

Le nom d'hôte et le port TCP/IP du serveur hMailServer auquel s'effectue la connexion lors dutéléchargement 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 sessionsur le serveur externe. Ils doivent être identiques aux informations d'ouverture de session quevous entrez dans votre client de messagerie lorsque vous vous connectez à ce compte.

Configuration

Minutes entre les téléchargements: Définit la fréquence à laquelle hMailServer doit téléchargerles messages à partir du serveur externe. La valeur par défaut est 30 minutes. Il est conseillé dene pas réduire cette valeur. Si vous sélectionnez Supprimer les messages immédiatement, hMailServer supprimera lesmessages du serveur externe immédiatement après leur téléchargement. Inversement, Ne passupprimer les messages, indiquera à hMailServer de ne pas effacer les messages du serveurexterne. Si vous choisissez Supprimer les messages après [x] jours, hMailServer effaceraautomatiquement les messages du serveur POP3 lorsqu'ils sont plus âgés que [x] jours. Distribuer aux bénéficiaires d'en-têtes MIME: Vous permet gérer à qui hMailServer doit délivrerles messages téléchargés. Par défaut, hMailServer télécharge les messages et les place dans lecompte où vous avez créé le compte externe. Si vous avez ajouté, par exemple, le compte externeà un compte nommé [email protected], tous les téléchargements seront placés dans laboîte de réception [email protected]. Cependant, si vous sélectionnez cette option,hMailServer les distribuera plutôt aux bénéficiaires d'en-têtes MIME. Si le champ À contient, parexemple, [email protected], hMailServer vérifiera s'il existe un compte nommé[email protected]. Dans ce cas, il distribuera les messages à ce compte.

Dans certains cas, tous les destinataires peuvent ne pas exister dans les en-têtes MIME. Si, parexemple, vous envoyer un message à un destinataire de la liste BCC, ce destinataire ne sera pasdisponible dans les en-têtes MIME, et hMailServer ne saura pas que le message doit lui êtredistribué Retrouver la date de l'en-tête Reçu: Vous permet de configurer hMailServer pour qu'il utilise ladate du dernier en-tête Reçu, au lieu d'utiliser la date en cours. Lorsque hMailServer a téléchargéun e-mail depuis un serveur externe, il règle normalement la date interne du message sur la dateet l'heure en cours. Si par la suite vous téléchargez le message à partir de hMailServer via IMAP, ladate interne peut apparaître comme date de "Réception" dans votre client de messagerie. Si vousavez sélectionné cette option, hMailServer essaiera de déterminer la date de réception du serveurPOP3 externe, et réglera la date interne à l'identique. Si ceci échoue, hMailServer utilisera la dateen cours.

En d'autres termes: Si vous souhaitez que la colonne Reçu de votre client de messagerie affiche ladate à laquelle hMailServer a téléchargé le message, ne sélectionnez pas cette option. Si voussouhaitez que la colonne affiche la date à laquelle le serveur POP3 externe a reçu le message,activez cette option. Anti-spam & Antivirus Sélectionnez cette option si vous souhaitez que hMailServer examine les messages téléchargéspour y détecter les spam et virus. Si vous savez que le serveur hébergeant le compte externe

hMailServer - Guide de l'Utilisateur

50 / 214

exécute déjà un logiciel anti-spam et antivirus, vous pouvez désactiver ces options pour lecompte externe afin d'améliorer la performance. 

Remarques

·Vous devez activer SMTP dans hMailServer pour que les fonctionnalités des comptes externesfonctionnent.·hMailServer 4.0 et 4.1 téléchargeront les messages des comptes externes, même si le compte/domaine parent est désactivé. Cependant,, si les messages sont supprimés du serveur distant, etque le compte/domaine local a été désactive, ils seront perdus. Pour éviter ceci à l'avenir, à partirde la version 4.2, hMailServer ne télécharge plus les messages des comptes externes si le compteou le domaine parent est désactivé.·Lorsque lee réglage permet de distribuer les messages aux bénéficiaires des en-têtes MIME,hMailServer vérifie les en-têtes suivants:

o Ao CCo X-RCPT-TOo X-Envelope-Too Reçu (multiple)

·Si vous avez choisi de distribuer les messages aux bénéficiaires des en-têtes MIME, et qu'aucundestinataire n'a été trouvé, hMailServer placera les messages dans le compte au sein duquel lecompte externe été créé.

Problèmes courants

Les destinataires ne sont pas dans les en-têtes MIME

Lors de la distribution des messages aux destinataires des en-têtes MIME, il y a le risque qu'ils nesoient pas distribués aux bons destinataires ou que certains reçoivent des messages en double. Ilest possible, par exemple, d'envoyer un message à une adresse mais pas d'en placer une autredans les en-têtes MIME. Si hMailServer lit les destinataires à partir des en-têtes MIME, le messagene sera pas distribué au bon destinataire (le destinataire de l'en-tête). Il est également possiblede placer les destinataires d'un message dans l'en-tête BCC (qui n'est pas inclus au message).hMailServer ne distribuera pas les messages aux destinataires qui ne sont pas énumérés dans lesen-têtes A, CC, X-RCPT-TO, X-Envelope-To ou Reçu.

Des messages en double ont été distribués

Si plusieurs exemplaires d'un même message sont enregistrés dans le compte externe,hMailServer distribuera plusieurs copies de ces messages. certains serveurs SMTP peuventdistribuer plusieurs exemplaires d'un même message à un même compte, si un compte catch-allest utilisé et que le message est envoyé à plusieurs personnes d'un même serveur. Le seulcontournement de ce problème consiste à reconfigurer le serveur SMTP pour qu'il n'enregistre pasplusieurs exemplaires d'un même message. Notez que ce n'est pas hMailServer qui doit êtrereconfiguré, mais le serveur SMTP qui distribue les messages au compte POP3 à partir duquelhMailServer effectue le téléchargement.

Liste grise

Général

La liste grise vous permet de vous protéger d'un spam en rejetant temporairement le message devotre serveur. La liste grise tire avantage du fait que les serveurs de messagerie correctementconfigurés essaieront de redistribuer les messages ultérieurement, alors que les spammeurs, enprincipe, abandonneront immédiatement si votre serveur rejette un e-mail.

Lorsqu'un expéditeur essaie de diffuser un message pour la première fois à votre serveur,hMailServer enregistre l'adresse IP de l'expéditeur, l'adresse de messagerie de l'expéditeur etl'adresse de messagerie du destinataire. Ces informations sont appelées un triplet. hMailServerrejettera le message et demandera au serveur d'envoi de bien vouloir réessayer ultérieurement.La prochaine fois que le serveur d'envoi essaie de distribuer un message qui correspond au

hMailServer - Guide de l'Utilisateur

51 / 214

triplet, hMailServer accepte celui-ci.

Les messages de spam qui sont arrêtés par le liste grise ne sont pas comptés dans la page Étatde hMailServer Administrator. Ainsi, même si vous configurez hMailServer pour distribuer desmessages de spam sans modifier l'en-tête, les messages rejetés par le liste grise ne seront pasdistribués du fait du mécanisme de fonctionnement de la liste grise.

Minutes d'attente pour accepter un message

Spécifiez 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'expéditeur ne refait pas l'essai deredistribuer le message, hMailServer supprimera le triplet après le nombre de jours spécifié.

Jours d'attente avant la suppression du triplet utilisé

Avec ce réglage, vous pouvez spécifier la durée de vie du triplets dans hMailServer avant d'êtresupprimé. Le nombre de jours est compté à partir de la date de dernière utilisation du triplet. Si untriplet a été créé, par exemple, le jour 1, qu'il est réutilisé le jour 5, et que ce paramètre est réglésur 10, le triplet sera supprimé 15 jours après sa création.

Contourner la liste grise sur Passe SPF

L'inconvénient avec la liste grise est qu'elle entraîne un délai pour les messages légitimes. Mêmesi le délai n'est pas très long, il peut parfois être un facteur de frustration pour l'utilisateurfinal. Comme solution partielle à ce problème, vous pouvez activer "Contourner la liste grise surPasse SPF". Les fournisseurs de messages les plus importants comme Gmail et Hotmail publientdes enregistrements SPF pour leur domaine. Si hMailServer reçoit un message d'un domaine qui apublié des enregistrements SPF, que l'adresse IP liée à hMailServer est autorisée à envoyer àpartir de ce domaine, te que cette option est activée, hMailServer ne traitera pas avec la listegrise.

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. Sil'adresse de connexion est détectée dans l'un des enregistrements, la liste grise sera ignoréelorsque cette option est activée.

Liste blanche

Les serveurs de messagerie qui utilisent des adresses IP différentes à chaque fois qu'ils essaientd'envoyer un message à hMailServer, les serveurs qui n'essaient pas de renvoyer les messagesqui ont été temporairement rejetés, ne sont ps compatibles avec la liste grise. Vous pouvezajouter ici une adresse IP à de tels serveurs. hMailServer n'utilisera pas la liste grise pour ceserveur. Les jokers sont pris en charge pour cette liste.

 

Groupe

Général

Nom du groupe

hMailServer - Guide de l'Utilisateur

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

Général

Connexions

Ce réglage d'finit le nombre maximum de connexions simultanées qui seront autorisées au serveurIMAP. Si zéro est spécifié, un nombre illimité de connexions sera autorisé.

Autre / Message de bienvenue

Le message de bienvenue est envoyé directement aux clients IMAP après qu'ils se soientconnectés au serveur. Vous pouvez modifier ce message si vous ne souhaitez pas que l'on sachele 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 accès aux dossiers publics.

Editer les dossiers

Choisissez cette option pour gérer les dossiers publics.

Les Permissions sont appliquées de la manière suivante:

·Si une permission correspondant à l'utilisateur spécifique est trouvée, cette permission estutilisée.·Sinon, hMailServer vérifiera si l'utilisateur est un membre d'un groupe. Si c'est le cas, le premiergroupe est sélectionné.·Sinon, hMailServer vérifiera si une permission "Anyone" ("tous") a été définie.

Avancé

Extensions

Utilisez ces réglages pour activer ou désactiver les extensions IMAP sur le serveur.

·L'extension SORT IMAP permet aux messages d'être triés sur le serveur au lieu du client demessagerie. Ce qui augmente la performance des clients de messagerie web.·Quota IMAP - L'extension Quota IMAP donne la possibilité aux clients IMAP de vérifier l'utilisationdu quota pour le compte.·Idle IMAP - A l'aide de cette extension, le client IMAP peut recevoir des notifications de la part duserveur dès qu'un nouveau message existe. De cette façon, le client de messagerie n'a pas àvérifier manuellement l'existence de nouveaux toutes les X minutes.·ACL IMAP - Lorsque cette extension est activée, vous pouvez définir les dossiers publics et leurspermissions.

hMailServer - Guide de l'Utilisateur

53 / 214

Séparateur hiérarchique

Choisissez le séparateur hiérarchique que hMailServer utilisera. Le séparateur est utilisé dans lescommunication entre les clients IMAP et hMailServer. Par exemple, dans la hiérarchie Inbox\Test\Sub le séparateur est \.

Après avoir choisi le séparateur, celui-ci ne peut pas être utilisé dans le nom des dossiers - du faitqu'il est utilisé pour séparer les niveaux d'un dossier.  Il n'est pas possible de changer leséparateur pour un caractère qui est seulement utilisé dans un nom de dossier sur le serveur. Iln'est pas non plus possible de le changer pour un séparateur qui est utilisé pour les noms dedossiers dans des actions de règle car cela créerait un conflit.

Lorsque vous changer le séparateur hiérarchique, hMailServer actualise automatiquement toutesles actions de règles qui contiennent ce séparateur hiérarchique pour le nouveau.

 

 

Relais entrant

Généralités

hMailServer suppose que tous les messages reçus de l'adresse IP d'un relais entrant sont àtransférer.

Normalement hMailServer utilise l'adresse TCP/IP des expéditeurs lors de la protection anti-spam.Si hMailServer reçoit le message d'une sauvegarde MX, il ne peut pas utiliser l'adresse TCP/IP desexpéditeurs car il s'agit de l'adresse IP du serveur de sauvegarde. Si vous ajoutez l'adresse IPdes serveurs de sauvegarde MX comme relais entrant, hMailServer saura que les messages de ceserveur sont à transférer. hMailServer essaiera alors de déterminer l'adresse IP d'origine desexpéditeurs en analysant les en-têtes Reçu du message. Notez que les relais entrants n'affectent pas la liste grise. Celle-ci prend toujours place avant queles en-têtes Reçu aient été transmis à hMailServer. Vous pourriez ajouter toute adresse IP derelais entrant de la liste grise à la liste blanche pour éviter qu'il fasse partie de la liste grise.

 

Configuration du fichier ini

Généralités

La plupart des paramètres d'installation de hMailServer sont enregistrés dans la base dedonnées. Cependant, certains réglages le sont dans le fichier hMailServer.ini. Les informationsconcernant les chemins et les connexions, par exemple, sont enregistrées dans le fichier ini. Cedocument énumère tous les paramètres présents dans le fichier hMailServer.ini.

Si vous souhaitez utiliser un paramètre qui n'est pas présent dans la fichier hMailServer.ini devotre système, vous pouvez le faire vous-même. Pour ajouter, par exemple le paramètreConnectionAttempts à la section Database, ajoutez simplement la ligne ConnectionAttempts=5sous la ligne [Database] du fichier hMailServer.ini. Dans certains cas, vous aurez peut-être aussi àajouter la section réelle ([SectionName]). Si la section existe déjà dans le fichier, ajoutez leparamètre à ce fichier. Vous ne pouvez pas avoir deux sections du fichier ini portant le même nom.

Sections

hMailServer - Guide de l'Utilisateur

54 / 214

Directories

·ProgramFolder - le chemin du dossier hMailServer. Par défaut, C:\Program Files\hMailServer.·DataFolder - le chemin du dossier de données de hMailServer. Par défaut, C:\Program Files\hMailServer\Data.·LogFolder - Le chemin d'enregistrement des fichiers journaux de hMailServer. Par défaut, C:\Program Files\hMailServer\Logs·TempFolder - Le chemin d'enregistrement des fichiers temporaires de hMailServer, comme lespièces jointes lors de l'examen antivirus. Par défaut C:\Program Files\hMailServer\Temp·EventFolder - Le chemin d'enregistrement du fichier événement de hMailServer. Par défaut, C:\Program Files\hMailServer\Events

GUILanguages

·ValidLanguages - liste des langues de l'interface utilisateur de hMailServer. hMailServerAdministrator utilise cette liste pour définir les langues à afficher dans le menu Langue.

Database

·Internal - 1 si la base de données MySQL interne est utilisée, 0 autrement. hMailServer utilise ceréglage pour déterminer si les scripts sont à appliquer à la base de données MySQL au premierdémarrage. Si, par exemple, une nouvelle version de MySQL fait partie du programmed'installation, hMailServer pourra exécuter le script SQL pour y apporter le correctif.·Type - le type de base de données. Il peut s'agir de MySQL ou MSSQL. hMailServer l'utilise pourdéterminer la méthode à utiliser pour la connexion au serveur de base de données, et la syntaxeà utiliser pour les instructions SQL.·Username - hMailServer utilisera ce nom d'utilisateur lors de la connexion au serveur de base dedonnées. Si ce paramètre est vierge et que MSSQL est utilisé, hMailServer essaiera d'utiliserWindows Authentication.·Password - le mot de passe que hMailServer doit utiliser lors de la connexion au serveur de basede données. Si passwordencryption est réglé sur 1, le mot de passe est crypté via blowfish.·Passwordencryption - réglé sur 1, le mot de passe de la base de données est crypté via blowfish.Dans ce cas, le service hMailServer décode le mot de passe avant la connexion à la base dedonnées.·Port - le port auquel hMailserver doit se connecter sur le serveur de base de données.·Server - le nom d'hôte du serveur de base de données auquel hMailServer doit se connecter.·Database - le nom de la base de données à laquelle hMailServer doit essayer de se connecter.·NumberOfConnections - le nombre de connexions qui doit s'ouvrir à la base de données. Lavaleur par défaut de cette valeur est 5, ce qui signifie que hMailServer ouvrira la connexion 5 auserveur de base de données. hMailServer veut souvent exécuter plusieurs requêtes de base dedonnées à la fois. Comme une connexion spécifique à une base de données ne peut utiliser qu'uninstruction SQL à la fois, plusieurs connexions a la base de données améliore la performance.·ConnectionAttempts - le nombre de fois que hMailServer doit essayer de se connecter à la basede données avant d'abandonner lors du démarrage. La valeur par défaut est 6 fois (hMailServer4.4 et supérieur).·ConnectionAttemptsDelay - le nombre de secondes de pause que hMailServer doit attendre entrechaque tentative de connexion lors du démarrage. La valeur par défaut est 5 secondes(hMailServer 4.4 et supérieur).

Security

·AdministratorPassword - le mot de passe principal d'administration de hMailServer. L'utilisateur,par exemple, doit entrer ce mot de passe au démarrage de hMailServer Administrator. Ce mot depasse est encodé via MD5.

Settings

Les paramètres ci-dessous doivent être édités avec prudence. Ils existent dans le fichier ini, uniquement pour des raisons de compatibilité de la base de données. Ils seront déplacés vers labase de données dans une prochaine version. Lorsque vous installez la version suivante dehMailServer, il se peut que vous ayez à modifier à nouveau ces réglages en utilisant hMailServer

hMailServer - Guide de l'Utilisateur

55 / 214

Administrator.

·DNSBLChecksAfterMailFrom - par défaut, hMailServer traite la vérification des listes noires DNSaprès SMTP/MAIL FROM. Certains utilisateurs préfèrent que cette action s'exécute après lacommande SMTP/RCPT TO. Dans ce cas, réglez cette valeur sur 0.·AddXAuthUserHeader - réglé sur 1, hMailSever ajoutera un en-tête X-AuthUser contenant un nomd'utilisateur au message reçu via SMTP, s'il cet utilisateur été identifié.·GreylistingEnabledDuringRecordExpiration - ce réglage vous permet de configurer hMailServerpour désactiver temporairement la fonctionnalité liste grise alors que les anciens enregistrementde l'ancienne liste grise sont effacés. Ce qui peut être nécessaire si vous avez une quantitéimportante d'enregistrements greylisting et que vous utilisez SQL. Lorsque hMailServer efface lesanciens enregistrements, la table greylisting entière sera verrouillée pour longtemps. Si d'autresconnexions de base de données tente d'accéder à la table en attente, ils devront attendre la finde la suppression. Si le processus prend plusieurs minutes, ceci est susceptible d'entraîner desproblèmes. La valeur pas défaut est 1, ce qui signifie que hMailServer continuera à utiliser la listegrise lors de l'effacement des enregistrements de la base de données.·GreylistingRecordExpirationInterval - ce réglage définit la fréquence à laquelle hMailserver doiteffacer les enregistrements greylisting expirés de la base de données. La suppression desenregistrements peut être une tâche fastidieuse. La valeur par défaut est 240, ce qui signifie quehMailServer effacera les enregistrements expirés toutes les 240 minutes (toutes les 4 heures).·PreferredHashAlgorithm  - Ce paramètre vous permet de spécifier l'algorithme de hachage quehMailServer doit utiliser pour les mots de passe de la base de données hMailServer. Dans lesanciennes versions de hMailServer, les mots de passe étaient enregistrés en texte clair. DanshMailServer 4, les mots de passe étaient enregistrés en MD5. Dans hMailServer 5, le hachagepréféré par défaut est désormais SHA256. Les valeurs valides pour ce réglage 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 sécurité n'est pas plus élevéeque 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'intègre avec la basede données hMailServer.

o 3 - SHA256 - Enregistrement des mots de passe en hachages SHA256. C'est habituellementl'option recommandée qui fournit le niveau de sécurité le plus élevé.

Plage IP

Général

Nom

Le nom de la plage IP. Tout texte entre 1 et 40 caractères. Indiquez des noms de plages IP quidécrivent ces plages, per exemple Mon ordinateur, Mon LAN, etc....

Priorité

La priorité de la plage IP. Vous pouvez spécifier une valeur entre 0 et 1000. Un valeur élevéesignifie une priorité élevée. Si hMailServer est confronté à deux plages d'adresses IP, la plaged'adresses IP avec la plus haute priorité sera utilisé. Par exemple, si un client correspond à uneplage IP de priorité 5, et à une de priorité 10, hMailServer utilisera la plage IP de priorité 10. Si unclient correspond à deux plages IP de même priorité, le choix que fera hMailServer n'est pas défini.

IP inférieure & IP supérieure

Toutes les adresses IP situées entre (et comprises) une IP inférieure et une IP supérieure seraaffectée par cette plage IP. Par exemple, l'adresse IP 127.0.0.4 correspond à une plage IP où l'IPinférieure est 127.0.0.1 et l'IP supérieure 127.0.0.5. L'adresse IP 255.255.255.0 correspond àune plage IP où l'IP inférieure et l'IP supérieure est 255.255.255.0.

Expire

hMailServer - Guide de l'Utilisateur

56 / 214

Si vous souhaitez que la plage IP soit effacée automatiquement, sélectionnez Expire et indiquez ladate et l'heure souhaitées pour la suppression.

La date d'expiration n'est pas exacte à la seconde - la tâche interne qui efface les plages expiréess'exécute une fois toutes les minutes. 

Cette fonctionnalité est utilisée par la fonction auto-ban de hMailServer. Si une adresse IP estauto bannie, une plage IP qui correspond à cette adresse IP sera créée. La date d'expiration seraautomatiquement réglée à un moment futur, comme défini dans les paramètres auto-ban.

Autoriser les connexions

Ce paramètre vous permet de définir le protocole que hMailServer autorisera, à partir desconnexions TCP/IP provenant de cette plage d'adresses IP.

Autoriser les distributions

Ce paramètre vous permet de définir si hMailServer doit autoriser les distributions SMTP pour cetteplage. Une personne qui envoie un message est considérée locale si la partie domaine de son adresse e-mail correspond·à un domaine local ou·à un itinéraire dans lequel vous avez sélectionné "Quand un destinataire correspond à l'itinéraire,traiter le domaine du destinataire comme un domaine local"

Une personne est considérée comme externe dans tous les autres cas.

Tous les utilisateurs possédant des comptes sur votre serveur seront habituellement considéréscomme locaux. Tous les autres seront considérés comme externes.

Si vous sélectionnez "Externe vers externe", les gens pourront envoyer des e-mail via le serveur,même si l'adresse de l'expéditeur ne correspond pas à un compte du serveur. Si vous sélectionnezcette option, vous devez être sûr de sélectionner les paramètres adéquats dans "Requiert uneauthentification SMTP". Sinon votre serveur sera ouvert aux spammeurs.

Requiert une authentification SMTP

En utilisant ces paramètres, vous pouvez sélectionner ce qui est requis pour utiliserl'authentification SMTP lors de l'envoi via le serveur. L'authentification SMTP devrait normalementêtre utilisée par toutes les personnes envoyany des messages depuis des comptes sur votreserveur. De même, Externe vers externe devrait normalement toujours être sélectionné. Si vous nedemandez pas d'authentification lorsque des utilisateurs externes envoient des messages viavotre serveur, celui-ci sera maltraité par les spammeurs.

Anti-spam

Si cette option est activée, hMailServer exécutera la protection anti-spam (comme le SPF, la listenoire DNS et la vérification MX) pour la distribution SMTP originaire de cette plage IP. Vous pourriezdésactiver cette option pour votre réseau local.

Anti-virus

Si cette option est activée, hMailServer exécutera la protection antivirus pour les distributionsoriginaires de cette plage IP. Vous pourriez désactiver cette option pour votre réseau local..

Recommandations

hMailServer - Guide de l'Utilisateur

57 / 214

Exécuter les tests de ralais ouverts

Après avoir changé ou ajouté une plage IP, vous devriez exécuter au moins un test de relaisouverts pour vérifier qu'aucun ne peut utiliser votre serveur pour envoyer des spams.

 

Activité

Généralités

Live (Activité) dans hMailAdmin vous permet de voir l'état actuel du serveur hMailServer. Par sonintermédiaire, vous pouvez voir si le serveur a démarré, le nombre de messages traités, le nombrede spams et le nombre de virus détectés.

Si vous avez activé l'ouverture d'une session hMailServer, vous pouvez voir les informationsd'ouverture de session directement dans l'onglet Ouverture de session. Si vous activez le Journalde l'Application, vous pouvez voir directement les détails des messages à distribuer dans cetteinterface utilisateur, sans avoir à examiner les fichiers journaux.

Vous pouvez aussi consulter une liste des messages non distribués. Ce sont les messages qui ontété reçus par hMailServer mais qui n'ont pas été distribués au destinataire. Ces messages sontdans la file d'attente de distribution.

Création des journaux

Général

Activer la création des journaux

Cette option permet la création de journaux. Si cette option est désactivée, rien ne seraenregistré dans un journal, sauf les erreurs.

Application

Le journal des applications contient des événements majeurs des serveurs, comme lesinformations de démarrage, d'arrêt et de distribution des messages du serveur.

Echange SMTP

Le journal des échanges SMTP contient les communication SMTP que crée hMailServer, lorsquehMailServer agit comme client SMTP (distribution) et comme serveur SMTP (réception).

Echange POP3

Le journal des échanges POP3 contient les communication POP3 que crée hMailServer, lorsquehMailServer agit comme client POP3 (téléchargement des messages d'un serveur externe) etcomme serveur POP3 (téléchargement des messages par le client de messagerie à partir dehMailServer).

Echange IMAP

Le journal des échanges IMAP contient les communications IMAP que crée hMailServer.

TCP/IP

hMailServer - Guide de l'Utilisateur

58 / 214

Le journal TCP/IP contient les événements TCP/IP, comme les requêtes DNS, l'ouverture et lafermeture des connexions, etc.

Messages de débogage

Le journal des messages de débogage contient les messages de bas niveau. L'enregistrement dujournal de débogage devrait être activé uniquement pour dépannage.

AWStats

Le journal AWStats (enregistré sous hmailserver_awstats.log) contient les événements dedistributions SMTP formatés pour AWstats.

Dans la configuration AWstats, les paramètres 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 paramètres 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 spécifier si hMailServer doit garder les fichiers journaux ouverts entreles écritures intermédiaires. Le comportement d'écriture du journal par défaut dans hMailServerest que toutes les fois où hMailServer ajoute un élément à un fichier journal, celui-ci est ouvert,écrit, puis fermé.  Ce qui signifie que les données écrites par hMailServer dans le fichier sontévacuées immédiatement. S'il existe de nombreuses petites écritures dans les fichiers journaux, laperformance peut en pâtir.  Si vous configurez hMailServer pour garder les fichiers journaux ouverts, Windows mettra dans untampon les données à envoyer dans le fichier journal. Ce qui peut radicalement améliorer laperformance du fichier journal. L'inconvénient est que ces fichiers journaux ne peuvent pas êtreeffacés lorsqu'ils sont ouverts. Lorsque hMailServer a fini d'écrire dans un fichier journal (dans lecas de fichiers journaux normaux, ceci se produit à minuit lorsqu'un nouveau nom de fichier estgénéré), il ferme le fichier et celui-ci peut être supprimé. 

 

Miroir

Généralités

Configuration

Adresse e-mail miroir

L'adresse de messagerie vers laquelle tous les messages seront transférés. 

·Les messages avec l'adresse miroir dans la liste des destinataires ne sont pas envoyés verscette adresse pour éviter la réaction en boucle.·Si une adresse locale a été spécifiée, mais que le domaine ou le compte est inactif, ou que cedernier n'existe pas, une erreur est insérée dans le journal.

Requête MX

hMailServer - Guide de l'Utilisateur

59 / 214

Configuration

Adresse e-mail

Indiquez l'adresse de messagerie pour laquelle vous souhaitez effectuer une recherche MX.

Résoudre

Sélectionnez Résoudre pour effectuer la résolution DNS/MX. Sauf si les information sont localementen cache sous Windows, hMailServer contactera le serveur DNS pour les informations

Serveurs Mail

Après avoir cliqué sur Résoudre, une liste des serveurs de messagerie responsables de lamanipulation des messages d'une adresse e-mail données sera affichée.

Performance

Généralités

Ces paramètres vous permettent de régler finement la performance de hMailServer.

Cache

Utilisez ces paramètres pour configurer le cache hMailServer. hMailServer peut mettre en cache des objets de la base de données. Si un objet est mis en cache, hMailServer n'a ps à contacter labase de données pour y accéder. Activez le cache peut améliorer radicalement la performance dehMailSever. Consultez le guide de l'utilisateur pour en savoir plus sur ces réglages.

Processus

Nombre Max de processus de commande

Lorsque qu'un client SMTP, POP3 ou IMAP envoie une commande à hMailServer, elle est manipuléepar ce que l'on appelle un processus de commande. Les processus de commande manipulenthabituellement des commandes simples, comme "ouvrir une session", "récupérer le message" et"ajouter un destinataire au message". Cette valeur spécifie le nombre de commandes simultanéesqui peuvent être utilisées par les clients. Si vous augmentez cette valeur, davantage decommandes peuvent s'exécuter en même temps, mais chacune d'entre elles s'effectuera pluslentement. Si vous réduisez cette valeur, moins de commandes seront exécutées à la fois, maiselles seront traitées plus vite.

Processus de distribution

hMailServer peut distribuer plusieurs messages à la fois. Ce paramètre vous permet de définir lenombre de messages que hMailServer pourra distribuer simultanément. Une valeur élevéenécessite plus de ressources CPU. Une valeur plus faible induira une distribution plus lente. Lemeilleur réglage dépend de votre matériel et de la quantité de messages à distribuer par votreserveur. Pour les petites installations, 3 distributions simultanées suffisent. Pour les installationsplus importantes, vous pouvez augmenter cette valeur jusqu'à 15 ou 20. Pour les installations très

hMailServer - Guide de l'Utilisateur

60 / 214

importantes, cette valeur est à régler entre 50 et 100. Les valeurs réelles optimales varient enfonction des habitudes d'utilisation, des envois quotidiens de messages, et ainsi de suite.

Nombre Max de processus de tâches asynchrones

Ce réglage définit le nombre de connexions parallèles que hMailServer effectuera vers le logicielexterne lors de l'exécution de la protection nti-spam. Ce réglage définit, par exemple, le nombrede 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 tâches différentes sont effectuées exactement au même moment. Par exemple, unmessage est reçu, distribué, pendant que les clients téléchargent des messages au mêmemoment. Ces différentes tâches sont traitées pour ce que l'on appelle les processus actifs. Vouspouvez changer la priorité des processus actifs pour modifier la quantité de temps qu'utilise lesystème d'exploitation pour ces processus. Si vous diminuez cette valeur, hMailServer s'exécuteraplus lentement et davantage de ressources CPU seront disponibles pour d'autres tâches dusystème d'exploitation. Si vous augmentez la priorité, hMailServer s'exécutera plus vite, mais lesautres logiciels seront ralentis.

Indexation des messages

Lorsque l'option Indexation des Messages est activée, certaines métadonnées de messagesupplémentaires sont enregistrées dans la base de données. Ce qui peut améliorerconsidérablement la vitesse de parcours des dossiers volumineux lors de l'utilisation d'un clientwebmail en rapport avec le côté tri du serveur. La performance est atteinte depuis quehMailServer peut trier les messages en récupérant les éléments analysables de la base dedonnées, plutôt qu'en ayant à lire tous les fichiers du dossier pour en analyser chaque contenu unà un.

L'inconvénient de ces option est que la taille de la base de données ira en augmentant. Il n'estpas conseillé d'activer cette fonction sauf si vous rencontrez des problèmes de performance enrapport avec les dossiers volumineux du webmail.

POP3 settings

Connexions

Ce réglage définit le nombre maximum de connexions simultanées autorisées au serveur POP3. Sizéro est spécifié, un nombre illimité de connexions sera autorisé.

Message d'accueil

Le message d'accueil est envoyé aux clients POP3 directement après leur connexion au serveur. laraison pour laquelle vous auriez à modifier le message d'accueil est de rendre plus difficile ledétection du logiciel serveur que vous exécutez.

Protocoles

Protocoles

Utilisez cette section pour définir les protocoles que hMailServer doit prendre en charge.

Routage

hMailServer - Guide de l'Utilisateur

61 / 214

Généralités

Itinéraires spécifie comment et où les messages de domaines spécifiques sont à distribuer.Normalement, hMailServer utilise les recherches DNS pour déterminer où les messages sont àdistribuer. Itinéraire vous permet de contourner ce comportement. Exemple:

·Itinéraire vous permet de distribuer les messages à un domaine spécifique via un serveurspécifique sans utiliser la recherche MX.·Itinéraire vous permet à votre serveur d'agir comme une sauvegarde MX pour un autre serveur·En utilisant les Itinéraires, vous pouvez configurer hMailServer pour transférer les messages decomptes spécifiques vers d'autres serveurs SMTP, même si le domaine du compte existe dansvotre installation hMailServer.

Configuration

Domaine

Le domaine auquel cet itinéraire doit s'appliquer. Le nom de domaine est insensible à la casse.

Hôte SMTP cible

L'hôte vers lequel seront délivrés les messages auxquels l'itinéraire s'applique. Il s'agithabituellement d'un nom d'hôte internet tel que mail.exemple.com.

Sécurité

Lorsqu'une personne essaie d'envoyer un message au destinataire qui correspond à un itinéraire,hMailServer utilise une plage IP et les paramètres de sécurité de l'itinéraire pour définir si ladistribution doit s'effectuer. En utilisant deux paramètres de sécurité, "Quand l'expéditeurcorrespond à l'itinéraire" et "Quand le destinataire correspond à l'itinéraire", vous spécifiez sil'expéditeur et le destinataire doivent être considérés comme locaux ou externes. Combinées auxréglages des plages IP, ces options spécifient à quel moment les distributions seront autorisées,et si l'authentification SMTP sera requise ou pas.

Si vous configurez hMailServer pour traiter les destinataires correspondants à un itinéraired'adresses locales, et que les plages IP ne permettent pas la distribution à des adresses locales,la distribution ne sera pas acceptée par hMailServer. De même, si vous configurez le destinatairepour être considéré comme externe, et que les plages IP indiquent que l'authentification SMTP estrequise pour la distribution à des adresses externes, hMailServer nécessitera une authentificationSMTP avant d'accepter la distribution.

Exemples:

·Si vous voulez que les utilisateurs externes (les utilisateurs d'autres serveurs demessagerie) puisent envoyer des messages via l'itinéraire, sélectionnez "Quand le destinatairecorrespond à l'itinéraire, le considérer comme local". Les plages IP par défaut dans hMailServerpermettent de distribuer depuis des adresses externes vers des adresses locales sansauthentification SMTP.·Si vous souhaitez que seuls les utilisateurs locaux puissent distribuer des messages vial'itinéraire, indiquez que le destinataire doit être considéré comme un domaine externe. Pardéfaut, les plages IP dans hMailServer ne permettent pas la distribution depuis des utilisateursexternes vers des utilisateurs externes sans authentification SMTP.

Adresses

Ce réglage vous permet d'indiquer les adresses de messagerie auxquelles hMailServer autorise ladistribution. Par exemple, si vous savez que seule l'adresse valide de l'hôte SMTP cible [email protected], vous pouvez ajouter cette adresse à la liste. dans ce cas, hMailServerne distribuera qu'à cette adresse spécifique. Ce qui économise l'utilisation de la bande passante.

hMailServer - Guide de l'Utilisateur

62 / 214

Vous pouvez configurer hMailServer pour qu'il distribue à toutes les adresses. Dans ce cas,hMailServer transférera tout message adressé au domaine de l'hôte spécifié dans l'itinéraire.

Distribution

Utilisez le Nombre de tentatives pour spécifier le nombre de fois que hMailServer devra réessayerd'envoyer vers ce domaine. Si l'itinéraire est utilisé pour la sauvegarde MX, vous aurezprobablement intérêt à régler ce paramètre sur une valeur plutôt élevée. Les minutes entrechaque tentative vous permettent de spécifier le délai entre deux tentatives de hMailServer. Si,par exemple, l'hôte SMTP cible est en panne, il n'est pas nécessaire de réessayer chaque minute.Par contre, si l'hôte SMTP cible réapparaît, vous ne voudrez certainement pas attendre 10 heurespour que le serveur essaie à nouveau. Utilisez Le serveur requiert une authentification pourspécifier le nom d'utilisateur et le mot de passe si l'hôte SMTP cible nécessite une authentification.

Exemples

Exemple 1 - Créer un nouvel itinéraire

L'exemple suivant explique comment configurer tous les messages du domaine hmailserver.compour qu'ils passent par mx.hmailserver.com au lieu du serveur par défaut, mail.hmailserver.com:

1.Lancez hMailServer Administrator2.Accédez à Configuration -> Protocoles -> SMTP -> Routes3.Cliquez sur Ajouter4.Dans le champ Domaine, entrez hmailserver.com5.Dans le champ Hôte SMTP cible, entrez mx.hmailserver.com.6.Cliquez sur Enregistrer

Ainsi, tous les messages envoyés à hMailServer.com passeront par mx.hmailserver.com, au lieude passer par le serveur par défaut, 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 unautre serveur. Dans cet exemple, le domaine example.com est un domaine "local" que noushébergeons nous-même. Ce qui peut être utile, par exemple, si nous avons actualisé lesenregistrements MX pour un domaine, mais que nous souhaitons encore recevoir le courrier dudomaine sur l'ancienne adresse IP au cas où certains expéditeurs SMTP n'auraient pas actualiséleur cache DNS.

1.Lancez hMailServer Administrator2.Accédez à Configuration -> Protocoles -> SMTP -> Routes3.Cliquez sur Ajouter4.Dans le champ Domaine, entrez example.com5.Dans le champ Hôte SMTP cible, entrez le nom d'hôte vers lequel le courrier de ce domaine seratransféré.6.Cliquez sur Enregistrer

Si hMailServer reçoit un message adressé au domaine example.com, et qu'il ne peut pas trouver ledestinataire dans l'installation locale, Il distribuera désormais le courrier au nom d'hôte que vousavez spécifié dans l'itinéraire. Si hMailServer ne trouve pas le destinataire dans l'installation locale,le courrier sera alors placé dans le comte local - hMailServer ne transfère le courrier en utilisant lesitinéraires que si les destinataires sont introuvables localement.

Exemple 3 - Configurer un serveur en DMZ pour transférer à un serveur de messagerie interne

Cet exemple explique comment mettre en place une installation de hMailServer dans une DMZ quitransmet tout le courrier entrant vers un serveur d'arrière-plan. Une des raisons courantes pourconfigurer une telle installation est de préférer que la protection anti spam et anti-virale s'exécuteen dehors de votre réseau interne. Autres raison courante: les sociétés qui exécutentMicrosoftExchange en interne ne souhaitent pas exposer ce serveur à Internet.

hMailServer - Guide de l'Utilisateur

63 / 214

1.Lancez hMailServer Administrator2.Accédez à Configuration -> Protocoles -> SMTP -> Routes3.Cliquez sur Ajouter4.Dans le champ Domaine, entrez votre nom de domaine, par exemple example.com5.Dans le champ Hôte SMTP cible, entrez le nom d'hôte du serveur de messagerie interne.

Vous ne devez pas ajouter le domaine au serveur dans le DMZ - seulement dans le routage.

Si hMailServer reçoit un message adressé à votre nom de domaine, il le transférera au serveurbackend. Si hMailServer reçoit un message d'un domaine inconnu, il sera rejeté.

Le problème, avec cette configuration, est que hMailServer n'a pas connaissance des destinatairesexistant sur le domaine interne. De ce fait, hMailServer acceptera le courrier de tout destinatairequi correspond à votre nom de domaine et essaiera de transférer le message à votre serveurinterne. Si le destinataire n'existe pas sur les serveur interne, un message d'avertissement seracréé pour informer l'expéditeur que l'adresse du destinataire n'est pas valide. Un façon decontourner ce problème consiste à ajouter tous les destinataires valides à la Configuration duRoutage, de sorte que hMailServer sache quels destinataires sont valides. Dans ce cas,hMailServer n'acceptera pas le courrier de l'expéditeur et aucun message d'avertissement ne seraenvoyé.

 

 

Règles

Généralités

Les règles vous permettent de définir les actions à prendre en fonction du contenu des messages.Vous pouvez, par exemple, définir une règle pour supprimer des messages en fonction d'un sujetspécifique, ou transférer un message de taille supérieure à une taille spécifiée.

Les règles peuvent être définies à deux niveaux différents: Général et Compte. Les règlesGénérales s'appliquent à tous es messages distribués au serveur, sans tenir compte desdestinataires qui les reçoivent. Les règles Compte ne s'appliquent qu'aux messages d'un comptespécifique.

Chaque règle possède un jeu de critères et d'actions. Lorsque vous créez une règle, vous ajoutezun critère qui spécifie à quel message la règle sera appliquée. Vous pouvez ajouter, par exemple,un critère qui limite la règle aux messages qui contiennent un en-tête d'ID de message spécifique.Après avoir ajouté un critère, vous ajoutez des actions. Les Actions définissent ce que hMailServerfera si un message correspond au critère. L'action peut, par exemple, consister à transmettre lemessage, à le supprimer ou à le déplacer dans un dossier spécifique.

Les règles sont appliquées lors de la phase de distribution des messages. Ce qui signifie que, sivous effectuez des modifications du contenu de la règle du message, ou si vous déplacez lemessage dans un dossier IMAP spécifique, cela n'affectera que la façon dont le destinataire verrale message. Si vous avez défini, par exemple, une règle globale pour déplacer les messages dansun dossier IMAP Spam, et que l'Utilisateur 1 envoie un message à l'Utilisateur 2, seul l'Utilisateur 2verra le message dans la boîte aux lettres Spam. L'Utilisateur 1 ne verra pas le message dans laboîte aux lettres Spam, car il n'est pas le destinataire du message. La raison en est que sil'Utilisateur 1 envoie à l'Utilisateur 2, le message n'est pas distribué à l'Utilisateur 1, mais àl'Utilisateur 2.

Test de correspondance

Dans la boîte de dialogue Critères de Règle, vous pouvez tester si les valeurs spécifiéescorrespondent aux critères. Pour effectuer un test, entrez simplement la valeur à tester dans lachamp Valeur du Test. Si la valeur correspond au critère, le texte "Correspond" (Match) apparaîtraprès du champ de saisie. Sinon, "Ne correspond pas" (No match) s'affichera. Ce qui facilite lacréation de critère plus avancés, pour utiliser, par exemple, des expressions régulières.

hMailServer - Guide de l'Utilisateur

64 / 214

Exemples

Voici quelques exemples sur la façon d'appliquer les règles.

Différents types de recherche

hMailServer prend en charge différents types de recherches. Ces types de recherche sont: Est,Contient, Inférieur à, Supérieur à et Expression Régulière.

·Is: (est) utilisé pour spécifier une correspondance exacte.·Contains: (contient) utilisé pour spécifier une correspondance partielle. Vous pouvez, parexemple, appliquer la règle à un message dont le Corps Contient un certain mot.·Less than: (inférieur à) utilisé pour des correspondances numériques. Vous pouvez, par exemple,appliquer la règle aux messages dont la taille est inférieure à 1 Mo.·Larger than: (supérieur à) utilisé pour des correspondances numériques. L'inverse de Inférueur à·Regular expression: (expression régulière) en utilisant la correspondance d'une expressionrégulière, vous pouvez spécifier des correspondances plus complexes. Vous pouvez, par exemple,appliquer la règle à tous les messages dont le sujet commence par une lettre et le reste par deschiffres. Pour en savoir plus sur les expressions régulières, consultez la page http://www.regular-expressions.info/. L'expression régulière utilisée doit correspondre à la valeur totale avec laquelleelle est comparée. Il n'est pas possible d'utiliser une correspondance partielle. hMailServers'appuie sur Boost/Regex pour faire l'analyse d'une expression régulière, et utilise la syntaxe Perl.Pour en savoir plus sur les options disponibles, consultez le site Boost.

Actions

·Supprimer le message - Choisissez cette règle pour supprimer le message. Le message serasupprimé à la fin du traitement de la règle.·Transférer le message - Choisissez cette règle si vous souhaitez transférer le courrier à un autredestinataire. Il est possible de spécifier des destinataires locaux et externes.·Répondre - Cette option peut s'utiliser si vous souhaitez répondre automatiquement auxcourriers.·Exécuter la fonction - Utilisez cette option si vous souhaitez exécuter un script hMailServer dèsqu'un message correspond à la règle.·Définit la valeur de l'en-tête - Avec cette option, vous pouvez ajouter des en-têtes MIME aumessage.·Déplacer dans un dossier IMAP - Il est possible, lors du déplacement du courrier dans un dossier,d'utiliser une règle, pour le déplacement dans des dossiers et des sou-dossiers. Utilisez cettesyntaxe: Folder.Subfolder1.Subfolder2. Si vous avez changé le Séparateur Hiérarchique par défautdans hMailServer, vous devez utiliser le nouveau séparateur plutôt que le . (point).·Arrêter le traitement de la règle - Choisissez cette option si vous souhaitez annuler le traitementde la règle restante. Ainsi, toute action ou règle spécifiée ne sera plus exécutée.

Détails

Si vous souhaitez connaître les détails sur le mode de fonctionnement du traitement d'une règle,voyez le document détaillé.

Dépannage

Si vous rencontrez des problèmes, voyez la rubrique Conseils de dépannage.

Configuration

Nom

Le nom de la règle. Tout texte de votre chhoix.

hMailServer - Guide de l'Utilisateur

65 / 214

Critère

Le critère de cette règle. Les messages correspondant à ce critère sera affecté par les actions dele règle.·Utiliser AND - Tous les critères doivent correspondre pour que le message soit affecté par la règle.·Utiliser OR - Si un critère correspond, le message sera affceté par la règle.

Champ prédéfini

·De - L'en-tête MIME De: du message.·À - L'en-tête MIME À: du message. A ne pas confondre avec le paramètre Liste des destinataires.Voir les remarques (3) ci-dessous pour en savoir plus.·CC - L'en-tête MIME CC: du message.·Liste des destinataires - Liste de tous les destinataires du message actuel. Cette liste récupéréeà partir de l'enveloppe SMTP, pas à partir des en-têtes MIME. Voir les remarques (3) ci-dessouspour en savoir plus.·Sujet - L'en-tête 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-tête personnalisé

Si l'en-tête que vous voulez filtrer n'existe pas dans la liste des champs prédéfinis, vous pouvez lenom de l'en-tête MIME dans ce champ.

Types de recherche

·Equals - (égal) la valeur / chaîne doit correspondre exactement·Not equals - (non égal) la valeur / chaîne ne doit pas correspondre.·Contains - (contient) correspond partiellement·Not contains - (ne contient pas) le valeur ne doit pas exister dans le champ Prédéfini field / en-tête personnalisé.·Less than - (inférieur à) ne peut être utilisé que pour les valeurs·Greater than - (supérieur à) ne peut être utilisé qe pour les valeurs.·Regular expression - (expression régulière) utilisez une expression régulière pour correspondre àla valeur.·Wildcard - (joker) utilisez une chaîne de recherche avec des jokers pour rechercher une valeur.

Valeur

Entrez la valeur à rechercher, ou l'expression régulière à utiliser.

Test

Dans la section Test de la boîte de dialogue Critère, vous pouvez tester si les différentes valeurscorrespondent à votre critère. Si la valeur entrée correspond au critère, le texte Correspond(Match) apparaît près de la valeur entrée, sinon Ne correspond pas (No match) apparaît.

Actions

Action que hMailServer doit prendre lorsqu'un message correspond au critère d'une règle.·Supprimer le message - Le message sera supprimé et non distribué au destinataire·Transférer le message - Transfère le message à l'adresse spécifiée. Le message sera toujoursdistribué au destinataire d'origine·Déplacer dans un dossier IMAP - Déplace le message dans le dossier IMAP spécifique. Nes'applique que si la distribution est locale. Si le dossier n'existe pas, il sera créé.·Répondre - Répond à l'expéditeur avec le message spécifié

hMailServer - Guide de l'Utilisateur

66 / 214

·Exécuter la fonction - Exécute la fonction d'un fichier script de hMailServer.Cette fonction doit prendre un objet hMailServer.Message comme paramètre, par exemple SubOnSomething(oMessage).·Définir la valeur de l'en-tête - Cette action vous permet de créer ou de modifier une valeur d'en-tête existant.·Arrêter le traitement de la règle - Cette action annule les règles restantes.·Envoyer via l'itinéraire - Normalement, hMailServer utilise les adresses des destinataires pourdéterminer si oui ou non un itinéraire doit être utilisé. Avec cette action de règle, vous pouvezcontourner ce comportement par défaut. Comme exemple, vous pouvez définir une règle quidemande à hMailServer d'envoyer tout le courrier adressé à un domaine spécifique vers un autreserveur.

Remarques

1.Il est possible de spécifier les macros %YEAR%, %MONTH% et %DAY% comme paramètres dunom de dossier si l'action Déplacer dans un dossier IMAP a été choisie.2.Lors de la recherche des valeurs de champs d'en-tête, une chaîne vide sera traitée de la mêmefaçon qu'un en-tête inexistant. Ainsi, si vous créez une règle qui supprimera les messages si leSujet est vide, elle supprimera aussi les lignes dont l'en-tête Sujet n'existe pas.3.Un message possède, normalement, deux listes de destinataires. Savoir ceci est très importantlors de la définition des règles pour filtrer les listes d'en-tête A et de Destinataires.

La première liste est la liste destinataires MIME. Cette liste de destinataires est celle que vousvoyez dans votre client de messagerie, dans les en-têtes A et CC. La seconde liste est celle del'enveloppe MIME - l'enveloppe MIME contient les adresses vers lesquelles le courrier seradistribué. Normalement, il n'est pas possible de voir cette liste dans le client de messagerie. Ce quisignifie qu'un message peut être envoyé à une adresse, mais qu'il contient aussi d'autresdestinataires dans les en-têtes A et CC. Exemple courant: vous envoyez un message et vousplacez quelqu'un dans le champ BCC. L'adresse entrée dans le champ BCC sera ajoutée à la listedes adresses de l'enveloppe SMTP, mais ne sera pas ajoutée aux en-têtes MIME.

Lorsque hMailServer transfère un courrier, la liste Destinataires (de l'enveloppe SMTP) estactualisée. Mais pas la liste Destinataire des en-têtes MIME. Ce qui signifie que le destinataire quireçoit le message transféré verra les destinataires d'origine dans son client de messagerie.

De même, si un message est placé dans un compte, la liste Destinataire est effacée pouréconomiser l'espace disque. Ainsi, lorsque les règles de niveau du compte est exécutée, la listeDestinataires sera purgée et ne pourra pas être vérifiée.

Exemples de règle

Exemple 1, Supprimer les messages

Supprimer automatiquement tous les messages dont le sujet contient le mot SPAM

1.Lancez hMailAdmin, et choisissez l'onglet Règles dans l'arborescence de gauche, sous Domaines2.Cliquez sur Ajouter. Entrez le nom MaRègle3.Dans Critère, cliquez sur Ajouter.4.Dans le Champ Prédéfini, sélectionnez Sujet5.Dans Type de recherche, choisissez Contient.6.Dans le champ de saisie Valeur, entrez le mot SPAM7.Cliquez sur Enregistrer pour ajouter le critère à la règle.8.Dans Actions, cliquez sur Ajouter.9.Choisissez Suprimer le message dans la liste déroulante10.Cliquez sur Enregistrer pour enregistrer l'Action11.Cliquez à nouveau sur EEnregistrer pour enregistrer la règle

Exemple 2, Transférer les messages

transférer tous les messages distribués à une adresse de messagerie externe. Le messaged'origine sera toujours distribué normalement. Ne créez pas une règle qui envoie le message àvous-même, car cela provoquerait une boucle sans fin.

1.Lancez hMailAdmin et accédez à la configuration du compte.

hMailServer - Guide de l'Utilisateur

67 / 214

2.Sélectionnez l'onglet Règles.3.Cliquez sur Ajouter. Entrez le nom RegleTransfert4.Dans Critère, cliquez sur Ajouter.5.Dans le Champ prédéfini, choisissez Taille du message6.Dans Type de recherche, choisissez Supérieur à.7.Dans le champ de saisie Valeur, entrez la valeur 0. Tous les messages dont la taille dépasse 0octets seront affectés par la règle.8.Cliquez sur Enregistrer pour ajouter le critère à la règle.9.Dans Actions, cliquez sur Ajouter.10.Choisissez Transférer les messages dans la liste déroulante. Entrez l'adresse externe verslaquelle transférer les messages.11.Cliquez sur Enregistrer pour enregistrer cette Action12.Cliquez à nouveau sur Enregistrer pour enregistrer la règle complète

Exemple 3, délacer les messages dans un dossier IMAP

Déplacer tous les messages d'un expéditeur spécifique vers un dossier IMAP spécifique

1.Lancez hMailAdmin et accédez à la configuration du compte.2.Sélectionnez l'onglet Règles.3.Cliquez sur Ajouter. Entrez le nom RègleDéplacer4.Dans Critère, cliquez sur Ajouter.5.Dans Champ prédéfini, choisissez De6.Dans Type de recherche, choisissez Contient.7.Dans le champ de saisie Valeur, entrez le valeur [email protected]. Tous les messagescontenant [email protected] du champ de l'en-tête De seront affectés par la règle.8.Cliquez sur Enregistrer pour ajouter le critère à la règle.9.Dans Actions, cliquez sur Ajouter.10.Choisissez Déplacer vers le dossier IMAP dans la liste déroulante. Entrez le nom du dossier IMAPdans lequel s'effectuera le déplacement.11.Cliquez sur Enregistrer pour enregistrer l'Action12.Cliquez à nouveau sur Enregistrer pour enregistrer la règle complète

Exemple 4, actualiser le Sujet d'un message

Le didacticiel suivant vous apprend à savoir appeler un script VBA en fonction du contenu dumessage. Il vous montre comment actualiser le Sujet d'un message en fonction de la taille ducelui-ci.

Configurer la règle

1.Lancez hMailServer Administrator2.Choisissez Règles3.Cliquez sur Ajouter. Entrez le nom RègleTaille4.Dans Critère, cliquez sur Ajouter.5.Dans Champ prédéfini, choisissez MessageSize6.Dans Type de recherche, choisissez Supérieur à.7.Dans le champ de saisie Valeur, entrez la valeur 4000. Tous les messages supérieurs à 4000octets seront affectés par cette règle.8.Cliquez sur Enregistrer pour ajouter le critère à la règle.9.Dans Actions, cliquez sur Ajouter.10.Choisissez Exécuter la fonction dans la liste déroulante. Entrez le nom OnSizeRule11.Cliquez sur Enregistrer pour enregistrer l'Action12.Cliquez à nouveau sur Enregistrer pour enregistrer la règle complète

Créer 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

hMailServer - Guide de l'Utilisateur

68 / 214

   oMessage.SaveEnd Sub

Activer le script dans hMailServer

1.Lancez hMailServer Administrator2.Accédez à Configuration, Avancé, Scripts3.Cliquez sur Vérifier la syntaxe pour confirmer que celle-ci est correcte4.Sélectionnez Activer5.Cliquez sur Enregistrer pour activer le script.

Scripts

Généralités

hMailServer vous permet d'écrire vos propres scripts pour étendre la fonctionnalité du serveur. Laprise en charge pour Microsoft VBScript et Microsoft JScript existe actuellement sur le serveur. Voustrouverez, sur hMailServer.com,, des modèles de script utiles, écrits en VBScript. Pour la syntaxede script générale, consultez la bibliothèque Microsoft MSDN.

Tous les scripts hMailServer sont à pplacer dans un fichier nnommé EventHandlers.vbs. Voustrouverez ce fichier dans le dossier Events de hMailServer, normalement C:\Program Files\hMailServer\Events.

hMailServer propose les événements prédéfinis suivants:

Événement But Implémenté dans

OnBackupCompleted Exécuté si une sauvegarde aréussi.

4.2

OnBackupFailed Exécuté si une sauvegarde aéchoué.

4.2

OnClientConnect Exécuté si un client estconnecté.

4.0

OnAcceptMessage Exécuté si un message a étédistribué au serveur utilisantle protocole SMTP.

4.0

OnDeliveryStart Exécuté directement si ladistribution d'un message adébuté avant l'exécution detoute règle.

4.4

OnDeliverMessage Exécuté si un message est encours de distribution. Exécutéaprès l'exécution des règlesgénérales, mas avant lesrègles de niveau du compte.

4.0

OnDeliveryFailed Exécuté si la distribution d'unmessage a échoué

5.0

OnExternalAccountDownload Exécuté si un message a été 5.3

hMailServer - Guide de l'Utilisateur

69 / 214

téléchargé à partir d'uncompte POP3 distant.

OnError Exécuté si une erreur s'estproduite dans hMailServer.

5.0

Configuration

Suivez ces étapes pour activer le script:

·Lancez hMailServer Administrator·Accédez à Configuration->Avancé->Scripts·Sélectionnez Activé·Cliquez sur Enregistrer pour enregistrer les modifications

Dès que vous modifiez le fichier de script, vous devez cliquer sur Recharger le script pour quehMailServer rafraîchisse, enregistre les changements. hMailServer conserve un exemplaire de latotalité du script en mémoire, ce qui améliore la performance.

 

OnAcceptMessage

Signature

OnAcceptMessage(oClient as hMailServer.Client, oMessage as hMailServer.Message)

Valeurs résultantes

·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 définie.

Exemples

Authentification requise pour les expéditeurs locaux

La fonctionnalité d'authentification SMTP intégrée vérifie seulement l'adresse de l'expéditeur pourdéterminer si l'authentification SMTP est requise. Souvent, il vous faut aussi vérifier l'adresse del'expéditeur. Le script suivant nécessite une authentification de la part de hMailServer, si l'adressedes expéditeurs 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 envoyezdepuis le domaine local."            Result.Value = 2         End If      End If        End Sub

hMailServer - Guide de l'Utilisateur

70 / 214

Refus des messages supérieurs à une taille donnée.

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 exécuté avant que hMailServer accepte le message et qu'il l'enregistredans la base de données. Ce qui signifie que vous ne pouvez pas accéder à l'ID du message decet événement.

OnBackupCompleted

Signature

Sub OnBackupCompleted()

Valeurs résultantes

Aucune

OnBackupFailed

Signature

Sub OnBackupFailed()

Valeurs résultantes

Aucune

OnClientConnect

Signature

OnClientConnect(oClient as hMailServer.Client)

Description

hMailServer - Guide de l'Utilisateur

71 / 214

Cet événement est déclenché directement après qu'une connexion TCP/IP ait été ouverte vershMailServer. L'événement est déclenché avant l'ouverture de session de l'utilisateur, ce qui signifieque la propriété oClient.Username retournera une chaîne vide.

Valeurs résultantes

·0 - hMailServer accepte la connexion·1 - hMailServer refuse la connexion

Exemples

VB-script:[]

OnDeliverMessage

Signature

OnDeliverMessage(oMessage as hMailServer.Message)

Valeurs résultantes

·0 - Distribuer le message·1 - Ne pas distribuer le message

Exemples

VB-script:[]

OnDeliveryFailed

Généralités

Cet événement est exécuté si la distribution au destinataire échoue. Si un courrier pour plusieursdestinataires ne peut pas être envoyé, l'événement est exécuté une fois pour chaquedestinataire.

Signature

OnDeliveryFailed(oMessage, sRecipient, sErrorMessage)

Paramètres

·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 déclenché l'échec de la distribution

Valeurs résultantes

·Aucune

hMailServer - Guide de l'Utilisateur

72 / 214

OnDeliveryStart

Généralités

Cet événement est exécuté directement lorsque la distribution d'un message a débuté.L'événement est exécuté avant l'exécution de toute règle générale

Signature

OnDeliveryStart(oMessage as hMailServer.Message)

Valeurs résultantes

·0 - Distribuer le message·1 - Ne pas distribuer le message

Exemples

VB-script:[]

OnError

Généralités

Cet événement est exécuté si une erreur se produit dans hMailServer.

Signature

OnError(iSeverity, iCode, sSource, sDescription)

Parameters

·iSeverity - Sévérité de l'erreur. 1 - Critique, 2 - Élevée, 3 - Moyenne, 4 - Faible·iCode - Le code d'erreur hMailServer.·sSource - Le composant qui a rapporté l'erreur.·sDescription - Une description de l'erreur rapportée.

Valeurs résultantes

·Aucune

OnExternalAccountDownload

Généralités

Cet événement est exécuté si un message a été téléchargé àà partir d'un compte externe àhMailServer.

hMailServer - Guide de l'Utilisateur

73 / 214

Signature

Sub OnExternalAccountDownload(oFetchAccount, oMessage, sRemoteUID)

Paramètres

·oFetchAccount - Le compte externe à partir duquel le message a été téléchargé.·oMessage - Le message qui a été léléchargé. Si le message a déjà été téléchargé, ce paramètresera Nothing / Null. ·sRemoteUID - L'UID du message sur e serveur distant.

Valeurs résultantes

A l'aide de l'objet Result, il est possible de définir si hMailServer doit supprimer le message duserveur distant ou non. Définissez les valeurs ci-dessous sur la variable Result.Value.

·1  -Supprimer immédiatement le message du serveur distant.·2  - Supprimer le message après le nombre de jours spécifié. Réglez le nombre de jours sur lavariable Result.Parameter.·3  -Ne jamais supprimer le messages sur le serveur distant.

Notez que les messages téléchargés seront encore distribués. Les paramètres ci-dessusn'affectent que la suppression ou non des messages sur le serveur distant.

 

 

Message du serveur

Général

Utilisez ces réglages pour changer les messages d'erreur et d'informations créés par hMailSever.

Nom

Le nom du message du serveur à modifier.

Texte

Le texte du message du serveur.

Envoi du serveur

Envoyer à

Sélectionnez les destinataires auxquels envoyer le message. Vous ne pouvez envoyer qu'auxcomptes du serveur.

E-mail

Spécifiez le contenu du message. Seul un texte et non un HTML est autorisé dans le champ Corps.

hMailServer - Guide de l'Utilisateur

74 / 214

Configuration

A la section Configuration de hMailServer Administrator, vous pouvez régler différentes parties ducomportement de hMailServer. Bien que les paramètres par défaut fonctionnent sur denombreuses installations, vous pouvez les modifier pour activer l'anti-spam, la journalisation ourégler finement les paramètres de performance.

Configuration SMTP

Général

Connexion

Le nombre maximum de connexions SMTP simultanées au serveur. Si cette valeur est réglée surzéro, un nombre illimité de connexions sera autorisé. Par défaut, cette valeur est réglée sur zéro.

Message d'accueil

Le message d'accueil est envoyé directement aux clients SMTP clients après qu'ils se soientconnectés au serveur. Ce message n'est généralement jamais vu par l'expéditeur ou ledestinataire. Une des raisons pour modifier le message d'accueil est de rendre la difficile, pour lesautres utilisateur, la détection du logiciel serveur utilisé.

Taille maximum d'un message

Si une Taille Maximum de Message est spécifiée, hMailServer refusera tout message supérieur àcette taille. Si vous souhaitez autoriser les messages d'une taille illimitée, réglez cette valeur surzéro. La taille est spécifiée 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, pourraientenvoyer un message si volumineux qu'il remplirait le disque dur du serveur, ce qui déclencherait uncomportement imprévisible. La taille maximum par défaut d'un message est de 20Mo.

Distribution d'un message

Nombre de tentatives

Ce réglage définit le nombre de fois que hMailServer devra essayer d'envoyer un message. Ladistribution peut échouer pour de nombreuses raisons. Le serveur de messagerie du destinatairedu courrier, par exemple, est peut-être en cours de réinitialisation, ou votre réseau peut êtretemporairement indisponible. La valeur par défaut est de 4 tentatives, ce qui signifie quehMailServer essaiera 5 fois au total avant d'abandonner et de renvoyer un message d'erreur àl'expéditeur.

Minutes entre chaque tentative

Ce réglage définit le nombre de minutes que hMailServer devra attendre avant chaque tentative,lors de la distribution des messages aux autres serveurs. La valeur par défaut est 60 minutes.

Nom d'hôte

Lorsqu'un serveur SMTP se connecte à un autre serveur pour envoyer un message, la premièrechose qui se passe, c'est que le serveur d'envoi s'identifie lui-même en utilisant le nom d'hôte.Comme il n'existe aucun moyen de détecter automatiquement en toute sécurité le nom d'hôte d'unordinateur, vous devez spécifier ce paramètre manuellement. Le nom d'hôte doit résoudrel'adresse IP de l'ordinateur qui exécute hMailServer. Certains serveurs valideront ceci et classeront

hMailServer - Guide de l'Utilisateur

75 / 214

votre e-mail comme un spam si l'adresse IP n'est pas résolue correctement.

Peu importe le nom d'hôte que vous saisissez, tant qu'il résout l'adresse IP où s'exécutehMailServer. Vous pouvez avoir 15 noms d'hôte différents qui résolvent l'adresse IP sous laquelles'exécute hMailServer. Si c'est le cas, vous pouvez entrer l'un de ces 15 noms d'hôte dans lechamp Nom d'hôte.

Exemple: Si hMailServer s'exécute sur une machine dont le nom d'hôte est mail.domain.com, vouspouvez spécifier mail.domain.com comme nom d'hôte. Si votre machine a plusieurs noms d'hôtepublics, comme mail.domain.com et mail.domain2.com, vous pouvez spécifier l'un d'entre euxcomme nom d'hôte.

Relais SMTP

Le paramètre Relais SMTP vous permet de spécifier à quel serveur de messagerie les massagesseront distribués. Vous ne devez jamais régler cette valeur sur "localhost" ou sur le nom d'hôte devotre propre serveur de messagerie. hMailServer essaierait alors de se connecter à lui-même.

Lorsqu'un serveur SMTP distribue un courrier à un autre, la recherche MX DNS est normalementutilisée. Ce qui signifie que si vous m'envoyez un message, à [email protected], votreserveur de messagerie effectuera une recherche MX pour mon domaine, hmailserver.com. Laréponse MX indiquera à votre serveur qu'il devra distribuer le courrier à mail.hmailserver.com. Lacommunication s'établit via le port 25. Cependant, il peut arriver que votre FAI bloque le traficsortant sur le port SMT (25) vers tous les ordinateurs sauf vers leur propre serveur demessagerie. Vous ne pourriez, par conséquent, vous connecter à mail.hmailserver.com. Dans cecas, configurez hMailServer pour qu'il envoie tout le courrier via le serveur de messagerie de votreFAI. Le serveur de messagerie de votre FAI sera alors votre relais . La valeur à entrer dans lachamp Relais est le nom du serveur de messagerie de votre FAI. par exemple, si vous utilisez lefournisseur de service à haut débit Suédois Bredbandsbolaget, entrez smtp.bredband.net commerelais SMTP.

Si vous ne souhaitez pas relayer tous les courriers sortants via un serveur SMTP spécifique, cechamp 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

Sélectionnez cette option si le serveur spécifié comme relais SMTP nécessite une authentification.

Utiliser SSL

Sélectionnez cette option si vous souhaitez que hMailServer utilise le cryptage SSL lors de laconnexion au serveur relais SMTP. Notez que le serveur relais SMTP doit être configuré pourutiliser 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 texteclair est autorisée.

Autoriser une adresse d'expéditeur vide

Certains spammeurs envoient du courrier avec une adresse d'expéditeur vide. Si vous désactivezcette option, hMailServer traitera ces messages comme des spams. Cependant, certainsmessages légitimes ont également des adresses d'expéditeur vides, et il est donc vivementconseillé de ne pas désactiver cette option.

hMailServer - Guide de l'Utilisateur

76 / 214

Autoriser les fins de ligne formatées

Selon la spécification SMTP, chaque ligne d'un message doit être séparée par les codes ASCII 13et 10. Certains spammeurs envoient des messages qui ne sont pas formatés correctement.Utilisez ce réglage pour refuser ces messages. Notez que des messages légitimes peuvent avoirété incorrectement formatés en fin de lignes, si le logiciel de distribution contient des bugs.

Déconnecter le client après trop de commandes non valides

Avec ce réglage, vous pouvez déconnecter les clients qui envoient trop de commandes nonvalides. Certains spammeurs, par exemple, essaient d'envoyer du courrier à de nombreusesadresses différentes de votre serveur, en espérant que celui-ci acceptera au moins l'un d'entreeux. Avec cette option, vous pouvez déconnecter automatiquement les clients qui se comportentde la sorte.

Avancé

Lier à l'adresse IP locale

Utilisez cette option pour spécifier l'adresse IP locale que hMailServer doit utiliser lors d'uneconnexion ux autres serveurs SMTP. Ce qui peut être utilisé si votre serveur a plusieurs adressesIP publiques, mais que vous souhaitez n'en utiliser qu'une seule pour les distributions. Si ceréglage n'est pas spécifié, hMailServer utilisera l'option par défaut de Windows qui fonctionnedans 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 pourun seul courrier. Ce qui peut se produire si le serveur SMTP de réception pense que votre courrierest un spam du fait que vous l'envoyez à un trop grand nombre d'utilisateurs. Utilisez ceparamètre pour limiter le nombre de destinataires que hMailServer utilise pour une mêmedistribution. Lorsque cette valeur a été atteinte, hMailServer se déconnecte du serveurdestinataire, se reconnecte et continue avec les destinataires restants.

Ajouter l'en-tête Distribué À

Si cette option est sélectionnée, hMailServer ajoutera un en-tête Distribué A à tous lesmessages. Cet en-tête contiendra les adresses des destinataires fournies dans l'enveloppe SMTPlors de la communication SMTP.

Régler le nombre de boucles

Cette option vous permet d'empêcher hMailServer de créer des messages délivrés en boucle sansfin. Exemple: Il est possible de créer une règle de compte qui transfère les messages d'unutilisateur A à un autre B, et une autre règle qui transfère à nouveau les messages de l'utilisateurB à l'utilisateur A. Pour éviter que ceci produise une boucle sans fin, hMailServer limite le nombrede transferts automatiques à la valeur définie par la Règle du nombre de boucles (hMailServer 4.2 etsupérieur).

 

Certificat SSL

Généralités

hMailServer 5 possède une prise en charge intégrée pour SSL. Ce qui signifie qu'après avoirobtenu un certificat SSL, vous pouvez crypter le trafic de messagerie entre vous et vosutilisateurs. Le trafic de messagerie normal sur Internet consiste à envoyer des messages non

hMailServer - Guide de l'Utilisateur

77 / 214

cryptés, ce qui signifie que le courrier est souvent lisible par des tiers. Si, par exemple, unutilisateur de réseau sans fil non crypté envoie un message, d'autres personnes peuventintercepter le trafic sans fil et lire le message. Autres exemples: les Fournisseurs d'Accès àInternet qui analysent les communications de messagerie de leurs utilisateurs et la curiosité desagences gouvernementales.

Obtenir un certificat SSL

Il existe deux méthodes pour obtenir un certificat SSL. Vous pouvez acheter un certificatSSL auprès d'une autorité de certification, ou créer votre propre certificat auto-signé. Acheter uncertificat auprès d'une autorité de certification procure généralement une sécurité plus élevée quela création d'un certificat auto-signe.

Les clients de messagerie ne sont pas configurés pour faire confiance à des certificats auto-signés. Ce qui signifie que si vous utilisez un certificat auto-signé, une boîte de dialogued'avertissement sera affichée lors de votre connexion au serveur. Dans de nombreux demessagerie, vous pouvez choisir d'ignorer l'avertissement et encore vous connecter. C'est laraison pour laquelle il est préférable d'acheter un certificat auprès d'une autorité de certification.

Il existe de très nombreuses sociétés qui vendent des certificats SSL et que vous trouverez viaGoogle. Si vous préférez créer votre propre certificat SSL, le plus simple est d'utiliser OpenSSL. 

Acheter un certificat SSL comprend généralement les étapes suivantes:

1.Vous générez une clé privée en utilisant OpenSSL.2.Vous générez une requête de signature de certificat en utilisant OpenSSL.3.Vous supprimer le mot de passe clé de la clé privée.4.Vous commandez un certificat auprès de l'autorité de certification et vous leur fournissez unerequête de signature de certificat.5.L'autorité de certification vous envoie le certificat.6.Vous configurez hMailServer pour utiliser la clé privée et le certificat SSL.

Créer un certificat SSL auto-signé comprend les étapes suivantes:

1.Vous générez une clé privée en utilisant OpenSSL.2.Vous générez une requête de signature de certificat en utilisant OpenSSL.3.Vous supprimer le mot de passe clé de la clé privée.4.A l'aide de OpenSSL, vous générez le certificat auto-signé.5.Vous configurez hMailServer pour utiliser le clé privée et le certificat SSL.

Configurer hMailServer pour utiliser un certificat SSL

Deux tâches liées sont nécessaires à la configuration de hMailServer pour qu'il utilise un certificatSSL:

Ajouter le certificat SSL à hMailServer

1.Lancez hMailServer Administrator2.Accédez à Configuration->Avancé->Certificat SSL3.Cliquez sur Ajouter4.Entrez un nom de certificat SSL. Ces era un nom de votre choix, mais nous vous conseillons de ledéfinir par le nom d'hôte du certificat SSL.5.Sélectionnez le fichier certificat et une clé privée déposée.6.Enregistrez les changements

Après avoir suivi ces étapes, hMailServer connaît le certificat SSL, mais vous devez aussi luiindiquer quand l'utiliser.

Configurer hMailServer pour utiliser le certificat SSL

1.Lancez hMailServer Administrator2.Accédez à Configuration->Avancé->ports TCP/IP3.Sélectionnez un port 4.Sélectionnez "Utiliser SSL" et le certificat.5.Enregistrez les changements6.Redémarrez hMailServer

hMailServer - Guide de l'Utilisateur

78 / 214

Ainsi, tout le trafic sur ce port sera crypté à l'aide du certificat. Normalement vous aurez à ajouterun port TCP/IP supplémentaire à hMailServer et à sélectionnez l'utilisation SSL pour ce port. Notezque tous les clients se connectant au port doivent être configurés pour utiliser SSL.

Configurer les clients

Après avoir configuré hMailServer pour utiliser les certificats SSL, vous devez aussi configurer lesclients. Ce qui implique à la fois d'accéder aux paramètres du compte du client de messagerie etde sélectionner l'utilisation SSL du serveur.

Si vous souhaitez que la communication SMTP entre vous et vos utilisateurs soit cryptée, vousdevez configurer le port TCP/IP pour que SMTP utilise SSL. Cependant, comme les autres serveursde messagerie qui distribuent le courrier à hMailServer ne savent pas que SSL est requis, vousdevez créer un second port TCP/IP pour SMTP et le configurer pour utiliser SSL. Après cela, vousdevez reconfigurer les clients pour qu'il se connectent à ce nouveau port TCP/IP et qu'ils utilisentSSL. Ainsi, les autres serveurs de messagerie continueront à distribuer le courrier non crypté sur leport 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 sécurité

Lorsque hMailServer se connecte à un autre serveur utilisant SSL (lors d'une distribution SMTP oud'un téléchargement à partir d'un compte externe), il ne vérifie pas les certificats SSL desserveurs. Ce qui signifie que la communication entre le client et le serveur est cryptée et ainsimoins ouverte pour l'écoute que les connexions non cryptées. Mais quelqu'un qui se trouve être lacible d'une attaque est toujours vulnérable car hMailServer ne vérifie pas qu'il communique avec lebon serveur.

Pour que hMailServer vérifie le certificat des serveurs, vous devez suivre quelques étapes:

1.Déterminez l'autorité de certification qui a fournie le certificat du serveur auquel vous vousconnectez. Ce que vous ferez avec la commande:openssl s_client -connect ${URL}:${PORT}Exemple:openssl s_client -connect pop.gmail.com:995L'autorité sera énumérée à la fin de la chaîne du certificat.2.Récupérez le certificat auprès de l'autorité de certification. Ce qui peut être fait en contactantl'autorité de certification ou en l'exportant à partir de votre navigateur web local. Firefox inclut lescertificats de la plupart des autorités de certification importantes. Le fichier de certificat doit êtreau format PEM.3.Calculez le hachage du certificat. Vous pouvez le faire via la commande:openssl x509 -in "C:\path\to\ca.pem"  -hashLa première ligne montrera le hachage du fichier. Exemple: le hachage pour Equifax Secure CA est594f1775.4.Renommez le fichier PEM de certificat pour <hash>.0 (le nom du fichier doit être hash etl'extension 0 (un zéro). 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.Redémarrez le service hMailServer.

Après ces étapes, hMailServer essaiera toujours de vérifier les certificat du serveur lors desconnexions à un port de serveur SSL. Si la vérification échoue, hMailServer abandonnera laconnexion. Notez que cela se produit pour tous les ports SSL et pas seulement pour ceux surlesquels vous avez installé un certificat.

Pour plus de sécurité, vous pouvez définir des autorisations pour le fichier de certificat de sorteque seul le service de hMailServer peut y accéder.

Configuration

hMailServer - Guide de l'Utilisateur

79 / 214

Nom

Le nom du certificat SSL. Le nom n'est utilisé que pour l'affichage et ne doit avoir aucune relationavec le certificat SSL.

Fichier certificat

Le fichier de certificat à utiliser.

Fichier de clé privée

Le fichier de clé privée à utiliser.

hMailServer sera incapable de lire la clé privée si elle contient un mot de passe. Assurez-vousd'avoir supprimé le mot de passe de la clé avant de configurer hMailServer pour qu'il utilise lefichier

État

Généralités

La boîte de dialogue État vous fournit des informations sur l'état en cours de votre installationhMailServer.

Serveur

A la section Serveur, vous pouvez lancer ou arrêter le serveur hMailServer, voir la version actuellede hMailServer et les informations sur la base de données. Si vous lancez ou arrêtez le serveur àpartir de cette boîte de dialogue, en fait vous ne lancez pas ni n'arrêtez pas le service du serveuractuel. Même si vous cliquez sur Stop, le service hMailServer continuera à s'exécuter. Autrementdit, le serveur s'arrête, pas le service. Le service est le fichier exécutable, hMailServer.exe, alorsque le serveur est le sous-composant de l'exécutable, celui qui accepte la connexion des clients.

Sous Avertissements de Configuration, vous verrez une liste des problèmes de configuration quel'auto-test de hMailServer Administrators a détectés. La plupart d'entre eux sont des problèmesque vous aurez à résoudre dès que possible.

État

La section État affiche des informations tels que le moment où le serveur a été lancé, le nombrede messages traités et le nombre de sessions actuellement actives pour les différents protocoles.Notez que le compteur de messages augmente à mesure que le courrier est traité (il ne décroitjamais) alors que le nombre de sessions ouvertes décroit à mesure que les clients sedéconnectent du serveur.

·Messages traités

Il s'agit du nombre de messages que hMailServer a accepté de distribuer et a commencé àdistribuer. Ils ont été distribués à hMailServer par un client SMTP, ou téléchargés d'un comptePOP3 externe, ou créés directement dans la base de données hMailServer ou en utilisant le API. ·Virus détectés (avant: Messages contenant un Virus)

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

hMailServer - Guide de l'Utilisateur

80 / 214

Il s'agit du nombre total de messages que hMailServer a détecté comme contenant un spam. Cesmessages peuvent avoir été distribués aux destinataires, en fonction de la configuration duserveur. Si, par exemple, hMailServer est configuré pour abandonner tous les spamsimmédiatement, le décompte peut être supérieur au nombre de messages traités.

Journalisation

En utilisant le journal en temps réel, vous pouvez voir ce qui se passe au niveau de votreinstallation de hMailServer sans être obligé d'ouvrir manuellement le journal. Le journal en tempsréel est principalement utilisé pour le dépannage. Pour utiliser le journal, accédez d'abord à sesparamètres et activez les options de détails que vous souhaitez enregistrer. Ensuite, ouvrez cettesection et cliquez sur Démarrer. Dès que quelque chose est ajouté au journal, elle apparaîtautomatiquement 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 êtredistribués. Les tâches suivantes peuvent être effectuées:

·Rafraîchir - La liste affichée est un instantané de l'instant où vous ouvrez cette section. Si vousattendes quelques minutes, plusieurs messages auront été distribués. Pour afficher un nouvellinstantané, cliquez sur Rafraîchir.·Effacer le file d'attente - Choisissez Effacer le file d'attente pour effacer tous les messages de lafile d'attente de distribution. Les messages actuellement en cours de distribution peuvent encoreêtre distribués, en fonction de l'état précis du moment.·Afficher (clic droit dans la liste) - Choisissez cette option pour afficher une nouvelle boîte dedialogue 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'attentepour un envoi immédiat. Ce qui signifie que si un processus de distribution est disponible, celle-cisera effectuée immédiatement. Sinon, l'envoi débutera dès qu'un processus de distribution estdisponible.·Effacer (clic droit dans la liste). Cette option effacera le message de la file d'attente dedistribution.

Serveurs SURBL

Général

Hôte DNS

L'hôte DNS que hMailServer doit demander lors d'une recherche SURBL.

Message de refus

Le message que hMailServer enverra à l'expéditeur si un courrier est refusé.

Port TCP/IP

Port TCP/IP

Protocole

Choisissez le protocole à utiliser pour ce port spécifique. Si un client se connecte au port,hMailServer utilisera ce protocole pour analyser les commandes entrantes du client.

hMailServer - Guide de l'Utilisateur

81 / 214

Adresse TCP/IP

Spécifiez l'adresse TCP/IP que hMailServer doit surveiller. La valeur par défaut, 0.0.0.0, signifie quehMailServer doit surveiller toutes les adresses IP disponibles.

Port TCP/IP

Le nombre de ports que hMailServer doit surveiller pour l'adresse IP spécifiée.

Utiliser SSL

Sélectionnez cette option si vous souhaitez que les transmissions entre le client et hMailServersoient cryptées. Si SSL est activé, toutes les communications avec hMailServer via ce portnécessitent d'être effectuées en utilisant SSL. hMailServer ne prend pas en charge STARTTLS.

Certificat SSL

Si vous avez choisi d'utiliser SSL, vous devez sélectionner le certificat SSL à utiliser pour ce portspécifique.

 

Utilitaires

Utilitaires

La section Utilitaires contient les éléments qui peuvent être considérés comme des outils de priseen charge pour l'installation de votre hMailServer.

Accueil

Accueil

Lorsque vous lancez hMailServer Administrator, une fenêtre d'Accueil apparaît pour vous aider àcréer votre premier domaine dans hMailServer.

Liste blanche

Général

hMailServer propose de nombreuses fonctionnalités anti-spam. Dans certains cas, vous aurezprobablement besoin que certains expéditeurs les contournent. Si, par exemple, une certaineadresse IP a été placée en liste noire par erreur, et que vous souhaitez recevoir son courrier.Autre exemple: vous attendez un courriel d'un expéditeur spécifique, et vous ne voulez pasrisquer de perdre ce courriel s'il est classé comme spam.

Pour ce faire, vous pouvez ajouter des enregistrement de liste blanche à la configuration. SihMailServer reçoit le courriel d'une source qui correspond à l'un de ces enregistrements,hMailServer n'essaiera pas de déterminer s'il s'agit d'un spam. Pour ajouter un enregistrement deliste blanche, lancez hMailServer Administrator, et accédez à Configuration, Protection anti-spam,Liste Blanche. Pour chaque enregistrement de liste blanche, vous pouvez entrer une description,une dresse IP inférieure et supérieure et une adresse de messagerie.

hMailServer - Guide de l'Utilisateur

82 / 214

Avant de traiter la protection anti-spam, hMailServer détermine l'adresse IP de l'expéditeur.Lorsque c'est fait, hMailServer parcourt la liste blanche. Si un enregistrement correspond àl'adresse IP est détecté, hMailServer vérifie si l'adresse de messagerie spécifiée dans la listeblanche correspond. Si c'est le cas, la protection anti-spam est ignorée pour ce courriel.

Exemples

Exemple 1: Placer en liste blanche tous les messages de [email protected]:

1.Cliquez sur Ajouter pour ajouter un nouvel enregistrement à la liste blanche2.Dans le champ Description, spécifiez "Liste blanche de [email protected]"3.Dans le champ Adresse e-mail, spécifiez [email protected] sur Enregistrer.

Désormais, un enregistrement est ajouté. Notez que la plage IP pour cet enregistrement estréglée sur 0.0.0.0 - 255.255.255.255. Ce qui signifie que le courrier provenant [email protected] contournera la protection ant-spam, sans tenir compte de l'origine de l'adresseIP.

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 expéditeursd'un domaine spécifié.

1.Cliquez sur Ajouter pour ajouter un nouvel enregistrement de liste blanche2.Dans le champ Description, spécifiez "Placer tout example.com en liste blanche"3.Dans le champ Adresse e-mail, indiquez *@example.com.4.Cliquez sur Enregistrer.

Exemple 3: Placer en liste blanche tous les courriels envoyés du domaine example.com, du réseaulocal (192.168.0.*)

1.Cliquez sur Ajouter pour ajouter un nouvel enregistrement de liste blanche2.Dans le champ Description, entrez "Réseau Local"3.Dans le champ IP inférieur, saisissez  192.168.0.14.Dans le champ IP supérieur, saisissez 192.168.0.255.5.Dans le champ Adresse e-mail, indiquez *@example.com.6.Cliquez sur Enregistrer.

 

Exemple 4: Placer en liste blanche tous les courriels envoyés du réseau local (192.168.0.*)

1.Cliquez sur Ajouter pour ajouter un nouvel enregistrement de liste blanche2.Dans le champ Description, entrez "Réseau Local"3.Dans le champ IP inférieur, saisissez  192.168.0.14.Dans le champ IP supérieur, saisissez 192.168.0.255.5.Cliquez sur Enregistrer.

Désormais, un enregistrement est ajouté. Notez que l'adresse e-mail de cet enregistrement estréglée sur *. Ce qui signifie que hMailServer ignorera la protection anti-spam pour tout le courrieroriginaires du réseau local, peu importe l'expéditeur.

Remarques

·Vous pouvez utiliser les jokers dans la partie adresse de messagerie des enregistrements deliste blanche. Vous pouvez les utiliser, par exemple dans la liste blanche:

o pour un domaine entier - *@example.como pour une boîte aux lettres spécifique, par exemple sales de tous les domaines - sales@*.o pour les edresses contenant des mots spécifiques, comme "support" - *support*

En d'autres termes, vous pouvez utiliser le * à n'importe quel endroit d'une adresse demessagerie.

·Il n'est pas possible d'utiliser les jokers dans une adresse IP.·Si vous avez sélectionné "Relais de transfert" dans la plage IP à partir de laquelle l'expéditeur seconnecte, hMailServer utilisera l'es en-têtes Reçu du message pour déterminer l'adresse IP dumessage d'origine.

hMailServer - Guide de l'Utilisateur

83 / 214

Configuration

Description

Description textuelle des enregistrements de la liste blanche.

Adresse e-mail

L'adresse de messagerie qui doit être placée en liste blanche. Il est possible d'utiliser les jokersdans ce champ. Vous pouvez, par exemple, placer en liste blanche tous le courriel du domaineexample.com, en spécifiant l'adresse *@example.com

IP Inférieur et Supérieur

La plage IP à laquelle s'applique les enregistrements de la liste blanche. Si vous laissez ceschamps vierges, hMailServer supposera que vous indiquez 0.0.0.0-255.255.255.255 (la totalitéd'Internet).

 

 

Dépannage

Messages d'erreur

Messages d'erreur de la base de données

Le serveur MySQL a disparu

Si hMailServer perd sa connexion avec le serveur de base de données lors d'une requête, il essaiede relancer la connexion et de relancer la requête. Ci cela échoue, l'erreur Le serveur MySQL adisparu est journalisée. Ce qui peut se produire si le serveur MySQL s'exécute sur un autreordinateur, et que la connexion réseau est perdue. Il est également possible que le serveurMySQL soit sur le point d'être arrêté, lors du redémarrage d'un ordinateur, par exemple. Dans laplupart des cas, cette panne n'a aucun effet secondaire.

Messages d'erreur DNS

Erreurs DNS

Informations générales

hMailServer utilise l'API de Windows pour interroger le serveur DNS. hMailServer lui-même ne demande pas à Windows d'utiliser un serveur DNS spécifique. La requête DNS se fait à l'aide de lafonction API de Windows DnsQuery. En fonction de l'erreur DNS qui s'est produite, DnsQueryrenvoie différentes valeurs. Si une erreur se produit, elle sera énumérée dans le journal dehMailServer.

hMailServer - Guide de l'Utilisateur

84 / 214

1460, ERROR_TIMEOUT

L'erreur DNS 1460 signifie qu'il y a eu un temps mort lors de l'exécution de DnsQuery. Ce qui peutse produire si le serveur DNS est en cours d redémarrage ou s'il n'est pas disponible du fait deproblèmes de réseau.

9002, DNS_ERROR_RCODE_SERVER_FAILURE

Le numéro 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, DCOMest utilisé. hMailServer se connecte au service hMailServer en utilisant l'API de DCOM et gère leserveur via l'API. hMailServer Administrator (et PHPWebAdmin) ne se connecte pas directement auserveur de base de données. De ce fait, pour pouvoir exécuter hMailServer Administrator, leservice hMailServer doit être en activité.

Si hMailServer Administrator ne peut pas se connecter au service hMailServer, vous pourrez voirl'erreur ci-dessus. Par défaut, hMailServer Administrator essaie de se connecter à une instance dehMailServer en activité sur localhost. Si vous obtenez ce message d'erreur, vérifiez que le nomd'hôte auquel vous essayez de vous connecter dans la boîte de dialogue de connexion est valide.Si c'est le cas, vous devez vous dépanner.

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 messaged'erreur est envoyé au client avant que hMailServer le déconnecte. Le temps mort SMTP danshMailServer est de 10 minutes.

421 Quantité excessive de données envoyée au serveur.

Cette erreur est générée par hMailServer si un client envoie une grande quantité de données àhMailServer ne contenant pas le caractère retour chariot (fin de commande). Un client ne doitjamais pratiquer de la sorte, mais des clients mal configurés peuvent déclencher ce problème.

451 Merci d'essayer à nouveau ultérieurement.

Ce message d'erreur est généré si la liste grise est activée et que le triplet expéditeur,destinataire et l'adresse IP ne correspond pas au triplet d'une liste grise existante.

500 Ligne trop longue

hMailServer - Guide de l'Utilisateur

85 / 214

Si un client SMTP envoie une commande SMTP que hMailServer considère comme étant trop long, ildéclenche cette erreur. Cette erreur indique habituellement un défaut du client ou une tentativede piratage.

501 EHLO Adresse de domaine non valide

502 TURN désactivé

Si un client SMTP essaie d'utiliser la commande TURN, hMailServer répond par ce code d'erreur.hMailServer n'inclut pas la prise en charge du verbe TURN.

502 Commande non implémentée

Si un client SMTP essaie d'utiliser une commande pour laquelle hMailServer n'a pasd'implémentation, ce message d'erreur est envoyé au client.

502 Utiliser d'abord HELO/EHLO

Après qu'un client SMTP se soit connecté à un serveur SMTP, la première chose qu'il doit faire estde s'identifier via la commande HELO ou EHLO. Dans le cas contraire, hMailServer répond par cemessage d'erreur.

502 VRFY refusé

Si un client SMTP essaie d'utiliser la commande VRFY, hMailServer répond par ce code d'erreur.hMailServer ne propose pas la prise en charge du verbe VRFY.

503 Effectuer une réinitialisation si vous voulez recommencer

Lorsqu'un client de messagerie distribue un courriel à un serveur de messagerie, il indique d'abordau serveur l'adresse de messagerie de l'expéditeur. Ensuite, il lance une transaction qui ne setermine pas tant que la totalité du message n'a pas été distribuée au serveur de messagerie. Si leclient souhaite abandonner la transaction et envoyer un autre message, il doit émettre lacommande RSET. Si un client, en plein milieu de la transaction, essaie d'envoyer un nouveaucourriel sans avoir d'abord abandonné la transaction en cours, hMailServer émettra ce messaged'erreur. Ce qui indique un bug du client SMTP.

503 Nécessite d'abord l'expéditeur et le destinataire.

Lorsqu'un client SMTP distribue un courriel à un serveur SMTP, il doit spécifier l'expéditeur et ledestinataire avant d'essayer de soumettre le contenu du message en cours. Si un client ne réussitpas à indiquer l'adresse de l'expéditeur et du destinataire à hMailServer avant d'essayer desoumettre le contenu du courriel, hMailServer répondra par cette erreur. Ce qui indique un bug duclient SMTP.

503 Nécessite d'abord l'expéditeur.

Lorsqu'un client SMTP distribue un courriel à un serveur SMTP, il doit spécifier l'expéditeur et ledestinataire avant d'essayer de soumettre le contenu du message en cours. Le client doit d'abordl'adresse de l'expéditeur au serveur, et indiquer ensuite l'adresse du destinataire. Si le clientessaie d'indiquer à hMailServer l'adresse du destinataire avant l'adresse de l'expéditeur, cemessage d'erreur est émis. Ce qui indique un bug du client SMTP.

hMailServer - Guide de l'Utilisateur

86 / 214

504 Mécanisme d'authentification non pris en charge.

Ce message d'erreur est émis si un client essaie de s'authentifier en utilisant une méthoode quin'est pas prise en charge par hMailServer.

504 Type d'authentification non spécifié.

Ce message d'erreur est émis par hMailServer si un client essaie de s'authentifier sans spécifier laméthode d'authentification. Cette erreur indique un bug du client SMTP utilisé.

530 Authentification SMTP requise.

Vous avez activé l'authentification SMTP pour la plage IP à laquelle l'utilisateur est connecté, maisl'utilisateur n'a pas configuré son client pour utiliser l'authentification SMTP. Deux méthodes sontpossibles pour résoudre ce problème. Vous configurez votre client de messagerie pour qu'il utilisel'authentification SMTP (réglage accessible dans la configuration du compte de votre client demessagerie), ou vous désactivez l'authentification SMTP pour la plage IP. La première méthode estpréférable car elle réduit le risque que quelqu'un eenvoie des spams sur votre serveur.

Par défaut, hMailServer ne nécessite pas d'authentification SMTP pour connexions en provenancede localhost / 127.0.0.1. Pour les connexions en provenance des autres hôtes, l'authentificationSMTP est requise pour les distributions aux destinataires externes. Par défaut, hMailServer nenécessite jamais d'authentification SMTP pour distribuer aux comptes locaux, car cela empêcheraitles autres serveurs de messagerie de distribuer du courrier à votre installation. Pour en savoirplus sur l'activation de l'authentification SMTP, consultez la rubrique HOWTO.

Si vous utilisez un routeur Cisco, vous aurez sans doute à désactiver le protocole SMTP Fixup.Dans le cas contraire, le routeur interceptera parfois le trafic SMTP et remplacera les données qu'ilcontient avant d'atteindre hMailServer, ce qui entraînera des problèmes.

535 L'authentification a échouée. Relancez le processus d'authentification.

Si un client SMTP s'authentifie mais que le nom d'utilisateur ou le mot de passe est incorrect, ou sile compte est désactivé, hMailServer envoie ce message d'erreur au client.

550 Une adresse valide est requise

hMailServer émet ce message d'erreur si un client SMTP essaie de spécifier une adresse dedestinataire non valide (dont la syntaxe n'est pas correcte).

550 Le compte n'est pas actif.

Si un client SMTP essaie d'envoyer un courriel à un compte qui n'a pas été activé, ce messaged'erreur est envoyé au client.

550 L'alias n'est pas actif.

Si un client SMTP essaie d'envoyer un courriel à un alias qui n'a pas été activé, ce messaged'erreur est envoyé au client.

550 Bloqué par SPF

Si un courriel est refusé au cours des vérifications SPF, ce message d'erreur est émis.

hMailServer - Guide de l'Utilisateur

87 / 214

550 La distribution n'est pas autorisée à cette adresse

Cette erreur signifie que l'expéditeur essaie d'envoyer un courriel à une adresse à laquelle il n'estpas autorisé à effectuer un envoi.Ce message est généré après que hMailServer ait vérifié lesparamètres de la plage IP. Exemple: la configuration par défaut de la plage IP ne permet pas auxutilisateurs externes d'envoyer des courriels aux autres utilisateurs externes. Ceci pour empêcherles gens d'utiliser votre serveur pour envoyer des spams. ainsi, si un utilisateur externe essaied'envoyer un courriel à un autre utilisateur externe, il recevra ce message.

550 Le liste de distribution n'est pas active.

Si un client SMTP essaie d'envoyer un courriel à une liste de distribution qui n'est pas activée, cemessage d'erreur sera envoyé au client.

550 Le domaine a été désactivé.

Si un client SMTP essaie d'envoyer un courriel à domaine qui a été désactivé, ce message d'erreursera envoyé au client.

550 Syntaxe non valide. La syntaxe doit être MAIL FROM:<userdomain>[crlf]

Si un client émet une commande MAIL FROM dont la syntaxe est incorrecte, hMailServer enverra cemessage d'erreur.

550 Les identifiants d'ouverture de session ne sont plus valides. Veuillez vous identifier ànouveau.

Lors d'une session SMTP, un expéditeur SMTP peut envoyer plusieurs courriels. A chaque foisqu'un client SMTP essaie 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 estnécessaire car il n'y a aucune limitation quant à la durée de connexion d'un client SMTP àhMailServer, tant qu'il envoie des messages. Si hMailServer ne ré-identifiait pas les utilisateursconnectés, il n'y aurait aucun moyen de déconnecter ceux qui enverraient des spams non stop.

550 Erreur de configuration du serveur de messagerie. Trop de transferts récurrents.

Lorsqu'un client de messagerie indique à hMailServer pour qui le courriel est destiné, il essaie dedéterminer le "destinataire final". L'adresse de messagerie que le client a fournie à hMailServerpeut ne pas être celle du destinataire final. Exemple:vous avez défini un alias, [email protected],qui pointe sur [email protected], et le client de messagerie indique à hMailServer que lecourriel est destiné à [email protected], alors que le destinataire final [email protected].

Il est possible, ici, de configurer hMailServer de façon incorrecte. Exemple: vous avez nommé unalias [email protected] pointant sur [email protected], et l'alias [email protected] pointantsur [email protected]. Lorsque hMailServer essaie de déterminer le destinataire final pour uncourriel destiné à [email protected], il abandonnera car il n'existe pas et il rapportera cemessage d'erreur. L'erreur sera toujours rapportée si hMailServer ne peut pas déterminer ledestinataire final.

Les causes suivantes sont les plus courantes:

·Une adresse fourre-tout a été spécifié pour le domaine du destinataire, mais aucun compten'existe qui correspond à l'adresse fourre-tout indiquée.·Le courriel a été envoyé à un alias qui ne pointe pas sur un compte valide.

hMailServer - Guide de l'Utilisateur

88 / 214

550 Non autorisé.

Si un client de messagerie essaie d'envoyer un courriel à une liste de distribution qui n'a pas depermission de réception, ce message d'erreur est émis.

550 Bénéficiaire absent de la liste de l'itinéraire.

Si un client essaie d'envoyer un courriel à un domaine de destinataires qui correspond àl'itinéraire, mais que l'adresse du destinataire ne figure pas dans la liste des adresses valides, cemessage d'erreur est envoyé au client.

550 L'adresse de l'expéditeur doit être spécifiée.

Si hMailServer est configuré pour refuser les adresses d'expéditeur vides, et qu'un clientSMTP essaie d'utiliser une adresse d'expéditeur vide, cette erreur est émise.

550 Le domaine de l'expéditeur n'a pas d'enregistrements MX.

Si un courriel est refusé après vérification MX, ce message d'erreur est émis.

550 L'adresse n'est pas valide.

hMailServer émet ce message d'erreur si un client SMTP spécifie une adresse d'expéditeur nonvalide (dont la syntaxe n'est pas correcte).

550 Le nom d'hôte spécifié dans HELO ne correspond pas à l'adresse IP.

Ce message d'erreur fait partie du mécanisme de protection anti-spam de hMailServer. Si unserveur d'envoi de courriel distribue un e-mail à hMailServer, l'une des premières choses qu'il doitfaire est de s'identifier lui-même. Il le fait via une commande HELO <HOSTNAME> où <HOSTNAME>est remplacé par son nom d'hôte. Le nom d'hôte que le serveur d'envoi fournit à la commandeHELO doit résoudre l'adresse IP du même serveur.

Si, par exemple, un des serveurs Hotmails essaie de distribuer un courriel à votre serveur, ilenverra une commande similaire à HELO mx1.hotmail.com. Si l'option Vérifier l'hôte dans lacommande HELO a été activée dans les paramètres de la protection anti-spam protection dehMailServer, celui-ci vérifiera que le nom d'hôte envoyé par le serveur de Hotmails,mx1.hotmail.com, correspond à l'adresse IP à partir de laquelle la connexion va s'effectuer. Sil'adresse IP ne correspond pas au nom d'hôte, hMailServer considère le courriel comme un spam.Si vous avez configuré hMailServer pour supprimer un e-mail considéré comme un spam,hMailServer rapportera le message d'erreur ci-dessus à l'expéditeur.

Si quelqu'un essaie de vous envoyer un e-mail et que vous recevez cette erreur, effectuez l'unedes actions suivantes:

·Informez l'administrateur du serveur qui envoie le courriel qu'il n' pas spécifié le nom d'hôtecorrect dans la commande HELO.·Désactivez l'option "Vérifier l'hôte dans la commande HELO" au niveau des paramètres de laprotection anti-spam via hMailServer Administrator ou PHPWebAdmin. Cette option est désactivéepar défaut.·Dans les paramètres de la prootection anti-spam, indiquez que hMailServer doit distribuer lesspams, mais modifiez le en-têtes de message. De même, choisissez de modifier le sujet dumessage. Le courriel sera alors distribué, mais [SPAM] sera ajouté au sujet.

550 Utilisateur inconnu

hMailServer - Guide de l'Utilisateur

89 / 214

Ce message d'erreur est émis si le client SMTP essaie de distribuer un courriel à un domainehébergé par hMailServer et que le compte de l'utilisateur est introuvable et qu'aucune adressefourre-tout n'a éré spécifiée pour le domaine destinataire.

550 Votre message a été reçu mais ne peut pas être enregistré. Essayez ultérieurement.

Si le courriel a été reçu par hMailServer mais qu'il n'a pu être enregistré, ce message d'erreur estenvoyé au client. Il indique des problèmes concernant la base de données.

550 <Autre message d'erreur>

Dans la liste noire DNS et la configuration SURBL, il est possible de spécifier des messages d'erreurpersonnalisés à utiliser lorsqu'un courriel est refusé.

552 La taille du message dépasse la taille de message maximum fixée. Taille: x Ko, TailleMax: y Ko

Dans hMailServer, il est possible de spécifier une taille maximum de message dans la configurationSMTP et dans la configuration du domaine. Si la taille d'un courriel dépasse cette limite, cemessage d'erreur est émis.

554 Refusé

Si un script hMailServer, s'exécutant lors de l'événement OnAcceptMessage, refuse un courrielsans message d'erreur spécifique, cette erreur est émise.

554 Refusé - Le message contient un LF seul.

Selon la spécification SMTP, les lignes d'un courriel doivent être séparées par les codes ASCII 13 et10 - retour chariot (CR) et saut de ligne (LF). Certains spammeurs et logiciels défectueux envoientdes courriels qui ne sont pas formatés correctement. Utilisez ce paramètre pour refuser cesmessages. Notez que des e-mails légitimes peuvent avoir été formatés de façon incorrecte en finde ligne, si le logiciel d'envoi contient des bugs.

Si, en temps que développeur, vous êtes confronté à ce problème, vérifiez que chaque ligne devotre courriel (en-tête et corps) se termine par un retour chariot et un saut de ligne, et passeulement un saut de ligne. La façon d'y parvenir dépend du langage de programmation aveclequel 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 séparateur de ligne est CRLF. Sous Linux et UNIX, le séparateur par défaut estLF seul. Cependant, lors de l'envoi d'un courriel depuis un système Linux/UNIX, CRLF doit toujoursêtre utilisé. Certains serveurs de messagerie sous Linux (comme Postfix) remplacentautomatiquement LF par CRLF. Par conséquent, si vous réglez le séparateur de ligne des courrielssur CRLF, il sera remplacé par CRCRLF.

554 Refusé - Aucune donnée enregistrée.

Si hMailServer reçoit un courriel d'un client SMTP mais qu'il ne peut pas enregistrer le fichiercorrespondant sur le disque, ce message d'erreur est émis. Le problème se produit si le dossier dedonnées spécifié 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'événement OnAcceptMessage, il peut envoyer

hMailServer - Guide de l'Utilisateur

90 / 214

un message d'erreur au client. Si un script le fait, hMailServer envoie ce message d'erreur aueclient. <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 denombreuses vérifications avant la distribution du courriel pour éviter des envois en bouclesinfinies. 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 lecourriel.

Avant que hMailServer se connecte au serveur des destinataires, il vérifie que l'adresse IP àlaquelle il va se connecter n'est pas une adresse IP locale. Si l'adresse IP est une adresse IPlocale, cela signifierait que hMailServer se connecte à lui-même, ce qui déclencheraitvraisemblablement une boucle de message. Dans ce cas, hMailServer refuse le courriel et retourneun message d'erreur à l'expéditeur.

Les causes suivantes sont courantes pour ce problème:

·Un nom d'hôte ou une adresse IP qui pointe sur un ordinateur local a été saisi comme relaisSMTP. Accédez à la section Distribution des e-mails de la configuration SMTP. Vérifiez le réglage duRelais SMTP. Si vous avez entré localhost, 127.0.0.1, your-own-domain-name.com, ou quelquechose de similaire dans le champ de saisie, c'est probablement la cause du problème. Si c'est lecas, consultez la rubrique Configuration SMTP pour en savoir plus et corrigez le problème.·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 requête DNSpour déterminer où le courriel doit être envoyé. Si la requête DNS échoue, le message d'erreur ci-dessus est rapporté. Exemple: la requête peut échouer si le serveur DNS n'est pas disponible ousi le domaine du destinataire n'existe pas. Pour de plus amples dépannages, consultez le journald'erreurs de hMailServer. Le journal d'erreurs de hMailServer contient les codes d'erreur du clientDNS sous Windows.

Messages d'erreur non générés par hMailServer

550 Boîte aux lettres non disponible

hMailServer ne génère 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 serveurdes destinataires peut émettre ce message d'erreur.

Le message d'erreur indique que vous envoyez le courriel à une adresse incorrecte. Si vous êtessûr que l'adresse est correcte, le problème peut provenir de la configuration DNS desdestinataires.

550 Échec de la vérification de l'expéditeur

hMailServer - Guide de l'Utilisateur

91 / 214

Lorsque hMailServer distribue un courriel à un autre serveur, le serveur SMTP destinataire peutessayer de valider que l'expéditeur du courriel existe réellement. Si cette vérification échoue, ilpeut répondre par le message d'erreur 'Échec de vérification de l'expéditeur'. Dans ce cas, l'e-mailsera renvoyé à l'expéditeur. Cette vérification fonctionne de la façon suivante:

1.hMailServer se connecte au serveur SMTP des destinataires2.hMailServer indique au serveur SMTP des destinataires que l'e-mail provient [email protected] serveur SMTP des destinataires recherche un enregistrement MX pour le domaineexample.com.4.Le serveur SMTP des destinataires se connecte à l'hôte spécifié dans l'enregistrement MX - quise trouve vraisemblablement là où votre serveur hMailServer s'exécute si les enregistrements MXsont réglés correctement.5.Ensuite, le serveur SMTP des destinataires émet les commandes HELO, MAIL FROM<> et RCPTTO:6.Si hMailServer confirme que le destinataire [email protected] existe, le serveur SMTP desdestinataires autorisera la distribution initialisée à l'étape 2 ci-dessus.

Certaines étapes peuvent mal se dérouler au cours de ce processus:

·Si les enregistrements MX du domaine example.com ne sont pas réglés correctement, le serveurSMTP des destinataires peut se connecter à un hôte SMTP incorrect et la vérification de l'adressede l'expéditeur échouera.·Si le compte [email protected] n'existe pas, la vérification de l'expéditeur échouera.·Si vous avez désactivé Autoriser une adresse d'expéditeur vide, la vérification de l'expéditeuréchouera, car le serveur SMTP des destinataires essaie de vérifier en utilisant une adressed'expéditeur vide.

 

Conseils de dépannage

Dépannage d'une règle

Généralités

Cette rubrique contient les conseils de dépannage concernant le traitement des règles. Si vousrencontrez des problèmes avec une règle, nous vous recommandons de consulter cette rubrique.

Conseils

Délai de 60 secondes

Lorsqu'un e-mail est généré automatiquement par une règle, après un transfert, par exemple, 60secondes peuvent s'écouler avant que le message soit distribué. Il le sera la prochaine fois quehMailServer sondera la base de données pour la distribution des messages. Ce délai estnécessaire. Sans lui, il serait facile de créer une règle qui distribuerait des messages selon uneboucle sans fin, et hMailServer utiliserait 100% des ressources CPU jusqu'à suppression de larègle.

Champs d'en-tête encodés

Les en-têtes d'un e-mail peuvent être encodés en utilisant différents types d'encodages. Si vousdéfinissez un critère de recherche d'un champ d'en-tête, hMailServer essaiera de décoder cechamp d'en-têtes si possible. Si l'en-têtes est en Japonais, par exemple, le contenu du messagene pourra pas être recherché.

Messages incorrectement formatés

hMailServer - Guide de l'Utilisateur

92 / 214

Si un message n'est pas correctement formaté, hMailServer peut rencontrer des problèmes pourretrouver les valeurs des en-têtes individuels du message. Dans un message correctementformaté, 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-tête. 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 prêter à confusion est que certains clients de messagerie ignorent le fait que lesmessages ne sont pas formatés correctement. Un e-mail que hMailServer n' pas pu analyser peutêtre affiché correctement dans votre client de messagerie. La seule façon de déterminer si un e-mail est correctement formaté ou pas est de localiser le fichier message dans le dossier data dehMailServer. Ouvrez le fichier de message dans le Bloc-notes et examinez les en-têtes au débutdu message. Si vous voyez plusieurs en-têtes sur une même ligne, c'est que le message n'est pascorrectement formaté. Il est important d'utiliser le Bloc-notes, et pas Wordpad ou Microsoft Word,car ces derniers insèrent automatiquement des fins de ligne correctes.

Vous pouvez configurer hMailServer pour qu'il refuse les messages qui ne sont pas correctementformatés:

1.Lancez hMailServer Administrator2.Déployez Configuration et Protocoles dans l'arborescence à gauche.3.Choisissez SMTP4.Sélectionnez l'onglet Conformité RFC.5.Désactivez "Autoriser les fins de ligne incorrectement formatées".

Envoyer de messages

Port 25 bloqué pour le trafic sortant

Pour distribuer un message sortant, tous les serveurs de messagerie doivent se connecter auserveur de messagerie du destinataire sur le port 25 TCP/IP. Certains Fournisseurs d'AccèsInternet (FAI) bloquent ce port pour réduire les spams. Ce qui crée un problème 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 connectermanuellement à notre serveur de messagerie en suivant ces étapes:

1.Sélectionnez Démarrer->Exécuter2.Entrez telnet mail.hmailserver.com 25 (saisissez exactement ce texte; ne remplacez pasmail.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 façon d'envoyer desmessages en dehors du réseau 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. Encas d'insuccès, contactez votre FAI et demandez-lui de vous permettre de re-router via leursserveurs 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 entraîner des problèmes de distribution pour hMailServer. Si le paramétrage DNS est incorrect, vous recevrez normalement unmessage de bounce qui vous indique qu'aucun serveur de messagerie n'a été trouvé pour ledestinataire. Windows utilise différents jeux de paramètres DNS, ce qui fait que même si, parexemple, votre navigateur web fonctionne correctement, le paramétrage DNS peut être incorrect.Pour vérifier si votre configuration DNS est correcte, suivez ces étapes:

1.Sélectionnez Démarrer->Exécuter2.Entrez nslookup3.Cliquez sur OK4.Entrez set type=mx et appuyez sur Entrer5.Saisissez gmail.com et appuyez sur EntrerVous devez alors voir la liste des serveurs de messagerie de GMails. Si ça n'est pas le cas, cela

hMailServer - Guide de l'Utilisateur

93 / 214

signifie que vos paramètres 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 desspams via votre serveur. Un moyen simple de déterminer si un spam vous sera envoyé sur votreserveur est d'ouvrir le dossier data de hMailServer. La racine du dossier data contient la filed'attente de distribution de hMailServer. S'il y a un nombre important de messages dans la filcd'attente de distribution, il est probable que quelqu'un vous envoie des spams via votre serveur.Vérifiez que vous avez désactivé Externe vers externe pour toutes les plages IP dans laconfiguration de hMailAdmin.

Recevoir des messages

Les problèmes les plus courants pour vous empêcher de recevoir des massages sont:

Problèmes MX

Tout serveur de messagerie doit posséder des enregistrements MX définis pour le domaine qu'ilhéberge. Les enregistrements MX sont ajoutés aux DNS. Vous pouvez vérifier si vosenregistrements sont définis 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 estsomething.com, entrez something.com et non smtp.something.com ou mail.something.com. Aprèsla recherche, consultez le résultat, sous la catégorie MX category. FAIL ne devrait apparaître nullepart. Sinon, vos enregistrements MX sont probablement mal définis. En savoir plus...

Ports TCP/IP bloqués

Certains FAI bloquent le port 25 TCP/IP pour éviter les spams. Certains bloquent le trafic entrantsur le port 25, alors que d'autres bloquent le trafic sortant. Pour vérifier si votre FAI a bloqué letrafic entrant, faites une requête sur intoDNS.com. Après la reequête, cherchez la catégorie Mail. Itshould not say FAIL ne devrait apparaître nulle part. Sinon, votre FAI a probablement bloqué letrafic vers ou depuis le port 25. En savoir plus.... Pour savoir si c'est la cas, contactez votre FAI etposez-lui la question.

Port 25 non utilisé

Pour fonctionner correctement, tous les serveurs de messagerie doivent utiliser le port 25 pour letrafic entrant. Si vous avez reconfiguré hMailServer pour utiliser un autre port, vous ne pourrezpas 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 hMailServersurveiller les connexions SMTP sur le port 25 (ce qu'il fait par défaut). Cependant, si votreinstallation de hMailServer est derrière un routeur ou pare-feu, vous devez probablementconfigurer le routeur ou le pare-feu pour transférer le trafic TCP entrant sur le port 25 del'ordinateur où s'exécute hMailServer. Sinon, le trafic ne parviendra pas à hMailServer et lesexpéditeurs de messages ne pourront pas se connecter.

Erreurs DNS

Si les enregistrements DNS de votre domaine ne sont pas définis correctement, vous ne pouvezpas recevoir de messages. Pour vérifier que vos enregistrements DNS sont définis correctement,utilisez intoDNS.com.

hMailServer - Guide de l'Utilisateur

94 / 214

Paramètres multi-hébergement incorrects

Si vous avez configuré hMailServer pour surveiller une adresse IP spécifique, vérifiez que cetteadresse est correcte et qu'il ne s'agit pas d'une adresse locale, comme 127.0.0.1. Si hMailServerne 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 défaut, une plage IP nommée Internet est créée. Si vous modifiez cette plage IP, il y a lerisque que vous ne puissiez pas recevoir les messages des autres serveurs. hMailServer n'acceptepas les messages des adresses IP qui ne correspondent à aucune des plages IP.

Autre

Si la description ci-dessus ne s'applique pas à votre problème, 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. Insérez lemessage d'erreur dans votre demande sur le forum.·Si vous n'obtenez pas de message en retour, activez le journalisation SMTP dans hMailServer,reproduisez l'erreur et vérifiez si quelque chose a été ajouté au journal. Si c'est le cas, ajoutez-leà votre demande sur le forum.

Autres conseils de dépannage...

Dépannage

Vous trouverez ci-dessous des conseils qui peuvent vous être utiles si vous rencontrez desproblèmes avec hMailServer. Si vous ne trouvez pas de réponse sur ces liens, posez votrequestion sur le Forum de hMailServer.

Problèmes 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 spécifiques, 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 données·PHPWebAdmin ne fonctionne pas

Messages d'erreur

Si vous recevez un message d'erreur de hMailserver lorsqu'un problème se produit, vous pouvezconsulter la rubrique messages d'erreur. Ce document contient une liste avec description desmessages d'erreur générés par hMailServer.

Ports bloqués

hMailServer - Guide de l'Utilisateur

95 / 214

Dépannage des ports bloqués

Si vous ne pouvez pas recevoir les messages d'autres serveurs, et que vous êtes sûr que vosenregistrements MX sont définis correctement, essayez ce qui suit:  De l'extérieur de votre réseau,réglez votre ordinateur telnet sur le port 25. Si cela échoue, un logiciel ou un matériel bloque laconnexion sur votre port 25.

Raisons possibles:

·Vous n'avez pas ouvert le port 25 dans votre pare-feu.·Un routeur / commutateur de votre réseau qui reçoit le trafic d'Internet ne transfert pas le traficvers l'ordinateur où s'exécute hMailServer.·Votre FAI (Fournisseur d'Accès à Internet) bloque le port 25 pour le trafic entrant.

Le pare-feu de Windows XP SP2 est activé par défaut, et peut bloquer les connexions entrantes.Les versions précédentes de XP possèdent aussi un pare-feu intégré, mais il ets désactivé pardéfaut. Si vous êtes sûr que vous n'avez pas bloqué le port 25 dans votre pare-feu, et que vousne pouvez toujours pas vous connecter sepuis l'extérieur de votre réseau, demandez à votre FAIs'il a bloqué le port 25. Certains FAI bloquent les ports du serveur (e-mail, FTP et HTTP) car ils nesouhaitent 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 données

Ouvrez le dossier Log de hMailServer dans l'Explorateur Windows. Ouvrez le fichier nomméERROR_*.log dans un éditeur de texte et examinez les dernières lignes.·Error: Cannot connect to xx on host xx (Connexion impossible à xx sur l'hôte xx)Raison: hMailServer ne peut pas se connecter à la base de données.·Error: Cannot open requested database (Impossible d'ouvrir la base de données requise)Raison: Vérifiez que la base de données spécifiée dans hMailServer.ini existe et que l'utilisateurqui essaie de s'y connecter à les droits appropriés pour son utilisation.

Connexion via le client de messagerie

Suggestions générales

Si vous ne pouvez pas vous connecter à hMailServer en utilisant votre client de messagerie, lescauses les plus fréquentes sont les suivantes:

·Vous n'avez pas entré le nom d'hôte correct du serveur de messagerie dans la configuration ducompte de votre client de messagerie.·Le nom d'hôte que vous avez saisi dans votre client de messagerie ne résout pas l'adresse IP del'ordinateur qui exécute le serveur de messagerie.·Un pare-feu actif bloque le trafic vers hMailServer. Il peut s'agir d'un pare-feu logiciel ou matériel.Très souvent, les administrateurs du serveur n'ont pas ouvert les ports pertinents (typiquement25, 110 et 143) dans le pare-feu de Windows XP.·La connexion Loopback n'est pas activé dans le routeur, ce qui fait que même si vous vousconnectez à une adresse IP publique correcte, et que le pare-feu est ouvert, votre routeur netransmet pas la connexion au serveur de messagerie puisque vous vous connectez à l'intérieur duréseau.·hMailServer n'est pas à l'écoute des ports TCP/IP. Dans la plupart des cas, ceci se produit si unautre serveur de messagerie est en activité sur le même ordinateur que hMailServer. Souvent, lesadministrateurs 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 vérifier si unautre serveur est à l'écoute sur ces ports.

Problèmes de connexion depuis l'ordinateur où est installé hMailServer

hMailServer - Guide de l'Utilisateur

96 / 214

Vérifiez que vous pouvez lancer un ping depuis l'ordinateur sur lequel hMailServer s'exécute.Vérifier que le serveur de messagerie a réellement démarré, en lançant une commande Telnetdepuis le serveur sur les ports 25 et 110. Dans hMailAdmin, cherchez les paramètres des plages IPet vérifiez que vous n'avez pas défini des plages IP qui rendent impossible l'envoi d'e-mail. Vouspouvez spécifier le nombre maximum de connexions simultanées dans hMailAdmin. La valeur pardéfaut est 0 (illimitées). Vérifiez que vous avez réglé cette valeur sur 0 ou sur une valeur élevée.Si ces conseils ne vous aident pas, faites ce qui suit:

1.Arrêtez 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.Démarrez le serveur5.Essayez de vous connecter avec votre client de messagerie.6.Créez une nouvelle rubrique dans le forum hMailServer et postez votre journal. Avant ceci,vérifiez le journal pour être sûr que votre mot de passe n'y figure pas.

Problème seulement lors d'une connexion depuis un autre ordinateur

Vérifiez que les pare-feu ne bloquent pas les ports. De nombreux FAI, par exemple, bloquent leport 25 à tout trafic sortant, et ainsi peuvent bloquer la connexion à votre serveur.

hMailServer échoue pour distribuer les messages à certains serveurs

Généralités

Ce document couvre les problèmes d'échec de hMailServer à distribuer des messages à un serveurspécifique, comme par exemple Yahoo, Google ou Hotmail. Si vous avez essayé d'envoyer desmessages à plusieurs serveurs différents, mais qu'aucun ne fonctionne, vous devez lire cce quisuit.

Enregistrements MX manquants

Si votre domaine aucun enregistrements MX, les autres serveurs de messagerie peuvent refuserles messages de votre serveur. Si vous n'êtes pas sûr de savoir si votre domaine possède desenregistrements MX, allez sur intoDNS.com, entrez votre domaine et cliquez sur DNS Report oucontactez la société qui a enregistré votre domaine.

Enregistrements DNS incorrects

Des entrées DNS incorrectes ont pour effet que les autres serveurs de messagerie n'acceptentpas les messages de votre domaine. Pour vérifier si vos enregistrements DNS sont corrects, allezsur intoDNS.com, entrez votre domaine et cliquez sur DNS Report.

Votre IP ne correspond pas à votre enregistrement SPF

Si des enregistrements SPF sont définis dans les DNS de votre domaine, vous devez vérifier quevous distribuez des messages à partir de l'adresse IP spécifiée dans vos enregistrements SPF. Sivous envoyez à partir d'autres adresses IP, de nombreux refuseront vos e-mails.

Nom d'hôte incorrect dans HELO

Dans la configuration SMTP de hMailServer, vous devez spécifier le nom d'hôte de l'ordinateur surlequel vous exécutez hMailServer. Ce doit être un nom d'hôte qui a un enregistrement A dans leDNS qui pointe sur l'adresse IP de votre ordinateur. Si vous entrez un autre nom d'hôte, comme localhost, mycomputername, de nombreux serveurs refuseront les messages de votre serveur.

hMailServer - Guide de l'Utilisateur

97 / 214

Adresse d'expéditeur vide non autorisée

Dans la configuration SMT de hMailServer, vous pouvez choisir de ne pas autoriser les messagesdont l'adresse de messagerie d'expéditeur est vide. Par défaut, c'est autorisé, et de nombreuxserveurs de messagerie refuseront le smessages de votre serveur si vous désactivez 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 listenoire. Si le serveur des destinataires vérifie cette liste noire, il peut refuser vos e-mails. Sur http://blacklistalert.org/ vous pouvez vérifier si votre adresse IP est dans une liste noire commune.

Filtre personnalisé

Le serveur des destinataires peut utiliser un filtre personnalisé qui gère un certain type de spamcomme évoqué ci-dessus. Le seul moyen d'être sûr de cela est de contacter l'administrateur duserveur distant et de lui demander pourquoi vos messages sont refusés. Si vous pouvez envoyeraux autres serveurs et pas à ce serveur spécifique, et que les conseils précédents n'apportentpas de solution, ii est conseillé de contacter l'administrateur du serveur distant.

Problèmes MX

Qu'est-ce que MX?

MX est l'abréviation de Mail Exchanger et est utilisé par tous les serveurs de messagerie lors del'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. Lesenregistrements MX sont stockés sur les serveurs DNS.

Comment fonctionne t-il?

Supposons que vous souhaitiez envoyer un e-mail à [email protected]. Si vouscliquez sur Envoyer dans votre client de messagerie, il sera d'abord présenté et enregistré dans labase de données de hMailServer. Celui-ci contacte alors le serveur DNS pour obtenir l'IP duserveur responsable de la manipulation du message pour le domaine, undomaineexterne.com. Leserveur DNS répond avec l'adresse IP du serveur. hMailServer se connecte à cet IP et envoie lemessage.

Le même 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 responsablede la manipulation du message pour le domaine, votre-domaine-hmailserver.com. Le serveur DNSrépondra avec l'adresse IP de votre ordinateur, celui sur lequel est situé hMailServer. Le serveurde messagerie de votre FAI se connecte alors à cet IP.

Comment le serveur DNS connaît-il l'IP de votre ordinateur?

Il vous faut configurer votre DNS pour le savoir. Le serveur DNS responsable des questions-réponses concernant votre domaine doit posséder un enregistrement MX. Si vous possédez undomaine, vous devez avoir accès à un panneau de contrôle dans lequel vous pouvez spécifierl'adresse IP pour l'enregistrement MX. Si vous n'avez pas accès à un panneau de contrôle DNS,contactez la société qui a enregistré votre domaine et demandez lui d'ajouter un enregistrementMX avec votre IP.

Il n'est pas suffisant de seulement faire pointer votre nom de domaine sur votre adresse IP. Lefait que votre nom de domaine décide de votre adresse IP ne fait pas fonctionner votremessagerie; l'enregistrement MX doit aussi décider de l'adresse IP correcte. Un domaine peutavoir plusieurs enregistrements MX (si vous exécutez, pour des raisons de sauvegarde par

hMailServer - Guide de l'Utilisateur

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 lesenregistrements MX via une interface web . Si vous n'avez accès à aucune interface web pourvotre domaine, vous devez contacter les gens qui ont enregistré votre domaine, et leur demanderde configurer un enregistrement MX pour vous. Configurer un enregistrement MX ne prend quequelques 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 plusd'informations. Vous pouvez faire toutes sortes de requêtes DNS en utilisant nslookup. Leparagraphe 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 réponse devrait ressembler à:C:\Documents and Settings\votre-nom d'utilisateur>nslookup -type=mxvotrenomdedomaine.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-ipns2.yourdns.com internet address = your-dns-ip ns1.yourdns.com internet address = your-dns-ip Si la réponse n'inclut pas un enregistrement MX, c'est que vous n'avez défini aucunenregistrement MX pour le domaine.

Port SMTP non par défaut

Les e-mail envoyés entre serveurs de messagerie sont toujours envoyés sur le port 25. Ce quin'est pas configurable et ce qui est pareil pour tous les serveurs de messagerie. Si vous changezle port SMTP pour autre chose que 25, les autres serveurs ne pourront pas vous envoyer desmessages. 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 pasutiliser le port 25 pour une raison quelconque, deux solutions sont possibles:·Changer de FAIou·Utiliser un service de routage. Il existe des sociétés qui proposent d'accepter les e-mails pourvotre domaine sur le port 25 et ainsi de les transférer sur votre hMailServer via un port SMTP nonstandard qui n'est pas bloqué par votre FAI.

Plantages Outlook

L'implémentation IMAP d'Outlook 2003 se comporte de façon légèrement différente del'implémentation IMAP des autres clients de messagerie. Il existes des problèmes avec Outlook etqui ne sont pas spécifiques à hMailServer. Ils se produisent sans rapport avec le serveur IMAP quevous utilisez.

Outlook 2003 tombe parfois en panne s'il ne peut pas se connecter au serveur IMAP. Il s'agit d'unbug 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 ledossier nommé Null. Pour certaines raisons, les versions internationales d'Outlook utilisent desnoms internationaux pour le dossier INBOX, même si la spécification IMAP précise que le nom doittoujours être INBOX. Pour contourner le comportement d'Outlook, accédez à Outils->Comptes e-mail->Affichage, ou changer le compte. Dans les propriétés du compte IMAP, cliquez sur Plus deParamètres, sélectionnez Avancé et entrez INBOX comme chemin du dossier Racine. Ce champ desaisie n'est pas disponible pour la version anglaise d'Outlook.

hMailServer - Guide de l'Utilisateur

99 / 214

Problèmes d'installation de PHPWebAdmin

Généralités

Cette section décrit les erreurs courantes d'installation de PHPWebAdmin.

Installation de base

·Lorsque vous mettez à niveau votre installation de hMailServer pour une nouvelle version, vérifiezbien que vous copiez lla version la plus récente de PHPWebAdmin, depuis le dossier d'installationde hMailServer vers le dossier web. Ignorer cette procédure peut empêcher PHPWebAdmin defonctionner.

Paramètres de config.php

·Lorsque vous spécifiez les chemins et les URL dans le fichier config, il est très important d'utiliserle /, et pas l'antislash \ comme séparateur de dossier. Il est également très important de terminerchaque chemin et chaque URL par un /.

Paramètres de PHP.ini

Editing the wrong PHP.ini

Une cause courante de problèmes est l'édition du fichier PHP.ini dans le mauvais dossier.Lorsqu'un script PHP est exécuté, aucune erreur n'est rapportée si le fichier PHP.ini estintrouvable. Certains utilisateurs éditent parfois un PHP.ini dans un dossier spécifique et, par lasuite, il s'avère que PHP essaie de lire le fichier à partir d'un autre dossier. Pour vérifier le fichierPHP.ini qui ets utilisé, suivez ces étapes:

1.Créez un nouveau fichier nommé test.php dans votre dossier web racine.2.Ajoutez le code suivant au fichier:<?php phpinfo();?>3.Accédez au script PHP via votre navigateur web (http://www.example.com/test.php)4.Vérifiez la valeur du paramètre Configuration File (php.ini) Path au début 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 lerapport d'erreur n'est pas activé dans php.ini. Activez le rapport d'erreur pour faciliter ledépannage. Vérifiez que error_reporting n'est pas commenté et qu'il est défini sur E_ALL. Si vousn'exécutez aucun autre script PHP sur le serveur, réglez display_errors sur On. Si vous exécutezd'autres scripts PHP, il est probable que vous ne souhaitez pas afficher les erreurs dans votrenavigateur web et que vous préférez consulter le journal PHP pour prendre connaissance deserreurs rapportées.

DCOM n'a pas été activé

PHPWebAdmin utilise l'API COM de hMailServer pour accéder aux paramètres et objets de votreinstallation hMailServer. Pour que cela fonctionne, il peut être nécessaire d'activer DCOM dans laconfiguration PHP. Vérifiez que com.allow_dcom = true existe dans php.ini et qu'il n'est pascommenté.

Dossier de session non créé

hMailServer - Guide de l'Utilisateur

100 / 214

Si PHP est configuré pour utiliser des sessions, vous devez vérifier que session.save_path n'estpas commenté et qu'il présente une valeur valide. Vous devez aussi vérifier que votre navigateurweb possède le droit en écriture dans ce dossier. Par exemple, si vous utilisez Microsoft IIS,l'utilisateur IUSR_[computername] nécessite write-permissions sur ce dossier.

Autres problèmes de permission

·Si vous utilisez Microsoft SQL Server pour hMailServer, vous devez accorder à l'utilisateurIUSR_[computername] les droits d'accès à la base de données de hMailServer.·Si vous utilisez IIS, ou Apache sous un utilisateur dédié, vous devez accorder l'accès du servicedu compte à la bibliothèque COM de hMailServer.

Serveur utilisé pour les spams

Contexte

C'est un problème assez fréquent que les spammeurs utilisent le serveur d'autres personnes pourtransmettre des messages de spam. hMailServer n'autorise pas ceci par défaut, mais si vous avezconfiguré hMailServer de façon incorrect, ou si vous utilisez un mot de passe faible pour voscomptes de messagerie, il sera assez facile pour les spammeurs d'agir de la sorte.

Comment puis-je le savoir avec certitude?

·Vérifiez d'abord la file d'attente de distribution de hMailServer. Si la file d'attente contient ungrand nombre de messages de l'extérieur vers d'autres adresses externes, il est probable quequelqu'un abuse de votre serveur pour envoyer des spams. Ainsi, si vous ne reconnaissez pasl'adresse des expéditeurs ou l'adresse des destinataires, ce sont probablement des spams.·Une autre méthode consiste à envoyer une commande telnet relay-test.mail-abuse.org à partirde l'ordinateur qui exécute hMailServer. Le serveur distant se reconnectera automatiquement auserveur de messagerie qui s'exécute sur votre ordinateur et effectuera quelques tests pourvérifier si votre ordinateur peut être utilisé pour l'envoi de spams.·Vérifiez aussi votre dossier data. Si ce dossier (pas le sous-dossier) contient de nombreux fichiers.ema, disons plus de 250, même si personne n'est en train d'envoyer des messages via votreserveur, il est probable que quelqu'un utilise votre serveur pour envoyer des spams.·Une quatrième méthode consiste à utiliser d'autres tests de relais ouvert.

Que puis-je faire?

Tout d'abord:

·Examinez la configuration de votre plage IP et vérifiez bien que vous demandez uneauthentification. En général, dans la plage IP Internet, hMailServer doit être configuré pour exigerl'authentification SMTP pour les distributions aux comptes externes.·Ne jamais permettre la distribution de comptes externes vers des comptes externes. Vérifieztoutes vos plages d'adresses IP.

Si vous êtes certain que la distribution externe vers externe n'est pas autorisée dans aucune devos plages IP, et que vous avez vérifié que vous demandez une authentification pour distribuervers des comptes externes, cela signifie probablement qu'un spammeur l'un de vos comptes duserveur pour envvoyer des spams. Dans la plupart des cas, lorsque cela se produit, l'utilisateur achoisi un mot de passe faible comme "test" ou "secret". Ainsi, vous devez détecter les comptes qui vous envoient ces messages:

1.Activez Application et journalisation SMTP. N'activez que ces deux éléments. Activer davantaged'éléments rendra plus difficile l'analyse des journaux2.Attendez quelques minutes que le spammeur envoie un autre e-mail sur votre serveur. Surveillezla file d'attente des "Undelivered messages" et notez l'adresse de l'expéditeur et celle dudestinataire de l'un des spams.3.Recherchez l'adresse des expéditeurs dans le journal hMailServer.

Le journal contiendra désormais des infos concernant la personne qui essaie de vous envoyer desspams. Vous verrez une section qui ressemble à ceci: (les premières colonnes sont laissés de côté

hMailServer - Guide de l'Utilisateur

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 AUTHLOGIN""<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: <[email protected]>""<spammers IP address>"    "SENT: 250 OK""<spammers IP address>"    "RECEIVED: RCPT TO: <[email protected]>""<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 intéressantes ici sont dans la section suivante:

"<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: ***"Ces lignes contiennent une version codée des informations de connexion utilisées par lespammeur. Le texte est codé en utilisant Base64 et peut être décodé en utilisant n'importe queldécodeur base64. En clair, il indique"<spammers IP address>"    "RECEIVED: AUTH LOGIN""<spammers IP address>"    "SENT: 334 Username:""<spammers IP address>"    "RECEIVED: [email protected]""<spammers IP address>"    "SENT: 334 Password:""<spammers IP address>"    "RECEIVED: ***"Ainsi, dans cet exemple, le spammeur est authentifié à l'aide de [email protected], et a envoyé unmessage à partir de [email protected]. Désormais, quand vous savez de quel comptele spammeur a abusé, vous pouvez désactiver le compte, ou choisir un meilleur mot de passe.

Lancer lee serveur

Services Terminal Server

La raison la plus courante de l'échec du démarrage de hMailServer, c'est que les services TerminalServer sont utilisés. L'installation du logisiel hMailServer crée un fichier dans le dossier deWindows nommé hMailServer.ini. Le fichier est créé dans le dossier réel de Windows, C:\Windows. Cependant, lorsque le service est lancé, Windows prétend que le dossier Windowsest situé dans C:\Documents And Settings\Username\Windows. Il en résulte que hMailServeressaie de lire à partir de ce fichier. Comme ce fichier n'existe pas, le démarrage du servicehMailServer échoue (hMailServer 4.0 et supérieur placent le fichier hMailServer.ini dans le dossierBin de hMailServer pour éviter ce problème).

Les ports sont en cours d'utilisation

Une autre raison courante pour que hMailServer ne démarre pas est qu'un autre logiciel peututiliser les ports TCP/IP nécessaires à hMailServer. Certaines versions de Windows possèdent, pardéfaut, un serveur de messagerie intégré. Il est extrêmement léger. Sous Windows 2000/XP, iln'inclut que SMTP (pas POP3), et sous Windows 2003, il n'inclut pas IMAP. Ce serveur intégré peutoccuper le port nécessaire à hMailServer.

hMailServer - Guide de l'Utilisateur

102 / 214

Si hMailServer s'arrête immédiatement après son démarrage, la première chose à faire est devérifier l'Observateur d'Evénements Windows. L'Observateur d'Evénements Windows se trouvedans le dossier Outils d'Administration du Panneau de Configuration. hMailServer rapporte icitoutes les erreurs fatales. Si le serveur ne démarre pas ou si elle s'arrête de manière inattendue,c'est le premier endroit à examiner.

Si l'Observateur d'Evénements Windows ne vous aide pas, essayez d'envoyer une commandetelnet sur le port 25. Lorsque vous vous connectez, un message indiquera le serveur demessagerie que vous utilisez. Repérez ce serveur de messagerie dans l'applet Services duPanneau de configuration et arrêtez / désactivez-le. Si aucun message d'erreur n'apparaît, vérifiezque 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 complètecomme nom d'utilisateur. Si votre adresse de messagerie est [email protected], vous devezspécifier [email protected] comme nom d'utilisateur.

Maintenance

Database maintenance

Maintenance de la base de données

Contexte

Il existe une limitation intégrée à hMailServer qui se produit lorsque 2 milliards de messages onttraversé le serveur.

Chaque message dans une installation de hMailServer possède un identifiant numérique unique.

·Lorsque le premier message est reçu dans une installation de hMailServer, il reçoit l'ID 1.·Lorsqu'il est copié dans la boîte de réception des destinataires, il reçoit l'ID 2.·S'il est copié dans un autre dossier IMAP par l'utilisateur, il reçoit l'ID 3.

Cet ID de message est utilisé dans la communication avec les clients IMAP. Le protocoleIMAP spécifie que cette valeur ne doit jamais dépasser les 4 milliards. Ce qui signifie que si vousrecevez 2 milliards de messages, vous atteignez cette limite. Si vous utilisez IMAP, vous atteignezla limite plus vite car un message reçoit un nouvel ID lorsqu'il est copié dans un nouveau dossier.

Déterminer la situation actuelle

Si vous voulez déterminer la situation en cours, vous pouvez exécuter l'instruction SQL suivantedans la base de données hMailServer. Elle vous indiquera l'ID de message le plus élevéactuellement attribué dans votre base de données.

select max(messageid) from hm_messages

Si cette valeur dépasse 4 000 000 000, vous allez bientôt rencontrer ce problème.

Sauvegarde & Restauration

Généralités

hMailServer propose un outil intégré qui peut être utilisé pour la sauvegarde et la restauration.Cependant, cet outil est conçu seulement pour fonctionner sur des toutes petites installations

hMailServer - Guide de l'Utilisateur

103 / 214

avec moins de 1Go de données. Pour les installations plus importantes, vous devez utiliser un outilexterne. 

Que sauvegarder?

Différents éléments sont à sauvegarder:·La base de données. Elle contient toutes les données de configuration et les liens qui pointentvers les messages enregistrés sur votre disque dur. Le meilleur moyen de sauvegarder la base dedonnées est d'utiliser mysqldump ou, si vous utilisez Microsoft SQL Server, l'outil de sauvegardeMS SQL intégré.·Le dossier data. Le dossier data contient les messages en cours. Ceux qui n'ont pas encore étédistribués, et ceux que vous avez enregistrés dans les dossiers IMAP. Le moyen le plus simple desauvegarder le dossier data est d'utiliser xcopy de MS-DOS.·Autres fichiers. Vous pourriez aussi sauvegarder le dossier Events (hMailServer version 4.0 etsupérieur), le fichier hMailServer.ini, le dossier log, etc.

Sauvegarde intégrée

hMailServer 4.2 et supérieur incluent un outil de sauvegarde intégré. Dans les paramètre desauvegarde de hMailAdmin, vous pouvez définir le type d'objets à sauvegarder. La fonctionnalitéde sauvegarde intégrée est conçue pour les petites installations. Si vous avez plus de 50 comptesou 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, sivous le faites, il existe un risque que certaines données ne soient pas sauvegardées. Scénariotypique: vous essayez de sauvegarder quand hMailServer n'a que partiellement reçu un message.Si vous voulez être sûr que tout est sauvegardé, arrêtez le serveur avant le processus desauvegarde.

Robocopy (version GUI) effectue tout ce que peut effectuer xcopy, mais il peut aussi "synchroniser",ou créer une copie miroir de deux dossiers, et ainsi ne copier que les différences. Pour aller plusvite, vous pouvez copier les fichiers dans un dossier de sauvegarde par la voie habituelle pendantque le service hMailServer est actif. A un moment plus opportun, vous arrêtez le service et vousutilisez à nouveau robocopy. Cette seconde dopie sera plus rapide car seuls les changementsseront copiés. Ce qui peut aider à économiser du temps. Cependant, sachez que robocopy peutentraîner un désastre si vous ne l'utilisez pas avec les bons commutateurs. Consultezsoigneusement sa documentation avant de l'utiliser.

Sauvegarde planifiée

Dans le dossier Addons de hMailServer, vous trouverez un script VBA nommé StartBackup.vbs.Pour exécuter ce script, vous devez l'éditer et entrer votre mot de passe d'administrationhMailServer principal. Quand c'est fait, vous pouvez lancer une sauvegarde en double-cliquant surle fichier VBA. Vous pouvez utiliser le Gestionnaire de Tâches de Windows pour planifier lasauvegarde à exécuter à un moment spécifié.

Recommandations

Indépendamment de la façon dont vous effectuez la sauvegarde, il est fortement recommandé devérifier régulièrement que les sauvegardes fonctionnent correctement en les restaurant sur unautre serveur.

 

Migrer sur un nouveau serveur

hMailServer - Guide de l'Utilisateur

104 / 214

Généralités

Ce document décrit comment déplacer hMailServer d'un serveur physique à un autre. La procédurese déroule en six étapes:

1.Vérifiez la configuration nécessaire2.Installez hMailServer sur le nouveau serveur3.Sauvegardez votre système4.Déplacez les données5.Vérifier la configuration TCP/IP adaptée6.Confirmez la migration

Si c'est la première fois que vous suivez ces étapes, il est recommandé de le faire d'abord avecune installation d'essai avant de passer à une installation de production. Il s'agit de s'assurer quevous comprenez exactement ce que vous devez faire.

Etape 1 - Vérifier la configuration nécessaire

Avant de commencer à déplacer votre installation de hMailServer sur un nouveau serveur, vousdevez vérifier que le nouveau serveur répond à la configuration nécessaire pour hébergerhMailServer. En plus de la configuration standard, les éléments suivant s'appliquent aussi lors dela migration:

Chemin du dossier data

La base de données de hMailServer contient des liens vers les fichiers message sur le disque dur.Pour chaque message de la base de données, le chemin complet du fichier sur le disque dur estspécifié. Ce qui signifie que lorsque vous migrez sur un autre serveur, le dossier Data doit êtreplacé au même emplacement que pour que la migration réussisse. Si le dossier Data est placé surun autre lecteur, par exemple D: au lieu de C:, hMailServer ne pourra plus trouver les messagesaprès la migration.

Etape 2 - Installer hMailServer sur le nouveau serveur

Avant de commencer la migration des données, vous devez installer hMailServer sur le nouveauserveur. Il est essentiel que vous installiez la même version de hMailServer que vous utilisiez surl'ancien serveur, et que vous l'installiez dans le même dossier que sur l'ancien serveur. SihMailServer est installé dans C:\hMailServer sur l'ancien serveur, vous devez l'installer dans lemême chemin de dossier sur le nouveau serveur.

Etape 3 - Sauvegarder votre système

Avant de sauvegarder votre système, vous devez arrêter votre service hMailServer pour être sûrqu'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 données seront copiées manuellement de l'ancien serveurvers le nouveau serveur. La sauvegarde ne sera nécessaire que si quelque chose se passe mal aucours du processus de copie afin de pouvoir restaurer les données sur l'ancien serveur.

Etape 4 - Déplacer les données

Trois éléments sont nécessaires à copier:

Le dossier Data

hMailServer - Guide de l'Utilisateur

105 / 214

Le dossier data contient tous les messages et doit être copié de l'ancien serveur sur le nouveau(sauf s'ils sont situés sur un SAN accessible par les deux serveurs). Il est important de copier lesfichiers dans le même dossier sur le nouveau serveur que sur l'ancien. Si les fichiers sont placéssur C:\Program Files\hMailServer\Data sur l'ancien serveur, ils doivent être situés au mêmeemplacement sur le nouveau serveur.

Personnalisation

Toute personnalisation que vous pouvez avoir effectué dans hMailServer doit être copiée del'ancien serveur vers le nouveau. Cela consiste généralement en des modifications apportées aufichier de script hMailServer.

Base de données

Les tâches impliquées à cette étape dépendent du type de serveur base de données que vousutilisez.

MySQL intégrée

Si vous utilisez le serveur MySQL intégré, vous pouvez copier les dossiers entiers de donnéesMySQL de l'ancien serveur vers le nouveau serveur. Si vous pratiquez ainsi, vous devez égalementcopier le mot de passe de base de données de hMailServer.ini depuis l'ancien serveur vers lenouveau serveur afin que hMailServer puisse se connecter sur le serveur de base de données.

Avant de copier les dossiers, assurez-vous que MySQL et le service hMailServer soient arrêtés.

Serveur MySQL externe

Une méthode consiste à supprimer la base de données de hMailServer sur le nouveau serveur etde copier la base de données hMailServer de l'ancien serveur vers le nouveau, ou d'exporter labase de données de l'ancien serveur puis de l'importer sur le nouveau.

Serveur SQL

Si vous souhaitez déplacer votre base de données hMailServer à une nouvelle installation deMicrosoft SQL Server, une méthode consiste à sauvegarder la base de données et à la restaurersur le nouveau serveur. Si vous avez créé des utilisateurs et des connexions spécifiques àhMailServer, vous devez vous assurer qu'ils existent toujours et sont configurés correctement sur la nouvelle installation

Etape 5 - Configuration adaptée TCP/IP

Après avoir déplacé les données, pensez à:

·Actualiser tout enregistrement MX qui pointait sur l'ancien nom d'hôte.·Actualiser le nom d'hôte dans votre configuration de hMailServer (en cas de modification)·Vérifier 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 accéder à vos messages·Informer vos utilisateurs que la migration est terminée, et demandez-leur (si nécessaire) demettre à jour leur client de messagerie avec les nouvelles informations d'hôte.

Autres

À propos des destinataires du message

hMailServer - Guide de l'Utilisateur

106 / 214

Contexte

Pour un e-mail, il ya deux listes distinctes de destinataires du message. Il y a une liste qui définit àqui le message qui doit être distribué, et une liste qui est affichée aux bénéficiaires dans leursclients de messagerie.

La liste qui définit à qui le message doit être distribué, les destinataires de l'enveloppe SMTP, n'apas à correspondre aux destinataires affichés dans les clients de messagerie (destinataires del'en-tête MIME).

Si, par exemple, vous envoyez un e-mail à [email protected] et que vous [email protected] dans le champ BCC, les utilisateurs seront dans la liste de l'enveloppedes destinataires SMTP, mais seul [email protected] sera placé dans le champ desdestinataires de l'en-tête MIME. Ce qui fait que le serveur de messagerie sait où distribuer lemessage, mais les destinataires ne verront pas [email protected] dans leur client demessagerie.

Les informations ci-dessus s'appliquent de façon tout à fait similaire aux adresses desexpéditeurs. Un message possède une enveloppe d'adresse d'expéditeur SMTP et une adressedans le champ De dans l'en-tête MIME. Ces deux adresses n'ont pas à correspondre. Vous pouvezenvoyer un e-mail à partir de votre propre adresse, mais avec [email protected] l'en-tête De, la rendant ainsi visible du destinataire à qui le message a été envoyé [email protected].

Ceci doit être pris en compte lors du paramétrage des règles, des scripts et lotrs d'un dépannage.

Les spammeurs envoient parfois des messages avec des bénéficiaires d'en-tête MIME necorrespondant pas aux destinataires de l'enveloppe SMTP. Cela peut entraîner l'illusion que vousavez reçu un e-mail qui ne vous a pas été envoyé. Vous pouvez être le destinataire de l'enveloppeSMTP - le destinataire réel - même si vous ne figurez pas dans les en-têtes MIME.

Exemples

Exemple 1:

Le fait que vous voyez votre propre adresse e-mail dans le champ De de votre client demessagerie ne signifie pas que l'e-mail a été envoyé à partir de votre compte. Cela signifiesimplement que l'expéditeur du message voulait que votre adresse soit dans le champ De.

Exemple 2:

Lorsque vous définissez une règle pour transférer un message, le message transféré aura unmême en-tête A mais une liste de destinataires différente. Ce qui est dû au fait que lesdestinataires du message changent, mais pas le contenu réel du message.

Exemple 3:

Si vous recevez un message de spam adressée au [email protected], cela signifieque le spammeur a voulu vous envoyer un e-mail, mais il voulait le faire apparaître comme ayantété envoyé à [email protected].

Méthodes Anti-spam

Anti spam methods

hMailServer - Guide de l'Utilisateur

107 / 214

hMailServer propose un certain nombre de fonctionnalités anti-spam que vous trouverez danshMailServer Administrator, sous Configuration -> Anti-spam. Cette section décrit les différentesoptions.

SPF

SPF signifie Sender Policy Framework (Cadre Stratégique de l'Expéditeur). Les propriétaires dedomaine peuvent, au moyen d'un enregistrement de texte dans leur DNS, identifier les serveursde messagerie qui sont autorisés à envoyer des courriels à partir de leur domaine. Si vous activezSPF dans hMailServer, hMailServer vérifie si l'adresse IP de l'expéditeur correspond à l'adresse IPde l'enregistrement texte du DNS. Sinon, le message sera considéré comme étant indésirable.Vous en saurez plus sur SPF en consultant la page http://spf.pobox.com/. hMailServer ne traiteque les résultats SPF FAIL comme spam.

Vérifier l'hôte dans la commande HELO

Lorsqu'un autre serveur de messagerie distribue un e-mail à hMailServer, il doit s'identifier enenvoyant son propre nom d'hôte. Si vous avez configuré hMailServer pour vérifier l'hôte dans lacommande HELO, hMailServer fera une recherche DNS et confirmera que le serveur d'envoi adonné un nom d'hôte correct.

L'inconvénient de cette méthode est le risque de faux positifs. Bien que cette méthode peut êtreutilisée pour détecter les spams, beaucoup de propriétaires de domaines légitimes ne configurentpas correctement leur serveur.

Vérifier que l'expéditeur a des enregistrements MX DNS

Si vous activez cette option, hMailServer va vérifier si le nom de domaine dans l'adresse email del'expéditeur a des enregistrements MX DNS. Si, par exemple,, [email protected] vous envoie une-mail, hMailServer vérifiera si le domaine, microsoft.com, a des enregistrements MX DNS. Si c'estle cas, le message est accepté. Sinon, il sera abandonné (si le score de spam est au-dessus duseuil d esuppression des spams). Certains spammeurs envoient des messages à partir de fauxdomaines qui n'existent pas. L'activation de cette option évite que hMailServer les accepte.

L'inconvénient de cette option est que le serveur peut refuser des messages légitimes. Si, parexemple, un message automatique est généré par cgi.domain.com et que cgi.domain.com n'a pasd'enregistrements MX valides, le message sera supprimé (en supposant que le score de spam soitsupérieur au seuil de suppression).

SpamAssassin

SpamAssassin est un système populaire anti-spam tierce partie. Il fait des centaines de contrôlessur le message pour déterminer s'il s'agit d'un spam.

Pour utiliser SpamAssassin avec hMailServer, vous devez installer SpamAssassin séparément.

Tarpitting

Tarpitting peut être utilisée pour ralentir la communication entre hMailServer et les spammeurs.Certains spammeurs peuvent cesser d'envoyer des e-mails à votre serveur s'il répond trèslentement à leurs demandes. La fonction suppose que le spammeur envoie un e-mail à plusieursdestinataires sur le serveur pendant une session SMTP. Si le nombre de bénéficiaires dépasse lenombre de Tarpitting, hMailServer va retarder la réponse de chaque bénéficiaire suivant, pour lenombre de secondes spécifié.

Bien que cette méthode de spam arrête les spammeurs, elle peut également entraîner desproblèmes pour les expéditeurs de courriels légitimes. Par conséquent, l'utilisation de cetteméthode de protection anti-spam n'est pas encouragée.

hMailServer - Guide de l'Utilisateur

108 / 214

Listes noires DNS

Les listes noires sont des listes de serveurs de messagerie qui sont connus pour envoyer desspams. Les listes noires sont entretenues par différentes organisations ou individus. Si vousactivez les listes noires dans hMailServer, à chaque fois que hMailServer reçoit un messageélectronique, il va vérifier l'adresse IP de l'expéditeur par rapport aux listes noires que vous avezchoisi d'utiliser. Si l'adresse IP se trouve être dans l'une des listes noires, hMailServer n'accepterapas le message.

Des statistiques différentes existent, mais on sait que les listes noires peuvent réduire vos spamsd'environ 15 à 25%, simplement sur la base de l'adresse IP de l'expéditeur. Sachez que la listenoire peut bloquer des messages électroniques légitimes, par exemple, si un spammeur utilise leserveur de messagerie d'un FAI particulier, qu'il en obtient la liste noire, et qu'il utilise le même FAIque, les e-mails de vos amis seront également bloquées.

SURBL

Les SURBL diffèrent des listes noires DNS en ce qu'ils sont utilisés pour détecter les spams enfonction de l'URL du corps du message (généralement des sites web). Les SURBL ne sont pasdestinés à identifier les expéditeurs de spam par leurs en-têtes de messages ou leurs adresses IPde connexion. Au contraire, ils vous permettent d'identifier les messages par les sites de spammentionnés dans leur corps de message. Cela signifie que lorsque vous avez activé SURBL,hMailServer recherches les liens des messages. Si des liens sont trouvés, hMailServer contrôleavec 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 messagesvers votre serveur. Les listes grises bénéficient du fait que, correctement configurées, les serveursde messagerie vont tenter de renvoyer les messages plus tard, alors que les spammeursnormalement abandonnent immédiatement si votre serveur refuse un e-mail.

Lorsqu'un expéditeur tente de distribuer un message pour la première fois à votre serveur,hMailServer enregistre l'adresse IP de l'expéditeur, l'adresse de messagerie de l'expéditeur etl'adresse de messagerie du destinataire. Ces informations sont nommées un triplet. hMailServerrefusera le message et demandera gentiment à serveur expéditeur de réessayer ultérieurement.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 méthode pour signer le contenu des messages. Ledestinataire peut vérifier que le message est envoyé à partir d'un serveur authentifié pourenvoyer à partir du domaine des expéditeurs, et que le contenu du message n'a pas été modifiépendant le transit.

Si la vérification DKIM est activée, hMailServer va chercher un en-tête de Signature DKIM pourchaque message. Si l'en-tête est trouvé, hMailServer va vérifier que le contenu du messagecorrespond à la signature. Si aucun en-tête de Signature DKIM est inclus, aucune vérification DKIMne sera faite.

Ce test devrait détecter peu de spams, car les spammeurs peuvent simplement ignorer même l'en-tête Signature DKIM.

SpamAssassin

hMailServer 5 et supérieur comprend un système d'intégration de SpamAssassin. Toutefois, leprogramme d'installation du hMailServer ne comprend pas SpamAssassin lui-même. Ce qui signifieque vous devez installer SpamAssassin séparément, avant d'installer hMailServer. Il est possible

hMailServer - Guide de l'Utilisateur

109 / 214

d'utiliser hMailServer avec les ports Windows de SpamAssassin, comme sawin32, et les serveursde SpamAssassin s'exécutant sur d'autres ordinateurs Linux.

Outils externes

Des outils externes, comme ASSP ou SpamAssassin, peuvent être utilisés avec hMailServer pourprévenir des spams. ASSP et SpamAssassin sont des logiciels dont le seul but est de détecter siun e-mail est un spam. Ils offrent donc une fonctionnalité beaucoup plus riche que la protectionanti-spam proposée dans hMailServer.

Mise en cache

Généralités

La communication entre hMailServer et la base de données peut être un goulot d'étranglementlorsque la charge est élevée. Ainsi, afin d'améliorer la performance, un cache a été implémentéavec hMailServer, afin d'éviter certains accès à la base de données en mettant en cache les objetsde base de données dans la mémoire des processus de hMailServer. Si un objet est mis enmémoire cache, hMailServer n'a pas à se connecter à la base de données pour lire à nouveaul'objet. La fonction de mise en cache se trouve dans les paramètres avancés de hMailAdmin.

Comment cela fonctionne t-il?

Lorsque hMailServer doit consulte un objet à partir de la base de données, il examine d'abord lecache pour voir si l'objet y est présent. Si c'est le cas, hMailServer vérifie depuis combien de tempsl'objet a été consulté. Si ce laps de temps dépasse la durée de vie (TTL) définie pour ce typed'objet, celui-ci sera supprimé du cache. Si l'objet n'existe pas dans le cache, ou s'il existe dans lecache mais qu'il est trop ancien, hMailServer consulte l'objet à partir de la base de données etactualise le cache. Si un objet est modifié ou supprimé en utilisant PHPWebAdmin ou hMailAdmin,l'objet sera immédiatement mis à jour dans le cache. Si un objet est modifié ou supprimédirectement dans la base de données par un outil tiers, l'objet sera mis à jour dans la mémoirelorsque son âge dépasse le TTL.

Seul un objet d'un type spécifique peut être mis en cache. Par exemple, lorsque vous mettez encache l'objet Domaine, seul l'objet Domaine est mis en cache. Les sous-objets tels que lescomptes et les alias ne sont pas mis en cache avec le domaine.

La valeur du taux de succès

Le taux de succès vous informe du succès du cache, en montrant la fréquence à laquellehMailServer doit interroger la base de données pour un type d'objet de cache spécifique. Si le tauxde succès pour un type d'objet est de 70%, cela signifie que hMailServer trouve le type d'objetdans la mémoire cache 70% du temps, et doit interroger la base de données seulement 30% dutemps. Augmenter le TTL d'un objet augmente habituellement le taux de succès. LorsquehMailServer recherche un objet et qu'il ne peut pas le localiser ni dans le cache, ni dans la base dedonnées, 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 durée de vie

La valeur TTL par défaut des objets est de 60 secondes. Il est difficile de donner une valeuruniverselle de TTL qui fonctionne pour toutes les configurations de serveur. Par exemple, si vousactualisez les domaines directement dans la base de données, et que vous le faites souvent, 10secondes semble être une bonne valeur. Si vous actualisez les domaines directement dans labase de données, mais que vous le faites pas trop souvent, 60 secondes semble correct. Si vousne mettez à jour les domaines qu'en utilisant PHPWebAdmin ou hMailAdmin, vous pouvez régler leTTL sur 3600 secondes (1 heure). hMailServer n'aura alors à consulter les domaines à partir la

hMailServer - Guide de l'Utilisateur

110 / 214

base de données qu'une fois par heure.

Avantages

·Consulter un objet à partir de la mémoire consomme moins de ressources CPU qu'à partir de labase de données.·Lorsque hMailServer consulte un objet en mémoire, le serveur de base de données n'est pasimpliqué. Ce qui réduit l'utilisation du CPU du serveur de base de données.

Inconvénients

·L'utilisation de la mémoire est toutefois légèrement augmentée, mais que très légèrement.·Si un objet est modifié ou supprimé de la base de données à l'aide d'un outil tiers, hMailServer nesaura rien de celui-ci jusqu'à ce que sa durée de vie soit dépassée.

Garder la cohérence du cache

Si un objet qui est modifié directement dans la base de données existe aussi dans le cache,,hMailServer utilisera l'objet dans le cache, jusqu'à ce qu'il expire. Ce qui peut être gênant danscertaines circonstances. Dans l'idéal, hMailServer devrait toujours utiliser les données les plusrécentes qui se trouvent dans la base de données, mais abaisser le TTL augmente les accès à labase de données. Il existe, néanmoins, trois façons de s'assurer que hMailServer obtient toujoursles données les plus récentes de la base de données:

·Désactiver le cache. S'il n'existe aucun cache, hMailServer accédera directement à la base dedonnées, et obtiendra ainsi les données les plus récentes.·Ne pas actualiser directement la base de données. Si vous n'utilisez que hMailAdmin ou COM, lecache sera toujours cohérent. Dans ce cas, utiliser une très grande durée de vie est absolumentsans danger. C'est en fait l'approche privilégiée, car vous pourrez profiter des avantages d'avoirun cache, tout en évitant la plupart de ses inconvénients (sauf pour la consommation demémoire).·Si vous avez absolument besoin d'actualiser directement la base de données, désactivez lecache. Si vous désactivez le cache avant de mettre à jour la base de données directement, et quevous ré-activez ensuite le cache - les deux sont faisables via COM - vous n'aurez jamais deproblèmes de cohérence; ce pourrait être une meilleure approche que d'attendre l'expiration desobjets, selon ceux que vous actualisez. Bien sûr, une approche plus radicale consiste à arrêter leservice de hMailServer pendant que la base de données est mise à jour manuellement, et à laredémarrer à la fin.

 

API COM

Généralités

L'API COM de hMailServer vous permet d'écrire vos propres scripts et applications qui s'intègrent àhMailServer. La plupart des objets de hMailServer sont accessibles en utilisant la bibliothèqueCOM. A titre d'exemple, hMailServer Administrator et PHP WebAdmin sont entièrement basés sur labibliothèque COM. En plus d'écrire de telles applications, vous pouvez écrire des scripts qui serontautomatiquement exécutés lorsque certains événements se dérouleront. Par exemple, vouspouvez écrire un script qui filtre les messages avant qu'ils ne soient remis aux destinataires.

L'objet Application est l'objet racine du modèle COM de hMailServers. En utilisant cet objet, vouspouvez accéder à tous les objets et paramètres de hMailServer. Avant d'accéder aux propriétés etméthodes de l'objet Application, vous devez appeler Application.Authenticate avec desinformations 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.

hMailServer - Guide de l'Utilisateur

111 / 214

Etapes fondamentales

Ce sont les étapes de base à effectuer lorsque vous souhaitez accéder à l'API COM dehMailServer.

1.Créer une instance de l'objet Application de hMailServer. Le moyen d'y parvenir dépend dulangage de programmation que vous utilisez. En VBScript, appelezCreateObject("hMailServer.Application").2.S'authentifier. Avant de pouvoir appeler d'autres méthodes dans l'API, vous devez vousauthentifier. Ce qui se fait en utilisant la méthode Authenticate() sur l'objet Application. Ceci estnécessaire pour empêcher les utilisateurs non autorisés d'accéder à votre installation dehMailServer.3.Appeler la méthode et utiliser les propriétés nécessaires.

Journal des modifications

Pour une liste des changements dans API COM, consultez la rubrique Journal des Modifications API COM

Référence

·Objets Domain

o Domainso Domain§ Accounts§ Account· IMAPFolders· IMAPFoldero Messageso Message§ Attachments§ Attachment§ Recipients§ Recipient· FetchAccounts· FetchAccount§ Aliases§ Alias§ DistributionLists§ DistributionList· DistributionListRecipients· DistributionListRecipient§ DomainAliases§ DomainAlias

·Settings

o AntiSpamo AntiViruso Cacheo BackupSettingso BlockedAttachmentso BlockedAttachmento DNSBlackListso DNSBlackListo GreyListingWhiteAddresseso GreyListingWhiteAddress

hMailServer - Guide de l'Utilisateur

112 / 214

o Languageo Linkso Loggingo Routeso Route§ RouteAddresses§ RouteAddresso Scriptingo SecurityRangeso SecurityRangeo ServerMessageso ServerMessageo SURBLServerso SURBLServero TCPIPPortso TCPIPPorto Settingso Ruleso Rule§ RuleCriterias§ RuleCriteria§ RuleActions§ RuleActiono WhiteListAddresseso WhiteListAddress

·Objets Server-wide

o Applicationo Backupo BackupManagero Databaseo DeliveryQueueo GlobalObjectso Statuso Utilities

·Objets Scripting-wide

o Cliento 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'ExplorateurWindows pour l'exécuter. Avant de faire cela, assurez-vous de bien comprendre le but du script etl'effet qu'il peut avoir sur votre installation de hMailServer. Nous vous recommandons fortementd'exécuter les scripts dans un environnement de test avant de les exécuter sur une installation dehMailServer utilisée pour la production.

·Changer le mot de passe d'un compte·Copier un message d'un dossier IMAP à un autre·Créer un compte·Supprimer un compte·Activer un domaine·Énumérer les dossiers IMAP appartenant à un compte spécifique·Envoyer un message

Objet Account

hMailServer - Guide de l'Utilisateur

113 / 214

Description

L'objet account représente un simple compte hMailServer.

Méthodes

Delete()

Supprime le compte de la base de données.

DeleteMessages()

Supprime tous les messages qui existent ddans le compte.

Save()

Enregistre le compte dans la base de donnéess.

UnlockMailbox()

Déverrouille la boîte aux lettres POP3.

ValidatePassword(string Password)

Valide le mot de passe. Retourne true si le mot de passe est correct.

Propriétés

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 données du domaine auquel appartient le compte.

FetchAccounts FetchAccounts

Chargement externe des comptes liés à ce compte.(lecture seule)

string ForwardAddress

Adresse du compte auquel ces messages sont à transférer.

bool ForwardEnabled

Le transfert à ce compte est activé.

hMailServer - Guide de l'Utilisateur

114 / 214

bool ForwardKeepOriginal

Garder le message d'origine après l'application du transfert.

long ID

L'identificateur de base de données 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 dernière utilisation de ce compte.(lecture seule)

long MaxSize

Taille maximum dans le compte (Mo).

Messages Messages

Messages dans le boîte aux lettres du compte.(lecture seule)

string Password

Le mot de passe du compte.

string PersonFirstName

Prénom du titulaire du compte.

string PersonLastName

Nom du titulaire du compte.

long QuotaUsed

Pourcentage de cota utilisé (0-100).(lecture seule)

Rules Rules

Les règles spécifiées 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

hMailServer - Guide de l'Utilisateur

115 / 214

La taille du compte.(lecture seule)

string VacationMessage

Le message d'absence

bool VacationMessageExpires

Le message d'absence est réglé 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 connectés à un domaine spécifique.

Méthodes

Add()

Ajoute un nouvel élément à la collection.

Delete(long Index)

Supprime un élément par son index donné dans la collection.

DeleteByDBID(long DBID)

Supprime un compte dans la base de données pour son identificateur de base de données donné.

Refresh()

Rafraîchit la collection

Propriétés

long Count

Retourne le nombre d'éléments 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 donnée.

hMailServer - Guide de l'Utilisateur

116 / 214

(lecture seule)

Account ItemByDBID(long DBID)

Retourne un compte par son identificateur de base de données donné.(lecture seule)

Objet Alias

Description

L'objet Alias représente un alias de hMailServer.

Méthodes

Delete()

Supprime l'alias de la base de données.

Save()

Enregistre l'alias dans la base de données.

Propriétés

bool Active

L'alias est actif.

long DomainID

L'identificateur du domaine auquel l'alias appartient.

long ID

L'identificateur unique de base de données 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 connectés à un domaine spécifique.

Méthodes

Add()

Ajoute un nouvel alias à la collection.

Delete(long Index)

hMailServer - Guide de l'Utilisateur

117 / 214

Supprime l'alias avec l'index spécifié.

DeleteByDBID(long DBID)

Supprime un alias par son identificateur de base de données donné.

Refresh()

Rafraîchit la collection.

Propriétés

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 données donné.(lecture seule)

Alias ItemByName(string Name)

Retourne un alias par son nom.(lecture seule)

Objet AntiSpam

Description

L'objet AntiSpam contient tous les paramètres au niveau serveur liés à l'anti-spam.

Méthodes

ClearGreyListingTriplets()

Efface les triplets de la liste grise.

Propriétés

bool AddHeaderReason

Ajoute l'en-tête X-hMailServer-Reason si un spam est trouvé.

bool AddHeaderSpam

Ajoute l'en-tête X-hMailServer-Spam si un spam est trouvé.

bool CheckHostInHelo

Vérifie l'hôte spécifié dans la commande HELO.

long CheckHostInHeloScore

Vérifie l'hôte spécifié dans la commande HELO (SpamScore).

hMailServer - Guide de l'Utilisateur

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é après ce temps (heures).

long GreyListingInitialDelay

GreyListing - Délai avant acceptation des messages (minutes).

long GreyListingInitialDelete

GreyListing - Supprime le triplet utilisé après ce temps (heures).

GreyListingWhiteAddresses GreyListingWhiteAddresses

Liste blanche pour liste grise.(lecture seule)

long MaximumMessageSize

Taille maximum de message pour exécuter l'anti-spam actif.

bool PrependSubject

Préfixer l'objet du message.

string PrependSubjectText

Texte pour préfixer le sujet du message.

bool SpamAssassinEnabled

Antispam: Activer l'intégration de SpamAssassin

string SpamAssassinHost

Antispam: Nom d'hôte 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

hMailServer - Guide de l'Utilisateur

119 / 214

Collection des serveurs SURBL.(lecture seule)

long TarpitCount

Compte Tarpit.

long TarpitDelay

Délai Tarpit.

bool UseMXChecks

Antispam: Utiliser les vérifications MX.

long UseMXChecksScore

Antispam: Utiliser les vérifications (score).

bool UseSPF

Antispam: Utiliser SPF.

long UseSPFScore

Antispam: Utiliser SPF (score).

WhiteListAddresses WhiteListAddresses

Liste blanche générale.(lecture seule)

Objet AntiVirus

Description

L'objet Anti virus paramètre les examens relatifs aux virus.

Propriétés

eAntivirusAction Action

Action.

BlockedAttachments BlockedAttachments

Pièces jointes bloquées(lecture seule)

string ClamWinDBFolder

Dossiier de base de données ClamWIn.

bool ClamWinEnabled

ClamWin activé.

string ClamWinExecutable

Chemin de l'exécutable ClamWin.

bool CustomScannerEnabled

Examen personnalisé activé.

hMailServer - Guide de l'Utilisateur

120 / 214

string CustomScannerExecutable

Chemin de l'exécutable personnalisé.

long CustomScannerReturnValue

Valeur de retour d'examen personnalisée.

bool EnableAttachmentBlocking

Activer le blocage des pièces jointes.

long MaximumMessageSize

Taille maximum d'un message lors de l'exécution de l'antivirus (Ko).

bool NotifyReceiver

Avertir le destinataire qu'un e-mail a été supprimé.

bool NotifySender

Avertir l'expéditeur 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 installationhMailServer. Le script est écrit en VBA. Pour l'utiliser, suivez ces étapes:

1.Copiez le script dans un éditeur de texte2.Enregistrez-le avec pour extension .vbs, par exemple Exemple.vbs3.Dans l'Explorateur Windows, double-cliquez sur le fichier .vbs pour l'exécuter.

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("[email protected]") ' Set the password to "secret" obAccount.Password = "secret" obAccount.Save

API Exemple: Copier un message dans un nouveau dossier IMAP

Généralités

Cet exemple indique comment copier un message d'un dossier IMAP vers un autre. Le scriptnécessite hMailServer 5 ou supérieur.

hMailServer - Guide de l'Utilisateur

121 / 214

Copier un message

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", "secret") ' 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("[email protected]") 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: Créer un compte

Cet exemple indique comment ajouter un nouveau compte à un domaine existant de votreinstallation hMailServer. Le script est écrit en VBA. Pour l'utiliser, suivez ces étapes:

1.Copiez le script dans un éditeur de texte2.Enregistrez-le avec pour extension .vbs, par exemple Exemple.vbs3.Dans l'Explorateur Windows, double-cliquez sur le fichier .vbs pour l'exécuter.

Créer 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", "your-main-hmailserver-password") ' 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.Add ' Set the account properties obAccount.Address = "[email protected]" obAccount.Password = "secret"

hMailServer - Guide de l'Utilisateur

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 installationhMailServer. Le script est écrit en VBA. Pour l'utiliser, suivez ces étapes:

1.Copiez le script dans un éditeur de texte2.Enregistrez-le avec pour extension .vbs, par exemple Exemple.vbs3.Dans l'Explorateur Windows, double-cliquez sur le fichier .vbs pour l'exécuter.

Supprimer 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", "your-main-hmailserver-password") ' Locate the domain we want to add the account to Dim obDomain Set obDomain = obApp.Domains.ItemByName("example.com") ' 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 accountobject. Dim obAccount Set obAccount = obDomain.Accounts.ItemByAddress("[email protected]") obDomain.Accounts.DeleteByDBID obAccount.ID

API exemple: Activer un domaine

Cet exemple indique comme activer un domaine existant de votre installation hMailServer. Le scriptest écrit en VBA.

Activer un domaine

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", "your-main-hmailserver-password") ' Locate the domain we want to add the account to Dim obDomain Set obDomain = obApp.Domains.ItemByName("example.com") 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'APICOM de hMailServer. Le script affichera une liste déroulante de tous les dossiers IMAP (y comprisles sous-dossiers) appartenant au compte [email protected].

hMailServer - Guide de l'Utilisateur

123 / 214

Dresser la liste des dossiers d'un utilisateur

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", "<administrator-password>") ' 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("[email protected]") 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 oMessageSet oMessage = CreateObject("hMailServer.Message")oMessage.From = "Me"oMessage.FromAddress = "[email protected]"oMessage.Subject = "Hi"oMessage.AddRecipient "My friend", "[email protected]"oMessage.Body = "This is the contents of the email."oMessage.Save

hMailServer - Guide de l'Utilisateur

124 / 214

Objet Application

Description

L'objet Application est l'objet racine de l'API de hMailServer. C'est le premier objet que vous devezcréer si vous souhaitez accéder à l'API de hMailServer

Méthodes

Authenticate(string Username, string Password)

Authentifier le client.

Connect()

Ouvrir une connexion à la base de données de hMailServer.

Reinitialize()

Réinitialiser tous les paramètres du serveur

Start()

Démerrer un serveur hMailServer.

Stop()

Arrêter un serveur hMailServer.

SubmitEMail()

Mettre en attente un e-mail. Peut être déclenchée si un courriel a été insérée manuellement dansla base de données.

Propriétés

BackupManager BackupManager

Accède au gestionnaire de sauvegarde.(lecture seule)

Database Database

Accède à l'interface de base de données.(lecture seule)

Domains Domains

Accède à la collection des Domaines.(lecture seule)

GlobalObjects GlobalObjects

Accède à l'objet Objects général.(lecture seule)

string InitializationFile

Le fichier d'initialisation en cours d'utilisation.(lecture seule)

Links Links

hMailServer - Guide de l'Utilisateur

125 / 214

Liens rapides pour accéder aux objets(lecture seule)

Rules Rules

Obtient une colleciton des règles générales.(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 représente une simple pièce jointe de message.

Méthodes

Delete()

Supprime cette pièce jointe du message.

SaveAs(string sName)

Enregistre la pièce jointe dans un fichier sous ne nom indiqué.

Propriétés

string Filename

Le nom de fichier de la pièce jointe.(lecture seule)

long Size

La taille de la pièce jointe.(lecture seule)

Objet Attachments

hMailServer - Guide de l'Utilisateur

126 / 214

Description

L'objet Attachments est une collection de toutes les pièces jointes d'un seul message.

Méthodes

Add(string sFilename)

Ajoute une pièce jointe à la collection.

Clear()

Supprime toutes les pièces jointes du message.

Propriétés

long Count

Le nombre d'objets de la collection.(lecture seule)

Attachment Item(long Index)

Retourne une pièce jointe par son index donné.(lecture seule)

Objet Backup

Description

L'objet Backup représente une simple sauvegarde de hMailServer.

Méthodes

StartRestore()

Lance une restauration de cette sauvegarde.

Propriétés

bool ContainsDomains

Contient les domaines.(lecture seule)

bool ContainsMessages

Contient les messages.(lecture seule)

bool ContainsSettings

Contient les paramètres.(lecture seule)

bool RestoreDomains

Restaure les domaines.

hMailServer - Guide de l'Utilisateur

127 / 214

bool RestoreMessages

Restaure les messages.

bool RestoreSettings

Restaure les paramètres.

Objet BackupManager

Description

L'objet BackupManager est l'objet qui lance et restaure les sauvegardes.

Méthodes

LoadBackup(string sXMLFile)

Charge un sauvegarde à partir d'un fichier.

StartBackup()

Lance une sauvegarde.

Objet BackupSettings

Description

L'objet BackupSettings contient tous les paramètres relatifs à la sauvegarde.

Properties

bool BackupDomains

Sauvegarder les domaines.

bool BackupMessages

Sauvegarder les messages.

bool BackupSettings

Sauvegarder les paramètres.

bool CompressDestinationFiles

Compresser les fichiers de destination

string Destination

Sauvegarder la destination

string LogFile

Sauvegarder le fichier journal(lecture seule)

Objet BlockedAttachment

hMailServer - Guide de l'Utilisateur

128 / 214

Description

L'objet BlockedAttachment représente une simple extension de fichier bloqué (ou un joker).

Méthodes

Delete()

Supprime l'objet.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

string Description

Description pour le bocage.

long ID

L'identificateur unique de l'objet dans le base de données.(lecture seule)

string Wildcard

Joker pour la pièce jointe bloquée.

Objet BlockedAttachments

Description

L'objet BlockedAttachments est une collection de toutes les pièces jointes bloquées del'installation de hMailServer.

Méthodes

Add()

Ajoute un nouvel objet à la collection.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son identificateur de base de données.

Refresh()

Rafraîchit la collection.

Propriétés

long Count

Le nombre d'objets de la collection.(lecture seule)

BlockedAttachment Item(long Index)

hMailServer - Guide de l'Utilisateur

129 / 214

Retourne une pièce jointe bloquée par son index.(lecture seule)

BlockedAttachment ItemByDBID(long DBID)

Retourne une pièce jointe bloquée par son identificateur de base de données(lecture seule)

Objet Cache

Description

L'objet Cache contient tous les paramètres relatifs à la mise en cache de hMailServer.

Méthodes

Clear()

Efface le et réinitialise les statistiques.

Propriétés

long AccountCacheTTL

Temps de cache du compte (en secondes).

long AccountHitRate

Taux de succès du compte(lecture seule)

long AliasCacheTTL

Temps de cache de l'alias (secondes).

long AliasHitRate

Taux de succès de l'alias.(lecture seule)

long DistributionListCacheTTL

Temps de cache de la liste de distribution (secondes).

long DistributionListHitRate

Taux de succès de la liste de distribution.(lecture seule)

long DomainCacheTTL

Temps de cache du domaine (secondes).

long DomainHitRate

Taux de succès du domaine.(lecture seule)

bool Enabled

Le cache est activé.

hMailServer - Guide de l'Utilisateur

130 / 214

Objet Client

Description

L'objet Client est un objet temporaire utilisé dans les événements hMailServer qui autorise lesscripts pour vérifier l'adresse et le nom d'utilisateur du client connecté.

Propriétés

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 énumère brièvement les changements effectués à l'API COM.

hMailServer 5.0

Changements rompant la rétrocompatibilitéAPI COM: Structure API

hMailServer 5 inclut de nombreuses fonctionnalités nouvelles. Certaines fonctionnalités dehMailServer 4 ont été refondées, ce qui a eu aussi pour effet de refonder les API correspondants.De ce fait, hMailServer 5 a eu ses API modifiés qui rompent la rétrocompatibilité.

Les objets suivants n'existent plus. Leur contenu a été déplacé dans l'objet TCPIPPort

·IPHomes·IPHome

Les propriétés suivantes n'existent plus:

·Aliaso Type - Cette propriété a été supprimée depuis qu'elle n'est plus utilisée.

·AntiSpamo AntiSpamAction - Cette propriété n'existe plus depuis que la fonctionnalité anti-spam de la

version 5 est basée sur le score.·Backup

o OverwriteObjects - Cette propriété a été supprimée depuis qu'elle n'est plus utilisée - lafonctionnalité correspondante dans la fonction de sauvegarde a été supprimée.

o DeleteObjectsNotInBackups - Cette propriété a été supprimée depuis qu'elle n'est plusutilisée - la fonctionnalité correspondante dans la fonction de sauvegarde a été supprimée.

·GlobalObjectso La propriété Language a été supprimée et remplacée par une propriété Languages qui

renvoie à une collection de langages.·Language

o La signature de la propriété String a été actualisée.·Settings

o POP3Port. Cette propriété n'est plus pertinente depuis que hMailServer peut surveiller

hMailServer - Guide de l'Utilisateur

131 / 214

plusieurs ports.o SMTPPort. Cette propriété n'est plus pertinente depuis que hMailServer peut surveiller

plusieurs ports.o TarpitDelay - Cette propriété a été déplacée dans l'objet AntiSpam.o TarpitCount - Cette propriété a été déplacée dans l'objet AntiSpam.o IMAPPort - Cette propriété n'est plus pertinente depuis que hMailServer peut surveiller

plusieurs ports.o UseSPF - Cette propriété a été déplacée dans l'objet AntiSpam.o UseMXChecks - Cette propriété a été déplacée dans l'objet AntiSpam.o DNSBlackLists - Cette propriété a été déplacée dans l'objet AntiSpam.o ListenOnAllAddresses - Cette propriété n'est plus pertinente depuis que la configuration des

surveillances de hMailServer de différents ports a été modifiée.o IPHomes - Cette propriété n'est plus pertinente depuis que les objets Homes/IPHome

n'existent plus.

Les éléments suivants ont été changés:

·Domainso ItemByName a été changé de Méthode à Propriété

Les méthodes et propriétés suivantes ont été ajoutées aux objets existants:

·Accounto PersonFirstName - Obtient ou définit le prénom du propriétaire du compte.o PersonLastName - Obtient ou définit le nom du propriétaire du compte.o Delete - Supprime le compte de la base de données.

·Aliaso Delete - Supprime l'alias de la base de données.

·AntiSpamo CheckHostInHeloScore - Obtient ou définit une valeur déterminant si hMailServer doit vérifier

l'hôte HELO des expéditeurs 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 définit la taille maximum d'un message que sera

examiné par hMailServer pour une recherche de spam.o SpamMarkThreshold - Obtient ou définit le seuil de marquage du spam.o SpamDeleteThreshold - Obtient ou définit le seuil de suppression du spam.o SpamAssassinEnabled - Obtient ou définit une valeur déterminant si l'intégration de

SpamAssassin est activée.o SpamAssassinScore - Obtient ou définit le score SpamAssassin.o SpamAssassinMergeScore - Obtient ou définit une valeur déterminant si hMailServer doit

utiliser le score de spam de SpamAssassin.o SpamAssassinHost - Obtient ou définit le nom d'hôte du serveur qui exécute SpamAssassin.o SpamAssassinPort - Obtient ou définit le port du serveur de SpamAssassin.o TarpitDelay - Obtient ou définit délai de répulsion.o TarpitCount - Obtient ou définit délai de répulsion.o UseSPF - Obtient ou définit une valeur déterminant si hMailServer doit exécuter les

vérifications SPF lors de la protection anti-spam.o UseSPFScore - Obtient ou définit le score SPF.o UseMXChecks - Obtient ou définit une valeur déterminant si hMailServer doit effectuer les

vérifications MX lors de la protection anti-spam.o UseMXChecksScore - Obtient ou définit le score des vérifications MX.

·BlockedAttachmento Delete - Supprime l'objet de la base de données.

·Databaseo CreateInternalDatabase - Crée une base de données interne utilisant MSSQL Compact

Edition.o CreateExternalDatabase  - Crée une base de données externe utilisant les informations de

connexion fournies.o DatabaseExists - Obtient une valeur qui détermine si les paramètres de base de données

dans hMailServer.ini semblent valides.o BeginTransaction - Lance une nouvelle transaction SQL.o CommitTransaction - Engage un transaction SQL.o RollbackTransaction - Restaure une transaction SQL.o ExecuteSQLScript - Exécute un script SQLo SetDefaultDatabase - Règle les paramètres par défaut de la base de données dans

hMailServer.ini.

hMailServer - Guide de l'Utilisateur

132 / 214

o IsConnected - Obtient une valeur qui détermine si hMailServer a pu se connecter à la basede données.

o ServerName - Obtient le nom du serveur de base de données auquel hMailServer estconnecté.

o DatabasName - Obtient le nom de la base de données à laquelle hMailServer est connecté·DNSBlackLists

o Score - Obtient ou définit le score de spam pour la liste noire DNS.o Delete - Supprime l'objet de la base de données.

·FetchAccounto UseSSL - Obtient ou définit une valeur qui détermine 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 chaîne contenant la date et l'heure de la prochaine

tentative de téléchargement.·GreyListingWhiteAddress

o Delete - Supprime l'élément de la base de données.·IMAPFolder

o Save - Enregistre les changements effectués au dossier IMAP dans la base de données.o ParentID - Obtient l'identificateur de base de données pour le dossier IMAP parent.o Permissions - Obtient une collection contenant les permissions ACL.o Delete - Supprime l'objet de la base de données.

·Languageo Name - Obtient le nom du langage.

·Loggingo CurrentAwstatsLog - Obtient le nom du fichier journal awstats actuel.o CurrentEventLog - Obtient le nom di fichier journal d'événement actuel.o CurrentErrorLog - Obtient le nom du fichier journal d'erreur actuel.o CurrentDefaultLog - Obtient le nom du journal par défaut en cours.o KeepFilesOpen - Obtient ou définit une valeur qui détermine si hMailServer doit garder les

fichiers journaux ouverts entre les écritures.·Message

o Charset - Obtient ou définit le jeu de caractères du message.o Copy - Copie le message dans le dossier IMAP spécifié (doit être le même que le compte

utilisateur).·Messages

o Add - Ajoute un nouveau message à la collectiono Clear - Supprime tous les messages de la collection.

·Recipiento OriginalAddress - Obtient l'adresse originale du destinataire (comme spécifié lors de la

conversation SMTP)·Route

o UseSSL - Obtient ou définit une valeur qui détermine si hMailServer doit utiliser SSL lorsd'une connexion à l'itinéraire.

o Description  - Obtient ou définit une description de l'itinéraire.o Delete - Supprime l'itinéraire de la base de données.

·RouteAddresso Delete - Supprime l'adresse de l'itinéraire de la base de données.

·Ruleo Delete - Supprime la règle de la base de données.

·RuleActiono HeaderName - Obtient ou définit le nom de l'en-tête à modifiero Value - Obtient ou définit la valeur de l'en-tête à modifier.o Delete - Supprime l'objet de la base de données.

·RuleCriteriao Delete - Supprime le critère de règle de la base de données.

·Scriptingo CurrentScriptFile - Le fichier de script en cours d'utilisation.

·SecurityRangeo EnableAntiVirus - Obtient ou définit une valeur qui détermine si l'antivirus est activé pour la

plage IP.o Delete - Supprime la plage IP de la base de données.

·SecurityRangeso SetDefault - Rétablit tous les réglages de la plage IP pour les paramètres par défaut de

hMailServer. Toute plage IP ajoutée qui ne fait pas partie de la configuration par défaut est

hMailServer - Guide de l'Utilisateur

133 / 214

supprimée.·ServerMessages

o ItemByName - Retourne un message au serveur par son nom.·Settings

o SMTPRelayerUseSSL - Obtient ou définit la valeur qui détermine si hMailServer doit utiliserSSL lors d'une communication vec le relais SMTP.

o SSLCertificates - Obtient une collection des certificats SSL qui ont été définis danshMailServer.

o AddDeliveredToHeader - Obtient ou définit la valeur qui détermine si hMailServer doitajouter un en-tête Distribué A aux messages reçus.

o IMAPPublicFolderName - Obtient ou définit le nom du dossier public.o IMAPACLEnabled - Obtient ou définit la valeur qui détermine si l'extension ACL dans le

protocole IMAP doit être activé.o SetAdministratorPassword - Définit le mot de passe de hMailServer Administrator.o Directories  - Obtient un objet Directories qui contient les paramètres du répertoire lié.o PublicFolders - Obtient une collection de dossiers publics.o PublicFolderDiskName  - Obtient le nom du dossier répertoire où les dossiers public sont

stockés.o Groups - Obtient une collection de groupes étendus de serveurs

·SURBLServero Score - Obtient ou définit le score de spam pour le serveur SURBL.o Delete - Supprime le serveur SURBL de la base de données.

·TCPIPPorto Address - Obtient ou définit l'adresse IP locale que hMailServer doit surveiller.o UseSSL - Obtient ou définit une valeur déterminant si hMailServer doit s'attendre à des

connexions SSL sur ce port.o SSLCertificateID - Obtient ou définit une valeur déterminant l'ID des certificats SSL à utiliser

pour ce port.o Delete - Supprime l'objet de la base de données.

·TCPIPPortso SetDefault - Rétablit la configuration TCP / IP pour les valeurs par défaut.

·Utilitieso IsStrongPassword - Retourne true si le passeport défini apparaît comme étant assez forte.

Notez que les exigences pour qu'un mot de passe soit considéré comme fort sont faibles.o SHA256 - Retourne un hachage SHA256 pour la chaîne donnée.

·WhiteListAddresso Delete - Supprime l'élément de la base de données.

·WhiteListAddresseso Clear - Efface la collection

hMailServer 4.4

Changements rompant la rétrocompatibilité

Aucun changement n'a été effectué à l'API COM de hMailServer qui rompt la compatibilité avec lesversions précédentes.

Nouveaux événements

·OnDeliveryStart - Cet événement est exécuté directement après le démarrage de la distributiond'un e-mail, avant que les règles générales soient exécutées.

Nouveaux objets

·WhiteListAddresses - Collection de toutes les adresses de la liste blanche.·WhiteListAddress - Une adresse vers la liste blanche.

Changements des objets existants

hMailServer - Guide de l'Utilisateur

134 / 214

Aucune propriété ou méthode n'a été supprimée dans hMailServer 4.4. Ci-dessous la liste despropriétés ajoutées

·AntiSpamo WhiteListAddresses - Retourne une collection avec les adresses de la liste blanche.

 ·Account

o LastLogonTime - L'horodatage de la dernière 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 - Durée du cache pour les alias (secondes)o AliasHitRate - Taux de consultation du cache de l'alias.o DistributionListCacheTTL - Durée du cache pour les listes de diffusion (secondes)o DistributionListHitRate - Taux de consultation du cache des listes de diffusion.

·Domaino MaxNumberOfAccounts - Nombre maximum de comptes qui peuvent être ajoutés au

domaine. *o MaxNumberOfAliases - Nombre maximum d'alias qui peuvent être ajoutés au domaine. *o MaxNumberOfDistributionLists - Nombre maximum de listes de diffusion qui peuvent être

ajoutées 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 ajoutés à ce domaine *

* Notez que ces propriétés ne font pas, en fait, appliquer les limitations. Pour l'instant, ceslimitations nécessitent d'être exécutées dans la couche de l'interface utilisateur de l'application(elles soont exécutées dans hMailServer Administrator et PHPWebAdmin). L'exécution dans lecœur du serveur nécessiterait une refonte des éléments internes. Ce qui est prévu pourhMailServer 5. 

·IMAPFolderso Add - Ajoute un nouveau dossier IMAP à la collectiono DeleteByDBID - Supprime un dossier IMAP avec l'identificateur de base de données attribué.

 ·Message

o InternalDate - La date interne du message (l'heure à laquelle le message a été créé danshMailServer) 

·Utilitieso ImportMessageFromFileToIMAPFolder - Importe un fichier message à partir du dossier du

disque et le place dans un dossier IMAP spécifique. 

·SecurityRangeo IsForwardingRelay - Spécifie si la plage IP couvre le relais de transfert, par exemple une

sauvegarde MX. 

·FetchAccounto DownloadNow - Force désormais un téléchargement des messages depuis un compte

externe.o ProcessMIMEDate - Activer le traitement de la date de réception dans l'en-tête Reçu.

 ·Rule

o MoveUp - Déplace la règle vers le haut dans l'ordre de traitement.o MoveDown - Déplace la règle vers le bas dans l'ordre de traitement.

 ·RuleAction

o MoveUp - Déplace l'action de la règle vers le haut dans l'ordre de traitement.o MoveDown - Déplace l'action de la règle vers le bas dans l'ordre de traitement.

 

hMailServer - Guide de l'Utilisateur

135 / 214

hMailServer 4.3

Changements rompant la rétrocompatibilité

Dans hMailServer 4.3, les clients COM doivent appeler la fonction Authenticate() de l'objethMailServer.Application avant d'accéder aux autres fonctions dans l'API. Ces changements ont étéeffectués pour augmenter la sécurité de l'API COM de hMailServer.

L'exception à ceci est l'objet Message. Les clients COM peuvent créer et envoyer des messages enutilisant l'objet hMailServer.Message sans appeler la méthode Authenticate.

Si vous devez passer à hMailServer 4.3, et que vous ne pouvez pas actualiser votre client COM,une alternative consiste à régler AdministratorPassword dans hMailServer.ini sur empty. Si vous lefaites, vous n'aurez pas à appeler Authenticate method()

Nouveaux objets

·SURBLServers - Collection de tous les serveurs SURBL mis en place dans le système·SURBLServer - Contient les propriétés pour un simple serveur SURBL·AntiSpam - Configuration relative à AntiSpam·BlockedAttachments - Collection de tous les objets mis en place dans l'examen antiviral / leblocage des pièces jointes.·BlockedAttachment - Propriétés d'une pièce jointe présente dans l'examen antivirral / les piècesjointes bloquées·ServerMessages - Collection des messages texte utilisés par le serveur (notification de virus, parexemple)·ServerMessage - Un message en texte clair utilisé par le serveur·GreyListingWhiteAddresses - Une collection de toutes les adresses blanches spécifiées dans lesoptions de la liste grise·GreyListingWhiteAddress - Une simple adresse blanche de liste grise·TCPIPPorts - Une collection de tous les ports TCP/IP qui doivent être utilisés·TCPIPPort - Propriétés d'un simple port TCP/IP

Enumération des nouveautés

·eRuleActionType, Added value: eRARunScriptFunction, - Exécuter d'une fonction de script·eAntiSpamAction - Action à prendre si un spam a été détecté·eDistributionListMode - Mode de liste de diffusion·eSessionType - Type de session (SMTP/POP3/IMAP)·eDomainSignatureMethod - Spécifie comment les signatures sont à appliquer (ajout,remplacement, t ainsi de suite)·eMessageFlag - Contient des indicateurs de message (vus, supprimés, et ainsi de suite)

Changements sur les objets existants

Aucune propriété ou méthode n'a été supprimée dans hMailServer 4.3. Ci-dessous le liste despropriétés ajoutées

·Applicationo 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 transférés.o ForwardKeepOriginal - Garder le message original après l'application du transfert.o SignatureEnabled - Activer la signatureo SignaturePlainText - La version en texte clair de la signature

 ·AntiVirus

o MaximumMessageSize - Taille maximale du message lors de l'exécution de l'antivirus (Ko).

hMailServer - Guide de l'Utilisateur

136 / 214

o BlockedAttachments - Collection de tous les types de pièces jointes bloquéeso EnableAttachmentBlocking - Activer le blocage des pièces jointes

 ·Database

o RequiresUpgrade - La base de données nécessite une mise à jour. 

·DeliveryQueueo Remove - Supprime le message de la file d'attente de distribution.

 ·DistributionList

o Mode - Mode de liste de diffusion 

·Domaino PlusAddressingEnabled - Utiliser l'adressage plus pour ce domaine.o PlusAddressingCharacter - Caractère 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 signatureo SignatureMethod - La méthode de signature du domaineo SignaturePlainText - La version texte claiir de la signatureo SignatureHTML - The HTML version of the signatureo AddSignaturesToReplies - Ajouter les signatures aux réponses du messageo AddSignaturesToLocalMail - Ajouter les signatures au message local

 ·FetchAccount

o ProcessMIMERecipients - Envoyer un message aux destinataires des en-têtes Reçu/A/CC. 

·Loggingo MaskPasswordsInLog - Masquer les mots de passe avant de les écrire dans le fichier

journal. 

·Messageo Flag - Retourne l'état d'un indicateur de message (supprimé, vu, etc)

 ·RuleAction

o ScriptFunction - Lorsque le type d'action est réglé sur eRARunScriptFunction, cette fonctionest exécutée 

·Statuso SessionCount - Nombre de sessions par type de session

 ·Settings

o DefaultDomain - Domaine à utiliser si le domaine n'a pas été spécifié lorsque l'utilisateur seconnecte.

o SMTPDeliveryBindToIP - L'adresse TCP / IP à laquelle se lier lors de la distribution demessages à des hôtes distants.

o MaxIMAPConnections - Nombre maximum des connexions IMAP simultanées.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 travailo TCPIPThreads - Nombre de processus TCP/IP (pour la communication) à exécuter.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 paramètres relatifs à Anti spam.o DisconnectInvalidClients - Déconnecter les clients qui ne suivent pas les RFCo MaxNumberOfInvalidCommands - Nombre maximum de commandes de client non valides

avant déconnexion.o ServerMessages - Retourne l'objet ServerMessage contenant des chaînes de texte utilisées

par le serveur.o TCPIPPorts - Une collection de tous les ports TCP/IP à utiliser

hMailServer - Guide de l'Utilisateur

137 / 214

 ·Utilities

o IsLocalHost - Vérifier si le nom d'hôte donné pointe sur localhost.

 

API COM: Structure API

Généralités

La plupart du temps, hMailServer se comporte comme tout autre API COM. Cependant, certaineschoses sont bonnes à savoir avant de commencer à écrire du code qui utilise l'API COMhMailServer.

Accéder à un objet

Quel que soit l'objet hMailServer auquel vous souhaitez accéder, vous devez passer par l'objetApplication de hMailServer. Par exemple, pour accéder à un domaine spécifique, vous devez créerune instance de l'objet hMailServer.Application, récupérer une collection de tous les domaines àl'aide de la propriété Domaines, puis recherchez le domaine spécifique. Il n'est pas possible decréer une instance de la collection hMailServer.Domains pour récupérer le nom de domainespécifique. La raison de ce comportement réside dans les mécanismes d'authentification de l'APICOM.

Manipulation des exceptions

L'API COM hMailServer génère une exception dans les cas suivants:

·Lorsque vous essayez de créer un nouvel objet avec le même nom que celle qui existe. Parexemple, si vous essayez de créer deux comptes avec la même adresse, une exception seragénérée.·Si une erreur de base de données se produit. Si la connexion au serveur de base de données estperdue, ou qu'un autre problème de base de données se produit, une exception sera générée.·Si les autorisations client ne suffisent pas. Avant de pouvoir accéder aux objets de l'API COMhMailServer, vous devez d'abord vous authentifier (à l'aide d'authentification dehMailServer.Application). Si vous essayez d'accéder à un objet pour lequel vous n'avez pas lapermission d'accès, une exception sera générée. Par exemple, si vous vous authentifiez en tantqu'utilisateur avec des droits au niveau utilisateur, une exception sera générée si vous essayezd'accéder aux paramètres généraux du serveur.·Une exception sera générée si vous essayez d'accéder à un élément inexistant dans unecollection. Par exemple, ItemByName appelant () sur la collection hMailServer.Domains lèvera uneexception si le domaine ne peut pas être trouvé.

Créer de nouveaux objets

Pour créer un nouvel objet, vous exécutez généralement Add() sur la collection parent. Parexemple, pour ajouter un nouveau domaine, exécutez Add() sur la collection Domaines. Laméthode Add() retournera un nouvel objet. Ce nouvel objet n'existera qu'en mémoire, et vousaurez à exécuter la méthode Save() sur l'objet pour l'enregistrer dans la base de données.Lorsque vous exécutez Save(), l'objet est enregistré dans la base de données et ajouté à lacollection.

 

Objet Database

Description

L'objet Database contient les informations sur la mise en place de la base de données en cours et

hMailServer - Guide de l'Utilisateur

138 / 214

sur les méthodes fondamentales pour exécuter SQL vers la base de données.

Méthodes

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, stringDatabaseName, string Username, string Password)

Créer une base de données externe

CreateInternalDatabase()

Créer une base de données interne

ExecuteSQL(string sSQLStatement)

Exécute une instruction SQL.

ExecuteSQLScript(string sFilename)

Exécute 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 données par défaut

UtilGetFileNameByMessageID(long MessageID)

Retourne le nom de fichier d'une ID de message donnée.

Propriétés

long CurrentVersion

Version de la base de données actuelle.(lecture seule)

bool DatabaseExists

Vérifie si une base de données existe.(lecture seule)

string DatabaseName

Nom de la base de données.(lecture seule)

eDBtype DatabaseType

Type de base de données.(lecture seule)

bool IsConnected

hMailServer - Guide de l'Utilisateur

139 / 214

Retourne true si une base de données est disponible.(lecture seule)

long RequiredVersion

Version de base de données requise.(lecture seule)

bool RequiresUpgrade

La base de données doit être mise à jour.(lecture seule)

string ServerName

Nom du serveur.(lecture seule)

Objet DeliveryQueue

Description

L'objet DeliveryQueue contient le méthode pour manipuler la file d'attente de hMailServer.

Méthodes

Clear()

Efface la file d'attente de distribution.

Remove(int iMessageID)

Supprime les message de la file d'attente de distribution.

ResetDeliveryTime(int iMessageID)

Réinitialise l'heure de la prochaine distribution

StartDelivery()

Force le libérateur SMTP à chercher les messages à distribuer.

Objet Directories

Description

L'objet Directories contient tous les répertoires mis en place dans hMailServer.ini.

Propriétés

string DatabaseDirectory

Dossier de base de donénes

string DataDirectory

Dossier de données

string DBScriptDirectory

Dossier des scripts de base de données(lecture seule)

hMailServer - Guide de l'Utilisateur

140 / 214

string EventDirectory

Dossier événements

string LogDirectory

Dossier journal

string ProgramDirectory

Dossier programme

string TempDirectory

Dossier temporaire

Objet DistributionList

Description

L'objet DistributionList représente une liste de diffusion de hMailServer.

Méthodes

Delete()

Supprime la liste de diffusion de la base de données.

Save()

Enregistre la liste de diffusion dans la base de données.

Propriétés

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 données 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

hMailServer - Guide de l'Utilisateur

141 / 214

Définit si la liste nécessite une authentification SMTP de la part de l'utilisateur avant de lui envoyerun e-mail.

Objet DistributionListRecipient

L'objet DistributionListRecipient représente un destinataire d'une liste de diffusion de hMailServer.

Propriétés

Property ID As LongL'identificateur de base de données pour le dossier de la liste de diffusionProperty RecipientAddress As StringL'adresse e-mail du destinataire.

Méthodes

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 dediffusion.

Méthodes

Add()

Ajoute un nouveau destinataire à la collection.

DeleteByDBID(long lDBID)

Supprime un destinataire de la collection.

Propriétés

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 données attribué.(lecture seule)

Objet DistributionLists

Description

hMailServer - Guide de l'Utilisateur

142 / 214

L'objet DistributionLists est une collection de tous les listes de diffusion liées à un domainespécifique.

Méthodes

Add()

Ajoute une nouvelle liste à la collection.

DeleteByDBID(long lDBID)

Supprime une liste de la collection.

Refresh()

Rafraîchit la collection de la base de données.

Propriétés

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 attribuée.(lecture seule)

DistributionList ItemByDBID(long DBID)

Retourne la liste de la collection par l'identificateur de base de données.(lecture seule)

Objet DNSBlackList

Description

L'objet DNSBlacklist représente une simple liste noire hMailServer.

Methods

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

bool Active

L'objet est actif.

hMailServer - Guide de l'Utilisateur

143 / 214

string DNSHost

L'hôte DNS à demander.

string ExpectedResult

L'adresse IP que la requête va résoudre si l'hôte est dans la liste noire.

long ID

L'identificateur unique de base de données 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 thehMailServer installation.

Methods

Add()

Ajoute un nouvel objet à la collection.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son identificateur de base de données attribué.

Refresh()

Rafraîchit la collection.

Propriétés

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 données.(lecture seule)

DNSBlackList ItemByDNSHost(string sDNSHost)

Retourne une liste noire DNS par son hôte DNS.(lecture seule)

hMailServer - Guide de l'Utilisateur

144 / 214

Objet Domain

Description

L'objet Domain représente un domaine hMailServer.

Méthodes

Delete()

Supprime le domaine de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

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 réponse

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)

hMailServer - Guide de l'Utilisateur

145 / 214

DomainAliases DomainAliases

Les alias du nom de domaine.(lecture seule)

long ID

L'identificateur de base de données unique pour le domaine.(lecture seule)

long MaxAccountSize

La taille maximum des comptes créés 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

Caractère 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é à cetteadresse.

bool SignatureEnabled

Activer la signature

string SignatureHTML

hMailServer - Guide de l'Utilisateur

146 / 214

La version HTML de la signature

eDomainSignatureMethod SignatureMethod

La méthode 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 représente un simple alias de nom de domaine hMailServer. A ne pasconfondre avec un Alias normal.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

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 pourun domaine spécifique.

Méthodes

Add()

Ajoute un nouvel élément à la collection.

hMailServer - Guide de l'Utilisateur

147 / 214

Delete(long Index)

Supprime un élément de la collection

DeleteByDBID(long DBID)

Supprime l'alias par l'identificateur de base de donné attribué.

Refresh()

Rafraîchit

Propriétés

long Count

Compte(lecture seule)

DomainAlias Item(long Index)

Elément(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 dehMailServer.

Methods

Add()

Ajoute un nouvel élément à la collection

DeleteByDBID(long DBID)

Supprime le domaine par l'identificateur de base de donné attribué.

Refresh()

Rafraîchit la collection.

Propriétés

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)

hMailServer - Guide de l'Utilisateur

148 / 214

Domain ItemByDBID(long DBID)

Retourne un domaine par son identificateur de base de donnée attribué attribué dans lacollection.(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 journald'événements.

Méthodes

Write(string sMessage)

Ecrit un a message dans le journal d'événements de hMailServer.

Objet FetchAccount

Description

L'objet FetchAccount représente un compte externe à partir duquel hMailServer télécharge lesmessages.

Methods

Delete()

Supprime l'objet de la base de données.

DownloadNow()

Effectue un téléchargement immédiat.

Save()

Enregistre l'objet dans la base de données.

Propriétés

long AccountID

Le compte auquel ce compte externe est connecté.

long DaysToKeepMessages

Le nombre de jours de conservation des messages sur le serveur externe.

hMailServer - Guide de l'Utilisateur

149 / 214

bool Enabled

Le compte externe est activé.

long ID

ID(lecture seule)

long MinutesBetweenFetch

Le nombre de minutes à attendre entre chaque téléchargement.

string Name

Le nom du compte externe.

string NextDownloadTime

Prochaine tentative de téléchargement(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 réception depuis l'en-tête Reçu.

bool ProcessMIMERecipients

Lire les destinataires du message depuis l'en-tête 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 uncompte hMailServer.

Méthodes

Add()

hMailServer - Guide de l'Utilisateur

150 / 214

Ajoute un nouvel élément à la collection.

Delete(long Index)

Supprimer

DeleteByDBID(long DBID)

DeleteByDBID

Refresh()

Rafraîchit

Properties

long Count

Compter(lecture seule)

FetchAccount Item(long Index)

Elément(lecture seule)

FetchAccount ItemByDBID(long DBID)

ItemByDBID(lecture seule)

Objet GlobalObjects

Description

L'objet GlobalObjects est l'objet racine des objets hMailServer généraux.

Propriétés

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 pasaffectée par la liste grise.

Méthodes

Delete()

hMailServer - Guide de l'Utilisateur

151 / 214

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

string Description

Description de l'adresse IP.

long ID

L'identificateur unique de base de données 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.

Méthodes

Add()

Ajoute un nouvel objet à la collection.

DeleteByDBID(long DBID)

Supprime un objet de la base de donénes par son identificateur de base de données attribué.

Refresh()

Rafraîchit la collection.

Propriétés

long Count

Le nombre d'objets de la collection.(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 données attribué(lecture seule)

GreyListingWhiteAddress ItemByName(string sName)

hMailServer - Guide de l'Utilisateur

152 / 214

Retourne un objet par son adresse IP.(lecture seule)

Objet Group

Description

L'objet Group représente un simple groupe mis en place dans hMailServer.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

long ID

L'identificateur de base de données 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 représente un seul membre d'un groupe hMailServer.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

Account Account

Retourne le compte référence par ce membre.(lecture seule)

long AccountID

hMailServer - Guide de l'Utilisateur

153 / 214

L'identificateur de base de données pour le compte du membre.

long GroupID

L'identificateur de base de données pour le groupe auquel ce membre appartient.

long ID

L'identificateur de base de données unique pour l'objet.(lecture seule)

Objet GroupMembers

Description

L'objet GrupMembers est une collection de tous les membres d'un groupe.

Méthodes

Add()

Ajoute un nouvel objet à la collection.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son identificateur de base de données attribué.

Refresh()

Rafraîchit la collection.

Propriétés

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 données(lecture seule)

Objet Groups

Description

L'objet Groups est une collection de tous les groupes de serveurs mis en place dans hMailServer.

Méthodes

Add()

Ajoute un nouvel objet à la collection.

hMailServer - Guide de l'Utilisateur

154 / 214

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son identificateur de base de données attribué.

Refresh()

Rafraîchit la collection.

Propriétés

long Count

Nombre d'objets de la collection.(lecture seule)

Group Item(long Index)

Retourne un objet par son index.(lecture seule)

Group ItemByDBID(long DBID)

Retourne un objet par son identificateur de base de données(lecture seule)

Group ItemByName(string Name)

Retourne un objet par son nom(lecture seule)

Objet IMAPFolder

Description

L'objet IMAPFolder représente un simple dossier IMAP.

Méthodes

Delete()

Supprime l'objet de a base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

long ID

L'identificateur de base de données pour le dossier IMAP.(lecture seule)

Messages Messages

Les messages dans ce dossier.(lecture seule)

string Name

Nom du dossier IMAP.

hMailServer - Guide de l'Utilisateur

155 / 214

long ParentID

Identificateur de base de données 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 représente une permission simple liée à un dossier IMAP.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

Account Account

Obtient le compte référencé par cette permission.(lecture seule)

Group Group

Obtient le groupe référencé par cette permission.(lecture seule)

long ID

L'identificateur unique de base de données pour la permission ACL.(lecture seule)

bool Permission(eACLPermission iType)

Permission ACL

long PermissionAccountID

L'identificateur du compte auquel cette permission ACL est liée.

long PermissionGroupID

hMailServer - Guide de l'Utilisateur

156 / 214

L'identificateur du groupe auquel cette permission ACL est liée.

eACLPermissionType PermissionType

Le type d'objet auquel cette permission ACL est liée.

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 liées à un dossier IMAPpublic spécifique.

Méthoses

Add()

Ajoute une nouvelle permission à la collection.

Delete(long Index)

Supprime la permission avec l'index spécifié.

DeleteByDBID(long DBID)

Supprime une permission par sonn identificateur de base de données attribué.

Refresh()

Rafraîchit la collection.

Propriétés

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 données attribué.(lecture seule)

IMAPFolderPermission ItemByName(string Name)

Retourne une permission par son nom.(lecture seule)

hMailServer - Guide de l'Utilisateur

157 / 214

Objet IMAPFolders

Description

l'objet IMAPFolders est une collection des dossiers IMAP racines ou des dossiers publics d'uncompte.

Méthodes

Add(string sName )

Ajoute un dossier IMAP avec le nom attribué à la collection. L'enregistrement est immédiat.

DeleteByDBID(long lDBID)

Supprime un dossier IMAP avec l'identificateur de base de données 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 données.(lecture seule)

IMAPFolder ItemByName(string sName)

Retourne un dossier IMAP par son nom.(lecture seule)

Objet Language

Description

L'objet Language représente une simple langue et contient sa fonctionnalité de traduction.

Propriétés

string Name

Nom de la langue(lecture seule)

string String(string EnglishString)

Une chaîne(lecture seule)

Objet Languages

hMailServer - Guide de l'Utilisateur

158 / 214

Description

L'objet Languages est une collection de toutes les langues accessibles par hMailServer.

Propriétés

long Count

Le nombre d'objets de la collection.(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'accès aux objets dont l'ID est connu.

Propriétés

Account Account(long DBID)

Retrouve un compte par son ID de base de données(lecture seule)

Alias Alias(long DBID)

Retrouve un alias par son ID de base de données(lecture seule)

DistributionList DistributionList(long DBID)

Retrouve une liste de diffusion par son ID de base de données(lecture seule)

Domain Domain(long DBID)

Retrouve un domaine par son ID de base de données(lecture seule)

Objet Logging

Description

L'objet Logging contient tous les paramètres relatifs à la journalisation.

Methods

EnableLiveLogging(bool newVal)

Active la journalisation en direct.

hMailServer - Guide de l'Utilisateur

159 / 214

Propriétés

bool AWStatsEnabled

Créer un journal AWStats

string CurrentAwstatsLog

Chemin complet vers le journal awstats en cours(lecture seule)

string CurrentDefaultLog

Chemin complet vers le journal par défaut 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'événements en cours(lecture seule)

eLogDevice Device

Périphérique de journalisation.

string Directory

Chemin vers le répertoire log(lecture seule)

bool Enabled

Journalisation activée.

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 débogage du journal

eLogOutputFormat LogFormat

Format du fichier journal

bool LogIMAP

Journal des conversations IMAP.

bool LogPOP3

hMailServer - Guide de l'Utilisateur

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 fichier journal.

Objet Message

Description

L'objet Message représente un simple e-mail.

Méthodes

AddRecipient(STR sName, STR sAddress)

Ajoute un destinataire au message.

ClearRecipients()

Efface lle destinataire du message (y compris les en-têtes MIME).

Copy(long iDestinationFolderID)

Copie le message dans le dossier IMAP spécifié

HasBodyType(string BodyType)

Vérifie si le message contient un type de contenu spécifique.

RefreshContent()

Rafraîchit le contenu du message

Save()

Enregistre le message. S'il s'agit d'un nouveau message, il sera distribué après enregistrement

Propriétés

Attachments Attachments

Pièces jointes du message.(lecture seule)

string Body

Contenu en texte clair du message.

string CC

L'en-tête CC du message.(lecture seule)

string Charset

hMailServer - Guide de l'Utilisateur

161 / 214

Jeu de caractères principal du message.

string Date

En-tête 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

Expéditeur du message.

string FromAddress

Adresse de l'expéditeur du message.

MessageHeaders Headers

Collection des en-têtes du message.(lecture seule)

string HeaderValue(string FieldName)

Valeur du champ d'en-tête donné.

string HTMLBody

Contenu HTML du message.

long ID

ID unique de base de données 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

hMailServer - Guide de l'Utilisateur

162 / 214

État du message.(lecture seule)

string Subject

Sujet du message.

string To

En-tête A du message.(lecture seule)

Objet MessageHeader

Description

L'objet MessageHeader représente un simple en-tête de message (un en-tête MIME).

Méthodes

Delete()

Supprime le champ de l'en-tête.

Properties

string Name

Nom de l'en-tête MIME.

string Value

Valeur de l'en-tête MIME.

Objet MessageHeaders

Description

L'objet MessageHeaders est la collection des en-têtes MIME d'un simple message.

Propriétés

long Count

Nombre d'objets dans la collection.(lecture seule)

MessageHeader Item(long Index)

Retourne un objet par son index.(lecture seule)

MessageHeader ItemByName(string sName)

Retourne un objet par son nom. Lorsqu'il existe plusieurs correspondances, la première estretournée.(lecture seule)

Objet Messages

hMailServer - Guide de l'Utilisateur

163 / 214

Description

L'objet Messages est une collection des messages, habituellement liés à un dossier IMAPspécifique.

Méthodes

Add()

Ajoute un nouveau message à cette collection.

Clear()

Efface tous les messages de la collection.

DeleteByDBID(long lDBID)

Supprime un message.

Propriétés

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 données.(lecture seule)

Objet Recipient

Description

L'objet Recipient représente un simple destinataire de message (trouvé dans l'enveloppe SMTP).

Propriétés

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)

hMailServer - Guide de l'Utilisateur

164 / 214

Objet Recipients

Description

L'objet Recipients est une collection de tous les destinataires d'un message.

Properties

long Count

Décompte(lecture seule)

Recipient Item(long Index)

Elément(lecture seule)

Objet Result

Description

L'objet Result est un objet temporaire utilisé dans les événements hMailServer pour permettre lesimplémentations d'événements pour la requête d'un comportement spécifique de hMailServer.

Propriétés

string Message

Message

long Value

Valeur

Objet Route

Description

L'objet Route représente un itinéraire de hMailServer.

Méthodes

Delete()

Supprime l'objet Domain de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

SetRelayerAuthPassword(string newVal)

Définit le mot de passe du serveur SMTP

Propriétés

hMailServer - Guide de l'Utilisateur

165 / 214

RouteAddresses Addresses

Adresses valides(lecture seule)

bool AllAddresses

Itinéraire vers toutes les adresses

string Description

Description de cet itinéraire.

string DomainName

Nom du domaine.

long ID

ID de base de données.(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 nécessite une authentification

string TargetSMTPHost

Hôte SMTP cible

long TargetSMTPPort

Port SMTP cible

bool TreatSecurityAsLocalDomain

Traiter la sécurité comme pour les domaines locaux.

bool UseSSL

Utiliser SSL pour cet itinéraire.

Objet RouteAddress

Description

L'objet RouteAddress représente un simple destinataire d'un itinéraire.

Méthodes

Delete()

Supprime l'objet Domain de la base de données.

hMailServer - Guide de l'Utilisateur

166 / 214

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

string Address

Adresse.

long ID

ID de base de données.(lecture seule)

long RouteID

ID d'itinéraire

Objet RouteAddresses

Description

L'objet RouteAddresses est une collection de tous les destinataires d'un simple itinéraire dehMailServer.

Méthodes

Add()

Ajoute un nouvel objet à la collection.

DeleteByAddress(string sAddress)

Supprime un objet de la base de données par son adresse.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son ID.

Propriétés

long Count

Le nombre d'objets de la collection.(lecture seule)

RouteAddress Item(long Index)

Retourne une pièce jointe par son index.(lecture seule)

RouteAddress ItemByDBID(long DBID)

Retourne une adresse d'itinéraire par son ID de base de données(lecture seule)

Objet Routes

hMailServer - Guide de l'Utilisateur

167 / 214

Description

L'objet Routes ets une collection de tous les itinéraires mis en place dans l'installation dehMailServer.

Méthodes

Add()

Ajoute un nouvel objet à la collection.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son ID de base de données.

Refresh()

Rafraîchit la collection.

Propriétés

long Count

Nombre d'objets dans la collection.(lecture seule)

Route Item(long Index)

Retourne un itinéraire par son index.(lecture seule)

Route ItemByDBID(long DBID)

Retourne un itinéraire par son ID de base de données.(lecture seule)

Route ItemByName(string ItemName)

Retourne un itinéraire par son nom de domaine.(lecture seule)

Objet Rule

Description

L'objet Rule représente une simple règle hMailServer.

Méthodes

Delete()

Supprime l'objet de la base de données.

MoveDown()

Déplace la règle vers le bas dans l'ordre de priorité

MoveUp()

Déplace la règle vers le haut dans l'ordre de priorité

hMailServer - Guide de l'Utilisateur

168 / 214

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

long AccountID

ID du compte

RuleActions Actions

Actions pour cette règle.(lecture seule)

bool Active

Activer

RuleCriterias Criterias

Les critères pour cette règle.(lecture seule)

long ID

ID(lecture seule)

string Name

Nom

bool UseAND

Utiliser AND

Objet RuleAction

Description

L'objet RuleAction représente une simple action dans une règle spécifique.

Méthodes

Delete()

Supprime l'objet de la base de données.

MoveDown()

Déplace la règle vers le bas dans l'ordre de priorité

MoveUp()

Déplace la règle vers le haut dans l'ordre de priorité

Save()

Enregistre les changements de l'objet dans la base de données.

hMailServer - Guide de l'Utilisateur

169 / 214

Propriétés

string Body

Corps

string Filename

Nom de fichier

string FromAddress

De (adresse)

string FromName

De (nom)

string HeaderName

Nom d'en-tête

long ID

ID(lecture seule)

string IMAPFolder

Dossier IMAP

long RouteID

ID d'itinéraire pour la distribution

long RuleID

ID de la règle

string ScriptFunction

Fonction du script à exécuter

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 règle.

hMailServer - Guide de l'Utilisateur

170 / 214

Méthodes

Add()

Ajouter

Delete(long DBID)

Supprime l'objet de la base de données.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son ID de base de données.

Refresh()

Rafraîchir

Propriétés

long Count

Décompte(lecture seule)

RuleAction Item(long Index)

Élément(lecture seule)

RuleAction ItemByDBID(long DBID)

Élément par son ID de base de données(lecture seule)

Objet RuleCriteria

Description

L'objet RuleCriteria représente un seul critère d'une règle.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

string HeaderField

Champ d'en-tête

long ID

ID

hMailServer - Guide de l'Utilisateur

171 / 214

(lecture seule)

eRuleMatchType MatchType

Type de correspondance

string MatchValue

Valeur

eRulePredefinedField PredefinedField

Champ prédéfini

long RuleID

ID de la règle

bool UsePredefined

Utiliser la règle prédéfinie

Objet RuleCriterias

Description

L'objet RuleCriterias est une collection de tous les critères mais en place dans une simple règle.

Méthodes

Add()

Ajouter

Delete(long DBID)

Supprime l'objet de la base de données par son index.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son ID de base de données.

Refresh()

Rafraîchir la collection.

Propriétés

long Count

Compte(lecture seule)

RuleCriteria Item(long Index)

Elément(lecture seule)

RuleCriteria ItemByDBID(long DBID)

Élément par son ID de base de données(lecture seule)

hMailServer - Guide de l'Utilisateur

172 / 214

Objet Rules

Description

L'objet Rules est une collection des règles. Elles sont soit générales, soit liées à un comptespécifique.

Méthodes

Add()

Ajouter

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son ID de base de données.

Refresh()

Rafraîchir la collection

Propriétés

long Count

Décompte(lecture seule)

Rule Item(long Index)

Élément(lecture seule)

Rule ItemByDBID(long DBID)

Élément par son ID de base de données(lecture seule)

Objet Scripting

Description

L'objet Scripting contient tous les paramètres relatifs aux scripts.

Méthodes

CheckSyntax()

Compile le script dans le répertoire event et retourne le résultat.

Reload()

Recharge le script depuis le répertoire event.

Propriétés

string CurrentScriptFile

Le fichier de script actuellement utilisé

hMailServer - Guide de l'Utilisateur

173 / 214

(lecture seule)

string Directory

Le chemin au répertoire events(lecture seule)

bool Enabled

Activer le serveur de script

string Language

Langage du script

Objet SecurityRange

Description

L'objet SecurityRange représente une plage IP de hMailServer.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre la plage de sécurité dans la base de données.

Propriétés

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

hMailServer - Guide de l'Utilisateur

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 données(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 sécurité.

bool RequireAuthForDeliveryToLocal

Nécessite une authentification SMTP pour distribuer aux utilisateurs locaux.

bool RequireAuthForDeliveryToRemote

Nécessite 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'installationde hMailServer.

Méthodes

Add()

Ajoute une nouvelle plage de sécurité à la collection.

Delete(long Index)

Supprime la plage de sécurité par l'index spécifié.

DeleteByDBID(long DBID)

Supprime la plage de sécurité par l'ID de base de données spécifié.

Refresh()

Rafraîchit la collection.

hMailServer - Guide de l'Utilisateur

175 / 214

SetDefault()

Revient aux paramètres de plage IP à leurs valeurs par défaut.

Propriétés

long Count

Nombre d'objets de la collection.(lecture seule)

SecurityRange Item(long Index)

Retourne une plage de sécurité par un index attribué.(lecture seule)

SecurityRange ItemByDBID(long DBID)

Retourne une plage de sécurité par un ID de base de données.(lecture seule)

SecurityRange ItemByName(string sName)

Retourne une plage de sécurité par un nom attribué.(lecture seule)

Objet ServerMessage

Description

L'objet ServerMessage représente un seul message de serveur personnalisable.

Méthodes

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

long ID

L'ID unique de base de données 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.

hMailServer - Guide de l'Utilisateur

176 / 214

Méthodes

Refresh()

Rafraîchit la collection.

Propriétés

long Count

Nombre d'éléments de la collection.(lecture seule)

ServerMessage Item(long Index)

Retourne un objet par son index.(lecture seule)

ServerMessage ItemByDBID(long DBID)

Retourne un objet par son ID de base de données(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 paramètres de hMailServer qui ne sont pas relatifsà un domaine spécifique.

Méthodes

SetAdministratorPassword(string newVal)

Définir le mot de passe d'Administration hMailServer principal

SetSMTPRelayerPassword(string newVal)

Définir le mot de passe du relais SMTP

Propriétés

bool AddDeliveredToHeader

Détermine si l'en-tête 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

hMailServer - Guide de l'Utilisateur

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é spécifié lors de l'ouverture de session d'un utilisateur.

bool DenyMailFromNull

Refuser un message aved une adresse d'expéditeur vide.

Directories Directories

Configuration du répertoire(lecture seule)

bool DisconnectInvalidClients

Déconnecter les clients qui ne suivent pas les RFC

Groups Groups

Collection de groupes.(lecture seule)

string HostName

Obtient ou définit le nom d'hôte sous lequel hMailServer s'identifie lui-même.

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.

hMailServer - Guide de l'Utilisateur

178 / 214

(lecture seule)

long MaxDeliveryThreads

Nombre maximum de processus de distribution SMTP.

long MaxIMAPConnections

Nombre maximum de connexions IMAP simultanées.

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 déconnexion.

long MaxPOP3Connections

Obtient ou définit le nombre maximum de connexions POP3 simultanées.

long MaxSMTPConnections

Obtient ou définit le nombre maximum de connexions tp simultanées.

long MaxSMTPRecipientsInBatch

Nombre maximum de destinataires SMTP dans un lot lors de la distribution.

string MirrorEMailAddress

Copie de tous les messages envoyés à cette adresse.

string PublicFolderDiskName

Nom du dossier du disque dans lequel les dossiers publics sont stockés.(lecture seule)

IMAPFolders PublicFolders

Dossiers publics(lecture seule)

Routes Routes

Collection des itinéraires.(lecture seule)

long RuleLoopLimit

Nombre maximum de fois qu'un message peut être traité par les règles.

Scripting Scripting

Configuration du script(lecture seule)

SecurityRanges SecurityRanges

Plages de sécurité.(lecture seule)

bool SendStatistics

Obtiennt ou définit si les statistiques doivent être envoyées à hMailServer.com

ServerMessages ServerMessages

hMailServer - Guide de l'Utilisateur

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 hôtes 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 nécessite une authentification

string SMTPRelayerUsername

Nom d'utilisateur du relais SMTP

bool SMTPRelayerUseSSL

Détermine 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) à exécuter.

bool UseDeliveryLog

Utiliser le journal de distribution.

string UserInterfaceLanguage

hMailServer - Guide de l'Utilisateur

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 représente un simple certificat SSL mis en place dans hMailServer.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

string CertificateFile

Le fichierr certificat.

long ID

L'ID unique de base de données pour l'objet.(read-only)

string Name

Le nom de l'objet.

string PrivateKeyFile

Le fichier de clé privée.

Objet SSLCertificates

Description

L'objet SSLCertificates est une collection de tous les certificats SSL mis en place dans hMailServer.

hMailServer - Guide de l'Utilisateur

181 / 214

Méthodes

Add()

Ajoute un nouvel objet à la collection.

Clear()

Efface la collection.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son ID de base de données.

Refresh()

Rafraîchit la collection.

Propriétés

long Count

Nombre d'objets de la collection.(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 données(lecture seule)

Objet Status

Description

L'objet Status contient les informations sur votre système, comme la disponibilité et lesstatistiques de base.

Propriétés

long ProcessedMessages

Obtient le nombre de messages distribués(lecture seule)

long RemovedSpamMessages

Obtient le nombre de messages de spam détectés(lecture seule)

long RemovedViruses

Obtient le nombre de virus supprimés(lecture seule)

long SessionCount(eSessionType iType)

Obtient le nombre de sessions en cours

hMailServer - Guide de l'Utilisateur

182 / 214

(lecture seule)

string StartTime

Obtient le temps de démarrage du serveur(lecture seule)

string UndeliveredMessages

Obtient une liste des messages non distribués.(lecture seule)

Objet SURBLServer

Description

L'objet SURBLServer représente un simple serveur SURBL.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

bool Active

L'objet est actif.

string DNSHost

L'hôte DNS à interroger.

long ID

L'ID unique de base de données pour l'objet.(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'installationhMailServer.

Méthodes

hMailServer - Guide de l'Utilisateur

183 / 214

Add()

Ajoute un nouvel objet à la collection.

DeleteByDBID(long DBID)

Suprime un objet de la base de données par son ID de base de données.

Refresh()

Rafraîchit la collection.

Propriétés

long Count

Le nombre d'objets de la collection.(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 données(lecture seule)

SURBLServer ItemByDNSHost(string sDNSHost)

Retourne un serveur SURBL par son hôte DNS(lecture seule)

Objet TCPIPPort

Description

L'objet TCPIPPort représente une simple adresse et un port configurés pour être sous lasurveillance de hMailServer.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

string Address

Adresse TCP/IP à laquelle se lier.

long ID

L'ID unique de base de données pour l'objet.(lecture seule)

hMailServer - Guide de l'Utilisateur

184 / 214

long PortNumber

Le numéro 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 configurés pourêtre surveillés par hMailServer.

Methods

Add()

Ajoute un nouvel objet à la collection.

DeleteByDBID(long DBID)

Supprime un objet de la base de données par son Id de base de données.

Refresh()

Rafraîchit la collection.

SetDefault()

Génère le réglage par défaut des objets de la collection

Propriétés

long Count

Nombre d'objets de la collection.(lecture seule)

TCPIPPort Item(long Index)

Retourne un objet par son index.(lecture seule)

TCPIPPort ItemByDBID(long DBID)

Retourne un objet par son ID de base de données(lecture seule)

Objet Utilities

hMailServer - Guide de l'Utilisateur

185 / 214

Description

L'objet Utilities contient les fonctions misc. utilisées par hMailServer Administrator.

Méthodes

BlowfishDecrypt(string Input)

Décrypte une chaîne depuis Blowfish.

BlowfishEncrypt(string Input)

Crypte une chaîne via Blowfish.

EmailAllAccounts(string sRecipientWildcard, string sFromAddress, string sFromName, stringsSubject, 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 messageriespécifiée.

ImportMessageFromFile(string sFilename, long iAccountID)

Importe le message d'un fichier du disque ou d'un compte spécifique pour distribution.

ImportMessageFromFileToIMAPFolder(string sFilename, long iAccountID, string sIMAPFolder)

Importe le message d'un fichier du disque ou d'un compte spécifique pour distribution.

IsLocalHost(string sHostname)

Vérifie si le nom d'hôte 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 dépendant d'un autre service.

MD5(string Input)

Retourne la chaîne hexadécimale MD5 pour une chaîne.

RunTestSuite(string sTestPassword)

Exécute une suite de tests. Ce qui supprimera tous les objets du serveur.

SHA256(string Input)

hMailServer - Guide de l'Utilisateur

186 / 214

Retourne la chaîne hex SHA256 pour une chaîne.

Objet WhiteListAddress

Description

L'objet WhiteListAddress représente une simple adresse IP ou adresse de messagerie en listeblanche.

Méthodes

Delete()

Supprime l'objet de la base de données.

Save()

Enregistre les changements de l'objet dans la base de données.

Propriétés

string Description

Description de l'enregistrement.

string EmailAddress

Adresse de messagerie en liste blanche

long ID

L'ID de base de données unique pour l'objet.(lecture seule)

string LowerIPAddress

Adresse IP la plus basse.

string UpperIPAddress

Adresse IP la plus élevée.

Objet WhiteListAddresses

Description

L'objet WhiteListAdresses est une collection de toutes les adresses de messagerie / adresses IPen liste blanche.

Méthodes

Add()

Ajoute un nouvel objet à la collection.

Clear()

Efface la collection.

DeleteByDBID(long DBID)

hMailServer - Guide de l'Utilisateur

187 / 214

Supprime un objet de la base de données par son ID de base de données.

Refresh()

Rafraîchit la collection.

Propriétés

long Count

Nombre d'objets de la collection.(lecture seule)

WhiteListAddress Item(long Index)

Retourne un objet par son index.(lecture seule)

WhiteListAddress ItemByDBID(long DBID)

Retourne un objet par son ID de base de données.(lecture seule)

Synchroniseur du répertoire Data

Contexte

Lorsque hMailServer reçoit un message, les informations concernant ce message sontenregistrées à deux emplacements. Les informations sur l'enveloppe SMTP, la date de réception etles indicateurs du message sont placés dans la base de données de hMailServer (tableshm_messages et hm_messagerecipients). Le message lui-même est placé dans un fichier .emlstocké dans le dossier Data de hMailServer.

Dans certaines situations, ces deux emplacements peuvent ne plus être synchronisés. Parexemple, si une table de base de données devient corrompue, des messages du dossier Datapeuvent ne pas être référencés par la base de données. Si cela se produit, vous ne pourrez plustélécharger les messages avec votre client de messagerie. Et si les messages n'ont pas étédistribués, hMailServer ne le fera pas

La solution à ce problème consiste à utiliser le Synchroniseur du Dossier Data (DDS) dehMailServer. 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 rechercheles fichiers dont l'extension est .hma ou .eml (les anciennes versions de hMailServer utilisaient.hma comme extension, et désormais .eml est utilisé). Lorsqu'un fichier .eml est détecté, il vérifie sile fichier est référencé par la base de données, sinon, le message est inséré dans la base dedonnées.

Si le fichier .eml existe dans un dossier utilisateur, hMailServer insère le message dans ce compteutilisateur. Le message termine alors dans le dossier Inbox (boîte de réception) de l'utilisateur.Les information du dossier IMAP sont stockées dans la base de données, 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 inséré dans la file d'attente dedistribution. hMailServer analyse les en-têtes A et CC du message pour déterminer à qui lemessage doit être distribué. Pour éviter que le message soir re-distribué aux destinataires,hMailServer n'envoie les messages qu'aux destinataires locaux.

hMailServer - Guide de l'Utilisateur

188 / 214

Comment puis-je l'exécuter?

1.Sauvegardez votre système. Le DDS effectue une quantité de modifications relativementimportantes dans la base de données. De ce fait, il est conseillé de tout sauvegarder avantd'exécuter le DDS.2.Cherchez DataDirectorySynchronizer.exe dans le dossier Addons et exécutez-le.3.Cliquez sur Suivant pour lancer la synchronisation.

Qu'est-ce qui est importé?

·Comme les données d'un message IMAP, telles les informations de dossier, les indicateurs demessage, etc sont stockées dans la base de données et pas dans le fichier message, cesinformation ne seront pas re-crées lors de la reconstruction de la liste des messages. Parconséquent, lorsque les messages sont insérés dans la base de données, ils se retrouveront tousdans la boîte de réception et marqués comme non lu.·Seuls les fichiers avec l'extension .eml ou .hma sont importées dans la base de données·Pour chaque fichier qui existe déjà dans la base de données, vous verrez un message "ignoré".

Où les messages importés seront-ils placés?

·Les fichiers situés dans le dossier Data racine seront remis aux destinataires locaux des en-têtesA et CC. Les informations de destinataire d'origine, de l'enveloppe SMTP, ne sont pas disponiblesdans les fichiers. EML. Par conséquent, les en-têtes To / CC sont utilisés. E-mail ne sont remis auxseuls destinataires locaux pour éviter que des messages ne soient re-transmis à des adressesexternes.·Les fichiers situés dans les sous-répertoires du dossier de données, telles que le domain\username seront reliés à cet utilisateur dans la base de données.·Les fichiers importés directement dans les comptes d'utilisateurs ne seront pas traités par lesfiltres, les règles, les fonctions de détection de virus dans hMailServer

Quel effet a t-il sur la production?

·Vous n'avez pas à arrêter hMailServer avant d'exécuter DDS.·Après l'importation de tous les messages, DDS redémarrer automatiquement le serveurhMailServer pour actualiser le cache.

 

Configuration des antivirus externes

Généralités

Cette rubrique présente des exemples de ligne de commande d'antivirus externes quifonctionnent 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 antérieures à AVG Free 8, avgscanx.exe ne retourne pas de valeurindiquant si un virus a été détecté. Pour pouvoir utiliser la ligne de commande ci-dessous, vérifiez

hMailServer - Guide de l'Utilisateur

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

Implémentation de fonctionnalités

Comment puis demander une fonctionnalité?

Si vous souhaitez demander une fonctionnalité, ajoutez-la à la section Feature du forum desutilisateurs. Si vous ne savez pas si la fonctionnalité est déjà implémenté, demandez-le d'abord àla section Discussions Générales

Qnand ma fonctionnalité sera t-elle implémentée?

Quand une demande de fonctionnalité a été présentée à la section de demande de fonctionnalitédu forum, un sondage est ajouté. En utilisant le scrutin, d'autres utilisateurs de hMailServerpeuvent voter pour ou contre la fonctionnalité.

L'équipe de développement hMailServer utilise ces votes pour décider des fonctionnalités àimplémenter. La règle générale est que les fonctions qui ont reçu le plus de votes populairesseront mis en œuvre en premier lieu, les fonctions qui ont reçues moins de voix positives serontmises en œuvre ultérieurement.

Sur la page des résultats du vote, vous pouvez voir une top-list des demandes les pluspopulaires.

Il existe certaines exceptions à cette règle.

·Les fonctions importantes, qui nécessitent une refonte interne importante, sont normalementreportées à une version majeure (comme 5.0, 6.0). Exemples de telles fonctionnalités: "prise encharge Full SSL" et "prise en charge multi-plateformes". La raison en est que l'ajout de plusgrandes fonctionnalités nécessite de nombreux tests et prend plus de temps. Et les versionsmineures, telles que 4.1, 4.2 devraient être publiés plus souvent, et on ne peut pas mettre enœuvre des fonctionnalités à haut risque.·Certains utilisateur risquent de rencontrer un problème où il est tout simplement incapabled'utiliser correctement le serveur en raison de la façon dont d'autres serveurs fonctionnent. S'il n'ya pas de solution raisonnable à ce problème, cette demande reçoit une priorité plus élevée. Celas'applique uniquement aux fonctionnalités de base du serveur. Par exemple, "Je ne peux pasutiliser ce logiciel tant qu'il ne peut pas utiliser les listes de diffusion" ne relève pas de cettecatégorie.·Les très petites fonctions qui peuvent être mises en œuvre sans aucun risque, et en quelquesminutes, reçoivent une priorité plus élevée.·Une entreprise peut décider d'acheter une nouvelle fonctionnalité de hMailServer. Cette nouvellefonctionnalité sera alors implémentée parallèlement aux autres caractéristiques. 

Questions souvent posées

Question 1 - Qu'est-ce que hMailServer?

hMailServer est un serveur de messagerie pour Microsoft Windows. Il vous permet de gérer tousvos mails vous-même sans avoir à dépendre d'un fournisseur de services Internet (FAI) pour cefaire. Comparé à votre FAI, hMailServer ajoute flexibilité et sécurité et vous donne le plein contrôlesur la protection anti-spam.

Question 2 - Qui utilise hMailServer?

hMailServer - Guide de l'Utilisateur

190 / 214

hMailServer est utilisé par un grand nombre de différents types d'utilisateurs. Voici quelquesexemples:

·Le type le plus commun est l'entreprise qui utilisent hMailServer pour héberger la messagerie deses propres domaines.·hMailServer est également utilisé par les petits et important fournisseurs d'accès Internet pourhéberger la messagerie pour leurs clients.·Différents gouvernements à travers le monde utilisent hMailServer pour héberger leurs e-mails.·D nombreuses personnes et familles exécutent hMailServer chez eux pour réduire la quantité despam qui envahit leur boîte de réception.

Question 3 - Quand dois-je utiliser hMailServer?

Toute personne ayant une adresse de messagerie peut bénéficier de l'utilisation de hMailServer.En règle générale, les organisations et les personnes qui ont enregistré un nom de domaine surInternet utilisent hMailServer pour héberger la messagerie de ce domaine.

Question 4 - Dois-je être connecté à Internet pour exécuter hMailServer?

Non, vous pouvez exécuter utilisent hMailServer sans être connecté à Internet, mais avec lalimitation é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 gérer?

Cela dépend principalement du matériel de l'ordinateur qui utilise hMailServer et du typed'utilisateurs. Par exemple, si vos utilisateurs sont très actifs, vous devez avoir un un serveurrapide par rapport à des utilisateurs qui ne vérifient pas souvent leur messagerie. Il existe desinstallations de hMailServer avec des dizaines de milliers de comptes utilisateurs sur un seulserveur.

Question 6 - Comment puis-je démarrer?

La première chose que vous devez faire est de déterminer ce que vous voulez faire dehMailServer. Ensuite, suivez le didecticiel d'installation.

Question 7 - J'ai installé hMailServer, que dois-je faire ensuite?

Cela dépend de la façon dont vous prévoyez d'utiliser hMailServer. Si vous voulez héberger lamessagerie de votre propre nom de domaine, vous devez ajouter un domaine et les comptesutilisateurs pour hMailServer. Les étapes pour ce faire sont décrites sur cette page: Configurationde base.

Question 8 - Je reçois le message "Authentification SMTP requise" si j'essaie d'envoyer unmessage. Que dois-je faire?

Il s'agit d'un message d'erreur courant, dû, dans la plupart des cas à un client de messagerie malconfiguré. Vérifier les rubriques suivantes pour obtenir des informations sur les messagesd'erreur: Messages d'erreur

Question 9 - Dois-je définir les noms d'hôte pop.example.com, smtp.example.com et ainsi desuite?

C'est inutile d'un point de vue technique, d'avoir plusieurs noms d'hôte pour résoudre la mêmeadresse IP. Tant que le nom d'hôte que vous utilisez pointe sur la bonne adresse IP, peu importele nom d'hôte.

hMailServer - Guide de l'Utilisateur

191 / 214

Autres considérations techniques:

·Pourquoi les messages entiers ne sont-ils pas enregistrée dans la base de données?·Pourquoi be pas enregistrer seulement les pièces jointes sur le disque dur?·Pourquoi existe t-il des dossiers vides dans le répertoire Data?

FAQ: Informations d'hébergement

Informations d'hébergement de hMailServer

hMailServer est un serveur de messagerie. Ce qui signifie que c'est un logiciel qui fonctionne surun ordinateur, qui peut être utilisé par les entreprises, les organisations et les individus pourhéberger des messages. hMailServer.com ne fournit pas de services de courrier électronique, maisseulement les logiciels qui sont utilisés pour créer des services de messagerie.

Si vous avez des problèmes avec hMailServer, mais que vous ne l'avez pas installé vous-même,vous devez contacter l'administrateur du serveur de messagerie. Si vous avez votre propre nomde domaine, l'administrateur est généralement la société que vous payez chaque mois /trimestre / année pour ses services.

 

Stocker les pièces jointes seules sur le disque dur

Question: Pourquoi ne pas enregistrer les pièces jointes seules sur le disquedur?

La question semble impliquer que le «corps» et les «pièces jointes» sont des entités distinctes, cequ'ils ne sont pas. Un message électronique est un flux continu d'octets, qui comprend un en-têtes, un corps, des pièces jointes etc . Lorsque hMailServer envoie ou reçoit des données, il le faitsous la forme de données codées MIME, pas sous la forme de données binaires, ce qui inclutpièces jointes. Chaque message est remis au client de messagerie tel qu'il a été reçu, c'est alorsau client de savoir quoi en faire .

Actuellement, ce que hMailServer fait consiste à obtenir un flux de données à partir du réseau, deles stocker dans un fichier exactement comme il a été reçu, et la remettre au client de courrierélectronique à la demande. Finalement, si un antivirus est présent, il devra décoder le MIME dumessage en entier et effectuer un examen antivirus.

Cependant, selon votre suggestion, chaque message devrait être décodé MIME au niveau duserveur, les pièces jointes extraites du message et stockées sous forme de données binaires, etle reste stocké dans la base de données. Les pièces jointes doivent nécessairement être desdonnées binaires simples (pas encodé MIME en utilisant base64 ou tout autre algorithme), sinonelles ne peuvent pas être examinées pour les virus.

Ce scénario conduirait à au moins deux problèmes:

Problème 1: Lorsque hMailServer accepte un message, il doit alors le décoder de Base64/Quoted-Printable et stocker chaque pièce jointe sur le disque, ayant en fait à le décoder MIME le messageentier avant de pouvoir l'enregistrer. Ce qui élève non seulement les besoins en mémoire, maisaussi consomme beaucoup de CPU.

Problème 2: Quand un client POP3 demande ce message, le serveur devrait encoder MIME toutesles pièces jointes et les remettre dans un flux unique avant de les envoyer. Ce qui aurait, encoreune fois, pour effet d'augmenter l'utilisation de la mémoire et du processeur.

Ainsi, demander à hMailServer d'extraire les pièces jointes ne servirait à rien, parce que celaentraînerait, en fait, plus de travail, pas moins.C'est pourquoi extraire les pièces jointes dumessage est traditionnellement le rôle du client de messagerie, pas celui du serveur.

Enregistrer le message dans la base de données

hMailServer - Guide de l'Utilisateur

192 / 214

Question: Pourquoi les messages entiers ne sont-ils pas stockés dans labase de données?

Stocker les e-mails pourrait avoir quelques avantages. Par exemple, il serait plus facile pourhMailServer de sauvegarder si toutes les données ont été stockées dans base de données.Cependant, il pourrait également y avoir de sérieux inconvénients:

Consommation plus élevée de mémoire

Quand un message est transmis par hMailServer à un client ou à un autre serveur de messagerie,hMailServer délivre le message par portions de 50Ko. hMailServer lit la valeur de 50Ko de donnéesdu message stocké sur le disque en mémoire. Il les envoie au client, et libère la mémoire de 50Ko.Ainsi, quand hMailServer envoie un message, l'utilisation de la mémoire n'a jamais besoin dedépasser 50 Ko par message. Il n'existe pas de moyen adéquat pour lire des portions de 50Kod'un message à partir de la base de données. Si le message a été enregistré dans la base dedonnées, hMailServer devra lire l'intégralité de la base de données et mettre en cache ce qui estdans la mémoire, ce qui augmenterait considérablement l'utilisation de celle-ci.

Utilisation plus importante du CPU

Stocker le message dans la base de données impliquerait plusieurs tâches supplémentaires, cequi consommerait tous les cycles de CPU:

·Si le message était stockée dans la base de données, il ne serait pas possible d'effectuer unexamen antivirus. Ainsi, hMailServer aurait à extraire l'intégralité du message de la base dedonnées et à en stocker les données sur le disque dur, avant de l'examiner, puis à supprimer ànouveau le fichier à partir du disque. Vous pourriez utiliser un examen antiviral de la  mémoirepour résoudre ce problème, mais vous seriez loin des infections possibles des API.·Les anciennes versions de MySQL ont d'assez faible limite de durée maximale de requête. Stockerun message lors de l'utilisation de ces versions nécessiterait que hMailServer divise les donnéesen plusieurs commandes SQL et les exécute une à une.·Il n'est pas possible d'exécuter insert into table (column) values ('the-puremessage-data').Avant cela, hMailServer aurait à chercher dans l'intégralité du message et à "extraire" " lescaractères spéciaux, par exemple, extraire ' en \'. Pour contourner cela, vous pouvez utiliser desprocédures stockées, mais tous les moteurs de base de données que hMailServer prend encharge, ne prennent pas en charge les procédures stockées.

gestion plus difficile

Stocker des e-mails sur le disque donne à l'administrateur un bon aperçu des messages sur leserveur. Il est possible d'afficher un e-mail juste en double-cliquant dessus, et de le supprimer enappuyant simplement sur la touche Suppr du clavier. Si les messages ont été stockés dans la basede données, l'administrateur doit savoir comment exécuter des instructions SQL.

Pourquoi des dossiers vides dans le répertoire Data?

Question: Pourquoi existe t-il des dossiers vides dans le répertoire Data?

hMailServer stocke les e-mails dans le répertoire Data. Les fichiers de messages sont stockésdans des sous-répertoires nommés après la création des comptes de domaine et d'utilisateur.

Dans les premières versions de hMailServer, les fichiers de messages étaient stockés directementdans le dossier du compte utilisateur (exemple: hMailServer/Data/domain.com/utilisateur1/.Quand il y avait 50 000 messages dans un compte utilisateurs, il y avait 50 000 messages dans ledossier de données des utilisateurs. Étant donné que Windows ne gère pas efficacement lesdossiers volumineux, ces nombreux les fichiers de messages ont eu un effet négatif sur lesperformances de hMailServer.

hMailServer - Guide de l'Utilisateur

193 / 214

Pour améliorer les performances, hMailServer stocke désormais les fichiers de messages dans dessous répertoires composés de 2 caractères de 0 à 9 et de A à F. Ces sous-répertoires sont créésdynamiquement en cas de besoin, mais ils ne sont pas supprimés tant que le compte n'est passupprimé. De ce fait, il peut y avoir plusieurs sous-répertoires vides. Étant donné que le nom d'unrépertoire ne se compose que de deux caractères, il y aura au plus 256 sous-répertoires.

Structure d'un dossier hMailServer

/Addons Ajour de scripts et utilitaires

/Bin Fichiers binaires hMailServer.Le serveur actuel ethMailAdmin

/Data Messages E-mail. Les fichiersdans la racine Data sont desmessages qui n'ont pas encoreété distribués. Les sous-dossiers contiennent lesmessages distribués. Les e-mails ont pour extension. hmaou. .eml, en fonction de laversion dans laquellehMailServer les à créés.

/DBScripts Les scripts SQL qui sontutilisés lors de la mise àniveau d'une version à l'autre.Les fichiers ont la norme dedénomination suivante:UpgradeXXXXtoYYYYZZZZ.sql.XXXX est l'ancienne version,YYYY est la nouvelle versionet ZZZZ est le type du serveurde base de données.

/Events Scripts VBA et JavaScriptutilisés par hMailServer.

/Languages Traduction de l'interfaceutilisateur de hMailServer.

/Logs Fichiers journaux créés parhMailServer.

/MySQL Le serveur MySQL

/PHPWebAdmin L'interface d'administrationweb PHP pour hMailServer.

/Temp Dossier temporaire utilisé parhMailServer. Utilisé, parexemple, quand hMailServerextrait les pièces jointes quisont à examiner pour lesvirus. Lorsque hMailServerextrait une pièce jointe pour

hMailServer - Guide de l'Utilisateur

194 / 214

un examen viral, l'extension.tmp lui est attribuée.

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 plusieursenregistrements Mail Exchange (MX). Les différents enregistrements MX ont des préférences oupriorité différentes. L'expéditeur d'un e-mail va d'abord essayer de distribuer au MX avec lapréférence la plus basse, et ensuite aux autres. Les serveurs de messagerie en cours d'exécutionsur les enregistrements MX avec une préférence élevée peuvent donc être considérés comme desserveurs de messagerie de sauvegarde.

Exemple

HôtePréférence

mail.hmailserver.com 25

mail-backup.hmailserver.com 50

Un expéditeur qui m'envoie un e-mail va d'abord essayer de le distribuer à mon serveur,mail.hmailserver.com. Si la distribution à mon hôte échoue pour une raison quelconque, parexemple, en raison d'erreurs de réseau ou d'un crash de la machine, l'expéditeur va essayer de ledistribuer au serveur, messagerie backup.hmailserver.com. Le serveur de messagerie-backup.hmailserver.com devra alors transférer le message à chaque fois que mail.hmailserver.comest en ligne. Les étapes indiquent comment configurer l'installation hMailServer s'exécutant surmail-backup.hmailserver.com pour transférer tout le courrier du domaine hmailserver.com à l'hôte

hMailServer - Guide de l'Utilisateur

195 / 214

mail.hmailserver.com.

Étapes

1.Lancez hMailAdmin.2.Accédez à Configuration3.Déployez le nœud des paramètres SMTP4.Sélectionnez Itinéraire et cliquez sur Ajouter5.Spécifiez ce qui suit:

o Domaine - Nom du domaine que vous souhaitez sauvegarder. Cela ne devrait pas être undomaine configuré sur votre serveur.

o Hôte SMTP Cible - Nom d'hôte ou, de préférence, l'adresse IP de l'ordinateur vers lequelletous les messages du domaine doivent être transférés.

o Port TCP - Le port TCP/IP que l'hôte SMTP cible surveille.o Sélectionnez l'expéditeur 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'itinéraire, ils doitêtre considéré comme externe. Si quelqu'un vous envoie un e-mail avec le nom de domaine,il doit être considéré comme local. Ceci a pour effet que hMailServer va permettre ladistribution au nom de domaine de l'itinéraire sans authentification SMTP.

o Page adresse - Si vous avez une liste des adresses e-mail existantes sur l'hôte SMTP cible,vous pouvez les spécifier 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 supérieures.

hMailServer - Guide de l'Utilisateur

196 / 214

Administrer à distance hMailServer

Généralités

Ce guide décrit comment administrer hMailServer à distance. L'ordinateur A est l'ordinateur oùhMailServer doit être exécuté, et l'ordinateur B est l'ordinateur que vous voulez administrer depuishMailServer. Les deux ordinateurs sont dans le même domaine Windows. L'administration àdistance est effectuée à l'aide de DCOM.

Ordinateur A

Installer hMailServer normalement.

Ordinateur B

Vous devez avoir Administrateur hMailServer installé, et la bibliothèque hMailServer COM dois êtreenregistrée. Comme il n'y a pas d'installation qui ne fait que cela, vous devez mettre en place uneinstallation complète de hMailServer et ensuite désactiver le service de hMailServer. Pour installerhMailServer sur l'ordinateur B, suivez ces étapes:1.Installez la même version de hMailServer que sur l'ordinateur A.2.Ouvrez le Panneau de Configuration, Outils d'Administration, Services.3.Cherchez le service hMailServer, arrêtez-le et désactivez-le.Ensuite, vous devez indiquer à Windows que lorsque vous utilisez l'administrateur hMailServer,vous souhaitez administrer l'installation hMailServer s'exécutant sur l'ordinateur A. Cela se fait en

hMailServer - Guide de l'Utilisateur

197 / 214

modifiant les paramètres de l'objet COM hMailServer sur l'ordinateur B.1.Ouvrez le Panneau de Configuration, Outils d'Administration, Services de Composants.2.Déployez le composant Services de Composants->Ordinateurs->Poste de Travail->ConfigurationDCOM.3.Cherchez hMailServer4.Faites un clic droit dessus et choisissez Propriétés5.Dans l'onglet Localisation, dé-sélectionnez Exécutez l'application sur cet ordinateur et activezExécuter l'application sur l'ordinateur suivant6.Indiquez le nom de l'Ordinateur A7.Lancez hMailAdmin.

hMailAdmin de l'Ordinateur B doir désormais 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 messagesde la file d'attente dans la base de données et les messages réels dans le dossier Data. Laméthode pour supprimer la file d'attente de distribution dépend de la version hMailServer quevous utilisez.

hMailServer 4.1 et antérieurs

Pour supprimer la file d'attente de distribution, supprimez tous les fichiers dans la racine durépertoire Data. Si vous avez installé hMailServer sur C:\Program Files\hMailServer supprimez tousles fichiers du répertoire C:\Program Files\hMailServer\Data\. Pour chaque fichier que voussupprimez, hMailServer supprime le message de la base de données et signale une erreur dans lejournal 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 répertoire Data, car ils pourraient contenirdes messages pour les comptes d'utilisateurs.

hMailServer 4.2 et supérieurs

A la section État de hMailAdmin, sélectionnez l'onglet "Messages non distribués" et cliquez surEffacer la file d'attente. hMailServer commencera alors à effacer toute la file d'attente.

Se connecter à MySQL

Cette section décrit comment se connecter à la base de données MySQL pour exécuter desinstructions.

Étapes 1: Déterminer le mot de passe MySQL

Si vous utilisez une version externe de MySQL, vous devez déjà connaître votre mot de passeMySQL. Si vous utilisez la version intégrée de MySQL fournie avec hMailServer, vous ne connaissezpeut-être pas votre mot de passe. Pour le déterminer, procédez 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 lefichier et allez à Etape 2: Se connecter au serveur ci-dessous.3.Exécutez le script \hMailServer\Addons\Utilities\DecryptBlowfish.vbs.4.Copiez le mot de passe de hMailServer.ini dans la boîte de dialogue DecryptBlowfish.5.Cliquez sur OK dans DecryptBlowfish pour afficher votre mot de passe. DecryptBlowfish afficheraalors votre mot de passe. Gardez la boîte de dialogue ouverte ou mémorisez 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 pource faire.1.Téléchargez et décompressez MySQLFront2.Exécutez MySqlFront.exe3.Dans le boîte de dialogue de connexion, cliquez sur Nouveau

hMailServer - Guide de l'Utilisateur

198 / 214

4.Entrez les informations de connexion pour votre serveur MySQL. Si vous utilisez le serveurintégré, vous devez entrer le nom d'hôte: localhost, utilisateur: root, mot de passe: le mot depasse, port: 33075.Cliquez sur Connexion pour vous connecter au serveur de base de données.Maintenant, vous êtes connecté à MySQL.

Étapes 3: Exécuter des instructions

Après vous être connecté à MySQL, vous pouvez exécuter des instructions en suivant ces étapes:1.Dans l'arborescence de gauche, cliquez sur la base de données hmailserver. Vous verrez à droitela liste des tables de la base de données.2.Au-dessus de la liste des tables, vous verrez un "onglet" avec pour titre Requête . Cliquez surcet onglet.3.Entrez votre requête SQL4.Cliquez sur le bouton Executer SQL ou appuyez sur la touche de clavier F9 pour exécuter larequête.

Permissions DCOM

Généralités

Par défaut, IIS 6 n'est pas autorisé à se connecter à hMailServer en raison des autorisationsDistributed COM qu'utilise Windows. De même, Apache fonctionner comme un compte d'utilisateuravec des autorisations restreintes et n'est pas autorisé à se connecter par défaut.

Étapes

Suivez ces étapes pour attribuer à IIS ou Apache les permissions requises pour se connecter àhMailServer en utilisant DCOM.

1.Lancez DCOM config en cliquant sur Démarrer, Exécuter, entrez dcomcnfg.exe et cliquez sur OK.2.Dans le programme Services des composants, déployez le dossier Services des Composants3.Allez à Ordinateurs | Poste de Travail | DCOM Config4.Faites un clic droit sur hMailServer et choisissez Propriétés5.Ouvrez l'onglet Sécurité6.Sous "Lancer et Activer les Permissions", sélectionnez Personnaliser et cliquez sur Éditer7.Sous "Groupe ou noms des utilisateurs", cliquez sur Ajouter8.Pour IIS6: ajoutez le compte d'utilisateur intégré anonyme IIS9.Pour Apache: ajoutez le compte d'utilisateur Apache10.Réglez les permissions Lancement Local et Activation Locale pour ces utilisateurs sur Autoriser.

Examen antiviral externe - valeur de retour

Généralités

Si vous avez l'intention d'utiliser un antivirus externe pour hMailServer, vous devez configurer lavaleur de retour dans hMailAdmin. Il ya deux façons de déterminer la valeur à entrer. Soit en lisantla documentation de votre antivirus soit en le testant vous-même. On va maintenant décrirecomment tester soi-même. Notez que vous ne devriez jamais effectuer le test sur un systèmehMailServer de production, car il y a le risque que même e-mail sans virus soit supprimé lors dutest.

La valeur retournée est normalement siruée entre 1 et 255.

Déterminer la valeur

hMailServer - Guide de l'Utilisateur

199 / 214

Etape 1: Activer l'examen antiviral

1.Lancez hMailAdmin2.Accédez aux paramètres de l'antivirus externe.3.Sélectionnez 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 vérifiez la valeur de retour

1.Activez l'application et le journal de débogage.2.Envoyez un e-mail qui contient le virus test eicar.3.Vérifiez la valeur de retour dans le fichier journal.4.Envoyez un e-mail qui ne contient le virus test eicar.5.Vérifiez la valeur de retour dans le fichier journal.

Dans hMailAdmin, vous devez spécifier la valeur de retour qui a été donnée par les journauxlorsque vous avez envoyé le virus de test EICAR. Si vous trouvez que la valeur de retour est lamême lorsque vous joignez le virus de test EICAR et lorsque vous ne le faites pas, il y a alors unproblème. Dans ce cas, vous ne devez spécifier aucune valeur. Signaler ceci dans le forum et vousdevriez 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. Lebut est d'empêcher les utilisateurs non autorisés de modifier votre installation de hMailServer.Lors de l'installation de hMailServer 4.3, vous spécifiez le mot de passe que vous souhaitezutiliser. Un hachage MD5 de ce mot de passe est ensuite stocké dans hMailServer.ini (Le réglageAdministratorPassword dans la section Sécurité)

Changer le mot de passe

Méthode 1 - Utiliser hMailServer Administrator

Si vous connaissez le mot de passe actuel de l'administrateur, ou tout autre mot de passe pour uncompte avec des autorisations d'administration au niveau du serveur, vous pouvez modifier le motde passe à l'aide hMailServer Administrator.

1.Lancez hMailServer Administrator et ouvrez une session.2.Accédez à Configuration -> Avancé3.Entrez le nouveau mot de passe d'administration et enregistrez les changements.

Méthode  2 - Réinstaller hMailServer

1.Supprimez le paramètre AdministratorPassword de hMailServer.ini.2.Réinstallez la même version de hMailServer que vous aviez déjà installée. Lors de l'installation ilvous sera demandé de spécifier le nouveau mot de passe.

Méthode  3 - Utiliser une calculatrice MD5

1.Utilisez une calculatrice MD5 pour calculer un nouvel hachage MD5.2.Spécifiez le nouveau hachage MD5 dans hMailServer.ini. Le réglage que vous devez actualiserest AdministratorPassword3.Relancez le service hMailServer.

 

hMailServer - Guide de l'Utilisateur

200 / 214

Déterminer le mot de passe MySQL hMailServer

Si vous utilisez la version intégrée de MySQL fournie avec hMailServer, vous ne connaissez peut-être pas votre mot de passe. Pour déterminer le mot de passe, procédez comme suit:1.Exécutez le script hMailServer/Addons/Utilities/DecryptBlowfish.vbs.2.Entrez votre mot de passe principal d'administrateur de hMailServer. Il s'agit du mot de passseque vous avez spécifié 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 données de hMailServer.ini dans la boîte 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

Généralités

Cette rubrique décrit comment activer l'authentification SMTP dans votre client de messagerie. Pardéfaut, hMailServer requiert une authentification SMTP à activer dans le client de messagerie.

Outlook Express 6

1.Sélectionnez Comptes dans le menu Outils.2.Sélectionnez l'onglet Messagerie.3.Double-cliquez sur le compte à modifier.4.Sélectionnez l'onglet Serveurs.5.Sous Serveur de Messages Sortants, choisissez Mon serveur nécessite une authentification.

Outlook 2003

1.Sélectionnez Comptes de messagerie dans le menu Outils.2.Sélectionnez Afficher ou changer un compte de messagerie existant3.Double-cliquez sur le compte à modifier.4.Cliquez sur Plus de paramètres.5.Ouvrez l'onglet Serveur Sortant.6.Choisissez Mon serveur sortant (SMTP) nécessite une authentification.7.Vérifiez que Utiliser les même réglages que mon serveur de messagerie entrant est sélectionné.

PHP/mail()

La fonction PHP mail() ne prend pas en charge l'authentification SMTP. Désactivez la plaged'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 décrit comment installer les outils clients hMailServer. Si vous souhaitez gérer votreinstallation hMailServer à distance, vous devez installer les outils clients hMailServer surl'ordinateur à partir duquel vous souhaitez gérer votre installation .1.Lancez le programme d'installation de hMailServer et cliquez sur Suivant dans la fenêtred'accueil.2.Choisissez l'emplacement de l'installation des outils clients et cliquez sur Suivant.3.A la section Sélectionnez les composants, décochez Serveur.4.Cliquez sur Suivant jusqu'à la fin de l'installation.

Régler manuellement la langue de hMailServer

Généralités

hMailServer - Guide de l'Utilisateur

201 / 214

Dans l'installation de hMailServer, seules deux langues sont incluses - suédois et en anglais. Il estcependant possible de configurer hMailServer pour utiliser une plage d'autres langues.

Quelles traductions sont disponibles?

Pour voir les traductions disponibles, allez à la page hMailServer Translation Status. La pageaffiche la liste des langues et la quantité de l'interface utilisateur qui a été traduite dans cettelangue. La traduction de certaines langues ne sont pas complètes à 100%. Cela signifie quecertaines parties de l'interface utilisateur seront toujours affichés en anglais. Par exemple, siseulement 70% de l'interface utilisateur est traduite, 30% de l'interface utilisateur sera affiché enanglais.

Il est recommandé de ne pas utiliser une traduction si moins de 97% de l'interface utilisateur esttraduite. Bien qu'il n'y ait pas de problèmes techniques avec l'utilisation d'une langue qui n'est quepartiellement traduite, cela pourrait être une source de confusion lorsque des chaînes sont dansune langue et d'autres dans une autre langue.

Comment puis-je installer une nouvelle traduction?

A l'avenir, cette fonctionnalité est susceptible d'être intégré dans hMailServer Administrator, maispour l'instant c'est un processus manuel.

1.Accédez à la page hMailServer Translation Status et choisissez la traduction à utiliser.2.Si vous voyez la liste de toutes les chaînes truduites, sélectionnez-les toutes et copiez-les dansle presse-papiers. 3.Lancez le Bloc-notes, et collez les chaînes 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 à cetteligne. Notez que chaque langue est séparée par une virgule. Par exemple:ValidLanguages=english,swedish,french7.Redémarrez le service hMailServer.

Désormais, le service hMailServer connaît l'existence de la traduction en français, dans notreexemple.

Comment puis-je utiliser la nouvelle traduction?

Dans hMailServer Administrator, choisissez Sélectionner une langue du menu Fichier.

Pour configurer WebAdmin pour utiliser cette langue, la spécifier dans le fichier de configuration deWebAdmin, config.php.

Déplacer les spams dans un dossier IMAP

Ces instructions supposent que vous utilisez hMailServer version 4.0 ou supérieure. Elles sontapplicables au courrier marqué comme spam, en utilisant ASSP, mais devraient fonctionner aussibien avec un autre filtre anti-spam. Il est seulement nécessaire que le filtre place un indicateur despam dans l'en-tête, par exemple, en remplaçant simplement les étapes 3 et 4 ci-dessous avecl'en-tête et la valeur appropriée.1.Ouvrez hMailAdmin2.Sélectionnez Règles (pour créer une règle qui s'applique globalement)3.Cliquez sur Ajouter4.Spécifiez un nom pour cette règle5.Cliquez sur Ajouter près de Critère6.Sélectionnez En-tête Personnalisée et entrez X-Assp-Spam7.Entrez YES dans la champ Valeur8.Cliquez sur Enregistrer9.Cliquez sur Ajouter près de Action

hMailServer - Guide de l'Utilisateur

202 / 214

10.Sélectionnez Déplacer dans le dossier IMAP11.Sous Dossier entrez le dossier dans lequel vous souhaitez effectuer le déplacement (exemple:Inbox\SPAM)Le dossier sera automatiquement créé pour les utilisateurs s'il n'existe pas la première fois qu'ilsreçoivent un message de spam.

Proposé par Colin Murphy

Recréer la liste des messages dans la base de données

Contexte

Les messages de hMailServer sont stockés dans le répertoire Data de hMailServer (normalement C:\Program Files\hMailServer\Data). La base de données contient une liste de ces messages. Parexemple, le chemin d'accès au fichier du message, la taille des messages, l'indicateur de messageet les destinataires du message sont stockés dans la base de données.

Lorsque vous téléchargez les messages de hMailServer en utilisant POP3 ou IMAP, hMailServercharge une liste des messages de la base de données pour déterminer si le message existe pourvotre compte. Ainsi, si le fichier e-mail existe sur le disque dans le répertoire Data, mais pas dansla base de données, vous ne serez pas en mesure de télécharger le message.

Normalement, vous ne devriez pas avoir à recréer la liste des messages. Ne pas essayer derecréer la liste des messages, sauf si vous êtes certain que vous avez besoin de le faire. Si vousêtes un doute, n'hésitez pas à poser une question dans le forum des utilisateurs.

Recréer la liste des messages dans la base de données

A l'aide de l'outil DataDirectory Synchronizer, vous pouvez recréer la liste des messages dans labase de données.

Suivez ces étapes pour recréer la liste des messages dans la base de données:

1.Sauvegardez votre système hMailServer (base de données et dossier Data). CommeDataDirectorySynchronizer effectue de nombreuses modifications dans votre base de donnéeshMailServer, cette étape est importante.2.Lancez DataDirectorySynchronizer.exe à partir du dossier Addons3.Cliquez sur Suivant pour lancer la synchronisation

La vitesse de la synchronisation varie en fonction du matériel de l'ordinateur. Sur un Intel P4 à2.4Ghz, vous pouvez estimer qu'environ 50 messages par seconde seront importés.

Remarques importantes

·Vous n'avez pas à arrêter hMailServer avant d'exécuter DDS.·Après que tous les messages aient été importés, DDS redémarrer automatiquement leserveurhMailServer pour actualiser le cache.·Comme les données de messages IMAP, tels que l'information du dossier, les indicateurs demessage, etc sont stockés dans la base de données et non pas dans les fichiers de messages,ces informations ne seront pas recréées quand sera recréée la liste des messages. Parconséquent, quand les messages seront insérés dans la base de données, ils se retrouveronttous dans la boîte de réception et marqué comme non lu.·Les fichiers situés dans le dossier racine Data seront remis aux destinataires locaux des en-têtesA et CC. Les informations de destinataires d'origine, de l'enveloppe SMTP, ne sont pas disponiblesdans les fichiers .EML. Par conséquent, les en-têtes A / CC seront utilisés. Les e-mail ne sont remisqu'aux destinataires locaux pour éviter que des messages soient ré-distribués à des adressesexternes.·Les fichiers situés dans les sous-répertoires du dossier Data, tels que le nom de domaine \d'utilisateur seront reliés à cet utilisateur dans la base de données.·Seuls les fichiers avec l'extension. eml ou. hma sont importées dans la base de données·Les fichiers importés directement dans les comptes d'utilisateurs ne seront pas traités par lesfiltres, les règles, les fonctions de détection de virus de hMailServer.

hMailServer - Guide de l'Utilisateur

203 / 214

Réparer une table MySQL corrompue

Les tables MySQL peuvent se corrompre pour différentes raisons, telles que la défaillance dumatériel, les bogues du système d'exploitation, les virus et les bogues de MySQL. hMailServer lui-même ne provoque pas de corruption des tables MySQL. hMailServer communique avec MySQL viaTCP / IP à l'aide d'un langage standardisé. Il n'y a rien dans ce langage qui puisse entraîner unecorruption des tables.

Si une table MySQL est corrompue, vous devez la réparer. Notez que la réparation d'une tableMySQL corrompus peut conduire à la perte de données. Il est donc important de créer unesauvegarde de votre système.

Comment savoir si une table est corrompue?

Examinez le journal d'erreur de hMailServer. Si vous voyez beaucoup d'erreur formulées lors del'exécution des messages d'état SQL, il est probable qu'une ou plusieurs de vos tables soientcorrompues. N'hésitez pas à demander de l'aide dans le forum si vous n'êtes pas sûr de vous.

Étape 1: Déterminez le mot de passe MySQL

Si vous utilisez une version externe de MySQL, vous devriez déjà connaître votre mot de passeMySQL. Si vous utilisez la version intégrée de MySQL fournie avec hMailServer, vous pourriez nepas le connaître. Pour le déterminer, procédez comme suit:1.Exécutez le script hMailServer/Addons/Utilities/DecryptBlowfish.vbs.2.Entrez votre mot de passe hMailServer Administrator principal. Il s'agit du mot de passe quevous avez spécifié lors de votre première 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 données de hMailServer.ini dans la boîte de dialogue "Entrerle 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 passeDecryptBlowfish va maintenant afficher votre mot de passe. Gardez la boîte de dialogue ouverteou mémorisez le mot de passe.

Étape 2: Connectez-vous au serveur

Pour pouvoir réparer votre table, vous devez vous connectez au serveur MySQL à l'aide d'un clientMySQL. Vous pouvez utiliser SQLyog pour ce faire. 1.Téléchargez et installez SQLyog2.Créez une nouvelle connexion.3.Entrez les informations de connexion pour votre serveur MySQL. Si vous utilisez le serveurintégré, vous devez entrer le nom d'hôte: localhost, d'utilisateur: root, le mot de passe: mot depasse DecryptBlowfish, le port: 33074.Cliquez sur Connexion pour vous connecter au serveur de base de données

Étape 3: Réparer la table

Suivez ces étapes pour exécuter l'instruction SQL afin de réparer la table.1.Dans l'arborescence de gauche, cliquez sur la base de données hmailserver.La base de données de hMailServer devient alors active.2.Dans la partie droite de la fenêtre de SQL, cliquez sur l'onglet Requête.3.Entrez REPAIR TABLE tablename, par exemple, REPAIR TABLE hm_messages.4.Cliquez sur le bouton Exécuter la Requête en Cours de la barre d'outils (ou sélectionnez Editer->Exécuter une Requête->Exécuter la requête en cours ou appuyez sur F5).5.MySQL devrait alors réparer la table. Après la réparation de la table, redémarrez MySQL puis leservice hMailServer. Selon la table qui était corrompue, un redémarrage des services peut ne pasêtre nécessaire, mais nous vous recommandons de le faire systématiquement.

hMailServer - Guide de l'Utilisateur

204 / 214

Réinitialiser le mot de passe de MySQL

Contexte

Lorsque vous installez hMailServer, vous pouvez choisir d'utiliser la base de données MySQLinterne. Si vous le faites, le programme d'installation va créer une base de données MySQL quehMailServer utilisera. Le programme d'installation va également créer un utilisateur root sur leserveur MySQL qui recevra un mot de passe généré de façon aléatoire. Ce mot de passe seraensuite écrit sous forme crypté dans hMailServer.ini. Si vous avez accès à hMailServer.ini, vouspouvez décrypter 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 uneconnexion à Internet) bloquent le trafic sortant sur le port 25. Ce qui ne permet plus à hMailServerde 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 même, pour différentes raisons, des différents peuvent vouloir router tout le courrier sortantvia un service tiers comme gmail.

Étapes

1.Lancez hMailServer Administrator2.Accédez à Configuration > Protocoles > SMTP3.Ouvrez l'onglet Distribution des e-mails.4.Spécifiez les paramètres suivants:Serveur relais SMTP - Le nom d'hôte 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 estutilisé).5.Si le serveur de votre FAI nécessite une authentification, sélectionnez Le serveur nécessite uneauthentification et entrez le nom d'utilisateur et le mot de passe.

Les paramètres ci-dessous sont valables pour les versions 3.4 supérieures.

hMailServer - Guide de l'Utilisateur

205 / 214

Définir des plages IP pour votre réseau privé

Contexte

La plage IP est l'un des mécanismes que hMailServer utilise pour la sécurité. En utilisant desplages d'adresses IP, vous pouvez donner un accès différent aux différents ordinateurs enfonction de leur adresse IP. Par exemple, vous pouvez activer le protocole IMAP pour votre réseaualors que les gens en dehors de votre réseau (par exemple sur Internet), ne peuvent accéder quevia POP3.Normalement, il ne devrait y avoir aucune raison pour ajouter ou supprimer des plages d'adressesIP. Vous ne devriez pas le faire, sauf si vous êtes sûr de ce que vous voulez et comment yparvenir. Les plages d'adresses IP par défaut créés lors de l'installation devraient fonctionner pourla plupart des utilisateurs.

Les étapes suivantes décrivent comment mettre en place plages d'adresses IP pour un réseaudomestique de 3 ordinateurs. On suppose que vous avez un réseau domestique où il a étéattribué aux ordinateurs des adresses IP commençant par 192.168.1.

Etapes

1.Lancez up hMailAdmin.2.Déployez le nœud Configuration3.Sélectionnez les plages IP dans l'arborescence et cliquez sur Ajouter4.Entrez les informations suivantes:

o Nom: Mon réseau privéo Priorité: 25

Lorsque hMailServer détermine la plage IP à utiliser, il peut y avoir plusieurs plages IP

hMailServer - Guide de l'Utilisateur

206 / 214

correspondant aux utilisateurs connectés. Si c'est le cas, la plage d'adresses IP avec lapriorité la plus élevée est utilisée. Pour que cette plage d'adresses IP fonctionnecorrectement, elle doit disposer d'une priorité plus élevée que toutes les autres plagesd'adresses IP.

o IP la plus basse: 192.168.1.0o IP la plus élevée: 192.168.1.255o Autoriser les connexions: SMTP, POP3 et IMAPo Pour les autres paramètres, utiliser les mêmes réglages que pour la plage IP Internet.

Les données ci-dessous sont valables pour les versions 5.2 et supérieures.

Mettre en place un serveur local / autonome

Contexte

Ce document décrit comment configurer un serveur de messagerie pour usage interneuniquement. Les utilisateurs de votre réseau pourront envoyer et recevoir des e-mails via leserveur. Ils ne seront pas en mesure d'envoyer ou de recevoir des emails des autres utilisateurssur Internet.

Créer le domaine

Lancez hMailServer Administrator et choisissez Ajouter un domaine.

Entrez un nom de domaine comme companyname.local. Pour éviter toute confusion, il estrecommandé de ne pas choisir un nom de domaine déjà utilisé par quelqu'un d'autre sur Internet.

Vérifiez que le domaine est activé / actif.

hMailServer - Guide de l'Utilisateur

207 / 214

Créez les comptes

Après la mise en place du domaine, créez des comptes pour vos utilisateurs. Par exemple, vouspouvez configurer des comptes nommés [email protected] et [email protected].

Configurez le pare-feu

Assurez-vous que le pare-feu fonctionnant sur le même 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é créés et le pare-feu configuré, il est temps de configurer vos clientsde messagerie. Comme nom d'utilisateur, vous devez utiliser une adresse e-mail complète, parexemple [email protected].  Comme adresse de serveur, utilisez le nom ou l'adresse IP del'ordinateur sur lequel fonctionne hMailServer. Notez que le nom du serveur n'est généralementpas le même que le nom de domaine.

Terminé

Dès que les étapes ci-dessus sont effectuées, les utilisateurs de votre réseau seront en mesurede 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é testée à la fois avec hMailServer et ASSP fonctionnant sur la mêmeinstallation de Windows 2000 Professionnel, mais cela devrait fonctionner pour pratiquementn'importe quel système qui exécutera 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-mailsPerl installé sous Win32Module Daemon installé

Configurer hMailServer

1.Ouvrir hMailServer Administrator2.Sous Configuration->SMTP, changez le port SMTP pour 125, enregistrez les paramètres etredémarrez le serveur

ASSP Installation & Configuration

hMailServer - Guide de l'Utilisateur

208 / 214

1.L'installation est simple, téléchargez et décompressez les fichiers dans c:\ASSP2.Créez les dossiers suivants:

o c:/assp/spamo c:/assp/notspamo c:/assp/errorso c:/assp/errors/spamo c:/assp/errors/notspam

3.Ouvrez une ligne de commande pour c:\assp. Exécutez: perl assp.pl4.Pointez votre navigateur sur http://127.0.0.1:55555/ nom d'utilisateur vierge, mot de passe nospam4me5.Cochez la case "Afficher les Options de Configuration Avancée" et cliquez sur le bouton Appliquerles changements6.Changez les paramètres suivants:

o Destination SMTP = 127.0.0.1:125o Cochez "Comme un Service" o Port d'écoute = 25o Domaines Locaux = énumérez les domaines que vous avez configuré pour hMailServer

7.Cliquez sur Appliquer les changements8.Appuyez sur Ctrl-C pour arrêter le processus assp.pl9.Exécuter: perl addservice.pl -i c:\assp\assp.pl c:\assp10.Lancer le service Proxy Smtp Anti-Spam11.Testez en essayant telnet pour 127.0.0.1:25; vous devriez voir la bannière du serveur demessagerie.Ceci fait fonctionner ASSP en Mode Test. Le courrier doit maintenant passer par ASSP vershMailServer. Vous remarquerez que les messages s'accumulent dans les répertoires mails etnotspam. Si vous voyez un spam dans le dossier notspam ou vice versa, vous devez déplacermanuellement les messages dans le dossier approprié. Une fois que vous avez accumulé quelque100 messages dans les dossiers mails et notspam, exécutez le script rebuildspamdb.pl. Ce quicréera la base de données spam. Lisez la documentation sur ASSP pour désactiver le mode test etsur l'automatisation de rebuildspamdb.pl

Changer le dossier Data

Contexte

Par défaut, tous les e-mails sont stockés dans le répertoire Data de hMailServer, sous C:\ProgramFiles\hMailServer\Data. Dans certains cas, vous voudrez peut-être changer pour un chemindifférent. Par exemple, si vous avez plus d'espace disque sur un autre lecteur. Bien qu'il soitpossible de modifier le chemin d'accès, les e-mails existants ne seront pas déplacés vers lenouveau chemin. Si vous déplacez les fichiers existants de l'ancien répertoire Data vers lenouveau, votre client de messagerie ne sera pas en mesure de les télécharger.

Etapes

1.Ouvrez hMailServer.ini2.Localisez DataFolder à la section Directories3.Indiquez le nouveau chemin

Remarque

·Si vous souhaitez déplacer vos fichiers de messages existants, vous devez vous connecter auserveur de base de données 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 messageriepeut utiliser pour télécharger des e-mail à partir d'un serveur de messagerie. IMAP comprendbeaucoup plus de fonctionnalités que POP3. Le protocole IMAP est conçu pour permettre auxutilisateurs de garder leur e-mail sur le serveur. Le protocole IMAP nécessite plus d'espace disqueet de ressources CPU sur le serveur que le protocole POP3, car tous les messages restent stockéssur le serveur après que le client de messagerie les a téléchargés. IMAP utilise normalement le

hMailServer - Guide de l'Utilisateur

209 / 214

port 143.

Dossiers IMAP

C'est le client IMAP lui-même (client webmail, Outlook Express, Netscape Mail et ainsi de suite) quiest responsable des propriétés des composants mis en place sur le client IMAP. Par exemple,hMailServer ne décide pas du nom que doit avoir le dossier "Eléments envoyés". Il ne sait pas nonplus que le dossier "Eléments envoyés" contient effectivement des éléments envoyés. Le clientIMAP demande au serveur de créer un dossier pour les éléments envoyés, puis place lesmessages dans le dossier. Si vous souhaitez modifier le nom de ce dossier, vous devez le fairedans votre client IMAP, pas dans hMailServer.

Rafraîchir le liste des dossiers IMAP

Le protocole IMAP ne fournit pas de mécanisme pour l'actualisation automatique des dossiersIMAP. Si vous avez plusieurs clients IMAP connectés au même compte en même temps, et que l'undes clients crée un nouveau dossier IMAP, les autres clients ne seront pas automatiquementavertis de ce dossier.

Rafraîchir la liste des messages

Le protocole IMAP possède une extension appelée IMAP IDLE. L'extension IMAP IDLE permet auclient de "S'abonner" dans un dossier IMAP et de recevoir des notifications à partir du serveurlorsque de nouveaux messages existent et lorsque l'état des messages change. De cette façon, leclient n'a pas besoin de vérifier les nouveaux messages lui-même. hMailServer 4.3 et ultérieuresprennent en charge cette extension.

Trier la liste des messages

hMailServer prend en charge l'extension IMAP SORT. Cette extension peut considérablementaméliorer les performances lorsque vous travaillez avec de grands dossiers IMAP. Pour en savoirplus....

Séparateur de dossiers

hMailServer utilise le . (point) comme séparateur de dossiers. Cela signifie que vous ne pouvezpas avoir de point dans un nom de dossier IMAP.

Extension IMAP Sort

Généralités

hMailServer 4.2 et ultérieur prend en charge l'extension IMAP sort. Cette extension peut améliorerles performances lors du chargement des boîtes 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 leserveur, au lieu du client. Par exemple, si la boîte aux lettres contient 1000 e-mails et que le clientne veut charger que les 10 messages les plus récent, il peut demander au serveur les 10 dernierse-mails. Si le client n'utilise pas l'extension IMAP Sort, il doit télécharger les 1000 e-mails et fairelui-même le tri.

Prise en charge IPv6

hMailServer - Guide de l'Utilisateur

210 / 214

Généralités

hMailServer prend en charge IPv4 et IPv6. La plupart des serveurs de messagerie sur Internetutilisent IP version 4.

Comment fonctionne t-il?

La prise en charge IPv6 sera automatiquement activée dans hMailServer si elle est activée dans lesystème d'exploitation. Si vous activez IPv6 dans le système d'exploitation, vous aurez besoin deredémarrer le service hMailServer pour que hMailServer devienne pleinement informé de laprésence d'IPv6.

Dans toutes les boîtes de dialogue de l'administrateur et de WebAdmin où vous pouvez entrer desadresses IP, vous pouvez saisir les adresses IPv4 et IPv6. Le stockage de base de données 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 votreréseau, vous pouvez spécifier l'une des trois valeurs dans les réglages du relais SMTP:

·Le nom du serveur hôte·L'adresse IPv4 du serveur·L'adresse IPv6 du serveur

De même, lorsque vous configurez hMailServer pour surveiller ou de se lier à une adresse IPspécifique, vous pouvez saisir une adresse IPv4 ou une adresse IPv6.

Configuration

La configuration par défaut de hMailServer ne surveille pas les adresses IPv6. Si vous voulez quehMailServer surveille l'adresse IPv6, vous devez faire deux choses. Notez que ces modifications deconfiguration ne sont nécessaires 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, ceschangements ne sont pas nécessaires.

Ajouter un port TCP/IP

Dans hMailServer Administrator, accédez à Configuration, Avancé, Ports TCP/IP. Ajoutez unnouveau port TCP/IP et spécifiez l'adresse IPv6 que vous souhaitez surveiller. Sinon, hMailServerne surveillera aucune adresse IPv6.

Ajouter une lage IP

Créer une nouvelle plage IP couvrant Internet IPv6 - :: - ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff. Dans la plageIP, choisissez les mêmes paramètres que dans la plage IP Internet déjà existante. Sinon,hMailServer acceptera toujours les connexions entrantes sur IPv6, mais il débrancheraimmédiatement 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 enfonction de la configuration de votre système d'exploitation. Microsoft Windows 2003 prend encharge DCOM sur IPv6. Les versions antérieures de Windows peuvent ne pas prendre en chargeDCOM sur IPv6. Il ne s'agit pas vraiment d'une limitation de hMailServer mais des limitations dansla prise en charge du système d'exploitation Windows pour DCOM.

 

hMailServer - Guide de l'Utilisateur

211 / 214

Tests des relais ouvert

Dès que vous avez terminé l'installation et la configuration de hMailServer, vous devez exécuterdes tests de relais ouvert. Ce qui vous garantit que votre serveur ne sera pas utilisé pour duspam.

·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 signifieque le test de relais ouvert prétend que votre serveur peut être un relais ouvert même s'il ne l'estpas. En d'autres termes, le serveur peut vous donner un avertissement, même si vous n'avez rienà craindre.

Domaine par défaut et adresse fourre-tout

Si vous spécifiez un domaine par défaut dans hMailServer, ce nom de domaine sera ajouté àtoutes les adresses e-mail à qui il manque un nom de domaine (le réglage se trouve danshMailServer Administrator sous Configuration->Avancé). Si vous spécifiez le domaine example.compar défaut, et que quelqu'un tente d'envoyer un mail au webmaster, hMailServer supposera que lemessage doit être envoyée à [email protected].

Si vous spécifiez une adresse fourre-tout pour un domaine, hMailServer acceptera tous les emailsenvoyés à ce domaine. Si l'adresse du destinataire ne correspond pas à un compte, le messagesera envoyé à l'adresse fourre-tout.

Combiner les paramètres du domaine par défaut avec le réglage de l'adresse fourre-tout peutconduire à des faux positifs. Si vous avez activé ces deux paramètres et que quelqu'un seconnecte à votre serveur pour envoyer un courriel à <any-random-string>, hMailServer accepterala distribution. hMailServer va tout d'abord ajouter le domaine par défaut à 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 livrée sur le compte fourre-tout.

 

Gestion à distance

Généralités

Il existe deux méthodes courantes différentes pour gérer une installation hMailServer à distance.La première consiste à utiliser PHPWebAdmin. PHPWebAdmin est un package d'administrationbasée sur le Web qui offre presque les mêmes fonctionnalités que hMailServer (l'édition de règlesn'est pas disponible dans PHPWebAdmin). PHPWebAdmin nécessite un serveur web avec prise encharge de PHP afin de fonctionner, mais il permet de gérer votre installation hMailServer den'importe où sur Internet. L'autre méthode consiste à installer les outils clients hMailServer et dese connecter à distance sur l'installation hMailServer. En raison de blocage du port dans le pare-feu cette méthode ne fonctionne que sur un réseau local ou une connexion VPN. Théoriquement, ilserait possible d'ouvrir ces ports mais ce n'est pas recommandé en raison de problèmes desécurité.

Utiliser PHPWebAdmin

Consultez le didacticiel d'installation pour PHPWebAdmin.

hMailServer - Guide de l'Utilisateur

212 / 214

Utiliser hMailServer Administrator

Pour vous connecter à une instance de hMailServer s'exécutant sur un autre ordinateur de votreréseau, exécutez le programme d'installation de hMailServer sur l'ordinateur à partir duquel voussouhaitez vous connecte. Lors de l'installation choisissez d'installer les outils clients. Aprèsl'installation des outils clients démarrez hMailServer Administrator. Dans la boîte de dialogue deconnexion, sélectionnez l'option "localhost" et cliquez sur Editer, puis entrez les informationsappropriées.

Problèmes courants

Lorsque vous utilisez l'administrateur de hMailServer pour se connecter à une instance en coursd'exécution de hMailServer sur un autre ordinateur, il n'est pas rare que vous obteniez unmessage de refus d'accès. hMailServer Administrator utilise DCOM / RPC pour communiquer avecl'instance de hMailServer sur l'autre ordinateur et pour que cela fonctionne correctement, vousdevez peut-être modifier les paramètres de votre client ou serveur. En raison des limites de cettetechnologie Microsoft, il n'est pas possible pour l'administrateur de hMailServer de déterminer lacause originelle de ce message Accès refusé, si vous avez besoin de vérifier manuellement lesparamètres. Si vous obtenez une erreur Accès refusé, ou une Erreur d'Automatisation lorsquevous essayez de vous connecter, vérifiez que ...

·le service d'Appel de procédure 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, consultezMicrosoft KB217351.·les entrés de base de registre ont la valeur suivante:

o HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Ole\EnableDCOMo HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Ole\EnableRemoteConnect

·que DCOM est actif sur le client et le serveur comme décrit 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 compteWindows avec le même nom et mot de passe existe sur le serveur et le client, et que vous avezouvert une session en tant que cet utilisateur.

Fonctionnement interne

Gestionnaires de commande

Généralités

La communication entre un serveur de messagerie et un client de messagerie est constitué d'ungrand nombre de commandes différentes et de transfert de données. Généralement, un client demessagerie se connecte à un serveur de messagerie sur TCP / IP et transfère les données via unsocket. Lorsque le client de messagerie a envoyé toutes ses commandes, il se déconnecte etferme la connexion TCP / IP. Exemples de commandes qu'un client peut envoyer: commandes deconnexion, diffusion de messages , récupération de messages, création de boîtes aux lettres, etainsi de suite.

L'ancien groupe d'unités d'exécution

Dans hMailServer 4.2 et version antérieure, hMailServer lançait un nouveau processus (thread) dusystème d'exploitation à chaque nouvelle connexion TCP / IP (les processus sont un moyen, pourles logiciels, d'exécuter plusieurs tâches à la fois). Chaque processus était responsable de lasurveillance d'une seule connexion TCP / IP, et de la manipulation des commandes envoyées parle client. Créer un nouveau processus était une opération assez intensive pour le CPU. Pourrésoudre ce problème, hMailServer proposait cette fameuse unité d'exécution. Lors du démarrage,il estimait le nombre de processus nécessaires, et les lançait immédiatement, même si aucun clientn'était connecté. Quand un client se connectait, hMailServer attribuait à l'un de ses processus laresponsabilité de gérer ce client de messagerie.

hMailServer - Guide de l'Utilisateur

213 / 214

Les unités d'exécution de hMailServer 4.2 contenaient rarement assez de processus, ainsi denouveaux processus devaient être lancés lorsque les clients se connectaient. Comme mentionnéprécédemment, lancer des processus est une opération assez intensive pour le CPU, ce qui n'étaitpas bon pour la performance. La solution consistait à lancer un grand nombre de processus lorsdu démarrage du service. Mais lancer plusieurs processus en même temps était égalementnéfaste pour la performance. Un CPU simple cœur ne peut exécuter qu'une seule tâche à unmoment donné. Cela signifie que si le logiciel veut exécuter deux choses en même temps, le CPUva d'abord traiter une petite partie de la tâche 1, puis une petite partie de la tâche 2, puis unepetite partie de la tâche 1 et à nouveau la tâche 2 et ainsi de suite . Ces allers-retours(commutation des tâches) conduit à un gaspillage des processus - le système d'exploitation doitpasser plus de temps sur la commutation des tâches que sur le traitement effectif des tâches .

Le nouveau gestionnaire de commandes

Dans hMailServer 4.3, une nouvelle méthode basée sur un gestionnaire de commande est utilisée.Lors d'un démarrage du service, un nombre fixe de processus de commandes est lancé (définidans Avancé-> Performance-> Paramètres des Processus). hMailServer indique à Windows queces processus sont prêts à traiter les commandes des clients TCP / IP. Lorsqu'un client demessagerie se connecte, hMailServer indique à Windows qu'il est intéressé par toutes lesdonnées que ce client envoie.

Lorsqu' un client de messagerie envoie une commande au serveur, le noyau Windows donnel'ordre de traiter la commande à l'un de ses processus de commande. Le processus de commandetraitera la commande et indiquera à Windows que tout est prêt pour traiter une autre commande.Ce qui signifie qu'un processus de commande unique peut exécuter des commandes pour denombreux clients de messagerie. La plupart du temps, les clients de messagerie sont inactifs (ilsn'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 clientssimultanés que le nombre de processus de commandes . Ce qui n'est normalement pas unproblème car les commandes sont traitées très rapidement. Comme le nombre de processus decommandes est limité, chaque commande peut s'exécuter plus rapidement que si le nombre decommandes parallèles é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 cœur de processeur unique ne peut jamais exécuter plus d'une tâches à la fois,le gestionnaires de commandes de hMailServer 4.3 donnera dans l'ensemble de meilleuresperformances que la méthode "processus par connexion" de hMailServer 4.2.

Les RFC

Généralités

Cette rubrique décrit les RFC pertinents pour hMailServer.

Protocoles

·RFC 5321 - Simple Mail Transfer Protocol, SMTP·RFC 3501 - Internet Message Access Protocol, IMAP, v4·RFC 1939 - Post Office Protocol, POP, v3

Encodage de message

·RFC 2047 - MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensionspour texte non ASCII

o RFC 2045 décrit un mécanisme pour désigner les parties textuelles du corps qui sont codéesvia différents jeux de caractères, ainsi que les méthodes pour coder ces parties du corpsselon des séquences de caractères imprimables US-ASCII. Cette note décrit des techniquessimilaires pour permettre l'encodage de texte non-ASCII dans diverses parties d'un en-têtede message RFC 822 [2], d'une manière qu'il est peu probable de confondre avec leslogiciels de traitement d'en-tête de message existants.

hMailServer - Guide de l'Utilisateur

214 / 214

 ·RFC 2184 - MIME Parameter Value et Encoded Word Extensions: Jeux de Caractères, Langages,et suites

o un moyen de spécifier les valeurs des paramètres dans les jeux de caractères autres queUS-ASCII

o pour spécifier la langue à utiliser si la valeur est affichée, eto un mécanisme de continuité pour les valeurs de paramètres longs pour éviter les problèmes

avec les retours à la ligne d'en-tête.

Extensions IMAP

·RFC 2177 - Commande IMAP4 IDLECette commande permet aux serveurs IMAP d'aviser les clients connectés quand un nouveaumessage est arrivé (plutôt que d'avoir des requêtes des clients pour les nouveaux messages).·RFC 4314 - Liste de Contrôle d'Accès IMAP4Cette extension permet de créer des dossiers publics partagés entre plusieurs dossiers. Ledocument précise par exemple la façon dont l'accès est accordé par un client IMAP.·RFC 2087 - Extension IMAP QuotaAvec cette extension, les cients IMAP peuvent vérifier quel quota de disque du serveur a été utiliséet quelle quantité est disponible.·RFC 5256 - Extensions SORT et THREADL'extension SORT offre des capacités de tri côté serveur. Ce qui ajoute de la performance, puisqueles clients IMAP n'ont pas à télécharger tous les messages dans une boîte aux lettres pourpouvoir les trier. L'extension Thread n'est pas implémentée dans hMailServer. 

Autre

·RFC 4871 - spécification DKIM DomainKeys Identified Mail (DKIM) définit un cadre d'authentification au niveau du domaine pour lecourrier électronique en utilisant la cryptographie à clé publique et la technologie de serveur declés pour permettre la vérification de la source et le contenu des messages par des Agents deTransfert 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.