4D Doc Center : HTTP AUTHENTICATE

4D v14.3

HTTP AUTHENTICATE


HTTP AUTHENTICATE ( nome ; senha {; metodoAut} {; *} )

Parâmetro	Tipo	Descrição
nome	Texto	Nome de usuário
senha	Texto	Senha de usuário
metodoAut	Inteiro longo	Método de autenticação: 0 ou se omite = não definido, 1 = BASIC, 2 = DIGEST
*	Operador	Se passado: autenticação por proxy

Descrição

O comando HTTP AUTHENTICATE permite fazer petições HTTP aos servidores que necessitam a autenticação da aplicação cliente. Os métodos BASIC e DIGEST são compatíveis, assim como também a presença de um proxy.

Nos parâmetros nome e senha, passe a informação de identificação requerida(nome de usuário e senha). Esta informação é codificada e agregada à seguinte petição HTTP enviada utilizando o comando HTTP Request ou HTTP Get, portanto é necessário chamar ao comando HTTP AUTHENTICATE antes de cada petição HTTP.

O parâmetro opcional metodoAut permite indicar o método de autenticação a utilizar. Pode passar uma das seguintes constantes, do tema HTTP Client:

Constante	Tipo	Valor	Comentário
HTTP basic	Inteiro longo	1	Utilizar o método de autenticação BASIC
HTTP digest	Inteiro longo	2	Utilizar o método de autenticação DIGEST

Se omite o parâmetro metodoAut (ou passa 0), deixa que o programa escolha o método apropriado a utilizar. Neste caso, 4D envia uma petição adicional com o fim de negociar o método de autenticação.

Se passado o parâmetro *, indica que a informação de autenticação é dirigida a um proxy HTTP. Esta configuração deve ser implantada quando existe um proxy que requer autenticação entre o cliente e o servidor HTTP. Caso o mesmo servidor seja autenticado, é necessário uma dupla autenticação.

Por defeito, a informação de autenticação é reinicializada depois de cada petição, portanto você deve utilizar HTTP AUTHENTICATE antes de cada petição HTTP Request ou HTTP Get. Entretanto, é possível conservar temporariamente esta informação utilizando uma opção do comando HTTP SET OPTION. Neste caso, não é mais necessário executar o comando HTTP AUTHENTICATE antes de cada petição.

Exemplo

Exemplos de petições com autenticação:

  // Autenticação em um servidor HTTP em modo DIGEST

 HTTP AUTHENTICATE("httpUser";"123";2)

  // Autenticação em um proxy em modo por defeito

 HTTP AUTHENTICATE("ProxyUser";"456";*)

 $httpStatus:=HTTP Get(...)