第三十四章 配置服务器访问

本页介绍如何配置`` 网关连接的应用程序。对于这些配置任务，可以使用 Web Gateway 管理页面。其他文章介绍了如何配置默认设置和服务器。

每个Web 应用程序都必须配置其 CSP 文件的路径。每个路径的配置标识负责运行应用程序的 IRIS 服务器。用于指定故障转移和负载平衡的可选指令包含在应用程序路径的配置中。首次启动 Web Gateway 时，会自动配置默认应用程序路径 root (/)。继承应用于应用程序路径。例如，如果 CSP 请求要求 /Accounts/Invoices 中的文件，并且 /Accounts/Invoices 没有配置，则 Web Gateway 将使用为 /Accounts 定义的配置。如果未定义，则使用默认路径 / 的配置。

添加应用程序路径

要配置应用程序的路径:

1. 在Web网关管理页面主菜单上，选择应用程序访问。
2. 选择添加应用程序。请注意，许多参数都有默认设置。
3. 在应用程序路径文本框中输入应用程序的唯一路径。此路径是出现在应用程序URL中的路径。

注意:IRIS安装会创建一个新的/csp配置。如果已将/csp配置为应用程序，当安装新版本的 IRIS时，配置将被覆盖。要维护应用程序配置，请输入/csp以外的路径。

/csp下的任何目录都可以正常工作，例如/csp/myapplication，但是路径不能包含任何点（句点），因为这些会导致Web网关不明确。在此示例中:/csp/samples/menu.csp/csp/aaa/bbb/ccc.cls，Web网关可能会将其解释为对/CSP/samples/menu.CSP/CSP/AAA/BBB/CCC.cls的请求或对/CSP/samples/menu.CSP（其中PATH_INFO为/CSP/AAA/BBB/CCC.cls）的REST请求。在web服务器环境中工作的Web网关无法解决这些歧义。

CSP区分大小写。在配置CSP时，请指定一致的路径名。

4. 为此应用程序输入其他配置路径和服务器参数（如下表所述）。
5. 完成后，选择保存配置。对应用程序配置所做的更改将在为该应用程序路径创建新用户会话时生效。现有用户不受影响。

应用程序路径配置参数

这组基本参数如下:

• Service Status - 通过应用程序路径启用和禁用对应用程序的访问（默认为启用）。

• Web Server Physical Path - web服务器上相应目录的路径。此设置对于Microsoft IIS系统尤其重要，在这些系统中，配置的每个路径都必须在web服务器配置下设置为虚拟目录。IIS中定义的每个虚拟目录都必须有一个与之关联的物理路径。IIS的这一附加配置过程的目的是允许使用执行权限定义系统间IRIS（特别是CSP引擎）使用的路径。默认情况下拒绝执行（以及对CSP引擎的访问）。

• Extra CGI Environment Variables - 每个请求返回到IRIS环境的附加CGI环境变量的逗号分隔列表。每个请求都会自动发送常用的CGI环境变量。输入通配符（*），指示web网关在每次请求时将Web服务器提供的所有环境变量发送到IRIS服务器。

• Process with this class - 用指定的类处理此路径中的文件。这允许在CSP中构建自己的请求处理程序。

• GZIP Compression - 对该路径中返回的所有CSP页面启用或禁用GZIP压缩（默认为禁用）。

• GZIP Minimum File Size - 调用GZIP压缩的最小响应大小（以字节为单位）。默认值为500字节。

• GZIP Exclude File Types - 这是从GZIP压缩中排除的文件类型列表。要排除的文件可以按MIME类型（如image/jpeg）或通用扩展名（如jpeg）列出。

  • 默认情况下，这些常见的（本机压缩）图像文件被排除在外:GZIP排除文件类型:jpeg gif ico png gz zip mp3 mp4 tiff
  • 用空格分隔附加类型或扩展名。

• Response Size Notification - 此参数提供对Web网关用来通知客户端每个响应中包含的数据量的方法的可配置控制。

  • 如果使用HTTP KeepAlive连接，Web客户端通常需要某种形式的响应大小通知。在这些情况下，如果正在使用HTTP v1.1，Web网关默认使用分块传输编码。如果使用早期的HTTP协议，它会缓冲从 IRIS接收的响应数据，并生成一个content-length标头。此外，在整个响应适合一个输出缓冲区的情况下，将生成内容长度标头，而不是使用分块传输。
  • 在有些情况下，需要指示Web网关专门使用一种或另一种方法。例如，在使用HTTP v1.1但某些中介（如代理）无法正确支持分块传输的情况下。此外，虽然所有web客户端都应支持不发送任何形式的大小通知（例如，关闭连接事件用作响应终止符的情况），但建议所有响应都应附带某种形式的大小通知，这是一种“良好做法”。事实上，有些客户需要这样做。
  • 提供了以下选项:
    • 分块传输编码和内容长度（默认）
    • 分块传输编码
    • 内容长度
  • 此参数补充了一个复选框，用于指示Web网关始终为所有请求生成大小通知，而不管是否使用了KeepAlive。
  • 与分块响应相反，指定内容长度标头的HTTP响应的大小限制为500千字节。如果超过此限制，CSP日志中会显示一条警告消息:
  • 警告:无法为此超大响应生成“Content-Length”标头指令（当前大小:大小；允许的最大缓冲大小:500000）

• KeepAlive - 启用或禁用此路径的HTTP保持活动连接。默认情况下没有操作，在这种情况下，保持活动状态由每个请求的HTTP响应标头决定。

• Non-Parsed Headers - 启用或禁用此路径的非解析头协议。默认启用，在这种情况下，HTTP响应头直接流回客户端。如果禁用此属性，响应标头将提交回宿主web服务器。这使web服务器有机会解析标题并调用可能指示的任何输出过滤器。例如，Apache集团的mod_deflate设施。请注意，对于Apache web服务器，如果启用了keep-alive，则无论未解析的头设置如何，响应头都会提交回Apache。