Toute l'équipe de Prologue Technologies vous remercie d'avoir choisi notre nouveau produit.

Vous trouverez des informations, FAQs, différentiels de versions, etc. sur le site de Prologue : http://www.prologue.fr/

Internet est devenu le vecteur de diffusion d'informations par excellence. L'évolution des lignes à haut débit renforce l'utilisation d'Internet en terme de consultation de données comme de transfert de données. Afin de faciliter l'accès à une session de travail, Prologue Technologies a développé le produit Twin Web et Uniterm Android pour UseIT. Uniterm Android est la déclinaison pour tablette Android version 3 et supérieure du produit Twinweb.

1 - Présentation

2 - Installation

2.1 Installation sous UseIT

2.2 Installation sur le poste client de Twinweb

3 - Configuration UseIT

3.1 Paramètres de connexion

3.2 Déclaration d'une console Twin Web ou Uniterm Android

4 - Paramétrage de Twin Web ou Uniterm Android

4.1 Serveur Web

4.2 Paramètres du fichier PASSWD

4.3 Paramètres de IWEB

4.4 Fonctionnement de l'authentification

4.5 Paramètres de l'applet Twinweb

4.6 Paramètres d'inactivité TIMECUT

4.7 Paramètres d'affichage

5 - Fonctionnement de Twin Web

5.1 Affichage de Twin Web

5.2 Paramètres d'impression

5.3 Utilisation des fichiers de traces

5.4 Internationalisation

6 - Personnalisation de la page HTML : IGENER

7 - Configurations Type

7.1 Je veux rendre 3 consoles disponibles en libre service à n'importe qui.

7.2 Je veux rendre 3 consoles disponibles en libre service de façon sécurisée.

7.3 Je veux attribuer 3 consoles spécifiquement à certaines personnes.

7.4 Je veux rendre 2 consoles disponibles en libre service , et 2 consoles pour certaines personnes en même temps.

7.5 Je dispose déjà d'un serveur web sur mon réseau.

ANNEXE

A - Liste des fichiers de la fourniture

B - Liste des erreurs

C - Fonction avancée

D - Codes d'échappement pour impression

1 - PRESENTATION retour à l'index

Cette version de Twin Web ou Uniterm Android pour Use IT offre des garanties de sécurité et une richesse de fonctionnalités qui permettra aisément son déploiement.

Twin Web est une émulation multivue texte de UseIT pour navigateur Internet. Twin Web permet donc la consultation et la saisie de données d'une application Abal sous UseIT à partir d'une interface Internet. Uniterm Android est sa déclinaison pour tablette Android version 3 et supérieure.

Twin Web ne demande aucune modification de l'application. Twin Web est une applet java déroulée dans une page html. Cette page est vierge et peut être habillée si nécessaire.

Une applet est un programme exécuté dans une page html. Elle sera chargée à chaque connexion de console et elle est la garantie d'une sécurité d'accès optimale.

En effet, cette sécurité est vérifiée par :

• une connexion par nom de login et mot de passe crypté,
• l'absence du contenu de l'applet dans les fichiers temporaires Internet.

De plus l'ensemble des ports ouverts par Twin Web sont tunnelisés via SSH pour une sécurité maximum.

La fourniture Twin Web est composée de 3 parties :

• Les pages html et les applets : délivrées par le serveur Apache de UseIT et qui sont enregistrées dans le répertoire /usr/share/useit-www/twinweb2/. Ce répertoire contient également quelques programmes vous aidant à gérer ces fichiers Web (mk_default, igener)
• Les programmes d'authentification : qui permettent d'assurer la sécurité des accès et qui sont enregistrés dans le répertoire /usr/lib/cgi-bin/
• Les fichiers et outils de configuration des accès : qui permettent de paramétrer les accès des utilisateurs et qui sont enregistrés dans le répertoire /usr/lib/twinweb2/

Le contenu exact de la fourniture est listé en annexe de cette documentation ( cf paragraphe Annexe\A ).

2 - INSTALLATION retour à l'index

2.1 Installation sous UseIT retour à l'index

Twin Web est installé automatiquement lors de l'installation du serveur v4.

L'installation enregistre automatiquement le paquet Twin Web. L'installation de Twin Web reconfigure automatiquement le service Apache du serveur Use IT v4 pour rendre les fichiers Twin Web accessibles depuis un navigateur Internet. Ainsi, même si vos consoles ne sont pas déclarées, vous pouvez déjà accéder à votre site Twin Web en utilisant l'URL http://@SRV/twinweb2/ dans votre navigateur (où @SRV est l'adresse IP ou le nom du serveur Use IT). N'oubliez pas le " / " à la fin de l'URL.

2.2 Installation sur le poste client retour à l'index

Une des particularités fondamentales de Twin Web est qu'il n'y a rien à installer sur le poste client . Il suffit juste de s'assurer que ce poste est muni d'une connexion Internet, ainsi que d'un navigateur disposant d'une machine virtuelle java active et des capacités d'exécution javascript. Vérifiez que ces options sont bien activées dans votre navigateur. L'applet de Twin Web est supportée par toutes les versions de JVM de SUN jusqu'à la version 1.6. Elle a été validée :

• sous Windows avec Internet Explorer 8.0 (JVM Microsoft et JVM SUN), FireFox 3.5.9, Chrome, Safari
• sous Linux avec Mozilla et FireFox
• sous MAC OS X avec FireFox et Safari

Sous MAC OS X, les touches de fonctions F9 et F10 sont utilisées par le système d'exploitation. L'applet Twin Web ne peut donc pas détecter l'utilisation de ces touches. De plus, sur ce système, il est possible lancer des navigateurs en mode décoré, c'est à dire au travers d'un émulateur simulant une exécution sur OS 9. Ce mode de fonctionnement est déconseillé avec Twin Web.

Beaucoup de navigateurs sur MAC ne supportent pas la fonction LiveConnect, permettant à TwinWeb de réaliser des impressions. Sur ces navigateurs, un message d'avertissement le signale à l'utilisateur. L'absence du support de cette fonction n'a pas de conséquence dans l'utilisation de la console TwinWeb. Le navigateur Safari sous MAC OS X intègre la fonction LiveConnect.

3 CONFIGURATION USEIT retour à l'index

3.1 Paramètres de connexion retour à l'index

Si votre architecture réseau est interfacée avec un Firewall ou un routeur, vous devez ouvrir les ports de connexion par défaut définis dans Twin Web, à savoir :

• le port 80 pour l'accès http et l'authentification
• le port 23 pour l'accès aux sessions Twin Web.

3.2 Déclaration d'une console Twin Web retour à l'index

Lorsqu'une connexion est établie, celle-ci correspond à une console du configurateur UseIT v4 (console dédiée nommée StaffNet).

Pour UseIT 4.0, la déclaration des consoles StaffNet s'effectue directement dans le configurateur du serveur v4. Pour déclarer une nouvelle console Twin Web, il faut:

• sélectionner "Ajouter un Terminal" dans la liste déroulante d'ajout d'objet
• sélectionner un terminal texte de type StaffNet.
• attribuer un nom à la console pour qu'elle puisse être accessible. Préciser également si la session est persistante et le clavier à utiliser.
• enregistrer un utilisateur pouvant accéder à cette console dans le fichier PASSWD ( Paramètre du fichier PASSWD ).
• redémarrer le service de gestion des terminaux pour qu'il prenne en compte la nouvelle configuration

Pour chaque console StaffNet déclarée, il est possible d'affecter une imprimante déportée qui sera gérée par Twin Web.(cf Paramètre d'impression)

4 - PARAMETRAGE DE TWIN WEB retour à l'index

4.1 Serveur Web retour à l'index

Twin Web utilise le serveur web Apache livré en standard sur le serveur UseIT v4 pour retourner les pages HTML et les autres fichiers aux navigateurs qui en font la demande. La configuration du site Twin Web, en ce qui concerne l'accès aux pages et aux fichiers, s'effectue en intervenant sur les fichiers de configuration Apache.

Par défaut, tous les fichiers de votre site Twin Web sont enregistrés dans le répertoire: /usr/share/useit-www/twinweb2/. Le fichier index de votre site Twin Web est /usr/share/useit-www/twinweb2/index.html. Ce fichier est en fait un lien sur le fichier /usr/share/useit-www/twinweb2/tweb.htm. Vous pouvez modifier le fichier sur lequel pointe index.html en passant le nom du nouveau fichier d'index en paramètre au programme /usr/share/useit-www/twinweb2/mk_default.sh

Le serveur web étant Apache, les traces d'accès aux fichiers du site Twin Web se trouvent dans les mêmes fichiers que les traces Apache, c'est à dire

• /var/log/apaché2/access.log pour les traces de demandes de fichiers
• /var/log/apache2/error.log pour les traces d'erreur lors de demandes de fichiers

Le serveur Apache du serveur UseIT v4 gère par défaut plusieurs groupes de pages. Afin d'accéder aux pages Twin Web, il faut préciser dans l'URL du navigateur en indiquant une adresse du type:
http://192.168.0.1/twinweb2/
ou bien
http://mon_use_it/twinweb2/
le caractère "/" en fin d'URL est obligatoire.

4.2 Paramètres du fichier PASSWD retour à l'index

Le fichier PASSWD contient la liste des noms d'utilisateurs et les mots de passe correspondants de chacune des consoles définies. Ce fichier se trouve par défaut dans /usr/lib/twinweb2/. Il est possible de changer de fichier de mot de passe en modifiant le script /usr/lib/cgi-bin/iweb (cf Paramètres de IWEB)

Ce fichier est un fichier texte, consultable et modifiable par un éditeur de texte. Toute ligne commençant par un ";" est ignorée. La syntaxe à employer est la suivante : nom_utilisateur->tab->mot de passe->tab->nom_console

Le nom d'utilisateur correspond à un utilisateur de Twin Web, et non pas à un utilisateur du système UseIT. Vous pouvez tout à fait utiliser pour Twin Web des noms d'utilisateurs qui n'existent pas dans le système. Il en est de même pour les mots de passe. Ces informations sont uniquement utilisées pour déterminer si la personne à la droit d'accéder à une session Twin Web, et quelle est la console qui lui sera attribuée.

La casse du nom de console n'a pas d'importance. Par contre celle du nom d'utilisateur et celle du mot de passe doivent être respectées pour que l'authentification soit validée

Le mot de passe est enregistré dans le fichier sous forme cryptée selon le même principe que ceux des utilisateurs du système dans le fichier "/etc/passwd". Il n'est donc pas possible de retouver un mot de passe si celui-ci a été perdu. La solution consiste à réenregistrer l'utilisateur avec un nouveau mot de passe. Pour enregistrer un utilisateur dans le fichier PASSWD, il suffit d'utiliser le lien /usr/lib/twinweb2/twpass. Ce programme demande le nom de l'utilisateur à enregistrer, son mot de passe et le nom de la console. Il enregistre automatiquement les informations dans le fichier PASSWD en cryptant le mot de passe. Pour supprimer un utilisateur, il suffit d'éditer le fichier PASSWD avec un éditeur de texte, et de retirer la ligne de l'utilisateur.

Le programme twpass ne prend aucun paramètre, il utilise le chemin indiqué dans le script /usr/lib/cgi-bin/iweb pour retrouver le chemin du fichier contenant les mots de passe.

Un mot de passe vierge permet l'authentification automatique lorsque le paramètre CONSOLNAME est fourni à l'applet. ( cf Paramètres de l'applet ).

Pour la version Uniterm Android, 2 paramètres ont été ajoutés:

- La définition du nombre de ligne et de colonne (par défaut 25x80).

- La définition de la palette couleur (par défaut la configuration de la palette est stockée dans un fichier colors-twinweb.conf se trouvant dans le répertoire courant).

4.3 Paramètres de IWEB retour à l'index

IWEB est le serveur d'authentification.

Il se présente sous la forme de programmes CGI accessibles par le serveur Apache. Ces programmes se trouvent dans le répertoire /usr/lib/cgi-bin/. Ils se composent de:

• iweb : script shell exportant des valeurs et appelant le programme iweb_prg
• iweb_prg : programme d'authentification

• TA_PORT : valeur du port de connexion TCP/IP au service Terminaux Anonymes du serveur UseIT. La valeur par défaut est "9999"
• PASSFILE : chemin du fichier contenant les profils utilisateurs pouvant se connecter à Twin Web. La valeur par défaut est /usr/lib/twinweb2/PASSWD
• KBDESCFILE : chemin du fichier décrivant les correspondances de code clavier. La valeur par défaut est /usr/lib/twinweb2/TwKbdesc.conf

4.4 Fonctionnement de l'authentification retour à l'index

L'authentification fait intervenir le couple applet java – serveur d'authentification iweb.

Elle se déroule en plusieurs phases:

• Le programme contrôle le nom utilisateur et le mot de passe
• Enfin, il retourne à l'applet le nom de la console sur laquelle elle doit se connecter. Ici, deux cas sont possibles:
  • Le nom de console dans le fichier PASSWD correspond exactement au nom d'une console StaffNet déclarée dans le configurateur du serveur UseIT v4, alors iweb retourne ce nom à l'applet. Dans ce cas, la persistance de la session est gérée en fonction du paramétrage dans UseITConf pour cette console.
  • Le nom de console "xxx" dans le fichier PASSWD ne correspond pas exactement au nom d'une console StaffNet déclarée dans UseITConf, alors iweb contacte le serveur UseIT v4 pour lui demander s'il gère une console de type StaffNet qui est libre et dont le nom commence par "xxx". Si le service fourni le nom d'une tel console, ce nom est retourné à l'applet. Dans ce cas, l'applet est utilisé en mode non persistant, c'est à dire que lorsque le terminal ferme sa connexion, la console est réinitialisée. Dans le cas où le serveur UseIT v4 ne trouve pas de console selon les critères indiqués, une erreur est retournée à l'applet. (voir liste des erreurs en annexe).

Un refus de connexion est notifié dans le fichier de trace /var/log/syslog du serveur UseIT ce qui permet à l'administrateur d'intervenir à bon escient.

L'authentification est obligatoire pour accéder à la connexion d'une console StaffNet. Cette vérification garantit un niveau de sécurité et empêche toute intrusion étrangère dans votre serveur UseIT.

De plus, des paramètres d'évaluation de l'inactivité de l'utilisateur (cf paramètres d'inactivités TIMECUT ) sur l'applet entraîne la déconnexion automatique de la session de travail. Une nouvelle authentification est alors nécessaire. Elle s'effectue en sélectionnant le bouton "actualiser" de votre navigateur Internet. La session de travail s'affichera alors à l'endroit où l'utilisateur l'avait laissée.

4.5 Paramètres de l'applet retour à l'index

La page HTML de connexion Twin Web est composée d'un code javascript et d'un code d'appel de l'applet.

Le code d'appel de l'applet comporte plusieurs paramètres qui peuvent être modifiés. Pour certains, il est néanmoins préférable de les laisser configurer par défaut.

• AUTOPRINT : lors d'une impression, ce paramètre permet que la page dans laquelle est générée l'impression demande immédiatement l'impression. La fenêtre de sélection de l'imprimante destinatrice est alors automatiquement lancée.
• PRNWHITEPAGE : ce paramètre permet d'imprimer ou non les pages blanches. Lorsque cette option est à "ON", elle provoque un saut de page dès qu'une page blanche se présente. Par défaut, ce paramètre est à "OFF".
• AUTHPORT : ce paramètre permet de spécifier le port IP sur lequel se fait l'authentification. Par défaut, la valeur de ce port IP est 80. Il est fortement conseillé de ne pas le modifier.
• CONSOLPORT : ce paramètre permet de spécifier la valeur du port de dialogue avec le serveeur UseIT v4 pour accéder à la console StaffNet. Par défaut, la valeur de ce port IP est 23. Il est fortement conseillé de ne pas le modifier.
• CAPSCONTROL : lorsque cette option est à "OFF", l'applet ne gère pas la touche CAPS LOCK du clavier. Cette option permet de contrôler la fonction SHIFT annule CAPS. Par défaut, ce paramètre est à "ON". ( cf Affichage de Twin Web, Zone applet )
• TIMECUT ALL/KEY : cf paramètres d'inactivités
• CONSOLNAME : ce paramètre permet de déclarer un nom d'utilisateur de connexion par défaut. Ce cas se présente quand seul un nom d'utilisateur est spécifié lors d'une connexion et que le mot de passe est vide.

4.6 Paramètres d'inactivité : TIMECUT retour à l'index

Afin d'optimiser la sécurité des données et l'accès à une session de travail UseIT, le paramètre TIMECUT permet d'évaluer un délai au-delà duquel la déconnexion de la console sera effective. Ce délai est indiqué en nombre de minutes dans les options de l'applet (cf programme IGENER ).

On distingue les deux paramètres suivants :

• TIMECUT KEY : temps d'inactivité à la saisie clavier et souris. Ce paramètre ne considère que le délai de non utilisation du clavier et de la souris, c'est à dire la non activité du réseau dans le sens console vers serveur. Dans ce cas, le TIMECUT ne s'active pas s'il y a une activité réseau dans le sens serveur vers console (dans le cas de déroulement d'affichage, par exemple).
• TIMECUT ALL : temps d'inactivité global. Ce paramètre considère le temps d'inactivité général sur la session de travail. Ce paramètre est prioritaire par rapport au paramètre TIMECUT KEY. La déconnexion est effective dans le cas d'inactivité de l'utilisateur, même lorsqu'il y a une activité réseau dans le sens serveur vers console.

Lorsque l'un des deux délais est dépassé, l'applet rompt la connexion. Une nouvelle authentification de l'utilisateur est alors nécessaire pour reconnecter la session de travail. Pour se faire, l'utilisateur devra soit relancer son navigateur Internet et ressaisir l'adresse du serveur, soit sélectionner le bouton "actualiser" de son navigateur.

4.7 Paramètres d'affichages retour à l'index

A la demande d'une connexion, un fichier (par défaut : tweb.htm, cf paramètre de IWEB ) contenant un code javascript de détection de la résolution est renvoyé par le serveur Apache. En fonction de la résolution écran du poste client, la page par défaut redirige le navigateur vers trois pages :

• tweb12.htm pour une résolution supérieure ou égale à 1280 x 1024
• tweb10.htm pour une résolution comprise entre 800 x 600 et 1280 x 1024
• tweb8.htm pour une résolution inférieure ou égale à 800 x 600

5 FONCTIONNEMENT DE TWIN WEB retour à l'index

Le fonctionnement de Twin Web suit les étapes suivantes :

• le poste client envoie une requête (adresse IP ou URL) à un fournisseur d'accès ou directement au serveur UseIT selon l'architecture choisie.
• le serveur Apache renvoie au poste client une page au format html (page tweb.htm ou la page par définie comme page par défaut). Cette page par défaut détecte alors la résolution écran et redirige le navigateur vers l'une des trois pages de travail (tweb8.htm, tweb10.htm ou tweb12.htm). Le chargement de cette page est plus ou moins long selon le contenu de la page.
• le chargement de l'applet commence par une page d'authentification dans laquelle l'utilisateur saisit son nom de login et son mot de passe. Cette phase de saisie par mot de passe peut être annulée en cas d'utilisation d'un nom de console par défaut (paramètre CONSOLNAME de l'applet).
• le serveur d'authentification vérifie les paramètres à partir du fichier PASSWD et autorise ou non la connexion au serveur UseIT.
• le contrôleur StaffNet est alors connecté et la session multivue peut débuter. L'accès à la session de travail peut être également contrôlée par les profils utilisateurs définis dans le configurateur UseITConf.

5.1 Affichage de Twin Web retour à l'index

Le fichier twebx.htm (page au format html contenant l'applet et tenant compte de la résolution écran) distingue plusieurs zones : la zone "applet" et la zone externe.

ZONE APPLET :

Cette zone délimite la console de travail connectée à UseIT. Un "focus" permet d'activer ou non cette zone. Lorsque l'utilisateur travail sur la zone externe (activation de lien, etc), la barre de status de l'applet devient grisée et l'utilisateur doit cliquer dans cette zone pour la réactiver. Ceci arrive par exemple quand une impression est lancée. L'utilisateur doit alors cliquer dans la zone applet pour réactiver le focus. La barre de status devient bleutée et indique le nom de la console connectée et son état.

Twin Web pour UseIT est validé pour les différentes versions de JVM SUN jusqu'à la version 1.6. Dans certaines conditions, la gestion du focus de l'applet peut être différente. Ainsi, sur Linux avec Mozilla et une JVM SUN suppérieure ou égale à 1.4, l'applet perd le focus lorsque la souris sort de la zone applet. Il est très difficile de détecter ce type de gestion du focus. Dans un but de compatibilité, lorsque l'applet est utilisée avec une version de JVM suppérieure ou égale à 1.4, l'applet signale lorsque la souris sort de la zone applet par un message spécifique et la couleur grise dans la barre de status.

Lorsque la connexion est rompue, la barre de status devient rouge. L'utilisateur doit alors tenir compte du message qui s'affiche et tenter une nouvelle connexion.

Le bouton CAPS LOCK permet de synchroniser l'état des fonctions clavier entre le système client (Windows, Linux, etc) et la session de travail UseIT. Si l'option de l'applet CAPSCONTROL est positionnée à "OFF", la touche CAPS LOCK du clavier n'est pas gérée. Dans ce cas, la touche SHIFT n'annule pas l'effet CAPS LOCK. Ceci autorise le changement de vue par la combinaison de touche CTRL+SHIFT+x (où x est le numéro de la vue) sans perdre l'activation du CAPS LOCK.

ZONE EXTERNE :

Cette zone entoure la zone applet. Il s'agit d'une page au format HTML.

Dans la fourniture de Twin Web, la page par défaut est tweb.htm. Toutefois, il est possible de personnaliser cette page afin de l'intégrer dans un site Internet ou d'envisager des liens vers d'autres sites ( cf programme igener).

Il est à noter toutefois que plus cette zone est lourde et plus le temps de connexion sera long. L'exemple fourni dans Twin Web (applet + tweb.htm) a une taille approximative de 300 Ko.

5.2 Paramètres d'impression retour à l'index

Twin Web autorise les impressions déportées en mode texte depuis UseIT via les devices imp présent dans /dev/terminal

Dans la mesure où ces impressions sont en mode texte et que les navigateurs Internet n'offrent la possibilité d'imprimer que du mode graphique, la fonctionnalité d'impression passe par une traduction des impressions en format html.

Les impressions à partir des commandes shell (cat file > /dev/terminal/TERM/imp) ou d'application ABAL entraîne l'ouverture d'une fenêtre du navigateur dans laquelle est figurée le document à imprimer. L'utilisateur a alors le choix de lancer l'impression ou non.

Le paramètre AUTOPRINT ( cf paramètres de l'applet ) permet de lancer directement l'impression depuis la fenêtre d'impression.

5.3 Utilisation des fichiers de traces retour à l'index

Un site Twin Web utilise 3 fichiers de traces:

• /var/log/apache2/access.log dans lequel le serveur web Apache enregistre les demandes de fichiers
• /var/log/apache2/error.log dans lequel le serveur web Apache enregistre les erreurs lors de demandes de fichiers
• /var/log/syslog dans lequel les programmes d'authentification iweb enregistrent les requêtes de connexion des applets Twin Web

5.4 Internationalisation retour à l'index

Twin Web est une émulation accessible par un navigateur. A ce titre, il peut être utilisé sur un réseau intranet ou directement par internet. Dans ce second cas, les utilisateurs peuvent avoir des équipements de connexions (c'est à dire leur poste) hétérogènes. Les connexions peuvent provenir de pays différents n'utilisant pas les mêmes configurations clavier ou les mêmes langages d'interface.

L'applet de Twin Web est capable de prendre en compte sans aucun paramètrage la configuration du poste client. Toutes les informations qu'elle affiche sont disponibles en deux langues, à savoir le français et l'anglais. Elle détermine automatiquement si le poste client est un poste francophone, auquel cas tous les messages sont affichés en français. Dans le cas contraire, les messages sont affichés en anglais.

La gestion du clavier permet de prendre en compte n'importe quel type de clavier. Elle est dépendante de la configuration du clavier de la console StaffNet enregistrée dans le configurateur du serveur UseIT v4. Ainsi, lorsque iweb indique à l'applet le nom de la console de connexion, il lui fournie également le nom du clavier à utiliser. L'applet télécharge alors deux fichiers clavier (keybxx.chr et keybxx.vk) depuis le serveur. Ces fichiers permettent à l'applet d'envoyer au serveur des informations claviers cohérentes par rapport à sa propre configuration.

Ainsi, si un poste Windows configuré avec un clavier français se connecte sur une console StaffNet utilisant un clavier allemand, et que l'utilisateur appuie sur la touche "a" de son clavier, il verra apparaitre un "a" dans la console, car l'applet traduit les demandes provenant du clavier français pour les transposer dans le clavier allemand.

Ce principe ne fonctionne pas pour les caractères présents sur le clavier du poste client et qui n'exitent pas dans le clavier sélectionner pour la console. Ainsi, dans l'exemple précédent, l'utilisateur ne pourra saisir de caractère "ç", car il n'existe pas dans le clavier allemand.

6 . PERSONNALISATION DE LA PAGE HTML : IGENER retour à l'index

Le programme igener permet de personnaliser l'applet et ses fonctions d'appel.

Il permet en outre de générer des pages au format HTML contenant l'applet et ainsi personnaliser l'accueil d'une session de travail Twin Web.

Principe de fonctionnement :

igener est un programme qui prend en compte des paramètres d'entrée (fichiers .tw ou options de l'applet). Parmi ces fichiers, on distingue jscript.tw (fichier contenant le code javascript de l'applet) et le fichier base.tw (modèle de page de chaînage tenant compte de la bonne résolution écran).

Ces pages sont consultables par un navigateur Internet et modifiables par un logiciel adapté ou un éditeur.

Étapes à suivre :

1) L'utilisateur crée les pages html devant contenir l'applet avec un éditeur. Il doit créer une page pour chaque résolution. Ces pages peuvent donc être identiques ou différentes en fonction de la résolution. L'utilisateur doit renommer ces trois pages. Le nouveau nom doit avoir le format - xxxxxx8.tw pour les faibles résolutions - xxxxxx10.tw pour les moyennes résolutions - xxxxxx12.tw pour les hautes résolutions (avec xxxxxx comme racine de noms des pages).

2 ) L'utilisateur ouvre chaque fichier .tw créé ci-avant et insère la chaîne "<twinweb> " à l'endroit où il souhaite voir apparaître l'applet, de sorte que igener remplace cette chaîne par le code d'appel de l'applet.

3) L'utilisateur lance le programme igener avec les options qu'il souhaite. Il doit pour cela se positionner dans le répertoire contenant les fichiers du site web Twin Web:

cd /usr/share/useit-www/twinweb2
./igener fichier=xxxxxx

igener ouvre le fichier base.tw en lecture et le fichier xxxxxx.htm en écriture. Il copie le contenu de base.tw dans xxxxxx.htm en remplaçant les chaînes twinweb par xxxxxx.

igener referme les deux fichiers et génère les trois fichiers contenant l'applet. Pour chaque fichier (xxxxxx8.htm, xxxxxx10.htm et xxxxxx12.htm), il ouvre le fichier jscript.tw et xxxxxx8.tw en lecture et xxxxxx8.htm en écriture.

Il recopie ensuite le contenu de xxxxxx8.tw dans xxxxxx8.htm sans le tag /head, il remplace "<twinweb>" par le tag APPLET en fonction des paramètres entrés par l'utilisateur.

La page par défaut est maintenant xxxxxx.htm. Veillez à modifier le fichier index de votre site Twin Web à l'aide du programme /usr/share/useit-www/twinweb2/mk_default.sh.

Les paramètres suivants sont facultatifs :

• CONSOLNAME : permet d'établir une connexion automatique sans authentification.
• TIMECUTKEY : nombre de minutes sans frappe clavier avant déconnexion automatique.
• TIMECUTALL : nombre de minutes avant déconnexion automatique.

Les autres paramètres sont utilisés pour une configuration plus spécifiques. Pour voir ces paramètres, tapez /usr/share/useit-www/twinweb2/igener et valider.

ATTENTION : Il est possible d'utiliser igener pour activer des options de débugage de l'applet. Lorsque ces options sont actives, l'applet utilise la console java (disponible dans les menus du navigateur) pour afficher des informations. Il est fortement recommandé de ne pas utiliser ces options de débugage. En effet, l'utilisation de la console java entraîne de forts ralentissements de la machine virtuelle et peut perturber le fonctionnement de l'applet. Il est recommandé de contacter le support de Prologue Software pour l'utilisation de ces options.

7 - Configurations Type retour à l'index

7.1 Je veux rendre 3 consoles disponibles en libre service à n'importe qui. retour à l'index

1) Installez le serveur UseIT v4

2) Déclarez vos 3 consoles StaffNet dans le configurateur du serveur UseIT v4, et donnez leur à chacune un nom. Ce nom doit être différent pour chaque console, par exemple 'CONSWEB1', CONSWEB2' et 'CONSWEB3'.

3) Ajoutez dans le fichier PASSWD une ligne qui permettra à vos consoles CONSWEB de s'authentifier. Cette ligne décrit un utilisateur, son mot de passe et sa (ou ses ) console(s). Nous choisissons comme nom utilisateur 'stduser'. Comme nous souhaitons une connexion sans mot de passe, il restera à blanc. Nous utiliserons comme nom de console 'CONSWEB', afin que Twin Web puisse attribuer à l'utilisateur la première console disponible parmi les trois dont le nom commence par CONSWEB. Pour enregistrer cette ligne, nous utilisons le programme /usr/lib/twinweb2/twpass. Après exécution du programme, nous trouvons dans le fichier PASSWD la ligne suivante:

stduser <tab>MOTPASSE <tab> CONSWEB

Où MOTPASSE représente le mot de passe crypté par twpass

4) Votre système est prêt, il vous reste à réaliser vos pages. Utilisez un programme de création de page HTML , et utilisez igener ( cf personnalisation de la page HTML ) pour créer votre site Twin Web. N'oubliez pas d'utiliser l'option CONSOLNAME pour spécifier le nom d'utilisateur de connexion. Les lignes de commande seront donc du type :

cd /usr/share/useit-www/twinweb2
./igener fichier=xxxxxx consolename=stduser

La page par défaut est maintenant xxxxxx.htm. Le serveur Apache prend comme page par default un fichier index.html. Pour que le fichier index soit xxxxxx.htm, vous pouvez utiliser le programme mk_default.sh dans le répertoire: ./mk_default xxxxxx.htm

5) Votre site Twin Web est alors opérationnel. Vous disposez de 3 consoles, nommées 'CONSWEB1', 'CONSWEB2' et 'CONSWEB3', accessibles depuis le Web sans saisie de mot de passe. Lorsqu'un utilisateur se connectera à votre site Twin Web, le système lui attribuera la première des trois consoles disponible. L'attribution de ces consoles sera réalisée par le serveur UseIT v4. Par conséquent, elles ne disposeront pas de la persistance de session, même si elles ont été paramétrées avec cette option active dans le configurateur.

7.2 Je veux rendre 3 consoles disponibles en libre service de façon sécurisée retour à l'index

Il suffit de suivre les étapes décrites ci-dessus, sauf pour les points 3 et 4. En effet, lors de l'utilisation de twpass, vous devez indiquer les mots de passe à utiliser. Il est possible d'affecter plusieurs mots de passe pour le même groupe de console. Après utilisation de twpass, le fichier PASSWD contient :

pierre <tab> MOTPASSE1 <tab> CONSWEB
paul <tab> MOTPASSE2 <tab> CONSWEB
marc <tab> MOTPASSE3 <tab> CONSWEB
franck <tab> MOTPASSE4 <tab> CONSWEB

où MOTPASSE1, MOTPASSE2, MOTPASSE3 et MOTPASSE4 sont les 4 mots de passe cryptés que vous avez enregistrés

Dans cette configuration, les utilisateurs s'authentifient sur l'une de vos 3 consoles CONSWEB en utilisant l'un des 4 logins. Ainsi, si vous donnez ces logins à 4 utilisateurs, il vous sera possible d'interdire la connexion à l'un d'entre eux en retirant du fichier PASSWD la ligne de login que vous lui aurez fourni.

En ce qui concerne le point 4, vous ne devez pas utiliser l'option CONSOLNAME de igener lors de la génération de vos pages au format HTML.

Dans cette configuration, la console attribuée par le système sera la première disponible. Bien sur, si vos 4 utilisateurs tentent de se connecter en même temps sur votre site, comme vous n'avez déclaré que 3 consoles, le dernier d'entre eux recevra une erreur du type « Il n'y a plus de console disponible».

7.3 Je veux attribuer 3 consoles spécifiquement à certaines personnes. retour à l'index

Dans ce cas, il n'est pas nécessaire de nommer chaque console avec la même racine de nom, vous pouvez leur donner des noms totalement différents. Dans notre exemple, nous continuerons à utiliser les consoles 'CONSWEB1', 'CONSWEB2' et 'CONSWEB3'. La seule modification importante à apporter par rapport à l'exemple précédent concerne le fichier PASSWD, dans lequel vous devez enregistrer les lignes suivantes à l'aide du programme twpass:

franck <tab> MOTPASSE1 <tab> CONSWEB1
marc <tab> MOTPASSE2 <tab> CONSWEB2
juliette <tab> MOTPASSE3 <tab> CONSWEB3

où MOTPASSE1, MOTPASSE2, MOTPASSE3 sont les 3 mots de passe cryptés que vous avez enregistrés

En donnant ces 3 logins aux 3 utilisateurs franck, marc et juliette, ceux-ci pourront se connecter depuis Internet de façon totalement sécurisée. L'attribution de la console se fera directement à partir du nom saisi par l'utilisateur lors de l'authentification. Ainsi, l'utilisateur se connectant avec le nom 'marc' et le mot de passe correspondant se verra toujours attribuer la console CONSWEB2.

Comme le nom de la console trouvé dans le fichier PASSWD correspond exactement à celui enregistré dans la configuration du serveur UseIT, le serveur iweb n'utilisera pas le service Terminaux Anonymes. La persistance de la session sera donc gérée par le serveur UseIT v4 selon le paramétrage effectué dans le configurateur.

7.4 Je veux rendre 2 consoles disponibles en libre service , et 2 consoles pour certaines personnes en même temps retour à l'index

Il suffit d'utiliser les exemples précédents simultanément. Vous allez donc créer 4 consoles dans le UseITConf, et les nommer, par exemple, avec les noms suivants : 'CONS1', 'CONS2', 'CFRANCK' et 'CMARC'. Votre fichier PASSWD aura le format suivant :

stduser <tab> MOTPASSE1 <tab> CONS
franck <tab> MOTPASSE2 <tab> CFRANCK
marc <tab> MOTPASSE3 <tab> CMARC

où MOTPASSE1, MOTPASSE2 et MOTPASSE3 sont les 3 mots de passe cryptés que vous avez enregistrés. MOTPASSE1 correspond à un mot de passe vide.

Ensuite, vous utilisez 2 fois igener, une fois en utilisant l'option CONSOLNAME et une fois sans :

cd /usr/share/useit-www/twinweb2
./igener fichier=XXXXXX consolename=stduser
./igener fichier=YYYYYY

où XXXXXX est le nom racine pour les pages accessibles par n'importe qui, et YYYYYY pour les utilisateurs privilégiés.

Vous devrez modifier l'accès au fichier index.html pour que la page par défaut devienne XXXXXX.HTM, par exemple :

cd /usr/share/useit-www/twinweb2
./mk_default XXXXXX.htm

Ainsi, les utilisateurs non privilégiés pourront se connecter en utilisant l'URL (par exemple : www.mon_use_it.fr/twinweb2/) de votre site et n'auront pas à saisir de mot de passe. Les utilisateurs privilégiés indiqueront en plus leur page spécifique (www.mon_use_it.fr/twinweb2/YYYYYY.htm) et auront à saisir leur mot de passe.

7.5 Je dispose déjà d'un serveur web sur mon réseau. retour à l'index

La première consiste à rendre votre serveur UseIT directement visible depuis internet en louant une nouvelle adresse IP statique à votre fournisseur d'accès internet. Vous disposerez alors de deux adresses statiques visibles depuis internet, à savoir une pour votre premier serveur web, et une seconde pour le serveur UseIT utilisant Twin Web.

La seconde solution est de ne conserver qu'une adresse IP statique visible depuis internet et donnant accès à votre premier serveur web. Ainsi, votre UseIT sera uniquement utilisé comme serveur d'authentification et serveur de consoles. Pour cela, il faut :

• Modifier les pages HTM de Twin Web à l'aide du programme igener ( cf programme IGENER ) pour changer le port TCP/IP d'authentification. Par défaut, ce port est 80, c'est à dire le même que celui utilisé par votre premier serveur web. Choisissez par exemple le port 113, qui est un port référencé pour l'authentification.
• Copier tous les fichiers du site web Twin Web sur votre premier serveur web pour rendre ces fichiers accessibles depuis un navigateur. Il s'agit des fichiers présents dans le répertoire /usr/share/useit-www/twinweb2/.
• Modifier la configuration de votre routeur internet pour que:
  • le port 80 soit redirigé vers le port 80 de votre premier serveur web
  • le port 113 soit redirigé vers le port 80 de votre UseIT
  • le port 23 soit redirigés vers le port 23 de votre UseIT

Votre site est alors opérationnel. Votre premier serveur web, qui utilise le port 80, est serveur de fichier internet pour vos fichiers Twin Web (page HTML, applet...). Dans le même temps, votre serveur UseIT v4 est serveur d'authentification sur le port 113 et serveur de consoles sur le port 23. Seuls les ports d'authentification et de console sont tunnélisés en SSH.

ANNEXE retour à l'index

A - Liste des fichiers de la fourniture retour à l'index

Fichiers installés dans le répertoire /usr/lib/cgi-bin

Noms	Définition
iweb	script fixant les paramètres d'utilisation et appelant le serveur d'authentification iweb_prg
iweb_prg	programme de gestion des authentifications Twin Web

Fichiers installés dans le répertoire /usr/lib/twinweb2

Noms	Définition
PASSWD	Fichier texte contenant la liste des noms de consoles et utilisateurs avec leur mot de passe
TwKbdesc.conf	fichier de description des codes de type de clavier
twpass	lien sur /usr/lib/cgi-bin/iweb. Permet l'enregistrement des utilisateur dans le fichier PASSWD.

B - Liste des erreurs retour à l'index

C - Fonction avancée retour à l'index

Twin Web permet de réaliser des actions spécifiques à son utilisation. Il permet ainsi d'ouvrir une page Web grâce à une URL.

Cette opération s'effectue au travers du flux écran en utilisant le code d'échappement suivant :

1B 63 F0 nom_URL F0 FF

Cette séquence provoque l'ouverture d'une nouvelle fenêtre vers la page portant le nom "nom_URL". Cette URL doit être complète c'est à dire qu'elle doit comporter le protocole, le domaine et le fichier à atteindre pour être prise en compte par la nouvelle fenêtre. (Par exemple "http://www.prologue.fr"). Cette séquence doit être envoyée en utilisant le mode transparent.

Il est nécessaire de temporiser les affichages de l'application ABAL lorsque celle-ci utilise l'une ou l'autre des ces fonctions avancées. Cette fonctionnalité peut être utilisée pour rendre accessibles des pages HTML générées par un programme abal. Dans ce type d'application, le programme en question doit enregistrer la page HTML dans le répertoire du site TwinWeb, puis utiliser la fonctionnalité avancée décrite ci-dessus afin de provoquer son affichage. L'application aura cependant à charge de supprimer le fichier généré afin de ne pas remplir le répertoire du site TwinWeb inutilement, par exemple lors de la reconnexion de l'utilisateur.

D - Code d'échappement pour impression retour à l'index

a) Liste des codes ATB gérés par Twin Web : retour à l'index

b) Liste des codes Epson gérés par Twin Web : retour à l'index

d ) Liste des codes spécifiques à Twin Web: retour à l'index

Dans les tableaux ci-dessus, les " n " suivant les codes hexadécimaux indiquent la présente d'un paramètre pour ces codes d'échappement.