4D Doc Center : HTTP AUTHENTIFIER

4D v14.3

HTTP AUTHENTIFIER


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

Paramètre	Type	Description
nom	Texte	Nom de l’utilisateur
motDePasse	Texte	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 HTTP AUTHENTIFIER vous permet d’effectuer des requêtes HTTP vers des serveurs 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.

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 prochaine requête HTTP envoyée via la commande HTTP Request ou HTTP Get. Il est donc nécessaire d’appeler la commande HTTP AUTHENTIFIER avant chaque requête HTTP.

Le paramètre facultatif méthodeAuth permet d’indiquer la méthode d’authentification à utiliser. Vous pouvez passer l’une des constantes suivantes, placées dans le thème Client HTTP :

Constante	Type	Valeur	Commentaire
HTTP basic	Entier long	1	Utiliser la méthode d’authentification BASIC
HTTP digest	Entier long	2	Utiliser la méthode d’authentification DIGEST

Si vous omettez le paramètre méthodeAuth (ou passez 0), vous laissez le programme 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 et le serveur HTTP. Si le serveur est lui-même authentifié, une double authentification est requise.

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

Exemple

Exemples de requêtes avec authentification :

  //Authentification sur un serveur HTTP en mode DIGEST

 HTTP AUTHENTIFIER("httpUser";"123";2)

  //Authentification sur un proxy en mode par défaut

 HTTP AUTHENTIFIER("ProxyUser";"456";*)

 $httpStatus:=HTTP Get(...)