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

API — Webprogrammierung

IP entsperren in der Firewall

Integriert die IP-Entsperrfunktion direkt in Ihre Webanwendung. Kompatibel mit klassischem ASP und PHP über das COM-Objekt der Erweiterung.

Klassisches ASP PHP XML / JSON

Funktion UnlockIP(IP,Rulename)

Von Ihrer Webseite aus — in Ihrer index.asp, index.php oder einem beliebigen Teil Ihrer Anwendung — können Sie diese Funktion aufrufen, um eine vom Firewall Manager gesperrte IP-Adresse programmatisch zu entsperren. Erfordert gültige Zugangsdaten einer Plesk-Domain.

1 Erforderliche Parameter


Parameter Typ Erforderlich Beschreibung
Username String Erforderlich Plesk-Domain-Benutzer mit Zugriff auf die Erweiterung.
Password String Erforderlich Passwort des Plesk-Domain-Benutzers.
FormatOutput String Optional Antwortformat: xml (Standard) oder json.
IP String Erforderlich Zu entsperrende IPv4- oder IPv6-Adresse.
Rulename String Optional Name der Regel, die die IP enthält
Rückgabewerte XML/JSON
result
(true oder false) Status der Entsperranfrage.
rulename
Name der Regel, die die entsperrte IP enthielt.
app
Ort, an dem die IP gesperrt wurde: Windows, MailEnable, Cloudflare
desc
Bei negativem Ergebnis werden Informationen zum Grund angezeigt.

Wichtig: Verwenden Sie diese Funktion nur auf Seiten, die durch eine eigene Authentifizierung geschützt sind. Ein ungeschützter Aufruf ermöglicht es jedem Benutzer, beliebige IPs zu entsperren.

2 Beispiel in klassischem ASP


Instanziieren Sie das COM-Objekt FlexFirewallManager.Admin, legen Sie die Zugangsdaten fest und rufen Sie UnlockIP() auf. Die Antwort wird als XML analysiert.

' COM-Objektinstanz erstellen Set App = CreateObject("FlexFirewallManager.Admin") App.FormatOutput = "xml" App.Username = "Plesk-Domain-Benutzer" App.Password = "Passwort Plesk-Domain" ' Zu entsperrende IP Dim strIP : strIP = "123.123.123.123" Dim returnstring : returnstring = App.UnlockIP(strIP) ' XML-Antwort analysieren Set objxml = CreateObject("Msxml2.DOMDocument") objxml.LoadXml(returnstring) If LCase(objxml.SelectSingleNode("/output/result").text) = "true" Then Response.Write "IP entsperrt " & strIP Else Response.Write "IP " & strIP & " konnte nicht entsperrt werden" End If

Sie können FormatOutput = "json" verwenden, wenn Sie die Antwort lieber mit JSON.parse statt XML analysieren möchten. Das JSON-Format wird für moderne Anwendungen empfohlen.

3 Beispiel in PHP


Instanziieren Sie in PHP das COM-Objekt mit new COM(). Verwenden Sie das Format json, um die Antwort direkt mit json_decode() zu analysieren.

// COM-Objektinstanz erstellen $app = new COM("FlexFirewallManager.Admin"); $app->FormatOutput = "json"; $app->Username = "Plesk-Domain-Benutzer"; $app->Password = "Passwort Plesk-Domain"; // Zu entsperrende IP $strIP = "123.123.123.123"; $returnstring = $app->UnlockIP($strIP); // JSON-Antwort analysieren $appjson = json_decode($returnstring); if ($appjson->result) { echo "IP entsperrt " . $strIP; } else { echo "IP " . $strIP . " konnte nicht entsperrt werden"; }

Tipp: Sie können diese Funktion mit einem internen Verwaltungsformular kombinieren, damit Ihre Benutzer die Entsperrung ihrer eigenen IP selbst verwalten können, ohne auf das Plesk-Panel zugreifen zu müssen.

4 Hinweise zur Implementierung


Beachten Sie Folgendes bei der Integration dieser Funktion in Ihre Anwendung:

Vorherige Authentifizierung Schützen Sie die Seite, die UnlockIP() aufruft, stets durch eine authentifizierte Benutzersitzung.
Nur unter Windows Server Das COM-Objekt FlexFirewallManager.Admin erfordert Windows Server mit installierter Erweiterung.
Sichere Zugangsdaten Fügen Sie Benutzername und Passwort niemals in öffentlich zugänglichen Quellcode ein. Verwenden Sie Umgebungsvariablen oder externe Konfigurationsdateien.
Synchronisierung mit Cloudflare Bei aktivierter Cloudflare-Integration wird die IP bei der Entsperrung automatisch auch aus den Cloudflare-Regeln entfernt.