Règles de cookie

Les règles de cookie définissent des règles de traitement des cookies que vous utilisez dans le contexte d'une connexion HTTP sortante.

Les cookies sont définis par le serveur distant à l'aide du paramètre d'en-tête de la réponse Set-Cookie:. Les règles de cookie déterminent la gestion d'un cookie créé. La règle de cookie définit la façon dont est traité ce cookie. Les définition de règles de cookie appartiennent aux règles de stratégie. Chaque règle de stratégie définit comment gérer individuellement les cookies qui sont définis dans les connexions HTTP sortantes.

Une règle de cookie contient les paramètres suivants :
cookie names
Utilisez ce paramètre pour spécifier un ensemble d'expressions génériques qui contiennent des noms ou des modèles de nom de cookies. Par exemple, la règle de cookie avec le nom LtpaToken* s'applique à LtpaToken et LtpaToken2. Une règle de cookie appartient à une règle de proxy. Par conséquent, une règle de cookie est appliquée si les deux conditions suivantes sont vérifiées :
  • Le règle de proxy propriétaire est appliquée.
  • Le nom de cookie correspond à l'expression générique.
cookie handling
Ce paramètre permet de définir la manière dont le service de connexion HTTP sortante gère les cookies distants. Le service de connexion HTTP sortante peut gérer des cookies de différentes façons :
bloquer
Il s'agit de la valeur par défaut. Les cookies que vous définissez comme bloqués sont filtrés : ils ne sont pas renvoyés dans l'en-tête de réponse de la connexion HTTP sortante.
store in session
Les cookies sont stockés dans un magasin de cookies qui est placé dans la session HTTP locale.
store in request
Les cookies sont stockés dans un magasin de cookies qui est placé dans la demande HTTP locale.
passthru
Les cookies de type passthru sont copiés dans l'en-tête de la réponse de la connexion du proxy Ajax. Le domaine et le chemin du cookie transmis sont convertis en domaine et chemin d'accès du servlet du proxy Ajax. Le type de gestion passthru devient effectif uniquement si la connexion sortante est établie via le proxy Ajax.
boucle
Si vous utilisez des cookies de type de traitement passthru, ils peuvent provoquer un conflit avec les cookies locaux, par exemple LtpaToken, LtpaToken2 ou JSESSIONID. Dans ce cas, vous pouvez utiliser le type de gestion wrap. Les cookies de type de gestion wrap sont gérés comme des cookies en mode passthru, mais en outre, le nom du cookie est transformé.
cookie scope
Ce paramètre définit le propriétaire du cookie. Un cookie peut être associé aux portées suivantes :
user
La portée du cookie est l'utilisateur en cours.
application
Le cookie est limité à l'application qui appelle le service de connexion HTTP sortante.
system
Le cookie n'a aucune portée.
cookie transformations
Ce paramètre définit une interface de programmation. Les développeurs d'applications peuvent l'utiliser pour implémenter un gestionnaire personnalisé de transformation de cookie. Le code d'extension personnalisé est appelé dans les deux cas suivants :
  1. Avant que la connexion HTTP distante écrive l'en-tête de demande dans la connexion distante.
  2. Lorsque l'en-tête de réponse de la connexion HTTP distante est évalué.
Le gestionnaire de transformation personnalisé peut modifier le nom, la valeur, le domaine, et le chemin d'accès du cookie qui est affecté avec le gestionnaire de transformation personnalisé. Pour plus d'informations, voir la rubrique Utilisation de gestionnaires personnalisés de transformation de cookie.