WEB GET OPTION and WEB SET OPTION

4D v15



	WEB GET OPTION ( sélecteur ; valeur ) WEB SET OPTION ( sélecteur ; valeur )

Description

Introduit dans 4D v14 R3

Un nouvelle valeur de sélecteur est disponible pour les commandes WEB GET OPTION et WEB SET OPTION :

Constante	Type	Valeur
Web activer validation adresse IP de session	Entier long	83

Portée : serveur Web local
Conservé entre deux sessions : Non
Description : Permet de désactiver ou d'activer la validation des adresses IP pour les cookies de session. Pour des raisons de sécurité, par défaut le serveur Web de 4D vérifie l'adresse IP de chaque requête contenant un cookie de session et rejette la requête si cette adresse elle ne correspond pas à l'adresse IP utilisée pour créer le cookie. Dans certaines applications spécifiques, vous pouvez souhaiter désactiver cette validation et accepter les cookies de session même si les adresses IP ne correspondent pas. Par exemple, lorsque les appareils mobiles basculent du réseau Wifi au réseau 3G/4G, leur adresse IP change. Dans ce cas, vous pouvez passer 0 dans cette option afin de permettre aux clients de pouvoir continuer à utiliser leur session Web même après changement d'adresse IP. Notez que ce paramétrage abaisse le niveau de sécurité de votre application.
Lorsqu'il est modifié, ce paramétrage est effectif immédiatement (il n'est pas nécessaire de redémarrer le serveur HTTP).
Valeurs possibles : 0 (désactivé) ou 1 (activé)
Valeur par défaut : 1 (les adresses IP sont vérifiées)

Description

Une nouvelle constante est disponible dans 4D v15 pour le paramètre sélecteur : Web debug log (84).

Ce sélecteur vous permet de lire ou de définir le statut du nouveau fichier d'historique de requêtes HTTP du serveur Web 4D. Lorsqu'il est activé, ce fichier, nommé "HTTPDebugLog_nn.txt", est stocké dans le dossier "Logs" de l'application (nn est le numéro de fichier). L'historique des requêtes HTTP est particulièrement utile dans le contexte du débogage du serveur Web. Il stocke en texte brut chaque requête et chaque réponse. La totalité des requêtes, en-têtes compris, est enregistrée ; en option, il est possible d'enregistrer également le corps (body) des requêtes.

Lorsque vous passez Web debug log dans le paramètre sélecteur, le paramètre valeur peut contenir diverses valeurs, en fonction des informations à enregistrer. Vous pouvez utiliser l'une des nouvelles constantes suivantes, ajoutées dans le thème "Serveur Web" :

Constante (valeur)	Type	Description
wdl désactiver log (0)	Entier long	Le fichier d'historique de requêtes HTTP Web est désactivé
wdl activer sans body (1)	Entier long	Le fichier d'historique de requêtes HTTP Web est activé sans les body (la taille des body est fournie dans ce cas)
wdl activer avec body response (3)	Entier long	Le fichier d'historique de requêtes HTTP Web est activé avec le body de la réponse uniquement
wdl activer avec body request (5)	Entier long	Le fichier d'historique de requêtes HTTP Web est activé avec le body de la requête uniquement
wdl activer avec tous body (7)	Entier long	Le fichier d'historique de requêtes HTTP Web est activé avec les body de la requête et de la réponse

Note : Le fichier d'historique de requêtes HTTP peut être activé ou désactivé uniquement via la commande WEB SET OPTION.

Exemple 1

  // Désactivation de la validation des adresses IP dans les cookies

 WEB SET OPTION(Web session enable IP address validation;0)

 ... // code spécifique

  // Valider les adresses

 WEB SET OPTION(Web session enable IP address validation;1)

Exemple 2

Activation du fichier d'historique de debug des requêtes HTTP, sans les parties body :

WEB SET OPTION(Web debug log;wdl enable without body)

Voici un exemple d'entrée enregistrée dans le fichier d'historique :

# REQUEST
# SocketID: 1592
# PeerIP: 127.0.0.1
# PeerPort: 54912
# TimeStamp: 39089388
GET /4DWEBTEST HTTP/1.1
Connection: Close
Host: 127.0.0.1
User-Agent: 4D_HTTP_Client/0.0.0.0

# RESPONSE
# SocketID: 1592
# PeerIP: 127.0.0.1
# PeerPort: 54912
# TimeStamp: 39089389 (elapsed time: 1 ms)
HTTP/1.1 200 OK
Accept-Ranges: bytes
Connection: close
Content-Length: 3555
Content-Type: text/plain; charset=UTF-8
Date: Tue, 20 Jan 2015 10:51:29 GMT
Expires: Tue, 20 Jan 2015 10:51:29 GMT
Pragma: no-cache
Server: 4D/14.6.0

[Body Size: 3555]