40.1 Configuration d'Identity Reporting pour WebSphere

40.1.1 Préparation des environnements WebSphere

Le programme d'installation d'Identity Reporting crée les utilisateurs idmrptuser et idmrptsrv dans la base de données PostgreSQL. Vous avez besoin de ces comptes utilisateur pour tester les sources de données requises par Identity Reporting. En outre, les sources de données doivent exister avant que vous ne procédiez au déploiement de l'application. Pour plus d'informations, reportez-vous à la Section 37.2, Présentation de la procédure d'installation des composants du module Identity Reporting.

Pour vous assurer que votre environnement est correctement configuré, vous devez effectuer les étapes suivantes dans l'ordre indiqué. Utilisez le tableau ci-dessous pour identifier les sources de données à lier aux comptes utilisateur de PostgreSQL.

Utilisateur PostgreSQL

Source de données WebSphere

idmrptsrv

IDMRPTDataSource

idmrptuser

IDMRPTCfgDataSource

  1. Installez Identity Reporting selon les instructions indiquées dans l'une des sections suivantes :

    Au cours de cette étape, la procédure d'installation crée les utilisateurs idmrptuser et idmrptsrv dans la base de données PostgreSQL et écrit les fichiers WAR sous /opt/netiq/idm/apps/IdentityReporting.

  2. Créez les deux sources de données pour PostgreSQL qui se connectent à la base de données SIEM et sont liées aux utilisateurs PostgreSQL.

  3. À l'aide des outils de déploiement adéquats en fonction de votre serveur d'applications, déployez les fichiers WAR suivants pour Identity Reporting :

    • IDMRPT-CORE.war

    • IDMRPT.war

    • rptdoc.war

    • easwebstart.war

    • easrestapi.war

40.1.2 Configuration de l'environnement WebSphere pour une exécution en tant que service Windows

Lorsque vous déployez Identity Reporting dans un conteneur Web qui s'exécute en tant que service Windows, vous devez définir la propriété Log on as (Se connecter en tant que) de ce service afin qu'il puisse lire ou écrire les mêmes données de configuration que celles définies par les outils de configuration et d'installation.

À défaut, il se peut que vous rencontriez des problèmes avec WebSphere 7.0 installé en tant que service Windows. En effet, la propriété Log on as (Se connecter en tant que) est définie par défaut sur local system (système local), ce qui ne correspond à aucun utilisateur défini dans les utilisateurs et groupes du système. Identity Reporting utilise les préférences Java pour stocker les données de configuration de l'application. Celles-ci sont associées au compte utilisateur du système d'exploitation qui exécute le processus (en d'autres termes, le serveur d'applications).

Pour la propriété Log on as (Se connecter en tant que), indiquez le compte utilisateur qui sera utilisé par le serveur d'applications. Par exemple, pour une exécution avec le compte administrateur, affectez la valeur administrator (administrateur) à Log on as (Se connecter en tant que). L'outil de configuration post-installation doit être exécuté avec le même compte utilisateur.

40.1.3 Configuration de WebSphere pour prendre en charge les connexions SSL

Si vous utilisez des connexions SSL, vous devez conserver le certificat eDirectory. Utilisez la console pour charger l'autorité de certification dans la zone de stockage approuvée.

40.1.4 Ajout de fichiers de configuration et de propriétés système JVM pour Identity Reporting

Cette section vous aide à créer de nouvelles propriétés système JVM afin qu'Identity Reporting puisse s'exécuter sur un serveur d'applications WebSphere. La procédure diffère légèrement selon que vous déployez Identity Reporting dans le même environnement WebSphere que les applications d'identité ou dans un environnement distinct.

  1. Connectez-vous à la console d'administration de WebSphere en tant qu'administrateur.

  2. Dans le volet de gauche, cliquez sur Servers > Application Servers (Serveurs > Serveurs d'applications).

  3. Dans la liste des serveurs, cliquez sur le nom du serveur que vous souhaitez configurer. Exemple : server1.

  4. Dans le volet de contenu, sous Server Infrastructure (Infrastructure du serveur), cliquez sur Java and Process Management (Gestion des processus et Java).

  5. Développez le lien et sélectionnez Process Definition (Définition des processus).

  6. Dans la liste sous Additional Properties (Propriétés supplémentaires), cliquez sur Java Virtual Machine (Machine virtuelle Java).

  7. Sous le libellé Additional Properties (Propriétés supplémentaires) de la page JVM, cliquez sur Custom Properties (Propriétés personnalisées).

  8. Pour ajouter la propriété système JVM com.netiq.rpt.config.file, effectuez les étapes suivantes :

    1. Cliquez sur New (Nouveau).

    2. Dans Name (Nom), indiquez com.netiq.rpt.config.file.

    3. Dans Value (Valeur), indiquez le chemin complet du fichier ism-configuation.properties (y compris son nom).

      Par exemple, /opt/netiq/idm/apps/IdentityReporting/config/ism-configuation.properties.

    4. Dans Description, saisissez une description de la propriété.

      Exemple : fichier de propriétés ISM pour Identity Manager Reporting.

    5. Cliquez sur OK pour enregistrer la propriété.

  9. (Facultatif) Si vous déployez Identity Reporting avec les applications d'identité, effectuez les étapes suivantes :

    1. Copiez les fichiers de configuration suivants depuis le répertoire d'installation d'Identity Reporting :

      • rpt_data_hibernate.cfg.xml

      • rpt_runner_hibernate.cfg.xml

      • rpt_mgt_cfg_hibernate.cfg.xml

    2. Placez ces fichiers dans le répertoire qui a été assigné à la propriété JVM extend.local.config.dir lors de la configuration des applications d'identité.

  10. (Facultatif) Si vous ne déployez pas Identity Reporting avec les applications d'identité, effectuez les étapes suivantes afin d'ajouter la propriété système JVM extend.local.config.dir :

    1. Cliquez sur New (Nouveau).

    2. Dans Name (Nom), indiquez extend.local.config.dir.

    3. Dans Value (Valeur), indiquez le chemin d'accès complet au répertoire qui contient les trois fichiers de configuration de Reporting (rpt_data_hibernate.cfg.xml, rpt_runner_hibernate.cfg.xml et rpt_mgt_cfg_hibernate.cfg.xml).

      Par exemple, /opt/netiq/idm/apps/IdentityReporting/conf/.

    4. Dans Description, saisissez une description de la propriété.

      Exemple : chemin d'accès aux fichiers de configuration d'Identity Manager Reporting.

    5. Cliquez sur OK pour enregistrer la propriété.

  11. Redémarrez WebSphere.

40.1.5 Création et application d'une bibliothèque partagée

Il peut être nécessaire de configurer une bibliothèque partagée pour Identity Reporting. Lorsque vous créez une bibliothèque partagée, vous devez également appliquer cette bibliothèque à un nouveau chargeur de classes afin que WebSphere utilise les versions des fichiers JAR correspondant à Identity Manager. Dans le cas contraire, vous rencontrerez des problèmes de chargement de classes avec les fichiers JAR fournis avec WebSphere. Les problèmes de chargement de classes WebSphere peuvent se manifester sous la forme des exceptions suivantes :

  • ClassCastException

  • ClassNotFoundException

  • NoClassDefFoundException

  • UnsatisfiedLinkError

  • LinkageError

Cette procédure implique les opérations suivantes :

Configuration de la bibliothèque partagée

  1. Connectez-vous à la console d'administration de WebSphere en tant qu'administrateur.

  2. Dans le volet de gauche, développez le noeud Environment (Environnement).

  3. Cliquez sur Shared Libraries (Bibliothèques partagées).

  4. Dans le volet de contenu, cliquez sur New (Nouveau).

  5. Saisissez un nom (IDMUA Classpath, par exemple).

  6. Dans Classpath (Chemin de classe), ajoutez les fichiers JAR requis :

    • Si Identity Reporting est installé à l'aide de son programme d'installation spécifique, la bibliothèque partagée doit disposer des mêmes trois fichiers JAR que ceux requis par les applications d'identité, ainsi que des fichiers JAR supplémentaires suivants :

      • log4j.jar

      • commons-logging-1.1.1.jar

      • IDMselector.jar

      • felix.jar

      Les fichiers log4j.jar, IDMselector.jar et felix.jar figurent sous le répertoire %reporting-install% et le fichier commons-logging-1.1.1.jar, sous %reporting-install%/bin/lib.

      Exemples :

      • /opt/netiq/idm/apps/IdentityReporting/log4j.jar

      • /opt/netiq/idm/apps/IdentityReporting/IDMselector.jar

      • /opt/netiq/idm/apps/IdentityReporting/bin/lib/commons-logging-1.1.1.jar

      • /opt/netiq/idm/apps/IdentityReporting/felix.jar

    • Si Identity Reporting est installé dans le cadre de l'installation des applications d'identité, ajoutez une entrée pour le fichier JAR felix dans la définition de la bibliothèque partagée. Le fichier JAR felix est situé dans le répertoire d'installation d'Identity Reporting. Par exemple, /opt/netiq/idm/apps/IdentityReporting/felix.jar.

      Par exemple, /opt/netiq/idm/apps/IdentityReporting/felix.jar

  7. Désélectionnez Use an isolated class loader for this shared library (Utiliser un chargeur de classes isolé pour cette bibliothèque partagée).

  8. Cliquez sur OK.

  9. Cliquez sur Enregistrer pour enregistrer les modifications apportées à la configuration principale.

Application de la bibliothèque partagée à un nouveau chargeur de classes

  1. Connectez-vous à la console d'administration de WebSphere en tant qu'administrateur.

  2. Développez Application servers > server-name > Class loader (Serveurs d'applications > nom_serveur > Chargeur de classes).

    REMARQUE :par défaut, cette option apparaît réduite dans la section Java and Process Management (Gestion des processus et Java).

  3. Dans le volet de contenu, cliquez sur New (Nouveau) pour créer un nouveau chargeur de classes.

  4. Sélectionnez Classes loaded with local class loader first (parent last) (Classes chargées en premier avec un chargeur de classes local (dernier parent)).

  5. Cliquez sur Apply (Appliquer).

  6. Sélectionnez Shared library references (Références de bibliothèque partagée).

  7. Cliquez sur Add (Ajouter), puis sélectionnez la bibliothèque partagée que vous avez créée à l'étape Configuration de la bibliothèque partagée.

  8. Cliquez sur Appliquer.

  9. Cliquez sur OK.

  10. Cliquez sur Enregistrer pour enregistrer les modifications apportées à la configuration principale.