WEB SERVICE AUTHENTICATE

4D v16.3


WEB SERVICE AUTHENTICATE ( nombre ; contraseña {; metAutenticacion} {; *} )

Parámetro	Tipo	Descripción
nombre	Cadena	Nombre del usuario
contraseña	Cadena	Contraseña del usuario
metAutenticacion	Entero largo	Método de Autenticación 0 u omitido = no especificado, 1 = BASIC, 2 = DIGEST
*	Operador	Si se pasa: autenticación por proxy

Descripción

El comando WEB SERVICE AUTHENTICATE permite utilizar los servicios web que necesitan de la autenticación de la aplicación cliente. Los métodos BASIC y DIGEST son soportados.

Nota: para más información sobre los métodos de autenticación BASIC y DIGEST, por favor revise la sección Seguridad de las conexiones.

En los parámetros nombre y contraseña, pase la información de identificación requerida (nombre de usuario y contraseña). Esta información será codificada y añadida a la petición HTTP enviada al servicio web utilizando el comando WEB SERVICE CALL. Es entonces necesario llamar al comando WEB SERVICE AUTHENTICATE antes de llamar al comando WEB SERVICE CALL.

La información de autenticación se reinicializa en cero después de cada petición. Por lo tanto, debe utilizar el comando WEB SERVICE AUTHENTICATE antes de llamar al comando WEB SERVICE CALL.

El parámetro opcional metAutenticacion permite indicar el método de autenticación a utilizar para la próxima llamada del comando WEB SERVICE CALL. Puede pasar uno de los siguientes valores:

2 = utilizar el método de autenticación DIGEST
1 = utilizar el método de autenticación BASIC
0 (ó se omite el parámetro) = utilizar el método apropiado. En este caso, 4D envía una petición adicional para negociar el método de autenticación.

Por defecto, la información de autenticación se reinicia después de cada petición. Por lo tanto, debe utilizar el comando WEB SERVICE AUTHENTICATE antes de cada comando WEB SERVICE CALL. Sin embargo es posible conservar temporalmente esta información utilizando una opción del comando WEB SERVICE SET OPTION. En este caso, no es necesario ejecutar el comando WEB SERVICE AUTHENTICATE antes de cada WEB SERVICE CALL.

Si la autenticación falla, el servidor SOAP devuelve un error que puede identificar utilizando el comando WEB SERVICE Get info.

Ejemplo

Autenticación con un servicio web ubicado detrás de un proxy:

  // Autenticación al servicio web en modo DIGEST

 WEB SERVICE AUTHENTICATE("SoapUser";"123";2)

  // Autenticación al proxy en modo por defecto

 WEB SERVICE AUTHENTICATE("ProxyUser";"456";*)

 WEB SERVICE CALL(...)

Ver también

WEB SERVICE CALL
WEB SERVICE Get info