API — Programação Web

Variáveis ASP e PHP — Módulo IIS

Acesse a partir da sua página web as variáveis de servidor injetadas pelo Módulo IIS do Firewall Manager. Obtenha o host, o IP, o país e o código ASN do visitante em tempo real.

ASP Clássico PHP Módulo IIS Server Variables

Dentro da sua página web — por exemplo index.asp ou index.php — você pode acessar as variáveis de servidor injetadas pelo Módulo IIS do Firewall Manager para obter informações enriquecidas sobre cada solicitação recebida. É necessário ter o Módulo IIS ativo para dispor dessas variáveis.

Variáveis disponíveis


Variável Descrição
HTTP_X_FIREWALL_HOST Nome de host do servidor associado à solicitação recebida.
HTTP_X_FIREWALL_IP Endereço IP real do visitante, incluindo suporte para IPv4 e IPv6.
HTTP_X_FIREWALL_COUNTRY Código de país ISO 3166-1 alpha-2 correspondente ao IP do visitante (ex: PT, US, CN).
HTTP_X_FIREWALL_ASN Número de Sistema Autônomo (ASN) associado ao IP do visitante. Permite identificar o provedor ou a rede de origem.

Exemplo em ASP Clássico


Acesse as variáveis através do objeto Request.ServerVariables a partir de qualquer página .asp:

' Ler variáveis de servidor injetadas pelo Módulo IIS response.write "<br>Host : " & Request.ServerVariables("HTTP_X_FIREWALL_HOST") response.write "<br>IP : " & Request.ServerVariables("HTTP_X_FIREWALL_IP") response.write "<br>País : " & Request.ServerVariables("HTTP_X_FIREWALL_COUNTRY") response.write "<br>ASN : " & Request.ServerVariables("HTTP_X_FIREWALL_ASN")

Exemplo em PHP


Acesse as mesmas variáveis através da superglobal $_SERVER a partir de qualquer arquivo .php:

// Ler variáveis de servidor injetadas pelo Módulo IIS echo "<br>Host : " . $_SERVER["HTTP_X_FIREWALL_HOST"]; echo "<br>IP : " . $_SERVER["HTTP_X_FIREWALL_IP"]; echo "<br>País : " . $_SERVER["HTTP_X_FIREWALL_COUNTRY"]; echo "<br>ASN : " . $_SERVER["HTTP_X_FIREWALL_ASN"];

Variável HTTP_X_FIREWALL_ASN


O código ASN (Autonomous System Number) identifica a rede ou provedor de internet ao qual pertence o IP do visitante. É especialmente útil para bloquear intervalos de IPs associados a provedores de hospedagem, redes de bots ou regiões específicas sem a necessidade de especificar cada IP individual.

Lista completa de códigos ASN

Você pode consultar a lista de identificadores ASN disponíveis no seguinte link:
https://2ip.io/analytics/asn-list/

Requisito: Você deve ter ativado o Módulo IIS na configuração do Firewall Manager para que essas variáveis estejam disponíveis nas solicitações HTTP. Sem o módulo ativo, as variáveis retornarão um valor vazio.

Essas variáveis são especialmente úteis para implementar lógica personalizada na sua aplicação web: mostrar conteúdo diferente com base no país do visitante, bloquear o acesso a áreas de administração a partir de determinados intervalos ASN, ou registrar no seu próprio banco de dados as informações geográficas de cada acesso.