Installation et configuration de Sage HRM Portal

Configuration de la console et HTTPS

1. Installation du serveur web X3

L'application Sage HRM Portal nécessite l'installation et la configuration d'un serveur X3web sur lequel va être publiée l'application HRM et créé un pool de web services.

 Les applications serveurs 'Sage HRM Portal' et serveur de 'web services' peuvent être hébergées sur un même serveur X3Web ou sur deux serveurs X3Web distincts.

1.1. Pré-requis à l'installation

La solution doit être visible dans le tiroir "Solutions" à gauche de l'écran. Dans le cas contraire, vous devez l'importer par le biais du bouton [Importer une solution].

1.2. Installation du serveur web

Pour réaliser l'installation du serveur web, sélectionnez le serveur souhaité dans le tiroir "Serveur web" à gauche de l'écran.
Si le serveur n'apparaît pas dans la liste, cliquez sur le bouton [Nouveau] et remplissez les informations demandées. Cliquez ensuite sur [Suivant] pour accéder à la fenêtre de sélection du serveur.
Cliquez sur [Ok] pour revenir à l'écran de sélection du serveur.

2. Configuration HTTPS

Par défaut les utilisateurs accèdent à la page de login du portail en http non sécurisé. Lorsque le navigateur émet la requête de login vers le serveur X3, les données (code utilisateur/mot de passe) saisies par l’utilisateur ne sont pas encryptées et transitent en clair sur le réseau. Ce paragraphe explique comment :

• activer le protocole sécurisé HTTPS sur le serveur X3WEB,
• installer des certificats valides pour les navigateurs,
• obliger l’utilisation du protocole http sur la page de login.

Les fichiers certificats livrés en standard ne sont pas certifiés par une autorité de certification et ne sont donc pas reconnus par les navigateurs. Des pages sont alors affichées par les navigateurs et l’utilisateur doit accepter le certificat pour accéder à la page cible. Ces pages ne s’affichent pas si on a configuré X3WEB avec un certificat validé par une autorité de certification.

2.1. Activer le protocole https

Le protocole https permet au visiteur de vérifier l'identité du site auquel il accède grâce à un certificat d'authentification. Il garantit la confidentialité et l'intégrité des données envoyées par l'utilisateur (notamment des informations entrées dans les formulaires) et reçues du serveur.

• Obtention d'un certificat
  L'Autorité de certification commerciale demande d'envoyer une demande de Signature de certificat (CSR) par l'intermédiaire d'un formulaire web, de régler le montant de la signature, puis vous envoie un certificat signé que vous pouvez enregistrer dans un fichier 'server.crt'.
• CSR
  Une Demande de Signature de Certificat (CSR) est un fichier numérique qui contient votre clé publique et votre nom. La CSR doit être envoyée à une Autorité de Certification (CA), qui va la convertir en vrai certificat en la signant
• Certificat (server.crt)
  Un certificat contient votre clé publique RSA, votre nom, le nom de la CA, et est signé numériquement par cette dernière. Les navigateurs qui reconnaissent la CA peuvent vérifier la signature du certificat, et ainsi en extraire votre clé publique RSA. Ceci leur permet de vous envoyer des messages chiffrés que vous seul pourrez déchiffrer.
• Clé RSA (server.key)
  Un fichier de clé privée RSA est un fichier numérique que vous pouvez utiliser pour déchiffrer des messages qui vous ont été envoyés.
  Il a son pendant à caractère public, que vous pouvez distribuer (par le biais de votre certificat), ce qui permet aux utilisateurs de chiffrer les messages qu'ils vous envoient.

1 - Ouvrez le tiroir "Serveur web" puis cliquez sur le bouton [Configuration] pour obtenir l'écran de configuration de la configuration HTTPS.

2 - Vérifiez la connexion ssl (HTTPS) et activez-la si besoin en sélectionnant la valeur 'yes'.

3 - Renseignez la valeur du paramètre 'apacheport' définissant le port d'écoute du serveur http front-office présent dans toutes les requêtes http vers ce serveur.

4 - Renseignez la valeur du paramètre 'apacheportssl'.

2.2. Installer les certificats

Ce paragraphe explique comment configurer SSL sur le serveur X3WEB pour utiliser des certificats certifiés par une autorité de certification. Le fichier de configuration du protocole SSL du serveur Apache est généré lors de l'installation du serveur X3WEB.
- Path : WebTools\SOFTS\HTTPD\conf\extra\httpd-ssl.conf
- WebTools est le répertoire 'Tools' défini lors de l'installation du serveur X3WEB

Les emplacements des fichiers certificat (.crt) et clé privée (.key) sont les suivants.
- WebebTools\SOFTS\HTTPD\conf\server.crt
- WebTools\SOFTS\HTTPD\conf\server.key

Les fichiers 'server.crt' et 'server.key' livrés par défaut sont des fichiers de test livrés par Apache.
Le fichier 'server.crt' n'est pas certifié par une autorité de certification et n'est donc pas reconnu par les navigateurs.
Pour configurer correctement le protocole SSL il faut générer un fichier clé privée server.key et effectuer une demande de certificat (server.crt) auprès d'une autorité de certification. Il faut ensuite remplacer les fichiers existant en conservant le même nom.

 Lorsqu'un serveur X3WEB est patché, les fichiers server.crt et server.key doivent être sauvegardés et recopiés après installation du patch.

2.3. Configuration du portail

 Le paramétrage de la fiche Site est réalisé dans Sage HRM. Vous pouvez vous reporter au § correspondant de cette documentation.

3. Publication du dossier

1 - Dans le tiroir "Serveur web", sélectionnez le serveur sur lequel est publiée la solution puis choisissez la solution dans la partie droite de l'écran.
Si la solution n'est pas présente dans la liste, cliquez sur le bouton [Ajouter] puis sélectionnez la solution. Validez par le bouton [Ok].
2 -  Dans la partie basse de l'écran, cochez et le ou les dossiers à publier.

4. Configuration du pool pour un dossier

Un pool de connexion est un ensemble de 'clients X3' connectés sur un même dossier. Ces clients sont utilisés pour exécuter les appels des web services (CALLIU) vers des sous programmes L4G.

4.1. Vérification des licences

Ouvrez la fonction "Visu licence" dans Sage HRM (VISULIC) et vérifiez que le nombre de licences de type 'Web services' est au moins égal au nombre de sessions de type 'Web services' à créer.

4.2. Sélection du dossier et création du pool

• Dans la Console, cliquez sur le bouton [Webservices] du tiroir "Serveur web" puis sélectionnez l'un après l'autre les dossiers pour lesquels un pool doit être configuré.
• Cliquez sur le bouton [Ajouter].
  Saisissez les paramètres du pool et cliquez sur [Appliquer] pour valider les modifications.
  Répétez la manupulation pour chaque dossier sélectionné.

Champs

Alias : identifiant du pool de connexion. L'alias doit être saisi en lettres majuscules.

Taille du groupe : nombre de connexions X3 allouées pour ce pool.
 Le nombre de licences webservices doit être suffisant.

Taille initiale du groupe : nombre de connexions X3 ouvertes au démarrage du serveur X3WEB. La valeur doit être égale à celle de la taille du groupe.

Langue, Utilisateur X3, Mot de passe X3, Utilisateur Système, Mot de passe système : ces paramètres sont ceux de la fenêtre de connexion au dossier (FIchier/Configuration des applications).
 L'utilisateur X3 utilisé pour configurer le pool de web services doit être autorisé.

Connexion automatique : la valeur doit toujours être 'on' afin que le pool puisse démarrer lors du démarrage du serveur X3WEB.

Entrées réservées : la valeur doit toujours être 'on' afin que le pool puisse démarrer lors du démarrage du serveur X3WEB.

5. Configuration du site Sage HRM Portal par défaut

Un site "Safe X3 WAS" peut être paramétré par défaut afin d'éviter la saisie des paramètres (solution, dossier, site et langue) dans l'url du portail.

5.1. Configuration du site

• Sélectionnez le serveur hébergeant l'application Sage HRM Portal dans le tiroir "Serveurs web" .
• Ouvrez la fenêtre de configuration du serveur (bouton [Configuration]) puis modifiez les paramètres 'gensetup.defsite.' de la façon suivante :
• Gensetup.defsite.x3sol : entrez le code de la solution,
• Gensetup.defsite.x3fld : indiquez le code du dossier X3 de l'application HRM,
• Gensetup.defsite.xtdsite : renseignez le code du site 'Safe X3 WAS'. Dans notre configuration, nous utilisons le code PORTAIL.
• Cliquez sur le bouton [Configurer] pour enregistrer le paramétrage.

Exemple :
L'url http://host:port/xtend/pag correspondra à l'url http://host:port/xtend/page?SITE=PORTAIL&FLDR=CodeDossierHRM&SOL=CodeSolutionHRM

5.2. Configuration de la langue par défaut

Dans la fenêtre de configuration du serveur web (bouton [Configuration]), renseignez le paramètre  gensetup.deflang du Serveur xtend permettant la sélection de la langue par défaut des pages html. Cette langue est appliquée par défaut si aucun code langue n'est présent dans l'url.
Si aucun paramètre n'est précisé, la langue appliquée sera celle définie dans le paramètre console 'all.host.language'.

Installation de composants à l'aide d'un wizard

L'installation et le paramétrage de certains composants sont réalisés automatiquement par l'Assistant d'installation et mise à jour du portail.

  Vous pouvez consulter le détail des actions réalisées par l'assistant dans l'annexe dédiée.

Création et configuration du portail

Ce paragraphe décrit la procédure de création et configuration du portail SHRMPORTAL dans le dossier de l’application HRM.

 Pour effectuer cette opération, vous devez vous connecter sur le dossier de l’application HRM avec un compte administrateur.

1. Paramétrage des utilisateurs

Tous les salariés qui accèdent au portail doivent disposer d’un login X3 propre avec :

• une connexion web activée,
• un ‘Profil Safe X3 WAS’.

1.1. Création des profils Safe X3 WAS

• Ouvrez la fonction Profil Safe X3 WAS (GESAYH) puis créez trois profils (ADMIN, MGR, USER) en associant le code du site (SHRPORTAL) et le profil du site web.
• ADMIN (administrateur du portail) : accède à la fonction Administration du portail permettant d'attribuer les droits d'accès aux autres fonctions du portail en fonction du profil Safe X3 WAS (MGR, USER) de l'utilisateur.
• MGR (manager) : accède à certaines options des fonctions du portail.
• USER (salarié).

 La fonction Création utilisateurs (CREUSR) permet la création d'utilisateurs en masse.

1.2. Paramétrage des utilisateurs

• Ouvrez la fonction Utilisateurs (GESAUS). Pour chaque utilisateur,
• Dans l'onglet "Général",
• cochez la case 'Connexion Web services' pour donner accès au site web du portail et à l'appel des web services,
• indiquez le profil Safe X3 WAS (ADMIN, MGR ou USER).
• Dans l'onglet "Paramètres",
• pour le chapitre Tronc commun / groupe DEF, effectuez un clic droit et cliquez sur l'option 'Détail'.
  Sélectionnez un salarié pour le paramètre REFNUM et enregistrez par le biais du bouton [Ok].

2. Paramétrage du Workflow

2.2. Signature des Worflows

Ouvrez la fonction Gestion des abonnements (GESABA). Cet abonnement doit lancer la tâche 'AWRKSIG' (le code de l'abonnement est identique) avec une fréquence que nous recommandons toutes les cinq minutes sur les périodes d’utilisation du portail.

3. Accès au site Sage HRM Portal / Paramétrage du serveur X3WEB

Ouvrez la console web : http://racine du serveur web/root/index.jsp

• Cliquez sur l'onglet "Serveur de web services" et vérifiez le démarrage du pool.
  Statelib doit avoir pour valeur "démarré".
• Cliquez sur l'onglet "Serveur Xtend" puis sur "Sites" dans la liste gauche (bloc "Services").
  Cliquez sur le lien "Liste des sites publiés" puis sur le site ".../SHRMPORTAL".
  Accédez au site en activant le bouton [Accéder au site].

L'url d'accès direct au site doit être "http://hostX3Web:port/xtend/page?SOL=SOLUTION&FLDR=DOSSIER&SITE=SHRMPORTAL&LANG=FRA".
L'url simplifiée d'accès au portail est : http://host/port/shrmportal/CodeSolutionHRM/CodeDossier/SHRMPORTAL(/CodeLangue)

4. Paramétrage de la fiche Site

Pour effectuer cette opération vous devez vous connecter sur le dossier de l’application HRM avec un compte administrateur.

• Page de login
  Dans la fonction Pages Web (GESAYG), sélectionnez 'HTTPS' dans le champ Protocole de l'onglet "Général" puis validez et enregistrez.
• Pages du portail
  Dans la fonction Pages Web (GESAYG), sélectionnez 'HTTPS' dans le champ Protocole de l'onglet "Avancé" puis validez et enregistrez.
    L'utilisation du protocole https pour toutes les pages du portail risque de pénaliser les temps de réponse et d’augmenter la charge du serveur X3WEB. En effet,  toutes les données échangées entre le navigateur et le serveur sont encryptées puis décryptées.

Fonctionnement de Sage HRM Portal

L’application Sage HRM Portal est une application web de type Ajax. Elle propose aux salariés de l’entreprise un ensemble de fonctions liées aux ressources humaines accessibles au travers d’un navigateur Web. L’application a été validée sur les navigateurs FireFox et Internet Explorer 8 et 9 mais fonctionne aussi avec Chrome et Opéra.
Sage HRM Portal permet de déporter une partie des fonctions RH auprès des salariés et des managers. Par exemple, les salariés peuvent gérer eux-mêmes la mise à jour de leurs données personnelles (changement d'état civil, naissance…), ainsi que les demandes de congés, les notes de frais... De leur côté, les managers valident ces demandes grâce aux Workflows et gagnent en visibilité en accédant aux plannings complets de leurs équipes…

L’accès aux fonctions nécessite au préalable une identification du salarié via la page de login. Les utilisateurs du portail sont gérés comme des utilisateurs Sage X3 (login, mot de passe..) mais ils ne disposent pas nécessairement des droits leur permettant de se connecter à l’application avec un client standard.

1. Composants du portail

Les différents composants qui entrent en jeu dans l’application Sage HRM Portail sont les suivants :

• le navigateur Web,
• le serveur http (Apache),
• le serveur Web (TomCat),
• le serveur X3WEB.

1.1 Le navigateur Web

Le navigateur Web charge et exécute l’application cliente Ajax. Cette application est constituée d’un ensemble de fichiers Html, JavaScript, Css et images.
L’application Sage HRM portail est développée en JavaScript et s’exécute dans le navigateur WEB. Cette application communique avec Sage HRM via l’appel de web services (requête http de type REST).
Comme toutes les applications Ajax, Sage HRM Portal utilise un cookie session pour identifier l’émetteur des requêtes http. Il est donc obligatoire d’autoriser au minimum les cookies de type session pour le site HRM Portal.

1.2. Le serveur http (Apache)

Le serveur http reçoit et traite les requêtes http en provenance du navigateur Web en les redirigeant vers l’application web Sage X3 WAS. La page de login utilise le mode sécurisé (https) pour encrypter les paramètres lors de l’appel du service de LOGIN. Les options HTTPS (all.apache.apacheportssl et all.apache.apacheportssl) doivent être activées dans les paramètres de la console.

1.3. Le serveur d'application Web (Tomcat)

Le portail est constitué des deux ‘Web applications’ suivantes.

1.3.1. L’application web ‘Safe X3 WAS' ou XTEND

L'application 'Safe X3 WAS' gère la session utilisateur. Elle interprète et exécute les requêtes en provenance du navigateur, délivre les fichiers (html, JavaScript, Css…) et gère la personnalisation.

1.3.2. L’application web serveur de web services

L'application web serveur des web services publie les sous-programmes ou objets X3 comme des services accessibles aux applications tierces via le protocole SOAP. L’application Sage X3 WAS communique avec le back-office X3 exclusivement au travers de l’appel de web services.
L’application Sage HRM Portal fonctionne uniquement si les Services web sont opérationnels, c'est-à-dire s’ils ont été publiés et sont bien accessibles au travers d‘un ‘pool de web services’ qui pointe sur le dossier X3. Nous conseillons de tester le fonctionnement du serveur de web service indépendamment du portail avant toute mise en oeuvre de Sage HRM Portal.

1.4. Le serveur X3WEB

Le serveur X3WEB héberge le serveur http et les applications web.

1.4.1. Hébergement dans un seul serveur X3WEB

Dans ce cas, les applications ‘Sage X3 WAS’ et ‘Serveur de web services’ peuvent communiquer via un ‘Bus interne’ optimisé qui évite de passer par le protocole SOAP/HTTP (voir paramètre ‘Bus Interne’ du ‘Site X3 WAS’). Cette configuration est la plus simple à administrer. Elle est conseillée pour un usage du portail en Intranet (sur le LAN de l’entreprise).

1.4.2. Hébergement dans deux serveurs X3WEB

Dans cette configuration se trouve un serveur X3WEB ‘FrontOffice’ qui héberge l’application ‘Sage X3 WAS’ et un serveur X3WEB dédié à la publication des web services. Ces deux applications communiquent via HTPP/SOAP.
Cette configuration est recommandée pour un usage du portail en Extranet lorsque les utilisateurs accèdent au portail via Internet ou en dehors du LAN. Elle permet de ne pas exposer les services web directement sur Internet et optimise la communication entre le serveur de web services et le back-office X3. Il est conseillé d’installer le serveur X3WEB qui héberge l’application de web services sur le même réseau LAN que le serveur X3 qui est généralement plus stable qu’une communication de type WAN.

2. Architecture

2.1. Application

2.2. Client

2.3. Communication inter-composants

3. Communication Sage HRM Portal / X3

3.1. Pools de connexions

Chaque salarié connecté au portail dispose d’une session utilisateur Web gérée par le serveur X3WEB (Apache + TomCat + X3 WAS) mais ne dispose pas d’une session X3 (processus Adonix) dédiée. Il n’est en effet pas envisageable de créer autant de sessions X3 que de salariés de l’entreprise pour gérer la communication entre Sage HRM Portal et l’application Sage HRM.

La communication entre le portail et le serveur X3 est basé sur un ensemble de connexions X3 mutualisées pour tous les salariés. Cet ensemble de connexions est appelé ‘Pool de connexions’ ou ‘Pool de web services’. Il est constitué d’un certain nombre de clients X3 (paramétrable via la console) qui sont en attente d’exécution de traitements.

Lorsqu’un utilisateur invoque un service X3, par exemple une demande de soldes de congés :

1. Le navigateur web émet une requête (http) à destination du serveur X3 WAS (XTEND).
2. XTEND détermine le (les) service(s) X3 (sous-programme) à invoquer et s’adresse au serveur de web services pour les exécuter.
3. Le serveur de web services récupère les paramètres (JSON) et les transforme en paramètres X3 puis il s’adresse au ‘pool de connexions’ pour demander l’exécution du traitement. Pour effectuer la demande de traitement, le serveur empile la demande dans une pile de demandes (First In First Out – FIFO).
4. Le ‘pool de connexions’ lit la pile des demandes (peek) et cherche une connexion (client X3) libre pour la demande en attente.
5. Si une connexion est libre il la réserve pour exécuter le traitement X3 (CALLIU). Il libère la connexion et dépile la demande lorsque l’exécution du traitement est terminée.
Dans le cas du portail HRM, le serveur de web services fait un changement d’utilisateur avant exécution du traitement. Le loginX3/Mot de passe sont transformés en paramètre lors de l’appel du service par XTEND.
6. Si aucune connexion libre n’a été trouvée, la demande n’est pas dépilée et sera traitée lorsque qu’une connexion sera libérée.

3.2. Dimensionnement

Le dimensionnement du pool de connexions est déterminant pour obtenir des temps de réponse optimums. Il est très difficile d’estimer le nombre de connexions requises pour assurer une bonne fluidité dans la navigation du portail. 
Les licences web service sont considérées comme des clients X3 à part entière. Il faut donc dimensionner (configurer) le(s) machine(s) qui héberge(nt) le serveur X3 et le serveur de base de données en conséquence. Pour optimiser les temps de réponse il est conseillé d’installer le serveur X3WEB et le serveur X3 sur le même LAN.
La charge désigne le nombre et les types d'utilisateurs, le périmètre fonctionnel déployé et le nombre de requêtes simultanées à traiter. La charge d’une application de type Portail RH Sage peut être calculée sur la base des paramètres suivants :

• les utilisateurs potentiels: nombre d'utilisateurs qui peuvent se connecter dans l’application.
  
• les utilisateurs simultanés actifs : nombre d'utilisateurs qui sont connectés dans l’application au même moment et qui sont en interaction avec le système. Ces interactions comprennent des fonctionnalités telles la validation de notes de frais, la validation de congés, la consultation des soldes, etc.
• les requêtes simultanées : nombre de requêtes générées au même moment par les utilisateurs simultanés actifs. Le nombre de requêtes simultanées est déterminé par le type d'utilisation selon la nature de fonctionnalités qu’ils exploitent et la fréquence avec laquelle ces utilisateurs interagissent avec le système.

Parmi ces paramètres, le nombre d'utilisateurs simultanés actifs et le nombre de requêtes simultanées sont cruciaux pour déterminer les ressources requises (taille du pool de connexion) et le dimensionnement des machines à prévoir pour répondre à la charge.

3.3. Contrôle des licences 'Web services'

Ouvrez la fonction Visu licence (VISULIC) et controlez le nombre d'utilisateurs dans le champs 'Web services'.

4. L'application Sage HRM Portal

Sage HRM Portal est composé de :

• un site X3 WAS (Xtend),
• un projet html,
• un ensemble de webservices X3.

4.1. Le site X3 WAS (Xtend)

Le site XTEND est un ensemble de fonctions X3 qui décrivent les éléments utilisées par l’application Web.
Le site par défaut a pour identifiant SHRMPORTAL. Pour que les modifications des fiches 'site' soient prises en compte, cliquez sur le bouton [Valider] qui génère un fichier XML à destination du serveur X3WEB.

4.1.1. Paramètres du site

La fonction Sites Web (GESAYS) permet de saisir les paramètres généraux et avancés du site.

4.1.2. Interfaces (Web services)

La fonction Interface (GESAYI) décrit toutes les interfaces (web services) entre le site (application web) et le back-office X3 Voir paragraphe web services ci-dessous.

4.1.3. Liste de valeurs

La fonction Liste de valeurs (GESAYC) décrit les listes de valeurs (menus, list-boxes, groupe de radio) utilisées par l’application portail et permet la personnalisation des libellés.

4.1.4. Validation

La fonction Validation site web (AYTFCYGEN) valide et génère le dictionnaire XTEND à destination du serveur X3WEB. Cette opération est conseillée après chaque modification des paramètres du site

4.1.5. Profils

La fonction Profils site Web (GESAYD) liste les profils utilisateurs de l’application portail (ADMIN, MANAGER, USER). L’administrateur doit créer un profil ‘Profil Safe X3 WAS’ par profil XTEND puis associer un ‘Profil Safe X3 WAS’ pour chaque utilisateur X3 du portail.

4.2. Projet HTML

Un ensemble de fichiers html, javascripts, css, images, sont chargés par le navigateur web. Ils constituent l'application cliente Ajax Sage HRM Portal, qui est chargée et exécutée par le navigateur. Ces fichiers sont stockés dans le dossier SOLUTION/DossierX3/X_TEND/SITEX3WAS.
Par exemple : SOLUTION/dossiers/X3_PUB/DOSSIER/X_TEND/X_HTML/SITEX3WAS.
Tous les fichiers du projet HTML doivent avoir au minimum les permissions en en lecture pour le compte utilisé pour installer le serveur X3.

4.2.1. Chargement des fichiers
Le chargement de ces fichiers par le navigateur (url) transite par le serveur X3WEB (application
XTEND) qui joue le rôle de ‘Proxy’.
Le serveur XTEND décode l’url, identifie les Solution/Dossier/Site, lit le fichier X3 dans X3_PUB (url) et renvoie le contenu au navigateur.
Exemple d’url :
http://serveurweb:port/xtend/datarh/remote/SOLUTION/DOSSIER/X_TEND/X_HTML/RECETTE/_rh/images/x3doc.png

Tout serveur X3WEB sur lequel est publié le dossier de PAIE peut servir de ‘front-office web’ pour le portail.

4.3 Web services

Ouvrez la fonction Web services (GESAWE) pour publier le service.
Tous les web services de type ‘Sous programme’ doivent être déclarés auparavant dans la fonction Sous-programmes (GESASU).