Référence : propriétés pour le TAI (Trust Association Interceptor)

Plusieurs propriétés de configuration sont associées au TAI Authentification de base HTTP.

Les propriétés ci-dessous peuvent être configurées pour le TAI Authentification de base HTTP.

Notes :

La valeur par défaut pour chaque paramètre figure entre parenthèses.
Dans les descriptions, le terme TAI se réfère au TAI Authentification de base HTTP.

enabled = ( true )

Utilisez cette propriété pour déterminer si le TAI est actif ou non. Les valeurs possibles sont true et false. La valeur par défaut est true. Si vous définissez cette propriété sur true, le TAI authentifie les requêtes. Si la valeur false est affectée à la propriété, les requêtes ne sont pas authentifiées par le TAI.

loginTarget = ( Portal_LTPA )

Utilisez cette propriété pour spécifier l'alias de configuration de connexion utilisé par le TAI. La valeur par défaut est Portal_LTPA. Par le biais de cette valeur par défaut, le TAI se sert de la même configuration de connexion JAAS que celle qui est utilisée par la connexion à base de formulaire HTTP du portail.

authenticationRealm = ( WPS )

Utilisez cette propriété pour spécifier le nom d'un domaine d'authentification comme défini dans RFC 2617. Le TAI demande au client de s'authentifier par rapport au domaine. La valeur par défaut est WPS. Par le biais de cette valeur par défaut, le TAI se sert du même domaine d'authentification que celui qui est utilisé par la connexion à base de formulaire HTTP du portail.

userAgentBlackList = ( AllAgentsAllowed )

Utilisez cette propriété pour spécifier la liste des formats dont vous ne voulez pas que le TAI gère les requêtes. Séparez les formats par des espaces.

Chaque nom de produit figurant dans la zone d'en-tête HTTP User-Agent des requêtes entrantes est comparé aux formats spécifiés pour ce paramètre. Si le TAI est activé et que l'URL correspond à au moins l'un des formats spécifiés dans la propriété userAgentBlackList, le TAI ne gérera pas la requête.

La valeur par défaut est AllAgentsAllowed. Cette valeur par défaut signifie que la liste noire de l'agent utilisateur n'est pas active.

Vous pouvez spécifier les formats avec un astérisque (* ) comme caractère générique. Il est aussi possible de les définir comme expressions Java régulières. Dans ce cas, donnez à la propriété useRegExp la valeur true.

urlBlackList = ( /wps/myportal* )

Utilisez cette propriété pour spécifier la liste des formats dont vous ne voulez pas que le TAI gère les requêtes. Séparez les formats par des espaces.

Le chemin complet de l'URL de la requête entrante est comparé à chacun des formats spécifiés pour ce paramètre. Avant cette comparaison, toutes les informations relatives au protocole, au serveur, au port et à la requête sont supprimées de l'URL. Si le TAI est activé et que l'URL correspond à au moins l'un des formats spécifiés dans la propriété urlBlackList, le TAI ne gérera pas la requête. La valeur par défaut est /wps/myportal*.

Servez-vous des règles de syntaxe ci-après pour spécifier les formats :

Vous pouvez utiliser des formats codés URI. Ainsi, si vous voulez intégrer un caractère vierge dans un format, vous pouvez le coder en tant que %20 . Il est alors interprété comme faisant partie du format et non pas comme un séparateur de format. Ne vous servez que des caractères qui sont valides dans un identificateur URI et codez tous les autres caractères.
Vous pouvez utiliser un astérisque ( * ) comme caractère générique.
Vous pouvez définir les formats comme expressions Java régulières. Dans ce cas, donnez à la propriété useRegExp la valeur true.

userAgentWhiteList = ( NoAgentSpecified )

Utilisez cette propriété pour spécifier la liste des formats dont vous voulez que le TAI gère les requêtes. Séparez les formats par des espaces. Chaque nom de produit figurant dans la zone d'en-tête HTTP User-Agent de la requête entrante est comparé aux formats spécifiés pour ce paramètre.

Si le TAI est activé et que le format spécifié pour cette propriété a au moins une correspondance sans qu'aucune correspondance n'existe dans userAgentBlackList ou urlBlackList, le TAI gère la requête.

La valeur par défaut est NoAgentSpecified. Cette valeur par défaut signifie que la liste blanche de l'agent utilisateur n'est pas active.

urlWhiteList = ( /wps/mycontenthander* )

Utilisez cette propriété pour spécifier la liste des formats dont vous voulez que le TAI gère les requêtes. Séparez les formats par des espaces. Le chemin complet de l'URL de la requête entrante est comparé à chacun des formats spécifiés pour ce paramètre. Avant cette comparaison, toutes les informations relatives au protocole, au serveur, au port et à la requête sont supprimées de l'URL.

La valeur par défaut est /wps/mycontenthander*.

Servez-vous des règles de syntaxe ci-après pour spécifier les formats :

Vous pouvez utiliser des formats codés URI. Ainsi, si vous voulez intégrer un caractère vierge dans un format, vous pouvez le coder en tant que %20 . Il est alors interprété comme faisant partie du format et non pas comme un séparateur de format. Ne vous servez que des caractères qui sont valides dans un identificateur URI et codez tous les autres caractères.
Vous pouvez utiliser un astérisque ( * ) comme caractère générique.
Vous pouvez définir les formats comme expressions Java régulières. Dans ce cas, donnez à la propriété useRegExp la valeur true.

Remarque : Les valeurs spécifiées pour les propriétés userAgentWhiteList ou urlWhiteList ne prennent effet que si toutes les conditions ci-après sont réunies :

Le TAI est activé en spécifiant enabled = true.
Aucune des deux propriétés userAgentBlackList ou urlBlackList n'a la valeur par défaut astérisque spécifiée. Pour activer les valeurs indiquées pour les propriétés de listes blanches, vous pouvez supprimer l'astérisque des propriétés de listes noires et les laisser sans valeur.

useRegExp = ( false )

Utilisez cette propriété pour déterminer si les formats spécifiés pour les propriétés de listes noires et de listes blanches ci-dessus doivent être ou non interprétées comme expressions Java régulières. Les valeurs possibles sont true ou false. La valeur par défaut est false. La signification et les règles de syntaxe de ces valeurs sont présentées ci-dessous :

conforme

Si vous définissez la valeur de cette propriété à true, tous les formats des listes noires et blanches sont interprétés comme des expressions Java régulières (RegExp). Pour plus d'informations sur la syntaxe et l'utilisation des expressions Java régulières, consultez http://docs.oracle.com/javase/tutorial/essential/regex/. Exemples :

[^X]* trouve chaque agent utilisateur qui ne contient pas X majuscule dans son nom de produit.
.*my_browser.* trouve chaque agent utilisateur dont le nom de produit comporte my_browser.
.*%5bX%5d, qui est l'URL codée correspondant à .*[X], trouve chaque URL qui se termine par X.

false

Il s'agit de la valeur par défaut. Si la valeur pour cette propriété est définie à false, seul l'astérisque ( * ) est pris en charge par tous les formats en tant que caractère générique correspondant à n'importe quelle chaîne. Le caractère générique astérisque ( * ) peut apparaître n'importe où dans le format. Il est possible d'utiliser plusieurs caractères génériques ( * ) au sein du même format.

Si vous voulez vous servir d'un astérisque réel pour la recherche de correspondance dans le format au lieu de l'utiliser comme caractère générique, préfixez-le avec une barre oblique inversée, comme ceci : \* . Pour représenter une barre oblique inversée comme caractère d'une recherche de correspondance, codez-la en la doublant de cette façon : \\ .

Exemples :

*my_browser* trouve chaque agent utilisateur dont le nom de produit comporte my_browser.
/myprefix*mysuffix recherche chaque URL commençant par /myprefix et se terminant par mysuffix.
Fun\* Ag\\ent limite sa recherche de correspondance à l'agent utilisateur dont le nom de produit est Fun* Ag\ent.