4D Doc Center : AUTHENTIFIER WEB SERVICE

4D v12.4

AUTHENTIFIER WEB SERVICE


AUTHENTIFIER WEB SERVICE ( nom ; motDePasse {; méthodeAuth} {; *} )

Paramètre	Type	Description
nom	Chaîne	Nom de l’utilisateur
motDePasse	Chaîne	Mot de passe de l’utilisateur
méthodeAuth	Entier long	Méthode d’authentification : 0 ou omis=non définie, 1=BASIC, 2=DIGEST
*	Opérateur	Si passé : authentification par proxy

Description

La commande AUTHENTIFIER WEB SERVICE vous permet d’utiliser des Web Services nécessitant l’authentification de l’application cliente. Les méthodes BASIC et DIGEST sont prises en charge ainsi que la présence d'un proxy.

Note : Pour plus d’informations sur les méthodes d’authentification BASIC et DIGEST, reportez-vous à la section CONFIRMER.

Passez dans les paramètres nom et motDePasse les informations d’identification requises (nom d’utilisateur et mot de passe). Ces informations seront encodées et ajoutées à la requête HTTP envoyée au Web Service via la commande APPELER WEB SERVICE. Il est donc nécessaire d’appeler la commande AUTHENTIFIER WEB SERVICE avant la commande APPELER WEB SERVICE.

Le paramètre facultatif méthodeAuth permet d’indiquer la méthode d’authentification à utiliser pour le prochain appel de la commande APPELER WEB SERVICE. Vous pouvez passer l’une des valeurs suivantes :

2 = utiliser la méthode d’authentification DIGEST
1 = utiliser la méthode d’authentification BASIC
0 (ou paramètre omis) = utiliser la méthode appropriée. Dans ce cas, 4D envoie une requête supplémentaire afin de négocier la méthode d'authentification.

Si vous passez le paramètre *, vous indiquez que les informations d’authentification s’adressent à un proxy HTTP. Ce paramétrage doit être mis en oeuvre lorsqu’il existe un proxy nécessitant une authentification entre le client du Web Service et le Web Service lui-même. Si le Web Service est lui-même authentifié, une double authentification est requise (cf. exemple).

Par défaut, les informations d’authentification sont réinitialisées après chaque requête. Vous devez donc utiliser la commande AUTHENTIFIER WEB SERVICE avant chaque APPELER WEB SERVICE. Il est toutefois possible de conserver temporairement ces informations à l'aide d'une option de la commande FIXER OPTION WEB SERVICE. Dans ce cas, il n'est pas nécessaire d'exécuter la commande AUTHENTIFIER WEB SERVICE avant chaque APPELER WEB SERVICE.

En cas d’échec de l’authentification, le serveur SOAP retourne une erreur que vous pouvez identifier à l’aide de la commande Lire infos erreur Web Service.

Exemple

Authentification auprès d’un Web Service situé derrière un proxy :

  `Authentification au Web Service en mode DIGEST

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

  `Authentification au proxy en mode par défaut

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

 APPELER WEB SERVICE(...)