Objeto Request - Servervariables

[Marcos-rj]

A coleção ServerVariables contém várias informações enviadas do browser do cliente e informações do servidor. Estas variáveis de ambiente são sempre criadas quando uma nova página ASP é requisitada no servidor. O uso das ServerVariables são bem útil em várias aplicações que necessitam de informações do servidor ou do navegador do cliente.

ServerVariables

A sintaxe para o uso dessa coleção é a mesma usada nas outras coleções do objeto request: (objeto.coleção("elemento")) - request.ServerVariables("variável_de_ambiente"). A varável de ambiente é uma entre as várias existentes, como por exemplo: request.ServerVariables("SCRIPT_NAME"). Este contém as informações sobre o PATH da raiz virtual do servidor até o nome do arquivo como: adm/arquivos/teste.asp. Abaixo listaremos as variáveis de ambiente dessa coleção e sua respectiva função.

ALL_HTTP - Lista todos os headers HTTP enviados pelo browser do cliente ao servidor. Informações tais como: host origem, página de origem, caracteristicas do navegador cliente, entre outras.

ALL_RAW - Retorna todas as informações enviadas por cabeçalho HTTP da página em seu estado original.

APPL_MD_PATH - Devolve o caminho lógico do arquivo ASP em questão (path do metabase).

APPL_PHYSICAL_PATH - Caminho físico do arquivo no disco. Este corresponde ao caminho lógico do APPL_MD_PATH (path do metabase).

AUTH_TYPE - Método de autenticação utilizado pelo servidor para validar usuários que solicitam um script.

AUTH_USER - Nome de usuário fornecido ao servidor em caso de não permitir acesso anônimo ao diretório. Este poderá ser o nome de um usuário de domínio ou usuário do Windows.

AUTH_PASSWORD - Senha referente ao usuário logado. Esta variável apenas se encontra disponível no modo básico de autenticação (basic authentication). Para este, é necessário o login ser feito pela caixa de diálogo ao requisitar a página.

CERT_COOKIE - ID do certificado digital do cliente.*

CERT_FLAGS - Valor de dois bits: bit 0 igual a 1 indica se o certificado do cliente está presente, bit 1 igual a 1, indica que a autoridade de certificação do certificado do cliente é inválida.*

CERT_ISSUER - Campo Issuer do certificado do cliente (O=MS, OU=IAS, CN=usuário, C=USA).*

CERT_KEYSIZE - Número de bits na chave de conexão Secure Sockets Layer - SSL. Ex.: 64, 128.*

CERT_SECRETKEYSIZE - Número de bits na chave do "Server certificate private" (chave privada).*

CERT_SERIALNUMBER - Campo Serial Number do certificado digital do cliente.*

CERT_SERVER_ISSUER - Campo Issuer do certificado do servidor.*

CERT_SERVER_SUBJECT - Campo Subject do certificado SSL do servidor.*

CERT_SUBJECT - Campo Subject do certificado do cliente.*

CONTENT_LENGTH - Tamanho em bytes, do conteúdo de uma requisição request ao servidor.

CONTENT_TYPE - Tipo de requisição enviada ao servidor pelo cliente.

GATEWAY_INTERFACE - Tipo de interface CGI usada no servidor web para manipular a solicitação (request).*

HTTP_nomeheader - Valor armazenado no header especificado. Podemos destacar os mais comuns: HTTP_ACCEPT, HTTP_ACCEPT_ENCODING, HTTP_ACCEPT_LANGUAGE, HTTP_COOKIE, HTTP_USER_AGENT, HTTP_REFERER.

HTTPS - Retorna à uma solicitação request, dizendo se o canal é seguro (ON) ou não seguro (OFF).

HTTPS_KEYSIZE - Número de bits na chave de conexão Secure Sockets Layer - SSL.*

HTTPS_SECRETKEYSIZE - Número de bits na chaver do "server certificate private".*

HTTPS_SERVER_ISSUER - Campo Issuer do certificado do servidor.*

HTTPS_SERVER_SUBJECT - Campo subject do certificado do servidor.*

INSTANCE_ID - ID, em formato texto, para a instância do Internet Information Server (IIS).*

INSTANCE_META_PATH - Path do metabase para a instância do Internet Information Server (IIS) que responde à solicitação (request).*

LOCAL_ADDR - Retorna o endereço lógico do servidor onde foi feito a requisição (o endereço do servidor onde se encontra o arquivo chamado).

LOGON_USER - Conta do usuário usada para efetuar o logon no Windows.*

PATH_INFO - Caminho virtual do arquivo que realizou a requisição, apartir da raiz do servidor. Ex.: /arquivos/documento.asp

PATH_TRANSLATED - Versão da variável "PATH_INFO" transformado em path físico.

QUERY_STRING - Retorna as variáveis passadas por cabeçalho HTTP à uma página via QueryString. Estes são apresentados apartir do ponto de interrogação - ? . Ex.: arquivo.asp?id=1&opcao=2=versao=a. Esta varável retorna: id=1&opcao=2=versao=a

REMOTE_ADDR - Retorna endereço IP da máquina cliente que requisitou algo ao servidor.

REMOTE_HOST - Nome do host que requisitou algo ao servidor.

REMOTE_USER - Nome da máquina que solicitou o arquivo asp ao servidor. Disponível somente se disponível.

REQUEST_METHOD - Método usado pela requisição ao servidor (GET ou POST)

SCRIPT_NAME - Path virtual do arquivo ASP requisitado ao servidor.

SERVER_NAME - Nome do servidor onde foi realizada a requisição (pode ser retornado o endereço IP, DNS alias ou nome do host).

SERVER_PORT - Retorna o número da porta onde foi realizada a requisição ao servidor.

SERVER_PORT_SECURE - Retorna 0 ou 1. Diz se a porta onde é recebida as solicitações pelo servidor é segura (1) ou não segura (0).

SERVER_PROTOCOL - Retorna nome e versão respectivamente do protocolo usado pelo servidor WEB para interpretar a solicitação. Ex.: HTTP/1.1

- Retorna nome e versão do servidor WEB. Ex.: Microsoft-IIS/5.1

URL - Endereço URL base requisitado (sem a QueryString) pelo browser cliente.*

As variáveis que HTTPS, provavelmente não poderão ser testadas ou usadas sem um ambiente seguro.

Vejamos abaixo como usar algumas essas variáveis:

<%
Dim variavel_1
Dim variavel_2
Dim variavel_3

variavel_1 = request.ServerVariables("LOCAL_ADDR")
variavel_2 = request.ServerVariables("REMOTE_ADDR")
variavel_3 = request.ServerVariables("PATH_INFO")

response.write("Endereço (local) Servidor: " & variavel_1)
response.write("<br>")
response.write("Endereço Cliente: " & variavel_2)
response.write("<br>")
response.write("Path raiz: " & variavel_3)
response.write("<br>")
response.write("Nome do Servidor: " & request.ServerVariables("SERVER_NAME"))
%> 

* Informações retiradas do livro "ASP - Guia de Consulta Rápida"