Nuova Estensione per Plesk. Protezione Antivirus per migliorare la sicurezza del tuo server. Perché scegliere Flex Antivirus?

API — Programmazione Web

Utility Plesk - RPC — Pacchetti XML

Il protocollo API XML consente l'interazione remota tra Plesk e applicazioni di terze parti tramite pacchetti HTTP strutturati. Invia il tuo messaggio all'endpoint di Plesk, ricevi la risposta dell'operazione e gestisci le regole del firewall in modo programmatico senza accedere all'interfaccia web.

Windows Server API XML Plesk RPC HTTP/HTTPS

Cos'è l'API XML RPC di Firewall Manager?

Il protocollo API XML è stato progettato per supportare l'interazione tra Plesk e software di terze parti in modalità remota. Per eseguire un'operazione, è necessario inviare un messaggio HTTP con una struttura specifica all'endpoint di Plesk: https://<your-host-or-IP>:8443/enterprise/control/agent.php. Plesk riceve il messaggio, lo trasforma in istruzioni operative, le esegue e restituisce lo stato e i dettagli del risultato. Per maggiori informazioni sulla struttura dei pacchetti e sul trasporto dei messaggi, consulta Modello Client-Server e Pacchetti API XML.

Endpoint dell'API XML

POST https://<your-host-or-IP>:8443/enterprise/control/agent.php

Riferimento completo dei pacchetti CLI RPC


Comando Descrizione dei Parametri Esempio di pacchetto XML
Gestione degli indirizzi IP
<add>
Aggiungi un indirizzo IP a una regola del firewall.
Richiede di specificare l'identificatore della regola come elemento XML:
<RULEID>IP</RULEID>
Aggiungi 1.2.3.4 alla regola SMTP:
<packet><extension><call><flex-firewall-manager><add><SMTP>1.2.3.4</SMTP></add></flex-firewall-manager></call></extension></packet>
<remove>
Rimuovi un indirizzo IP da una regola del firewall.
Richiede di specificare l'identificatore della regola come elemento XML:
<RULEID>IP</RULEID>
Rimuovi 1.2.3.4 dalla regola SMTP:
<packet><extension><call><flex-firewall-manager><remove><SMTP>1.2.3.4</SMTP></remove></flex-firewall-manager></call></extension></packet>
<find>
Cerca un indirizzo IP nelle regole del Firewall di Windows o negli elenchi di MailEnable.
Richiede di specificare il contesto di ricerca:
-firewall  -mailenable
<PARAM>IP</PARAM>
Cerca 1.2.3.4 nel Firewall:
<packet><extension><call><flex-firewall-manager><find><firewall>1.2.3.4</firewall></find></flex-firewall-manager></call></extension></packet>
Cerca 1.2.3.4 in MailEnable:
<packet><extension><call><flex-firewall-manager><find><mailenable>1.2.3.4</mailenable></find></flex-firewall-manager></call></extension></packet>
<whitelist>
Aggiungi un indirizzo IP alla lista delle eccezioni (whitelist).
Gli IP nella whitelist non verranno mai bloccati dal sistema di protezione automatica.
<whitelist>IP</whitelist>
Aggiungi 1.2.3.4 alla whitelist:
<packet><extension><call><flex-firewall-manager><whitelist>1.2.3.4</whitelist></flex-firewall-manager></call></extension></packet>
Gestione delle regole del firewall
<enable>
Attiva una regola del firewall.
Richiede di specificare l'identificatore della regola <RULEID>.
<enable>RULEID</enable>
Attiva la regola SMTP:
<packet><extension><call><flex-firewall-manager><enable>SMTP</enable></flex-firewall-manager></call></extension></packet>
<disable>
Disattiva una regola del firewall.
Richiede di specificare l'identificatore della regola <RULEID>.
<disable>RULEID</disable>
Disattiva la regola SMTP:
<packet><extension><call><flex-firewall-manager><disable>SMTP</disable></flex-firewall-manager></call></extension></packet>
<list>
Mostra l'elenco delle regole disponibili o dei loro identificatori.
Valori accettati: id  exist
<list>ID</list>
Ottieni l'elenco degli identificatori delle regole:
<packet><extension><call><flex-firewall-manager><list>id</list></flex-firewall-manager></call></extension></packet>
Elenca i nomi delle regole esistenti:
<packet><extension><call><flex-firewall-manager><list>exist</list></flex-firewall-manager></call></extension></packet>
Controllo del sistema e dello stato
<on>
Attiva il Firewall di Windows o abilita l'estensione Firewall Manager.
Valori accettati: firewall  extension
<on>ID</on>
Attiva il Firewall di Windows:
<packet><extension><call><flex-firewall-manager><on>firewall</on></flex-firewall-manager></call></extension></packet>
Abilita l'estensione:
<packet><extension><call><flex-firewall-manager><on>extension</on></flex-firewall-manager></call></extension></packet>
<off>
Disattiva il Firewall di Windows o disabilita l'estensione Firewall Manager.
Valori accettati: firewall  extension
<off>ID</off>
Disattiva il Firewall di Windows:
<packet><extension><call><flex-firewall-manager><off>firewall</off></flex-firewall-manager></call></extension></packet>
Disabilita l'estensione:
<packet><extension><call><flex-firewall-manager><off>extension</off></flex-firewall-manager></call></extension></packet>
<status>
Controlla lo stato del Firewall, dell'estensione o dei moduli di protezione attivi.
Valori accettati: firewall extension protection mailenable smartermail
<status>ID</status>
Stato del Firewall di Windows:
<packet><extension><call><flex-firewall-manager><status>firewall</status></flex-firewall-manager></call></extension></packet>
Stato dell'estensione:
<packet><extension><call><flex-firewall-manager><status>extension</status></flex-firewall-manager></call></extension></packet>
Elenca lo stato di tutte le protezioni:
<packet><extension><call><flex-firewall-manager><status>protection</status></flex-firewall-manager></call></extension></packet>
Stato del servizio MailEnable:
<packet><extension><call><flex-firewall-manager><status>mailenable</status></flex-firewall-manager></call></extension></packet>
Stato del servizio SmarterMail:
<packet><extension><call><flex-firewall-manager><status>smartermail</status></flex-firewall-manager></call></extension></packet>
Moduli di protezione
<protection>
Attiva/disattiva lo stato di un modulo di protezione specifico.
Richiede di indicare quale modulo cambiare di stato:
SMTP IMAP POP FTP SECURITY DB RDP WEB
<protection>ID</protection>
Attiva/disattiva il modulo SMTP:
<packet><extension><call><flex-firewall-manager><protection>SMTP</protection></flex-firewall-manager></call></extension></packet>
Attiva/disattiva il modulo RDP:
<packet><extension><call><flex-firewall-manager><protection>RDP</protection></flex-firewall-manager></call></extension></packet>
Aiuto
<help>
Mostra la guida integrata con tutti i pacchetti disponibili e la loro descrizione.
Mostra la guida completa:
<packet><extension><call><flex-firewall-manager><help/></flex-firewall-manager></call></extension></packet>