Spécification du type d'authentification d'une source de données dans une spécification de document

Lorsqu'une source de données doit être authentifiée, chaque type d'authentification pris en charge par Rational Publishing Engine (Formulaire, De base, OAuth ou OAuth-OSLC) est testé jusqu'à ce que le type correct soit détecté. Vous pouvez éviter ce processus de test en désignant un type d'authentification.

Lorsque vous spécifiez le type d'authentification, Rational Publishing Engine vérifie que le protocole correct est utilisé en premier et qu'aucune requête inutile n'est exécutée. Vous constaterez peut-être un gain significatif de performances en termes de durée de génération de documents si votre source de données utilise un type d'authentification De base, OAuth, ou OAuth-OSLC ou en cas d'utilisation d'un canevas complexe nécessitant de nombreuses requêtes en provenance de la source de données. Si aucun type d'authentification n'est spécifié, chaque type est testé.

Pourquoi et quand exécuter cette tâche

Effectuez cette tâche pour améliorer les performances de génération de documents HTML, XSL-FO et PDF existant.

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.

Procédure

  1. Ouvrez l'application Launcher.
  2. Créez une spécification de document.
  3. Configurez une source de données.
  4. Sélectionnez la source de données. La vue Propriétés s'ouvre.
  5. Dans la zone Authentification, entrez le type d'authentification qui s'applique à votre source de données. Vous pouvez entrer l'un des types d'authentification sensibles à la casse suivants :
    • Formulaire
    • De base
    • OAuth
    • OAuth-OSLC
  6. Si nécessaire, entrez les données d'identification pour l'authentification avec la source de données, et notamment le nom d'utilisateur et le mot de passe.
  7. Sauvegardez la spécification de document.

Que faire ensuite

Mettez à jour les propriétés d'authentification dans les spécifications de document existantes.

Création d'un fichier oslcServiceProviders.xml pour l'authentification OAuth-OSLC

Si vous utilisez une source de données XML générique, REST v1 ou REST v2 qui requiert une authentification OAuth-OSLC, vous devez d'abord créer un fichier oslcServiceProviders.xml pour le stockage des valeurs de propriété base_url, consumer_key et secret.

Pourquoi et quand exécuter cette tâche

Par défaut, le produit recherche le fichier oslcServiceProviders.xml sous le répertoire RPE_HOME/config. L'avantage de créer votre fichier oslcServiceProviders.xml sous ce répertoire RPE_HOME/config par défaut est qu'aucune configuration supplémentairee n'est requise. N'oubliez pas, toutefois, de créer une copie de sauvegarde de ce fichier si vous souhaitez effectuer une mise à niveau vers une version ultérieure du produit. Après l'installation et la mise à niveau, vous pouvez placer le fichier de sauvegarde oslcServiceProviders.xml sous le répertoire RPE_HOME/config du produit nouvellement installé.
Vous pouvez placer le fichier oslcServiceProviders.xml dans un autre répertoire que le répertoire RPE_HOME/config par défaut, mais vous devez alors spécifier l'emplacement du fichier oslcServiceProviders.xml avec la propriété com.ibm.rational.rpe.config.oslcServiceProviders. Si la localisation est un chemin d'accès sécurisé, vous devez spécifier les données d'authentification à l'aide des propriétés com.ibm.rational.rpe.config.oslcServiceProviders.usr et com.ibm.rational.rpe.config.oslcServiceProviders.pwd. Spécifiez ces propriétés à l'aide de l'une des portées suivantes :
  • Variables d'environnement de votre système d'exploitation
  • Propriétés Java de votre machine virtuelle Java (JVM)
  • Indicateurs de votre environnement d'exécution. Consultez les rubriques ci-après pour plus d'informations sur la configuration des étiquettes pour WebSphere Application Server, Apache Tomcat ou les applications client.

La création du fichier oslcServiceProviders.xml en dehors du répertoire RPE_HOME/config par défaut prend en charge les environnements de collaboration des équipes. Le fichier oslcServiceProviders.xml peut être réutilisé par plusieurs utilisateurs si vous le placez dans un emplacement partagé et que vous définissez la propriété com.ibm.rational.rpe.config.oslcServiceProviders de façon à pointer vers l'emplacement partagé.

Procédure

  1. Créez une copie de l'exemple dans le répertoire d'installation de Rational Publishing Engine : RPE_HOME/config/oslcServiceProviders-sample.xml
  2. Dans un éditeur de texte, ouvrez votre copie du fichier oslcServiceProviders.xml.
  3. Dans les étiquettes title, indiquez un nom pour le fournisseur de source de données.
  4. Dans les étiquettes description, indiquez une description ou des remarques concernant le fournisseur de source de données.
  5. Dans les étiquettes base_url, indiquez l'URL de base d'accès à la source de données. Exemple : https://server:port/oslcCatalog
  6. Dans les étiquettes pattern, indiquez le module d'URL de la source de données. Lorsqu'une liste de sources de données est spécifiée dans le fichier oslcServiceProviders.xml, le modèle est utilisé pour identifier les détails de source de données qui correspondent à la source de donnée requise. Exemple : https://server:port/contextroot
  7. Dans les étiquettes consumer_key, indiquez la clé de consommateur de la source de données.
  8. Dans les étiquettes secret, indiquez la valeur de secret de la source de données.
  9. Sauvegardez le fichier oslcServiceProviders.xml dans un emplacement situé en dehors du répertoire d'installation de Rational Publishing Engine.