19/06/202

Gateway 0

Document d’Installation applicative

PROJET : Gateway

VERSION : 2.0.0 - STATUT : Draft

Suivi des modifications
Applicable depuis : 08/06/2020

Version Date Auteur Modifications apportées

3.0.0 19/06/2020 Hajjaji Mohammed Config Browser + Config header X-Forwarded-For
3.0.0 19/06/2020 Bouarourou Fouad Config Browser+ Config header X-Forwarded-For

Liste de Diffusion

618366094.docx. Page | 1 sur 8

 19/06/202
Gateway 0

Nom Fonction Entité

Monsieur Fonction A Entité A
Madame Fonction B Entité B

618366094.docx. Page | 2 sur 8

 19/06/202
Gateway 0

SOMMAIRE
1 INTRODUCTION.....................................................................................................................................

1.1 OBJET DU DOCUMENT..................................................................................................................................

1.2 ENVIRONNEMENTS......................................................................................................................................
1.3 ORGANISATION DU DOCUMENT......................................................................................................................

2 ABRÉVIATIONS ET ACRONYMES.............................................................................................................

3 DESCRITION GENERALE DE LA SOLUTION...............................................................................................

4 INSTALLATION ET CONFIGURATION :......................................................................................................

4.1 PRÉ REQUIS LOGICIEL & INFRASTRUCTURE........................................................................................................

4.2 INSTALLATION.............................................................................................................................................
4.2.1 Configuration du Browser.................................................................................................................
4.2.2 Web Service qui retourne USER.LAST.IP...........................................................................................
4.2.3 Installation du Proxy.........................................................................................................................

618366094.docx. Page | 3 sur 8

 19/06/202
Gateway 0

1 INTRODUCTION

1.1 Objet du document

Ce document a pour but de décrire la procédure d’installation de la solution PROXY
« Ne pas inclure les procédures d’installation des outils techniques tel que CFT,… etc»

1.2 Environnements
Ce document est applicable lors de phase de développement / de test ou bien de mise en production

1.3 Organisation du document

 Le chapitre 1 constitue l'introduction du document ;
 Le chapitre 2 présente les abréviations et acronymes ;
 Le chapitre 3 présente les documents généraux du projet où cette solution est utilisée.
 Le chapitre 3 présente les procédures de l’installation de cette solution.

2 Abréviations et acronymes

N/A Non Applicable

etc

618366094.docx. Page | 4 sur 8

 19/06/202
Gateway 0

3 DESCRITION GENERALE DE LA SOLUTION

Documents de référence

Réf. Nom du document Chemin d’accès

1 Document d’architecture technique \\PartageA
2 Document d’architecture fonctionnelle \\PartageB

618366094.docx. Page | 5 sur 8

 19/06/202
Gateway 0

4 Installation et Configuration :

4.1 Pré requis Logiciel & Infrastructure

- Voir les documents d’architecture Technique et Applicative.
- Prérequis :
o La machine doit avoir JDK 8

4.2 Installation
4.2.1 Configuration du Browser
1. Dans le BrowserWeb.war modifier le fichier BrowserParamateres.xml pour ajouter la valeur
‘Default’ dans le tag ‘hostName’ comme suit :
                                  <parameterName>hostName</parameterName>
                                  <parameterValue>default</parameterValue>
1. La routine AB.SIGN.ON.RTN doit être déclarée dans EB.API
2. La routine doit être attachée à tous les utilisateurs dans le champ SIGN.ON.RTN de la table
USER
Pour le faire une DMD a été créé sur RG1 sous le nom  DMD/DSC : BCP.USER.GATEAWAY.MIG
, qui utilise un fichier d'entrée contenant tous les ID utilisateurs à modifier .

DMD/DSC : BCP.USER.GATEAWAY.MIG

Fichier : BCP.USER.MIG.GATEAWAY.txt

3. Installer la dernière version du Browser contenant le code JS qui prend en compte l’ajout du
paramètre userID dans l’URL de la requête vers les APIs (Editique, GED, ….)
4. Au niveau de la table BROWSER.TOOLS, configurer le champ ITEM pour pointer sur la
Gateway pour les services cachés par la Gateway,

618366094.docx. Page | 6 sur 8

 19/06/202
Gateway 0

618366094.docx. Page | 7 sur 8

 19/06/202
Gateway 0

4.2.2 Configuration du fichier application.properties (voir le dossier

d’exploitation)

4.2.3 Configuration du header X-Forwarded-For

Le header X-Forwarded-For doit etre activé au niveau des configs VS et IHS pour transférer l’@IP
du client.

Du coté netscaler , le header x-forwarded-for de l’entête http doit être pris en compte dans les
configs des IHS pour intégrer leurs valeurs dans logs.

4.2.4 Publication du web Service qui retourne USER.LAST.IP

Publication du web service userIpApi.war qui prend en paramètre le UserID et retourne la valeur du
champ USER.LAST.IP de la table USER pour le UserID correspondant.

4.2.5 Installation du Proxy (au niveau de la machine ayant JDK8 installée)

Le projet Proxy est une application Spring Boot sous forme d’un jar, jusqu’à présent le proxy n’a pas
de concept de stockage (base de données,cache,…).

Pour démarrer le proxy, il suffit de d’éxécuter cette commande :

nohup java -jar routing-and-filtering-gateway-0.0.4-SNAPSHOT.jar --spring.config.location=application.properties &

le parameter --spring.config.location représente l’emplacement du fichier application.properties, dans ce cas il est

dans le dossier actuel.

618366094.docx. Page | 8 sur 8