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.
Como padrão, informação de autenticação é armazaneada e reutilizada para cada requisição no processo atual. Entretanto, é possível resetar esta informação depois de cada requisição usando uma opção do comando HTTP SET OPTION. Neste caso, terá que executar o comando HTTP AUTHENTICATE antes de cada chamada HTTP Request ou HTTP Get.
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(...)