4D Doc Center : HTTP AUTHENTICATE

4D v13.4

HTTP AUTHENTICATE


HTTP AUTHENTICATE ( nombre ; clave {; metodoAut} {; *} )

Parámetro	Tipo	Descripción
nombre	Texto	Nombre de usuario
clave	Texto	Clave de usuario
metodoAut	Entero largo	Método de autenticación: 0 o se omite = no definido, 1 = BASIC, 2 = DIGEST
*	Operador	Si se pasa: autenticación por proxy

Descripción

El comando HTTP AUTHENTICATE permite efectuar peticiones HTTP a los servidores que necesitan la autenticación de la aplicación cliente. Los métodos BASIC y DIGEST son compatibles, así como también la presencia de un proxy.

En los parámetros nombre y clave, pase la información de identificación requerida(nombre de usuario y contraseña). Esta información se codifica y añade a la siguiente petición HTTP enviada utilizando el comando HTTP Request o HTTP Get, de manera que es necesario llamar al comando HTTP AUTHENTICATE antes de cada petición HTTP.

El parámetro opcional metodoAut permite indicar el método de autenticación a utilizar. Puede pasar una de las siguientes constantes, del tema HTTP Client:

Constante	Tipo	Valor	Comentario
HTTP Basic	Entero largo	1	Utilizar el método de autenticación BASIC
HTTP Digest	Entero largo	2	Utilizar el método de autenticación DIGEST

Si omite el parámetro metodoAut (o pasa 0), deja que el programa elija el método apropiado a utilizar. En este caso, 4D envía una petición adicional con el fin de negociar el método de autenticación.

Si pasa el parámetro *, indica que la información de autenticación se dirige a un proxy HTTP. Esta configuración debe implementarse cuando hay un proxy que requiere autenticación entre el cliente y el servidor HTTP. Si el servidor mismo se autentica, es necesaria una autenticación doble.

Por defecto, la información de autenticación se reinicializa después de cada petición, de manera que debe utilizar HTTP AUTHENTICATE antes de cada petición HTTP Request o HTTP Get. Sin embargo, es posible conservar temporalmente esta información utilizando una opción del comando HTTP SET OPTION. En este caso, ya no es necesario ejecutar el comando HTTP AUTHENTICATE antes de cada petición.

Ejemplo

Ejemplos de peticiones con autenticación:

  // Autenticación en un servidor HTTP en modo DIGEST

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

  // Autenticación en un proxy en modo por defecto

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

 $httpStatus:=HTTP Get(...)