Personnalisation du transfert des cookies client

Un client peut envoyer des cookies au Consommateur WSRP dans le cadre d'une requête HTTP. Vous pouvez personnaliser le Consommateur WSRP pour qu'il transfère des cookies client spécifiques aux ports Producteur ou à d'autres ressources servies par le Consommateur WSRP en tant que proxy.

Pourquoi et quand exécuter cette tâche

Par défaut, le consommateur WSRP ne transfère pas les cookies client aux producteurs WSRP ou à d'autres ressources. Pour personnaliser le consommateur WSRP afin qu'il transfère des cookies client spécifiques, procédez comme suit :

Procédure

  1. Définissez la propriété suivante dans le service client HTTP : 
    wsrp.consumer.cookieforward.cookiename = hostdomainnames [; cookiepriority]
    Vous devez définir une propriété distincte pour chaque cookie client à transférer.
  2. Redémarrez le portail ou le cluster pour que le nouveau paramètre prenne effet.

Résultats

Description :
wsrp.consumer.cookieforward.cookiename = hostdomainnames [; cookiepriority]
Cette propriété définit une règle de réacheminement de cookie pour le cookie identifié par la valeur cookiename. La règle de transfert fournit une liste de noms d'hôte et de domaine ainsi, éventuellement, qu'une priorité pour le cookie.
nom_cookie
La valeur du paramètre cookiename doit correspondre au nom exact du cookie concerné.
nom_domaine_hôte
Cette valeur est une liste de noms d'hôtes et de domaines séparés par des virgules. Le cookie est transféré aux Producteurs dont les URL d'adresse de noeud final WSRP correspondent aux entrées de la liste de noms d'hôtes et de domaines. Le consommateur WSRP transfère également les cookies client aux ressources services par le consommateur WSRP en tant que proxy et dont les URL concordent avec la liste des noms d'hôtes et de domaines. Cette liste peut contenir des noms d'hôte (alpha.company.com, par exemple) ou des noms de domaine, ces derniers étant précédés d'un point ( . ), .sample.com, par exemple. Le Consommateur WSRP fait correspondre exactement les noms d'hôtes et de domaines aux URL d'adresse de noeud final WSRP du Producteur et aux URL de ressources. Il ne convertit pas les adresses IP en noms d'hôtes et de domaines, ou vice-versa.
priorité_cookie
Ce paramètre est facultatif. Il permet de définir une priorité pour chaque cookie. Le consommateur WSRP utilise la priorité du cookie pour résoudre les conflits entre des cookies client et des cookies producteur de même nom. Les valeurs admises sont les suivantes :
clientfirst
Cette priorité définit le Consommateur WSRP pour qu'il donne la priorité à un cookie client par rapport à un cookie du même nom défini par le Producteur. En d'autres termes, il demande au Consommateur WSRP d'envoyer le cookie client au Producteur WSRP ou à la ressource du Producteur plutôt que d'envoyer le cookie du Producteur.
clientlast
Cette priorité définit le Consommateur WSRP pour qu'il donne la priorité à un cookie défini par le Producteur WSRP par rapport à un cookie client. En d'autres termes, il demande au Consommateur WSRP d'envoyer le cookie défini par le Producteur WSRP au Producteur WSRP ou à la ressource Producteur et de ne pas envoyer le cookie client. Il s'agit de la valeur de priorité par défaut. Il s'applique, par exemple, si la priorité du cookie n'est pas définie dans la règle de réacheminement des cookies.
Exemples de propriétés contenant des règles de réacheminement des cookies :
wsrp.consumer.cookieforward.SAMPLECOOKIE = alpha.company.com,.sample.org
Avec ce paramètre, le Consommateur WSRP réachemine le cookie client nommé SAMPLECOOKIE vers l'hôte alpha.company.com et vers tous les hôtes contenus dans le domaine sample.org. Il suppose que la priorité de cookie par défaut clientlast est appliquée.
wsrp.consumer.cookieforward.COOKIE2 = .myorg.com,beta.sample.com;clientfirst
Avec ce paramètre, le Consommateur WSRP réachemine le cookie client nommé COOKIE2 vers l'hôte beta.sample.com et vers tous les hôtes contenus dans le domaine myorg.com. Ce paramètre donne la priorité aux cookies client.
Remarque : Le consommateur WSRP n'envoie pas les cookies lorsqu'il demande les documents de description du service WSDL d'un producteur.