Intègre la fonction de déblocage d'IP directement dans votre application web. Compatible avec ASP classique et PHP via l'objet COM de l'extension.
UnlockIP(IP,Rulename)Depuis votre page web — dans votre index.asp, index.php ou toute section de votre application — vous pouvez appeler cette fonction pour débloquer par programmation une adresse IP qui a été bloquée par le Firewall Manager. Nécessite des identifiants valides.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| Username | String | Requis | Utilisateur du système. |
| Password | String | Requis | Mot de passe de l'utilisateur. |
| FormatOutput | String | Optionnel | Format de réponse : xml (défaut) ou json. |
| IP | String | Requis | Adresse IPv4 ou IPv6 à débloquer. |
| Rulename | String | Optionnel | Nom de la règle contenant l'IP |
Important : Utilisez cette fonction sur des pages protégées par votre propre authentification. Exposer cet appel sans protection permet à n'importe quel utilisateur de débloquer des IP arbitraires.
Instanciez l'objet COM FlexFirewallManager.Admin, définissez les identifiants et appelez UnlockIP(). La réponse est analysée en tant que XML.
' Créer l'instance de l'objet COM
Set App = CreateObject("FlexFirewallManager.Admin")
App.FormatOutput = "xml"
App.Username = "Utilisateur du système"
App.Password = "Mot de passe de l'utilisateur"
' IP à débloquer
Dim strIP : strIP = "123.123.123.123"
Dim returnstring : returnstring = App.UnlockIP(strIP)
' Analyser la réponse XML
Set objxml = CreateObject("Msxml2.DOMDocument")
objxml.LoadXml(returnstring)
If LCase(objxml.SelectSingleNode("/output/result").text) = "true" Then
Response.Write "IP débloquée " & strIP
Else
Response.Write "Impossible de débloquer l'IP " & strIP
End If
Vous pouvez utiliser FormatOutput = "json" si vous préférez analyser la réponse avec JSON.parse plutôt qu'en XML. Le format JSON est recommandé pour les applications modernes.
En PHP, instanciez l'objet COM avec new COM(). Utilisez le format json pour analyser la réponse directement avec json_decode().
// Créer l'instance de l'objet COM
$app = new COM("FlexFirewallManager.Admin");
$app->FormatOutput = "json";
$app->Username = "Utilisateur du système";
$app->Password = "Mot de passe de l'utilisateur";
// IP à débloquer
$strIP = "123.123.123.123";
$returnstring = $app->UnlockIP($strIP);
// Analyser la réponse JSON
$appjson = json_decode($returnstring);
if ($appjson->result) {
echo "IP débloquée " . $strIP;
} else {
echo "Impossible de débloquer l'IP " . $strIP;
}
Astuce : Vous pouvez combiner cette fonction avec un formulaire d'administration interne afin que vos utilisateurs gèrent eux-mêmes le déblocage de leur propre IP sans avoir à accéder à l'administrateur.
Tenez compte des aspects suivants lors de l'intégration de cette fonction dans votre application :
UnlockIP() par une session utilisateur authentifiée.
FlexFirewallManager.Admin nécessite Windows Server avec l'extension installée.