Merge pull request #122 from annkots/master

TCR-678: update documentation about generic control panel integration

Author: annkots

docs/control_panel_integration/README.md

@@ -266,7 +266,7 @@ After the successful installation, **you can reach the Imunify360 UI at the URL
 
 ## 4. Set up modules and integrations and change other Imunify360 settings to reflect your needs
 
-#### 4.1 Define list of administrators for Imunify360
+### 4.1 Define list of administrators for Imunify360
 
 The administrators have full access to Imunify360 UI and its settings. To grant non-root users full access add more administrators by listing them in the them in the <span class="notranslate">`/etc/sysconfig/imunify360/auth.admin`</span> file or specify the [integration scripts](https://cloudlinux.zendesk.com/hc/en-us/articles/4840433434524-How-to-filter-the-number-of-users-by-using-integration-scripts?_gl=1*1dtmkmt*_up*MQ..*_ga*ODUwMjA5NDYyLjE2OTkyMTAwOTI.*_ga_1RCQ134PYC*MTY5OTIxMDA4OS4xLjAuMTY5OTIxMDA4OS4wLjAuMA..*_ga_V4QHJSZM47*MTY5OTIxMDA4OS4xLjAuMTY5OTIxMDA4OS4wLjAuMA..*_ga_8LBSSX7VQX*MTY5OTIxMDA4OS4xLjAuMTY5OTIxMDA4OS4wLjAuMA..) admin scetion. 
 
@@ -317,7 +317,7 @@ It should point to an executable file that generates a JSON file similar to the
 </div>
 </details>
 
-#### 4.2 FTP uploads scan
+### 4.2 FTP uploads scan
 To scan files uploaded via FTP, configure [PureFTPd](https://www.pureftpd.org/project/pure-ftpd/). Write in the <span class="notranslate">`pure-ftp.conf`</span>:
 
 <div class="notranslate">
@@ -327,7 +327,7 @@ CallUploadScript             yes
 ```
 </div>
 
-#### 4.3 Per-domain rules constrol
+### 4.3 Per-domain rules constrol
 To enable domain-specific ModSecurity configuration, specify the <span class="notranslate">`modsec_domain_config_script`</span> in the <span class="notranslate">`integration.conf`</span>.
 
 <div class="notranslate">
@@ -354,7 +354,7 @@ The script should also restart the web server to apply the configuration. This s
 If configuration change failed, the script should return 1, and in the standard error stream (stderr) it should return the reason for failure. On success, the script should return 0.
 In a single run of the script, we might update a single domain/user, as well as multiple users (all users) on the system.
 
-#### 4.4 Integration with WebShield
+### 4.4 Integration with WebShield
 
 WebShield consists of four services:
 
@@ -782,3 +782,40 @@ It should point to an executable file that generates a JSON file similar to the
 </div>
 
 <span class="notranslate">`web_server_config_path`</span> should point to a path that is added as <span class="notranslate">`IncludeOptional`</span> in this domain's virtual host e.g., <span class="notranslate">`/path/to/example.com/specific/config/to/include`</span> path should be added for the <span class="notranslate">`example.com`</span> domain.
+
+### WordPress Plugin with non-CloudLinux generic panel environment
+
+This section explains how install the [**Imunify Security WordPress Plugin**](https://docs.imunify360.com/wordpress_plugin/) on servers that **do not run CloudLinux OS** and use a **home-grown** or **“generic” hosting panel**.
+
+1. Ensure the PHP-handler discovery script is present. Add (or reuse) the PHP discovery script described in the [CloudLinux OS integration guide](https://docs.cloudlinux.com/cloudlinuxos/control_panel_integration/#php).  
+
+2. Extend your [domain](https://docs.imunify360.com/control_panel_integration/#data-description) API response. Your `domain` script must now return PHP-handler details for **every** hosted domain.
+
+```
+{
+  "data": {
+    "example.com": {
+      "document_root": "/home/example/public_html",
+      "php": {                 // <========== NB: lines 5-11 — required in full
+        "php_version_id": "alt-php56",
+        "version": "56",
+        "ini_path": "/opt/alt/php56/link/conf",
+        "is_native": true,
+        "handler": "lsapi"
+      }
+    }
+  },
+  "metadata": {
+    "result": "ok"
+  }
+} 
+```
+
+3. Provide Imunify Security integration settings – create the vendor-specific configuration directory and symlink the standard Imunify Security integration file into it:
+
+```
+mkdir -p /opt/cpvendor/etc/
+```
+```
+ln -s /etc/sysconfig/imunify360/integration.conf /opt/cpvendor/etc/integration.ini
+```