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

API — Webprogrammierung

IP sperren über Cloudflare

Integriert Cloudflare zum Sperren einer IP. Kompatibel mit klassischem ASP und PHP über das COM-Objekt der Erweiterung.

Klassisches ASP PHP XML / JSON

Mit zwei zusätzlichen Codezeilen können Sie sich mit Cloudflare verbinden: CloudFlareLogin und CloudflareDomain

Funktion BlockIp(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 IP-Adresse über den Firewall Manager zu sperren. 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 sperrende IPv4- oder IPv6-Adresse.
CloudFlareLogin String Erforderlich E-Mail und Token-Schlüssel von Cloudflare
CloudflareDomain String Erforderlich In Cloudflare integrierte Domain
Rückgabewerte json/xml
result
(true oder false) Status der Sperranfrage.
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 sperren.

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" App.CloudFlareLogin("E-Mail Cloudflare" , "Token Cloudflare") App.CloudflareDomain = "Domainname" ' Zu sperrende IP Dim strIP : strIP = "123.123.123.123" Dim returnstring : returnstring = App.BlockIp(strIP)

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"; $app->CloudFlareLogin("E-Mail Cloudflare","Token Cloudflare"); $app->CloudflareDomain = "Domainname"; // Methode 2 $returnstring = $app->BlockIp($strIP); // JSON-Antwort analysieren $appjson = json_decode($returnstring); if ($appjson->result) { echo "IP gesperrt " . $strIP; }

Tipp: Sie können diese Funktion mit einem internen Verwaltungsformular kombinieren, damit Ihre Benutzer die Sperrung 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 BlockIp() 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 Sperrung nur auf die Regeln der ausgewählten Domain angewendet.