Help Center

Something isn't going as expected? Find the message you saw or the symptom you noticed: each answer explains what it means and what to do.

Installation and license

Your license key is entered in HiveProtect.ai > License. Here are the messages you may run into there and what to do.

My license key is refused

In HiveProtect.ai > License, paste the full key into the “Enter your license key:” field, then click Validate. If a red box appears, find your message in this table.

Message displayedWhat it meansWhat to do
“Please enter a license key.”The field is empty.Paste your key, then click Validate.
“Invalid license key format.”The key is incomplete or was copied incorrectly, or the field still contains the masked key HP-XX-****-****.Paste the full key, with no spaces or line breaks: HP, two letters, then six groups of four characters.
“Clé de licence invalide”This key is not known to the license server.Copy it again from your customer area (Downloads, Your license block, Copy button), the license email or your order confirmation page.
“License expired” or “Votre licence a expiré. Veuillez la renouveler.”The license end date has passed.Renew it from the Pricing page, then enter your key again.
“Licence revoked”, “Licence suspended” or “Votre licence est …”The license is no longer active (the status is displayed in English).Contact us and give us your site's address.
“Erreur - Contactez hiveprotect.ai”The license server refuses this site.Contact us and give us your site's address: no setting lets you lift this refusal yourself.
“L'empreinte de ce site ne correspond plus à celle enregistrée.”The site has moved or has been duplicated.See the question “I moved my site or changed its address”.
“Unable to verify the license. Please check your connection.”Your site cannot reach the license server.See the next question.
“Connection error. Please try again.”Your browser's request to the admin failed.Reload the page, log in again if needed, then try again.

The “Unable to verify the license” message appears

Your site must be able to reach the license server. This message covers several causes: outgoing connections blocked by the host, a response intercepted (maintenance page, firewall, Cloudflare challenge) or a server clock that is off.

  • Ask your host to allow outgoing HTTPS connections (port 443) to hiveprotect.ai.
  • Check that your server's time is accurate: a drift of more than a few minutes causes responses to be rejected.
  • Wait a few minutes before trying again: repeated attempts don't help.

The free trial does not start

The 15-day trial starts when you click Activate in the WordPress plugins list: HiveProtect then opens the License screen. If you installed the plugin another way (FTP copy, cloned or restored site), the trial does not start on its own: click Free trial on the License screen.

Message displayedWhat it meansWhat to do
“A license is already active. Remove it first.”A key is already saved on this site, even if invalid or expired.If it is yours, enter a valid key or renew it. Otherwise, click Remove license, confirm, then click Free trial.
“Error connecting to the server: …”Your site cannot reach the license server.See the question “The Unable to verify the license message appears”.
“Le serveur n'a pas pu vérifier votre domaine…”The license server must be able to read https://votre-site/wp-json/hiveprotect/v1/domaine.Check that this address responds over HTTPS, with no redirect, no password and no firewall challenge, and that the site address (Settings > General) uses HTTPS, with no port number. A local or maintenance-mode site cannot be verified.

My site shows “Free version” even though I have a license

Open HiveProtect.ai > License: the screen shows the real status of the license.

  • If the field shows HP-XX-****-****, a key is saved: click Refresh license.
  • If the field is empty, paste your key again, then click Validate.
  • If the message says the license has expired or been suspended, renew it from the Pricing page.

Once the license is active again, open the screens of the licensed features (firewall, AI analysis, statistics, geographic filtering…) and check that each one is turned on.

The key can also disappear on its own when the license server answers “invalid license” during an automatic check: the plugin does not show the reason for this removal.

I moved my site or changed its address

Change of address (new domain, switch to HTTPS, adding or removing www): open HiveProtect.ai > License and click Refresh license. Then check that the screen shows “License active” and that https://votre-site/wp-json/hiveprotect/v1/domaine responds over HTTPS, with no redirect.

Change of host (another WordPress location or another table prefix, with the same domain): if the screen refuses with “L'empreinte de ce site ne correspond plus à celle enregistrée”, contact us and give us the site's address. Only our support team can reset this fingerprint; then enter your key again.

I want to use my license on another site

Install and activate HiveProtect on the new site, then enter your key in HiveProtect.ai > License and click Validate. To free up the old location, contact us: only our support team can detach a site from a license.

Access and login

When HiveProtect refuses an address, the page displayed shows which mechanism is responsible. Find it here to know which screen to use.

I'm blocked on my own site

What is displayedOriginWhere to act
“403 Forbidden — Your access has been blocked by our security system.”The plugin's firewall.WAF Security > Dashboard, “IPs blocked by the WAF” block.
“Acces Refuse — Votre adresse IP a été bloquée par notre système de sécurité.”The early firewall.WAF Security > Dashboard, “IPs blocked by the WAF” block.
“Access Denied — Your IP address has been blocked by our security system.”An address written in the .htaccess file.WAF Security > Dashboard, “IPs blocked by the WAF” block.
“Access Denied — Your IP address has been identified as a threat by our collective defense network.”HiveShield.See below.
“Too many attempts. Wait N minute(s) before trying again.”The login lockout, after repeated failures.Login Logs, “Lockout after repeated failures”.
“Error: Too many failed attempts. Try again in … minutes.”The account is locked after several wrong two-factor authentication codes.Wait without trying again.
“Page Secured & Relocated”The custom login address.See “I can't find the login address anymore”.
“Your submission has been blocked by our security system…” in a formForm blocking only: the admin remains accessible.Blocked IPs.

How do I unblock an address?

You need to be able to open the admin: log in from another address (another network, your phone's connection sharing) or with another administrator account. Each button only lifts its own type of block.

1

Find the address in question: in WAF Security > Rules & configuration, the “Your real IP” card shows the address HiveProtect sees for the current connection.

2

Firewall: in WAF Security > Dashboard, “IPs blocked by the WAF” block, click Unblock (or Unblock all) and confirm.

3

Forms and mass attack protection: in Blocked IPs, click Unblock form submissions or Lift 403 mode on the address's row. Unblock all, at the top of the page, lifts every type.

4

Login lockout: in Login Logs, “Lockout after repeated failures” section, “Currently refused:” table, click Unblock. Without any action on your part, the refusal expires on its own.

5

To avoid being hit again: in Blocked IPs, enter the address or CIDR range in “Whitelist”, then click Add.

My admin is inaccessible (500 error, blank page)

HiveProtect provides no address, file or wp-config.php constant to suspend itself from the outside: there is no recovery procedure outside the admin. It limits the risk in two ways.

  • The hardening blocks and the list of banned addresses in the .htaccess file are protected by an automatic rollback when the site responds with a 500 error. The HTTP headers are not.
  • All refusals are per address: if you blocked yours, log in from another address (another network, your phone's connection sharing).

If the 500 error comes from the HTTP headers block, delete, by FTP or from your host's file manager, the lines between # BEGIN HiveProtectHeaders and # END HiveProtectHeaders in the .htaccess file. HiveProtect does not put them back until you change the headers in the admin.

I lost my phone (two-factor authentication)

Two-factor authentication is reserved for administrators: other accounts, WooCommerce customers included, log in normally. The Secure Login screen generates 10 single-use backup codes and offers a recovery link.

1

From a computer where your administrator session is still open, open Secure Login, click Send Recovery Link and confirm.

2

Open the “2FA recovery” email received at your account's address: the link works only once and for a limited time.

3

Scan the new QR code with your new phone and keep the 10 new backup codes.

My codes are refused even though the app shows one

  • Check that your phone's time is set automatically, then wait for the next code.
  • Check that you are reading the code for the right account: the app labels each entry “domain:email”.
  • After several wrong codes, the account is locked for a few minutes (“Error: Too many failed attempts.”): wait without trying again.
  • If the security keys in wp-config.php have changed (renewal, site moved or restored with a different wp-config.php), the two-factor authentication secret can no longer be read: contact us.

I can't find the login address anymore

As long as two-factor authentication is active, the wp-login.php page is hidden for all accounts and displays “Page Secured & Relocated”, in English. Only your site's custom login address shows the form.

  • It appears in Secure Login (“Custom login URL:” and “Log in via:”), which another logged-in administrator can also read.
  • It is repeated in the emails sent to WordPress's admin address each time two-factor authentication is turned on or off, and each time its options are changed.
  • “Lost your password?” remains usable, but does not reveal the address.

An administrator cannot log in through WooCommerce's “My account” form when two-factor authentication is active: WordPress answers “incorrect password” there, even if it is right. Use the custom login address.

Messages and forms

When a legitimate message is refused, find the cause in the log, then act according to the type of refusal.

A legitimate message was classified as spam

Depending on the cause of the refusal, your visitor sees a different message.

What the visitor seesCause
“Your message has been identified as unwanted.”Verdict of the artificial intelligence analysis.
“Validation error. Please try again.”An invisible trap field was filled in.
“Suspicious behavior detected.”Behavioral detection judged the input suspicious, or JavaScript is disabled and your setting requires it.
“Service not available in your region.”Geographic filtering.
“Your submission has been blocked by our security system. If you believe this is an error, please contact us.”The visitor's address is already blocked.
A 403 page, with no message in the formThe firewall refused the request before the form.
1

Open HiveProtect.ai > Detailed logs and filter on “Spam”. The search covers the name, email, phone number, IP address and message, on the displayed page.

2

Read the “Detection reason” and the “Complete form content:”: the refused message is not sent on, so contact the sender again.

3

If the cause is artificial intelligence, click Not spam. The “What do you want to add to the whitelist?” box offers the email address and an excerpt of the content: future submissions from this address, or containing this excerpt, will no longer go through the AI analysis. You can also add a rule in HiveProtect.ai > False positives.

4

If the cause is the trap field, behavioral detection or geographic filtering, adjust HiveProtect.ai > Settings (“Honeypot System”, “Behavioral Detection”, “Geographic filtering”), or add the visitor's IP address to the “Whitelist” in Blocked IPs.

The firewall wrongly refuses a page or a form

The “Reason” column of the firewall log cites the rule concerned.

1

Open WAF Security > Rules & configuration.

2

Find the rule, with the same text as the “Reason”, under “Form POST filtering” or under “Active detection rules”.

3

Flip its switch: it is saved immediately and a “Rule disabled” bubble confirms it.

4

If the address was banned in the meantime, unblock it in WAF Security > Dashboard.

My statistics or logs are not moving

  • Several screens keep their figures in cache. Clear cache rebuilds those of Abuse & Reports, 404 & Redirects and the three Analytics screens, which are recalculated at most every ten minutes anyway. The Dashboard is cached for up to 24 hours and has no refresh button: it updates with the next log entry or when Settings are saved.
  • Several tasks depend on cron: open the CRON diagnostics on the HiveShield screen.
  • Check the time zone in Settings (“Time zone”).
  • A page served by a page cache without running PHP is not filtered by the plugin: early firewall and HiveShield refusals do not show up for those pages.
  • Clear logs resets the counters to zero, and log search only covers the displayed page.
  • The Dashboard and the admin bar only count what the anti-spam analyzed, not the attacks stopped by the firewall, which has its own Dashboard.
  • Without a valid license, Visitor Analytics and Bot Analytics stop collecting: the data already recorded remains available. In Bot Analytics, only known bots verified by their host name (reverse DNS) are counted, and the “DNS Reverse verification” checkbox in WAF Security > Rules & configuration must stay checked; AI bots are not counted.
  • E-commerce Analytics reads a copy of the orders: import the history first, then an order only enters the copy when its status changes to “processing” or “completed”.

Email alerts and notices

Find out who receives what, and what the banners displayed in the admin mean.

I'm not receiving the email alerts

The recipient address depends on the alert:

  • spam and form alerts: the “Notification email” in HiveProtect.ai > Settings;
  • login notifications: the “Recipient email:” in Login Logs > Login Email Notifications.

Click Test the email in Settings: “Test email sent” means that WordPress accepted the message. If nothing arrives, check your spam folder and that your server can send emails. The screen also runs a diagnostic of your domain's SPF, DKIM, DMARC and MX records: a low score often explains messages landing in spam. Anti-spam alerts are infrequent: the automatic block email is sent only once per address, and the weekly report only if there were attempts during the week. The “Notification email” field must not be left empty.

No alert email contains an unblock link.

What do the admin banners mean?

BannerMeaningWhat to do
“⚠️ Anti-spam protection out of service”The call to artificial intelligence failed in the last 24 hours: the messages concerned were not analyzed by the AI; the other filters stayed active.In Settings, check the “API key” and the model, then run Test the API.
“⚠️ N new IP(s) automatically blocked in the last 24h after repeated spam was detected.”Addresses were blocked for forms.Open Blocked IPs and click Unblock form submissions if it is a false positive.
“HiveProtect.ai Universal: No supported form plugin was detected.”No recognized form plugin is active: the anti-spam has nothing to protect.Install a supported form plugin, or dismiss the banner.
“⚠️ WordPress is set to a fixed offset…”The displayed time does not follow the switch to daylight saving time.In Settings > General, choose your time zone's city (for example Paris).
“⚠️ 2FA conflict: … takes precedence over HiveProtect”Another two-factor authentication plugin (Wordfence Login Security) asks for its code before HiveProtect's.Follow one of the three options offered by the Secure Login screen before turning on HiveProtect's two-factor authentication.
“🧱 A hardening rule had disappeared from .htaccess…”HiveProtect put back a rule in the .htaccess file that had disappeared or been modified.Information: the View button opens the .htaccess screen.

The banners about the license and file integrity are explained in the “Installation and license” section above and in “Updates and end of license” below.

Updates and end of license

HiveProtect does not use WordPress's “Updates” page: it updates itself, and you can also install it by hand.

How do I update HiveProtect?

An update requires a valid license. There are three ways:

  • Automatically: every day, HiveProtect checks whether a new version exists and installs it.
  • From the plugin: in HiveProtect.ai > License, click Install next to “v… available”, then confirm.
  • By hand: download the ZIP file from your customer area (Downloads, Download the ZIP), then install it with Plugins > Add New > Upload Plugin.

The installed version is shown on the License screen.

The update failed

When you click Install, an “Installation error” window shows the cause.

Message displayedWhat it meansWhat to do
“token_request_failed” or “download_failed”Your site could not reach the server or download the archive.The host must allow outgoing HTTPS connections to hiveprotect.ai.
“token_generation_failed” with “invalid_license”No valid license is saved on this site.Enter a valid key in License, then try again.
“unzip_failed” or “Archive de mise à jour invalide”The archive is unreadable or the folder is not writable.Check the write permissions of the wp-content folder, then reinstall the official ZIP.
“No files could be copied. Check the plugin folder permissions.”HiveProtect is not allowed to write to its folder.Fix the write permissions, then try again.
“Partial update: …”Some files could not be replaced: the plugin mixes two versions (the message is displayed as a success).Reinstall the official ZIP with Plugins > Add New > Upload Plugin, then click Check file integrity: the expected result is “All files are intact”.

My license has expired or my trial has ended: what happens?

HiveProtect goes back to the free version: the free features keep protecting your site, the licensed features are no longer offered, updates stop, and a “You are using the free version” banner is displayed in the admin. No warning is displayed before the trial ends: its date is shown on the License screen.

Your address lists, rules, logs and statistics are kept.

To resume, choose a plan, then enter your key in HiveProtect.ai > License. Then open the screens of the licensed features and check that each one is turned on.

Hosting and compatibility

HiveProtect adapts to most hosting setups. Here is what changes depending on your server, your cache or your CDN.

My host uses nginx: what doesn't work?

The .htaccess file protections and the HTTP headers only apply on an Apache or LiteSpeed server. On nginx, the WAF Security > .htaccess tab shows “No effect”: “This server does not read .htaccess files”. The HTTP Headers screen, for its part, accepts your settings without warning: on nginx alone, no header is sent.

The rest works: the firewall, the anti-spam, secure login and the refusal of banned addresses are handled by PHP, whatever the server. If nginx is only a relay in front of Apache, as at many hosts, everything works: Apache is what reads the file.

HiveProtect says the .htaccess file is not writable

The WAF Security > .htaccess tab says so clearly:

  • “The WordPress folder is not writable: unable to create the .htaccess.”
  • “The .htaccess belongs to another user (…): HiveProtect does not write it.”
  • “The .htaccess file is not writable (chmod 644 expected).”

HiveProtect does not work around these permissions: ask your host to fix them. In the meantime, banned addresses are still refused by the plugin's other protections.

If another security plugin (Wordfence, Solid Security, Sucuri…) already manages the file, HiveProtect writes nothing there and the screen says so. Deactivate that plugin, or click Apply anyway.

I'm behind a page cache (WP Rocket, LiteSpeed Cache, W3 Total Cache…)

HiveProtect does not configure these plugins. Each time a form is changed, Forms Creator clears the cache of the affected pages for the main caching plugins; after changing the protection badge or the HTTP headers, clear the page cache yourself.

The firewall's refusal pages are marked “do not cache”. However, a page served by a cache before PHP runs does not reach the firewall: the plugin cannot filter it.

My site is behind Cloudflare or another CDN: all my visitors have the same address

HiveProtect uses the address of the connection received by your server. It trusts Cloudflare's header (CF-Connecting-IP) only if the connection really comes from Cloudflare; the X-Forwarded-For and X-Real-IP headers are ignored.

  • With Cloudflare: the WAF Security > Rules & configuration screen shows “Cloudflare configured correctly” or “Cloudflare detected but incomplete configuration”. Check that the domain has the orange cloud (Proxied) and that the SSL/TLS mode is Full or Full (strict).
  • With another CDN or a load balancer: ask your host to pass the visitor's address in the connection address (for example with Apache's mod_remoteip module). HiveProtect has no “trusted proxy” setting.

Deactivating or uninstalling

Before removing HiveProtect, decide what you want to keep: the choice is made before deletion.

What happens if I deactivate HiveProtect?

Nothing is erased: your settings, license, two-factor authentication codes, lists and logs are kept, and reactivation finds them again.

  • The early firewall file is removed: after reactivation, turn the Performance Mode (MU-Plugin) switch back on in WAF Security > Rules & configuration.
  • The rules written to the .htaccess file stay in place, banned addresses included: the server keeps refusing them.
  • After reactivation, check your security settings.
  • Deactivating the plugin does not free up your license's location.

What is left after HiveProtect is deleted?

Before deleting the plugin, open HiveProtect.ai > Settings: the uninstall row offers the “Keep data when uninstalling” checkbox. Check it or uncheck it, then click Save.

What it concernsBox checkedBox unchecked
Settings and licenseKeptDeleted
Logs, blocked and allowed addresses, statisticsKeptDeleted
Forms created with Forms CreatorKeptDeleted
Two-factor authentication (secrets and backup codes)KeptDeleted: each administrator will have to set it up again after a reinstall
Hardening rules in the .htaccess fileRemovedRemoved
Banned addresses and HTTP headers in the .htaccess fileStayStay

No screen removes the HiveProtect Blocks and HiveProtectHeaders blocks from the .htaccess file: if you wish, delete the lines between # BEGIN … and # END …. The wp-content/hiveprotect-logs/ folder, if it exists, also stays.

How do I remove everything cleanly?

1

In HiveProtect.ai > Settings, uncheck “Keep data when uninstalling”, then click Save.

2

In WAF Security > .htaccess, click Remove our blocks.

3

Optional: in WAF Security > Rules & configuration, set the Performance Mode (MU-Plugin) switch to “Disabled”.

4

In Plugins, deactivate HiveProtect, then delete it.

To free up your license's location, contact us.

I deleted or renamed HiveProtect's folder by FTP

No cleanup step runs: the early firewall file, the .htaccess file rules, the settings, the tables and the scheduled tasks stay in place. The early firewall file simply becomes inactive.

If you only renamed the folder, the early firewall stops running: the WAF Security > Rules & configuration screen shows a warning, with the Regenerate the early firewall button.

If you deleted it, reinstall the plugin (settings, tables and license are still in the database), then uninstall it cleanly from WordPress.

Is your problem not described here?

The documentation details every screen of the plugin, and the FAQ answers the most frequent questions. If the problem persists, write to us with your site's address and the message displayed.

Ready to protect your site?

Try HiveProtect free for 15 days, with all features included.