Skip to content

Commit a713d37

Browse files
authored
TCR-732 update for docs on how to disable the CXS Watch daemon
1 parent 3bd4e2d commit a713d37

File tree

1 file changed

+37
-1
lines changed

1 file changed

+37
-1
lines changed

docs/ids_integration/README.md

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,12 +46,48 @@ When some IP address is blocked by <span class="notranslate">LFD, Imunify360</sp
4646
1. <span class="notranslate">_Automatically scan all modified files_</span>
4747

4848
<span class="notranslate">CXS Watch</span> daemon must be disabled.
49+
```
50+
# stop and disable the service so it won’t start on boot
51+
systemctl stop cxswatch
52+
systemctl disable cxswatch
53+
54+
# hard-prevent other units from starting it
55+
systemctl mask cxswatch
56+
57+
# (optional) to allow it again later, unmask it:
58+
systemctl unmask cxswatch
59+
```
60+
:::tip Note:
61+
You normally don’t need to chmod or rename `/etc/cxs/cxswatch.sh`. Masking the unit already prevents activation by other services. (If you do want an extra safety lock, you can `chmod 000 /etc/cxs/cxswatch.sh` and revert with `chmod 755` later. The script path is standard for CXS.
62+
:::
4963

5064
2. <span class="notranslate">_Automatically scan any files uploaded using web_</span>
5165

5266
<span class="notranslate">CXS ModSecurity</span> vendor should be disabled.
5367

54-
3. <span class="notranslate">_Automatically scan any file uploaded using ftp_</span>
68+
You can do this by CLI (preferred for repeatability) or via WHM UI.
69+
70+
**CLI (root)**
71+
The vendor short name for CXS is `configserver` (per vendor metadata). Use either the helper script or WHM API:
72+
73+
```
74+
# Using cPanel helper script (works on all supported versions)
75+
# Disable the ConfigServer (CXS) ModSecurity vendor
76+
/usr/local/cpanel/scripts/modsec_vendor disable configserver
77+
78+
# (optional) also disable that vendor’s individual config files & updates via API:
79+
whmapi1 modsec_disable_vendor_configs vendor_id=configserver
80+
whmapi1 modsec_disable_vendor_updates vendor_id=configserver
81+
82+
# Apply ModSecurity settings and restart Apache
83+
whmapi1 modsec_deploy_settings_changes
84+
/usr/local/cpanel/scripts/restartsrv_httpd
85+
```
86+
87+
**WHM UI (if you prefer)**
88+
WHM » Security Center » ModSecurity® Vendors → find **ConfigServer (CXS)** → toggle `Enabled` to `Off.` (You may also click Delete to remove it entirely.)
89+
90+
4. <span class="notranslate">_Automatically scan any file uploaded using ftp_</span>
5591

5692
Imunify360 supports only <span class="notranslate">[Pure-FTPd](https://www.pureftpd.org)</span>. For <span class="notranslate">Pure-FTPd CXS</span> launches pure-uploadscript for the scan. Any pure-uploadscript used by <span class="notranslate">CXS</span> must be disabled. You can use the following commands to do that:
5793

0 commit comments

Comments
 (0)