配置 Web 预览服务器

您可以配置 Web 预览服务器和 proxy-config.xml 文件。

过程

  1. 在“服务器”视图中,双击 Web 预览服务器以打开服务器编辑器。 您可以使用“概述”和“安全性”页面来配置 Web 预览服务器。
  2. 在“概述”页面的“常规信息”部分中,编辑服务器名称、主机名和运行时环境。
  3. 在“通信设置”部分中,指定要用于 Web 预览服务器的缺省端口号。
    注: 如果已经在使用缺省端口号,那么 Web 预览服务器将自动分配另一个可用的端口号。
  4. 在“发布”部分中,选择下列其中一个设置:
    选项 描述
    从不自动发布 工作台从不将文件发布至服务器。
    资源更改时自动发布 当保存对与服务器相关联的文件所做的更改并且“发布时间间隔”设置中的完整时间间隔耗尽时,工作台将进行发布。此为缺省设置。
    构建事件后自动发布 当保存对需要构建且与服务器相关联的文件所做的更改并且“发布时间间隔”设置中的完整时间间隔耗尽时,工作台将进行发布。
    发布时间间隔(以秒计) 工作台在服务器上发布文件之前所经过的秒数。但是,如果在此时间间隔完成之前对文件进行了后续更改,那么将延迟发布,因为已将计时器重置。只有在完整时间间隔耗尽之后,工作台才会发布到服务器。如果将发布时间间隔设置为 0 秒,那么只要保存对文件所做的更改,就会发布文件。
  5. 在“超时”部分中,设置请求完成所需的时间量。
  6. “Ajax 代理”部分包含一个表,用于显示访问 URL 以及它们相应的已解析的目标 URL。 “Ajax 代理”部分具有适用于列示在访问 URL 列中通配符的缺省代理规则 (proxy/http/*),您可以使用该规则来代理任何 URL。例如,您可以在 Web 浏览器中使用此 http://localhost:8080/proxy/http/google.com URL 来装入 Google Web 页面。通过代理映射的这个请求与针对 http://www.google.com 发出定向请求的结果相同。
    提示: 您可以右键单击 AJAX 代理 URL 表的某一行并复制访问 URL(例如 proxy/us/en)以粘贴到 JavaScript 代码中。
  7. 单击配置代理 URL 链接以编辑 proxy-config.xml
  8. 在“AJAX 代理配置”编辑器中,添加用于映射至远程域的代理规则。选择代理规则节点,然后单击添加
  9. 在“添加项目”窗口中,选择下列其中一项并在编辑器中编辑其属性:
    选项 描述
    映射 根据其上下文路径将入局请求映射至目标 URL。

    指定上下文路径属性和可选的 URL 属性。例如,您可能会将 /ibmproducts 的上下文路径设置为 URL http://www.ibm.com/products

    如果入局代理 URL 为 http://mywebsite.com/ibmproducts/us/en,那么代理会将请求转发至 http://www.ibm.com/products/us/en。 在您应用匹配的访问策略之前,代理会先解析上下文路径映射。提供了两个缺省代理映射 http/*us/en 以支持快速原型。

    Metadata 指定代理的常规配置属性,例如与 HTTP 相关的参数。代理编辑器提供了一些具有缺省名称和值对的常用元数据选项:
    forward-http-errors
    缺省情况下,Ajax 代理仅转发大于或等于 200 且小于 400 的 HTTP 状态码。超出此范围的状态码会自动更改为 404,表示发生了“找不到文件”错误。您可以通过将 forward-http-errors 参数设置为 true 来使用消息转发大于或等于 400 的 HTTP 代码。
    unsigned_ssl_certificate_support
    未签署的证书通常用在受保护的 REST 服务上。 如果 unsigned_ssl_certificate_support 处于启用状态,那么 Ajax 代理将接受任何 SSL 证书。此选项对于测试和调试非常有用。 请不要在生产环境中使用此选项。
    basic-auth-support
    如果目标服务使用基本认证,请将此选项设置为 true。 除非针对该特定请求启用了 basic-auth-support 属性,否则 HTTP 状态码 401(未经授权)会导致“403:禁止”HTTP 代码。
    maxconnectionsperhost
    maxconnectionperhost 是一个全局值,用于指定为任何主机或端口组合保持活动的最大连接数。 缺省情况下,该值设置为 2。如果应用程序访问两个以上远程站点以获取内容,请增大该值。
    maxtotalconnections
    maxtotalconnections 是代理所支持的最大连接总数。缺省值为 5。您选择的值必须足够高以支持您可能接收到的并发连接数。在实践中,请考虑 Web 容器的配置方式以及该容器所支持的并发连接数。
    socket-timeout
    socket-timeout 定义建立连接之后等待数据的缺省套接字超时(以毫秒计)。缺省超时值为 0,这表示无限超时。
    retries
    retries 参数定义 AJAX 代理在放弃建立连接之前所执行的套接字尝试次数。 缺省值是 2。
    connection-timeout
    connection-timeout 定义在建立连接之前经过的时间(按毫秒计)。如果未指定值,那么会使用缺省值 60000。如果使用 0,那么会将该值解释为不使用超时。
    策略 定义给定 URL 模式的访问策略。
    1. ACF 字段中,开启或关闭活动内容过滤。活动内容过滤会从显示在浏览器中的应用程序内容移除恶意的活动内容。
    2. URL 属性字段中指定模式。对于各传入请求,代理会应用 URL 最匹配的策略。如果未找到匹配策略,那么代理将拒绝该请求。如果找到某个策略,那么会应用该策略元素的子元素以检查是否接受请求。
    3. 开启或关闭对基本认证挑战的支持。
    您可以编辑以下策略子元素:
    操作方法
    指定至少一个受支持的 HTTP 方法。Ajax 代理支持 GET、POST、PUT、HEAD 或 DELETE 请求。
    cookie
    定义一列 cookie 名称,这些 cookie 名称用于标识您要让代理转发至目标域的 cookie。为了转发 cookie,代理会按照已定义的 cookie 名称来过滤 cookie 头的值。
    HTTP 头
    定义您要让代理转发至目标域的头名称的列表。头名称可以包含通配符。
    Mime 类型
    指定已接受的 MIME 类型的列表。mime 类型是指代理从目标服务器接收到的响应。如果指定了至少一种 MIME 类型,那么代理将只接受具有 Content-Type 响应头且与其中一种指定的 MIME 类型相匹配的响应。如果未指定任何 MIME 类型,那么代理将接受所有响应。
    用户
    指定用户或用户组的列表。例如,如果指定 AllAuthenticatedUsers,那么代理会验证该请求是否由已认证的用户发送。
  10. “Ajax 代理密钥库”部分显示 AJAX 代理所使用的密钥库的信息(例如密钥库路径和类型)。您可以从密钥库中添加或移除 SSL 证书,以使用 Ajax 代理从目标服务器对其使用不受信 SSL 证书的 URL 检索信息。导入某个 URL(指向具有不受信证书的服务器)的 SSL 证书之后,您可以使用 AJAX 代理来访问此 URL,而不会接收到错误消息。
    1. 可选: 如果使用从另一个供应商获取的软件更改了密钥库密码,请更新密钥库密码字段中的密码。
    2. 密钥库路径字段中指定的密钥库添加或移除 SSL 服务器证书。
      1. 单击管理密钥库条目。这时,“管理密钥库”窗口将打开并显示当前密钥库条目(由它们的别名标识每一个条目)的列表。
      2. 要移除密钥库条目,请从密钥库条目列表中选择该条目,然后单击移除条目
      3. 要添加密钥库条目,请单击添加条目。 这时,将打开“导入证书”窗口。
      4. 条目别名字段中,指定新密钥库条目的别名。
      5. 指定您是要从服务器导入 SSL 证书,还是要从本地系统导入 SSL 证书。
        将证书从服务器导入至密钥库
        输入您要从其中导入 SSL 证书的服务器的 URL。
        将本地证书导入至密钥库
        单击浏览证书以在本地系统上找到您要导入的 SSL 证书。
      6. 单击确定以保存更改并关闭“导入证书”窗口。在“管理密钥库”窗口中,单击确定以保存您对密钥库所做的所有更改。
  11. 在“安全性”页面上,配置以下设置。
    部分 描述
    常规 对 Web 应用程序启用或禁用安全性;复查已部署在 Web 预览服务器上的当前项目。
    注: 必须对已部署在 Web 预览服务器上的 Web 应用程序启用安全性。您可以在要部署至服务器的 Web 项目中所包含的 WebContent/WEB-INF/web.xml 文件内配置安全性。
    用户与组 管理已在 Web 预览服务器上注册的用户和组。
    • 在该服务器上注册新用户。
    • 从该服务器中移除用户。
    • 在该服务器上注册新组。
    • 从已注册的组中添加或移除用户。
    • 从该服务器中移除组。
    安全性角色 管理已在 Web 预览服务器上注册的安全角色。
    • 在该服务器上注册安全角色。
    • 从该服务器中移除安全角色。
    • 将安全角色映射至用户。
    • 从用户中移除安全角色。
    • 将安全角色映射至组。
    • 从组中移除安全角色。
  12. 保存所做的更改。
指示主题类型的图标 任务主题
信息中心的条款和条件 | 反馈

时间戳记图标 最近一次更新时间: 2014 年 4 月 17 日

文件名:tconfigajaxtestserver.html