CPGuard ​
CPGuard shows the malware scans of your files: the history of every scan of your account and what each one found. You can also start a scan yourself. Available since panel 1.9.0.
Overview ​
URL: /client/cpguard
Open it from Security > CPGuard in the sidebar. The page appears when your hosting provider runs CPGuard on the server and your hosting plan includes it.
Your files are scanned automatically. Scans your hosting provider runs on your account are listed here too.
Since panel 1.9.3, your hosting provider can show CPGuard's own interface on this page instead of the scan list. You then see CPGuard's dashboard, the detections, manual scans, WAF and bot statistics, and CMS threats, for your own account only. Scans are started and followed in that interface; Quarantined files stays at the top of the page.
Scanning your files ​
Scan my files starts a scan of every file in your account. Large accounts take a while; the result appears in the list when the scan finishes.
How often you can start a scan is limited, and you cannot start one while another scan of your account runs. When you cannot start one yet, the dialog says when the next scan can start.
The scan list ​
Each row shows the Scan, its Scope, who Started by, the Status, when it Started and Finished, the Files scanned, and the number of Detections.
- Detections lists the files the scan flagged. Only files in your own account are shown. A scan that is still running shows what it has found so far.
- Stop stops a running scan that you started.
If files are flagged and you need help cleaning them up, contact your hosting provider. Since panel 1.9.3, you can also move them to quarantine or delete them on Security > Malware.
Quarantined files ​
Since panel 1.9.3, Quarantined files lists the files CPGuard moved out of your website. Select the files you want back under Files to restore, up to 50 at a time, and click Restore selected. Each file goes back to the place it was moved from, and a message confirms each one.
Restore a file only if you are sure it is safe: CPGuard still detects it, and may quarantine it again.
A file cannot be restored when another file is already at its original path (move or delete that one first), when the folder it was in no longer exists, or when CPGuard no longer keeps a copy of it. The message says which applies.
The files CPGuard moved to its quarantine are also listed on Security > Malware as In cPGuard quarantine, when your hosting plan includes that page, and can be restored from there too. That page also moves files to quarantine and deletes them, whichever scanner found them.
Threat notifications ​
Since panel 1.9.3, when CPGuard flags files in your account, you get a notification in the bell at the top of the panel and, when your account has a contact email, an email to that address, listing the files and what was found. Set the address under Password & Security. If your account is suspended because of a threat, you are told the same way, with the reason.
Over the API ​
Since panel 1.9.4, the client REST API runs the scans of this page:
| Method and path | What it does |
|---|---|
GET /api/client/cpguard/scans | List the scans, newest first: the account's own and the whole-server scans the administrator ran. |
POST /api/client/cpguard/scans | Scan every file of the account, like Scan my files. One scan of the account runs at a time, and as on this page, a new scan may have to wait. |
GET /api/client/cpguard/scans/{scanId} | Read one scan and the files it found in the account. A whole-server scan lists only the account's own files. |
POST /api/client/cpguard/scans/{scanId}/stop | Stop a running scan of the account. A whole-server scan is the administrator's and cannot be stopped here. |
The endpoints need this page's feature in your hosting plan; see API Keys.
Related pages ​
- Malware - quarantine, restore, or delete a flagged file.
- File Manager - open or remove a flagged file.