Configuration des utilisateurs de Document Builder sur Apache Tomcat

Pour configurer les utilisateurs de Document Builder sur un serveur Apache Tomcat, procédez comme suit.

Avant de commencer

Vous devez d'abord installer Apache Tomcat, Rational Publishing Engine et Document Builder puis déployer ce dernier pour pouvoir configurer les utilisateurs et les options Java™.

Pourquoi et quand exécuter cette tâche

Pour plus d'informations sur le mode de stockage des noms d'utilisateur et des mots de passe, voir Remarques relatives à la sécurité pour IBM® Rational Publishing Engine.

Les rôles utilisateur doivent être définis pour l'application rpeng seulement et pas pour l'application dgaas.

Examinez les rôles de Document Builder :

Tableau 1. Rôles d'utilisateur Document Builder
Rôle Fonctions
Utilisateur final (rpe_user)
  • Possibilité de générer des documents à partir de Document Builder
  • Possibilité d'afficher des fichiers de sortie et des journaux sur les travaux de génération de document
  • Possibilité de planifier une génération de document
Concepteur de rapport (rpe_report_designer)
  • Possibilité de télécharger des canevas et des feuilles de style dans Document Builder
  • Possibilité d'assembler des rapports
  • Possibilité de définir des connexions de sources de données
  • Possibilité de marquer des rapports comme disponibles ou non disponibles pour d'autres utilisateurs
  • Possibilité de générer des documents à partir de Document Builder
  • Possibilité d'afficher des fichiers de sortie et des journaux sur les travaux de génération de document
  • Possibilité de planifier une génération de document
Administrateur (rpe_admin)
  • Possibilité d'accéder à l'option de menu Administrer
  • Possibilité de surveiller la santé du système, d'afficher tous les travaux en cours d'exécution et d'affecter des variables d'exécution et d'environnement
  • Possibilité de générer des documents à partir de Document Builder
  • Possibilité de télécharger des canevas et des feuilles de style dans Document Builder
  • Possibilité d'assembler des rapports
  • Possibilité de définir des connexions de sources de données
  • Possibilité de générer des documents à partir de Document Builder
  • Possibilité d'afficher des fichiers de sortie et des journaux sur les travaux de génération de document
  • Possibilité de planifier une génération de document

Procédure

  1. Ouvrez Apache Tomcat Manager
    • Si vous exécutez Apache Tomcat en tant que service Windows, ouvrez le panneau de configuration et, sur la ligne Apache Tomcat, cliquez sur Admin. Cliquez ensuite sur Manager App.
    • Si vous n'exécutez pas Apache Tomcat en tant que service Windows, ouvrez Apache Tomcat Manager dans un navigateur en entrant une adresse au format suivant : http://serveur:port/manager/html

      Exemple : http://localhost:8080/manager/html.

  2. Arrêtez l'application web déployée. Dans la section Applications, recherchez la ligne application_rpeng.war et cliquez sur Arrêter.
  3. Ouvrez le fichier web.xml qui se trouve dans <rép_install_Tomcat>\webapps\rpeng\WEB-INF.
  4. Si les contraintes de sécurité ne sont pas activées dans le fichier web.xml, supprimez la mise en commentaire dans la section suivante :
    <security-constraint>
            <web-resource-collection>
                <web-resource-name>All</web-resource-name>
                <url-pattern>/api/*</url-pattern>
                <url-pattern>/home/*</url-pattern>
                <url-pattern>/license</url-pattern>
                <http-method>GET</http-method>
                <http-method>POST</http-method>
                <http-method>PUT</http-method>
                <http-method>DELETE</http-method>
            </web-resource-collection>
    
            <auth-constraint>
                <role-name>rpe_user</role-name>
                <role-name>rpe_report_designer</role-name>
                <role-name>rpe_admin</role-name>
            </auth-constraint>
        </security-constraint>
  5. Créez les utilisateurs et les rôles Apache Tomcat pour Document Builder.
    1. Ouvrez le fichier tomcat-users.xml, qui se trouve par défaut dans $CATALINA_HOME\conf\tomcat-users.xml.
    2. Ajoutez les rôles suivants :
      <role rolename="rpe_user" />
      <role rolename="rpe_report_designer" />
      <role rolename="rpe_admin" />  
    3. Ajoutez au moins un utilisateur final. Affectez-lui le rôle utilisateur. Exemple :
      <user username="user" password="password" roles="rpe_user"/>
    4. Facultatif : Ajoutez les concepteurs de rapport. Affectez-leur les rôles de concepteur de rapport. Exemple :
      <user username="designer" password="password" roles="rpe_user,rpe_report_designer"/>
    5. Ajoutez au moins un administrateur et affectez-lui les rôles administrateur, utilisateur et concepteur de rapport. Exemple :
      <user username="admin" password="password" roles="rpe_user,rpe_report_designer,rpe_admin"/>
  6. Démarrez Document Builder. Dans la section Applications d'Apache Tomcat Manager, recherchez la ligne application_rpeng.war et cliquez sur Démarrer.