One problem, one page
A site does not answer, a certificate is not issued, traffic does not go through: the Doctor checks everything end to end instead of leaving you to guess.
Doctor and safe updates
One diagnostic, from the machine up to the origin of your sites, that says what is wrong and what to do, with your own values already filled in. And ToutWAF updates that verify the checksum, back up first and roll back by themselves if the new version does not start.
Where to find it in the console : Console: Infrastructure > ToutWAF Doctor; on the command line: toutwafctl doctor; updates: Administration > Updates.
What it is for
The cause and the action
Each finding gives its cause and what to do, with your own values (addresses, names, ports) already filled in.
The same check everywhere
The console, the REST API, the command line and the pre-check before every certificate order use the same check: they can never disagree.
A report to send
A plain text to copy or download for support. It contains the checks and the addresses of your installation, nothing about your visitors or the content of your pages.
What it checks
Each card is green, orange (to watch), red (to fix) or grey (not checked, with the reason).
ToutWAF
A data-plane node is enrolled and online; the policy is published and applied by the nodes; on the command line, the services are active.
This machine
The local ports (80, 443, 9443, 9444) listen, the machine's firewall lets the web ports in, and no firewalld rule is aimed at ToutWAF's address. Nothing is changed automatically.
DNS in IPv4 and IPv6
Every A and AAAA record of every site name leads to this ToutWAF. It finds the classic trap: an AAAA record left over at a CDN or proxy while the A record points here.
Certificate
The prerequisites of a certificate order (node, policy, port 80, DNS), then the state of the stored certificate: none, pending, last order failed with the authority's message, expired or expiring.
Reachable from the Internet
Optionally, the Let's Encrypt staging test server tries to reach port 80 of your site from outside; no certificate is kept.
Origin, scheduled tasks, anti-bot
The origin answers (connection refused, 5xx error, untrusted certificate, protected address), including after an address change; failing or missed scheduled tasks; programs (git, curl) challenged by mistake by the anti-bot.
Product updates from the console
The Updates page offers a new version as soon as it is published and can install it on the server it runs on.
- Two channels: stable (a version only when everything was tested) and development (beta, may contain bugs, not for production). No stable version is published yet.
- The checksum is verified, a backup of the configuration and the database is taken first, and if the new version does not start or fails its health check, the previous one is restored automatically.
- No silent downgrade: nothing is offered when the chosen channel is older than the installed version.
- When the console cannot apply the update, the page says why and shows the exact command to run as root.
Privacy of the Doctor
What it reads and what it sends.
- It reads nothing about visitors or the content of sites and sends nothing about them.
- Its probes to the DNS addresses of your site identify themselves as ToutWAF-Doctor/1.0: if your DNS points to the address of another company (a CDN), that company sees it.
- To find ToutWAF's public address it asks a third-party service at most once an hour; an environment variable and the “Public host name or IP” field in Settings avoid that.
What is not done, or not proven
We prefer to say it plainly.
- The Doctor says what to do but fixes nothing by itself: a firewall, a DNS or a router remains yours to set.
- The test from the Internet only works with a configured Let's Encrypt staging directory; without it, it is refused rather than issuing a real certificate.
- Part of the findings depends on what ToutWAF can see from the machine: a router, an Internet box or a cloud security group upstream is not inspected, the assistant only shows the settings to make there with your values.
- No stable ToutWAF version is published: console updates today concern the development version.
Use cases
A site that answers “421”
The Doctor says whether the site was just created, no node is enrolled, the publication failed or the typed name is wrong.
A certificate that is not issued
It spots the AAAA record left at a CDN before the order, so no attempts are wasted.
An update without stress
You read the release notes, update in one click, and the previous version comes back by itself if it fails.
What is included, by edition
The basics are free; the advanced options need a paid offer. An option under licence stays visible in the console, locked, never hidden.
EditionFree Included in every offer, including both free offers (Free and Free +)Pro and above Paid offers: visible in the console, locked without a licence. From Pro, unless Agency or Enterprise is shown
Not yet tried in real conditions Works in the product's tests, but has not yet been tried with the real service, system or equipment. The console shows the same note where you set the function up.
- One diagnostic from the machine up to the origin: node, policy, ports, firewall, DNS, certificate, Internet access, originFree
- Each finding comes with its cause and the action to take, in plain wordsFree
- DNS check for IPv4 and IPv6 that recognises a CDN or proxy address left over in an AAAA recordFree
- Go-live assistant: node, DNS, ports and certificate in four rows, certificate ordered only when everything is greenFree
- Optional test from the Internet, through the staging server of a certificate authorityFree
- Help for your router, box, cloud security group or firewall, with your values filled in (files for OPNsense and pfSense) Not yet tried in real conditionsFree
- Text report to send to support: nothing about your visitors or the content of your pagesFree
Going back to the default of an advanced option is always possible. What happens when a paid licence ends is described in the pricing FAQ: 48 hours of grace, 48 hours of read-only, then WAF protection is switched off until renewal.
Pricing Read the documentation
Put a shield in front of your applications today
Install it on your own server, or get in touch to talk about licences.