4D Doc Center : AUTHENTICATE WEB SERVICE

4D v12.4

AUTHENTICATE WEB SERVICE


AUTHENTICATE WEB SERVICE ( 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 AUTHENTICATE WEB SERVICE 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 CONFIRM.

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 CALL WEB SERVICE. Es entonces necesario llamar al comando AUTHENTICATE WEB SERVICE antes de llamar al comando CALL WEB SERVICE.

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

El parámetro opcional metAutenticacion permite indicar el método de autenticación a utilizar para la próxima llamada del comando CALL WEB SERVICE. 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 AUTHENTICATE WEB SERVICE antes de cada comando CALL WEB SERVICE. Sin embargo es posible conservar temporalmente esta información utilizando una opción del comando SET WEB SERVICE OPTION. En este caso, no es necesario ejecutar el comando AUTHENTICATE WEB SERVICE antes de cada CALL WEB SERVICE.

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

Ejemplo

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

  `Autenticación al servicio web en modo DIGEST

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

  `Autenticación al proxy en modo por defecto

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

 CALL WEB SERVICE(...)