4D v16.3

WEB SERVICE AUTHENTIFIER

Accueil

 
4D v16.3
WEB SERVICE AUTHENTIFIER

WEB SERVICE AUTHENTIFIER 


 

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

La commande WEB SERVICE AUTHENTIFIER 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 Sécurité des connexions.

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 WEB SERVICE APPELER. Il est donc nécessaire d’appeler la commande WEB SERVICE AUTHENTIFIER avant la commande WEB SERVICE APPELER.

Le paramètre facultatif méthodeAuth permet d’indiquer la méthode d’authentification à utiliser pour le prochain appel de la commande  WEB SERVICE APPELER. 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 WEB SERVICE AUTHENTIFIER avant chaque WEB SERVICE APPELER. Il est toutefois possible de conserver temporairement ces informations à l'aide d'une option de la commande  WEB SERVICE FIXER OPTION. Dans ce cas, il n'est pas nécessaire d'exécuter la commande WEB SERVICE AUTHENTIFIER avant chaque WEB SERVICE APPELER.

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

Exemple  

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

  //Authentification au Web Service en mode DIGEST
 WEB SERVICE AUTHENTIFIER("SoapUser";"123";2)
  //Authentification au proxy en mode par défaut
 WEB SERVICE AUTHENTIFIER("ProxyUser";"456";*)
 WEB SERVICE APPELER(...)



Voir aussi  

WEB SERVICE APPELER
WEB SERVICE Lire infos

 
PROPRIÉTÉS 

Produit : 4D
Thème : Web Services (Client)
Numéro : 786
Nom intl. : WEB SERVICE AUTHENTICATE

 
HISTORIQUE 

Modifié : 4D v11 SQL Release 3
Renommé : 4D v13

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)