Integra a função de desbloqueio de IPs diretamente na sua aplicação web. Compatível com ASP clássico e PHP através do objeto COM da extensão.
UnlockIP(IP,Rulename)A partir da sua página web — no seu index.asp, index.php ou qualquer seção da sua aplicação — você pode chamar esta função para desbloquear programaticamente um endereço IP que tenha sido bloqueado pelo Firewall Manager. Requer credenciais válidas.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Username | String | Obrigatório | Usuário do sistema. |
| Password | String | Obrigatório | Senha do usuário. |
| FormatOutput | String | Opcional | Formato da resposta: xml (padrão) ou json. |
| IP | String | Obrigatório | Endereço IPv4 ou IPv6 que se deseja desbloquear. |
| Rulename | String | Opcional | Nome da regra que contém o IP |
Importante: Use esta função em páginas protegidas com autenticação própria. Expor a chamada sem proteção permite que qualquer usuário desbloqueie IPs arbitrários.
Instancie o objeto COM FlexFirewallManager.Admin, defina as credenciais e chame UnlockIP(). A resposta é interpretada como XML.
' Criar instância do objeto COM
Set App = CreateObject("FlexFirewallManager.Admin")
App.FormatOutput = "xml"
App.Username = "Usuário do Sistema"
App.Password = "Senha do Usuário"
' IP a desbloquear
Dim strIP : strIP = "123.123.123.123"
Dim returnstring : returnstring = App.UnlockIP(strIP)
' Interpretar resposta XML
Set objxml = CreateObject("Msxml2.DOMDocument")
objxml.LoadXml(returnstring)
If LCase(objxml.SelectSingleNode("/output/result").text) = "true" Then
Response.Write "IP Desbloqueado " & strIP
Else
Response.Write "Não foi possível desbloquear o IP " & strIP
End If
Você pode usar FormatOutput = "json" se preferir interpretar a resposta com JSON.parse em vez de XML. O formato JSON é recomendado para aplicações modernas.
Em PHP, instancie o objeto COM com new COM(). Use o formato json para interpretar a resposta diretamente com json_decode().
// Criar instância do objeto COM
$app = new COM("FlexFirewallManager.Admin");
$app->FormatOutput = "json";
$app->Username = "Usuário do Sistema";
$app->Password = "Senha do Usuário";
// IP a desbloquear
$strIP = "123.123.123.123";
$returnstring = $app->UnlockIP($strIP);
// Interpretar resposta JSON
$appjson = json_decode($returnstring);
if ($appjson->result) {
echo "IP Desbloqueado " . $strIP;
} else {
echo "Não foi possível desbloquear o IP " . $strIP;
}
Dica: Você pode combinar esta função com um formulário de administração interno para que seus usuários gerenciem por conta própria o desbloqueio do próprio IP sem precisar acessar o administrador.
Leve em conta os seguintes aspectos ao integrar esta função na sua aplicação:
UnlockIP() com uma sessão de usuário autenticado.
FlexFirewallManager.Admin requer Windows Server com a extensão instalada.