Dollar Universe Manager pour Web Services Manuel utilisateur

Dllar Universe Manager pur Web Services Manuel utilisateur Versin : 6.6.01 Date de publicatin : 2016-02 Autmic Sftware GmbH

ii Cpyright Cpyright Autmic et les lg Autmic snt des marques dépsées appartenant à Autmic Sftware GmbH (Autmic). L'utilisatin de tutes les marques dépsées nécessite une autrisatin explicite écrite et est sumise aux cnditins de la licence. Les lgiciels et/u le prgramme snt la prpriété prtégée d'autmic Sftware. L'accès et l'utilisatin de ces derniers snt sumis à des cnditins de licence devant être appruvées par écrit. Les lgiciels et/u le prgramme snt également prtégés par des drits de reprductin par des cntrats internatinaux ainsi que par les lis natinales et internatinales. Un accès et/u une utilisatin nn autrisés peuvent entraîner des pursuites civiles et pénales. La cpie nn autrisée et d'autres frmes de reprductin partielle u ttale, la décmpilatin, la reprductin, la mdificatin, u le dévelppement de prduits dérivés du lgiciel snt strictement interdits. Le nn-respect de ces cnditins peut entraîner des pursuites pénales. Sus réserve de mdificatins. Aucune respnsabilité ne sera acceptée pur tute mdificatin, missin, erreur d'impressin u de prductin. Tute reprductin, ttale u partielle, est strictement interdite. Cpyright Autmic Sftware GmbH. Tus drits réservés.

Dllar Universe Manager pur Web Services Manuel utilisateur iii Table des matières 1 Release Ntes... 5 2 Intrductin... 6 2.1 Présentatin... 6 2.2 Fnctinnalités... 6 2.2.1 Fnctinnalités SOAP supprtées... 7 2.2.2 Fnctinnalités REST supprtées... 7 2.2.3 Sécurité... 8 2.2.4 Variables... 8 2.3 Architecture... 9 3 Installatin... 11 3.1 Prérequis... 11 3.2 Installer Dllar Universe Manager pur Web Services... 11 3.2.1 Structure des répertires... 11 3.2.2 Autmate Java JEE... 12 3.2.3 Emplacement des fichiers... 12 3.3 Mettre à jur Dllar Universe Manager pur Web Services... 12 4 Cnfiguratin... 13 4.1 Administrer le Manager pur Web Services... 13 4.1.1 Activer le Manager pur Java... 13 4.1.2 Activer le Manager pur Web Services... 13 4.1.3 Licence utilisateur... 14 4.1.4 Démarrer/Arrêter le Manager pur Java... 14 4.1.5 Désactiver le Manager pur Web Services... 15 4.1.6 Désactiver le Manager pur Java... 15 4.2 Paramètres nœud du Manager pur Java... 15 4.3 Paramètres du Manager pur Web Services... 17 4.3.1 SOAP... 17 4.3.2 REST... 22 4.3.3 Keystres/Truststres... 24 4.3.4 Variables glbales... 24 4.4 Jurnalisatin du Manager pur Web Services... 25 5 UniViewer Cnsle... 26 5.1 Caractéristiques cmmunes... 26 5.1.1 Expressins régulières... 26 5.1.2 Caractères spéciaux... 26 5.2 Uprcs de type Web Services... 27 5.2.1 Uprcs de type Web Services SOAP... 27 5.2.2 Uprcs de type Web Services REST... 29 5.3 Ressurces de type Web Services... 33 5.3.1 Ressurces de type Web Services SOAP... 33

iv Table des matières 5.3.2 Ressurces de type Web Services REST... 35 5.4 Cnditinner une Uprc sur une ressurce web service... 36 5.4.1 Cnditin de ressurce web service Sectin Ressurce... 37 5.4.2 Cnditin de ressurce web service Sectin Statut... 37 5.5 Exécuter un service web à l'aide de Dllar Universe... 38 5.5.1 Exécuter un service web... 38 5.5.2 Se synchrniser sur l'exécutin d'un service Web... 41 6 Cmmandes... 44 6.1 Créer une Uprc Web Service SOAP... 44 6.1.1 Uprc SOAP Infrmatins générales... 44 6.1.2 Uprc SOAP Cnfiguratin spécifique... 45 6.1.3 Uprc SOAP Statut... 45 6.1.4 Uprc SOAP Dnnées en entrée... 46 6.1.5 Uprc SOAP Dnnées en srtie... 46 6.2 Créer une Ressurce Web Service SOAP... 47 6.2.1 Ressurce SOAP Infrmatins générales... 48 6.2.2 Ressurce SOAP Cnfiguratin spécifique... 48 6.2.3 Ressurce SOAP Dnnées en entrée... 49 6.3 Cnditinner une Uprc sur une ressurce Web Service SOAP... 49 6.4 Créer une Uprc Web Service REST... 50 6.4.1 Uprc REST Infrmatins générales... 51 6.4.2 Uprc REST Gestin des entêtes http... 52 6.4.3 Uprc REST Paramètres de l'url... 52 6.4.4 Uprc REST Paramètres de fichiers... 53 6.4.5 Uprc REST Infrmatins pur la requête... 54 6.4.6 Uprc REST Statut... 54 6.4.7 Uprc REST Dnnées en srtie... 56 6.5 Créer une Ressurce Web Service REST... 58 6.5.1 Ressurce REST Infrmatins générales... 58 6.5.2 Ressurce REST Gestin des entêtes Http... 59 6.5.3 Ressurce REST Paramètres de l'url... 60 6.5.4 Ressurce REST Paramètres de fichiers... 60 6.5.5 Ressurce REST Infrmatins pur la requête... 61 6.6 Cnditinner une Uprc sur une ressurce Web Service REST... 61 6.7 Démarrer/Arrêter le service JEE... 64 7 A prps d'autmic, de la cmmunauté et des services... 65 7.1 La sciété Autmic Sftware... 65 7.2 La cmmunauté Autmic... 65 7.3 Centre de téléchargement... 65 7.4 Supprt technique... 66 7.5 Frmatin et services... 66

Chapitre 1 Release Ntes 5 1 Release Ntes Le tableau ci-dessus récapitule l'histrique des mdificatins. Les infrmatins sur les crrectins de prblèmes et sur les prblèmes cnnus snt dispnibles dans les Release Ntes Wrklad Autmatin u en cntactant le supprt technique d'autmic. Date Fnctinnalités clés 11-2014 Les manuels utilisateurs de Dllar Universe changent de lk pur s'intégrer dans le mnde Autmic. 03-2015 Crrectins sur la prcédure d'activatin du Manager

6 Chapitre 2 Intrductin 2 Intrductin Bienvenue dans le Manuel Utilisateur de Dllar Universe Manager pur Web Services! Ce manuel est un guide d'utilisatin de Dllar Universe Manager pur Web Services. Il décrit : L implémentatin : l installatin, la cnfiguratin et les cmmandes d administratin, Les interfaces l utilisateur : UniViewer Cnsle et l interface ligne de cmmande. Dllar Universe Manager pur Web Services permet à des Uprcs de Dllar Universe : D'invquer un service web au frmat SOAP u REST De se synchrniser (via les cnditins des ressurces spécifiques Web Services) sur l'exécutin d'un service web au frmat SOAP u REST. 2.1 Présentatin Ce manuel est destiné aux dévelppeurs et pérateurs ayant besin de cmprendre rapidement les fnctins de Dllar Universe Manager pur Web Services. Le lecteur est suppsé être familier avec Dllar Universe et les services web SOAP u REST. Les services web permettent la cnsultatin et la manipulatin à distance d'infrmatins en utilisant les technlgies du Web. Afin de garantir l'interpérabilité des applicatins dévelppées sur le web, deux standards snt apparus, en résumé : L'architecture rientée services (SOAP) qui utilise des messages au frmat XML transprtés à l aide du prtcle http. L'architecture rientée ressurces (REST) qui utilise le prtcle http. Le cntenu puvantêtre sus n imprte quelle frme (XML, JSON, ). Dllar Universe Manager pur Web Services permet l'utilisatin de l'une u l'autre. 2.2 Fnctinnalités Dllar Universe Manager pur Web Services permet l'invcatin synchrne de services web au frmat SOAP u REST et la synchrnisatin sur l'exécutin d'un service web au frmat SOAP u REST sur le serveur Web. L'invcatin d'un service web est réalisée par l'exécutin d'une Uprc de type Web Service SOAP u REST. La synchrnisatin sur l'exécutin d'un service web est réalisée par le cnditinnement d'une Uprc (quelle qu'elle sit) sur une ressurce de type Web Service SOAP u REST. Le service web est identifié par un nm unique, indépendant de sn URL, garantissant ainsi la pérennité du paramétrage dans Dllar Universe indépendamment de l'évlutin des applicatins web. Le paramétrage général du Manager et la prédéfinitin des services web permet de simplifier l'utilisatin des Uprcs et des ressurces Web Services. La cnfiguratin est réalisée dans UniViewer Cnsle, la créatin/mise à jur des Uprcs et des ressurces de type Web Services peut être réalisée dans UniViewer Cnsle u en mde cmmandes.

Chapitre 2 Intrductin 7 Lrs de l'utilisatin d'un service web de type SOAP, le fichier de cnfiguratin WSDL est téléchargé par le manager et permet à l'utilisateur de dispser d'une aide à la saisie des valeurs dans UniViewer Cnsle lrs du paramétrage des Uprcs et des ressurces. 2.2.1 Fnctinnalités SOAP supprtées SOAP Le manager supprte SOAP 1.1 et 1.2. Représentatin WSDL Le manager supprte WSDL 1.1 mais ne supprte pas WSDL 2.0. Représentatin XSD Le manager supprte le schéma de spécificatins XML, cependant certains détails divent être précisés : Les attributs ne peuvent pas avir d'espace de nms. Les éléments "xs:any" et "xs:anyattribute" ne snt pas supprtés et snt ignrés par le manager. Prtcle HTTP Le manager envie des requêtes HTTP v1.1. HTTPS/SSL Le manager supprte HTTPS mais peut avir besin d'un truststre externe si le certificat n'est pas signé par une autrité de certificatin recnnue par Oracle (et déjà présente dans le truststre par défaut). Fichiers jints Le manager ne supprte pas les fichiers jints pur SOAP. XPath Le manager supprte les requêtes standards Xpath. Regex Le manager supprte les expressins régulières DOTALL. 2.2.2 Fnctinnalités REST supprtées Prtcle HTTP Le manager envie des requêtes HTTP v1.1. HTTPS/SSL Le manager supprte HTTPS mais peut avir besin d'un truststre externe si le certificat n'est pas signé par une autrité de certificatin recnnue par Oracle (et déjà présente dans le truststre par défaut). Fichiers jints Le manager supprte les fichiers jints pur REST utilisant MIME. La taille ttale des fichiers jints ne dit pas dépasser 20 M. Analyse JSON Le manager ne supprte pas tute la syntaxe JSON. La seule syntaxe supprtée est :

8 Chapitre 2 Intrductin Expressin a.b a.b[0] Descriptin Extraire la prpriété b de a Extraire le premier élément du tableau placé dans la prpriété b de a XPath Le manager supprte les requêtes standards XPath. Regex Le manager supprte les expressins régulières DOTALL. 2.2.3 Sécurité Plusieurs niveaux de sécurité peuvent être implémentés pur l'invcatin/la synchrnisatin des services web SOAP : Hradatage L'élément d'hrdatage est supprté. Il est pssible de définir la précisin à la secnde u à la millisecnde. Jetn utilisateur Signature Chiffrement SAML Le jetn utilisateur est supprté. Il est pssible d'ajuter un nnce u la date à laquelle le jetn a été créé. Reprtez-vus à la sectin "Service web SOAP - Sectin Cnfiguratin WS- Security srtante Jetn d'utilisateur" page 19. La signature est supprtée. Les types d'identificatin, les algrithmes de signature, les algrithmes de cannisatin et les algrithmes de hachage supprtés snt listés à la sectin "Service web SOAP - Sectin Cnfiguratin WS-Security srtante Signature" page 19. Le chiffrement est supprté. Les types d'identificatin, les algrithmes de cdage symétriques et les algrithmes de chiffrement supprtés u nn-supprtés snt listés à la sectin "Service web SOAP - Sectin Cnfiguratin WS-Security srtante Chiffrement" page 20. SAML n'est pas supprté. Les requêtes peuvent utiliser SSL seln l'url utilisée : http u https. Les truststres/keystres utilisés snt définis au niveau du manager et peuvent être utilisés par plusieurs services web. Le Manager utilise la spécificatin WSS 1.1 et le Basic Security Prfile 1.1 pur les services web SOAP. La RFC utilisée peut être truvée à l'adresse suivante : http://dcs.asis-pen.rg/wss/v1.1/wss-v1.1-spec-s-soapmessagesecurity.pdf https://www.asis-pen.rg/cmmittees/dwnlad.php/13392/wss-v1.1-spec-pr- UsernameTkenPrfile-01.htm La sécurisatin des web services REST se fait uniquement à l aide de https. 2.2.4 Variables Des variables utilisables dans les Uprcs u les ressurces Web Services peuvent être définies à plusieurs niveaux :

Chapitre 2 Intrductin 9 1. Variables glbales (dans les paramètres du Manager) : "Variables glbales" page 24 2. Variables d'un service web (dans les paramètres du Manager) : "Service web SOAP - Sectin Variables persnnalisées" page 18 u "Service web REST - Sectin Variables persnnalisées" page 22. 3. Variables de nœud (décrites dans la dcumentatin de Dllar Universe) 4. Variables d'ug 5. Variables d'uprc Lrs de l'exécutin de l'uprc la valeur prise en cmpte est (dans la liste ci-dessus) la dernière définie. La substitutin est réalisée par Dllar Universe puis par le Manager lrs de l'invcatin du service web. Lrs de l'exécutin d'une ressurce, les variables de nœud, d'ug et d'uprc ne snt pas utilisables. Seules les variables du service web (1 et 2) et les variables héritées par l'uprc cnditinnée snt utilisables. Dans les cmmandes, une variable dit être appelée sus la frme!var!. Sus UNIX/Linux, le nm des variables ne dit pas cmmencer par un chiffre (restrictin du système d'explitatin). 2.3 Architecture L'invcatin d'un service web sur un serveur web est réalisée au sein de Dllar Universe seln le schéma présenté ci-dessus : Figure 1 : Sumissin d'un service web par Dllar Universe L'utilisateur définit des Uprcs et des ressurces de type Web Services (SOAP u REST) se basant sur des services web déclarés dans les paramètres du Manager. La sumissin d'une Uprc et l'attente d'une cnditin de ressurce de type Web Service (SOAP u REST) sumet l'invcatin du service web asscié sur le serveur web de façn synchrne.

10 Chapitre 2 Intrductin Figure 2 : Cmpte rendu d'exécutin du service web Le Manager analyse le cmpte rendu d'exécutin du service web et, en fnctin du paramétrage de l'uprc u de la cnditin de ressurce, établit le statut de l'exécutin / valide la cnditin. La trace de l'exécutin du service web peut être inscrite dans le jurnal d'exécutin de l'uprc qui a sumis le service web u de la ressurce cnditinnante.

Chapitre 3 Installatin 11 3 Installatin Dllar Universe Manager pur Web Services est basé sur le service Java de Dllar Universe. L'installatin de Dllar Universe Manager pur Web Services est dnc réalisée lrs de l'installatin du service Java de Dllar Universe. Une cnfiguratin supplémentaire, décrite ci-dessus, est nécessaire à l'utilisatin des services web. 3.1 Prérequis Pur plus d infrmatins sur les systèmes d explitatin et sur la cmpatibilité avec les autres prduits Dllar Universe, reprtez-vus à la matrice de cmpatibilité ("Cmpatibility Matrix") accessible sur le site web du Service Clients, dans l nglet "Cntent". Dllar Universe Manager pur Web Services/Java requiert un Java Runtime Envirnment (JRE). Si aucun JRE n'est installé, vus puvez le télécharger depuis la page http://java.cm/fr/ 3.2 Installer Dllar Universe Manager pur Web Services Dllar Universe Manager pur Web Services est une partie intégrante de Dllar Universe et est supprté par le Manager pur Java. Lrs de l'installatin de Dllar Universe sur la machine, dans le dialgue "Managers installatin" sus Windws u "Usage f the ODB, EJB, JMS, WSC Managers" sus UNIX/Linux, tris ptins snt prpsées pur le service Java : Remve service ("r") : le service Java n'est pas installé. Aucun Manager basé sur le Manager Java ne purra être activé. Keep service ("k") : le service Java est installé mais devra être activé par la suite. Reprtezvus à la sectin "Activer le Manager pur Java " page 13. Activate service ("a") : le service Java est installé et activé. Le chemin d'accès cmplet à un JRE/JDK valide dit être saisi. Par exemple C:\Prgram Files\Java\jre7 sus Windws u /usr/bin/java sus UNIX/Linux. Le service Java est utilisé par le Manager pur Oracle Database, par le Manager pur Micrsft SQL Server, par le Manager pur Java (JMS et EJB) et par le Manager pur Web Services. Si le service Java n'est pas installé, aucun de ces Managers ne purra être activé/utilisé. Une fis l'installatin terminée et le service Java activé, l'utilisateur devra activer le Manager pur Web Services. Reprtez-vus à la sectin "Activer le Manager pur Web Services" page 13. 3.2.1 Structure des répertires L installatin cpie les fichiers nécessaires au Manager : Le sus-répertire bin/bin_java de la Sciété, ciblé par la variable UXJEE_DIR_EXEC, cntient tus les binaires. Le sus-répertire data/data_java de la Sciété, ciblé par la variable UXJEE_DIR_DATA, cntient les dnnées et paramètres du Manager. Les fichiers cncernant les Web Services snt préfixés par ws_.

12 Chapitre 3 Installatin Le sus-répertire lg de la Sciété, ciblé par la variable UXJEE_DIR_LOG, cntient le fichier jurnal du manager : mgrjava.lg. Le sus-répertire thirdparty de la Sciété cntient les fichiers internes déclarés dans les "Paramètres du Manager pur Web Services". 3.2.2 Autmate Java JEE Lrsque Dllar Universe a été installé u mis à jur en versin 6, l'autmate Java JEE a été installé. C'est un prcessus Java lancé par le serveur d'io. Lrsque l'autmate est démarré, il utilise un prt TCP dnt le numér est le numér du prt de base de la Sciété Dllar Universe (par défaut 10600) plus 16, sit 10616 par défaut. 3.2.3 Emplacement des fichiers Fichiers des Uprcs : Les scripts des Uprcs Web Services snt situés dans le répertire: <SOCIETE>\<espace>\upr. Ils snt écrits en XML. Le cdage du nm des Uprcs est décrit dans le Manuel d'administratin de Dllar Universe, sectin "Identifiants des bjets". Fichiers des ressurces : Les fichiers de descriptin des ressurces Web Services snt situés dans le sus-répertire data\res de la Sciété. Ils snt également écrits en XML. Jurnal du Manager : Le fichier jurnal du Manager est nmmé mgrjava.lg, il est situé dans le répertire lg de la Sciété. Jurnaux des exécutins : Cmme pur les autres types d'uprcs, les résultats d exécutin snt affichés dans le jurnal de l'uprc. Les traces d'exécutins du service web peuvent être inscrites par le Manager dans le jurnal d'exécutin de l'uprc si l'utilisateur a cnfiguré l'uprc pur cela. Jurnaux des ressurces Web Services Le jurnal de la ressurce est enregistré dans le sus-répertire lg\<espace> de la Sciété. Il est nmmé ${S_ESPEXE}${S_ID_UG}${S_ID_UPROC}RES.${S_NUMLANC}. Les traces d'exécutins du service web peuvent être inscrites par le Manager dans le jurnal de la ressurce si l'utilisateur a cnfiguré la cnditin de ressurce pur cela. 3.3 Mettre à jur Dllar Universe Manager pur Web Services La mise à jur de Dllar Universe v6 Manager pur Web Services est réalisée lrs de la mise à jur de Dllar Universe v6.

Chapitre 4 Cnfiguratin 13 4 Cnfiguratin 4.1 Administrer le Manager pur Web Services En mde Administratin d'univiewer Cnsle, les actins suivantes peuvent être effectuées sur le nœud Dllar Universe : Activer le Manager pur Java : le Manager pur Java est le supprt de tutes les pératins Java du nœud Dllar Universe, dnt le Manager pur Web Services. "Activer le Manager pur Web Services" page 13. Mdifier les "Paramètres du Manager pur Web Services" page 17. "Désactiver le Manager pur Web Services" page 15. "Désactiver le Manager pur Java " page 15 En mde Prductin d'univiewer Cnsle : Si Dllar Universe Manager pur Java est activé sur le nœud Dllar Universe : Suivi > Autmates pur afficher si le Manager est démarré u nn. L'autmate Java JEE ne peut être démarré que si Dllar Universe est démarré. 4.1.1 Activer le Manager pur Java Cette actin est valide si le Manager pur Java est installé mais n est pas actif. Cette actin permet d activer la gestin des pératins Java sur le nœud Dllar Universe. Elle permet également d'activer par la suite les Managers rattachés : EJB, JMS, Web Services, Oracle DB u Micrsft SQL Server. Dans UniViewer Cnsle, en mde Administratin, cliquez sur la sectin Nœuds > Nœuds. Sélectinnez le nœud Dllar Universe v6 et cliquez sur Mdifier. Dans la sectin Cnfiguratin Service, sélectinnez Manager Java, et cliquez sur Activer. Une fenêtre nmmée Activatin : Manager Java est affichée. Saisissez le numér de prt TCP, par défaut le numér de prt du serveur d'io X +16 est prpsé. Saisissez le chemin d'accès cmplet à une cmmande java valide (JRE/JDK), par exemple C:\Prgram Files\Java\jre7\bin\java.exe. Cliquez sur Activer. Une fenêtre "Traitement " affiche les actins en curs. Lrsque l'activatin est terminée ( Fait), vus puvez cliquer sur Fermer. Le message "Succès de la prcédure d'activatin" est affiché. Cliquez sur Ok et enregistrez les mdificatins du nœud DUAS. Lrs de l'activatin, l'autmate JEE est autmatiquement démarré. 4.1.2 Activer le Manager pur Web Services Cette actin est valide si le Manager pur Java est "Activé" et si le Manager pur Web Services est "Dispnible". Dans UniViewer Cnsle, en mde Administratin, cliquez sur la sectin Nœuds > Nœuds.

14 Chapitre 4 Cnfiguratin Sélectinnez le nœud Dllar Universe v6 et cliquez sur Mdifier. Dans la sectin Cnfiguratin Service, sélectinnez Manager Web Services, et cliquez sur Activer. Une fenêtre nmmée Activatin : Manager Web Services est affichée. Saisissez une Licence utilisateur valide. Si une licence de ce Manager existe déjà dans le fichier des licences du nœud Dllar Universe elle est affichée. Cliquez sur Activer. Une fenêtre "Traitement " affiche les actins en curs. Lrsque l'activatin est terminée (" Fait"), vus puvez cliquer sur Fermer. Le message "Succès de la prcédure d'activatin" est affiché. Cliquez sur Ok et enregistrez les mdificatins du nœud DUAS. Le statut du Manager devient "Activé". 4.1.3 Licence utilisateur L utilisatin de Dllar Universe v6 Manager pur Web Services est sumise à une licence. La clé de la licence dit être déclarée dans le fichier des licences de Dllar Universe. Ce fichier %UNI_DIR_ROOT%\data\u_fali01.txt est créé par la prcédure d installatin. La licence peut être saisie : Par UniViewer Cnsle : mde Administratin > Nœuds > Nœuds, sélectinnez le nœud Dllar Universe v6 supprtant le Manager > Paramètres nœud > Licence. Ou directement par un éditeur de texte. Cette licence est spécifique au nm de nœud Dllar Universe sur lequel le Manager pur Web Services est situé. Le cde du prduit est WSC; la versin du prduit est 6. Saisissez la licence valide au frmat suivant : neud prduit versin date_expiratin clé DU6_neud DOLLAR_UNIVERSE:WSC 6 20201231 0123456789ABCDEF La licence du Manager est testée lrs de la sumissin des jbs. Si Dllar Universe est en péride de grâce, une licence WSC n'est pas nécessaire. Si Dllar Universe pssède une licence, le Manager pur Web Services devra en psséder une également, sinn les jbs ne purrnt pas être sumis. Les clés de licence peuvent être btenues depuis le site web du Service Clients u par vtre cntact cmmercial. 4.1.4 Démarrer/Arrêter le Manager pur Java Dllar Universe Manager pur Java peut être démarré u arrêté avec UniViewer Cnsle : en mde Prductin, sélectinnez l envirnnement du nœud Dllar Universe sur lequel le Manager pur Java est activé. Puis sélectinnez Suivi > Autmates pur afficher la liste des autmates. Le Manager pur Java est nmmé JEE. Il peut être démarré u arrêté (seln sn statut). L'autmate JEE est aussi utilisé par le Manager pur Oracle Database, par le Manager pur SQL Server et par le Manager pur EJB/JMS. Si vus arrêtez l'autmate JEE vus puvez interrmpre l'activité de ces Managers. Le Manager ne peut être démarré que si Dllar Universe est démarré. Dllar Universe Manager pur Java peut être démarré u arrêté à l aide de l interface cmmandes. Reprtez-vus à la sectin "Démarrer/Arrêter le Manager pur Java " page 14.

Chapitre 4 Cnfiguratin 15 4.1.5 Désactiver le Manager pur Web Services Si vus n'utilisez plus le Manager pur Web Services, vus puvez le désactiver pur libérer des ressurces. Cette actin n est pssible que si le Manager pur Web Services est actif. Si vus désactivez ce service, la gestin des pératins Web Services définis pur ce nœud Dllar Universe sera interrmpue. Dans UniViewer Cnsle, en mde Administratin, cliquez sur la sectin Nœuds > Nœuds. Sélectinnez le nœud Dllar Universe v6 et cliquez sur Mdifier. Dans la sectin Cnfiguratin Service, sélectinnez Manager Web Services, et cliquez sur Désactiver. Une fenêtre nmmée Désactivatin : Manager Web Services est affichée. Cliquez sur Désactiver. Une fenêtre "Traitement" affiche les actins en curs. Lrsque la désactivatin est terminée, le message "Traitement Fait" est affiché. Cliquez sur Fermer. Le message "Succès de la prcédure de désactivatin" est affiché. Cliquez sur Ok et enregistrez les mdificatins du nœud Dllar Universe. La licence du Manager est cnservée dans le fichier des licences de Dllar Universe. 4.1.6 Désactiver le Manager pur Java Cette actin n est pssible que si le Manager pur Java est actif. Si vus désactivez ce service, la gestin des pératins Java définis pur ce nœud Dllar Universe sera interrmpue. La désactivatin du Manager pur Java désactive tus les managers rattachés : EJB, JMS, Web Services, Oracle DB et Micrsft SQL Server. Dans UniViewer Cnsle, en mde Administratin, cliquez sur la sectin Nœuds > Nœuds. Sélectinnez le nœud Dllar Universe v6 et cliquez sur Mdifier. Dans la sectin Cnfiguratin Service, sélectinnez Manager Java, et cliquez sur Désactiver. Une fenêtre nmmée Désactivatin : Manager Java est affichée. Cliquez sur Désactiver. Une fenêtre "Traitement " affiche les actins en curs. Lrsque la désactivatin est terminée (" fait"), vus puvez cliquer sur Fermer. Le message "Succès de la prcédure de désactivatin" est affiché. Cliquez sur Ok et enregistrez les mdificatins du nœud Dllar Universe. 4.2 Paramètres nœud du Manager pur Java Le tableau suivant décrit les variables du Manager. Ces variables snt définies dans les Paramètres nœud > Manager pur Java du nœud Dllar Universe v6 supprtant le Manager. Cmme pur Dllar Universe, les variables du Manager snt de type Install (I), Statique (S) u Dynamique (D). Les variables du Manager liées à l installatin de Dllar Universe ne peuvent pas être mdifiées. Elles snt de type Install (I). Les autres variables de type Statique u Dynamique peuvent être mdifiées avec UniViewer Cnsle u avec la cmmande unisetvar. La mdificatin de variables statiques ne sera prise en cmpte qu'après le redémarrage du Manager pur Java. Les variables dynamiques snt prises en cmpte par le Manager sans avir à le redémarrer.

16 Chapitre 4 Cnfiguratin Variable / Nm I/S/D Descriptin UXJEE_MINJVMMEM Taille mémire initiale de la zne heap (Mctets) UXJEE_MAXJVMMEM Taille mémire maximum de la zne heap (Mctets) S Valeur par défaut 128 S Valeur par défaut 128 UXJEE_DIR_ROOT Répertire racine du manager Java UXJEE_DIR_EXEC Répertire des binaires du manager Java UXJEE_DIR_DATA Répertire des dnnées du manager Java UXJEE_DIR_LOG Répertire des lgs du manager Java U_LOG_JAVA_LOG4J_FILE Fichier de cnfiguratin lg4j U_LOG_JAVA_LOG_FILE Fichier jurnal du manager java U_LOG_JAVA_LOG_LEVEL Niveau du jurnal du Manager Java I I I I I I D!UNI_DIR_ROOT! Crrespnd au répertire racine de la Sciété Dllar Universe.!UNI_DIR_EXEC!\bin_java Répertire cntenant les exécutables et utils du Manager. Crrespnd à UXJEE_DIR_ROOT/bin/bin_java!UNI_DIR_DATA!\data_java Répertire cntenant tutes les dnnées gérées par le Manager. Crrespnd à UXJEE_DIR_ROOT/data/data_java!UNI_DIR_LOG! Crrespnd au répertire des jurnaux de la Sciété Dllar Universe!UXJEE_DIR_DATA!\lg4j.xml!UXJEE_DIR_LOG!\mgrjava.lg FATAL : erreurs fatales uniquement ERROR : tutes les erreurs WARN : tutes les erreurs et les avertissements INFO (valeur par défaut) : tutes les erreurs, les avertissements et les infrmatins TRACE : tutes les erreurs, les avertissements, les infrmatins et les messages de trace DEBUG : tus les messages U_LOG_JAVA_MAX_SIZE_LOG_FILE Taille maximum du fichier jurnal Java (M) U_LOG_JAVA_ARCH_MAX_NB Nmbre maximum de fichiers jurnaux Java archivés S Minimum 1, valeur par défaut 100 D Minimum 0, valeur par défaut 1 UXJEE_JAVA_EXE Chemin d'accès à la cmmande "java" pur le démarrage du Manager Java D Valeur par défaut "java" Chemin d'accès cmplet à une cmmande java valide (JRE/JDK), par exemple C:\Prgram Files\Java\jdk1.6.0_20\bin\java.exe. UXJEE_SSL_SESSION_CACHE_SIZE Taille du cache de sessins SSL UXJEE_MAIN_MIN_POOL_SIZE Nmbre minimum de threads dans le pl de threads principal UXJEE_MAIN_MAX_POOL_SIZE Nmbre maximum de threads dans le pl de threads principal UXJEE_MAIN_POOL_QUEUE_SIZE Taille de la queue du pl de threads principal (0 pur une taille illimitée) D Valeur par défaut 100 S Minimum 0, valeur par défaut 5 S Minimum 1, valeur par défaut 20 S Minimum 0, valeur par défaut 200 UXJEE_MAIN_POOL_KEEP_ALIVE Temps limite en secndes pendant lequel les S Minimum 0, valeur par défaut 120 secndes

Chapitre 4 Cnfiguratin 17 Variable / Nm I/S/D Descriptin threads du pl principal peuvent rester actifs UXJEE_SUBMISSION_MIN_POOL_SIZE Nmbre minimum de threads dans le pl de threads de sumissin UXJEE_SUBMISSION_MAX_POOL_SIZE Nmbre maximum de threads dans le pl de threads de sumissin UXJEE_SUBMISSION_POOL_QUEUE_SIZE Taille de la queue du pl de threads de sumissin (0 pur une taille illimitée) UXJEE_SUBMISSION_POOL_KEEP_ALIVE Temps limite en secndes pendant lequel les threads du pl de sumissin peuvent rester actifs UXJEE_HTTP_CONNECTION_TIMEOUT Valeur du timeut sur cnnexin (en secndes) UXJEE_HTTP_READ_TIMEOUT Valeur du timeut pur attendre les dnnées (en secndes) S Minimum 0, valeur par défaut 1 S Minimum 1, valeur par défaut 100 S Minimum 0, valeur par défaut 100 S S S Minimum 0, valeur par défaut 120 secndes Temps maximum d'attente pur la créatin de la scket. Valeur par défaut 120 secndes Temps maximum d'attente pur une pératin de lecture. Valeur par défaut 120 secndes 4.3 Paramètres du Manager pur Web Services Les paramètres du Manager pur Web Services permettent de cnfigurer la cmmunicatin entre le Manager et les services web. En mde Administratin, affichez la liste des nœuds. Sélectinnez le nœud Dllar Universe v6 sur lequel le Manager Web Services est activé et cliquez Mdifier. Dans la sectin Cnfiguratin service, sélectinnez la ligne Manager Web Services et cliquez Paramètres du Manager. Pur définir l'un des paramètres u ajuter une valeur, sélectinnez l'une des sectins cidessus et cliquez sur le butn Ajuter u duble-cliquez sur une ligne vide. Seln le paramètre sélectinné, le dialgue est différent. Pur mdifier une valeur d'un paramètre, sélectinnez la sectin et le paramètre à mdifier et cliquez sur le butn Mdifier u duble-cliquez sur la ligne à mdifier. Pur supprimer une valeur d'un paramètre, sélectinnez la sectin et le paramètre à mdifier et cliquez sur le butn Supprimer. Une cnfirmatin est demandée avant de supprimer la valeur du paramètre. N'ubliez pas de cliquer sur Enregistrer pur sauvegarder les mdificatins apprtées. La mdificatin des paramètres SOAP et REST ne nécessite pas le redémarrage du service JEE pur être pris en cmpte. 4.3.1 SOAP Cette liste cntient l'ensemble des services web utilisant le prtcle SOAP qui sernt invqués par des Uprcs u des ressurces de type "Web Services SOAP". Des paramètres snt nécessaires au Manager pur invquer un service web SOAP et réceptinner la répnse; ils snt décrits ci-dessus.

18 Chapitre 4 Cnfiguratin Dans la barre d'utils, le butn Recharger WSDL permet de télécharger à nuveau le fichier de cnfiguratin WSDL des services web sélectinnés dans le cas ù ceux-ci auraient été mdifiés sur le serveur web. 4.3.1.1 Service web SOAP - Sectin Général Nm : nm du service web SOAP (limité à 64 caractères) tel qu'il sera invqué dans l'uprc u la ressurce. URL de la descriptin : URL du fichier de cnfiguratin WSDL du service web à invquer. Ce fichier sera téléchargé dans le sus-répertire thirdparty de la Sciété. En cas de mdificatin du fichier sur le serveur web, il devra être téléchargé à nuveau à l'aide du butn Recharger WSDL de la barre d'utils. Récursins max par éléments : nmbre de récursins autrisées pur un élément puvant cntenir un fils de même type. Au-delà de cette prfndeur, les fils snt ignrés dans l aide à la saisie des dnnées de l Uprc. Si un fichier WSDL était utilisé par le Manager et permettait d'exécuter des Uprcs et des ressurces de type Web Service SOAP et si ce fichier est mdifié (s'il cmprte une erreur, si des pératins snt supprimées, etc.) il ne sera pas pssible de revenir à la dernière bnne cnfiguratin cnnue. 4.3.1.2 Service web SOAP - Sectin Variables persnnalisées Cette liste cntient l'ensemble des variables persnnalisées pur ce Web Service qui purrnt être utilisées dans les Uprcs et les ressurces sus la frme :!VARIABLE!. Pur ajuter une nuvelle variable, cliquez sur le butn Ajuter u duble-cliquez sur une ligne vide. Dans la fenêtre "Ajut / Mdificatin d'une variable glbale", les champs suivants snt affichés : Variable : saisissez le nm de la variable en majuscules (limité à 64 caractères). Reprtezvus au Manuel de Référence de Dllar Universe, sectin "Utilisatin de variables dans la ligne de cmmande" pur plus de détails sur l'utilisatin des variables. Type : chisissez le type de la variable entre Chaîne et Mt de passe. Le type de la variable détermine le mde d'affichage de la valeur de la variable. Valeur: saisissez la valeur de la variable. La valeur d'une variable de type Chaîne est affichée en clair. La valeur d'une variable de type Mt de passe est cryptée. Des caractères * snt affichés lrs de la saisie, dans le fichier de stckage (fichier ws_sap_services.xml dans le sus-répertire UXJEE_DIR_DATA) et lrs de sn utilisatin. Si cette variable existe déjà dans les variables glbales du Manager, la valeur indiquée ici écrasera la valeur de la variable glbale. Reprtez-vus à la sectin "Variables" page 8. Lrs de la mdificatin d'une variable, seule sa valeur peut être mdifiée. Cliquez sur OK pur valider la créatin u la mdificatin, u sur Annuler pur fermer la fenêtre sans rien mdifier. 4.3.1.3 Service web SOAP - Sectin Cnfiguratin http Encdage : définit l'encdage du cntenu du message XML. Sélectinnez dans la liste le type d'encdage utilisé par le service web (liste nn exhaustive des cdages supprtés). Keystre : Cchez la case "Utilisez le keystre " pur spécifier le keystre/truststre à utiliser dans cas d une cnnexin https. Puis dans le champ Keystre sélectinnez un keystre qui aura été préalablement défini dans les paramètres "Keystres/Truststres" du Manager.

Chapitre 4 Cnfiguratin 19 Laissez la case " Utilisez le keystre " décchée si vus n utilisez pas https u si vus suhaitez utiliser le truststre par défaut du JRE. 4.3.1.4 Service web SOAP - Sectin Entêtes http Cette liste définit les entêtes http qui purrnt être ajutés par défaut lrs de l'invcatin du service web par l'uprc u la ressurce. Cliquez sur Ajuter pur ajuter un entête, sélectinnez une ligne et cliquez sur Mdifier pur mdifier la valeur d'un entête u cliquez sur Supprimer pur supprimer l'entête sélectinné. Nm : saisissez le nm de l'entête qui sera ajutée par défaut au message Valeur : saisissez sa valeur. 4.3.1.5 Service web SOAP - Sectin Cnfiguratin WS Security srtante Cette liste permet de définir les paramètres de sécurité pur les requêtes du Manager à destinatin du service web. Le service web visé dit supprter la nrme WSS. Cette cnfiguratin est ptinnelle si le service web visé n exige pas explicitement un cntenu sécurisé à l aide de WSS. Pur ajuter une nuvelle sécurité, cliquez sur le butn Ajuter. Plusieurs chix snt pssibles et cumulables : Hrdatage, Jetn d'utilisateur, Signature u Chiffrement. Seln l'ptin chisie, les infrmatins saisies snt différentes. Service web SOAP - Sectin Cnfiguratin WS Security srtante Hrdatage Cette cnfiguratin permet d'hrdater le message et de lui définir une durée de validité. Durée de vie : saisissez la durée de validité du message en secndes. Précisin : cchez cette case si la précisin demandée est la millisecnde. Dans le cas cntraire une précisin à la secnde sera appliquée. Service web SOAP - Sectin Cnfiguratin WS-Security srtante Jetn d'utilisateur Cette cnfiguratin permet d'ajuter un cntrôle sur l'utilisateur/mt de passe. Nm de l'utilisateur : saisissez le nm de l'utilisateur Mt de passe de l'utilisateur : saisissez le mt de passe de l'utilisateur. Il est autmatiquement crypté dans la cnfiguratin du Manager, mais il sera envyé en clair si la représentatin est "Text". Représentatin du mt de passe : chisissez la méthde de transmissin du mt de passe : Text (en clair), Digest (hachage) u Digest ext (hachage étendu). Ajuter un élément nnce : ajute une partie générée aléatirement dans le jetn Ajuter la date de créatin : ajuter la date de créatin du jetn. Service web SOAP - Sectin Cnfiguratin WS-Security srtante Signature Cette cnfiguratin permet de signer le message émis. La signature est générée à partir d'un keystre et d'un alias. Cette fenêtre détermine les infrmatins nécessaires au service web pur analyser la signature. Les valeurs affichées par les butns d'aide aux valeurs réalisée u celles supprtées par le Manager. snt issues de la cnfiguratin déjà Keystre : sélectinnez dans la liste le keystre qui dit avir été préalablement défini dans la sectin "Keystres/Truststres" des paramètres du Manager. Alias : sélectinnez dans la liste le nm du certificat appruvé dans le keystre qui sera utilisé pur la cnnexin.

20 Chapitre 4 Cnfiguratin Type d'indentificatin : tris types d'identifiant de clé peuvent être chisis : Binary security tken : BST_IDENTIFIER Issuer name and serial number : ISSUER_SERIAL Subject key identifier : SKI_KEY_IDENTIFIER Algrithme de signature: algrithmes de calcul de la signature. Les algrithmes supprtés snt les suivants : Algrithme RSA RSA_SHA1 RSA_SHA256 RSA_SHA384 RSA_SHA512 URL http://www.w3.rg/2000/09/xmldsig#rsa-sha1 http://www.w3.rg/2000/09/xmldsig#rsa-sha1 http://www.w3.rg/2001/04/xmldsig-mre#rsa-sha256 http://www.w3.rg/2001/04/xmldsig-mre#rsa-sha384 http://www.w3.rg/2001/04/xmldsig-mre#rsa-sha512 Algrithme de cannisatin : les cannisatins supprtées snt les suivantes : Cannisatin C14N_EXCL_OMIT_COMMENTS URL http://www.w3.rg/2001/10/xml-exc-c14n# Algrithme de hachage: les algrithmes supprtés snt les suivants : Algrithme SHA1 SHA256 SHA384 SHA512 URL http://www.w3.rg/2000/09/xmldsig#sha1 http://www.w3.rg/2001/04/xmlenc#sha256 http://www.w3.rg/2001/04/xmldsig-mre#sha384 http://www.w3.rg/2001/04/xmlenc#sha512 Certificat unique : La signature n utilisera pas la chaine cmplète de certificats (certificat + chaine de certificat CA), mais uniquement le certificat. Signer la ttalité du message : valeur par défaut, la signature est appliquée à tut le message Signer les parties suivantes : sélectinnez cette ptin pur n'appliquer la signature qu'aux espaces de nms indiqués dans la liste. Sélectinnez un champ dans la liste puis cliquez sur Mdifier pur le mdifier u sur Supprimer pur le supprimer. Cliquez sur Ajuter pur ajuter un champ dans la liste, les infrmatins suivantes divent être saisies : Nm : nm de la partie à signer Espace de nms : namespace crrespndant Méthde : sélectinnez Cntent pur signer le cntenu de l'élément u Element pur signer la ttalité de l'élément. Cliquez sur Ok pur valider les infrmatins saisies et ajuter un champ à la liste. Service web SOAP - Sectin Cnfiguratin WS-Security srtante Chiffrement Cette cnfiguratin permet de crypter le message émis. Le message est crypté à partir de la clé publique d'un keystre et d'un alias. Les valeurs affichées par les butns d'aide aux valeurs réalisée u celles supprtées par le Manager. snt issues de la cnfiguratin déjà

Chapitre 4 Cnfiguratin 21 Keystre : sélectinnez dans la liste le keystre qui dit avir été préalablement défini dans la sectin "Keystres/Truststres" des paramètres du Manager. Alias : sélectinnez dans la liste le nm du certificat appruvé dans le keystre qui sera utilisé pur la cnnexin. Type d'identificatin : plusieurs types d'identifiant de clé peuvent être chisis : Type d'identificatin BST_IDENTIFIER ENCRYPTED_KEY_SHA1_IDENTIFIER ISSUER_SERIAL SKI_KEY_IDENTIFIER THUMBPRINT_IDENTIFIER Descriptin Binary security tken Encrypted Key SHA1 Identifier Issuer name and serial number Subject key identifier Thumbprint SHA1 Identifier Les clés d'identificatin nn supprtées snt les suivantes : X509_KEY_IDENTIFIER EMBEDDED_KEYNAME EMBED_SECURITY_TOKEN_REF UT_SIGNING CUSTOM_SYMM_SIGNING CUSTOM_SYMM_SIGNING_DIRECT CUSTOM_KEY_IDENTIFIER Algrithme de cdage symétrique : sélectinnez un algrithme de cryptage dans la liste des algrithmes supprtés : Algrithme de cdage symétrique AES_128_CBC AES_192_CBC AES_256_CBC TRIPLE_DES URL http://www.w3.rg/2001/04/xmlenc#aes128-cbc http://www.w3.rg/2001/04/xmlenc#aes192-cbc http://www.w3.rg/2001/04/xmlenc#aes256-cbc http://www.w3.rg/2001/04/xmlenc#tripledes-cbc Pur utiliser les algrithmes de cryptage symétriques AES_192_CBC et AES_256_CBC, il est nécessaire de cnfigurer la machine virtuelle Java de la machine hébergeant le Manager en installant l extensin : Java Cryptgraphy Extensin (JCE). Ceci dit aussi être réalisé sur la machine hébergeant le web service si celui-ci utilise la machine virtuelle Java. Algrithme de chiffrement : sélectinnez un algrithme de cryptage de la clé dans la liste des algrithmes supprtés : Algrithme de chiffrement KEYTRANSPORT_RSA15 KEYTRANSPORT_RSAOEP URL http://www.w3.rg/2001/04/xmlenc#rsa-1_5 http://www.w3.rg/2001/04/xmlenc#rsa-aep-mgf1p Ajut de la clé : cchez cette case pur ajuter la clé générée par le Manager dans le message. Chiffrer la ttalité du message : valeur par défaut, la signature est appliquée à tut le message Chiffrer les parties suivantes : sélectinnez cette ptin pur n'appliquer la signature qu'aux Espaces de nms indiqués dans la liste.

22 Chapitre 4 Cnfiguratin Imprtant : dans ce cas, les parties désignées divent figurer dans la sectin Paramètres d'entrée de tutes les Uprcs et ressurces de type SOAP. Sélectinnez un champ dans la liste puis cliquez sur Mdifier pur le mdifier u sur Supprimer pur le supprimer. Cliquez sur Ajuter pur ajuter un champ dans la liste, les infrmatins suivantes divent être saisies : Nm : nm de l'élément à signer Espace de nms : nm du namespace à signer Méthde : sélectinnez Cntent pur signer uniquement le cntenu de la balise u Element pur signer le cntenu et la balise. Cliquez sur Ok pur valider les infrmatins saisies et ajuter un champ à la liste. 4.3.1.6 Service web SOAP - Sectin Cnfiguratin WS-Security Entrante Ces paramètres définissent la sécurité pur les cmmunicatins du service web vers le Manager (répnse à une requête du Manager). Cette cnfiguratin n'est bligatire que si le service web visé est susceptible d envyer une répnse sécurisée par WSS. Tus les champs snt ptinnels. Keystre pur la signature : sélectinnez dans la liste le keystre, utilisé pur le calcul de la signature, qui dit avir été préalablement défini dans la sectin "Keystres/Truststres" des paramètres du Manager. Keystre pur le décryptage : sélectinnez dans la liste le keystre, utilisé pur le cryptage du message, qui dit avir été préalablement défini dans la sectin "Keystres/Truststres" des paramètres du Manager. Nm du jetn utilisateur : saisissez le nm de l'utilisateur pur le cntrôle du jetn utilisateur du message reçu. Mt de passe du jetn utilisateur: saisissez sn mt de passe. 4.3.2 REST Cette liste cntient l'ensemble des services web utilisant le prtcle REST qui sernt invqués par des Uprcs u des ressurces de type "Web Services REST". Des paramètres snt nécessaires au Manager pur invquer un service web REST et réceptinner la répnse; ils snt décrits ci-dessus. 4.3.2.1 Service web REST - Sectin Général Nm : nm du Web Service REST (limité à 64 caractères) tel qu'il sera invqué dans l'uprc u la ressurce URL de référence : URL de base du service web qui sera cmplétée lrs de l'invcatin du service dans l'uprc u la ressurce. Les paramètres de l'url ne divent pas être saisis dans ce champ mais dans le tableau de la sectin "Service web REST - Sectin Paramètres d'url par défaut" page 23. Nmbre maximum de redirectins : nmbre maximum de redirectins autrisées si l'url de base renvie sur une autre URL (si un cde 3xx est renvyé). 4.3.2.2 Service web REST - Sectin Variables persnnalisées Cette liste cntient l'ensemble des variables persnnalisées pur ce Web Service qui purrnt être utilisées dans les Uprcs et les ressurces sus la frme :!VARIABLE!.

Chapitre 4 Cnfiguratin 23 Pur ajuter une nuvelle variable, cliquer sur le butn Ajuter u duble-cliquez sur une ligne vide. Dans la fenêtre "Ajut / Mdificatin d'une variable glbale", les champs suivants snt affichés : Variable : saisissez le nm de la variable en majuscules (limité à 64 caractères). Reprtezvus au Manuel de Référence de Dllar Universe, sectin "Utilisatin de variables dans la ligne de cmmande" pur plus de détails sur l'utilisatin des variables. Type : chisissez le type de la variable entre Chaîne et Mt de passe. Le type de la variable détermine le mde d'affichage de la valeur de la variable. Valeur: saisissez la valeur de la variable. La valeur d'une variable de type Chaîne est affichée en clair. La valeur d'une variable de type Mt de passe est cryptée. Des caractères * snt affichés lrs de la saisie, dans le fichier de stckage (fichier ws_rest_services.xml dans le sus-répertire UXJEE_DIR_DATA) et lrs de sn utilisatin. Si cette variable existe déjà dans les variables glbales du Manager, la valeur indiquée ici écrasera la valeur de la variable glbale. Reprtez-vus à la sectin "Variables" page 8. Lrs de la mdificatin d'une variable, seule sa valeur peut être mdifiée. Cliquez sur OK pur valider la créatin u la mdificatin, u sur Annuler pur fermer la fenêtre sans rien mdifier. 4.3.2.3 Service web REST - Sectin Cnfiguratin http Encdage : définit l'encdage du cntenu du message. Sélectinnez dans la liste le type d'encdage utilisé par le service web (liste nn exhaustive des cdages supprtés). Keystre : Cchez la case "Utilisez le keystre " pur spécifier le keystre/truststre à utiliser dans cas d une cnnexin https. Puis dans le champ Keystre sélectinnez un keystre qui aura été préalablement défini dans les paramètres "Keystres/Truststres" du Manager. Laissez la case " Utilisez le keystre " décchée si vus n utilisez pas https u si vus suhaitez utiliser le truststre par défaut du JRE. 4.3.2.4 Service web REST - Sectin Entêtes par défaut Cette liste définit les entêtes http qui purrnt être ajutés par défaut lrs de l'invcatin du service web par l'uprc u la ressurce. Cliquez sur Ajuter pur ajuter un entête, sélectinnez une ligne et cliquez sur Mdifier pur mdifier la valeur d'un entête u cliquez sur Supprimer pur supprimer l'entête sélectinné. Nm : saisissez le nm de l'entête qui sera ajuté par défaut au message Valeur : saisissez sa valeur. 4.3.2.5 Service web REST - Sectin Paramètres d'url par défaut Liste les paramètres qui sernt ajutés à l'url. La valeur définie par défaut purra être écrasée par la valeur définie dans la ressurce u dans l'uprc. Sélectinnez une ligne et cliquez sur Mdifier pur mdifier la valeur par défaut d'un paramètre u cliquez sur Supprimer pur supprimer le paramètre sélectinné. Cliquez sur Ajuter pur ajuter un nuveau paramètre et sa valeur par défaut, les infrmatins suivantes divent être saisies : Name : nm du paramètre qui sera ajuté à l'url Value : valeur par défaut du paramètre.

24 Chapitre 4 Cnfiguratin Le paramètre et sa valeur sernt encdés autmatiquement pur s'appliquer à l'url lrs de l'invcatin du service web. 4.3.3 Keystres/Truststres Tus les keystres utilisés pur la sécurité des messages (https, signature et cryptage) divent être déclarés dans cette liste. Nm : saisissez le nm du keystre Chemin : saisissez le chemin cmplet du fichier cntenant les certificats Mt de passe du keystre : saisissez le mt de passe nécessaire à l'accès au keystre Alias : si plusieurs certificats snt cntenus dans ce keystre, il faut ajuter un alias et sn mt de passe par certificat. Sélectinnez une ligne et cliquez sur Mdifier pur mdifier le mt de passe u cliquez sur Supprimer pur supprimer l'alias sélectinné. Cliquez sur Ajuter pur ajuter un nuvel alias et sn mt de passe. Vérifier les mts de passe : cliquez sur ce butn pur tester le mt de passe du keystre et le mt de passe de chaque alias déclaré. Si certains alias existent dans le keystre mais n'nt pas été déclarés dans le manager, leur mt de passe n'est pas testé. Le manager différencie un keystre/alias inaccessible (le fichier n'existe pas, n'a pas les drits de lecture u n'est pas un keystre) et un mt de passe faux (u un keystre/alias crrmpu u qui ne respecte pas le frmat attendu). 4.3.4 Variables glbales Cette liste cntient l'ensemble des variables glbales du Manager qui purrnt être utilisées dans les Uprcs et les ressurces sus la frme :!VARIABLE!. Pur ajuter une nuvelle variable, cliquer sur le butn Ajuter u duble-cliquez sur une ligne vide. Dans la fenêtre "Ajut / mdificatin d'une variable glbale", les champs suivants snt affichés : Variable : saisissez le nm de la variable en majuscules (limité à 64 caractères). Reprtezvus au Manuel de Référence de Dllar Universe, sectin "Utilisatin de variables dans la ligne de cmmande" pur plus de détails sur l'utilisatin des variables. Type : chisissez le type de la variable entre Chaîne et Mt de passe. Le type de la variable détermine le mde d'affichage de la valeur de la variable. Valeur: saisissez la valeur de la variable. La valeur d'une variable de type Chaîne est affichée en clair. La valeur d'une variable de type Mt de passe est cryptée. Des caractères * snt affichés lrs de la saisie, dans le fichier de stckage (fichier ws_glbal_variables.xml dans le sus-répertire UXJEE_DIR_DATA) et lrs de sn utilisatin. Lrs de la mdificatin d'une variable, seule sa valeur peut être mdifiée. Cliquez sur OK pur valider la créatin u la mdificatin, u sur Annuler pur fermer la fenêtre sans rien mdifier.

Chapitre 4 Cnfiguratin 25 4.4 Jurnalisatin du Manager pur Web Services Dllar Universe Manager pur Web Services génère des traces afin d aider l administrateur à identifier et résudre des prblèmes éventuels. Vus puvez activer le mde trace du Manager en mdifiant le Paramètre nœud du nœud Dllar Universe > catégrie Manager pur Java > Niveau du jurnal du Manager Java (U_LOG_JAVA_LOG_LEVEL). Les traces snt enregistrées dans le fichier jurnal du Manager nmmé par défaut mgrjava.lg; il est situé dans le répertire lg de la Sciété. Pur afficher le fichier jurnal du Manager, dans UniViewer Cnsle, en mde Administratin, uvrez le dcument Nœuds > Nœuds. Sélectinnez le nœud Dllar Universe v6 et cliquez sur Trace > Jurnal du Manager pur Java.

26 Chapitre 5 UniViewer Cnsle 5 UniViewer Cnsle UniViewer Cnsle permet de gérer les Uprcs et les ressurces Web Services : Une Uprc de type SOAP dit être créée dans Dllar Universe pur invquer un service Web SOAP. Une Uprc de type REST dit être créée dans Dllar Universe pur invquer un service Web REST. Une ressurce de type SOAP dit être créée dans Dllar Universe pur se synchrniser sur l'exécutin d'un service web SOAP. Une ressurce de type REST dit être créée dans Dllar Universe pur se synchrniser sur l'exécutin d'un service web REST. 5.1 Caractéristiques cmmunes 5.1.1 Expressins régulières Les expressins régulières peuvent être utilisées pur tester le cntenu d'une prpriété, d'un élément u de la répnse. La ttalité du cntenu demandé dit valider l expressin régulière, même si celui-ci pssède plusieurs lignes. Par exemple, pur valider que le cntenu demandé cntient au mins une fis le terme "OK", l expressin régulière dit être la suivante : ".*OK.*". Les expressins régulières utilisées snt de type DOT_ALL, cela signifie que le caractère "." peut crrespndre à un retur à la ligne. Tut caractère puvant présenter une ambiguïté (par exemple?) dit être prtégé par un \ (par exemple : \?) pur ne pas être utilisé cmme une expressin régulière. 5.1.2 Caractères spéciaux Sus XML, certains caractères divent être prtégés pur ne pas être interprétés par le langage; ces caractères snt les suivants : Caractère " &qut ' > &lt Valeur prtégée &aps < &gt & &amp Chacun de ces caractères sera écrit en utilisant la valeur prtégée à l'intérieur du jurnal de l'exécutin, mais l'utilisateur dit utiliser la valeur nn prtégée pur tester le statut de l'exécutin (service web SOAP u REST si le bdy de la répnse cntient du XML) dans la définitin de l'uprc u dans la définitin de la cnditin de la ressurce.