versión 11.3 (Modificado)
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 | |||
* | * | 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 (autenticación simple). Los métodos BASIC y DIGEST son soportados.
Nota: para más información sobre los protocolos de autenticación BASIC y DIGEST, por favor revise la sección Connection Security.
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 OPTION SERVICE. 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.
Ver también
CALL WEB SERVICE, Get Web Service error info.