Указание типа идентификации для источника данных в спецификации документа

Если источник данных требует идентификации, проверяется каждый тип идентификации, поддерживаемый Rational Publishing Engine (Form, Basic, OAuth или OAuth-OSLC), пока не будет найден правильный тип. Можно обойти процесс проверки, назначив тип идентификации.

Когда вы указываете тип идентификации, Rational Publishing Engine обеспечивает использование правильного протокола в первую очередь и излишние запросы не выполняются. Вы можете ощутить значительное улучшение производительности при генерации документа, если источник данных требует идентификации Basic, OAuth или OAuth-OSLC или если используется сложный шаблон, который требует многих запросов из источника данных. Если тип идентификации не задан, проверяется каждый тип.

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

Дополнительная информация о хранении имени пользователей и паролей приведена в разделе Замечания о защите для IBM® Rational Publishing Engine.

Процедура

  1. Откройте приложение Панель запуска.
  2. Создайте спецификацию документа.
  3. Настройте источник данных.
  4. Выберите источник данных. Откроется панель Свойства.
  5. В поле идентификация введите тип идентификации, применяемый для источника данных. Можно ввести один из следующих типов идентификации с учетом регистра:
    • Form
    • Базовая
    • OAuth
    • OAuth-OSLC
  6. Если необходимо, введите идентификационные данные для источника данных, включая имя пользователя и пароль.
  7. Сохраните спецификацию документа.

Дальнейшие действия

Измените свойства идентификации в существующих спецификациях документов.

Создание файла oslcServiceProviders.xml для идентификации OAuth-OSLC

В случае применения источника данных Базовый XML, REST v1 или REST v2 с идентификацией OAuth-OSLC необходимо создать 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 источника данных. Пример: https://сервер:порт/oslcCatalog
  6. В тегах pattern укажите шаблон URL источника данных. Если в файле oslcServiceProviders.xml указан список источников данных, то шаблон применяется для выбора источника данных, соответствующего требованиям. Пример: https://сервер:порт/contextroot
  7. В тегах consumer_key укажите ключ приемника из источника данных.
  8. В тегах secret укажите пароль из источника данных.
  9. Сохраните файл oslcServiceProviders.xml за пределами установочного каталога Rational Publishing Engine.