Настройка идентификации OAuth-OSLC для Rational DOORS Web Access

Создайте файл oslcServiceProviders.xml для хранения значений свойств base_url, consumer_key и secret.

Прежде чем начать

Об этой задаче

По умолчанию продукт выполняет поиск файла oslcServiceProviders.xml в каталоге RPE_HOME/config. Преимущество создания файла oslcServiceProviders.xml в каталоге RPE_HOME/config заключается в том, что не требуется дополнительная настройка. Обратите внимание, что перед обновлением продукта необходимо создать резервную копию этого файла. После установки и обновления поместите резервную копию файла oslcServiceProviders.xml в каталог RPE_HOME/config нового экземпляра продукта.
Файл oslcServiceProviders.xml можно разместить за пределами каталога RPE_HOME/config, однако в этом случае расположение файла oslcServiceProviders.xml должно быть указано в свойстве com.ibm.rational.rpe.config.oslcServiceProviders. В случае применения защищенного пути HTTP необходимо указать идентификационные данные в свойствах com.ibm.rational.rpe.config.oslcServiceProviders.usr и com.ibm.rational.rpe.config.oslcServiceProviders.pwd. Эти свойства можно указать в следующих областях:
  • Переменные среды в операционной системе
  • Свойства Java в виртуальной машине Java (JVM)
  • Флаги в среде выполнения. Дополнительная информация о настройке флагов для WebSphere Application Server, Apache Tomcat или клиентских приложений приведена в одном из следующих разделов.

Возможность создания файла oslcServiceProviders.xml за пределами каталога по умолчанию RPE_HOME/config в особенности актуальна для сред совместной работы. Файл oslcServiceProviders.xml в общем расположении может использоваться несколькими пользователями. Общее расположение должно быть указано в свойстве com.ibm.rational.rpe.config.oslcServiceProviders.

Процедура

  1. Создайте копию примера в установочном каталоге Rational Publishing Engine: RPE_HOME/config/oslcServiceProviders-sample.xml
  2. В текстовом редакторе откройте копию файла oslcServiceProviders.xml.
  3. В тегах title укажите имя провайдера источника данных.
  4. В тегах description укажите описание или примечания провайдера источника данных.
  5. В тегах base_url укажите базовый URL источника данных.

    Для определения URL в клиенте Rational DOORS щелкните правой кнопкой мыши на URL объекта в открытом модуле и выберите Скопировать URL.

    Для определения URL в Rational DOORS Web Access откройте представление Структура базы данных, откройте модуль и выберите объект. В разделе Атрибуты > Системы скопируйте значение поля URL. Например, щелкните правой кнопкой мыши на поле URL и выберите Скопировать ярлык.

    Пример: https://сервер:порт/dwa

  6. В тегах pattern укажите шаблон URL источника данных. Как правило, теги base_url и pattern содержат одно и то же значение URL источника данных Rational DOORS Web Access. Если в файле oslcServiceProviders.xml указан список источников данных, то шаблон применяется для выбора источника данных, соответствующего требованиям.

    Пример: https://сервер:порт/dwa

  7. В тегах consumer_key укажите ключ приемника из источника данных.

    Для определения значения consumer_key в Rational DOORS выберите Файл > OSLC > Локальные ключи.

  8. В тегах secret укажите пароль из источника данных.

    Для определения значения secret в Rational DOORS выберите Файл > OSLC > Локальные ключи. Найдите поле Пароль OAuth. Значение Пароль OAuth следует указать для свойства secret Rational Publishing Engine.

  9. Сохраните файл oslcServiceProviders.xml за пределами установочного каталога Rational Publishing Engine.