Dépannage des notifications par e-mail WP Cerber
English version: Troubleshooting WP Cerber Email Notifications
Si une notification WP Cerber n'arrive pas, les diagnostics par e-mail peuvent vous aider à déterminer ce qui s'est passé lorsque l'extension a tenté de l'envoyer. Ceci est particulièrement utile lorsque les e-mails de test arrivent, mais pas les alertes de sécurité ou les rapports programmés.
Les diagnostics d'email enregistrent les tentatives d'envoi d'emails de WP Cerber. Ils ne suivent pas les messages provenant d'autres extensions WordPress et ne confirment pas la réception d'un message dans la boîte de réception du destinataire. L'activation des diagnostics ne modifie pas vos paramètres de distribution d'emails ni ne supprime les limites de notification.
Avant de commencer
Vérifiez la notification concernée
Vérifiez que la notification est activée et que ses destinataires sont corrects. Pour une alerte d'activité, vérifiez ses conditions, le canal de messagerie, la date d'expiration et la limite de notifications. Pour les notifications de verrouillage, vérifiez le seuil de verrouillage configuré et la limite d'alertes par heure. Un événement de sécurité enregistré ne nécessite pas toujours l'envoi d'un e-mail.
Vérifiez si un plugin modifie votre dossier d'uploads
Vérifiez d'abord si un plugin, un thème ou une personnalisation contrôle votre dossier d'uploads locaux. Un paramètre vous permettant de choisir ce dossier est une raison de vérifier la compatibilité. Certaines configurations peuvent entraîner la perte du journal de diagnostic et de la mise en quarantaine de WP Cerber, laissant des fichiers sur le disque mais inaccessibles via le tableau de bord. Si vous utilisez ce type de configuration ou en cas de doute, désactivez les diagnostics par e-mail.
Le fait de définir un emplacement fixe via
UPLOADSdanswp-config.phpou l'optionupload_pathde WordPress ne provoque pas ce problème à lui seul. Un autre plugin peut néanmoins le remplacer.
1. Activer les diagnostics de messagerie
Après avoir effectué la vérification du dossier uploads ci-dessus, enregistrez une copie du fichier wp-config.php de votre site. Ajoutez la ligne suivante dans sa section PHP existante, au-dessus de la ligne qui charge wp-settings.php :
define ( 'CERBER_MAIL_DEBUG' , true );
Si le fichier définit déjà CERBER_MAIL_DEBUG , changez sa valeur à true au lieu d'ajouter une autre définition.
2. Envoyer une notification de test
Ouvrez les paramètres de notifications de WP Cerber et cliquez sur « Envoyer un test » à côté de « Notification de verrouillage » . Notez l'heure et vérifiez si l'e-mail de test est arrivé. S'il n'est pas arrivé, vérifiez la boîte de réception, y compris le dossier « Courriers indésirables », et notez toute erreur affichée par WP Cerber.
Ensuite, collectez les enregistrements relatifs à la notification manquante. Un test réussi du tableau de bord ne confirme pas qu'une alerte d'activité a rempli ses conditions, qu'un rapport planifié s'est exécuté ou qu'une notification créée précédemment dans une requête a suivi le même chemin d'envoi.
En cas d'alerte intermittente, ne laissez les diagnostics activés que le temps nécessaire pour observer le prochain événement pertinent. Notez l'heure et votre fuseau horaire afin de pouvoir retrouver les entrées correspondantes. Évitez de modifier les paramètres de messagerie entre le test et la notification concernée, car cela complique la comparaison des résultats.
Il n'est pas nécessaire d'attaquer votre site ni de vous en bloquer l'accès volontairement pour générer un enregistrement. S'il n'existe aucun moyen sûr de reproduire l'événement, attendez qu'il se produise naturellement.
3. Examinez le journal de diagnostic
Accédez à WP Cerber → Outils → Journal de diagnostic et recherchez les entrées marquées [MAIL] aux alentours des heures d'enregistrement du test et de la notification concernée. Utilisez « Télécharger le journal » si vous avez besoin d'un fichier, ou copiez les entrées pertinentes au format texte. Le format texte conserve l'intégralité des enregistrements et est plus facile à consulter qu'une capture d'écran d'une longue ligne.
Chaque entrée commence par explain , un résumé en une phrase de la tentative d'envoi, rédigé en langage clair. Les champs techniques qui suivent sont utilisés par le support pour mener l'enquête.
Les exemples ci-dessous sont donnés à titre d'illustration. Ils montrent la partie [MAIL] de chaque entrée, sans le préfixe de date et d'heure ajouté par le journal de diagnostic.
Exemple : un test de tableau de bord
[MAIL] explain="WordPress reported success for recipient 1 of 1 with WP Cerber SMTP disabled." ts=2026-11-06T15:20:00Z rid=EXAMPLETEST01 type=lockout dispatch=direct cwd=inside_abspath pwd=none cwd_send=inside_abspath pwd_send=none recipient=1 recipients=1 attempt=initial smtp=disabled result=ok
Exemple : une notification de verrouillage envoyée à la fin d’une requête
[MAIL] explain="WordPress reported success for recipient 1 of 1 with WP Cerber SMTP disabled." ts=2026-11-06T15:25:00Z rid=EXAMPLEALERT02 type=lockout event=708 dispatch=shutdown cwd=abspath pwd=none cwd_send=root pwd_send=none recipient=1 recipients=1 attempt=initial smtp=disabled result=ok
Les deux appels d'exemple ont abouti. Leurs chemins d'envoi et catégories de répertoires de travail différents permettent de comparer le test avec la notification réelle, mais n'expliquent pas pourquoi un message n'est pas arrivé.
Utilisez le champ ts pour comparer les heures. Il est toujours en UTC, indiqué par le Z final. Le préfixe de date et d'heure distinct du journal de diagnostic peut utiliser un fuseau horaire différent.
4. Comprendre le résultat
result=ok ne confirme pas la livraison au destinataire. Cela signifie simplement que la fonction d'envoi d'e-mails de WordPress a renvoyé une réponse positive. WordPress explique cette distinction dans sa documentation relative à cette fonction . Il en va de même pour la mention « WordPress a signalé une réussite » dans le texte explain : un échec dans ce explain n'indique pas la cause de l'erreur.
| Ce que vous voyez | Ce que cela vous dit | Que faire ensuite ? |
|---|---|---|
result=error |
Cet appel a échoué. | Enregistrez l'enregistrement et toute erreur de courriel associée affichée par WP Cerber. |
result=ok , mais le message est manquant |
L'envoi a réussi. La réception dans la boîte de réception n'est pas encore confirmée. | Demandez à votre fournisseur d'accès Internet (votre hébergeur ou votre serveur SMTP) de vérifier ses journaux d'envoi aux alentours de ts (UTC). Communiquez-lui l'adresse du destinataire en privé et demandez-lui s'il a bien reçu le message et ce qui s'est passé ensuite. |
| Le test arrive, mais la notification concernée n'arrive pas. | Les deux scénarios aboutissent à des résultats différents. | Rassemblez les deux ensembles de données et identifiez la notification manquante. |
Aucune entrée [MAIL] correspondante |
Le journal ne contient aucun résultat enregistré pour la tentative attendue. | Vérifiez la version, la date d'activation, les conditions de notification et les limites. Assurez-vous que le test de votre tableau de bord génère bien un enregistrement. |
Plusieurs entrées avec le même rid |
Plusieurs appels enregistrés se rapportent à la même requête. | Conservez les entrées ensemble. Elles ne représentent pas nécessairement des livraisons en double. |
Des paramètres ou des limites de débit peuvent empêcher l'envoi d'un message. L'absence d'un enregistrement peut également être due à l'impossibilité d'écrire dans le journal ou à l'arrêt de l'exécution avant le retour de la fonction d'envoi d'e-mail. L'absence d'une entrée ne signifie pas nécessairement que l'hébergeur a bloqué le message. Veuillez contacter le support si un test connu ne produit aucun enregistrement.
5. Désactivez les diagnostics après avoir collecté les enregistrements.
Une fois les tentatives pertinentes enregistrées, modifiez la définition existante comme suit :
define ( 'CERBER_MAIL_DEBUG' , false );
Vous pouvez également supprimer la ligne que vous avez ajoutée. N'ajoutez pas de deuxième définition. Si l'assistance vous a aidé à définir un chemin de stockage fixe pour votre site, conservez ce paramètre.
Cette action empêche l'ajout de nouveaux e-mails de diagnostic. Les enregistrements existants restent dans le journal de diagnostic. Sauvegardez les données nécessaires avant d'utiliser « Effacer le journal » , qui supprime le journal partagé, y compris les entrées provenant d'autres fonctionnalités de WP Cerber.
6. Partagez les détails pertinents avec le service d'assistance.
Choisissez la chaîne correspondant à votre version :
- WP Cerber Professional : Ouvrez un ticket privé sur le portail d’assistance WP Cerber .
- Version gratuite : Créez un sujet sur le forum de la communauté WP Cerber .
Veuillez inclure les détails suivants :
- Votre version de WP Cerber et la notification manquante.
- À la date prévue, en tenant compte de votre fuseau horaire.
- Pour savoir si le test du tableau de bord est arrivé.
- Les entrées
[MAIL]pertinentes. - Que vous utilisiez les paramètres SMTP de WP Cerber ou un autre plugin de messagerie WordPress.
Si WP Cerber affiche une erreur d'envoi d'e-mail, veuillez l'indiquer dans votre ticket privé. Dans une discussion publique, signalez l'erreur et évitez de publier des informations permettant d'identifier des utilisateurs ou des comptes.
Pour une notification de sécurité, une entrée correspondante du journal d'activité peut également s'avérer utile. Partagez les entrées du journal d'activité de manière privée , car elles peuvent contenir des adresses IP et des noms d'utilisateur. Pour trouver l'entrée, copiez l'identifiant de requête ( rid ) de l'enregistrement de messagerie, ouvrez le journal d'activité, cliquez sur « Plus » , saisissez-le dans le champ « ID de requête » , puis cliquez sur « Filtrer » . Consultez la section « Qu'est-ce qu'un RID et comment l'utiliser ? » .
Les nouvelles lignes [MAIL] décrites dans ce guide omettent les adresses e-mail, les adresses IP, les sujets, le corps des messages, les identifiants et les chemins d'accès bruts au système de fichiers. Vous pouvez partager ces lignes individuellement dans un sujet de forum public. Copiez uniquement les lignes [MAIL] pertinentes, sans les entrées de journal environnantes ni les captures d'écran contenant d'autres données.
Les exportations complètes du journal de diagnostic peuvent contenir des entrées provenant d'autres fonctionnalités de WP Cerber et doivent être partagées de manière privée. Si vous utilisez la version gratuite et qu'un membre de votre équipe vous demande une entrée du journal d'activité ou une exportation complète, demandez-lui comment l'envoyer de manière privée avant de la partager. Ne divulguez ni les mots de passe ni l'intégralité de votre fichier wp-config.php . Ne partagez les adresses des destinataires que par un canal privé et uniquement lorsque cela est nécessaire.
Référence de terrain
Vous pouvez partager les enregistrements avec le support sans avoir à décoder chaque champ. Cette documentation fournit des informations complémentaires si vous souhaitez approfondir le sujet.
| Champ | Signification |
|---|---|
explain |
Résumé concis de la tentative d'envoi, établi à partir des champs recipient , recipients , attempt , smtp et result . Il décrit le résultat de l'envoi et la décision du serveur SMTP de WP Cerber, et non la réussite ou l'échec de la livraison du message. |
ts |
L'heure UTC a été capturée juste avant l'appel de la fonction d'envoi d'e-mail. |
rid |
L'identifiant de requête WP Cerber sert à relier les enregistrements d'une même requête. Il ne s'agit pas d'un identifiant de message électronique. |
type |
Type de notification. Les valeurs courantes incluent lockout , send_alert , report , scan , generic et 2fa . Les types non reconnus apparaissent sous la forme other . |
event |
Le motif du verrouillage ou le code d'activité d'origine, lorsqu'il est disponible. Il ne s'agit pas d'un code d'erreur de messagerie. |
dispatch |
Comment la notification a-t-elle été transmise par e-mail ? Voir le tableau ci-dessous. |
cwd / cwd_send |
Catégories du répertoire de travail de PHP au moment de la préparation de la notification et juste avant l'appel par e-mail. |
pwd / pwd_send |
Les catégories de la variable d'environnement PWD du serveur sont définies aux mêmes deux emplacements. Cette variable peut être non définie ou différer du répertoire de travail réel de PHP. |
recipient ( recipients |
La position du destinataire dans cette notification et le nombre de destinataires sont enregistrés. Les adresses électroniques ne sont pas enregistrées. |
attempt |
initial pour le premier appel vers un destinataire, ou retry lorsque WP Cerber répète un appel infructueux vers le même destinataire. WP Cerber effectue des nouvelles tentatives uniquement lorsque son paramètre SMTP est activé. |
smtp |
Décision SMTP de WP Cerber concernant l'appel. Voir le tableau ci-dessous. |
result |
ok ou error , selon la valeur de retour de cet appel par e-mail. |
Le champ event est omis lorsqu'aucun code applicable n'a été fourni. Les tests du tableau de bord peuvent l'omettre, mais l'absence event ne constitue pas en soi un message de test.
Chemins d'envoi
dispatch |
Signification |
|---|---|
direct |
WP Cerber a envoyé la notification sans la reporter à aucune des étapes ci-dessous. |
plugins_loaded |
La notification a été préparée en amont et envoyée lorsque WordPress a atteint l'étape plugins_loaded . |
shutdown |
La notification a été préparée en amont et envoyée par une fonction de rappel une fois la requête PHP terminée. Cela ne signifie pas que le serveur s'est arrêté ni que la requête a échoué. |
Ces valeurs décrivent le chemin d'envoi de WP Cerber. Elles n'identifient pas un serveur SMTP ni ne décrivent la file d'attente de livraison d'un fournisseur de messagerie. En particulier, direct ne précise pas si le protocole SMTP a été utilisé.
Décisions SMTP
smtp |
Signification |
|---|---|
enabled |
WP Cerber applique ses paramètres SMTP à l'appel. |
disabled |
WP Cerber n'applique pas ses paramètres SMTP car ils sont désactivés ou nécessitent WP Cerber Professional. |
bypassed |
Les paramètres SMTP sont activés, mais WP Cerber les ignore pour cet appel suite à un appel précédent ayant échoué dans la même requête. |
Ce champ reflète uniquement la configuration de WP Cerber. Un autre plugin peut modifier la façon dont WordPress envoie les messages ; enabled ne garantit donc pas l’utilisation du serveur SMTP configuré.
Catégories du répertoire
Le journal utilise des catégories au lieu d'enregistrer les chemins réels.
| Valeur | Signification |
|---|---|
root |
La racine du système de fichiers / . |
abspath |
Le répertoire d'installation de WordPress. |
inside_abspath |
Un répertoire à l'intérieur de l'installation WordPress. |
outside_abspath |
Un répertoire situé en dehors de l'installation WordPress. |
none |
La valeur était indisponible ou vide. |
Les valeurs pwd=none et dispatch=shutdown ne constituent pas des erreurs en soi. Une modification telle que cwd=abspath suivie de cwd_send=root fournit des informations utiles sur l'environnement d'envoi, mais ne prouve pas un échec de livraison. La correspondance des catégories ne garantit pas non plus la correspondance des chemins, et l'instantané avant l'appel ne reflète pas les modifications apportées à la fonction d'envoi d'e-mails ni à ses hooks.
Sur les serveurs soumis à la restriction open_basedir de PHP, un chemin PWD qui accède au répertoire WordPress via un lien symbolique peut être classé comme outside_abspath . Le support technique peut tenir compte de cette limitation lors de l'examen des entrées.
Pourquoi une seule notification peut générer plusieurs enregistrements
Chaque appel enregistré génère un résultat distinct. Plusieurs destinataires ou une redirection SMTP existante peuvent produire plusieurs enregistrements pour une notification. Une seule requête peut également générer différentes notifications.
Par exemple, une notification avec deux destinataires et un serveur SMTP inaccessible peut produire ces trois enregistrements, présentés ici avec les champs techniques omis :
[MAIL] explain="The email attempt for recipient 1 of 2 failed with WP Cerber SMTP enabled." ... recipient=1 recipients=2 attempt=initial smtp=enabled result=error
[MAIL] explain="WordPress reported success for the retry to recipient 1 of 2 without WP Cerber SMTP settings." ... recipient=1 recipients=2 attempt=retry smtp=bypassed result=ok
[MAIL] explain="WordPress reported success for recipient 2 of 2 without WP Cerber SMTP settings." ... recipient=2 recipients=2 attempt=initial smtp=bypassed result=ok
La tentative SMTP a échoué, et les deux appels suivants ont été effectués sans les paramètres SMTP de WP Cerber. Rien n'indique que le serveur SMTP ait été rétabli ni que les messages soient arrivés.
La numérotation des destinataires est réinitialisée à chaque notification, et les adresses électroniques sont volontairement omises ; ainsi, la position ne permet pas d’identifier l’adresse utilisée. Veuillez conserver toutes les entrées associées lors du signalement d’un problème, même si une error est suivie d’une ok .
Problème connu : modifications apportées au dossier de téléchargements local
Ce problème affecte les sites où un plugin, un thème ou une personnalisation fait que WP Cerber accède à des dossiers de base d'uploads locaux différents lors des premières requêtes et des requêtes normales du tableau de bord. Par exemple, un plugin peut modifier ce dossier uniquement après son chargement.
WP Cerber utilise l'emplacement des fichiers téléchargés pour localiser son dossier de stockage partagé. Si le dossier existant est introuvable à cet emplacement, WP Cerber peut en créer un nouveau et perdre la trace de l'ancien. Les anciens fichiers restent sur le disque, mais les fichiers mis en quarantaine peuvent disparaître de la page de quarantaine et devenir inaccessibles à la restauration. Les rapports de diagnostic peuvent également se retrouver dans différents dossiers.
Le fait de configurer un emplacement fixe via UPLOADS dans wp-config.php ou l'option upload_path ne provoque pas à lui seul cette incohérence au démarrage. Un plugin ou une personnalisation peut toujours la modifier ultérieurement. De même, le paramètre local-folder d'un plugin est une raison de vérifier son fonctionnement, et non une preuve que le site est affecté. Il s'agit d'exemples de configurations existantes, et non d'instructions pour modifier vos paramètres d'upload.
Si votre configuration risque d'être affectée, désactivez les diagnostics par e-mail et demandez de l'aide . Indiquez le nom du plugin, du thème ou de la personnalisation qui contrôle l'emplacement des fichiers téléchargés.
Conservez tous les dossiers wp-cerber-* existants et leur contenu. Ne les déplacez pas, ne les renommez pas, ne les supprimez pas, ne modifiez pas les paramètres de l'extension d'uploads et n'essayez pas un chemin de stockage aléatoire. La configuration correcte doit préserver le dossier déjà utilisé par WP Cerber.
Si les diagnostics sont déjà activés sur un site concerné, désactivez-les pendant la vérification de l'emplacement de stockage. Cette opération ne rétablit pas la connexion de WP Cerber à un dossier précédent. D'autres fonctions de WP Cerber peuvent toujours être à l'origine du problème de stockage.