Paramètres Fabriques de connexions J2C

Cette page permet de définir les paramètres d'une fabrique de connexions.

Pour afficher cette page de la console d'administration, cliquez sur Ressources > Adaptateurs de ressources > adaptateur_ressources > Fabriques de connexions J2C > fabrique_connexions.

Onglet Configuration

Portée
Indique à quel niveau cette définition de ressource est visible : cellule, noeud ou serveur.

Des ressources telles que les fournisseurs JDBC, les liaisons d'espace de noms et les bibliothèques partagées peuvent être définies à plusieurs niveaux. Dans ce cas, pour une ressource donnée, la définition figurant au niveau le plus spécifique (par exemple, le serveur) l'emporte sur l'éventuelle définition homologue figurant à un niveau plus général (par exemple, la cellule).

Notez que quelle que soit la portée d'une ressource définie, les propriétés de cette ressource s'appliquent uniquement au niveau d'un serveur individuel. Par exemple, si vous définissez la portée d'une source de données au niveau cellule, tous les utilisateurs de cette cellule peuvent rechercher et utiliser cette source de données, laquelle est unique au sein de cette cellule. Cependant, les paramètres de propriété de la ressource sont locaux à chaque serveur de la cellule. Par exemple, si vous attribuez la valeur 10 à la propriété Nombre maximal de connexions, chaque serveur de cette cellule pourra avoir 10 connexions.

Cellule
Niveau de portée le plus général. Les ressources définies au niveau cellule sont visibles depuis tous les noeuds et serveurs de cette cellule, sauf si elles sont redéfinies à un niveau inférieur. Pour visualiser les ressources définies au niveau cellule, ne spécifiez pas de nom de serveur ni de nom de noeud dans le formulaire de sélection de portée.
Noeud
Portée par défaut de la plupart des types de ressources. Les ressources définies au niveau noeud l'emportent sur les éventuelles définitions homologues figurant au niveau cellule et sont visibles depuis tous les serveurs du noeud considéré, sauf si elles sont redéfinies à un niveau serveur sur ce noeud. Pour visualiser les ressources définies au niveau d'un noeud, ne spécifiez pas de serveur dans le formulaire de sélection de portée ; spécifiez simplement le nom du noeud concerné.
Serveur
Niveau de portée le plus spécifique pour la définition des ressources. Les ressources définies au niveau d'un serveur l'emportent sur les éventuelles définitions homologues apparaissant au niveau de la cellule parente ou du noeud parent ; elles sont visibles uniquement depuis ce serveur. Pour visualiser les ressources définies au niveau d'un serveur, spécifiez le nom de ce serveur ainsi que celui de son noeud parent dans le formulaire de sélection de portée.

Lorsque des ressources sont créées, elles le sont toujours dans la portée en cours, c'est-à-dire celle qui est sélectionnée dans le formulaire. Pour afficher les ressources d'autres portées, spécifiez un noeud ou un serveur différent dans le formulaire de sélection de portée.

Type de données String (chaîne)
Nom
Indique la liste des noms affichés de la fabrique de connexions.
Type de données String (chaîne)
Nom JNDI
Indique le nom JNDI de cette fabrique de connexions.

Par exemple, vous pouvez indiquer le nom eis/myECIConnection.

Une fois la valeur définie, sauvegardez-la et redémarrez le serveur. Cette chaîne doit apparaître lorsque vous exécutez dumpNameSpace.

Type de données String (chaîne)
Valeur par défaut eis/nom_affiché
Description
Texte décrivant cette fabrique de connexions.
Type de données String (chaîne)
Catégorie
Chaîne que vous pouvez utiliser pour classifier ou grouper cette fabrique de connexions.
Type de données String (chaîne)
Préférences d'authentification
Indique les mécanismes d'authentification définis pour cette fabrique de connexions.

Cette option indique quel mécanisme d'authentification défini pour l'adaptateur de ressources correspondant s'applique à cette fabrique de connexions. Les valeurs applicables en fonction des capacités de l'adaptateur de ressources sont KERBEROS, MOT_PASSE_BASE et Aucun.

Si vous sélectionnez Aucun, le composant d'application doit gérer l'authentification (<res-auth>Application</res-auth>). Dans ce cas, l'ID utilisateur et le mot de passe sont extraits des éléments suivants :

  • l'alias d'authentification géré par composant,
  • les propriétés personnalisées du nom d'utilisateur et du mot de passe,
  • les chaînes transmises dans la méthode getConnection.

Par exemple, si deux mécanismes d'authentification sont définis pour un adaptateur de ressources dans le document ra.xml :

  • <authentication-mechanism-type>BasicPassword</authentication-mechanism-type>
  • <authentication-mechanism-type>Kerbv5</authentication-mechanism-type>
Les préférences d'authentification définissent le mécanisme à utiliser pour l'authentification gérée par conteneur. Une exception est générée lors du démarrage du serveur si vous avez sélectionné un mécanisme qui n'est pas pris en charge par l'adaptateur de ressources.

Type de données Liste de sélection
Valeur par défaut MOT_PASSE_BASE
Alias d'authentification géré par composant
Définit les données d'authentification pour la connexion gérée par composant établie avec la ressource. Faites votre choix parmi les alias figurant sous Sécurité > Configuration JAAS > Données d'authentification J2C.

Pour définir un alias qui n'apparaît pas dans la liste, procédez comme suit :

  • Cliquez sur Valider pour afficher les rubriques connexes.
  • Cliquez sur >Entrées des données d'autorisation J2C.
  • Définissez un alias.
  • Cliquez sur le nom de la fabrique de connexions dans la partie supérieure de la page Entrées des données d'autorisation J2C pour revenir à la page de la fabrique de connexions.
  • Sélectionnez l'alias.

Type de données Liste de sélection
Alias d'authentification géré par conteneur
Indique les données d'authentification (chaîne de caractères convertie en ID utilisateur et mot de passe) gérées par conteneur pour une connexion à la ressource. Faites votre choix parmi les alias figurant sous Sécurité > Configuration JAAS > Données d'authentification J2C.

Pour définir un alias qui n'apparaît pas dans la liste, procédez comme suit :

  • Cliquez sur Valider pour afficher les rubriques connexes.
  • Cliquez sur >Entrées des données d'autorisation J2C.
  • Définissez un alias.
  • Cliquez sur le nom de la fabrique de connexions dans la partie supérieure de la page Entrées des données d'autorisation J2C pour revenir à la page de la fabrique de connexions.
  • Sélectionnez l'alias.

Type de données Liste de sélection
Alias de configuration de mappage
Permet aux utilisateurs de faire leur choix dans la liste Sécurité > Configuration JAAS > Configuration de connexion de l'application.

La configuration JAAS DefaultPrincipalMapping associe l'alias de connexion à l'ID utilisateur et au mot de passe. Vous pouvez définir et utiliser d'autres configurations de mappage.

Type de données Liste de sélection

Informations connexes

Boutons de la console administrative
Caractéristiques de la page de la console d'administration