Neue Erweiterung für Plesk. Antivirenschutz zur Verbesserung der Serversicherheit. Warum Flex Antivirus wählen?

API — Webprogrammierung

Plesk-Dienstprogramm - RPC — XML-Pakete

Das XML-API-Protokoll ermöglicht die Remote-Interaktion zwischen Plesk und Drittanwendungen über strukturierte HTTP-Pakete. Senden Sie Ihre Nachricht an den Plesk-Endpunkt, erhalten Sie die Antwort des Vorgangs und verwalten Sie Firewall-Regeln programmatisch, ohne auf die Weboberfläche zuzugreifen.

Windows Server XML-API Plesk RPC HTTP/HTTPS

Was ist die XML-RPC-API von Firewall Manager?

Das XML-API-Protokoll wurde entwickelt, um die Remote-Interaktion zwischen Plesk und Drittanbieter-Software zu unterstützen. Um einen Vorgang auszuführen, müssen Sie eine HTTP-Nachricht mit einer bestimmten Struktur an den Plesk-Endpunkt senden: https://<ihr-host-oder-IP>:8443/enterprise/control/agent.php. Plesk empfängt die Nachricht, wandelt sie in Betriebsanweisungen um, führt sie aus und gibt Status und Details des Ergebnisses zurück. Weitere Informationen zur Paketstruktur und Nachrichtenübertragung finden Sie im Client-Server-Modell und den XML-API-Paketen.

XML-API-Endpunkt

POST https://<ihr-host-oder-IP>:8443/enterprise/control/agent.php

Vollständige Referenz der CLI-RPC-Pakete


Befehl Parameterbeschreibung Beispiel eines XML-Pakets
Verwaltung von IP-Adressen
<add>
Eine IP-Adresse zu einer Firewall-Regel hinzufügen.
Erfordert die Angabe der Regel-ID als XML-Element:
<RULEID>IP</RULEID>
1.2.3.4 zur Regel SMTP hinzufügen:
<packet><extension><call><flex-firewall-manager><add><SMTP>1.2.3.4</SMTP></add></flex-firewall-manager></call></extension></packet>
<remove>
Eine IP-Adresse aus einer Firewall-Regel entfernen.
Erfordert die Angabe der Regel-ID als XML-Element:
<RULEID>IP</RULEID>
1.2.3.4 aus der Regel SMTP entfernen:
<packet><extension><call><flex-firewall-manager><remove><SMTP>1.2.3.4</SMTP></remove></flex-firewall-manager></call></extension></packet>
<find>
Eine IP-Adresse in den Windows-Firewall-Regeln oder in den MailEnable-Listen suchen.
Erfordert die Angabe des Suchkontexts:
-firewall  -mailenable
<PARAM>IP</PARAM>
1.2.3.4 in der Firewall suchen:
<packet><extension><call><flex-firewall-manager><find><firewall>1.2.3.4</firewall></find></flex-firewall-manager></call></extension></packet>
1.2.3.4 in MailEnable suchen:
<packet><extension><call><flex-firewall-manager><find><mailenable>1.2.3.4</mailenable></find></flex-firewall-manager></call></extension></packet>
<whitelist>
Eine IP-Adresse zur Ausnahmeliste (Whitelist) hinzufügen.
IPs in der Whitelist werden vom automatischen Schutzsystem niemals gesperrt.
<whitelist>IP</whitelist>
1.2.3.4 zur Whitelist hinzufügen:
<packet><extension><call><flex-firewall-manager><whitelist>1.2.3.4</whitelist></flex-firewall-manager></call></extension></packet>
Verwaltung der Firewall-Regeln
<enable>
Eine Firewall-Regel aktivieren.
Erfordert die Angabe der Regel-ID <RULEID>.
<enable>RULEID</enable>
Regel SMTP aktivieren:
<packet><extension><call><flex-firewall-manager><enable>SMTP</enable></flex-firewall-manager></call></extension></packet>
<disable>
Eine Firewall-Regel deaktivieren.
Erfordert die Angabe der Regel-ID <RULEID>.
<disable>RULEID</disable>
Regel SMTP deaktivieren:
<packet><extension><call><flex-firewall-manager><disable>SMTP</disable></flex-firewall-manager></call></extension></packet>
<list>
Die Liste der verfügbaren Regeln oder ihrer IDs anzeigen.
Unterstützte Werte: id  exist
<list>ID</list>
Liste der Regel-IDs abrufen:
<packet><extension><call><flex-firewall-manager><list>id</list></flex-firewall-manager></call></extension></packet>
Namen vorhandener Regeln auflisten:
<packet><extension><call><flex-firewall-manager><list>exist</list></flex-firewall-manager></call></extension></packet>
Systemsteuerung und Status
<on>
Die Windows-Firewall aktivieren oder die Firewall-Manager-Erweiterung aktivieren.
Unterstützte Werte: firewall  extension
<on>ID</on>
Windows-Firewall aktivieren:
<packet><extension><call><flex-firewall-manager><on>firewall</on></flex-firewall-manager></call></extension></packet>
Erweiterung aktivieren:
<packet><extension><call><flex-firewall-manager><on>extension</on></flex-firewall-manager></call></extension></packet>
<off>
Die Windows-Firewall deaktivieren oder die Firewall-Manager-Erweiterung deaktivieren.
Unterstützte Werte: firewall  extension
<off>ID</off>
Windows-Firewall deaktivieren:
<packet><extension><call><flex-firewall-manager><off>firewall</off></flex-firewall-manager></call></extension></packet>
Erweiterung deaktivieren:
<packet><extension><call><flex-firewall-manager><off>extension</off></flex-firewall-manager></call></extension></packet>
<status>
Den Status der Firewall, der Erweiterung oder der aktiven Schutzmodule abfragen.
Unterstützte Werte: firewall extension protection mailenable smartermail
<status>ID</status>
Status der Windows-Firewall:
<packet><extension><call><flex-firewall-manager><status>firewall</status></flex-firewall-manager></call></extension></packet>
Status der Erweiterung:
<packet><extension><call><flex-firewall-manager><status>extension</status></flex-firewall-manager></call></extension></packet>
Status aller Schutzmodule auflisten:
<packet><extension><call><flex-firewall-manager><status>protection</status></flex-firewall-manager></call></extension></packet>
Status des MailEnable-Dienstes:
<packet><extension><call><flex-firewall-manager><status>mailenable</status></flex-firewall-manager></call></extension></packet>
Status des SmarterMail-Dienstes:
<packet><extension><call><flex-firewall-manager><status>smartermail</status></flex-firewall-manager></call></extension></packet>
Schutzmodule
<protection>
Den Aktiv-/Inaktiv-Status eines bestimmten Schutzmoduls umschalten.
Erfordert die Angabe des umzuschaltenden Moduls:
SMTP IMAP POP FTP SECURITY DB RDP WEB
<protection>ID</protection>
Modul SMTP umschalten:
<packet><extension><call><flex-firewall-manager><protection>SMTP</protection></flex-firewall-manager></call></extension></packet>
Modul RDP umschalten:
<packet><extension><call><flex-firewall-manager><protection>RDP</protection></flex-firewall-manager></call></extension></packet>
Hilfe
<help>
Die integrierte Hilfe mit allen verfügbaren Paketen und deren Beschreibung anzeigen.
Vollständige Hilfe anzeigen:
<packet><extension><call><flex-firewall-manager><help/></flex-firewall-manager></call></extension></packet>