Configuration de l'authentification OAuth-OSLC pour Rational DOORS Web Access

Créez un fichier oslcServiceProviders.xml pour le stockage des valeurs de propriété base_url, consumer_key et secret.

Avant de commencer

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.

    Pour identifier l'URL dans le client Rational DOORS, cliquez avec le bouton droit de la souris sur une URL d'objet d'un module ouvert et cliquez sur Copier l'URL.

    Pour identifier l'URL dans Rational DOORS Web Access, accédez à la vue Explorateur de base de données, ouvrez un module et sélectionnez un objet. Sous la section Attributs > Systèmes, copiez la valeur dans la zone URL. Par exemple, en cliquant avec le bouton droit de la souris sur la zone URL et en sélectionnant l'option de menu Copier le raccourci.

    Exemple : https://serveur:port/dwa

  6. Dans les étiquettes pattern, indiquez le module d'URL de la source de données. Généralement, les balises base_url et pattern contiennent la même valeur d'URL de la source de données Rational DOORS Web Access. 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://serveur:port/dwa

  7. Dans les étiquettes consumer_key, indiquez la clé de consommateur de la source de données.

    Pour identifier la valeur consumer_key, dans Rational DOORS, cliquez sur File > OSLC > Local keys.

  8. Dans les étiquettes secret, indiquez la valeur de secret de la source de données.

    Pour identifier la valeur secret, dans Rational DOORS, cliquez sur File > OSLC > Local keys. Recherchez la zone OAuth secret. La valeur OAuth secret est la valeur à entrer dans la propriété Rational Publishing Engine secret.

  9. Sauvegardez le fichier oslcServiceProviders.xml dans un emplacement situé en dehors du répertoire d'installation de Rational Publishing Engine.