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]
