Integriert die IP-Entsperrfunktion direkt in Ihre Webanwendung. Kompatibel mit klassischem ASP und PHP über das COM-Objekt der Erweiterung.
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.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| Username | String | Erforderlich | Systembenutzer. |
| Password | String | Erforderlich | Passwort des 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 |
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.
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 = "Systembenutzer"
App.Password = "Passwort des Benutzers"
' 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.
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 = "Systembenutzer";
$app->Password = "Passwort des Benutzers";
// 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 die Verwaltung zugreifen zu müssen.
Beachten Sie Folgendes bei der Integration dieser Funktion in Ihre Anwendung:
UnlockIP() aufruft, stets durch eine authentifizierte Benutzersitzung.
FlexFirewallManager.Admin erfordert Windows Server mit installierter Erweiterung.