AGuard Safe for Joomla

Documentation

How to install the extension, how to read its results and what to do about each finding.

Installing and removing

Requirements
Joomla 5 or 6 and PHP 8.1 or newer. No database tables are created.
Install
In the Joomla administrator open System, Install, Extensions and upload the package. Then open Components, AGuard Safe.
Update
New versions appear in System, Update, Extensions, like any other extension.
Remove
Open System, Manage, Extensions, find AGuard Safe and uninstall it. Its files and settings are removed; nothing else on the site is touched.

Reading the results

Fix now
Something a visitor can already use against the site, for example a password file that the server hands out. Deal with it today.
Review
A weakness that needs a decision: a leftover file the server currently refuses to serve, an administrator without multi-factor authentication, HTTPS that is not forced.
Fine
The check passed.
Note
Not a fault, but worth knowing, such as the log folder sitting in its default place inside the web root.
Check again
The check runs every time the page opens. Use the Check again button after you have fixed something.

Files left in the web root

What is looked for
Repository folders (.git, .svn), .env files, copies of configuration.php with endings such as .bak or .old, phpinfo and test pages, error logs, and archives or database dumps lying in the site's top folder.
How it decides a file is public
The site requests the file from itself over HTTP, the way a visitor would. If the server answers with the file, it is marked Fix now. If the server refuses, it is marked Review, because one change in the server configuration would expose it.
How to fix
Delete the file, or move it to a folder outside the web root. Renaming it is not enough.
The installation folder
If the installation folder still exists after setup, delete it.

Software versions

Joomla and extensions
The result is based on the last update check Joomla itself made. Open System, Update to refresh it, then install what is waiting.
PHP
The extension compares your PHP branch with the end-of-support dates published on php.net. An unsupported branch is marked Fix now; a branch that loses support within six months is marked Review. Changing the PHP version is done in your hosting control panel or by your hosting provider.

Site settings

Debug mode and error reporting
Both reveal file paths, database queries and software details to visitors. Turn Debug System off and set Error Reporting to None or System Default in Global Configuration.
Force HTTPS
Set Force HTTPS to Entire Site in Global Configuration, Server. If your server already redirects every request to HTTPS, you can leave it as it is.
Log and temporary folders
Joomla keeps them inside the web root by default. Moving them outside removes any chance of their files being downloaded.
Open registration
If the site does not need visitor accounts, turn registration off in Users, Options.

Administrator accounts

Number of Super Users
More than three active Super Users is marked Review. Keep only the accounts that are really used.
Multi-factor authentication
Each Super User turns it on in their own profile, under Multi-factor Authentication.
Easily guessed names
Names such as admin or administrator are the first that password-guessing attacks try. Rename the account in Users, Manage.

E-mail protection

SPF
A DNS record that lists the servers allowed to send mail for your domain. It is added in your domain's DNS settings, not in Joomla.
DMARC
A DNS record that tells receiving servers what to do with mail that fails the checks. Without it, or with the policy none, forged mail in your name is still delivered. Start with p=none and reports, then move to quarantine or reject.
Not checked
The check is skipped on local addresses and when it is turned off in the options.

Options and privacy

Options
The Options button has two switches: testing whether found files are public, and looking up the SPF and DMARC records. Access to the extension is set on the Permissions tab.
What leaves the site
Nothing about your site is sent to us or anyone else. The only requests are to your own site and to DNS, and both can be switched off.

Something missing or not working? Write to [email protected]