Nouvelle Extension pour Plesk. Protection Antivirus pour améliorer la sécurité de votre serveur. Pourquoi choisir Flex Antivirus?

API — Programmation Web

Utilitaire Plesk - RPC — Paquets XML

Le protocole API XML permet l'interaction distante entre Plesk et des applications tierces via des paquets HTTP structurés. Envoyez votre message au point de terminaison de Plesk, recevez la réponse de l'opération et gérez les règles du pare-feu par programmation sans accéder à l'interface web.

Windows Server API XML Plesk RPC HTTP/HTTPS

Qu'est-ce que l'API XML RPC de Firewall Manager ?

Le protocole API XML a été conçu pour prendre en charge l'interaction entre Plesk et des logiciels tiers à distance. Pour effectuer une opération, vous devez envoyer un message HTTP avec une structure spécifique au point de terminaison de Plesk : https://<your-host-or-IP>:8443/enterprise/control/agent.php. Plesk reçoit le message, le transforme en instructions d'opération, les exécute et retourne les statuts et détails du résultat. Pour plus d'informations sur la structure des paquets et le transport des messages, consultez le Modèle Client-Serveur et Paquets API XML.

Point de terminaison de l'API XML

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

Référence complète des paquets CLI RPC


Commande Description des paramètres Exemple de paquet XML
Gestion des adresses IP
<add>
Ajouter une adresse IP à une règle du pare-feu.
Nécessite de spécifier l'identifiant de règle comme élément XML :
<RULEID>IP</RULEID>
Ajouter 1.2.3.4 à la règle SMTP :
<packet><extension><call><flex-firewall-manager><add><SMTP>1.2.3.4</SMTP></add></flex-firewall-manager></call></extension></packet>
<remove>
Supprimer une adresse IP d'une règle du pare-feu.
Nécessite de spécifier l'identifiant de règle comme élément XML :
<RULEID>IP</RULEID>
Supprimer 1.2.3.4 de la règle SMTP :
<packet><extension><call><flex-firewall-manager><remove><SMTP>1.2.3.4</SMTP></remove></flex-firewall-manager></call></extension></packet>
<find>
Rechercher une adresse IP dans les règles du pare-feu Windows ou dans les listes de MailEnable.
Nécessite de spécifier le contexte de recherche :
-firewall  -mailenable
<PARAM>IP</PARAM>
Rechercher 1.2.3.4 dans le pare-feu :
<packet><extension><call><flex-firewall-manager><find><firewall>1.2.3.4</firewall></find></flex-firewall-manager></call></extension></packet>
Rechercher 1.2.3.4 dans MailEnable :
<packet><extension><call><flex-firewall-manager><find><mailenable>1.2.3.4</mailenable></find></flex-firewall-manager></call></extension></packet>
<whitelist>
Ajouter une adresse IP à la liste d'exceptions (whitelist).
Les IP figurant dans la whitelist ne seront jamais bloquées par le système de protection automatique.
<whitelist>IP</whitelist>
Ajouter 1.2.3.4 à la whitelist :
<packet><extension><call><flex-firewall-manager><whitelist>1.2.3.4</whitelist></flex-firewall-manager></call></extension></packet>
Gestion des règles du pare-feu
<enable>
Activer une règle du pare-feu.
Nécessite de spécifier l'identifiant de règle <RULEID>.
<enable>RULEID</enable>
Activer la règle SMTP :
<packet><extension><call><flex-firewall-manager><enable>SMTP</enable></flex-firewall-manager></call></extension></packet>
<disable>
Désactiver une règle du pare-feu.
Nécessite de spécifier l'identifiant de règle <RULEID>.
<disable>RULEID</disable>
Désactiver la règle SMTP :
<packet><extension><call><flex-firewall-manager><disable>SMTP</disable></flex-firewall-manager></call></extension></packet>
<list>
Afficher la liste des règles disponibles ou leurs identifiants.
Valeurs prises en charge : id  exist
<list>ID</list>
Obtenir la liste des identifiants de règle :
<packet><extension><call><flex-firewall-manager><list>id</list></flex-firewall-manager></call></extension></packet>
Lister les noms de règles existantes :
<packet><extension><call><flex-firewall-manager><list>exist</list></flex-firewall-manager></call></extension></packet>
Contrôle du système et état
<on>
Activer le pare-feu Windows ou activer l'extension Firewall Manager.
Valeurs prises en charge : firewall  extension
<on>ID</on>
Activer le pare-feu Windows :
<packet><extension><call><flex-firewall-manager><on>firewall</on></flex-firewall-manager></call></extension></packet>
Activer l'extension :
<packet><extension><call><flex-firewall-manager><on>extension</on></flex-firewall-manager></call></extension></packet>
<off>
Désactiver le pare-feu Windows ou désactiver l'extension Firewall Manager.
Valeurs prises en charge : firewall  extension
<off>ID</off>
Désactiver le pare-feu Windows :
<packet><extension><call><flex-firewall-manager><off>firewall</off></flex-firewall-manager></call></extension></packet>
Désactiver l'extension :
<packet><extension><call><flex-firewall-manager><off>extension</off></flex-firewall-manager></call></extension></packet>
<status>
Consulter l'état du pare-feu, de l'extension ou des modules de protection actifs.
Valeurs prises en charge : firewall extension protection mailenable smartermail
<status>ID</status>
État du pare-feu Windows :
<packet><extension><call><flex-firewall-manager><status>firewall</status></flex-firewall-manager></call></extension></packet>
État de l'extension :
<packet><extension><call><flex-firewall-manager><status>extension</status></flex-firewall-manager></call></extension></packet>
Lister l'état de toutes les protections :
<packet><extension><call><flex-firewall-manager><status>protection</status></flex-firewall-manager></call></extension></packet>
État du service MailEnable :
<packet><extension><call><flex-firewall-manager><status>mailenable</status></flex-firewall-manager></call></extension></packet>
État du service SmarterMail :
<packet><extension><call><flex-firewall-manager><status>smartermail</status></flex-firewall-manager></call></extension></packet>
Modules de protection
<protection>
Basculer l'état actif/inactif d'un module de protection spécifique.
Nécessite d'indiquer quel module changer d'état :
SMTP IMAP POP FTP SECURITY DB RDP WEB
<protection>ID</protection>
Basculer le module SMTP :
<packet><extension><call><flex-firewall-manager><protection>SMTP</protection></flex-firewall-manager></call></extension></packet>
Basculer le module RDP :
<packet><extension><call><flex-firewall-manager><protection>RDP</protection></flex-firewall-manager></call></extension></packet>
Aide
<help>
Afficher l'aide intégrée avec tous les paquets disponibles et leur description.
Afficher l'aide complète :
<packet><extension><call><flex-firewall-manager><help/></flex-firewall-manager></call></extension></packet>