IMAP / SMTP

N’importe quelle boîte : serveur, port et mot de passe d’application.

Une connexion IMAP / SMTP branche n'importe quelle boîte qui propose l'IMAP standard pour la réception et le SMTP pour l'envoi : une boîte chez un hébergeur, un serveur de messagerie d'entreprise, ou tout fournisseur sans connexion dédiée. Mankomail reflète la boîte par IMAP et envoie par SMTP : elle sert donc de déclencheur et de boîte d'expédition comme n'importe quelle autre.

Contrairement à Google et Microsoft, il n'y a pas de page d'autorisation à traverser : le membre remplit un formulaire avec les adresses des serveurs et un mot de passe. Chaque connexion IMAP appartient au membre qui la crée et sert une seule boîte.

En bref

• Identifiant : imap
• Famille : Compte
• Configurée par : Chaque membre, pour lui-même
• Authentification : Adresse du serveur, identifiant et mot de passe
• Type de credential : imap

Avant de commencer

Rassemblez auprès de votre fournisseur de messagerie ou de votre administrateur :

• l'adresse de la boîte qui reçoit le courrier ;
• le nom d'hôte et le port du serveur de réception (IMAP), et s'il chiffre dès l'ouverture (TLS, en général port 993) ou bascule en STARTTLS (en général port 143) ;
• le nom d'hôte et le port du serveur d'envoi (SMTP), et s'il chiffre dès l'ouverture (TLS, en général port 465) ou bascule en STARTTLS (en général port 587) ;
• l'identifiant de connexion, s'il diffère de l'adresse ;
• le mot de passe. Si votre fournisseur propose des mots de passe d'application, créez-en un pour Mankomail : il se révoque seul, sans changer votre mot de passe principal. Il doit autoriser à la fois la lecture et l'envoi.

Vérifiez aussi que :

• l'instance dispose d'une clé de chiffrement (ENCRYPTION_KEY), sans quoi le mot de passe ne peut pas être stocké — voir les variables d'environnement ;
• le compte accepte une connexion par mot de passe en IMAP et en SMTP. Mankomail ne se connecte pas aux serveurs IMAP par OAuth : un serveur qui n'accepte que la connexion OAuth ne peut pas être branché de cette façon.

Boîtes Google et Microsoft

Pour une boîte Gmail ou Microsoft 365, préférez la connexion Google ou Microsoft : elle passe par l'API du fournisseur et donne un miroir plus riche que l'IMAP.

Ajouter la connexion

1. Ouvrez Connexions, cliquez sur Ajouter une connexion, puis sur Connecter sur la carte IMAP / SMTP. Le même formulaire s'ouvre depuis Boîtes › Connecter une boîte IMAP.
2. Remplissez le formulaire Connecter une boîte IMAP :

Champ	Obligatoire	Que saisir
Adresse de la boîte	oui	L'adresse qui reçoit le courrier. C'est l'identité de la boîte dans Mankomail, pas forcément l'identifiant de connexion.
Réception (IMAP) › Serveur	oui	Le nom d'hôte IMAP, par exemple imap.exemple.fr.
Réception (IMAP) › Port	oui	Pré-rempli avec 993.
Réception (IMAP) › Connexion chiffrée dès l'ouverture (TLS)	—	Cochée par défaut. Décochée, la connexion s'ouvre en clair puis bascule en STARTTLS — jamais en clair jusqu'au bout.
Envoi (SMTP) › Serveur	oui	Le nom d'hôte SMTP, par exemple smtp.exemple.fr.
Envoi (SMTP) › Port	oui	Pré-rempli avec 465.
Envoi (SMTP) › Connexion chiffrée dès l'ouverture (TLS)	—	Cochée par défaut ; même règle que ci-dessus.
Identifiant de connexion (facultatif)	non	Seulement si votre hébergeur vous a donné un identifiant différent de l'adresse. Laissé vide, c'est l'adresse qui sert.
Mot de passe	oui	Jamais réaffiché. Préférez un mot de passe d'application quand votre fournisseur en propose.
Avancé › Accepter un certificat que le système ne valide pas	non	Uniquement pour un serveur interne à certificat auto-signé (voir l'avertissement ci-dessous).

3. Cliquez sur Connecter la boîte. Le bouton affiche Test de la connexion… pendant que Mankomail ouvre une vraie session IMAP (il sélectionne la boîte de réception en lecture seule), puis une vraie session SMTP. Rien n'est enregistré tant que les deux n'ont pas réussi. Si l'une échoue, le formulaire dit quel serveur a refusé et signale le champ à corriger.
4. En cas de succès, le message Boîte … connectée. s'affiche, la boîte commence à se synchroniser dans Boîtes, et la connexion apparaît dans Connexions sous Comptes mail et cloud, avec un bouton Gérer les boîtes.

Certificats auto-signés

Cocher Accepter un certificat que le système ne valide pas retire la seule protection contre un serveur qui se ferait passer pour le vôtre : vos identifiants partiraient chez lui sans que rien ne le signale. Réservez-le à un serveur interne dont vous savez le certificat auto-signé — jamais pour passer outre une erreur de certificat chez un fournisseur public.

Changer le mot de passe ou reconnecter

Pour changer le mot de passe ou les réglages des serveurs, connectez de nouveau la même adresse avec le formulaire. Mankomail teste les nouveaux réglages, puis remplace les identifiants enregistrés de la boîte existante : aucune seconde boîte n'est créée. Une boîte déconnectée est réactivée de la même façon, avec son historique.

Depuis Boîtes, Reconnecter cette boîte rouvre le formulaire avec l'adresse déjà remplie.

Le mot de passe n'est jamais affiché, ni renvoyé par l'API, ni écrit dans les journaux : si vous l'avez perdu, définissez-en un nouveau chez votre fournisseur et reconnectez.

Déconnecter

Une connexion IMAP se retire depuis Boîtes : déconnecter la boîte arrête la synchronisation, laisse son historique lisible et efface le mot de passe enregistré. Les workflows qui se déclenchent sur cette boîte ou envoient depuis elle cessent de le faire jusqu'à la reconnexion. Voir boîtes et miroir.

Erreurs fréquentes

Le test de connexion renvoie l'un de huit codes. Le préfixe dit quel serveur a refusé : imap. pour la réception, smtp. pour l'envoi. Une erreur smtp. signifie que la réception fonctionne déjà — seuls les réglages d'envoi sont à corriger.

Code	Message affiché (résumé)	Cause	Que faire
imap.host_not_found	Serveur de réception introuvable.	Le nom d'hôte n'existe pas, ou le DNS n'a pas répondu.	Corrigez le Serveur de réception.
imap.unreachable	Le serveur de réception n'a pas répondu sur ce port.	Mauvais port, port fermé, connexion coupée — ou tout échec qui n'a pas pu être classé.	Corrigez le Port de réception : 993 avec TLS, 143 sans.
imap.tls_failed	La connexion chiffrée au serveur de réception a échoué.	Réglage TLS qui ne correspond pas au port, ou certificat refusé par le système.	Vérifiez le port et la case TLS ; pour un serveur interne auto-signé, voyez Avancé.
imap.auth_failed	Le serveur de réception a refusé vos identifiants.	Identifiant ou mot de passe erroné, ou connexion par mot de passe refusée par le compte.	Vérifiez l'Identifiant de connexion et le Mot de passe.
smtp.host_not_found	Serveur d'envoi introuvable.	Le nom d'hôte SMTP n'existe pas, ou le DNS n'a pas répondu.	Corrigez le Serveur d'envoi.
smtp.unreachable	Le serveur d'envoi n'a pas répondu sur ce port.	Mauvais port, ou port bloqué — beaucoup d'hébergeurs bloquent par défaut les ports d'envoi.	Corrigez le Port d'envoi : 465 avec TLS, 587 sans.
smtp.tls_failed	La connexion chiffrée au serveur d'envoi a échoué.	Réglage TLS qui ne correspond pas au port, ou certificat refusé.	Vérifiez le port et la case TLS, ou Avancé pour un serveur auto-signé.
smtp.auth_failed	Le serveur d'envoi a refusé vos identifiants alors que la réception les a acceptés.	Typiquement un mot de passe d'application limité à la lecture.	Créez un mot de passe qui autorise aussi l'envoi.
credentials.encryption_disabled	L'instance ne peut pas stocker de secret : la clé de chiffrement n'est pas configurée.	ENCRYPTION_KEY manque sur l'instance.	Demandez à l'administrateur de l'instance de la configurer.
bad_request	—	Un champ manque ou est mal formé (adresse invalide, port hors de 1–65535…).	Corrigez le formulaire.

Nœuds qui utilisent cette connexion

Aucun nœud du catalogue n’exige directement cette connexion.