API — Programación Web

Desbloquear una IP del Firewall

Integra la función de desbloqueo de IPs directamente en tu aplicación web. Compatible con ASP clásico y PHP mediante el objeto COM de la extensión.

ASP Clásico PHP XML / JSON

Función UnlockIP(IP,Rulename)

Desde tu página web — en tu index.asp, index.php o cualquier sección de tu aplicación — puedes llamar a esta función para desbloquear programáticamente una dirección IP que haya sido bloqueada por el Firewall Manager. Requiere credenciales validas.

1 Parámetros requeridos


Parámetro Tipo Requerido Descripción
Username String Requerido Usuario del sistema.
Password String Requerido Contraseña del usuario.
FormatOutput String Opcional Formato de respuesta: xml (defecto) o json.
IP String Requerido Dirección IPv4 o IPv6 que se desea desbloquear.
Rulename String Opcional Nombre de la regla que contiene la IP
Valores de retorno XML/JSON
result
(true o false) Estado de la petición de desbloqueo.
rulename
Nombre de la regla que contenida la ip desbloqueada.
app
Sitio donde estaba bloqueada: Windows , MailEnable, Cloudflare
desc
Si el resultado es negativo, mostrará información del motivo.

Importante: Usa esta función en páginas protegidas con autenticación propia. Exponer la llamada sin protección permite que cualquier usuario desbloquee IPs arbitrarias.

2 Ejemplo en ASP Clásico


Instancia el objeto COM FlexFirewallManager.Admin, establece las credenciales y llama a UnlockIP(). La respuesta se parsea como XML.

' Crear instancia del objeto COM Set App = CreateObject("FlexFirewallManager.Admin") App.FormatOutput = "xml" App.Username = "Usuario del sistema" App.Password = "Clave del usuario" ' IP a desbloquear Dim strIP : strIP = "123.123.123.123" Dim returnstring : returnstring = App.UnlockIP(strIP) ' Parsear respuesta XML Set objxml = CreateObject("Msxml2.DOMDocument") objxml.LoadXml(returnstring) If LCase(objxml.SelectSingleNode("/output/result").text) = "true" Then Response.Write "Desbloqueada IP " & strIP Else Response.Write "Imposible desbloquear IP " & strIP End If

Puedes usar FormatOutput = "json" si prefieres parsear la respuesta con JSON.parse en lugar de XML. El formato JSON es recomendado para aplicaciones modernas.

3 Ejemplo en PHP


En PHP, instancia el objeto COM con new COM(). Usa el formato json para parsear la respuesta directamente con json_decode().

// Crear instancia del objeto COM $app = new COM("FlexFirewallManager.Admin"); $app->FormatOutput = "json"; $app->Username = "Usuario del sistema"; $app->Password = "Clave del usuario"; // IP a desbloquear $strIP = "123.123.123.123"; $returnstring = $app->UnlockIP($strIP); // Parsear respuesta JSON $appjson = json_decode($returnstring); if ($appjson->result) { echo "Desbloqueada IP " . $strIP; } else { echo "Imposible desbloquear IP " . $strIP; }

Tip: Puedes combinar esta función con un formulario de administración interno para que tus usuarios autogestionen el desbloqueo de su propia IP sin necesidad de acceder administrador.

4 Notas de implementación


Ten en cuenta los siguientes aspectos al integrar esta función en tu aplicación:

Autenticación previa Protege siempre la página que llama a UnlockIP() con sesión de usuario autenticado.
Solo en Windows Server El objeto COM FlexFirewallManager.Admin requiere Windows Server con la extensión instalada.
Credenciales seguras Nunca incluyas el usuario y la clave en el código fuente accesible públicamente. Usa variables de entorno o archivos de configuración externos.
Sincronización con Cloudflare Si tienes la integración con Cloudflare activa, el desbloqueo también eliminará la IP de las reglas de Cloudflare automáticamente.