在文档规范中为数据源指定认证类型

如果数据源需要认证,那么会测试 Rational® Publishing Engine 支持的每种认证类型(FormBasicOAuthOAuth-OSLC),直至找到正确的类型。可通过指定认证类型来避免该测试过程。

指定认证类型时,Rational Publishing Engine 会确保首先使用正确协议并且不会执行非必需请求。在下列情况下,您会看到文档生成时性能得到显著提高:如果数据源需要 BasicOAuthOAuth-OSLC 认证,或者如果您使用的复杂模板需要来自数据源的许多请求。如果未指定任何认证类型,那么会测试每种类型。

关于此任务

请完成此任务以提高生成 HTML 文档、XSL-FO 文档和旧 PDF 文档的性能。

有关用户名和密码的存储方式的更多信息,请参阅 IBM® Rational Publishing Engine 的安全性注意事项

过程

  1. 打开 Launcher 应用程序。
  2. 创建文档规范。
  3. 配置数据源。
  4. 选择该数据源。 此时,会打开“属性”视图。
  5. 认证字段中,输入适用于数据源的认证类型。可输入下列其中一种认证类型(区分大小写):
    • Form
    • Basic
    • OAuth
    • OAuth-OSLC
  6. 如有必要,请输入用来向数据源进行认证的凭证(包括用户名和密码)。
  7. 保存文档规范。

下一步做什么

更新现有文档规范中的认证属性。

创建 oslcServiceProviders.xml 文件以进行 OAuth-OSLC 认证

如果使用需要进行 OAuth-OSLC 认证的通用 XML、REST V1 或 REST V2 数据源,那么必须首先创建 oslcServiceProviders.xml 以存储 base_urlconsumer_keysecret 属性值。

过程

  1. Rational Publishing Engine 安装目录中创建样本副本:%RPE_HOME%/config/oslcServiceProviders-sample.xml
  2. title 标志中,提供数据源提供程序的名称。
  3. description 标志中,提供数据源提供程序的描述或注释。
  4. base_url 标志中,提供数据源的基本 URL。 示例:https://server:port/oslcCatalog
  5. patter 标志中,提供数据源的 URL 模式。 当在 oslcServiceProviders.xml 文件中指定了数据源的列表时,会使用模式来标识哪些数据源详细信息匹配数据源需求。 示例:https://server:port/contextroot
  6. consumer_key 标志中,提供数据源的使用者密钥。
  7. secret 标志中,提供数据源的 secret 值。
  8. oslcServiceProviders.xml 文件保存在 Rational Publishing Engine 安装目录之外的位置中。

下一步做什么

使用 -Dcom.ibm.rational.rpe.config.oslcServiceProviders 标志指定 oslcServiceProviders.xml 的位置,使用 -Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr 标志指定认证凭证。

请参阅以下其中一个主题,以获取有关为 WebSphere® Application ServerApache Tomcat客户机应用程序配置标志的更多信息。


反馈