Foire aux questions

Comment relancer l'Assistant de Configuration de PYTHEAS MailGate

Cela peut s'avérer utile pour faire des modifications majeures dans la configuration, comme par ex. activer le courrier sortant, ou encore changer votre serveur de messagerie. L'assistant ne se comportera pas comme "un éléphant dans un magasin de porcelaine" - il n'effacera pas les options déjà configurées, et ne modifiera que le strict minimum. Voici la procédure:

• En v. 3.x: Utilisez le bouton sur la page A Propos du Panneau de Configuration de PYTHEAS MailGate.
• En v. 2.x: Si vous avez installé le programme en tant que service Windows NT/200x : arrêtez le service Pytheas.MailGate. Puis démarrez le PYTHEAS MailGate Communication Task à partir du menu Démarrer. Sur la page Configuration (onglet), vous trouverez le bouton Configuration Wizard. Après avoir sollicité l'assistant, et si vous avez installé le programme en tant que service Windows NT/200x, fermez le Communicaion Task. Puis redémarrez le service the Pytheas.MailGate.

Comment configurer l'envoi des messages Session Log

Pour éviter de les recevoir

• Décocher la case Envoyer le Session Log ici sur la page de propriétés du Destinataire (Recipient). Cette case a probablement été cochée par l'Assistant de Configuration.

Pour les recevoir

• Cocher la case Envoyer le Session Log ici sur la page de propriétés d'un des Destinataires (Recipient).
• Afin de ne les recevoir uniquement quand la situation mérite une attention particulière: cocher la case Envoyer des messages "Session Log" seulement en cas d'erreur sur la page Régrlages du service / Journaux (Logging). Ainsi, ces messages ne seront envoyés qu'en cas d'anomalie.
• Vous pouvez aussi positionner le paramètre Seuil pour le compteur d'erreurs... à une valeur de 2. Avec ce paramétrage, le Session log n'est envoyé que lorsqu'une connexion à une boîte aux lettres POP3 échoue dans 2 sessions consécutives.

Formatage des Session Logs

• Les Session Logs deviennent beaucoup plus lisibles si vous empêchez Outlook d'enlever des sauts de ligne qu'il considère superflus. Pour cela, dans Microsoft Outlook: Options, Courrier, section Format de message, Décocher la case Supprimer les sautes de ligne superflus dans les messages en texte brut.

Comptes POP3 de moindre importance

• Si vous avez dans votre configuration des Comptes POP3 de moindre importance, et vous ne souhaitez pas recevoir des messages Session log chaque fois un problème de connexion survient, vous pouvez ajouter le mot NoWarning au champ comment de ces comptes POP3 (supporté depuis la v. 2.74).

Ecrire les Session Logs dans un fichier

Session Logs peuvent être écrits dans un fichier sur disque.

Pour activer cette fonction en v.3.x : utilisez la case à cocher sur la page Réglages du service / Journeaux.
Pour activer cette fonction en v. 2.x : dans PMailGat.ini, [Options], configurer le paramètre Logmsg to disk avec une valeur de 1.

A partir de la v. 2.75c, ces fichiers sont créés dans ProgramData\Pytheas\PytheasMailgate\Log (i.e. dans le sous-dossier du dossier où se situe PMailGat.ini).
NB: dans les version précédentes, ces fichiers sont créés dans le dossier d'installation, où se trouve PMailGat.exe.

A partir de la v. 3.22, ces fichiers sont écrits systématiquement en cas d'erreur lors de la session, même si cela n'est pas demandé par ailleurs. Ils sont supprimés après 30 jours.

Comment transférer une installation existante sur une nouvelle machine

... tout en conservant le paramétrage. Procédez de la manière suivante :

NB: Pour rendre le dossier ProgramData visible dans l'interface graphique de l'Explorateur de fichiers Windows, vous devez autoriser l'affichage des dossiers et fichiers cachés. Ou taper ce nom directement dans la barre d'adresses de l'Explorateur de fichiers.

• Vérifiez que vous disposez du fichier contenant votre clé de licence (pytheas.ini).
• Installez la version la plus récente du produit sur la nouvelle machine.  Nous recommandons d'utiliser la version "mise à jour", et non pas la version d'évaluation. A la fin évitez le lancement de PYTHEAS MailGate.
• L'étape suivante dépend où exactement se trouve le fichier PMailGat.INI sur l'ancienne machine :
  • S'il se trouve dans \Program_Files_(x86)\PytheasMailgate :
    Copiez le contenu de ce dossier de l'ancienne machine (y compris les dossiers qu'il contient) vers le dossier C:\ProgramData\Pytheas\PytheasMailgate sur la nouvelle machine. Dans ce dossier sur la nouvelle machine, supprimer les fichiers avec les extensions .exe, .cmd, .dll, .tlb, .manifest, .chm, .hlp, .cnt, .gid .
  • S'il se trouve dans C:\ProgramData\Pytheas\PytheasMailgate :
    Copiez le contenu de ce dossier (y compris les dossiers qu'il contient) de l'ancienne machine vers le dossier C:\ProgramData\Pytheas\PytheasMailgate sur la nouvelle machine.
• S'ils existent, copiez \Program files\PytheasMailgate\SA.CMD, DOS2UNIX.EXE et UNIX2DOS.EXE de l'ancienne machine dans le dossier \Program_Files_(x86)\PytheasMailgate sur la nouvelle machine.
• Démarrez le Panneau de Configuration de PYTHEAS MailGate. Allez sur la page A propos... et activez votre clé de licence.
• Depuis la page A Propos, démarrez l'Assistant de Configuration et passez soigneusement toutes les pages en revue. Faites particulièrement attention à toute adresse IP (ces adresses sont probablement différentes pour la nouvelle machine) et au paramétrage de votre serveur de messagerie (il est peut-être nouveau, lui aussi). Après la dernière étape, cliquez sur Appliquer et fermez l'assistant.
• Passez votre paramétrage en revue. Faites encore particulièrement attention aux adresses IP.
• Sur la page Tableau de bord vous trouverez la possibilité d'installer et démarrer le service Pytheas.Mailgate.
• Si vous ne trouvez pas vos anciennes données de configuration, vérifiez qu'il n'existe pas de fichier nommé PMailGat.INI dans le dossier \Program files_(x86)\PytheasMailgate. S'il y en a, supprimez-le de là. Puis recommencez les vérifications avec l'Assistant de Configuration et le Panneau de Configuration.

Comment gérer efficacement un grand nombre de boîtes aux lettres POP3 ou de Destinataires (Recipients) ?

Par défaut PYTHEAS MailGate sauvegarde l'ensemble du paramétrage dans un fichier de configuration au format INI. Si vous gérez un grand nombre de boîtes aux lettres, la taille de ce fichier peut s'approcher de la limite de taille imposé par le système d'exploitation (qui peut être aussi basse que 64 ko). Dans ce cas, il est recommandé d'enregistrer le paramétrage des comptes POP3 et/ou des Destinataires dans des fichiers séparés. Dans la mesure où ces fichiers sont au format texte avec le caractère de tabulation comme séparateur de colonnes, ce format d'enregistrement présente également l'avantage de permettre la modification du paramétrage en utilisant votre logiciel tableur préféré. Vous pouvez bien entendu aussi continuer à utiliser le Panneau de Configuration (Programme de Configuration) comme avant.

Le procédé, ainsi que la structure détaillée des fichiers, sont décrits dans le fichier d'aide en ligne ; cherchez les chapitre How to keep the list of POP3 Accounts in a separate file et How to keep the list of Recipients in a separate file. Voici un aperçu de la procédure :

• Faites une copie de sauvegarde de PMailGat.INI.
• Dans PMailGat.INI, section [Options], modifiez la ligne Keep accounts in file (pour la liste des comptes POP3), ou  Keep Recipients in file (pour la liste des Destinataires), on y ajoutant un nom de fichier, sans aucune information de chemin d'accès. Par exemple:
  Keep accounts in file=PmgAccountlist.txt
  Si vous modifiez les deux lignes, n'utilisez pas le même nom de fichier !
• Redémarrez le Programme de Configuration de PYTHEAS MailGate. Tant que le fichier PmgAccountlist.txt (selon notre exemple) n'existe pas, le paramétrage des comptes POP3 ou Destinataires sera lu comme avant à partir du fichier PMailGat.INI. Par contre, à partir de maintenant, une sauvegarde du paramétrage aura lieu dans le fichier PmgAccountlist.txt (faites une modification quelconque pour un de vos comptes POP3 ou Destinataires), et à partir du moment où le fichier existe, aussi la lecture du paramétrage.
• Si tout se déroule sans problème, vérifiez que les données de configuration ont bien migrées vers les nouveaux fichiers. Elles sont créés dans le même dossier que PMailGat.INI. Vous pouvez consulter l'emplacement de ce fichier sur la page About du Panneau (Programme) de Configuration.

Les points suivants méritent également votre attention :

• Vous allez constater que les mots de passe des comptes POP3 figurent sous forme cryptée dans le fichier, ce qui compromet leur saisie ou modification avec un tableur quelconque. Deux solutions : les éditer comme avant avec le Panneau (Programme) de Configuration, ou donner l'instruction à PYTHEAS MailGate de ne pas crypter ces mots de passe. Vous pouvez obtenir ce comportement avec une valeur de 1 pour e paramètre POP3 Password not encrypted (à ajouter dans la section [Options] de PMailGat.INI). Veuillez noter cependant qu'une modification de ce paramètre vous obligera de ressaisir les mots de passe pour l'ensemble des comptes POP3. Vous pouvez également obtenir auprès de notre support technique un composant logiciel permettant de réaliser le cryptage du mot de passe.
• Pour que le service Pytheas.Mailgate (la Tâche de Communication) tienne compte des modifications effectuées avec votre logiciel tableur préféré, lancez le Panneau (Programme) de Configuration de PYTHEAS MailGate avec le paramètre de ligne de commande /touch .

PYTHEAS MailGate comme service Windows

En v. 3.x:

• l'installation du service Windows est prise en charge par l'Assistant de Configuration.
• Depuis la page Tableau de bord, vous pouvez installer, surveiller, démarrer, arrêter et désinstaller le service Windows.

En v. 2.x:

• Rendez-vous sur la page Configuration de la Tâche de Communication (PYTHEAS MailGate Communication Task). Puis utilisez le bouton prévu à cet effet.
• Pensez à fermer la Tâche de Communication, avant de démarrer le service Pytheas.Mailgate avec le gestionnaire des services Windows (services.msc).

Sauvegarde de la configuration de PYTHEAS MailGate

• L'emplacement des fichiers de configuration est affiché sur la page About du Panneau de Configuration (Programme de Configuration)..
  Il peut s'agir des emplacements suivants :
  • ProgramData\Pytheas\PytheasMailgate: sauvegardez le dossier entier, y compris les sous-dossiers,
  • Program_files_(x86)\PytheasMailgate (sur des systèmes x64) ou Program_files\PytheasMailgate (sur des systèmes x86): sauvegardez tous les fichiers ayant une extension différente de : exe, cmd, dll, manifest, tlb, chm, hlp, cnt, gid, log.

Comment conserver les messages sur le serveur POP3 après leur téléchargement

• En v. 3.x : Sélectionnez l'option sur la page des propriétés du Compte POP3.
  En v. 2.x : Cochez la case Don't delete messages forwarded to this Recipient sur la page de propriétés de chaque destinataire (Recipient) concerné.
• En v. 2.x seulement: Si le compte POP3 reçoit du courriel pour plusieurs destinataires (Recipients), cochez aussi la case Don't delete non routable messages sur les pages de propriétés du compte POP3.
• Nous recommandons d'utiliser également la fonction Delete mail left on POP3 server after ...days sur la page de propriétés du compte POP3. Cela vous aidera à maintenir le volume des messages conservés en dessous de la limite fixée par votre fournisseur d'accès.

Messages de grande taille et limitations

Repérer la taille maximale des messages acceptée par la serveur qui héberge la boîte aux lettres POP3

Tous les serveurs SMTP/POP3 imposent une taille maximale aux messages entrants. Vous avez peut-être une fiche technique; sinon, pour connaitre la taille limite qui s'applique pour vos boîtes aux lettres POP3 procédez comme suit :

• repérer le nom du serveur SMTP qui reçoit le courriel pour vos boîtes aux lettres POP3 avec NSLOOKUP. Ouvrir une fenêtre "ligne de commande":
  > NSLOOKUP
> SET TYPE=MX
> votredomaine.com
  vous listera la/les serveur SMTP en question. Remplacez "votredomaine.com" par le suffixe de domaine de l'adresse SMTP de la boîte aux lettres POP3 à examiner.
  NB: si, en fonction de votre installation, cela ne vous liste que des serveurs SMTP de votre réseau local, changez de serveur DNS grâce à la commande SERVER (prenez en un à l'extérieur de l'entreprise, que vous pouvez souvent trouver dans la configuration des redirecteurs des serveurs DNS de votre réseau local).
• NB: nous allons faire des modifications dans la configuration de PYTHEAS MailGate, mais ne les sauvegardez pas !
  Lancez le Panneau / Programme de Configuration de PYTHEAS MailGate, page "Serveur de messagerie",
  si la case "sur cette machine" est cochée: décochez-la,
  dans "Nom du serveur", saisissez un des serveurs SMTP repérés avec NSLOOKUP.
  click sur "Essai de connexion", et repérez la ligne qui commence par 250-SIZE qui annonce la taille maximale de messages acceptée (en octets).
  Ensuite refermez le Panneau / Programme de Configuration de PYTHEAS MailGate sans sauvegarder la configuration.

Décision à prendre: voulez-vous accepter les messages entrants avec la même limite sur votre serveur de messagerie interne (Microsoft Exchange par ex.) ?

Si oui :

• Configurez cette limite (en fait, quelques % de plus) dans le Connecteur de Réception (voir ici pour Microsoft Exchange 2013 / 2016 , 2010 ou 2007).

Si non :

• Dans la configuration de PYTHEAS MailGate, pages de propriétés des Comptes POP3, configurez la taille limite que vous souhaitez admettre ("Taille maximale pour messages"), et configurez votre Connecteur de Réception en cohérence avec ce choix (quelques % plus grand).
• Si désormais un message au delà de la limite est présent dans la boîte aux lettres POP3, ce message ne sera pas téléchargé, et son destinataire en sera averti. Si vous configurez le Connecteur de Réception correctement, PYTHEAS MailGate (depuis la v. 2.72) sera aussi capable d'extraire la taille maximale des messages de la réponse du Connecteur de Réception, et ne téléchargera pas un tel message, même si vous ne configurez pas la taille maximale des messages dans PYTHEAS MailGate, comme nous l'avons recommandé ci-dessus (toutefois, dans ce cas, PYTHEAS MailGate émettra un avertissement dans son session log).
• Le message ne sera pas supprimé tout de suite, mais peut l’être avec du retard (option « supprimer les messages restés sur le serveur POP3 après… jours"). Vous pouvez aussi supprimer le message avec la fonction "Afficher/supprimer messages dans la boîte aux lettres". Sachez que tant que le message n'est pas supprimé, vous pouvez provoquer son téléchargement et remise en augmentant la limitation de la taille, et en s'assurant que votre serveur de messagerie veuille bien l'accepter (cf. ci-dessus).
• Optionnellement, PYTHEAS MailGate (depuis la v. 2.50) peut renvoyer un avertissement à l’expéditeur  ("avertir également l'expéditeur..."). Vous pouvez personnaliser cet avertissement "Les modèles pour notifications", "...renvoyée à l'expéditeur pour message au delà de la taille limite". Si cette fonction est grisée dans votre installation, c'est parce-que le module "Règles d'analyse du contenu" n'est pas activé par votre clé de licence, nécessaire à son fonctionnement.

Investigations autour du problème "Déconnexion inattendue du serveur POP3..." ("Unexpected disconnection from POP3 server: The server has closed the connection")

Il faut s'occuper de cette situation si cette erreur apparait d'une manière répétée pour un certain message. Dans la plupart des situation que nous avons pu investiguer, le "coupable" était un programme Antivirus ou Antispam, par où transitaient les communications sortantes du port TCP 110, qui avait du mal à "digérer" le message en question.

1. Vérification avec Telnet sur la machine où PYTHEAS MailGate est installé

Veuillez utiliser cette procédure. A l'étape 4, au lieu de supprimer le message (DELE n), tapez:
RETR n
Quand tout fonctionne comme il le faut, le message entier est téléchargé, et s'affiche au fur et à mesure dans la fenêtre dans laquelle vous avez lancé Telnet.

Si Telnet parvient à télécharger le message en entier sans perte de la session Telnet, veuillez contacter notre support technique pour investigation.

Si la connexion Telnet est perdue (comme cela arrive à PYTHEAS MailGate), cherchez un message d'erreur dans la partie basse de la fenêtre (une ligne qui commence par le code -ERR); elle pourrait nous donner des informations supplémentaires. S'il n'y a rien de tel, veuillez continuer avec l'étape 2.

2. Est-ce qu'il y a un programme Antivirus ou Antispam installé sur la machine où PYTHEAS MailGate est installé?

S'il y en a, veuillez l'arrêter temporairement, et refaire le test. Si le problème n'est pas réglé, veuillez continuer avec l'étape 3.

3. Une fonction Antivirus ou Antispam sur le pare-feu Internet?

Si vous avez accès à la configuration du firewall, désactivez la fonction en question temporairement et réessayez.

4. Refaire l'essai (1) sur d'autres machines

Refaites l'essai (1) sur une autre machine utilisant la même connexion Internet. Si le test se déroule normalement, cherchez le problème plutôt sur la machine sur laquelle PYTHEAS MailGate est installé. Dans le cas contraire, faites l'essai (5).

5. Refaire l'essai (1) en passant par un autre accès Internet

Si le test se déroule normalement sur une telle machine, le problème se situe plutôt au niveau du pare-feu du réseau où PYTHEAS MailGate est installé. Est-ce qu'il y a une protection antispam/antivirus installé sur le pare-feu?). Si, sur une telle machine, vous constatez également la rupture de la connexion Telnet, ou, autrement dit, s'il semble impossible de trouver une machine, sur laquelle la connexion Telnet reste intact après le téléchargement du message en question, nous vous recommandons de vous tourner vers le prestataire qui héberge le serveur POP3.

Messages refusés en tant que spam par le serveur Microsoft Exchange

Si vous avez installé et activé les agents anti-spam sur votre serveur Microsoft Exchange, il arrive qu'il refuse certains messages que PYTHEAS MailGate cherche à lui transmettre. De son côté, PYTHEAS MailGate considère un transfert de message terminé quand le message a été accepté par le serveur de messagerie en aval, et va donc réessayer de transmettre ce message à la prochaine occasion.

Afin de résoudre cette problématique, vous pouvez désactiver les agents anti-spam. Ou (à partir de la v. 2.74), vous pouvez configurer PYTHEAS MailGate afin de reconnaitre les messages d'erreur du refus.

En v. 3.x: Sur la page Règles d'analyse du contenu, Détection de spam, remplissez le formulaire.

En v. 2.x: Les paramètres suivants ont été mis en place dans le fichier de configuration (PMailGat.INI), dans la section [Rules] (veuillez noter que les noms de ces paramètres sont ajoutés automatiquement):

• Rejected as spam SMTP error code=550 (cette valeur est configurée par défaut, à laisser dans la majorité des cas)
• Rejected as spam SMTP response: par défaut, cette valeur est vide, ce que désactive cette fonction de reconnaissance. Configurez ici une valeur comme: "Message rejected as spam by Content Filtering" (cette valeur correspond au message d'erreur smtp renvoyé par Exchange 2013). Pour activer la fonction, cette valeur doit avoir une longueur minimale de 4 symboles, et doit apparaitre dans le message d'erreur smtp afin que celui-ci soit reconnu en tant que message de refus. La casse n'a pas d'importance. Un tel message d'erreur apparait dans les session logs, ou en temps réel dans le Remote Control Program.

Arrêtez le service PYTHEAS MailGate service, faites les modification dans le fichier de configuration, and redémarrez-le. Dans le Programme de Configuration, en bas de la page Content-checking-page, vous pouvez observer l'activation de cette fonction.

Comment spécifier le type de pièces jointes à laisser passer avec les Règles d'Analyse du Contenu

Ajoutez deux règles:

• une règle de type Pass-Through qui définit les masques pour les pièces jointes à laisser passer (il est important de définir l'ensemble de ces masques dans une seule règle):
  - appelons-la par exemple : Laisser passer ces extensions;
  - sur sa page Attachments, configurer la liste des masques à laisser passer (par ex.: *.doc; *.zip; *.gif).
• une règle de type Intercept qui déclenche pour toute pièce jointe:
  - appelons-la par exemple : Tout intercepter;
  - sur sa page Attachments, saisir: * (un astérisque);
  - cette règle doit se trouver plus bas dans la liste que la règle ci-dessus.

Nous recommandons de vérifier votre nouveau jeu de règles avec la fonction Essais avec les Règles d'Analyse du Contenu (Try Content-Checking Rules).

Utiliser une ligne en-tête cachée pour déterminer le destinataire d'un message

La problématique

Normalement, PYTHEAS MailGate utilise les lignes d'en-tête To: et Cc: pour déterminer le destinataire d'un message entrant. Toutefois, cela n'est pas possible pour des messages qui ont été adressés en mode "destinataire invisible" (cci ou bcc), comme par exemple des messages envoyés à une liste de diffusion. Ceci ne pose pas de problème dans une configuration où chaque utilisateur possède sa propre boîte aux lettres POP3. Par contre, dans une configuration avec une boîte aux lettres POP3 du type "catch-all" (i.e. une boîte aux lettres qui reçoit le courriel pour tout un domaine de messagerie), le routage de tels messages est problématique.

Afin d'assurer le routage des messages dans un tel scénario, nous pouvons essayer d'utiliser une ligne d'en-tête cachée qui a pu être écrite par le serveur POP3 du FAI, et qui a conservé l'information du dialogue RCPT-TO (= le destinataire sur "l'enveloppe SMTP" du message) au moment de la réception. Pour déterminer si un telle ligne existe, examinez les en-têtes SMTP d'un message reçu (dans Microsoft Outlook, vous pouvez utiliser le dialogue Options ou Propriétés d'un message ouvert). Des candidates pour une telle ligne: Delivered-To, X-Envelope-To, Envelope-To. Malheureusement, une l'existence et le nom d'une telle ligne ne sont pas standardisés.

Comment utiliser une telle ligne

• Sur le page de propriétés du Compte POP3, configurer le nom de la ligne d'en-tête. Si le nom n'est pas proposé dans la liste, vous pouvez le saisir.
• Sur la page de propriétés d'un des Destinataires étant en relation avec ce compte POP3, consultez le libellé pour les Mots-clé et les Autres adresses SMTP  dans le cadre Critères de routage. Il révélera laquelle de ces informations sera utilisé pour identifier le destinataire à l'aide de "notre" ligne d'en-tête.
• Si l'information Keywords est utilisée pour l'identification, la valeur de "notre" ligne d'en-tête doit d'abord passer la "validation des adresses SMTP" (une propriété du compte POP3 qui devrait être dans ce scénario sous la forme "@societe.fr").
• Si l'information Autres adresses SMTP est utilisée pour l'identification, l'algorithme de routage compare l'adresse SMTP du Recipient et les Autres adresses SMTP à la valeur trouvée dans "notre" ligne d'en-tête.
• Pour configurer laquelle de ces stratégies est utilisée, éditer le fichier de configuration PMailGat.INI et rechercher la section [Envelope information Header Masks].
  NB: cette section apparait après avoir sauvegardé votre configuration. Les exemples suivants vous aident à ajuster votre configuration:

Si vous devez modifier cette configuration, quittez le Programme de Configuration, éditez PMailGat.INI, puis redémarrez le service Pytheas.MailGate.

L'objet du message est préfixé par[Man.Distr]

L'objectif de ce préfixe est d'aider à distinguer entre les messages destinés à la boîte aux lettres, de ceux qui y atterrissent car ils n'ont pas pu être routés autrement.

Pour y remédier:

• Si tout le courriel de la boîte aux lettres POP3 est transféré vers un Destinataire : vérifiez que la case  "Transférer tous les messages..." dans les propriétés du Destinataire  soit cochée (plus d'informations à ce sujet...).
• Si le courriel de la boîte aux lettres POP3 est distribué à plusieurs Destinataires : s'il ne s'agit pas d'une erreur de frappe manifeste, nous vous recommandons soit d'ajouter un Destinataire avec les Critères de routage requis, soit de compléter un qui existe déjà (plus d'informations à ce sujet...).

Supprimer un message dans une boîte aux lettres POP3, en utilisant Telnet

NB: A partir de la version 2.15a, vous pouvez utiliser l'utilitaire intégré dans le Panneau / Programme de Configuration pour effectuer cette opération (accessible par le bouton Afficher / supprimer messages dans la boîte aux lettres sur la page de propriétés d'un compte POP3).

1. Se connecter au serveur POP3

Si le client Telnet n'est pas encore installé sur le serveur (et tel est souvent le cas depuis Microsoft Windows Server 2008): rendez-vous dans le Panneau de Configuration, Programmes et fonctionnalités, Activer ou désactiver des fonctionnalités Windows, Fonctionnalités.

Exécuter TELNET.EXE (ligne de commande). Puis taper:

• OPEN POP3server 110

Lorsque vous êtes connecté, Telnet affiche le message de bienvenue du serveur POP3.

2. Obtenir la liste des messages dans la boîte aux lettres POP3

Taper:
USER POP3user
PASS POP3password
LIST

NB: attention aux majuscules/minuscules lors de la saisie du mot de passe. Vous n'avez pas droit à l'erreur, le retour en arrière (backspace) n'est pas pris en charge :-(

3. Identification du message à supprimer

La commande LIST a produit la liste des messages et de leur taille dans la boîte aux lettres POP3. Pour identifier un message en particulier, vous pouvez taper:
TOP n 0
où n représente le numéro d'un des messages listés; le symbole à la fin de la ligne est un zéro.

4. Supprimer le(s) message(s)

Pour supprimer un message, taper:
DELE n
où n représente le numéro du message.

5. Supprimer le(s) message(s) et se déconnecter

A la fin des opérations, il faut se déconnecter "proprement" du serveur POP3; pour cela, taper:
QUIT

Enregistrer la trace d'une connexion avec un serveur POP3

• Si PYTHEAS MailGate est configuré de ne pas supprimer le courriel dans la boîte aux lettres POP3 lors de son téléchargement, et vous souhaitez analyser le procédé par rapport à un message particulier qui se trouve dans la boîte aux lettres, mais qui a déjà été téléchargé, faites l'opération suivante : cliquer sur le bouton Clear message Ids (sur les pages de propriétés du compte POP3), afin que PYTHEAS MailGate "oublie" quel message a déjà été téléchargé. Dans la foulée, vous pouvez aussi utiliser l'outil View/delete messages (aussi sur les pages de propriétés, sur l'onglet Delete/Cleanup) pour éventuellement nettoyer la boîte aux lettres.
• Dans le fichier PMailGat.INI, dans la section [Options], positionner le paramètre suivant:
  POP3 Trace=1
  (modifier la ligne si elle existe déjà; sinon, l'ajouter. Il vaut mieux éviter le copier/coller ici car on obtient parfois un caractère espace autre que le caractère standard.)
• Arrêtez le service Pytheas.Mailgate.
• Avant v. 3.20: démarrez le PYTHEAS MailGate Communication Task (PMailGat.exe) à partir de l'Explorateur de fichiers Windows (en v. 2.x cela est également possible depuis le menu Démarrer). L'activation de l'écriture de la trace de communication sera confirmée.
• Après v. 3.20: démarrez le service Pytheas.Mailgate à nouveau. Dans la fenêtre de la Télécommande de PYTHEAS MailGate, sur la page Session, vous allez trouver au début de chaque session de téléchargement POP3 une confirmation que l'écriture de la trace de communication est activée.
• Déclenchez une session de téléchargement (bouton dans la barre d'outils). Attendez que la session se termine.
• Arrêtez le PYTHEAS MailGate Communication Task / service.
• Dans le fichier PMailGat.INI, désactivez le paramètre:
  POP3 Trace=0
• Redémarrez le service Pytheas.Mailgate.
• Le fichier PmgPOP3Trace.txt avec la trace du dialogue a été enregistré dans le même dossier que PMailGat.INI. Vous pouvez remplacer des mots de passe par XXXX (recherchez >>PASS). Si votre fichier est trop volumineux (plus que 20 Mo), même après compression, vous pouvez le transférer à l'aide de cette page: http://support.pytheas.com/srq/pupload.aspx (dans le formulaire, veuillez faire commencer le nom de votre société par les lettres PMG).

Enregistrer la trace SMTP d'une connexion avec le serveur de messagerie interne (Microsoft Exchange ou Lotus Domino)

• Ceci fonctione à partir de la version 2.40 de PYTHEAS MailGate.
• Si PYTHEAS MailGate est configuré de ne pas supprimer le courriel dans la boîte aux lettres POP3 lors de son téléchargement, et vous souhaitez analyser le procédé par rapport à un message particulier qui se trouve dans la boîte aux lettres, mais qui a déjà été téléchargé, faites l'opération suivante : cliquer sur le bouton Clear message Ids (sur les pages de propriétés du compte POP3), afin que PYTHEAS MailGate "oublie" quel message a déjà été téléchargé. Dans la foulée, vous pouvez aussi utiliser l'outil View/delete messages (aussi sur les pages de propriétés, sur l'onglet Delete/Cleanup) pour éventuellement nettoyer la boîte aux lettres.
• Dans le fichier PMailGat.INI, dans la section [Options], positionner le paramètre suivant:
  Inbound SMTP Trace=1
  (modifier la ligne si elle existe déjà; sinon, l'ajouter. Il vaut mieux éviter le copier/coller ici car on obtient parfois un caractère espace autre que le caractère standard.)
• Arrêtez le service Pytheas.Mailgate.
• Avant v. 3.20 : démarrez le PYTHEAS MailGate Communication Task  (PMailGat.exe) à partir de l'Explorateur de fichiers Windows (en v. 2.x cela est également possible depuis le menu Démarrer). L'activation de l'écriture de la trace de communication sera confirmée.
• Après v. 3.20: démarrez le service Pytheas.Mailgate à nouveau. Dans la fenêtre de la Télécommande de PYTHEAS MailGate, sur la page Session, vous allez trouver au début de chaque session de téléchargement POP3 une confirmation que l'écriture de la trace de communication est activée.
• Déclenchez une session de téléchargement (bouton dans la barre d'outils). Attendez que la session se termine.
• Arrêtez le PYTHEAS MailGate Communication Task / service.
• Dans le fichier PMailGat.INI, désactivez le paramètre:
  Inbound SMTP Trace=0
• Redémarrez le service Pytheas.Mailgate.
• Le fichier PmgInboundSMTPTrace.txt avec la trace du dialogue a été enregistré dans le même dossier que PMailGat.INI.

Dépannage : le courriel sortant n'arrive pas dans la file d'attente de PYTHEAS MailGate

Avec la Télécommande de PYTHEAS MailGate (Remote Control), observez la page Outbound transfer. Si ce programme ne parvient pas à établir la liaison avec le service Pytheas.Mailgate, vérifiez que ce service se trouve bien dans l'état Démarré.

Envoyez un courriel à partir d'un poste client vers un correspondant situé hors de votre organisation. Quelques lignes similaires à celles ci-dessous rendent normalement compte de l'accueil du courriel dans la file d'attente :

[00:50] Queue [1] ESMTP Connection accepted from: your-mail-server
[00:50] Queue [1] Mail From: <webmaster@pytheas.com> SIZE=3798 (Pmg1F7B.tmp, Priority:  High)
[00:50] Queue [1] Rcpt To: <somebody@somedomain.com>
[00:50] Queue [1] Subject: A sample message
[00:50] Queue [1] Connection closed.

Si vous obtenez un résultat similaire, votre installation ne souffre pas du problème évoqué dans le titre de cet article. En revanche, si un tel courriel a des problèmes de quitter la file d'attente pour poursuivre son chemin, nous vous recommandons notre article à propos des erreurs Relaying denied.

Si vous n'obtenez pas ce résultat, vérifiez la file d'attente de votre serveur de messagerie (celui auquel le poste client est connecté). Normalement, vous devez y trouver le courriel que vous venez d'envoyer.

• Si cela est le cas, commencez le Test A1.
• Dans le cas contraire, vérifiez si votre correspondant a reçu le message.
  • Si cela est le cas, mais vous souhaitez que les courriels sortants passent par PYTHEAS MailGate, continuez avec le Test C.
  • Si le courriel n'a pas été reçu, vérifiez que votre serveur de messagerie a été configuré correctement pour prendre en charge le courriel Internet sortant.

Test A1: Vérifier avec le Programme de Configuration de PYTHEAS MailGate si le service Pytheas.MailGate est prêt à prendre en charge le courriel sortant

Sur la machine sur laquelle le service Pytheas.Mailgate ou le Communication Task est en cours d'exécution, lancez le Programme de Configuration de PYTHEAS MailGate, rendez vous sur la page Outgoing mail, et appuyez sur la bouton Try to listen for outgoing message now... Normalement, vous devez obtenir la réponse suivante :

*** The port could not be opened for listening.
*** Now trying SMTP connection to port 2500...
220 PYTHEAS MailGate ESMTP server ready
HELO Your_machine_name
250 PYTHEAS.MailGate
QUIT
*** The SMTP connection has been closed

Si vous obtenez cette réponse, passez directement au Test B. Dans le cas contraire, essayez le Test A3.

Test A3: Relever des messages d'erreur au démarrage du PYTHEAS MailGate Communication Task

Arrêtez le service Pytheas.Mailgate, et lancez le PYTHEAS MailGate Communication Task  (PMailGat.exe) à partir de l'Explorateur de fichiers Windows (en v. 2.x cela est également possible depuis le menu Démarrer). Attendez quelques secondes. Confirmez que vous obtenez une ligne comme celle-ci sur la page Session :

[00:10] Now queuing outbound messages in C:\ProgramData\Pytheas\PytheasMailgate\Outgoing; listening on TCP port 2500.

• Si vous obtenez ce message (ou similaire), et le test précédent ne s'est pas déroulé avec succès, procédez comme suit :
  • Laissez le Communication Task en cours d'exécution, ne redémarrez pas le service Pytheas.Mailgate, et réessayez le test à nouveau (Test A1).
  • Si vous obtenez un meilleur résultat, modifiez les paramètres de démarrage du service Pytheas.Mailgate afin de le faire démarrer avec un "vrai" compte utilisateur (auparavant, il démarrait dans le contexte Système local, si cela n'a pas été modifié par vos soins). Puis stoppez le Communication Task, démarrez le service Pytheas.Mailgate, et réessayez Test A1.
• Si vous obtenez un message d'erreur à la place, vérifiez qu'il n'y ait pas un autre service qui utiliserait le port que PYTHAS Mailgate essaye d'utiliser. Dans ce cas, arrêtez ou reconfigurez l'autre service, ou configurez PYTHEAS MailGate afin d'utiliser un autre port TCP; veuillez noter qu'il va falloir également préciser ce nouveau port TCP dans la configuration de votre serveur de messagerie (voir ci-dessous).

Test B: Paramètres de configuration de PYTHEAS MailGate

Dans le programme de configuration de PYTHEAS MailGate, sur la page Courriel sortant, dans le cadre Ecouter sur cette adresse IP / port, veuillez sélectionner: <any available>. Si une autre valeur s'y trouvait auparavant, sauvegardez cette nouvelle configuration. Puis, à l'aide du gestionnaire de la file d'attente des messages sortants de votre serveur de messagerie, provoquez une réexpédition des messages sortants en attente. Observez au même temps la page Outbound transfer dans le PYTHEAS Mailgate Remote Control.

Si le transfert fonctionne désormais, vous pouvez éventuellement restreindre l'adresse IP du port TCP en écoute à nouveau. Utilisez l'adresse IP du "hôte actif (smart host)" dans la configuration de votre serveur de messagerie (voir ci-dessous).

Test C: Vérifier la configuration de votre serveur de messagerie

Procédons à la vérification de l'adresse IP et du port TCP vers où votre serveur de messagerie est configuré d'envoyer le courriel sortant :

Si vous utilisez le serveur Microsoft Exchange 2016, Microsoft Exchange 2013, Microsoft Exchange 2010 ou Microsoft Exchange 2007 :

Lisez ceci à propos de la configuration de configuration de Microsoft Exchange 2013 / 2016 ou Microsoft Exchange 2010 ou Microsoft Exchange 2007.

Si vous utilisez le serveur Microsoft Exchange 2000 ou Microsoft Exchange 2003 :

Dans le Gestionnaire système de Microsoft Exchange, cherchez un Connecteur SMTP dans le Groupe de Routage auquel appartient votre serveur, avec un espace d'adressage de SMTP:*, censé de prendre en charge le courriel Internet sortant.

• Si vous en trouvez, vérifiez sur sa page de propriétés General qu'il soit configuré pour envoyer le courriel sortant vers l'adresse IP de la machine, sur laquelle le service Pytheas.Mailgate est en cours d'exécution ; ceci correspond à l'option : Transférer tous les courriers via ce connecteur aux hôtes actifs suivants.
• Si vous n'en avez pas, cette destination est configurée sur la page de propriétés Remise du Serveur virtuel SMTP par défaut, que vous trouverez sous le nœud Serveurs/(Votre_Serveur)/Protocoles/SMTP. Rendez-vous sur la page Cliquez sur le bouton Avancé pour trouver le champ Hôte actif.

NB : une adresse IP doit être entourée de [crochets].

Le port SMTP sortant est configuré sur la page Remise des propriétés du serveur virtuel SMTP, bouton Connexions sortantes. La valeur Port TCP doit correspondre à la valeur configurée dans le Programme de Configuration de PYTHEAS MailGate, sur la page Outgoing mail, paramètre Listen on IP address / port.

Si vous utilisez Lotus Domino :

Consultez notre guide de configuration pour serveurs Lotus Domino R5/R6, chapitre 4 à propos de la destination d'envoi du courriel sortant, et le chapitre 2 à propos du port SMTP sortant.

Si vous utilisez Microsoft Exchange 5.5 :

Vérifiez dans le programme d'administration du serveur, sur page page de propriétés Connexions, que l'option Transférer tous les messages vers l'hôte soit activée, et pointe vers l'adresse IP appartenant à la machine sur laquelle le service Pytheas.Mailgate a été installé.

Conclusion

A partir du moment où nous avons confirmé, que la file d'attente de PYTHEAS Mailgate est prête pour accepter le courriel sortant, et que votre serveur de messagerie envoie le courriel sortant vers la bonne adresse IP/port TCP, le courriel sortant devrait parvenir dans la file d'attente de PYTHEAS MailGate. Si des problèmes apparaissent par la suite, lors de l'envoi de ces messages vers le relais SMTP de votre FAI, veuillez lire l'article ci-dessous.

Quoi faire lorsque l'expédition d'un message se solde par l'erreur Relaying denied (réponse SMTP 550...)

• L'autorisation de l'utilisation du service "Relaying" d'un serveur SMTP est lié au contrat d'accès à l'Internet. Il est donc recommandé d'utiliser celui de votre FAI. Ainsi, il y a une chance qu'il reconnaîtra automatiquement que votre machine soit autorisée d'utiliser ce service.
• Vérifiez si une procédure d'identification particulière est nécessaire (par ex. la procédure AUTH-LOGON du protocole ESMTP); si oui, configurez PYTHEAS MailGate comme requis. Si vous avez un pare-feu, vérifiez qu'il laisse passer les extensions requises pour les connexions ESMTP sortantes. Vous pouvez utiliser la fonction Try connection sur la page Outgoing Mail pour vérifier le déroulement de cette authentification.
• Vérifiez que l'adresse de l'expéditeur des messages sortants correspond à l'adresse SMTP de sa boîte aux lettres POP3, et n'appartient surtout pas à un domaine de messagerie inconnu dans le DNS publique.
• Prenez contact avec l'exploitant du serveur SMTP en question, et vérifiez sous quelle condition vous pouvez bénéficier de son service "Relaying".

Comment faire pour que plusieurs utilisateurs puissent envoyer du courriel avec la même adresse d'expéditeur ?

En général, les adresses d'expéditeur d'un courriel sortant sont déterminées par votre serveur de messagerie, et celui-ci ne vous laisse pas attribuer la même adresse SMTP à deux utilisateurs différents. Par contre, PYTHEAS MailGate vous permet d'obtenir ce résultat, sous condition de faire passer le courriel sortant par PYTHEAS MailGate.

L'astuce consiste à attribuer aux utilisateurs concernés des adresses comme sales__fk@pytheas.com. Lors de l'expédition d'un courriel avec une telle adresse d'expéditeur, PYTHEAS MailGate enlèvera les deux underscores et a partie comprise entre celles-ci et le symbole @ (avec une longueur maximale de 10 caractères), laissant ainsi l'adresse d'expéditeur comme sales@pytheas.com.

Intéressant dans ce contexte est également la possibilité de réécriture du nom de l'expéditeur. Dans notre exemple ci-dessus, pour obtenir que l'expéditeur du courriel n'y apparaisse pas avec son nom, mais plutôt en tant que Service Commercial, vous pouvez activer la fonction Rewrite human readable names sur la page Outgoing mail du Programme de Configuration : dans la configuration de cette option, saisissez le ligne suivante :
sales@pytheas.com Service commercial
Bien entendu, cette réécriture n'affecte que le courriel qui est envoyé vers l'Internet.

Un message refusé par le serveur relais SMTP n'est pas renvoyé à l'expéditeur

Ce problème est visible de la manière suivante dans le session log:
Queue: *** Error: No notification to: <unexped@votredom.fr> (objet du message). Sender's address unknown.

Faites de la sorte que l'adresse SMTP correspondante unexped@votredom.fr figure à un des endroits suivants:

• en tant qu'adresse SMTP d'un Destinataire (Recipient'),
• dans la propriété Autres adresses SMTP d'un des Destinataires.

Depuis la v. 2.70, vous pouvez être alerté par un Session Log, si un message avec un expéditeur "inconnu" est accepté dans la file d'attente des messages sortants (cocher la case correspondante dans le paramétrage du Courriel sortant.

Comment se débarrasser des messages de confirmation "Non lu"

Le traitement du courriel sortant  (à partir de la v. 2.75c) peut automatiquement enlever des messages dont l'objet du message commence par un certain préfixe. Nous pouvons utiliser cette fonctionnalité afin de supprimer ces confirmations, qui peuvent parfois s'avérer troublantes pour les expéditeurs.

Pour ce faire, éditer PMailGat.INI et configurez le paramètre
Silent drop Message_Subject prefix
dans la section [Outgoing mail] (il devrait déjà s'y trouver, sans valeur). Les confirmations dont nous parlons commencent typiquement par le préfixe "not read: ". En conséquence, nous allons donner à ce paramètre la valeur suivante : Not read:  . Ensuite redémarrer le service PYTHEAS MailGate.
NB: Un caractère "espace" au début ou à la fin d'une expression doit être encodé sous forme de  . Une virgule doit être encodée sous forme de ,. Des valeurs multiples sont à séparer par la virgule (,). La détection du préfixe ne tient pas compte de la casse, et doit compter au moins 4 caractères..

Quand un message est enlevé de la file d'attente pour cette raison, ce fait est signalé dans le Session Log.

Des messages avec un Return-Path vide (MAIL FROM: <>) ne sont pas pris en charge par le relais SMTP

En fonction de la configuration du relais SMTP utilisé pour envoyer le courriel sortant, il est possible qu'il ne prenne pas en charge les messages avec un Return-Path vide (par ex. les messages d'"absence de bureau"). On reconnait de tels messages dans le Session Log par la ligne MAIL FROM: <> . Dans une telle situation, PYTHEAS MailGate peut substituer la valeur de la ligne d'en-tête FROM du message (l'adresse de l'expéditeur) au Return Path (à partir de la v. 2.75c).

Afin de configurer cette option, éditer PMailGat.INI, la section [Outgoing mail], et positionner le paramètre Avoid emtpy MAIL FROM (qui devrait déjà y être, avec une valeur 0 (zéro)) à la valeur 1. Ensuite redémarrer le service PYTHEAS MailGate.

NB: ce paramètre n'est pas utile quand le courriel sortant est configuré à être envoyé directement, sans passer par un relais SMTP.

Enregistrer la trace d'une connexion SMTP sortante

Ceci peut être utile pour comprendre des problèmes de communication entre PYTHEAS MailGate et le serveur relais SMTP de votre FAI.

• Arrêtez le service Pytheas.Mailgate.
• Dans le fichier de configuration PMailGat.INI, section [Options], ajouter le paramètre
  Outbound SMTP Trace=2
  (ou le modifier, s'il existe déjà. Il vaut mieux éviter le copier/coller ici car on obtient parfois un caractère espace autre que le caractère standard.)
• Avant v. 3.20: Exécuter le PYTHEAS MailGate Communication Task (PMailGat.exe) à partir de l'Explorateur de fichiers Windows (en v. 2.x cela est également possible depuis le menu Démarrer). Dans sa fenêtre, vous pouvez découvrir la ligne
  [10:00] Outbound SMTP Client trace activated.
• Après v. 3.20: démarrez le service Pytheas.Mailgate à nouveau. Dans la fenêtre de la Télécommande de PYTHEAS MailGate, sur la page Session, vous allez trouver au début de chaque session de téléchargement POP3 l'aversissement : SMTP trace for sending outgoing mail activated.
• Faites de la sorte que le problème à examiner apparaisse. Le dialogue SMTP sera enregistré dans le fichier PmgOutboundSMTPTrace2.txt (dans le même dossier que PMailGat.INI).
• Arrêtez le PYTHEAS MailGate Communication Task / service. Remettez la valeur du paramètre mentionné ci-dessus à 0 (zéro).
• Redémarrez le service Pytheas.Mailgate.

NB: Plus d'informations dans l'aide en ligne, dans le chapitre Diagnostic of Communication Problems. Dans un log de session, dans la partie Outbound transfer, une connexion sortante apparaît sous la forme suivante:

[10:10] Send: Connecting to smtprelay.isp.com...Login successful...done. (ESMTP, Max size: 21000000, DSN)
[10:10] Send: Mail From: <pmgsupport@pytheas.com> (Pmg5C47.tmp, 7,4 kb, queued: 01/01/2015 10:09:54)
[10:10] Send: Rcpt To: <webmaster@pytheas.com>
[10:10] Send: Subject: This is an outgoing message
[10:10] Send: Message sent (7,4 kb).
[10:10] Send: Outbound connection closed.