WordPress Security How To

Problemen oplossen met WP Cerber e-mailmeldingen


English version: Troubleshooting WP Cerber Email Notifications


Als een WP Cerber-melding niet aankomt, kunnen e-maildiagnostiekgegevens helpen om te achterhalen wat er misging toen de plugin de melding probeerde te verzenden. Dit is vooral handig wanneer testmails wel aankomen, maar beveiligingswaarschuwingen of geplande rapporten niet.

E-maildiagnostiek registreert de e-mailverzendpogingen van WP Cerber. Het volgt geen berichten van andere WordPress-plugins en bevestigt ook niet of een bericht de inbox van de ontvanger heeft bereikt. Het inschakelen van diagnostiek wijzigt evenmin uw e-mailbezorgingsinstellingen of de notificatielimieten.

Voordat je begint

Controleer de betreffende melding.

Controleer of de melding is ingeschakeld en of de ontvangers correct zijn. Controleer voor een activiteitsmelding de voorwaarden, het e-mailkanaal, de vervaldatum en de meldingslimiet. Controleer voor vergrendelingsmeldingen de geconfigureerde vergrendelingsdrempel en de limiet voor meldingen per uur. Een geregistreerde beveiligingsgebeurtenis vereist niet altijd dat er een e-mail wordt verzonden.

Controleer of een plug-in je uploadmap wijzigt.

Controleer eerst of een plugin, thema of aanpassing uw lokale uploadmap beheert. Een instelling waarmee u die map kunt kiezen, is een reden om de compatibiliteit te controleren. Sommige configuraties kunnen ervoor zorgen dat WP Cerber het diagnostische logboek en de quarantaine niet meer bijhoudt, waardoor bestanden op de schijf blijven staan maar niet toegankelijk zijn via het dashboard. Als u dit soort configuratie gebruikt of twijfelt, schakel dan de e-maildiagnose uit.

Een vaste locatie die al is ingesteld via UPLOADS in wp-config.php of via upload_path optie van WordPress, veroorzaakt dit probleem op zich niet. Een andere plugin kan deze instelling echter nog steeds overschrijven.

1. Schakel e-maildiagnostiek in

Nadat je de bovenstaande controle van de uploadmap hebt voltooid, sla je een kopie van het wp-config.php -bestand van je site op. Voeg de volgende regel toe in het bestaande PHP-gedeelte, boven de regel die wp-settings.php laadt:

 define ( 'CERBER_MAIL_DEBUG' , true );

Als het bestand CERBER_MAIL_DEBUG al definieert, wijzig dan de waarde ervan naar true in plaats van een nieuwe definitie toe te voegen.

2. Verstuur een testmelding

Open de WP Cerber -meldingsinstellingen en gebruik 'Klik om test te verzenden' naast 'Vergrendelingsmelding' . Noteer het tijdstip en of de testmail is aangekomen. Als deze niet is aangekomen, controleer dan de betreffende mailbox, inclusief de spammap, en noteer eventuele foutmeldingen van WP Cerber.

Verzamel vervolgens gegevens voor de melding die daadwerkelijk ontbreekt. Een geslaagde dashboardtest bevestigt niet dat een activiteitswaarschuwing aan de voorwaarden voldeed, dat een gepland rapport werd uitgevoerd of dat een eerder in een verzoek aangemaakte melding hetzelfde verzendpad volgde.

Bij een intermitterende melding, laat de diagnostische functie alleen ingeschakeld zolang als nodig is om de volgende relevante gebeurtenis te observeren. Noteer de tijd en uw tijdzone, zodat u de bijbehorende vermeldingen kunt terugvinden. Vermijd het wijzigen van e-mailinstellingen tussen de test en de betreffende melding, aangezien dit de vergelijking van de resultaten bemoeilijkt.

Je hoeft je site niet aan te vallen of jezelf opzettelijk buiten te sluiten om een record te genereren. Als er geen veilige manier is om de gebeurtenis te reproduceren, wacht dan tot deze zich vanzelf voordoet.

3. Bekijk het diagnostisch logboek.

Ga naar WP Cerber → Tools → Diagnostisch logboek en zoek naar vermeldingen met de aanduiding [MAIL] rond de tijdstippen die u hebt vastgelegd voor de test en de betreffende melding. Gebruik 'Logboek downloaden' als u een bestand nodig hebt, of kopieer de relevante vermeldingen als tekst. Tekst behoudt de volledige gegevens en is gemakkelijker te bekijken dan een schermafbeelding van een lange regel.

Elke vermelding begint met explain , een korte samenvatting van de verzendpoging in begrijpelijke taal, in één zin. De technische velden die volgen, worden door de supportafdeling gebruikt voor het onderzoek.

De onderstaande voorbeelden dienen ter illustratie. Ze tonen het [MAIL] -gedeelte van elke vermelding, zonder het datum- en tijdvoorvoegsel dat door het diagnostisch logboek is toegevoegd.

Voorbeeld: een dashboardtest

 [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

Voorbeeld: een vergrendelingsmelding die wordt verzonden wanneer een verzoek is voltooid.

 [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

Beide voorbeeldoproepen werden succesvol geretourneerd. De verschillende verzendpaden en werkmapcategorieën kunnen helpen bij het vergelijken van de test met de daadwerkelijke melding, maar geven geen uitsluitsel over de reden waarom een bericht niet is aangekomen.

Gebruik het veld ts bij het vergelijken van tijden. Dit is altijd in UTC, aangegeven door de laatste Z . Het aparte datum- en tijdvoorvoegsel van het diagnostisch logboek kan een andere tijdzone gebruiken.

4. Begrijp het resultaat

result=ok bevestigt niet dat de e-mail bij de ontvanger is afgeleverd. Het betekent dat de WordPress-e-mailfunctie voor die specifieke oproep een succes heeft geretourneerd. WordPress legt dit onderscheid uit in de documentatie van de e-mailfunctie . Hetzelfde geldt voor "WordPress meldde succes" in de explain , en een mislukte poging in de explain geeft de oorzaak van de fout niet aan.

Wat je ziet Wat het je vertelt Wat moet ik nu doen?
result=error Die oproep leverde een foutmelding op. Bewaar het record en eventuele bijbehorende e-mailfoutmeldingen van WP Cerber.
result=ok , maar het bericht ontbreekt De verzendfunctie meldde succes. De ontvangst in de mailbox is nog niet bevestigd. Vraag de provider die de e-mails van uw website verzendt (uw hostingprovider of SMTP-service) om de verzendlogboeken rond ts (UTC) te controleren. Geef hen het e-mailadres van de beoogde ontvanger in vertrouwen en vraag of ze de poging hebben ontvangen en wat er daarna is gebeurd.
De test komt wel aan, maar de betreffende melding niet. De twee scenario's hebben verschillende uitkomsten. Verzamel beide sets documenten en identificeer welke melding ontbreekt.
Geen overeenkomende [MAIL] vermelding gevonden Het logboek bevat geen geregistreerd resultaat voor de verwachte poging. Controleer de versie, de activeringstijd, de meldingsvoorwaarden en de limieten. Controleer of uw dashboardtest een resultaat oplevert.
Meerdere vermeldingen met dezelfde rid Meerdere opgenomen gesprekken hebben betrekking op hetzelfde verzoek. Houd de gegevens bij elkaar. Het hoeft niet per se om dubbele leveringen te gaan.

Instellingen of snelheidslimieten kunnen een verzendpoging blokkeren. Een record kan ook ontbreken als het logboek niet kon worden geschreven of als de uitvoering werd gestopt voordat de e-mailfunctie een resultaat retourneerde. Een ontbrekende vermelding bewijst niet dat de hostingprovider het bericht heeft geblokkeerd. Neem contact op met de supportafdeling als een bekende test geen record oplevert.

5. Schakel de diagnostische functies uit nadat de gegevens zijn verzameld.

Zodra je de relevante pogingen hebt vastgelegd, wijzig je de bestaande definitie in:

 define ( 'CERBER_MAIL_DEBUG' , false );

Je kunt de toegevoegde regel ook verwijderen. Voeg geen tweede definitie toe. Als de supportafdeling heeft geholpen bij het instellen van een vast opslagpad voor je site, behoud dan die aparte instelling.

Dit voorkomt dat er nieuwe diagnostische e-mailberichten worden verzonden. Bestaande gegevens blijven in het diagnostisch logboek staan. Sla alleen de benodigde gegevens op voordat u 'Logboek wissen' gebruikt. Hiermee wordt het gedeelde logboek gewist, inclusief gegevens van andere WP Cerber-functies.

6. Deel de relevante details met de ondersteuning.

Kies het kanaal voor uw versie:

Vermeld de volgende gegevens:

  • Uw WP Cerber-versie en de ontbrekende melding.
  • Wanneer verwacht, inclusief uw tijdzone.
  • Of de dashboardtest is aangekomen.
  • De relevante [MAIL] -vermeldingen.
  • Of je nu de SMTP-instellingen van WP Cerber gebruikt of een andere WordPress-mailplugin.

Als WP Cerber een e-mailfout weergeeft, vermeld deze dan in je privéticket. In een openbaar topic vermeld je dat er een fout is opgetreden en vermijd je het plaatsen van details die gebruikers of accounts identificeren.

Voor een beveiligingsmelding kan een gerelateerde vermelding in het activiteitenlogboek ook nuttig zijn. Deel vermeldingen in het activiteitenlogboek privé , omdat ze IP-adressen en gebruikersnamen kunnen bevatten. Om de vermelding te vinden, kopieert u de rid van het e-mailrecord, opent u het activiteitenlogboek, klikt u op Meer , voert u de RID in bij Aanvraag-ID en klikt u op Filteren . Zie Wat is een RID en hoe gebruikt u deze ?

De nieuwe [MAIL] -regels die in deze handleiding worden beschreven, bevatten geen e-mailadressen, IP-adressen, onderwerpen, berichtinhoud, inloggegevens en onbewerkte bestandspaden. U kunt deze afzonderlijke regels delen in een openbaar forumonderwerp. Kopieer alleen de relevante [MAIL] -regels, zonder de omringende logboekvermeldingen of schermafbeeldingen die andere gegevens bevatten.

Exports van volledige diagnostische logboeken kunnen vermeldingen van andere WP Cerber-functies bevatten en dienen privé te worden gedeeld. Als u de gratis versie gebruikt en een medewerker om een vermelding in het activiteitenlogboek of een volledige export vraagt, vraag dan eerst hoe deze privé kan worden verzonden voordat u deze deelt. Voeg geen wachtwoorden of uw volledige wp-config.php bestand toe. Deel e-mailadressen van ontvangers alleen via een privékanaal wanneer dit echt nodig is.

Veldreferentie

Je kunt de gegevens met de supportafdeling delen zonder elk veld afzonderlijk te hoeven decoderen. Deze handleiding geeft extra context als je de gegevens nader wilt bekijken.

Veld Betekenis
explain Een samenvatting van één zin van de poging, opgebouwd uit de velden recipient , recipients , attempt , smtp en result . Deze beschrijft wat de e-mailfunctie heeft gerapporteerd en de SMTP-beslissing van WP Cerber, niet of het bericht daadwerkelijk is bezorgd.
ts De UTC-tijd is vastgelegd vlak voordat de e-mailfunctie wordt aangeroepen.
rid De request-ID van WP Cerber, gebruikt om records van dezelfde request te koppelen. Het is geen Message-ID van een e-mail.
type Het type melding. Veelvoorkomende waarden zijn onder andere lockout , send_alert , report , scan , generic en 2fa . Niet-herkende typen worden weergegeven als other .
event De oorspronkelijke reden voor de blokkering of de activiteitscode, indien beschikbaar. Dit is geen foutcode uit een e-mail.
dispatch Hoe de melding de e-mailfunctie heeft bereikt. Zie de tabel hieronder.
cwd / cwd_send Categorieën voor de werkmap van PHP op het moment dat de melding werd voorbereid en vlak voor het versturen van de e-mail.
pwd / pwd_send Categorieën voor de omgevingsvariabele PWD van de server op diezelfde twee punten. Deze variabele kan niet ingesteld zijn of afwijken van de daadwerkelijke werkmap van PHP.
recipient ( recipients De positie van de ontvanger binnen deze melding en het aantal ontvangers van de melding. E-mailadressen worden niet geregistreerd.
attempt De initial poging voor een aanroep naar een ontvanger wordt uitgevoerd, of retry wanneer WP Cerber een mislukte aanroep naar dezelfde ontvanger herhaalt. WP Cerber doet alleen een nieuwe poging als de SMTP-instelling is ingeschakeld.
smtp De eigen SMTP-beslissing van WP Cerber voor het gesprek. Zie de tabel hieronder.
result ok of error , afhankelijk van de retourwaarde van die e-mailoproep.

Het event wordt weggelaten wanneer er geen toepasselijke code is opgegeven. Dashboardtests kunnen dit veld weglaten, maar een ontbrekende event betekent op zichzelf niet dat er een testbericht is.

Verzendpaden

dispatch Betekenis
direct WP Cerber verstuurde de melding zonder deze door te verwijzen naar een van de onderstaande fasen.
plugins_loaded De melding werd vroegtijdig voorbereid en verzonden toen WordPress de fase plugins_loaded ' bereikte.
shutdown De melding werd vroegtijdig voorbereid en verzonden via een callback zodra het PHP-verzoek was voltooid. Dit betekent niet dat de server is afgesloten of dat het verzoek is mislukt.

Deze waarden beschrijven het verzendpad van WP Cerber. Ze identificeren geen SMTP-server en beschrijven ook niet de bezorgwachtrij van een e-mailprovider. Met name direct geeft niet aan of er gebruik is gemaakt van SMTP.

SMTP-beslissingen

smtp Betekenis
enabled WP Cerber past zijn SMTP-instellingen toe op het gesprek.
disabled WP Cerber past de SMTP-instellingen niet toe omdat deze zijn uitgeschakeld of WP Cerber Professional vereisen.
bypassed De SMTP-instellingen zijn ingeschakeld, maar WP Cerber slaat ze voor deze oproep over na een eerdere mislukte oproep in hetzelfde verzoek.

Dit veld geeft alleen de configuratie van WP Cerber weer. Een andere plugin kan nog steeds wijzigen hoe WordPress het bericht verzendt, dus enabled bewijst niet dat de geconfigureerde SMTP-server ook daadwerkelijk is gebruikt.

Directorycategorieën

Het logboek gebruikt categorieën in plaats van daadwerkelijke paden vast te leggen.

Waarde Betekenis
root De root van het bestandssysteem is / .
abspath De installatiemap van WordPress.
inside_abspath Een map binnen de WordPress-installatie.
outside_abspath Een map buiten de WordPress-installatie.
none De waarde was niet beschikbaar of leeg.

pwd=none en dispatch=shutdown zijn op zichzelf geen fouten. Een wijziging zoals cwd=abspath gevolgd door cwd_send=root geeft nuttige informatie over de verzendomgeving, maar bewijst geen mislukte levering. Overeenkomende categorieën garanderen ook geen overeenkomende paden, en de snapshot vóór de aanroep toont geen wijzigingen die binnen de e-mailfunctie of de bijbehorende hooks zijn aangebracht.

Op servers met de PHP-beperking ` open_basedir kan een PWD pad dat via een symbolische link de WordPress-directory bereikt, worden geclassificeerd als outside_abspath . De supportafdeling kan met deze beperking rekening houden bij het beoordelen van de vermeldingen.

Waarom één melding meerdere records kan genereren

Elk opgenomen gesprek heeft zijn eigen resultaat. Meerdere ontvangers of een bestaande SMTP-terugvaloptie kunnen meer dan één record voor een melding genereren. Een enkel verzoek kan ook verschillende meldingen opleveren.

Een melding met twee ontvangers en een onbereikbare SMTP-server kan bijvoorbeeld de volgende drie resultaten opleveren, die hier worden weergegeven zonder de technische velden:

 [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

De SMTP-poging mislukte en beide latere aanroepen werden gedaan zonder de SMTP-instellingen van WP Cerber. Niets wijst erop dat de SMTP-server hersteld is of dat een van beide berichten is aangekomen.

De nummering van de ontvangers begint opnieuw bij elke melding en e-mailadressen worden opzettelijk weggelaten, zodat een positie niet aangeeft welk adres is gebruikt. Bewaar alle gerelateerde gegevens bij het melden van een probleem, zelfs als een error wordt gevolgd door een ' ok .

Bekend probleem: wijzigingen in de lokale uploadmap.

Dit probleem doet zich voor op sites waar een plugin, thema of aanpassing ervoor zorgt dat WP Cerber tijdens vroege verzoeken en normale dashboardverzoeken andere lokale uploadmappen ziet. Een plugin kan die map bijvoorbeeld pas wijzigen nadat de pagina is geladen.

WP Cerber gebruikt de uploadlocatie om de gedeelde opslagmap te vinden. Als de bestaande map niet op de andere locatie wordt gevonden, kan WP Cerber een nieuwe map aanmaken en de oude map kwijtraken. De oude bestanden blijven op de schijf staan, maar in quarantaine geplaatste bestanden kunnen van de quarantainepagina verdwijnen en daar niet meer hersteld kunnen worden. Diagnostische gegevens kunnen ook in andere mappen terechtkomen.

Een vaste locatie die is geconfigureerd via UPLOADS in wp-config.php of de optie upload_path veroorzaakt deze opstartinconsistentie op zich niet. Een plugin of aanpassing kan dit later alsnog overschrijven. Evenzo is de local-folder-instelling van een plugin een reden om te controleren hoe deze werkt, en geen bewijs dat de site erdoor wordt beïnvloed. Dit zijn voorbeelden van bestaande configuraties, geen instructies om uw uploadinstellingen te wijzigen.

Als uw configuratie hierdoor mogelijk wordt beïnvloed, schakel dan de e-maildiagnose uit en vraag om hulp . Vermeld de naam van de plug-in, het thema of de aanpassing die de uploadlocatie bepaalt.

Behoud alle bestaande wp-cerber-* mappen en hun inhoud. Verplaats, hernoem of verwijder ze niet, wijzig de instellingen van de uploads-plugin niet en probeer geen willekeurig opslagpad. De juiste configuratie moet de map behouden die WP Cerber al gebruikt.

Als diagnostiek al is ingeschakeld op een betreffende site, schakel deze dan uit terwijl de opslaglocatie wordt gecontroleerd. Dit herstelt de verbinding van WP Cerber met een eerdere map niet. Andere WP Cerber-functies kunnen het opslagprobleem nog steeds veroorzaken.


I'm a team lead in Cerber Tech. I'm a software & database architect, WordPress - PHP - SQL - JavaScript developer. I started coding in 1993 on IBM System/370 (yeah, that was amazing days) and today software engineering at Cerber Tech is how I make my living. I've taught to have high standards for myself as well as using them in developing software solutions.

View Comments
There are currently no comments.