Nuova Estensione per Plesk. Protezione Antivirus per migliorare la sicurezza del tuo server. Perché scegliere Flex Antivirus?

API — Programmazione Web

Sblocca un IP dal Firewall

Integra la funzione di sblocco degli IP direttamente nella tua applicazione web. Compatibile con ASP classico e PHP tramite l'oggetto COM dell'estensione.

ASP Classico PHP XML / JSON

Funzione UnlockIP(IP,Rulename)

Dalla tua pagina web — nel tuo index.asp, index.php o in qualsiasi sezione della tua applicazione — puoi chiamare questa funzione per sbloccare in modo programmatico un indirizzo IP bloccato dal Firewall Manager. Richiede credenziali di un dominio valido in Plesk.

1 Parametri richiesti


Parametro Tipo Obbligatorio Descrizione
Username String Obbligatorio Utente del dominio Plesk con accesso all'estensione.
Password String Obbligatorio Password dell'utente del dominio Plesk.
FormatOutput String Facoltativo Formato della risposta: xml (predefinito) o json.
IP String Obbligatorio Indirizzo IPv4 o IPv6 da sbloccare.
Rulename String Facoltativo Nome della regola che contiene l'IP
Valori di ritorno XML/JSON
result
(true o false) Stato della richiesta di sblocco.
rulename
Nome della regola che conteneva l'IP sbloccato.
app
Sito in cui era bloccato: Windows, MailEnable, Cloudflare
desc
Se il risultato è negativo, mostrerà informazioni sul motivo.

Importante: Usa questa funzione in pagine protette con autenticazione propria. Esporre la chiamata senza protezione permette a qualsiasi utente di sbloccare IP arbitrari.

2 Esempio in ASP Classico


Istanzia l'oggetto COM FlexFirewallManager.Admin, imposta le credenziali e chiama UnlockIP(). La risposta viene analizzata come XML.

' Crea istanza dell'oggetto COM Set App = CreateObject("FlexFirewallManager.Admin") App.FormatOutput = "xml" App.Username = "Utente Dominio Plesk" App.Password = "Password Dominio Plesk" ' IP da sbloccare Dim strIP : strIP = "123.123.123.123" Dim returnstring : returnstring = App.UnlockIP(strIP) ' Analizza risposta XML Set objxml = CreateObject("Msxml2.DOMDocument") objxml.LoadXml(returnstring) If LCase(objxml.SelectSingleNode("/output/result").text) = "true" Then Response.Write "IP Sbloccato " & strIP Else Response.Write "Impossibile sbloccare l'IP " & strIP End If

Puoi usare FormatOutput = "json" se preferisci analizzare la risposta con JSON.parse invece di XML. Il formato JSON è consigliato per le applicazioni moderne.

3 Esempio in PHP


In PHP, istanzia l'oggetto COM con new COM(). Usa il formato json per analizzare la risposta direttamente con json_decode().

// Crea istanza dell'oggetto COM $app = new COM("FlexFirewallManager.Admin"); $app->FormatOutput = "json"; $app->Username = "Utente Dominio Plesk"; $app->Password = "Password Dominio Plesk"; // IP da sbloccare $strIP = "123.123.123.123"; $returnstring = $app->UnlockIP($strIP); // Analizza risposta JSON $appjson = json_decode($returnstring); if ($appjson->result) { echo "IP Sbloccato " . $strIP; } else { echo "Impossibile sbloccare l'IP " . $strIP; }

Suggerimento: Puoi combinare questa funzione con un modulo di amministrazione interno affinché i tuoi utenti possano autogestire lo sblocco del proprio IP senza dover accedere al pannello Plesk.

4 Note di implementazione


Tieni presente i seguenti aspetti quando integri questa funzione nella tua applicazione:

Autenticazione preliminare Proteggi sempre la pagina che chiama UnlockIP() con una sessione utente autenticata.
Solo su Windows Server L'oggetto COM FlexFirewallManager.Admin richiede Windows Server con l'estensione installata.
Credenziali sicure Non includere mai nome utente e password nel codice sorgente accessibile pubblicamente. Usa variabili d'ambiente o file di configurazione esterni.
Sincronizzazione con Cloudflare Se hai l'integrazione con Cloudflare attiva, lo sblocco rimuoverà automaticamente l'IP anche dalle regole di Cloudflare.