Configuration du connecteur

Après l'installation des fichiers de connecteur sur votre système à l'aide du programme d'installation, vous devez définir les propriétés de configuration standard et spécifiques d'application pour le connecteur.

Définition des propriétés de configuration

Les connecteurs ont deux types de propriétés de configuration : les propriétés standard et les propriétés spécifiques. Vous devez définir les valeurs de ces propriétés à l'aide de System Manager (SM) avant d'exécuter le connecteur.

Propriétés standard de configuration

Les propriétés standard de configuration fournissent des informations utilisées par tous les connecteurs. Voir l'Annexe A. Propriétés de configuration standard pour les connecteurs pour plus d'informations sur ces propriétés. Le tableau donne des informations spécifiques à ce connecteur et concernant les propriétés de configuration de l'annexe.

Propriété Description
CharacterEncoding

Le connecteur n'utilise pas cette propriété.

Locale

Ce connecteur n'étant pas internationalisé, vous ne pouvez pas modifier la valeur de cette propriété. Voir les notes d'informations concernant le connecteur pour connaître les paramètres régionaux pris en charge.

Du fait que ce connecteur ne prend en charge qu'InterChange Server (ICS) comme courtier d'intégration, les seules propriétés de configuration appropriées concernent ICS.

Vous devez définir au moins les propriétés standard de configuration du connecteur :

Propriétés de configuration spécifiques au connecteur

Les propriétés de configuration spécifiques au connecteur fournissent des informations requises par l'agent du connecteur au moment de l'exécution. Les propriétés spécifiques au connecteur permettent également de modifier les informations statiques ou logiques dans l'agent du connecteur sans devoir le recoder et le recompiler.

Le tableau 33 dresse la liste des propriétés de configuration spécifiques au connecteur. Pour obtenir une explication des propriétés, voir les sections suivantes. Certaines propriétés contiennent elles-mêmes d'autres propriétés. Le caractère + indique la position de l'entrée dans la hiérarchie des propriétés.

Tableau 33. Propriétés de configuration spécifiques au connecteur
Nom Valeurs possibles Valeur par défaut Obligatoire
DataHandlerMetaObjectName Nom du méta-objet du gestionnaire de données MO_DataHandler_ Default Oui
UseDefaults UseDefaults false Non
JavaProtocolHandlerPackages Packages du gestionnaire de protocole Java valides com.ibm.net.ssl. internal.www.protocol Non
ProtocolHandlerFramework Il s'agit d'une propriété hiérarchique ne possédant pas de valeur Néant Non
+ProtocolHandlers Il s'agit d'une propriété hiérarchique ne possédant pas de valeur Non
++Handler1 Il s'agit d'une propriété hiérarchique. Pour plus d'informations sur ses sous-propriétés, voir Handler1. Oui
+++Protocol http Oui
+++HandlerSpecific Chaque gestionnaire de protocole peut posséder des propriétés obligatoires.
ProtocolListenerFramework Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Non
+WorkerThreadCount Entier supérieur ou égal à 1 définissant le nombre d'unités d'exécution disponibles du programme d'écoute. 10 Non
+RequestPoolSize Entier supérieur à WorkerThreadCount indiquant la taille du pool de ressources. 20 Non
+ProtocolListeners Il s'agit d'une propriété hiérarchique ne possédant pas de valeur
++Listener1 Programme d'écoute de protocole portant un nom unique Oui
+++Protocol http ou https Oui
+++ListenerSpecific Propriétés uniques du programme d'écoute ou requises par celui-ci. Voir ListenerSpecific.
ProxyServer Il s'agit d'une propriété hiérarchique ne possédant pas de valeur Non
+HttpProxyHost Nom d'hôte du serveur proxy HTTP Non
+HttpProxyPort Numéro de port du serveur proxy HTTP 80 Non
+HttpNonProxyHosts Hôte(s) HTTP nécessitant une connexion directe Non
+HttpsProxyHost Nom d'hôte du serveur proxy HTTPS Non
+HttpsProxyPort Numéro de port du serveur proxy HTTPS 443 Non
+HttpsNonProxyHosts Hôte(s) HTTPS nécessitant une connexion directe Non
+SocksProxyHost Nom du serveur proxy Socks Non
+SocksProxyPort Port du serveur proxy Socks Non
+HttpProxyUsername Nom d'utilisateur du serveur proxy Http Non
+HttpProxyPassword Mot de passe du serveur proxy Http Non
+HttpsProxyUsername Nom d'utilisateur du serveur proxy Https Non
+HttpsProxyPassword Mot de passe du serveur proxy Https Non
SSL Il s'agit d'une propriété hiérarchique ne possédant pas de valeur Non
+SSLVersion SSL, SSLv2, SSLv3, TLS, TLSv1 SSL Non
+SSLDebug true, false false Non
+KeyStoreType N'importe quel type de magasin de clés correct JKS Non
+KeyStore Chemin d'accès du fichier KeyStore Non
+KeyStorePassword Mot de passe de clé privée dans KeyStore Non
+KeyStoreAlias Alias pour une paire de clés dans KeyStore Non
+TrustStore Chemin d'accès au fichier TrustStore Non
+TrustStorePassword Mot de passe de TrustStore Non
+UseClientAuth true false false Non
DataHandlerMetaObjectName

Il s'agit du nom du méta-objet utilisé par le gestionnaire de données pour définir les propriétés de configuration.

Default = MO_DataHandler_Default.

UseDefaults

Dans une opération Request Processing, si UseDefaults est défini sur true, le connecteur contrôle si une valeur valide ou une valeur par défaut est fournie pour chaque attribut d'objet métier isRequired. Si une valeur est indiquée, l'opération Request Processing réussit. Si le paramètre est défini sur false, le contrôleur cherche uniquement une valeur valide et entraîne l'échec de l'opération s'il n'en trouve pas.

Valeur par défaut = false.

JavaProtocolHandlerPackages

La valeur de cette propriété définit les packages Java Protocol Handler. Le connecteur utilise la valeur de cette propriété pour définir la propriété système java.protocol.handler.pkgs.

Default = com.ibm.net.ssl.internal.www.protocol.

ProtocolHandlerFramework

La structure Protocol Handler Framework utilise cette propriété pour charger et configurer ses gestionnaires de protocole. Il s'agit d'une propriété hiérarchique ne possédant pas de valeur.

Valeur par défaut = none.

ProtocolHandlers

Cette propriété hiérarchique ne possède pas de valeur. Ses enfants de premier niveau représentent des gestionnaires de protocole discrets.

Valeur par défaut = none.

Handler1

Nom d'un gestionnaire de protocole HTTP-HTTPS. Il s'agit d'une propriété hiérarchique. A la différence des programmes d'écoute, les gestionnaires de protocole ne peuvent être dupliqués et on ne compte qu'un gestionnaire par protocole. Le tableau 34 représente les sous-propriétés du gestionnaire de protocole HTTP-HTTPS. Le caractère + indique la position de l'entrée dans la hiérarchie des propriétés.

Tableau 34. Propriétés de configuration du gestionnaire de protocole HTTP-HTTPS
Nom Valeurs possibles Valeur par défaut Obligatoire
++HTTPHTTPSHandler Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Oui
+++Protocol Type du protocole implémenté par le gestionnaire. Pour HTTP et HTTPS, la valeur est http.
Remarque :
Si vous n'indiquez pas de valeur pour cette propriété, le connecteur n'initialisera pas le gestionnaire de protocole.
http Oui
+++HTTPReadTimeout Propriété spécifique à HTTP qui indique l'intervalle du délai (en millisecondes) lors de la lecture depuis l'hôte éloigné. Si cette propriété n'est pas indiquée ou définie à 0, le protocole HTTP-HTTPS bloque indéfiniment lors de la lecture depuis l'hôte éloigné. 0 Non
Protocol

La valeur de cette propriété fournit le protocole que doit implémenter le gestionnaire.

HandlerSpecific

Cette propriété indique toute propriété obligatoire du gestionnaire de protocole.

ProtocolListenerFramework

La structure du programme d'écoute du protocole utilise cette propriété pour charger des programmes d'écoute de protocole. Il s'agit d'une propriété hiérarchique ne possédant pas de valeur.

WorkerThreadCount

Cette propriété, qui doit être un entier supérieur ou égal à 1, établit le nombre d'unités d'exécution de travail du programme d'écoute de protocole disponibles pour la structure du programme d'écoute de protocole. Pour plus d'informations, voir Programmes d'écoute de protocole. Default = 10.

RequestPoolSize

Cette propriété, qui doit être un entier supérieur à WorkerThreadCount, définit la taille du pool de ressources de la structure du programme d'écoute de protocole. La structure peut traiter simultanément le nombre maximal de demandes défini par la somme de WorkerThreadCount et de RequestPoolSize.

Default = 20.

ProtocolListeners

Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Chaque enfant de premier niveau de cette propriété représente un programme d'écoute de protocole discret.

Listener1

Nom d'un programme d'écoute de protocole. Il peut exister plusieurs programmes d'écoute de protocole. Il s'agit d'une propriété hiérarchique. Vous pouvez créer plusieurs instances de cette propriété et créer des programmes d'écoute portant chacun un nom différent. Dans ce cas, vous pouvez modifier les propriétés du programme d'écoute et non pas la propriété de protocole. Chaque nom de programme d'écoute doit être unique. Noms possibles (il ne s'agit pas de valeurs): HTTPListener1, HTTPSListener1.

Protocol

Cette propriété indique le protocole implémenté par le programme d'écoute. Valeurs possibles : http, https.

Remarque :
Si vous n'indiquez pas de valeur pour cette propriété, le connecteur n'initialisera pas le programme d'écoute de protocole.
ListenerSpecific

Les propriétés spécifiques du programme d'écoute sont spécifiques au programme d'écoute de protocole indiqué ou requises par celui-ci. Par exemple, le programme d'écoute HTTP possède une propriété qui lui est spécifique, Port, qui représente le numéro de port sur lequel il contrôle les demandes. Le tableau 35 dresse la liste des propriétés spécifiques au programme d'écoute HTTP-HTTPS. Le caractère + indique la position de l'entrée dans la hiérarchie des propriétés.

Tableau 35. Propriétés de configuration spécifiques au programme d'écoute du protocole HTTP et HTTPS
Nom Valeurs possibles Valeur par défaut Obligatoire
+++HTTPListener1 Nom unique d'un programme d'écoute de protocole HTTP. Il s'agit d'un enfant de la propriété hiérarchique ProtocolListenerFramework -> ProtocolListeners. Plusieurs programmes d'écoute peuvent exister : vous avez la possibilité de brancher des programmes d'écoute HTTP supplémentaires en créant une autre instance de cette propriété et la hiérarchie correspondante. Oui
++++Protocol http s'il s'agit d'un programme d'écoute de protocole HTTP
https s'il s'agit d'un programme d'écoute de protocole HTTPS
Remarque :
Si vous n'indiquez pas de valeur pour cette propriété, le connecteur n'initialisera pas le programme d'écoute de protocole.
Oui
++++HostInfoValidation FailRequest - si les informations hôte/port de la demande ne correspondent pas aux informations hôte/port du programme d'écoute, un message d'erreur est consigné et la demande échoue avec le code état 400 (demande erronée).

LogError - si les informations hôte/port de la demande ne correspondent pas aux informations hôte/port du programme d'écoute, le message d'erreur est consigné et l'exécution de la demande se poursuit.

Ignore - aucune validation n'est réalisée sur les informations hôte/port de la demande.

Remarque : Si la propriété n'existe pas, les programmes d'écoute HTTP(S) règlent la propriété sur FailRequest. Si la propriété ne possède pas de valeur correcte, le programme d'écoute HTTP(S) ne parviendra pas à effectuer l'initialisation.
FailRequest N
++++BOPrefix La valeur de cette propriété est transmise au gestionnaire de données. Non
++++Host Le programme d'écoute écoute le trafic à l'adresse IP indiquée par la valeur de cette propriété. Si Host n'est pas indiqué, la valeur par défaut est localhost. Notez que vous pouvez soit indiquer soit un nom d'hôte(nom DNS) soit une adresse IP pour la machine sur laquelle le programme d'écoute s'exécute. Une machine peut posséder plusieurs adresses IP ou plusieurs noms. localhost Non
++++Port Le port sur lequel le programme d'écoute écoute les demandes. S'il n'est pas indiqué, le port utilisé par défaut est le port 80 pour HTTP et le port 443 pour HTTPS.
Si vous copiez le programme d'écoute dans un connecteur, la combinaison des propriétés Host et Port peut être incapable d'établir des liens avec le port pour accepter des demandes.
80 pour le programme d'écoute HTTP
443 pour le programme d'écoute HTTPS
Non
++++SocketQueueLength Longueur de la file d'attente (file d'attente de socket) pour les demandes de connexion entrantes. Indique le nombre de connexions entrantes pouvant être stockées simultanément avant que l'hôte refuse des connexions. La longueur maximale de file d'attente dépend du système d'exploitation. 5 Non
++++RequestWaitTimeout Exprimé en milli-secondes, intervalle pendant lequel le module d'exécution du programme d'écoute sera bloqué sur l'hôte et le port en attendant l'arrivée de demandes. S'il reçoit une demande avant cette intervalle, le programme d'écoute la traitera. Dans le cas contraire, l'unité d'exécution du programme d'écoute vérifie si l'indicateur d'arrêt du connecteur est défini. Si celui-ci est défini, le connecteur s'arrête. Dans le cas contraire, il continue à être bloqué pendant l'intervalle RequestWaitTimeout. Si cette propriété est réglée sur 0, il est bloqué indéfiniment. S'il n'est pas indiqué, la valeur par défaut est 60000 millisecondes. 60000 (ms) Non
++++HTTPReadTimeout Exprimé en milli-secondes, intervalle pendant lequel le module d'exécution du programme d'écoute sera bloqué pendant la lecture d'une demande émanant d'un client. Si ce paramètre est réglé sur 0, le programme d'écoute sera bloqué indéfiniment jusqu'à la réception du message de demande complet. 0 Non
++++HttpAsyncResponseCode Code réponse HTTP pour les demandes asynchrones adressées au programme d'écoute :
200 (OK)
202 (ACCEPTED)
202 (ACCEPTED) Non
++++Pingability Propriété comprenant 0 spécification ou plus pour les services ping pour ce programme d'écoute. Cette propriété ne possède pas de valeur. Non
+++++PingService1 Cette propriété comprend une spécification pour le service ping.

Cette propriété ne comprend pas de valeur et le nom peut être n'importe quel nom de propriété correct.
Remarque : il peut exister plusieurs instances structurellement identiques avec des valeurs différentes de cette propriété.

En cas d'erreur lors de la validation de cette propriété, un message d'erreur est consigné et le programme d'écoute de protocole ne s'initialise pas.
Non
++++++Method Méthode HTTP de la demande, casse indifférenciée. Oui
++++++StatusCode Code état de la réponse à la demande. Oui
++++++ReasonPhrase Motif-Phrase en réponse à la demande. Oui
++++URLsConfiguration Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Elle contient une ou plusieurs configurations pour les URL prises en charge par ce programme d'écoute et, le cas échéant, les valeurs mime type et charset. Notez qu'il s'agit de la propriété enfant de la propriété hiérarchique ProtocolListenerFramework->ProtocolListeners->HTTPListener1. En l'absence de cette propriété, le programme d'écoute utilise des valeurs par défaut.

Si cette propriété n'est pas indiquée, le programme d'écoute utilise la propriété URLsConfiguration définie sur >ContextPath: "/".
>Enabled: true
>DataHandler MimeType: égal au ContentType de la demande
>Charset : selon les règles de la section de globalisation.
ContextPath : / Enabled : true MimeType du gestionnaire de données : égal au ContentType de la demande Charset : NONE. Pour plus d'informations, voir HTTP et HTTPS traitement du programme d'écoute de protocole. Non
+++++URL1 Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Ses enfants fournissent le nom de l'URL prise en charge par ce programme d'écoute. Plusieurs URL peuvent être prises en charge. Notez que vous pouvez brancher plusieurs URL supplémentaires en copiant cette propriété et sa hiérarchie. Non
++++++ContextPath L'URI des demandes HTTP reçues par le programme d'écoute. Cette valeur doit être unique parmi les valeurs ContextPath de la propriété URLsConfiguration. Autrement, le connecteur consignera une erreur et ne pourra démarrer. La casse des valeurs ContextPath est différenciée. Cependant, elles peuvent contenir le protocole, le nom d'hôte et le port dont la casse est indifférenciée. Si le protocole est indiqué dans ContextPath, il doit s'agir de http. Si l'hôte est indiqué, il doit s'agir de la valeur de la propriété Host du programme d'écoute. Si le port est indiqué, il doit s'agir de la valeur de la propriété Port du programme d'écoute. Non
++++++Enabled La valeur de cette propriété détermine si la propriété hiérarchique de l'URL parent est activée pour le connecteur. True Non
++++++TransformationRules Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Elle peut comporte une ou plusieurs règles de transformation. Non
+++++++EmptyRequestRule Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Cette propriété comporte la règle de transformation à utiliser en cas de charge de demande vide.
++++++++MimeType Type mime DataHandler à utiliser quand le gestionnaire de données appelant traite des demandes à charge vide. (Notez que le gestionnaire de données recevra Hashtable d'entêtes de demande au lieu de l'objet de configuration) Oui
++++++++Charset Charset qui doit être utilisé lors de la transformation de la demande avec charge vide. Non
++++++++BOPrefix Si elle est définie, la valeur de cette propriété remplacera BOPrefix de ce programme d'écoute de protocole pour le transmettre au gestionnaire de données. Non
++++++++BOName Si elle est définie, la valeur de cette propriété sera transmise au gestionnaire de données dans la table de hachage des entêtes avec BOName comme nom de l'élément.
Si un entête de protocole porte le même nom, la valeur d'entête de protocole est prioritaire sur cette valeur de propriété.
Non
++++++++BOVerb Si elle est définie, la valeur de cette propriété sera transmise au gestionnaire de données dans la table de hachage des entêtes avec BOVerb comme nom de l'élément.
Si un entête de protocole porte le même nom, la valeur d'entête de protocole est prioritaire sur cette valeur de propriété.
Non
+++++++TransformationRule1 Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Elle comprend la règle de transformation. Non
++++++++ContentType La valeur de cette propriété indique le ContentType de la demande entrante à laquelle une gestion spéciale (type mime ou charset du gestionnaire de données) doit être appliquée. Si ContentType n'est pas indiqué par la propriété hiérarchique TransformationRuleN, le connecteur consigne un message d'avertissement et ne tient pas compte de la propriété TransformationRuleN.

La valeur spéciale */* de cette propriété permet aux programmes d'écoute de protocole d'appliquer cette règle à n'importe quel ContentType. Notez que si un programme d'écoute trouve plusieurs règles pour le même chemin d'accès de contexte partageant un ContentType, le programme d'écoute consigne une erreur et ne parvient pas à s'initialiser.
Non
++++++++MimeType Type mime à utiliser lors de l'appel d'un gestionnaire de données afin de traiter les demandes du ContentType indiqué. Non
++++++++Charset Charset à utiliser lors de la transformation de la demande du ContentType indiqué en objet métier. Non
++++++++BOPrefix Si elle est définie, la valeur de cette propriété remplacera BOPrefix de ce programme d'écoute de protocole pour le transmettre au gestionnaire de données. Non
++++++++BOName Si elle est définie, la valeur de cette propriété sera transmise au gestionnaire de données dans la table de hachage des entêtes avec BOName comme nom de l'élément.
Si un entête de protocole porte le même nom, la valeur d'entête de protocole est prioritaire sur cette valeur de propriété.
Non
++++++++BOVerb Si elle est définie, la valeur de cette propriété sera transmise au gestionnaire de données dans la table de hachage des entêtes avec BOVerb comme nom de l'élément.
Si un entête de protocole porte le même nom, la valeur d'entête de protocole est prioritaire sur cette valeur de propriété.
Non

La figure 18 représente les propriétés telles qu'elles figurent dans Connector Configurator.

Figure 18. Propriétés du programme d'écoute de protocole HTTP(S)
ProxyServer

Configurez les valeurs enfants de cette propriété quand le réseau utilise un serveur proxy. Il s'agit d'une propriété hiérarchique ne possédant pas de valeur. Les valeurs enfants de cette propriété sont utilisées par les gestionnaires de protocole HTTP-HTTPS.

La figure 19 représente les propriétés ProxyServer telles qu'elles sont affichées dans Connector Configurator.

Figure 19. Propriétés ProxyServer
HttpProxyHost

Nom d'hôte du serveur proxy HTTP. Indiquez cette propriété si le réseau utilise un serveur proxy pour le protocole HTTP.

Valeur par défaut = aucune

HttpProxyPort

Numéro du port que le connecteur utilise pour se connecter au serveur proxy HTTP.

Valeur par défaut = 80

HttpNonProxyHosts

Le valeur de cette propriété définit un ou plusieurs hôtes (HTTP) qui doivent être connectés directement et non pas par l'intermédiaire du serveur proxy. Il peut s'agir d'une liste d'hôtes séparés les uns des autres par "|".

Valeur par défaut = aucune

HttpsProxyHost

Nom d'hôte du serveur proxy HTTPS.

Valeur par défaut = aucune

HttpsProxyPort

Numéro du port que le connecteur utilise pour se connecter au serveur proxy HTTPS.

Valeur par défaut = 443

HttpsNonProxyHosts

Le valeur de cette propriété définit un ou plusieurs hôtes (HTTPS) qui doivent être connectés directement et non pas par l'intermédiaire du serveur proxy. Il peut s'agir d'une liste d'hôtes séparés les uns des autres par "|".

Valeur par défaut = aucune

SocksProxyHost

Nom d'hôte du serveur proxy Socks. Indiquez cette propriété quand le réseau utilise un proxy socks.

Remarque :
Le JDK sous-jacent doit prendre en charge Socks.

Valeur par défaut = aucune

SocksProxyPort

Numéro de port de connexion au serveur proxy Socks. Indiquez cette propriété quand le réseau utilise un proxy socks.

Valeur par défaut = aucune

HttpProxyUsername

Nom d'utilisateur du serveur proxy HTTP. Si vous indiquez ProxyServer ->HttpProxyUsername alors que la destination de la demande est une URL HTTP, le gestionnaire de protocole HTTP-HTTPS crée un entête Proxy-Authorization lors de l'authentification avec le proxy. Le gestionnaire utilise la méthode CONNECT pour l'authentification.

L'entête proxy-authentication est codée en base64 et possède la structure suivante :

Proxy-Authorization: Basic
Base64EncodedString

Le gestionnaire concatène les valeurs de propriété du nom d'utilisateur et du mot de passe séparées par le signe deux-points (:) afin de créer la chaîne base64.

Valeur par défaut = aucune

HttpProxyPassword

Mot de passe du serveur proxy HTTP. Pour plus d'informations sur l'utilisation de cette valeur, voir HttpProxyUsername.

Valeur par défaut = aucune

HttpsProxyUsername

Nom d'utilisateur pour le serveur proxy HTTPS. Si vous indiquez ProxyServer ->HttpsProxyUsername alors que la destination de la demande est une URL HTTPS, le gestionnaire de protocole HTTP-HTTPS crée un entête Proxy-Authorization pour l'authentification avec le proxy. Le gestionnaire concatène les valeurs de propriété de configuration HttpsProxyUsername et HttpsProxyPassword séparées par le signe deux-points (:) afin de créer la chaîne base64.

Valeur par défaut = aucune

HttpsProxyPassword

Mot de passe du serveur proxy HTTPS. Pour plus d'informations sur l'utilisation de cette valeur, voir HttpsProxyUsername.

Valeur par défaut = aucune

SSL

Indiquez des valeurs sous cette propriété pour configurer SSL pour le connecteur. Il s'agit d'une propriété hiérarchique ne possédant pas de valeur.

La figure 20 représente les propriétés SSL telles qu'elles sont affichées dans Connector Configurator.

Figure 20. Propriétés SSL
SSLVersion

Version SSL à utiliser par le connecteur. Pour plus d'informations sur les versions SSL prises en charge, voir la documentation JSSE IBM.

Valeur par défaut = SSL

SSLDebug

Si cette propriété est réglée sur true, le connecteur définit la valeur de la propriété système javax.net.debug sur true. IBM JSSE emploie cette propriété pour activer la fonction de trace. Pour plus d'informations, voir la documentation IBM JSSE.

Default = false

KeyStoreType

La valeur de cette propriété définit le type de KeyStore et de TrustStore. Pour plus d'informations sur les types de magasin de clés corrects, voir la documentation JSSE IBM.

Valeur par défaut = JKS

KeyStore

Cette propriété définit le chemin d'accès complet au fichier du magasin de clés. En l'absence de KeyStore et/ou de KeyStoreAlias, les propriétés KeyStorePassword, KeyStoreAlias, TrustStore, TrustStorePassword ne sont pas prises en compte. Le connecteur ne parvient pas à démarrer s'il ne peut charger le magasin de clés à l'aide du chemin d'accès indiqué dans cette propriété. Le chemin d'accès indiqué doit être le chemin d'accès complet au fichier du magasin de clés.

Valeur par défaut = aucune

KeyStorePassword

Cette propriété définit le mot de passe de la clé privée de Keystore.

Valeur par défaut = aucune

KeyStoreAlias

Cette propriété définit l'alias de la paire de clés dans le KeyStore. Les programmes d'écoute HTTPS utilise cette clé privée stockée dans le magasin de clés. De même, le gestionnaire de protocole HTTP-HTTPS utilise cet alias extrait du magasin de clés lors de l'appel de services HTTPS nécessitant l'authentification client. La propriété doit être réglée sur un alias JSSE correct.

Valeur par défaut = aucune

TrustStore

Cette propriété définit le chemin d'accès complet au TrustStore. TrustStore permet de stocker les certificats approuvés par le connecteur. TrustStore doit être du même type que KeyStore. Vous devez définir le chemin d'accès complet au fichier TrustStore.

Valeur par défaut = aucune

TrustStorePassword

Cette propriété définit le mot de passe de Truststore.

Valeur par défaut = aucune

UseClientAuth

Cette propriété indique si l'authentification client SSL est employée. Quand elle est réglée sur true, les programmes d'écoute HTTPS utilisent l'authentification client.

Valeur par défaut = false

Création programmes d'écoute multiples

Vous pouvez créer plusieurs instances de programmes d'écoute. Les programmes d'écoute de protocole sont configurés en tant que propriétés enfants de la propriété de connecteur ProtocolListenerFramework -> ProtocolListeners. Chaque enfant(de ProtocolListenerFramework -> ProtocolListeners) identifie un programme d'écoute de protocole distinct pour le connecteur. Ainsi, vous pouvez créer des programmes d'écoute supplémentaires en configurant de nouvelles propriétés enfants de la propriété ProtocolListeners. Assurez-vous d'indiquer toutes les propriétés enfants de la propriété du programme d'écoute que vous venez de créer. Chaque programme d'écoute doit porter un nom unique. Cependant, vous ne modifiez pas la propriété Protocol du programme d'écoute (http ou https), qui doit rester la même pour les multiples instances d'un programme d'écoute.

Remarque :
La propriété Protocole est essentiel car elle joue le rôle de commutateur. Si vous ne souhaitez pas utiliser de programme d'écoute ou de gestionnaire, laissez cette propriété vide.

Si vous créez plusieurs instances d'un programme d'écoute HTTP ou HTTPS, assurez-vous d'indiquer des propriétés Port et Host pour chaque instance.

Vous ne pouvez pas créer plusieurs instances d'un gestionnaire. Il ne doit exister plus d'un protocole par gestionnaire.

Copyright IBM Corp. 2003, 2005